DataMatrix nebo jak správně označit obuv

Od 1. července 2019 byla v Rusku zavedena povinná označení pro skupinu zboží. Od 1. března 2020 měla do tohoto zákona spadat obuv. Ne všichni se na to stihli připravit, a výsledkem bylo, že start byl posunut na 1. července. Lamoda patří mezi ty, kdo to stihli.

Proto se chceme podělit o zkušenosti s těmi, kteří se teprve připravují na označení oděvů, pneumatik, parfémů atd. Článek popisuje řadu odvětvových standardů, některé normativní dokumentace a osobní zkušenosti. Článek je určen především pro integrátory a vývojáře, kteří se teprve budou zabývat tímto projektem.

Vezměte prosím na vědomí, že normativní základna se často mění a autor nemá možnost neustále aktualizovat materiály. Proto k době čtení může být část informací již zastaralých.

Osobní zkušenost měla autorka jak v rámci práce na projektu Datamatrix v Lamoda, tak při vývoji vlastní bezplatné aplikace pro označení BarCodesFx.

Od 1. července 2019 platí v Rusku zákon o povinném označování. Zákon se nevztahuje na všechny skupiny zboží a termíny vstupu v platnost povinného označování pro různé skupiny se liší. V současné době se povinné označení vztahuje na tabák, kožichy, obuv a léky. V blízké budoucnosti se zavede pro pneumatiky, oděvy, parfémy a jízdní kola. Každá skupina zboží je regulována samostatným vládním nařízením (PPR). Proto některá tvrzení platná pro obuv mohou být nesprávná pro jiné skupiny zboží. Ale můžeme doufat, že technická stránka se nebude výrazně lišit mezi různými skupinami zboží.

OznačeníHlavní myšlenkou označování je přiřadit každé jednotce zboží individuální číslo. Podle tohoto čísla lze sledovat historii konkrétní jednotky zboží od výroby nebo dovozu do země až po vyřazení u pokladny. Zní to hezky, ale v praxi je to extrémně obtížné realizovatelné. Podrobnosti o konceptu jsou popsány na oficiálních stránkách čestného označení.

Obecně uznávané termíny a pojmy

ÚOT — účastník oběhu zboží.
CRPT — centrum rozvoje perspektivních technologií. Soukromá společnost, jediný státní dodavatel projektu označování. Pracuje na základě veřejně-soukromého partnerství (PPP). Informace o dalších účastnících tendru na projekt, stejně jako o samotném tendru, bohužel nejsou k dispozici.
TG — obchodní skupina. Obuv, oděvy, pneumatiky atd.
GTIN — v podstatě článek s ohledem na barvu a velikost. Vydává se v GS1 nebo národním katalogu pro každého dovozce či výrobce na jeho zboží. Předtím musí výrobce nebo dovozce tento výrobek popsat.
PPR — usnesení vlády Ruské federace. Pro obuv — 860.
KM — kód označování. Jedinečná sada symbolů přiřazená konkrétní jednotce zboží. Pro obuv se skládá z GTIN, sériového čísla, kontrolního kódu a kryptoháčku.
GS1 — mezinárodní organizace vydávající GTIN. Také autoři řady standardů pro označování.
Národní katalog — ekvivalent GS1, vyvinutý CRPT.
Kryptoháček — ekvivalent digitálního podpisu, který potvrzuje zákonnost KM. Musí být vždy v datamatrixu na značce. Uložení v textové podobě je zakázáno. Po vytištění značky musí být odstraněn podle smlouvy s CRPT. Není známo, že by byl kdy použit.
SUZ — stanice pro správu zakázek. Systém, ve kterém se objednávají KMs pro zboží.
EDO — elektronický oběh dokumentů.
UKEP — posílený kvalifikovaný elektronický podpis.

Termíny a pojmy v rámci tohoto článku

ČZ — čestný znak.
LK — osobní kabinet.
Značka — vytištěný kód označování.

Proces vypadá takto: nejprve účastník (UOT) vydá elektronický podpis (UKEP), zaregistruje se v čestném znaku (ČZ), popíše zboží v národním katalogu nebo GS1, obdrží GTINy na zboží. Na webových stránkách čestného znaku jsou tyto kroky podrobně popsány, proto se o nich nebudeme blíže zmiňovat.

Objednání a získání kódů

Po obdržení GTINů účastník (UOT) objednává kódy (KM) v systému SUZ.
Důležité, ale ne zřejmé.

1. V jedné objednávce lze požadovat kódy maximálně pro 10 GTINů. V zásadě to je nejasné omezení. Dovozce s 14 000 GTINy musí vytvořit 1400 objednávek.
2. V jedné objednávce lze požadovat maximálně 150 000 kódů.
3. Existuje omezení na 100 objednávek v procesu. To znamená, že může být současně zpracováváno maximálně 100 objednávek. Pokud jich bude více než 100, API začne vracet chybu místo seznamu objednávek. Jediný způsob, jak tuto chybu odstranit, je uzavřít část objednávek přes webové rozhraní. V API není zahrnut parametr pro částečné zobrazení objednávek.
4. Existuje limit na počet dotazů — maximálně 10 požadavků za sekundu. Podle mých informací se toto omezení v dokumentech nezmiňuje, ale je přítomno.

Z osobní zkušenosti s objednávkami kódů označení KM přes API systému SUZ.

1. Požadavek (samotný json) je nutné podepsat podpisem podle GOST. To znamená práci s kryptopro. Je třeba pečlivě sledovat, aby použitý rámec nebo knihovna nezměnily původní json o jediný byte. Jinak podpis okamžitě přestává být platný.
2. Podpis objednávky. Objednávka může být podepsána jakýmkoli podpisem jakéhokoli klienta. Pokud je podpis platný, systém SUZ jej přijme. Při integraci se podařilo podepisovat požadavek cizím podpisem, vydaným testovacím CA. Bojový obrys SUZ zpracoval objednávku a vydal kódy. Podle mého názoru je to slabina v bezpečnosti. Na chybu vývojáři reagovali "podíváme se na to". Doufám, že to opravili.

   Buďte proto extrémně opatrní, pokud na jednom pracovním místě pracuje více než jedna právnická osoba. Dnes SUZ tyto požadavky přijme, ale zítra požadavky přezkoumají a stáhnou polovinu kódů kvůli cizímu podpisu. A v zásadě budou formálně mít pravdu.

3. Automatické podepisování objednávek — je to funkcionalita, která již není dostupná v SUZ. Pro její fungování bylo třeba nahrát uzavřenou část klíče do osobního účtu čestného znaku. To je kompromitace klíče. A podle platné legislativy, v případě kompromitace zesíleného kvalifikovaného elektronického podpisu, by měl jeho vlastník informovat své certifikační centrum (CA) a odvolat ZKEP. Pokud se tato funkcionalita vrátí, pečlivě sledujte, aby uzavřená část klíče neopustila počítač.
4. V únoru Centrum rozvoje perspektivních technologií (ČRPT) tiše zavedlo omezení počtu požadavků na API SUZ. Ne více než jeden požadavek za sekundu. Poté také nečekaně a tiše toto omezení zrušilo. Doporučuji tedy do systému zakomponovat možnost omezit počet požadavků na API ČRPT pro případ recidivy. Nyní je k dispozici informace o limitu 10 požadavků za sekundu.
5. Také v únoru se bez varování výrazně změnilo chování API SUZ. API obsahuje požadavek na získání stavu objednávek. Ve statutu byly uvedeny buffery a jejich stav. Jeden GTIN = jeden buffer. Také tam bylo uvedeno, kolik kódů je k dispozici pro získání z bufferu. Jednoho krásného dne se počet kódů pro všechny buffery změnil na -1. Bylo nutné každé buffer ověřovat prostřednictvím samostatné metody. Místo jednoho požadavku bylo potřeba udělat jedenáct.

Struktura kódů

Takže kódy byly objednány a vygenerovány. Můžete je získat přes API v textovém formátu, v PDF jako etikety k tisku a jako CSV soubor s textem.

O API již bylo zmíněno výše. Co se týče dvou dalších metod, původně SUZ umožňoval stáhnout kódy pouze jednou. A pokud byl stažen PDF soubor, kódy v textovém formátu bylo možné získat jen opětovným naskenováním všech datamatricí z PDF. Naštěstí byla přidána možnost stáhnout kódy vícekrát, a tento problém tak byl vyřešen. Po dobu dvou dnů jsou kódy ještě k dispozici pro opakované stažení.

Pokud stahujete ve formátu CSV, nikdy, za žádných okolností, jej neotevírejte v Excelu. A nikomu to nedovolte. V Excelu je funkce automatického ukládání. V momentě ukládání může Excel nejnepředvídatelnějším způsobem změnit vaše kódy. Doporučuji používat Notepad++ pro prohlížení kódů.

Pokud otevřete soubor z SUZ v Notepad++, můžete vidět řádky tohoto typu. Třetí kód je neplatný (chybí mu oddělovače GS).

Partneři nám předávali kódy pro označování svého zboží. Nepřehlédnutelně je patrné, jaké soubory byly vytvořeny pomocí Excelu — až 5% kódů bylo neplatných.

Důrazně doporučuji přečíst si o standardech GS1. V popisu standardu jsou odpovědi na mnoho otázek týkajících se generování DataMatrix.

Identifikační kód se skládá z GTIN a sériového čísla. Podle standardu GS1 odpovídají identifikátorům použití (IP) 01 a 21. Všimněte si, že identifikátory použití nejsou součástí GTIN a sériového čísla. Ukazují, že po identifikátoru použití (IP) následuje GTIN nebo sériové číslo. To je zvlášť důležité při programování pokladního softwaru. Pro vyplnění tagu 1162 jsou potřebné právě GTIN a sériové číslo, bez identifikátorů použití.

Pro UPD (univerzální předávací dokument) a další dokumenty, naopak, je většinou zapotřebí zápis včetně identifikátorů použití.

Ve standardu GS1 je uvedeno, že GTIN má pevnou délku 14 znaků a může obsahovat pouze číslice. Sériové číslo má proměnlivou délku a je popsáno na 155. stránce standardu. Tam je také odkaz na tabulku se znaky, které se mohou objevit v sériovém čísle.

Jelikož sériové číslo má proměnlivou délku, znamená oddělovač GS jeho konec. V ASCII tabulce má kód 29. Bez tohoto oddělovače žádný program nepochopí, kdy sériové číslo skončilo a začaly jiné datové skupiny.

Podrobněji o kódu označení (KM) si můžete přečíst v oficiální dokumentaci.

Pro obuv je sériové číslo stanovené na 13 znaků, avšak jeho velikost může být kdykoli změněna. Pro jiné skupiny zboží (TG) může být délka sériového čísla různá.

Generování DataMatrix

Dalším krokem je převod dat do DataMatrix kódu. V usnesení vlády Ruské federace 860 je uveden GOST, podle kterého je nutné vytvářet DataMatrix. Také v PPR 860 je uvedeno povinné použití identifikátorů použití. Všimněte si, že ve standardu DataMatrix neexistuje pojem „identifikátory použití“. Existují pouze ve standardu GS-1 DataMatrix. Ukazuje se, že PPR 860 nepřímo zavazuje používat právě GS-1 DataMatrix. Naštěstí jsou standardy podobné. Hlavní rozdíl: v GS-1 DataMatrix musí být prvním symbolem FNC1. Symbol GS nesmí být na prvním místě v DataMatrix, pouze FNC1.

FNC1 nelze jen tak vzít a přidat do řetězce jako GS. Musí jej přidávat program, který generuje DataMatrix. Na stránkách Aliance Fortes je zveřejněno několik mobilních aplikací, pomocí kterých můžete zkontrolovat správnost vygenerovaných DataMatrix kódů.

Důležité. Aplikace Čestný Znak přijímá neplatné DataMatrix. Dokonce i QR kódy. Skutečnost, že značka byla rozpoznána a informace o produktu se zobrazila, není důkazem, že DataMatrix byl vytvořen správně. Dokonce ani při výměně kryptohavětu aplikace ČZ rozpoznala značku a zobrazila údaje o produktu.

Později ČZ vydali vysvětlení, jak správně generovat kódy. Vzhledem k vysokému počtu chybových kódů uznali kódy bez FNC1 za platné, nicméně stále doporučují generovat GS-1 DataMatrix.

Bohužel, dost velké procento datamatriců od partnerů přicházelo s chybami. Dě thanks vysvětlením od ČZ byl plně vyřešen dotaz „Můžu obchodovat s tímto produktem po 1. červenci, nebo ne?“. Spoiler - můžu.

Tisk

Věnujte pozornost způsobu tisku značek. Při tisku na termotiskárně značka rychle bledne, a tento produkt už nelze prodávat. Nečitelná značka je porušením PPR 860. Co vede k odebrání zboží, pokutám a trestní odpovědnosti.

Používejte termosublimační tisk. V tomto případě není značka tak silně vystavena blednutí. Z materiálu etikety také závisí, jak moc je značka náchylná k mechanickému poškození. Pokud kód není čitelný kvůli mechanickému poškození, je to rovno absenci značky se všemi důsledky.

Vyberte tiskárnu na základě plánovaných objemů tisku. Stolní tiskárny nejsou určeny k tisku 100 000 etiket za den.

Zastavení a zahájení tisku zvyšují opotřebení tiskárny. Některé programy posílají tiskovou zakázku po jedné etiketě. Takové programy je lepší nepoužívat.

Práce s dokumenty

Poté, co byly značky vytištěny a nalepeny, všechny další operace s nimi probíhají prostřednictvím dokumentů nebo osobního účtu Čestného Znaku.

Při práci s velkým množstvím kódů je možné vytvářet XML soubory, ve kterých budou požadované kódy, a nahrávat tyto soubory prostřednictvím API nebo webového rozhraní osobního účtu.

XSD schéma lze stáhnout v sekci „pomoc“ v LK ČZ.

Věnujte pozornost následujícím bodům.

1. XSD schémata v LK ČZ obsahují chyby ve validaci IČ a omezení na délku řetězce. Pouze opravou chyb je možné schémata používat. Naštěstí jsou chyby zřejmé, takže není složité je opravit.
2. Schéma se většinou skládá ze dvou částí – obecné pro všechny typy dokumentů a samostatné pro konkrétní typ. Obecná schéma je přidána importem do konkrétního. Obě schémata jsou umístěna v sekci nápovědy v LK ČZ.
3. Pravidla pro escapování pro KM se liší od běžně uznávaných pro XML, o tom se píše v oficiální dokumentaci od ČZ, věnujte tomu pozornost. Zde zde na 4. stránce jsou všechna pravidla.
4. Nesnažte se zavést 150 000 kódů do oběhu jedním souborem. Podle svědků soubory nad 30 000 obyčejně procházejí.
5. XML soubor může být zamítnut s chybou "chyba validace xml", a za pět minut může být ten samý soubor přijat bez problémů.
6. Pokud soubor obsahuje již zavedený kód, pravděpodobně nebude přijat do oběhu.
7. Dokumenty o odeslání a převzetí se používají jako dočasné řešení. V budoucnu se plánuje jejich zrušení a přechod na UPD podle PPR 860.
8. Mýtus o 60 dnech. Existuje názor, že nezavedené kódy "ztrácejí platnost" po 60 dnech. To je mýtus, zdroj není znám. Kódy "ztrácejí platnost" pouze pokud jste je nevyzvedli z SUZ během 60 dní. Doba platnosti vyzvednutých kódů není omezena.

Závěr

Při vývoji mé aplikace pro označování BarCodesFX byla původně provedena integrace s API SUZ. Když Čestný znak podruhé neočekávaně změnil logiku API, musel jsem od integrace odstoupit. Doufám, že se v budoucnu ČZ podaří stabilizovat vývoj a API, protože pro nekomerční produkt je pro mě velmi nákladné každý den kontrolovat, zda došlo ke změnám v API, a rychle se přizpůsobovat.

Při zavádění označování se pečlivě seznamte s normativní dokumentací pro vaši skupinu zboží TG, správně tiskněte GS1-DataMatrix a buďte připraveni na jakékoli nečekané změny ze strany Čestného znaku ČZ.

Aliance Fort vytvořila informační prostor (wiki, chaty v telegramu, semináře, webináře), kde můžete nalézt užitečné a aktuální informace o označování ve všech odvětvích.

Zdroj: habr.com