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

Popis služby

Služba slouží k získání údajů z katalogu balení přípravků na ochranu rostlin (dále POR).

Katalog POR je databáze balení POR ve vazbě na typ balení a evidenční číslo přípravku a každý zapsaný pohyb vůči Jednotnému úložišti pohybů je nutné provázat s údajem v Katalogu - párovací hodnotou je GTIN balení.

Služba poskytuje data vždy pro aktuální okamžik a služba neposkytuje žádné časové řezy. Služba obsahuje pro konkrétní záznam v katalogu vazbu na rozhodnutí v Registru POR.

Hierarchická balení jsou definována od nižší jednotky směrem nahoru a služba v případě adekvátního vstupní parametru vrací i hierarchická balení, pokud mají vazbu na vrácený záznam v katalogu. V případě dohledání GTIN hodnoty pro minimální balení (PE lahev) se vrátí i souhrnné balení v kartonu, ale pro souhrnné balení (karton) se nižší balení nevrací.

Základní funkčnosti webové služby

• Stažení kompletního obsahu katalogu,
• zjištění posledního okamžiku změny dat v katalogu (pro celý katalog souhrnně),
• stažení záznamů, které vyhovují vstupnímu filtru služby (služba vstupní parametry spojuje do logického operátoru and),
• stažení hierarchie balení,
• stažení obsahu katalogu pro záznamy změněné v určitém období,
• získání informací o násobnosti obchodních jmen - nově od verze B,
• informace z databáze sdružení GS1 - nově od verze B.

Služba poskytuje datum změny na úrovni celého katalogu i na úrovni jednotlivého záznamu.

Aktualizace dat

Katalog je databáze, která může být průběžně aktualizována /doplňována nebo zpřesňována/. Služba neposkytuje žádné údaje popisující úpravy konkrétního údaje.

Příklad:

U určitého GTIN kódu jsou uvedeny dva popisy balení POR:

1. karton  -  2 X 10 L,
2. krabice z vlnité lepenky 2 x 10 l

Určité období služba vrací oba záznamy v rámci elementu DESCRIPTIONS_OF_PACKAGING.

Pověřený pracovník ÚKZÚZ provede revizi popisu balení, kdy výstupem  revize je zneplatnění  prvního záznamu. V katalogu proběhne aktualizace GTIN záznamu a nastaví se datum poslední změny na okamžik zpracování změny. Od toho okamžiku se bude vracet pouze jeden popis balení.

Na straně konzumentského systému se zpracuje datum poslední změny (vyhodnotí se, že datum změny v katalogu nesouhlasí s datem posledního importu) a provede se nový import. V rámci tohoto importu je vhodné pro GTIN záznam provést plnou náhradu údajů z webové služby, protože nelze žádnými stavy nebo ID hodnotami vracet původní a nové záznamy a vyhodnotit dílčí rozdíly.

Není vhodné vracet údaje, které byly z katalogu odstraněny a přenášet, tak zneviditelnění těchto údajů na konzumenty. Vhodnější je tedy neplatné údaje nevracet.

Parametry na vstupu služby

element GETDATA

Pokud je uvedena hodnota 0/false, tak v odpovědi služby je naplněn pouze element DATE_LAST_CHANGE a služba nevrací žádné konkrétní záznamy. Pokud je hodnota 1/true, tak v odpovědi služby je naplněn element DATE_LAST_CHANGE a zároveň se vrací záznamy odpovídající vstupní podmínce.

Element je možné použít pro každodenní ověření změny v katalogu s cílem hlídat si změny oproti poslední aktualizaci dat na straně konzumentského systému a vyvarovat se zbytečnému stahování celé databáze katalogu pokud v něm nedošlo ke změnám.

Pokud je okamžik posledního import na straně konzumenta odlišný od data, které vrací služba jako poslední datum aktualizace může provést konzumenský systém import dat.

element GTIN

Dle parametru se vyhledává v katalogu odpovídající záznam.

element GET_HIERARCHY

V případě hodnoty 1/true se v odpovědi služby vrací element PARENT_GTINS, který definuje vazby směrem od nejnižšího balení k souhrnnému balení. Dále se vrací i samotný záznam souhrnného balení.

V případě hodnoty 0/false se v odpovědi služby element PARENT_GTINS nevrací.

element REG_NUMBER

Do uvedeného elementu je možné uvést evidenční číslo rozhodnutí a systém vrátí všechny katalogové položky, které mají vazbu na uvedené evidenční číslo.

element STATEMENT_ID

Webová služby EPH_GCP01H nebo Registr POR poskytují tzv. unikátní číslo rozhodnutí o registraci/povolení POR. Toto číslo je možné využít i v rámci vyhledávání v katalogu.

Struktura odpovědi služby

Data katalogu se vztahují ke konkrétnímu GTIN identifikátoru, který je primárním klíčem.

Typ dat	Evidované údaje
Popis balení	DESCRIPTIONS_OF_PACKAGING Určuje popis balení a údaj může být uveden jako seznam.
Velikost balení	UNIT_OF_MEASURE Měrná jednotka balení - povolené hodnoty jsou kilogramy (kg), litky (l) a kusy (ks).   PACK_SIZE Velikost balení, která se vztahuje k zadané měrné jednotce. V případě pětilitrového kanystru bude uvedena hodnota 5 a měrná jednotka litry.
Popisné údaje GS1	GTIN_VERIFIED Určuje, zda se jedná o údaj v katalogu, který ověřil výrobce nebo držitel uvedeného GS1 kódů. Hodnotu nastavuje ÚKZÚZ po dohodně s dovozci nebo výrobci. Pokud je tento údaj nastaven, tak není přípustné pohybem 7 měnit údaje v katalogu.
Vazba na registraci POR	STATEMENTS    Tento záznam popisuje vazbu na rozhodnutí ÚKZÚZ, které ÚKZÚZ publikuje v Registru POR. Služba vrací i další údaje z tohoto Registru (držitel rozhodnutí, stav rozhodnutí, ID rozhodnutí a dále datové položky k rozhodnutí). Pokud je více stejných rozhodnutí evidovaných pod evidenčním číslem jsou zobrazeny všechna. Vazba na rozhodnutí může být i na jiná evidenční čísla z registru POR.   Zde jsou i informace o vícenásobných obchodních jménech.
Hierarchická vazba	PARENT_GTINS    Určuje nadřízená balení, kdy systém předpokládá, že nadřízených balení může být i více (jednotkové balení je možné dodávat ve sdruženém balení po 4 nebo 2 kusech). Služba vrací GTIN nadřízeného balení a zároveň služba vrací počet balení v nadřízeném balení.
Vazba na GS1	GTIN_GS1_VERIFIED informace zda je GTIN kód ověřen proti databázi sdružení GS1 GTIN_GS1_VERIFICATION_DATE datum ověření kódu - obvykle se kód ověřuje pouze 1x při jeho začlenění do katalogu GTIN_GS1_VERIFIED_SUBJECT název držitel kódu - název společnosti GTIN_GS1_VERIFIED_SUBJECT_ADDRESS kontaktní údaje na držitele GTIN_GS1_VERIFIED_RESULT_STATE stav ověření, kdy obchodní balení může být podle sdružení GS1 ve stavu OK nebo se může jednat o obchodní balení, které je označeno jako balení, kde už je jeho distribuce ukončena.

Násobnost obchodních jmen je uvedena v rámci nového elementu NAMES. Příkladem je přípravke Spekfree. Katalogová služba vrací nově údaje o dalších jménech přípravků, která může rozhodnutí mít. U rozhodnutí 4867-0 (Spekfree) se jedná o obchodní jména Bounty, Starpro a TebuGUARD Plus. V seznamu obchodních jmen je uvedeno i samotné jméno Spekfree. Odpověď se výčtem obchodních jmen potom vypadá takto (celá odpověď je jako přílohou článku):

<STATEMENTS>
    <STATEMENT>
        <ID>1039364</ID>
        <REG_NUMBER>4867-0</REG_NUMBER>
        <NAME>Spekfree</NAME>
        <NAMES>
            <NAME>
                <ID>16302</ID>
                <NAME>Spekfree</NAME>
            </NAME>
            <NAME>
                <ID>16923</ID>
                <NAME>Bounty</NAME>
            </NAME>
            <NAME>
                <ID>18870</ID>
                <NAME>Starpro</NAME>
            </NAME>
            <NAME>
                <ID>18874</ID>
                <NAME>TebuGUARD Plus</NAME>
            </NAME>
        </NAMES>
        <HOLDER>Rotam Agrochemical Europe Ltd.</HOLDER>
        <STATE>Platné rozhodnutí</STATE>
        <DATE_VALID_TO>2027-08-15</DATE_VALID_TO>
        <DATE_DISTRIBUTION_TO>2027-08-15</DATE_DISTRIBUTION_TO>
        <DATE_USE_TO>2027-08-15</DATE_USE_TO>
    </STATEMENT>
</STATEMENTS>