JUP_INSPOH01A - struktura služby na testovacím prostředí

Přehled verzí služby

Verze Datum Popis změny
1.3 17.7.2024 Nové elementy EMAIL a TRANSFER_NOTE. Elementy NUMBER_OF_PACKAGES a QUANTITY dovolují zadat záporné množství
1.2 19.12.2023 Element BUSINESS_PARTNER_ID akceptuje IČO nebo SZR ID
1.1 22.8.2023 Element DISTRIBUTOR_ID akceptuje IČO nebo SZR ID
1.0 15.6.2021 První verze služby

 

Export do excelu

Request

XML Element (@atribut) Typ Výskyt Omezení Popis
Request  1 - 1 Request
TRANSFERS  1 - 1 Obalující element celé dávky
TRANSFER  1 - N Element pohybů. Za den je možné poslat v rámci dávky více pohybů.
TRANSFER_DATE  date 1 - 1 Datum pohybu přípravků
BUSINESS_PARTNER_ID  string 0 - 1 Vzor: \d{8}(\d{2})? SZR iD nebo IČO dodavatele při naskladnění, SZR ID nebo IČO odběratele v případě vyskladnění.
BUSINESS_PARTNER_NAME  token 0 - 1 Max. délka: 100 Povinné pokud není uvedeno IČO druhé strany
TRANSFER_TYPE  int 1 - 1 Hodnoty:
- 1
- 2
- 3
- 4
- 5
- 6
- 7
- 8
"Typ pohyb: 1. naskladnění - uvádí se IČO dodavatele (registrovaného distributora) 2. vyskladnění - uvádí se IČO odběratele nebo označení odběratele textově pokud subjekt nemá IČO 3. vývoz - uvádí se textové označení zahraničního odběratele 4. skladová ztráta u distributora 5. aplikace POR u distributora 6. vyskladnění za účelem přebalení - uvádí se IČO odběratele 7. dovoz ze třetí země/přemístění v rámci EU/nákup od výrobce/uvedení POR po přebalení/ - 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"
TRANSFER_NOTE  token 0 - 1 Poznámka pohybu
TRANSFER_ID  token 1 - 1 Max. délka: 100 Např. označení dodejky nebo příjemky. ID musí být jedinečné v kombinaci k SZRID distributora. V případně, že bude ID pohybu dohledáno v úložišti dojde k aktualizaci záznamu pohybu.
DISTRIBUTOR_ID  string 0 - 1 Vzor: \d{8}(\d{2})? Vyplňuje se v případě, že zápis provádí pověřená osoba. Do tohoto elementu se uvádí IČO nebo SZR ID distributora za kterého je zápis prováděn.
EMAIL  token 0 - 1 Max. délka: 255 Emailová adresa pro notifikace.
ITEMS  0 - 1 Seznam položek přípravků. Pokud se jedná o aktualizaci pohybu tak neuvedením žádné položky dojde k výmazu celého pohybu.
ITEM  1 - N Položka přípravků
GTIN  string 1 - 1 Vzor: \d{14} GTIN balení
BATCHES  1 - 1 Element šarže - je možné oznámit více šarží v rámci jednoho volání.
BATCH  1 - N
BATCH  token 0 - 1 Max. délka: 50 Číslo šarže. Element nemusí být uveden. V tomto případě je pohyb automaticky jako neúplný a čeká se na korekci pohybu, kdy subjekt sarži následně dohlásí.
PRODUCTION_DATE  date 0 - 1 Datum výroby. Element nemusí být uveden. V tomto případě je pohyb automaticky jako neúplný a čeká se na korekci pohybu, kdy subjekt datum následně dohlásí.
[SERIAL_NUMBER nebo NUMBER_OF_PACKAGES nebo QUANTITY] 
SERIAL_NUMBER  token 1 - 1 Max. délka: 50 Sériové číslo balení. U tohoto typu evidence se nevkládá žádné množství.
NUMBER_OF_PACKAGES  int 1 - 1 "Množství fyzických balení - nepracuje se s MJ samotného balení, ale s obchodními jednotkami (sud, barel, pytel, kanystr, apod). Pokud je vyplněno sériové číslo předpokládá se automaticky počet 1. Evidence na sériové číslo není přípustná s elementem MNOZSTVI_MJ."
QUANTITY  double 1 - 1 "Množství přípravku v MJ. Používá se v případě, že distributor eviduje přípravky nikoliv v balení ale např. v litrech. Systém v rámci vyhodnocení chyb bude sledovat, zda je zadané množství v MJ rozpočítatelné na nejmenší MJ dle katalogu. Nebude tak možné zadat naskladnění 9 litrů přípravku, kdy dle katalogu je MJ balení 2 litry. Měrná jednotka se přebírá z katalogu POR, kde je uvedeno, že konkrétní GTIN má měrnou jednotku litry nebo kg."
CATALOG  0 - 1 Element obsahující data do katalogu. Pro pohyb 7 povinný element. U ostatních pohybů se ignoruje a nevyplňuje.
REG_NUMBER  token 1 - 1 Min. délka: 6
Max. délka: 10
Evidenční číslo rozhodnutí
UNIT_OF_MEASURE  string 1 - 1 Hodnoty:
- kg
- l
- ks
kg, l, ks
PACK_SIZE  double 1 - 1 Min. hodnota: 0 Velikost balení
DESCRIPTION_OF_PACKAGING  token 1 - 1 Max. délka: 500 Popis balení - ideálně dle údajů na rozhodnutí.
SUB_ITEM  0 - 1 Element obsahující údaje k podřízenému GTIN kódu. Podřízený GTIN kód je automaticky propojen s evidenčním číslem a měrnou jednotkou. Nikoliv však s velikostí balení.
GTIN  string 1 - 1 Vzor: \d{14} GTIN menší jednotky. Nadřízený GTIN označuje karton 10 malých barelů. V tomto elementu je poté uveden GTIN konkrétního barelu, ale GTIN v datové větě je vztažen ke kartonu.
PACK_SIZE  double 1 - 1 Min. hodnota: 0 Velikost balení
DESCRIPTION_OF_PACKAGING  token 1 - 1 Max. délka: 500 Popis balení - ideálně dle údajů na rozhodnutí.
SUB_ITEM  TItem 0 - 1 Element obsahující údaje k podřízenému GTIN kódu. Podřízený GTIN kód je automaticky propojen s evidenčním číslem a měrnou jednotkou. Nikoliv však s velikostí balení.

Response

XML Element (@atribut) Typ Výskyt Omezení Popis
Response  1 - 1 Data odpovědi
STATUS  string 1 - 1 Status