InnerWeb
Přejít na obsah

Integrace avizace dodávek přes SOAP: poznámky k nasazení

Načítání údajů o dodávce podle kódu karty funguje přes SOAP a vyžaduje implementační práce na obou stranách. IT klienta a dodavatel systému avizace by před spuštěním měli sjednat několik věcí: klíč, rozsah polí, chování u neznámých kódů a přístup k telemetrii.

5
etap nasazení integrace
Zdroj: doporučení pro nasazení
5 znaků
kanonický kód karty avizace
Zdroj: karta funkce dodávek

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)

Příkladový podíl práce v etapách integrace (kalkulace příkladu)Sloupcový graf: kontrakt 15 procent, přístup 15, mapování 25, testy 30, zkušební provoz 150102030%Kontrakt SOAP: 15 %15 %Kontrakt SOAPPřístup a prostředí: 15 %15 %Přístup aprostředíMapování polí: 25 %25 %Mapování políTesty: 30 %30 %TestyZkušební provoz: 15 %15 %Zkušební provoz
Zdroj: Kalkulace příkladu: předpokládané rozdělení práce, nejde o data klienta

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