Úložiště dat o uvádění POR na trh - zápis
(JUP_INSPOH01A)

Popis služby

Služba slouží k předávání informaci o pohybu přípravků na ochranu rostlin dle návrhu zákona o rostlinolékařské péči do Jednotného úložiště pohybů (JUP). Oprávnění zápisu do JUP je přiděleno registrovaným distributorům POR.

Základní funkčnosti webové služby

• Vložení údajů o pohybu.
• Výmaz dříve zadaného pohybu.
• Aktualizace údajů o pohybu (doplnění např. šarže nebo úprava množství).
• Zápis do Katalogu GTIN pro typ pohybu 7 (typy pohybů jsou vysvětleny níže).

Vložení pohybu probíhá sestavením datové věty na straně skladového SW distributora POR.

Pohyby je možné zasílat průběžně dle změn ve skladovém SW (v jedné dávce jeden pohyb) nebo jednorázově za období např. 1 den/12 hodin (v jedné dávce je poté N pohybů).

Uložení pohybu v prostředí JUP je potvrzeno standardní SOAP odpovědí s vyplněným elementem STATUS = OK. Pokud není volání služby validní je vrácena chyba validace nebo SOAP error a záznam do systém JUP není zapsán a je považován jako neodeslaný.

Příklady volání jsou uvedeny v přílohách tohoto článku. Některé charakteristiky ke struktuře dat jsou rozepsány dále v textu.

Jednoznačný identifikátor pohybu

Každý pohyb, který je do JUP zapsán musí být identifikován jednoznačným identifikátorem pohybu (ve struktuře služby se jednáno o element TRANSFER_ID). Strukturu a hodnotu si definuje distributor POR na straně svého skladového SW. Jeho hodnota není ze strany JUP předepsána. Je pouze stanovena maximální délka tohoto identifikátoru, která je 100 znaků.

Jednoznačný identifikátor pohybu je možné využívat pro čtení výsledku zpracování pohybu. Je tak možné zpětně získat informace o výsledku zpracování pohybu a zobrazit detailní informace k případné chybě pohybu.

Jednoznačný identifikátor pohybu je také určen k opravným zápisům k pohybu v JUP a případně je možné provést výmaz pohybu.

Výmaz pohybu je možné provést uvedením původního identifikátoru pohybu v requestu služby, ale s neuvedením elementu ITEMS. Pokud bude původní identifikátor requestu dohledán, tak systém provede výmaz pohybu. Pokud by původní identifikátor pohybu nebyl nalezen, tak se vrací chyba 101.

Komentář k položce ITEMS ve WSDL (Seznam položek přípravků. Pokud se jedná o aktualizaci pohybu, tak neuvedením žádné položky dojde k výmazu celého pohybu.)

Na straně JUP existuje omezení, kdy v rámci jedné dávky není možné zaslat pohyby se stejným TRANSFER_ID. Pokud tedy systém chce provést aktualizaci pohyby nebo jeho výmaz musí tak učinnit v jiné dávce. Toto omezení má také za cíl zablokovat potencionálně chybné dávky, které jsou chybně založeny nad stejným TRANSFER_ID.

Specifikace typu pohybu

Pro každý pohyb se specifikuje jeho typ. Dle typu pohybu se provádí kontroly nad úplností dat v dávce. Typ pohybu také určuje bilanční výpočet stavu konkrétních POR u distributora POR.

Distributor službou oznamuje následující typy pohybů:

Údaje o balení POR

Nejmenší sledovaná balení POR (základní jednotka) je specifikována jako unikátní kombinace těchto tří údajů:

• GTIN (určuje obchodní jednotku konkrétní POR včetně velikosti balení a vazbě na Registr přípravků),
• šarže,
• datum výroby.

Tyto tři údaje specifikují nejmenší sledovanou položku (základní jednotku) v systému JUP. Pro pohyb položky se stejnými údaji se uvádí pouze množství bez nutnosti uvádět každé balení odděleně.

Specifikace velikosti balení

Při předávání informací o pohybu základní jednotky do systému JUP je možné specifikovat množství:

• počtem obchodních jednotek nebo
• množstvím v měrných jednotkách.

Ukázka evidence pohybu dvou 5 litrových kanystrů základní jednotky je následující:

• při evidenci v obchodních jednotkách bude v elementu NUMBER_OF_PACKAGES hodnota 2,
• při evidenci množství v měrných jednotkách bude v elementu QUANTITY hodnota 10.

Množství v měrných jednotkách je vztahován vůči údajům v Katalogu GTIN kódů, kde jsou údaje o měrné jednotce základní jednotky. Hlášení, kdy výpočet množství v měrné jednotce nelze propočítat na obchodní jednotky je prohlášen jako chybný (např. pokud by bylo v příkladu výše zaslána místo hodnoty 10 hodnota 8).

Systém JUP vnitřně dopočítává obě formy množství, které musí být v souladu.

Aby bylo zamezeno nesrovnalostem v počtu množství je nutné každý pohyb zasílat na existující hodnotu v katalogu GTIN.

Pohyb 7 je možné zaslat na existující GTIN nebo pohybem 7 nový GTIN do katalogu založit.

Specifikace sdružených balení

Obchod s přípravky na OR je často založen na sdružených baleních. Hlášení do JUP vychází z pohybů základních jednotek. Základní jednotka se může skládat z dalších základních jednotek až po minimální základní jednotku, která se již nedá dále dělit a musí být distribuována jako celek.

Členění sdruženého balení:

Definice vazeb u sdružených balení je součástí Katalogu GTIN kódů, kde se eviduje struktura sdružených balení.

Seznam zkratek a vysvětlení některých pojmů

Seznam možných chyb rozhraní