Čeština

English

Čeština

English

Vzhled

Integrace přes můstek ​

Na můstku zakládáte a zapínáte propojení Elasticru s bankou, platebním terminálem, hotovostním automatem, poskytovatelem přepravy, mapou výdejních míst, datovým úložištěm a firemním přihlášením. Jedno propojení = jedna integrace s vybraným adaptérem.

O funkci ​

E-shop a sklad bývají jen jedním dílkem: vedle žijí banka, pokladní hardware, přepravní služby nebo firemní účty zaměstnanců. Můstek je místo, kde si taková propojení zavedete sami, bez zásahu implementačního týmu.

Integrace se skládá ze tří věcí:

  • adaptér — se kterým systémem nebo zařízením se komunikuje; adaptér patří do jedné ze sedmi kategorií (v administraci Typ),
  • konfigurace — přístupové údaje a parametry pro daný systém,
  • funkce — dílčí schopnosti, které kategorie nabízí (například výběr hotovosti nebo zpětné štítky), a u každé to, jestli ji adaptér umí a jestli je připravená k provozu.

Přehled kategorií a adaptérů, včetně toho, k čemu které propojení slouží, je na stránce Přehled integrací. Tady je popsané, jak se integrace zakládá a co se při jejím uložení stane.

Cesta v administraci

Nastavení > Můstek > Integrace

Výpis integrací ​

Každý řádek ukazuje název integrace se štítkem Zapnuto / vypnuto a pod ním Kód a Typ (kategorii). Sloupec Funkce shrnuje připravenost řadou teček — plná tečka je funkce, která už funguje, prázdná funkce, kterou adaptér neumí — a jedním slovem:

  • Funkční — všechny funkce, které adaptér umí, fungují,
  • Vyžaduje nastavení — některé funkci chybí nebo stojí automatizace,
  • Bez funkcí — adaptér žádnou funkci kategorie neumí (typicky Bez dopravce).

Filtr Typ zúží seznam na jednu kategorii, pole Vyhledat… hledá v názvu a kódu. Novou integraci založíte tlačítkem Nový, existující otevřete ikonou tužky.

Výpis integrací se zvýrazněným filtrem Typ a sloupcem FunkceVýpis integrací s otevřenou filtrací — u každé integrace kód, typ a stav funkcí.

Založení a úprava integrace ​

  • Název (povinné) — pod tímto názvem se integrace nabízí jinde v administraci, například v poli Poskytovatel přepravy u dopravy.
  • Kód (povinné, jedinečný) — malá písmena, číslice, pomlčky a podtržítka, nejvýše 64 znaků (např. automat-prodejna-1). Po uložení se nedá změnit.
  • Adaptér (povinné) — po uložení se nedá změnit; pro jiný systém založte novou integraci.
  • Aktivní — nová integrace je vypnutá. Automatizace vypnuté integrace neběží, platební metoda terminálu či automatu se zneveřejní a firemní přihlášení se nenabídne.

Uložení integrace zakládá i navazující záznamy

Automatizace pro funkce, které je potřebují, vzniknou samy při uložení a zapínají se a vypínají spolu s přepínačem Aktivní; smazáním integrace zmizí. Podle kategorie se navíc založí platební metoda nebo poskytovatel přepravy, viz níže.

Chybějící adaptér

Když integrace odkazuje na adaptér, který na instalaci už není, výpis místo adaptéru ukáže Chybějící adaptér: <kód>, integrace se chová jako vypnutá a nemá žádné funkce. Uložená konfigurace se nemaže.

Kategorie integrací ​

Banka ​

Adaptéry Fio banka, Komerční banka a UniCredit Bank. Všechny umějí Manuální import transakcí (nahrání výpisu). Fio banka má v konfiguraci Bankovní účet a API token a umí navíc Automatickou synchronizaci transakcí, kterou spouští automatizace. Účet musí patřit do Fio banky a mít nastavený formát importu Fio, viz Bankovní účty.

Platební terminál ​

Adaptér Comgate platební terminál, jedna integrace na jeden fyzický terminál. Konfigurace obsahuje přihlašovací údaje terminálu a testovací režim. Uložení integrace založí k terminálu platební metodu pro pokladnu, stejně jako u hotovostního automatu.

Hotovostní automat ​

Adaptér CashMatic, jedna integrace na jeden automat.

  • Kasa pro hotovost automatu (povinné) — pokladna, do které se zapisuje hotovost z prodejů zaplacených automatem. Jednu pokladnu smí mít vybranou jen jeden automat.
  • Adresa zařízení (povinné) — adresa automatu v místní síti, začíná http:// nebo https://.
  • Uživatelské jméno (povinné) a Heslo — účet nastavený v automatu.
  • Ověřovat TLS certifikát — nechte vypnuté, pokud automat používá vlastní (self-signed) certifikát.

Konfigurace integrace hotovostního automatu s polem Kasa pro hotovost automatuZáložka Konfigurace hotovostního automatu. Adresa zařízení a uživatelské jméno jsou na snímku nahrazené.

Všechny funkce automatu (platby, výběr, vklad a doplnění hotovosti, správa hotovosti, stav zařízení, přehledy) spouští obsluha z pokladny, žádná neběží automatizací. Zápisy do pokladny popisuje stránka Pohyby pokladny.

Uložením integrace vznikne platební metodaHotovostní automat viditelná jen v administraci. Její stav řídí integrace: zapnutá integrace = metoda publikovaná, vypnutá = nepublikovaná. Smazáním integrace se metoda jen zneveřejní, starší objednávky na ni dál odkazují.

Dopravci ​

Adaptéry Balíkobot, Dropshipment (ESB), Výdejní box (ESB) a Bez dopravce. Uložením integrace této kategorie vznikne poskytovatel přepravy se stejným názvem a kódem a nabídne se v poli Poskytovatel přepravy u dopravy. Pozdější změna názvu se do poskytovatele propíše. Samotné přepravní firmy eviduje číselník Dopravci.

Integraci, kterou ještě používá některá doprava nebo výdejní box, nejde smazat. Systém vypíše kódy doprav a boxů, kterým je potřeba přiřadit jiného poskytovatele.

Balíkobot má v konfiguraci API uživatel, API klíč, Zdroj referenčního čísla, Mapování přepravních metod a Přihlašovací údaje podle skladu. V mapování se ke každé dopravě (Přepravní metoda) vybírá:

  • Dopravce (povinné) a Služba dopravce — podle nich se u Balíkobotu objednávají štítky,
  • Manipulační jednotka a Služba pro zpětnou zásilku,
  • Prohodit štítek,
  • Měna dobírky — nepovinné; prázdné pole znamená měnu dokladu. Vyplňte ji u přepravy do zahraničí, kde přepravce měnu dobírky ověřuje proti zemi doručení.

Panel mapování přepravní metody v integraci BalíkobotPanel Upravit mapování otevřený z konfigurace Balíkobotu. API uživatel je na snímku nahrazený.

Nabídky dopravců, služeb a manipulačních jednotek se načítají z vašeho účtu Balíkobotu, až je integrace uložená s platnými přihlašovacími údaji. Do té doby se dopravci a služby nabízejí z obecného seznamu a manipulační jednotky vůbec. Přihlašovací údaje podle skladu jsou pro lokace, které odesílají pod vlastním účtem Balíkobotu. Ostatní použijí údaje zadané nahoře.

Widget dopravce ​

Adaptér PPL – widget výdejních míst nese jediný údaj, API klíč mapy výdejních míst PPL. Integraci vybíráte u dopravy v poli Integrace PPL widgetu. Dokud ji některá doprava používá, nejde ji vypnout ani smazat. Systém ohlásí Integraci používá dopravní metoda: ….

Datové úložiště ​

Adaptér Google BigQuery průběžně kopíruje vybraná data do vašeho BigQuery pro reporting:

  • ID projektu Google Cloud a Dataset (povinné), Lokalita (výchozí EU) a Prefix tabulek,
  • Klíč servisního účtu (JSON) — celý klíč účtu s rolemi BigQuery Data Editor a BigQuery Job User,
  • Synchronizovaná data — oblasti ke kopírování. Dnes jsou to Pracovní výkazy (worklogy), tedy záznamy práce skladu: kdo, jakou činnost a na kterém dokladu.

Konfigurace nové integrace Google BigQueryZáložka Konfigurace nové integrace datového úložiště, vyplněná vymyšlenými hodnotami.

Každá vybraná oblast dostane vlastní automatizaci. Ta ve výchozím nastavení každých pět minut dopíše změněné záznamy a jednou denně (ve 3:00) tabulku nahradí celou, čímž z ní zmizí i záznamy smazané v Elasticru.

Datové úložiště zapíná dodavatel platformy

Kopírování do BigQuery je na instalaci za přepínačem funkce, který je ve výchozím stavu vypnutý a zapíná ho dodavatel platformy. Dokud je vypnutý, integrace se sice dá založit, ale její funkce svítí Nepodporováno a nic se nekopíruje.

Poskytovatel identity ​

Adaptér Microsoft EntraID zapne přihlášení do administrace firemním účtem. Údaje dodá správce vašeho tenantu Microsoft:

  • ID tenanta a ID aplikace (client ID) (povinné, ve tvaru GUID) — pod polem ID tenanta je vypsaná návratová adresa, kterou správce tenantu zaregistruje u aplikace,
  • Scope (povinné),
  • E-mailové domény (povinné) — jedna na řádek, porovnávají se přesně, subdomény je nutné vypsat zvlášť. Firemním účtem se přihlásí jen uživatel s adresou z těchto domén.
  • Vynutit SSO pro tyto domény — uživatelé z domén se pak nepřihlásí heslem ani si ho nenechají obnovit,
  • Adresa administrace — jen když administrace běží na jiném hostu než veřejný web (např. https://admin.example.cz).

Přechod na firemní přihlášení může smazat hesla

Samotné vynucení heslo jen zablokuje. Na vyžádání může dodavatel platformy při přechodu uživatelům z vynucených domén zneplatnit uložená hesla: dosavadní heslo pak nefunguje ani po vypnutí vynucení, všechna přihlášení v prohlížečích se ukončí a volitelně se zruší i jejich API tokeny. Krok nejde vrátit a lze ho provést jen při zapnutém vynucení.

Časté dotazy (FAQ) ​

Jaký je rozdíl mezi můstkem a exporty?

Exporty posílají data ven v podobě souboru nebo feedu. Integrace na můstku je propojení s konkrétním systémem nebo zařízením, které má vlastní adaptér a sadu funkcí.

Integrace je založená, proč nefunguje?

Zkontrolujte, že je Aktivní, že má v Konfiguraci vyplněné přístupové údaje, a na záložce Funkce, v jakém stavu je potřebná funkce. U funkce s automatizací ve stavu Nenastaveno nebo Chyba použijte Nastavit / opravit automatizaci.

Můžeme mít dvě integrace se stejným adaptérem?

Ano, každá má vlastní kód a konfiguraci. U terminálu a automatu je to dokonce pravidlo, jedna integrace na jedno zařízení.

Kde jsou poskytovatelé přepravy, které jsme měli dřív?

Stávající poskytovatelé přepravy se převedli na integrace kategorie Dopravci se stejným názvem a kódem, zapnuté a s dosavadním nastavením. Dopravy na ně dál odkazují.

Proč nevidím uložený API klíč?

Tajné údaje se po uložení nezobrazují. Když pole necháte prázdné, klíč zůstane beze změny.

Související dokumentace ​