Ú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.

 

Tyto webové stránky využívají k analýze návštěvnosti soubory cookies. Pokud váš internetový prohlížeč má v nastavení cookies povoleny, je nezbytný váš souhlas s použitím této technologie.

Více informací

Chyba komunikace se serverem

Nastaly technické problémy. Zkontrolujte prosím připojení k síti, a pokud pracujete jako přihlášený uživatel, ověřte prosím nastavení VPN a stav přihlášení.