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

Co má obsahovat zadání integrace v tendru

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

Zadání integrace obstojí tehdy, když jmenuje konkrétní systém a jeho verzi, uvádí, zda k němu existuje dokumentace rozhraní a kdo je za ni na straně zadavatele odpovědný, tabulkou popisuje, jaká data mají téct kterým směrem a jak často, a požaduje integraci jako samostatnou položku rozpočtu. Věta „součástí dodávky je integrace na stávající systémy“ nedefinuje ani jedno z toho. Právě proto se z ní při realizaci pravidelně stává spor.

Tenhle text je psaný pro nákup a IT, kteří zadávací dokumentaci sestavují. Není to výklad pravidel zadávání zakázek a neřeší lhůty ani formality — jde o věcný obsah technické části: co musí být napsané, aby se nabídky daly porovnat a aby se odpovědnost za protistranu neztratila v pasivním rodu.

Proč jedna věta nestačí

Šest otázek, které si má zadavatel zodpovědět dřív, než integraci napíše do zadání — systém, verze, dokumentace, odpovědná osoba, směry dat a frekvence — rozebírá checklist pro IT před projektem integrace. Tenhle text je neopakuje. Řeší, co se s odpověďmi stane dál: jak se promítnou do technické části, co se k zadání přiloží a co se z toho stane akceptačním kritériem.

Bez těch odpovědí je výsledek předvídatelný. Opatrný dodavatel si integraci nacení s velkou rezervou, nebo ji z nabídky vyloučí a prohraje. Méně opatrný ji slíbí naslepo a zjišťování začne až u realizace. Nákup pak porovnává čísla, která nepopisují stejný rozsah práce.

Šest bodů níže je pořadí, ve kterém se odpovědi zapisují.

1. Jmenovitě systém a verze

Do zadání patří jmenovitý seznam systémů, na které se má napojovat, s uvedením verze a toho, kdo je provozuje — interní IT, nebo externí dodavatel. U každého systému stačí jeden řádek: název, verze, vlastník, agenda.

Pokud je některý systém před výměnou nebo upgradem, patří to přímo do zadání. Rozhoduje to o tom, jestli má rozhraní smysl stavět teď, nebo až ve druhé etapě — a poctivý dodavatel se na to stejně zeptá.

Přehled typických napojení — docházka, plánování dopravy, ERP a WMS, mostové váhy, přístupové systémy, Outlook a kalendáře — shrnuje stránka integrace na podnikové systémy. Ke každému se váže jiná sada polí, jiná frekvence a jiná protistrana.

2. Existuje dokumentace rozhraní?

U každého jmenovaného systému by zadání mělo uvádět, zda k němu existuje dokumentace rozhraní, a pokud ano, přiložit ji nebo popsat, jak ji uchazeč získá. Ústní ujištění správce nebo obchodníka druhé strany se do zadání přepsat nedá: uchazeč z něj nezjistí, jaké operace rozhraní nabízí ani čím se autentizuje, a nemá tedy co ocenit.

Když dokumentace neexistuje, není to důvod integraci ze zadání vyškrtnout — je to důvod napsat to nahlas. Zadání pak může požadovat variantu: strojové rozhraní, pokud se protistrana zpřístupní, nebo pravidelný import souboru v dohodnutém formátu a intervalu. Obě se dají nacenit, jen každá jinak. Co se nacenit nedá, je nejistota vydávaná za samozřejmost.

3. Odpovědná osoba na straně zadavatele

Skluz nevzniká na technice. Vedle chybějícího rozhraní protistrany — nejčastější příčiny, kterou popisuje stránka integrace na podnikové systémy — se v projektech opakuje i to, že u testů rozhraní není nikdo z druhé strany. Do zadání proto patří jméno nebo alespoň role odpovědné osoby ke každému systému: interní správce, nebo dodavatel, u kterého se součinnost objednává. V tendru se tahle odpověď píše dopředu, ne až při realizaci.

4. Tabulka datových toků jako příloha

Přílohou zadání je jednoduchá tabulka — pro každý datový tok jeden řádek: údaj — zdrojový systém — cílový systém — směr — frekvence — účel.

Příklad, jak takový řádek vypadá u vjezdu vozidel: registrační značka (dále SPZ) očekávaného závozu — ERP — vrátnice — jednosměrně dovnitř — dávka 1× denně na následující den — spárování příjezdu s avízem. Protikus téhož toku: skutečný čas vjezdu a výjezdu — vrátnice — ERP — ven — průběžně — doložení časů pro příjem zboží.

Co má takový řádek obsahovat v projektu s několika systémy — vedle polí a frekvence i odpovědnou osobu na obou stranách a chování při výpadku — rozebírá článek o napojení na sklad a dopravu. Tady jde o roli tabulky v zadávací dokumentaci.

Ta role je trojí. Tabulka je příloha, ne odstavec v textu — dá se připomínkovat a vrátit uchazečem doplněná. Přinutí zadavatele rozhodnout, co vlastně chce; obvykle se ukáže, že plná obousměrná výměna všech údajů nikomu nechybí, protože s každým polem navíc roste testování i údržba. A je to společný podklad pro nacenění: zadání může požadovat cenu k jednotlivým řádkům, takže nabídky jdou porovnat řádek po řádku.

Do tabulky patří i to, čím se vozidlo identifikuje — rozpoznáním SPZ (LPR — License Plate Recognition), RFID kartou, nebo QR kódem. Klíč, kterým se záznamy párují, je součást datového toku, ne detail k dořešení.

5. Integrace jako samostatná položka rozpočtu

Zadání by mělo výslovně požadovat, aby byl vývoj každého rozhraní vyčíslen samostatnou položkou, ne skryt v ceně licence nebo v souhrnné částce za software. Důvody jsou dva.

První: souhrnná částka se nedá kontrolovat. Když je integrace samostatně, je vidět, co stojí, a lze ji porovnat napříč nabídkami. Stejnou logiku sleduje i příprava business case automatizace, kde je položkový rozpočet nástroj kontroly, ne administrativní ozdoba.

Druhý: samostatná položka se dá odložit. Když se u některého systému ukáže, že rozhraní chybí nebo že jeho dodavatel nemá kapacitu, vyjme se ta jedna položka a projekt běží dál. Vrátnice i recepce fungují i bez napojení na podnikové systémy. Je-li integrace rozpuštěná v licenci, tahle možnost neexistuje: položku už nejde odložit, aniž by se měnil rozsah dodávky.

6. Historie, export a co zůstane po skončení

Poslední bod se v zadáních vynechává často a zpětně se dodělává obtížně: co systém o proběhlých událostech uchová a v jaké podobě to zadavatel dostane ven.

Do zadání patří požadavek na historii s filtrováním a na export dat v běžném formátu — u průjezdů čas, směr, SPZ a snímek, u Modulu Logistika čekání, délka nakládky a doba v areálu. Export historie do tabulky (u plánování ramp do Excelu) je odpověď na dvě situace, které přijdou později: audit a spor s dopravcem nebo pojišťovnou. Jak taková evidence vypadá v provozu, popisuje stránka řídicí platformy PSA (průjezdový systém areálu) — u každého průjezdu je vidět, jestli ho povolil systém, nebo obsluha, a kdo závoru otevřel.

Sem patří i zabezpečení strojových rozhraní — u SECAPRO jsou chráněná API klíčem i tokenem (JWT) — a to, co se s rozhraním stane při aktualizaci systému.

Dvě formulace, na kterých zadání stojí

Šest bodů výše popisuje, co se do technické části zapíše. Zbývají dvě formulace, na kterých stojí převzetí díla a objednávka práce na druhé straně.

Akceptační kritérium se skládá z tabulky. Místo obecného „integrace je funkční“ se do zadání dá napsat kritérium, které jde odškrtat: integrace je splněná tehdy, když každý řádek přílohy prokazatelně teče v deklarované frekvenci a zůstane po něm záznam, který jde vyexportovat. Přejímka se tím přesune z debaty nad dojmem na kontrolu seznamu. Jak takový test postavit jako jeden souvislý provozní průchod, popisuje článek o třech systémech a třech dodavatelích.

Součinnost cizího dodavatele je položka zadání, ne poznámka pod čarou. Rozhraní zpřístupňuje dodavatel druhého systému, ne uchazeč. Do zadání proto patří tři údaje: kdo je protistrana (jmenovitě), kdo její součinnost objednává a kdo ji hradí. Bez nich nemá tahle práce v rozpočtu nositele — uchazeč ji objednat nemůže, protože s cizím dodavatelem nemá smlouvu, a zadavatel s ní nepočítal.

Hodnocení došlých nabídek je jiná úloha a tenhle text ji neřeší. Otázky na dodavatele vrátnice a na otevřenost jeho rozhraní shrnuje checklist v článku o tom, co má umět API elektronické vrátnice; co má obsahovat kontrolovatelná nabídka, popisuje článek o chybách při automatizaci vrátnice.

Kdy to nedává smysl

Ne každý požadavek na integraci se dá napsat tak, aby v zadání obstál:

  • Vlastník systému není známý. Když zadavatel neví, kdo systém provozuje a kdo k němu má přístupová práva, nemá koho uvést jako protistranu. Do vyjasnění je poctivější požadovat variantní ocenění než jmenovat nepotvrzené rozhraní.
  • Zadavatel nemá mandát objednat součinnost cizího dodavatele. Když smlouvu s dodavatelem druhého systému drží jiná část firmy, nemá požadavek komu adresovat. Nejdřív se vyjasní, kdo součinnost objedná a zaplatí.
  • Technická část vzniká kopií staršího zadání. Seznam přepsaný z minulého tendru je bez verzí a bez vlastníků a při realizaci se z každého řádku stane dotaz. Jedna schůzka s interním správcem systémů tomu předejde.
  • Požadavek na integraci, kterou vlastník druhého systému neschválí. Je-li předem známo, že protistrana rozhraní nezpřístupní, není co zadávat. Do zadání pak patří import souboru, nebo odklad do samostatné etapy.

Situace, kdy se integrace nevyplatí sama o sobě — malý objem závozů, systém těsně před výměnou, proces, který v žádném systému nežije — shrnuje článek o propojení vrátnice s ERP. Pravidlo z toho plyne jednoduché: co se nevyplatí, se do zadání nepíše ani „pro jistotu“.

Časté dotazy

Musíme v zadání jmenovat konkrétní systémy?

Popis systémů, které dnes provozujete, je popis výchozího stavu — bez něj se integrace nedá nacenit. Jak se tenhle popis do zadávacích podmínek promítne po právní stránce, posuďte s tím, kdo u vás zakázku administruje; my se k tomu nevyjadřujeme. Věcně se uchazeči liší v tom, jak napojení postaví, ne v tom, jaký systém u vás běží.

Co když u některého systému dokumentaci rozhraní nemáme?

Napište to do zadání tak, jak to je, a požádejte o dvě varianty ocenění: strojové rozhraní za předpokladu součinnosti druhé strany a pravidelný import souboru jako záložní cestu. Získáte porovnatelné nabídky místo rezerv schovaných v ceně.

Jak v zadání ošetřit, že rozhraní zpřístupňuje cizí dodavatel?

Uveďte ho jmenovitě jako protistranu a napište, kdo jeho součinnost objednává a kdo ji hradí. Bez toho ji uchazeč buď nacení „pro jistotu“, nebo ji z nabídky vypustí.

Můžeme integraci zadat až v druhé etapě?

Ano, a u víc systémů to bývá rozumné. Podmínkou je samostatná položka v rozpočtu a dodávaná technologie s otevřeným strojovým rozhraním — druhá etapa se dá postavit jen na něm.

Podle čeho poznáme, že je integrace hotová?

Podle tabulky datových toků: každý její řádek prokazatelně teče v deklarované frekvenci a dá se to doložit záznamem — ne „systémy spolu komunikují“.

Patří do zadání i to, co se stane po nasazení?

Ano. Rozhraní žije dál: mění se verze systémů, přibývají pole. Do zadání proto patří i to, kdo bude rozhraní udržovat a jak se to promítne do servisní smlouvy.

Pokud zadání integrace teprve píšete, pošlete nám seznam systémů, které provozujete — vrátíme se s tím, jaké údaje k nim budeme potřebovat a co se dá ověřit ještě před vypsáním tendru. Rozsah dodávky si můžete předtím naklikat v konfigurátoru.

Související články