Hlášení (PUT_HLASENI_CHMELNICE)
(RCH_PHL01A)
Služba zabezpečuje předání dat z lokálního SW do Registru chmelnic. Ve volání se předávají data prohlášení označovacích štítků. V odpovědi se propaguje stav přijetí dat do registru chmelnic včetně případných chybových stavů.
| Název služby | Hlášení (PUT_HLASENI_CHMELNICE) (RCH_PHL01A) |
|---|---|
| Popis služby | Služba zabezpečuje předání dat z lokálního SW do Registru chmelnic. Ve volání se předávají data prohlášení označovacích štítků. V odpovědi se propaguje stav přijetí dat do registru chmelnic včetně případných chybových stavů. |
| 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://eagritest.cz/ssl/nosso-app/EPO/WS/v2Online/vOKOsrv.ashx prod: https://eagri.cz/ssl/nosso-app/EPO/WS/v2Online/vOKOsrv.ashx |
Popis služby
Služba je určena k předání prohlášení k jednotlivým označovacím (bílým) štítkům.
Producent v rámci prohlášení informuje ÚKZÚZ o detailních informacích týkajících se konkrétního balení chmele.
Podrobný popis zpracování dat na straně Registru chmelnic
Pro sklizeň roku 2021 došlo k úpravě chování služby, kdy služba umožňuje za určitých podmínek přijmout prohlášení k certifikovanému/zpracovanému bílému štítku.
| Stav označovacícho štítku | Chování služby |
|---|---|
|
Štítek nebyl dosud ze strany ÚKZÚZ certifikován.
Tento případ popisuje standardní situaci zasílání prohlášení. Služba se v tomto ohledu pro rok 2021 neměnila.
|
Producent může opakovaně zasílat prohlášení s jakoukoliv váhu (brutto i tára) k označovacímu štítku. Webová služba hodnotu přijme provede zápis nebo aktualizaci zaslané váhy a provede zápis nového prohlášení. |
| Štítek byl ze strany ÚKZÚZ certifikován bez předem zaslaného prohlášení (tj. štítek neměl vyplněnu váhu) a v rámci certifikace nebylo provedeno kontrolní vážení. |
Producent může zaslat 1x jakoukoliv váhu (brutto i tára). Webová služba tuto hodnotu přijme a uloží ji ke štítku. Opakované volání služby už musí být na stejnou váhu a váhu už nelze měnit. V případě zaslání jiné váhy služba končí chybou. |
| Štítek byl ze strany ÚKZÚZ certifikován bez předem zaslaného prohlášení (tj. štítek neměl vyplněnu váhu) a v rámci certifikace bylo provedeno kontrolní vážení. |
Kontrolním vážením ÚKZÚZ úředně stanovil váhu, kterou musí producent v rámci prohlášení zaslat. Tára je stanovena u kartonu na 0,5 kg. Hodnotu brutto, kterou je nutné do prohlášení uvést vrací webová služba v chybové odpovědi. |
| Štítek byl ze strany ÚKZÚZ certifikován a štítek měl zaslané prohlášení (tj. štítek měl vyplněnu váhu od producenta). Kontrolní vážení ze strany ÚKZÚZ nebylo provedeno. | Producent již nemůže váhu (brutto i tára) v prohlášení měnit. Producent může prohlášení poslat znovu, ale pouze na váhu, která byla zadána v systému v době certifikace štítku. |
| Štítek byl ze strany ÚKZÚZ certifikován a štítek měl zaslané prohlášení (tj. štítek měl vyplněnu váhu od producenta). Kontrolní vážení ze strany ÚKZÚZ bylo provedeno. |
Producent již nemůže váhu měnit (brutto i tára). Producent může prohlášení poslat znovu, ale pouze na váhu, která byla zadána v systému v době certifikace štítku - z pohledu kontrolního vážení. |
Producent je povinnen prohlášení zasílat na ÚKZÚZ před samotnou certifikací chmele zpracováním nebo v originále. Chování služby je nicméně vůči producentům v určitém ohledu vstřícné a umožňuje zasílat prohlášení i po provedené certifikaci.
Příklad chyby, kdy došlo k odmítnují hmotnosti pro nesoulad s hmotností certifikovanou.
Uvedený štítek obsahuje v Registru chmelnic váhu 50kg, ale do prohlášení byla vložena váha 51kg. Systém v případě, že není povoleno váhu aktualizovat vrátí tuto chybu. V tomto případě je nutné zaslat váhu 50kg.
<Description>Chyba při načítání do registru: Štítek EAN: 20210000001 je certifikován a jeho hmotnost (50) neodpovídá zadané hmotnosti (51)</Description>
Opakované zasílání prohlášení - změna rozsahu EAN kódů
Opakovaného zaslání prohlášení je určeno primárně k aktualizaci hmotností. Systém nedovoluje při opravě prohlášení přidat do prohlášení další EAN kódy.
Pokud by v rámci zpracování prohlášení bylo zjištěno, že u některých EAN kódů dochází k aktualizaci hmotností, protože EAN kód je již v existujícím prohlášení a u jiného EAN kódu k prvotnímu zápisu prohlášení, tak služba spadne na chybu a je nutné zaslané prohlášení rozdělit.
Ukázka chyby:
Chyba při načítání do registru: Štítek EAN: 202100000001 bez prohlášení neodpovídá prohlášení: 41034 ! (nelze vložit nový štítek do existujícího prohlášení).