Rozsah integrace a co neslibujeme
Modul Dodávky a avizace v InnerWeb po zadání kódu karty načítá ze systému avizace klienta údaje plánované dodávky a předvyplňuje formulář. Integrace funguje přes SOAP. Neslibujeme integraci s libovolným systémem avizace bez implementačních prací, protože každý systém má vlastní pole, omezení a způsob vracení dat.
InnerWeb je nezávislý systém, který doplňuje stávající systémy klienta. Systém avizace zůstává zdrojem plánu dodávek a naše strana odpovídá za zpracování údajů a chování na bráně.
Etapy nasazení postupně
Pořadí prací má význam, protože mnoho problémů se projeví až na bráně, když řidič čeká. Doporučujeme pět etap.
- Etapa 1: sjednání kontraktu služby SOAP, tedy vstupních a výstupních polí
- Etapa 2: technický přístup a testovací prostředí na straně systému avizace
- Etapa 3: mapování polí avizace na pole dodávky v InnerWeb
- Etapa 4: testy na skutečných, neexistujících a ukončených kódech dodávek
- Etapa 5: zkušební provoz na jedné bráně se zapnutou telemetrií vyhledávání
Příkladový podíl práce v etapách integrace (kalkulace příkladu)
Dohody, bez kterých integrace nevyjde
Níže uvedené body je nejlépe zapsat do protokolu o dohodě a podepsat na obou stranách, než začne první test.
Spojovací klíč a formát kódu
Kód karty avizace je samostatné pole dodávky a slouží jako klíč, který spojuje dodávku v InnerWeb se záznamem v systému avizace klienta. Dotaz jde jediným kanonickým pětiznakovým kódem a úvodní nuly zadané ochrankou výsledek nemění. Dodavatel systému avizace musí potvrdit, že tento formát odpovídá jeho kódům.
Chování u neznámých kódů a ukončených přeprav
Externí systém umí u neznámých kódů vrátit poslední ukončenou přepravu. Proto je dodávka s ukončenou přepravou v systému avizace záměrně brána jako chybějící údaj, aby nedošlo k chybné identifikaci řidiče a problému podle GDPR. Dodavatel by měl popsat, jak jeho služba reaguje na neznámý kód, a tým IT klienta to má ověřit testem.
Povinná pole a chybějící údaje
Typ operace z avizace určuje štítek dodávky a název místa obsluhy se páruje s kódy skladů a doků. Pokud avizace neobsahuje přepravce, systém dosadí náhradního přepravce. Vyplatí se sjednat, která pole avizace jsou na straně dodavatele povinná, aby chybějící přepravce nebyl pravidlem.
Typické úskalí nasazení
První úskalí je neshoda názvů míst obsluhy s kódy doků v InnerWeb. Párování probíhá podle názvu, takže rozdíl v zápisu znamená dodávku bez přiděleného skladu. Před testy je nutné sjednotit číselníky.
Druhé úskalí je doba odezvy služby. Ochranka nebude u brány čekat desítky sekund na odpověď. Telemetrie zapisuje dobu odezvy každého vyhledávání, takže hranice přijatelné doby je vhodné stanovit ještě před spuštěním, na základě dat z testů.
Třetí úskalí jsou servisní okna systému avizace. Pokud je služba v noci nedostupná a závod pracuje nepřetržitě, ochranka potřebuje postup pro ruční založení dodávky, protože chybějící odpověď systému znamená chybějící údaje.
Telemetrie jako součást dohod
Každé vyhledávání podle kódu karty avizace se zapisuje do telemetrie: kód, výsledek, stav, doba odezvy a zdroj. Je vhodné hned s dodavatelem dohodnout, že tyto záznamy budou základem pro projednávání hlášení o nefunkčních kartách. Spor o to, kdo má pravdu, pak skončí u čísel.
K dohodám patří také ochrana údajů: kdo vidí kódy karet, jak dlouho záznamy uchováváme a kdo může požadovat jejich nahlédnutí. Ujednání je vhodné konzultovat s inspektorem ochrany osobních údajů klienta.
Videomateriál
Často kladené otázky
Je integrace se systémem avizace hotová ihned?
Ne. Integrace funguje přes SOAP a vyžaduje implementační práce na obou stranách. Bez nich neslibujeme integraci s libovolným systémem avizace.
Co s dodávkou, jejíž přeprava byla v systému avizace ukončena?
Je záměrně brána jako chybějící údaj, protože externí systém může u neznámých kódů vrátit poslední ukončenou přepravu, což by ohrozilo správnou identifikaci řidiče.
Co má ochranka dělat, když je služba avizace nedostupná?
Založit dodávku ručně podle připraveného postupu. Chybějící odpověď systému se bere jako chybějící údaje.
Zdroje
Naplánujme integraci s vaším systémem avizace
Domluvme schůzku s naším týmem. Společně s vaším IT oddělením a dodavatelem avizace sepíšeme kontrakt a etapy prací.
Pojďme si promluvit