Úložiště dat o uvádění POR na trh - čtení
(JUP_GETPOH01B)

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.

Rozdíl oproti verzi B

Do odpovědi služby jsou přidány nové informace z katalogu a dále služba vrací informace o poznámce uvedené v pohybu a emailové adrese, která byla pro notifikaci pohybů uvedena.

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