Úložiště dat o uvádění POR na trh - čtení
(JUP_GETPOH01A)
Služba vrací zadané pohyby v Úložišti dat o uvádění POR na trh. Informace jsou opatřeny vazbou na registraci POR a případně je uvedena chyba pohybu. Součástí odpovědi jsou i pohyby, které jsou zadány jiným distributorem vůči subjektu, který službu volá.
Název služby | Úložiště dat o uvádění POR na trh - čtení (JUP_GETPOH01A) |
---|---|
Popis služby | Služba vrací zadané pohyby v Úložišti dat o uvádění POR na trh. Informace jsou opatřeny vazbou na registraci POR a případně je uvedena chyba pohybu. Součástí odpovědi jsou i pohyby, které jsou zadány jiným distributorem vůči subjektu, který službu volá. |
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 získání údajů o pohybech, které jsou uloženy v Jednotném úložišti pohybů (dále JUP).
Každý distributor, který provádí zápis pohybů do systému JUP (webovou službou nebo přes GUI) může zpětně ověřit informace o pohybu uložených v systému JUP.
Dále službu může využít každý subjekt, která není distributor, ale vůči němuž je v systému JUP zaznamenán pohyb. Službu tak může využít např. zemědělský podnikatel, který tak získá popisné údaje ke všem předaným balením od distributora. Podmínkou je, aby pohyb ze strany distributora byl zapsán na IČ zemědělského subjektu.
Základní funkčnosti webové služby
- Stažení zadaných pohybů ze strany distributora dle vstupního filtru služby,
- stažení pohybů, které byly zadány na subjekt, který službu volá.
Parametry na vstupu služby
element BUSINESS_PARTNER_ID
Umožňuje vyhledat pohyby, kde je druhá strana evidována pomocí IČ a toto IČ odpovídá vstupnímu filtru. Filtrace slouží pro distributora k dohledání pohybů, které zadal ním pověřená osoba, která za distributora provádí zápis do systému JUP.
element TRANSFER_ID
Služba vrací pohyb, který odpovídá uvedené hodnotě. V případě, že pohyb není dohledán se vrací prázdné XML. Služba nevrací žádnou business chybu.
element TRANSFER_TYPE
Služba vrací pohyby odpovídající definovanému typu:
1. naskladnění,
2. vyskladnění,
3. vývoz,
4. skladová ztráta u distributora,
5. aplikace POR u distributora,
6. vyskladnění za účelem přebalení,
7. dovoz ze třetí země/přemístění v rámci EU/nákup od výrobce/uvedení POR po přebalení/,
8. vratka od zemědělce.
element TRANSFER_DATE_FROM/TO
Element slouží k vyhledání pohybů, které byly provedeny v období uvedeném v requestu.
element TRANSFER_INSERT_FROM/TO
Element slouží k vyhledání pohybů, které byly vloženy do JUP v uvedeném období.
element SEARCH_TYPE
Element slouží k vyhledání směru pohybu:
hodnota 1 = vlastní pohyby zadané distributorem (nebo jím pověřenou osobou), který službu volá. V response se plní element OWN_TRANSFERS,
hodnota 2 = pohyby, kde je subjekt, který službu volá uveden jako druhá strana. V response se plní element BUSINESS_PARTNER_TRANSFERS.
Pokud není typ uveden, tak služba vrací oba směry pohybů.
V případě optimalizace rychlosti vyhledávání je možné pomocí elementu řídit rozsah odpovědi.
element TRANSFER_STATE
Pomocí elementu je možné vyhledávat pouze pohyby s chybou. Bez uvedené elementu se vrací všechny pohyby.
element APPEND_GTIN_METADATA
Vstupní parametr ovlivňuje, zda se v response vrací k GTIN balení i údaje z katalogu a registrace POR.
element DISTRIBUTOR_ID
Vstupní parametr je určen pro zástupce distributora. Tímto vstupním parametrem si zástupce vyhledává pohyby, které jsou v systému evidovány pod identitou distributora. Hodnota je SZRID distributora, kterého zástupce zastupuje.
Struktura odpovědi služby
Struktura odpovědi kopíruje strukturu předaných dat zápisovou službou. Navíc jsou v odpovědi tyto informace:
BUSINESS_PARTNER | Element obsahující informaci, zda je druhá strana vedená v registru distrubutorů či nikoliv. |
INSERT_DATE UPDATE_DATE |
Datum, kdy byl proveden zápis pohybu a nebo byla provedena aktualizace pohybu. |
TRANSFER_STATE | Hodnota určuje, zda některá dílčí položka v rámci pohybu nevykazuje chybu. Pokud žádná položka pohybu neobsahuje chybu, tak je hodnota v odpovědi rovna OK. V opačním případě je hodnota ERROR. |
TRANSFER_EVALUATIONS |
Jedná se o seznam chyb, které se vyhodnocují v rámci pohybu. Seznam není přesně daný a může se v budoucnu rozšiřovat. Aktuálně se vyhodnocují chyby: - nezadané číslo šarže - nezadaný datum výroby - nespárovaný pohyb v případě naskladnění nebo vyskladnění směrem k jinému distributorovi |
GTIN_METADATA | Jedná se o element, který obsahuje detailní informace z katalogu k evidovanému GTIN kódu. Údaje odpovídají struktuře, kterou poskytuje služba JUP_CAT01A a na údaje se vztahují stejná pravidla v oblasti historizace. |
OWN_TRANSFERS | Tento element obsahuje pohyby, které byly do úložiště zapsány distributorem nebo pověřenou osobou za distributora. |
BUSINESS_PARTNER_TRANSFERS |
Tento element obsahuje pohyby, které jsou v úložišti zapsány vůči distributorovi. V tomto elementu jsou uvedeny i pohyby vůči zemědělskému subjektu pokud byl tento uveden distributorem v pohybu typu vyskladnění.
Pohyby se párují dle IČ uvedeném v pohybu. Pokud je pohyb vůči zemědělci zapsán bez uvedení jeho IČ (jenom názvem subjektu), tak tyto pohyby nebudou v odpovědi služby uvedeny.
Distributor může pohyb dodatečně opravit a pohyb zapsat do JUP s uvedeném IČ druhé strany. |