Integrace: přehled

Integrace propojují Tappeer s vaším účetním programem nebo ERP a udržují v obou systémech stejné firmy, faktury a další záznamy. Tato stránka vysvětluje, jak integrace fungují, kdo je smí nastavovat a v jakém pořadí postupovat.

Co integrace dělají

Integrace synchronizují záznamy mezi Tappeerem a externím systémem — například firmy a faktury mezi Tappeerem a Money S3. Každý druh záznamu (entitu) synchronizuje samostatný konektor, který určuje směr, plán a pravidla přenosu.

Příchozí směr zapisuje záznamy změněné v externím systému do Tappeeru.
Odchozí směr zapisuje záznamy změněné v Tappeeru do externího systému.
Jeden konektor může běžet jedním směrem, nebo oběma.

Které systémy a entity jsou podporované, najdete v části Podporované systémy. Pojmy jako konektor, instalace nebo business klíč vysvětluje Základní pojmy.

Dva způsoby připojení

Přes bridge

Desktopové účetní programy, například Money S3 a POHODA, běží na počítači ve vaší síti, kam se cloud Tappeer nedostane. K nim se Tappeer připojuje přes Tappeer Bridge — malého agenta, kterého nainstalujete na počítač s Windows, odkud je účetní program dostupný.

Bridge se k Tappeeru připojuje sám, vždy jen směrem ven. Do vaší sítě se zvenčí nic nepřipojuje a na firewallu nemusíte otevírat žádný port pro příchozí spojení.

flowchart LR
  T["Tappeer (cloud)"] <--> G["Brána Tappeer bridge"]
  G <-->|"šifrované spojení, otevírá ho bridge"| B["Tappeer Bridge<br/>na počítači ve vaší síti"]
  B <--> E["Money S3 / POHODA"]

Přímo

Systémy, které mají vlastní rozhraní dostupné z internetu, například ABRA Flexi, připojuje Tappeer přímo z cloudu. Bridge v tom případě nepotřebujete.

flowchart LR
  T["Tappeer (cloud)"] <-->|"HTTPS"| E["ABRA Flexi (API)"]

Kdo může integrace nastavovat

Integrace musí mít váš účet zapnuté. Pokud jste Administrátor nebo Správce bezpečnosti a položku Integrace v nabídce nastavení nevidíte, obraťte se na podporu Tappeer.
Nastavovat je mohou jen uživatelé s rolí Administrátor nebo Správce bezpečnosti.
Účetní kancelář může stejnou integraci připravit jednou a nasadit ji více klientům najednou (viz Šablony integrací).

V uživatelském menu vpravo nahoře (pod vaším avatarem) otevřete Nastavení systému a v nabídce nastavení vlevo Integrace. Na mobilu najdete Nastavení systému v nabídce Nastavení.

Integrace se otevírají uvnitř Nastavení systému: vlevo je nabídka nastavení, kde jsou Integrace první položkou skupiny Integrace a API. Pod nimi jsou Instalace, Bridge a Monitor; nabídka je ukáže, když máte otevřenou některou stránku integrací, nebo když je najdete hledáním. Detail konektoru a průvodce nastavením mají v nabídce označené Integrace, detail instalace Instalace a detail bridge Bridge. Na detailu se na předchozí stránku vrátíte šipkou zpět v jeho záhlaví.

Uvítací stránka

Dokud váš účet nemá žádný konektor, ukáže stránka Integrace místo přehledu uvítání. Krátce vysvětlí, co integrace dělají, a nabídne kartu pro Money S3 a pro ABRA Flexi (jen pro ty z nich, které jsou pro váš účet dostupné). Karta popisuje, co systém potřebuje, co se synchronizuje a co se načítá zpět; tlačítko Nastavit otevře průvodce nastavením integrace (/integrations/setup).

Máte-li nastavení rozpracované — máte vlastní bridge nebo instalaci Money S3 či ABRA Flexi, ale zatím žádný konektor — nabídne stránka Pokračovat v nastavení. Průvodce naváže tam, kde jste skončili.
Používáte jiný systém, například POHODU? Pod kartami je Přidat konektor ručně, které otevře běžné přidání konektoru (viz Přidání a nastavení konektoru).
V záhlaví je tlačítko Nápověda; bridge, instalace a monitor najdete v nabídce nastavení pod Integrace.

Jakmile vznikne první konektor, ukazuje stránka přehled popsaný níže.

Jak vypadá stránka Integrace

Stránka je rozdělená do pruhů, jeden pruh pro každou entitu. Každý pruh čtete zleva doprava ve čtyřech sloupcích:

Sloupec	Co ukazuje
Entita Tappeeru	Kde záznamy žijí v Tappeeru, například firmy nebo faktury.
Připojení	Jak se Tappeer k systému dostane: přímo přes internet (Cloud), nebo Bezpečný tunel k bridgi ve vaší síti.
Konektor	Co záznamy přenáší a upravuje: název konektoru, směr, stav a výsledek posledního běhu.
Externí systém	Odkud záznamy přicházejí, nebo kam jdou, a verze jeho pluginu.

Šipky mezi sloupci ukazují směr synchronizace (příchozí, odchozí, oba směry). Kliknutím na kartu zobrazíte podrobnosti; u konektoru najdete také přepínač zapnutí a tlačítko Synchronizovat. Entita, kterou zatím žádný konektor nesynchronizuje, má pruh s tlačítkem pro přidání konektoru.

V záhlaví stránky jsou tato tlačítka:

Nápověda — tato příručka v nové záložce.
Přidat systém — průvodce nastavením integrace, který připojí Money S3 nebo ABRA Flexi až po první synchronizaci.
Přidat konektor — založení nového konektoru (viz Přidání a nastavení konektoru).

Na mobilu jsou tlačítka záhlaví v nabídce ⋮.

Ostatní stránky integrací otevřete v nabídce nastavení pod Integrace:

Instalace — instalace externích systémů, které konektory používají (viz Cílové systémy a instalace).
Bridge — seznam bridgů vašeho účtu a registrace dalšího.
Monitor — průběhy synchronizace všech konektorů (viz Sledování synchronizace).

Rychlý start

Připojujete-li Money S3 nebo ABRA Flexi, otevřete na stránce Integrace kartu svého systému (nebo Přidat systém). Průvodce nastavením integrace (/integrations/setup) vás provede výběrem bridge (jen u Money S3), instalací, ověřením připravenosti, konektory pro firmy a faktury a první synchronizací. Průvodce založí:

konektor Firmy oběma směry: změny z Tappeeru odejdou hned po uložení a každý den ve 2:00 (v časovém pásmu instalace) proběhne úplná synchronizace;
konektor Faktury do účetního systému hned po každé změně, s Jen zpětné načtení stavu faktur každých 6 hodin u Money S3 a každou hodinu u ABRA Flexi.

Oba konektory smějí v účetním systému zakládat nové záznamy. Konektory se založí vypnuté a zapne je až první synchronizace, kterou spustíte v posledním kroku. Plán i směr můžete později změnit u konektoru.

U ostatních systémů, nebo chcete-li vše nastavit ručně, postupujte v tomto pořadí:

Přečtěte si Základní pojmy a v části Podporované systémy ověřte, co váš systém umí.
Připojujete-li Money S3 nebo POHODU, nainstalujte a spárujte bridge podle návodu Instalace a spárování bridge.
Na stránce Instalace přidejte instalaci svého systému a spusťte Ověřit připravenost (viz Cílové systémy a instalace).
Přidejte konektor, nastavte směr a plán synchronizace (viz Přidání a nastavení konektoru).
Podle potřeby upravte pravidla přenosu polí (viz Pole a transformace).
Spusťte první příchozí synchronizaci a vyřešte čekající shody (viz Párování záznamů a duplicity).
Sledujte průběhy synchronizace (viz Sledování synchronizace); s chybami pomůže Řešení problémů.

Provoz bridge, aktualizace a příkazy pro správce IT popisuje Provoz bridge.