Textilný DPP je naživo: skontrolujte súlad s EÚ za pár sekúnd — ešte pred uložením

Popri batériovej kategórii teraz qr3.app prináša druhú kompletnú kategóriu DPP: textil podľa francúzskeho zákona Loi AGEC (Décret 2022-748) a návrhu delegovaného aktu ESPR. Zároveň sme priamo do dashboardu zabudovali živý validátor EÚ, ktorý beží predtým, ako pas uložíte, a predtým, ako produkt uvediete na nový trh.

V skratke tri veci, ktoré na bežných QR platformách nedostanete:

1. Kompletnú schému textilného DPP vrátane povinného reťazca AGEC a voliteľnej časti ESPR.
2. Živý náhľad priamo vo formulári na vytvorenie pasu, ktorý okamžite odhalí porušenia AGEC a greenwashing.
3. Simulátor súladu na detailnej stránke, ktorý odpovie na otázku: „Čo sa stane, ak zajtra pridám medzi svoje trhy Francúzsko?"

Prečo na textilnom DPP dnes záleží

Delegovaný akt ESPR pre textil je stále v štádiu návrhu — centrálny register DPP v EÚ sa spustí 19. 7. 2026. Čakať však nemôžete, pretože časť regulácie je už dnes právne záväzná:

• Loi AGEC (Francúzsko, od 1. 1. 2023): povinný reťazec pôvodu, upozornenie na mikroplasty, transparentnosť REACH-SVHC, zákaz vágnych environmentálnych tvrdení.
• Od roku 2025 sa AGEC vzťahuje na predajcov textilu s obratom nad 10 mil. € alebo viac než 10 000 kusov. Menší výrobcovia nasledujú v roku 2027 a takmer všetci do roku 2028.
• Počet výziev na zdržanie sa greenwashingu (cease-and-desist) dosiahol vo Francúzsku v roku 2024 rekordné hodnoty — slová „natural", „biodegradable" či „écologique" bez dôkazu vás vyjdú drahšie než pár dní práce na dokumentácii.

Ak dodávate textil do EÚ (alebo čo i len do Francúzska), vybudovať si svoj DPP stack už teraz je lacnejšie než panická migrácia v roku 2027.

Textilná schéma v skratke

Staviame priamo na katalógu povinných polí AGEC:

{
  "category": "textile",
  "gtin": "04012345678901",
  "product_name": "Organic Cotton T-Shirt",
  "manufacturer": "EcoWear GmbH",
  "origin_country": "PT",
  "market_countries": ["DE", "AT", "FR"],
  "textile_data": {
    "fiber_composition": [
      { "material": "cotton", "percentage": 95, "origin_country": "TR", "recycled_pct": 0 },
      { "material": "elastane", "percentage": 5, "origin_country": "IT", "recycled_pct": 0 }
    ],
    "country_weaving_knitting": "PT",
    "country_dyeing_printing": "PT",
    "country_assembly": "PT",
    "contains_microplastics": false
  }
}

Povinné polia pokrývajú štyri pravidlá AGEC, ktoré francúzske úrady vymáhajú najčastejšie:

Navyše podporujeme voliteľné polia ESPR (životnosť, PEF CO₂, URL na opravu, termín dostupnosti náhradných dielov, trieda recyklovateľnosti). Keď sú všetky vyplnené, dashboard zobrazí odznak ESPR-ready — ideálne pre výrobcov, ktorí teraz investujú čas, aby v roku 2027 spustili predaj bez migrácie.

Živý náhľad: chyby vidíte ešte pred uložením

Bežný postup býval takýto: vyplniť formulár → uložiť → preskočiť na detailnú stránku → prečítať chyby súladu → vrátiť sa do formulára. To poriadne bolí vo chvíli, keď vytvárate celú dávku.

Od tohto vydania beží validátor EÚ bezstavovo priamo vo formulári na vytvorenie:

• POST /v1/dpp/validate teraz okrem validácie cez Zod vracia aj ďalšie pole eu_compliance s hodnotami compliant, espr_ready, issues[] a so súhrnom zoskupeným podľa závažnosti.
• Dashboard vykreslí jednotlivé problémy priamo pod panelom validácie, zoskupené podľa kategórie chyba / varovanie / informácia.
• Vždy, keď nejaké problémy zostanú, sa nad tlačidlami na odoslanie objaví ochranný banner pri ukladaní („2 chyby a 1 varovanie — uložiť aj tak?"). Uloženie nie je blokované, ale čierne na bielom vidíte, čo akceptujete.

Pre vás ako vývojára to znamená: validátor môžete nasadiť kdekoľvek — do vlastného importovacieho procesu, do CI kontroly, do hooku agenta v Cursore.

curl -X POST https://qr3.app/v1/dpp/validate \
  -H "Authorization: Bearer $API_KEY" \
  -H "X-Workspace-Id: $WS_ID" \
  -H "Content-Type: application/json" \
  -d @textile-payload.json | jq '.data.eu_compliance.summary'

Simulátor súladu: „Čo ak pridám Francúzsko?"

Funkcia, ktorú som osobne chcel najviac, je simulátor súladu na detailnej stránke existujúceho DPP. Typický scenár:

V systéme máte 500 textilných pasov, všetky pre nemecký trh. Príde obchod: „Budúci mesiac sa rozširujeme do Francúzska." Otázka: ktoré z vašich pasov zrazu prestanú spĺňať AGEC?

Otvorte pas v dashboarde a v sekcii súladu s EÚ sa objaví nová karta: Simulátor súladu.

• Kliknite na čip FR (vedľa predvolieb DE/AT/FR/IT/ES/NL) alebo zadajte vlastný ISO kód.
• Voliteľne: prepnite stav z draft na live.
• Tlačidlo Preview EU impact.

Rozhranie vám okamžite zobrazí, bez uloženia pasu:

• Nové karty chýb (napr. TEXTILE_AGEC_REQUIRED na ceste poľa textile_data.country_weaving_knitting).
• Varovanie o greenwashingu, ktoré sa eskaluje z warning na error, pretože FR je medzi trhmi.
• Značku preview.changed_fields, ktorá presne identifikuje, ktoré polia by sa zmenili.

Keď ste spokojní, Save changes odošle deltu cez PUT /v1/dpp/:id. Ak nie — Reset, a nič sa nestalo.

Pod kapotou je za tým jeden nový endpoint:

curl -X POST https://qr3.app/v1/dpp/$DPP_ID/validate-update \
  -H "Authorization: Bearer $API_KEY" \
  -H "X-Workspace-Id: $WS_ID" \
  -H "Content-Type: application/json" \
  -d '{ "market_countries": ["DE", "FR"], "status": "live" }'

Worker spojí patch v pamäti s existujúcim DPP a nad výsledkom spustí validátor EÚ — bez prístupu na zápis. Prázdne telo je povolené a vráti aktuálny verdikt.

Prečo je to viac než len „pekná vychytávka"

Tri dôvody, prečo simulátor nie je len gimmick:

1. Predpredajná kontrola pri expanzii na trh. Obchod dokáže za 60 sekúnd odpovedať, ktoré produkty sú pripravené pre FR a koľko by stál rollout.
2. Oddelenie dátových operácií od operácií súladu. Tím súladu už nemusí naháňať každú dátovú chybu — stačí raz spustiť simulátor, čisto vyfiltrovať a otvoriť tikety.
3. Priateľské k AI agentom. Endpoint má presne rovnaký tvar ako POST /v1/dpp/validate. Agent v Cursore či Claude ho môže zavolať priamo z úlohy typu „nájdi pasy pripravené pre FR" — bez medzikroku v podobe mini skriptu.

Stále API-first

Všetko, čo je viditeľné v dashboarde, je dostupné cez API:

• POST /v1/dpp/validate — bezstavový validátor pre proces vytvárania.
• POST /v1/dpp/:id/validate-update — bezstavový validátor pre čiastočné úpravy (simulátor).
• GET /v1/dpp/:id/eu-compliance — perzistentná kontrola pre existujúce pasy (skvelé pre CI).
• POST /v1/dpp/import — hromadný import CSV/XLSX s novými textilnými šablónami (GET /v1/dpp/import/templates/textile?format=xlsx).
• GET /01/{GTIN}/21/{SERIAL} — spotrebiteľský pohľad s AGEC upozornením na mikroplasty, reťazcom pôvodu, zoznamom SVHC a sekciou o životnosti.

Všetky tri validačné endpointy vracajú rovnaký tvar EuComplianceResult. Zoskupovanie problémov a vykresľovanie závažnosti tak naprogramujete iba raz.

Záruka spätnej kompatibility

Všetko v tomto vydaní je aditívne:

• Existujúci klienti POST /v1/dpp/validate môžu nové pole eu_compliance bez zmien ignorovať.
• Batériové procesy zostávajú nezmenené.
• market_countries je voliteľné a predvolene má hodnotu [].

Podrobnosti nájdete v changelogu a v našich pravidlách verzovania API.

Začnite

• Dokumentácia textilného DPP — schéma, pravidlo o mikroplastoch, voliteľná časť ESPR
• Dokumentácia súladu s EÚ — katalóg pravidiel, živý náhľad, simulátor
• Začnite zadarmo — bezplatný plán, dashboard + API
• Sledujte na GitHube — issues, vydania SDK, roadmapa

Ak máte rozsiahly katalóg textilných pasov alebo potrebujete auditovať riziko AGEC/Francúzsko, ozvite sa nám — sme pripravení na pilotných zákazníkov s 500 až 50 000 SKU.