Přeskočit na obsah
SECAPRO Professional Intelligent Technology
577 440 325
Centrum znalostí

Jak propojit elektronickou vrátnici s ERP: co teče kterým směrem a na co se zeptat předem

Zdeněk Juřica — odborný garant19. 8. 2026Integrace a IT

Elektronická vrátnice se s ERP propojuje dvěma cestami: strojovým rozhraním (API), nebo — pokud ERP žádné použitelné rozhraní nenabízí — pravidelným importem souboru. Z ERP do vrátnice tečou avíza o závozech, dodací listy a referenční čísla, aby řidič u brány nemusel nic přepisovat; vrátnice pak každý průjezd spáruje s avízem a vede jeho historii s doloženými časy, o kterou se dá opřít příjem zboží i řešení sporných situací. O úspěchu integrace přitom nerozhoduje technologie, ale pořadí kroků: nejdřív ověřit rozhraní druhé strany, teprve potom cokoli slíbit.

Tenhle článek je psaný pro IT oddělení a správce podnikových systémů. Popisuje, jaká data se typicky vyměňují, čím je výměna zabezpečená, jak poznat poctivou nabídku integrace a jaké otázky si vyjasnit dřív, než se integrace objeví v rozpočtu projektu.

Proč vrátnici napojovat na ERP

Bez propojení vede areál dvě evidence téhož. ERP ví, že dnes má dorazit závoz ke konkrétní objednávce s konkrétním referenčním číslem. Vrátnice ví, že k bráně přijelo vozidlo s určitou registrační značkou (dále SPZ). Dokud spolu tyhle dvě evidence nemluví, spojuje je člověk: řidič diktuje číslo dodacího listu, obsluha ho přepisuje do formuláře, překlepy se dohledávají telefonem a příjem zboží pracuje s jinými časy než vrátnice.

Propojení tuhle ruční spojku odstraňuje. Vrátnice dopředu ví, jaký závoz očekává a k jakému dokladu patří, takže řidič při odbavení nic nevyplňuje — systém ho spáruje s avízem sám. Jak celé odbavení vypadá z pohledu provozu, popisuje stránka elektronické vrátnice; přehled všech typických napojení — vedle ERP a WMS také docházka, plánování dopravy nebo kalendáře — shrnuje stránka integrace na podnikové systémy.

Co teče kterým směrem

Základem návrhu integrace je tabulka datových toků: konkrétní údaje, směr a účel. Ne „propojíme systémy“, ale „tato pole potečou tímto směrem, protože…“.

Z ERP nebo WMS do vrátnice (avízo):

  • Údaje o závozu — kdo přijede, kdy a k jaké objednávce. Vrátnice díky nim rozliší ohlášený závoz od neohlášeného.
  • Dodací listy a referenční čísla — klíč, kterým se fyzický průjezd spáruje s dokladem. Právě tady vzniká hlavní přínos: řidič čísla nediktuje a obsluha je nepřepisuje.
  • Identifikace vozidla nebo dopravce — typicky SPZ, pokud je dopředu známá. Systém při příjezdu registrační značku rozpozná (LPR — automatické rozpoznávání registračních značek) a vozidlo spáruje s avízem bez zásahu řidiče.

Z vrátnice (potvrzení průjezdu):

  • Spárování průjezdu s dokladem — který dodací list dorazil kterým vozidlem. Právě tahle vazba je protikusem avíza: fyzický průjezd se spojí s referenčním číslem z ERP.
  • Historie průjezdů s doloženými časy — skutečné časy příjezdu a odjezdu, ne odhadované. Historie se dá exportovat z administrace a slouží při reklamacích i vyhodnocování dopravců.
  • Vážní lístek — kde je součástí procesu vážení, naváže se na tentýž průjezd a dodací list i vážní lístek, který vzniká automaticky; detail uvádí stránka integrace na podnikové systémy.

Zda a v jakém rozsahu se tato potvrzení zapisují automaticky zpět do ERP, se ověřuje v konkrétním projektu podle rozhraní protistrany — obdobný zpětný zápis dnes funguje například u docházkových systémů (zápis příchodu). Do zadání proto patří i otázka, jestli potvrzené průjezdy stačí vést v evidenci vrátnice s exportem, nebo je má ERP přebírat automaticky.

Platí přitom jednoduché pravidlo o zdrojích pravdy: obchodní data (objednávky, doklady, partneři) vlastní ERP, časy a fyzickou přítomnost vozidel vlastní vrátnice. Integrace data předává, nikdy je neudržuje na dvou místech zároveň. A pokud areál řídí i rampy, navazuje výměna dat na plánování ramp a časových oken — avízo z ERP pak není jen záznam pro vrátnici, ale rovnou podklad pro rezervaci konkrétního slotu.

API, nebo import souboru

Strojové rozhraní (API) je první volba, když má ERP dokumentované rozhraní a někdo za ně na straně zákazníka odpovídá. Rozhraní systému SECAPRO je typu M2M (machine-to-machine): protistrana může ohlásit vozidlo, dotázat se na plán nebo ověřit povolení vjezdu podle SPZ. Přístup je zabezpečený API klíčem i tokenem (JWT) a dokumentaci rozhraní poskytujeme k projektu. Rozhraní stavíme podle systému zákazníka, ne obráceně.

Import souboru je poctivá druhá volba pro případy, kdy ERP žádné použitelné rozhraní nemá, nebo kdy jeho zpřístupnění naráží na licence či kapacitu dodavatele ERP. Dohodne se formát, obsah a interval a data se přenášejí v dohodnutých dávkách. Platí se za to nižší aktuálností dat; pro řadu provozů je to ale přiměřené řešení, které se nasazuje rychle a bez zásahu do ERP.

Za pozornost stojí i cesta, kudy data tečou. Řídicí platforma PSA (průjezdový systém areálu) běží ve vyhrazené síti, databáze není vystavená ven a žádná komponenta není přímo dostupná z veřejného internetu; data z veřejného rezervačního portálu tečou dovnitř šifrovaným tunelem. Podrobný popis síťové architektury včetně používaných portů uvádí stránka řídicí platformy PSA — pro interní schválení integrace bývá právě tohle podklad, který IT oddělení potřebuje jako první.

Nejdřív ověřit, potom slíbit

Integrace je nejčastější místo, kde projekty automatizace vjezdu nabírají zpoždění. Obvyklý scénář: v nabídce se integrace objeví jako samozřejmost a teprve při realizaci se zjistí, že protistrana žádné použitelné rozhraní nemá — nebo že ho má, ale nikdo k němu nedodá dokumentaci ani přístup.

SECAPRO postupuje obráceně a stejnou metodiku doporučujeme vyžadovat po každém dodavateli:

  1. Před slibem chceme vidět dokumentaci rozhraní druhé strany. Ne ústní ujištění, že „to náš systém umí“, ale konkrétní popis: jaké operace, jaká pole, jaká autentizace.
  2. Chceme znát odpovědnou osobu. Interního správce systému nebo dodavatele ERP, který rozhraní zpřístupní a bude u testů. Bez ní se integrace nedá termínovat.
  3. Když rozhraní neexistuje, řekneme to rovnou — a navrhneme jinou cestu, typicky import souboru. Zamlčet to a doufat, že se to při realizaci nějak vyřeší, je nakonec dražší pro obě strany.
  4. Vývoj rozhraní vedeme jako samostatnou položku rozpočtu, ne skrytě v ceně licence. Zákazník vidí, co integrace stojí, a rozhodne, jestli ji chce hned, nebo až ve druhé etapě.

Poslední bod má praktický důsledek pro plánování: integrace se dá z první etapy vyjmout, aniž by se projekt zastavil. Vrátnice funguje i samostatně a napojení na ERP se doplní, až bude rozhraní protistrany připravené.

Checklist před projektem

Šest otázek, které si vyjasnit interně dřív, než se integrace objeví v poptávce. Odpovědi se dají zjistit předem — při realizaci pak nevzniká čekání na základní fakta.

  1. Jaký systém provozujeme? ERP, WMS, případně obojí — a který z nich má být zdrojem avíz.
  2. Jakou verzi? Rozhraní se mezi verzemi liší. Pokud je v plánu upgrade nebo výměna systému, patří to do zadání, protože rozhoduje o tom, kdy integraci stavět.
  3. Má systém dokumentované rozhraní? Existuje dokumentace API, exportů, nebo alespoň popsaná struktura dat? „Dodavatel říkal, že to jde“ není dokumentace.
  4. Kdo je za rozhraní odpovědný? Jméno a role — interní správce, nebo externí dodavatel. U externího dodavatele i to, jak se jeho součinnost objednává a co stojí.
  5. Jaká data mají téct kterým směrem? Konkrétní seznam polí a jejich účel. „Všechno obousměrně“ není zadání — každé pole navíc znamená testování a údržbu navíc.
  6. Jak často se mají data synchronizovat? Průběžně přes API, nebo v dávkách? Odpověď plyne z procesu: avíza na příští den snesou dávku, ověření povolení vjezdu potřebuje aktuální stav.

Kdy to nedává smysl

  • Pár závozů týdně. Při malém objemu je ruční založení avíza levnější než vývoj a údržba rozhraní. Evidence ve vrátnici samotné pro doložitelnost stačí; integrace se vyplácí až s objemem.
  • ERP těsně před výměnou. Rozhraní by se psalo dvakrát. Rozumnější je první etapu pokrýt importem souboru a API integraci navázat až na nový systém.
  • Avíza v ERP reálně nevznikají. Pokud objednávky závozů žijí v e-mailech a telefonátech, nemá integrace co přenášet. Nejdřív je potřeba dostat proces do systému, teprve potom stavět rozhraní — obráceně to nefunguje.
  • Nikdo na straně ERP nespolupracuje. Bez dokumentace a odpovědné osoby se integrace nedá seriózně slíbit ani termínovat. Poctivé řešení je import souboru nebo odklad do druhé etapy, ne slib v nabídce.

Časté dotazy

Napojíte se na naše ERP, i když jste ho ještě neintegrovali?

Rozhraní stavíme podle systému zákazníka, ne obráceně — nejsme vázáni na seznam podporovaných ERP. Podmínkou je dokumentované rozhraní na vaší straně a osoba, která ho zpřístupní. Bez toho nabídneme import souboru, ne slib.

Co když naše ERP žádné API nemá?

Řekneme to rovnou a navrhneme výměnu souborů: dohodnutý formát, obsah a interval. Je to méně aktuální než živé propojení, ale nasazuje se rychle a nevyžaduje zásah do ERP. Na API se dá přejít později, samostatnou etapou.

Jak je rozhraní zabezpečené?

Strojová rozhraní jsou zabezpečená API klíčem i tokenem (JWT). Platforma běží ve vyhrazené síti, databáze není vystavená ven a žádná komponenta není přímo dostupná z veřejného internetu; podrobnosti k síťové architektuře a portům uvádí stránka platformy PSA.

Kolik integrace stojí?

Konkrétní cena vzniká až po ověření rozhraní protistrany — dřív by šlo o odhad vydávaný za nabídku. Důležitější než samotné číslo je forma: vývoj rozhraní vedeme jako samostatnou položku rozpočtu, ne skrytě v licenci. Je tak vidět, co integrace stojí a co se dá odložit do druhé etapy.

Jak často se data synchronizují?

Podle povahy dat: přes API průběžně, importem souboru v dohodnutém intervalu. Frekvence je jedna z otázek, které se řeší před projektem, ne po nasazení — u avíz na další den stačí dávka, u povolení vjezdu je potřeba aktuální stav.

Dostanou naši vývojáři dokumentaci?

Ano, dokumentaci strojového rozhraní poskytujeme k projektu. Rozsah rozhraní roste s každou realizovanou integrací.

Pokud propojení s ERP zvažujete, popište nám v poptávce, jaký systém a jakou verzi provozujete — vrátíme se s návrhem rozsahu integrace a s tím, co k ní budeme potřebovat od vaší strany.

Související články