Úložiště dat o uvádění POR na trh - zápis
(JUP_INSPOH01A)
Služba pro zápis a aktualizaci pohybů v Úložišti dat o uvádění POR na trh. Distributoři přípravků na ochranu rostlin touto službu plní oznamovací povinnost vůči MZe a ÚKZÚZ.
Název služby | Úložiště dat o uvádění POR na trh - zápis (JUP_INSPOH01A) |
---|---|
Popis služby | Služba pro zápis a aktualizaci pohybů v Úložišti dat o uvádění POR na trh. Distributoři přípravků na ochranu rostlin touto službu plní oznamovací povinnost vůči MZe a ÚKZÚZ. |
Verze služby | 01A |
Způsob autorizace |
PF -
služba vyžaduje autorizaci na základě WS klíče, který je možné získat po přihlášení na eAGRI. Autentizace je řešena hashovanou zprávou, kdy je do requestu vkládán unikátní HASH requestu. Postup pro generování HASHe je zde. Místo hashované zprávy je také možné použít certifikát. Veřejnou část certifikát je nutné nejdříve ve spolupráci s HD MZe do prostředí MZe importovat.
|
Datový model služby | Datový modely služby obsahuje podrobné popisy jednotlivých elementů, které jsou na vstupu nebo výstupu služby. Před implementací služby je vhodné se s obsahem datového modelu seznámit. prod test |
WSDL služby | prod test |
Adresy serverů | test: https://epomzetest.gov.cz/ssl/nosso-app/EPO/WS/v2Online/vOKOsrv.ashx prod: https://epomze.gov.cz/ssl/nosso-app/EPO/WS/v2Online/vOKOsrv.ashx |
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ů:
Označení pohybu |
Popis pohyby a jeho specifikace |
---|---|
1 |
Naskladnění přípravku na svůj sklad od jiného registrovaného distributora.
Je povinné uvést IČO dodavatele (registrovaného distributora). Může být uvedeno i jeho SZRID pokud distributor nemá přiděleno IČO. |
2 |
Vyskladnění přípravku ze svého skladu. Vyskladnění může být jinému distributorovi nebo koncovému uživateli.
Uvádí se IČO odběratele nebo označení odběratele textově pokud subjekt IČO nemá. Je možné uvést i SZRID subjektu. |
3 |
Vývoz přípravku mimo území Evropské unie nebo přemístění mimo území ČR.
Označení zahraničního odběratele se uvádí textově. Takto evidovaná balení POR jsou v JUP označena jako nedostupná – mimo trh s POR v ČR. |
4 |
Skladová ztráta u distributora POR.
Označení druhé strany se neuvádí. |
5 |
Aplikace POR u distributora, kdy sám distributor je zemědělský subjekt, které POR využil v rámci vlastní zemědělské činnosti.
Označení druhé strany se neuvádí. |
6 |
Vyskladnění za účelem přebalení.
Uvádí se IČO odběratele nebo SZRID subjektu. |
7 |
Typ pohybu pokrývající následující pohyby:
Uvádí se IČO druhé strany nebo označení druhé strany pokud subjekt nemá IČO. |
8 |
Vratka od zemědělce.
Uvádí se IČO zemědělce/odběratele nebo textově pokud subjekt nemá IČO. Je možné uvést i SZRID. |
Ú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í:
|
Základní jednotka |
Základní jednotka |
Minimální základní jednotka |
Typ balení |
Krabice |
Karton |
Kanystr |
Popis balení |
Papírová krabice obsahující 2 kartony |
Papírový karton obsahující 4 PE kanystry |
PE kanystr s obsahem 1 litr přípravku |
Celkový objem |
8 |
4 |
1 |
Vlastní GTIN |
Ano |
Ano |
Ano |
Šarže |
Pro všechny základní jednotky je šarže stejná |
||
Datum výroby |
Pro všechny základní jednotky je datum výroby |
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ů
Zkratka | Popis |
---|---|
JUP | Jednotné úložiště pohybů je informační systém Ministerstva zemědělství ČR, kde jsou shromažďovány pohyby přípravků na území ČR, které jsou klasifikovány pro použití profesionálními uživateli a pohyb a povinnost plnění JUP se vztahuje na registrované distributory POR v ČR. |
základní jednotka | Jedná se o balení POR s kterým lze samostatně obchodovat a je možné jej identifikovat 2D matrix kódem dle specifikace GS1. |
minimální základní jednotka | Jedná se o základní jednotku, kterou již nelze dále dělit. Obvykle se jedná o barel, kanystr, pytel jehož poškozením se stává POR neprodejný. |
POR | Přípravek na ochranu rostlin |
GTIN | 14 místný identifikátor každé základní jednotky. Identifikátor může být pro stejné základní jednotky totožný. |
Katalog GTIN kódů |
Katalog, který definuje veškeré základní jednotky. K základní jednotce se v tomto katalogu eviduje:
|
Registrovaný distributor POR | Právnická osoba registrovaná na ÚKZÚZ s přiděleným registračním číslem. |
Dávka pohybů | Jedná se o souhrn pohybů POR, které jsou předány do systému JUP. V dávce může být 1 nebo N samostatných pohybů. |
Pohyb POR |
Jedná se o specifikaci pohybu základní jednotky v rámci skladové evidence registrovaného distributora POR u POR, které jsou určeny pro profesionální použití a jsou označeny 2D kódem. Neevidují se tak malobalení. |
Seznam možných chyb rozhraní
kód chyby | popis chyby |
---|---|
101 | Pohyb xxx nebyl nalezen. Nelze provést smazání pohybu. |
102 | neobsazeno |
103 |
Volání obsahuje duplicitní kód pohyby: xxx.
Předaná dávka obsahuje několik shodných kódů pohybu (TRANSFER_ID). Toto není přípustný stav a každá dávka musí obsahovat neduplicitní kód pohybu. |
104 | Pro pohyby 1, 6 musí být zadané IČO druhé strany. |
105 | neobsazeno |
106 | Pro pohyb 7 musí být k GTIN kódu uvedena data v katalogu POR. |
107 |
Data katalogu mohou být ovedena jen pro pohyb 7.
V rámci pohybu jsou uvedeny data pro zápis do katalogu. Zápis do katalogu je možné realizovat pouze pohybem č. 7. Ověřte, že ve volání nejsou data pro katalog uvedena. |
108 | neobsazeno |
109 | neobsazeno |
110 | Nelze měnit měrnou jednotku POR u GTIN kódu v katalogu. Katalog již obsahuje jinou měrnou jednotku. GTIN: xxx |
111 | Nelze měnit velikost balení POR u GTIN kódu v katalogu. Katalog již obsahuje jinou velikost balení. GTIN: xxxx |
112 | neobsazeno |
200 |
Struktura katalogu obsahuje duplicitní GTIN: xxx
Chyba nastává pokud je struktura katalogu předána tak, že jsou vnořeny GTIN kódy, které mají stejnou hodnotu. Je nutné ověřit, že je správně definována hierarchie jednotlivých GTIN kódů. |