Tekstilni DPP je v živo: preverite skladnost z EU v nekaj sekundah — še preden shranite

Poleg baterijske kategorije qr3.app zdaj ponuja še drugo popolno kategorijo DPP: tekstil po francoskem Loi AGEC (Décret 2022-748) s polji, pripravljenimi za pričakovani, a še nesprejeti delegirani akt ESPR. Hkrati smo vgradili validator EU v živo, ki teče neposredno v nadzorni plošči — še preden shranite potni list in še preden izdelek uvrstite na nov trg.

Na kratko, tri stvari, ki jih na običajnih platformah za QR kode ne dobite:

1. Popolna shema tekstilnega DPP, vključno z obvezno verigo AGEC in možnostjo izbire ESPR.
2. Predogled v živo znotraj obrazca za ustvarjanje, ki takoj označi kršitve AGEC in lažno oglaševanje.
3. Simulator skladnosti na strani s podrobnostmi, ki odgovori na vprašanje: "kaj se zgodi, če jutri svojim trgom dodam Francijo?"

Zakaj je tekstilni DPP pomemben že danes

Delegirani akt ESPR za tekstil še ni bil sprejet — delovni načrt Komisije začasno predvideva njegovo sprejetje za leto 2027, njegove zahteve pa se na splošno začnejo uporabljati najprej 18 mesecev po začetku veljavnosti. Ne morete čakati do takrat, saj je del uredbe že danes pravno zavezujoč:

• Loi AGEC (Francija, od 1. 1. 2023): obvezna veriga porekla, opozorilo o mikroplastiki, preglednost glede REACH-SVHC, prepoved nejasnih okoljskih trditev.
• Od leta 2025 AGEC velja za proizvajalce, uvoznike in druge gospodarske subjekte, ki dajejo tekstil na francoski trg z več kot 10 mio. EUR letnega prometa iz zajetih izdelkov in vsaj 10.000 enotami na leto (od leta 2023: 50 mio. EUR in 25.000 enot; od leta 2024: 20 mio. EUR in 10.000 enot).
• Število opominov zaradi lažnega oglaševanja je v Franciji leta 2024 doseglo rekord — "naraven", "biorazgradljiv" ali "écologique" brez dokazov je dražje kot teden dela na dokumentaciji.

Če tekstil pošiljate v EU (ali zgolj v Francijo), je vzpostavitev DPP-sklada zdaj cenejša od panične selitve, ko se začne uporabljati delegirani akt ESPR.

Tekstilna shema na hitro

Gradimo neposredno na katalogu obveznih polj 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
  }
}

Obvezna polja pokrivajo štiri pravila AGEC, ki jih francoski organi najpogosteje uveljavljajo:

Poleg tega podpiramo izbirna polja ESPR (trajnost, PEF CO₂, URL za popravila, rok za rezervne dele, razred reciklabilnosti). Ko so vsa nastavljena, nadzorna plošča prikaže značko ESPR-ready — popolno za proizvajalce, ki vlagajo čas zdaj, da bodo pripravljeni brez selitve, ko se začne uporabljati delegirani akt ESPR.

Predogled v živo: napake vidite, še preden shranite

Običajen potek je bil: izpolniš obrazec → shraniš → skočiš na stran s podrobnostmi → prebereš napake skladnosti → se vrneš na obrazec. To boli v trenutku, ko ustvarjate paket izdelkov.

Od te izdaje validator EU teče brez stanja (stateless) znotraj obrazca za ustvarjanje:

• POST /v1/dpp/validate zdaj poleg validacije Zod vrne dodatno polje eu_compliance z compliant, espr_ready, issues[] in povzetkom, razvrščenim po resnosti.
• Nadzorna plošča izriše težave neposredno pod panelom validacije, razvrščene po napaki / opozorilu / informaciji.
• Pasica z varovalom pred shranjevanjem se prikaže nad gumbi za oddajo ("2 napaki in 1 opozorilo — vseeno shrani?"), kadar koli ostanejo težave. Shranjevanje ni blokirano, vendar črno na belem vidite, kaj sprejemate.

Za vas kot razvijalca to pomeni: validator lahko vključite kamor koli — v svoj lasten potek uvoza, v preverjanje CI, v kavelj agenta Cursor.

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

Simulator skladnosti: "kaj če dodam Francijo?"

Funkcija, ki sem si je osebno najbolj želel, je simulator skladnosti na strani s podrobnostmi obstoječega DPP. Tipičen scenarij:

V sistemu imate 500 tekstilnih potnih listov, vse za nemški trg. Vstopi prodaja: "Naslednji mesec se širimo v Francijo." Vprašanje: kateri od vaših potnih listov nenadoma kršijo AGEC?

Odprite potni list v nadzorni plošči in pod razdelkom skladnosti z EU se pojavi nova kartica: Simulator skladnosti.

• Kliknite žeton FR (poleg prednastavitev DE/AT/FR/IT/ES/NL) ali vnesite poljubno kodo ISO.
• Po želji: preklopite status z draft na live.
• Gumb Preview EU impact.

Vmesnik vam takoj prikaže, brez shranjevanja potnega lista:

• Nove kartice z napakami (npr. TEXTILE_AGEC_REQUIRED na poti polja textile_data.country_weaving_knitting).
• Opozorilo o lažnem oglaševanju, ki se zaradi FR med trgi stopnjuje iz warning v error.
• Oznako preview.changed_fields, ki natančno določi, katera polja bi se spremenila.

Ko ste zadovoljni, Save changes preko PUT /v1/dpp/:id potisne razliko (delta). Če ne — Reset, in nič se ni zgodilo.

V ozadju je za vse to en sam nov endpoint:

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

Worker v pomnilniku združi popravek z obstoječim DPP in nad rezultatom zažene validator EU — brez pisalnega dostopa. Prazno telo zahteve je dovoljeno in vrne trenutni izid.

Zakaj je to več kot le "lepa dodatna funkcija"

Trije razlogi, zakaj simulator ni le trik:

1. Predprodajno preverjanje za širitev na trge. Prodaja lahko v 60 sekundah odgovori, kateri izdelki so pripravljeni za FR in kako drago bi bilo uvajanje.
2. Ločitev podatkovnih operacij od operacij skladnosti. Skladnost ne lovi več vsake napake v podatkih — zaženite simulator enkrat, čisto filtrirajte, odprite vstopnice.
3. Prijazno do AI-agentov. Endpoint ima popolnoma enako obliko kot POST /v1/dpp/validate. Agent Cursor ali Claude ga lahko pokliče neposredno iz naloge, kot je "poišči potne liste, pripravljene za FR" — brez vmesnega mini skripta.

Še vedno API-first

Vse, kar je vidno v nadzorni plošči, je dosegljivo prek API:

• POST /v1/dpp/validate — validator brez stanja za poteke ustvarjanja.
• POST /v1/dpp/:id/validate-update — validator brez stanja za delne posodobitve (simulator).
• GET /v1/dpp/:id/eu-compliance — trajno preverjanje za obstoječe potne liste (odlično za CI).
• POST /v1/dpp/import — paketni uvoz CSV/XLSX z novimi tekstilnimi predlogami (GET /v1/dpp/import/templates/textile?format=xlsx).
• GET /01/{GTIN}/21/{SERIAL} — pogled za potrošnika z okvirjem z opozorilom AGEC o mikroplastiki, verigo porekla, seznamom SVHC in razdelkom o trajnosti.

Vsi trije validatorski endpointi vrnejo enako obliko EuComplianceResult. Tako razvrščanje težav in izris resnosti zgradite natanko enkrat.

Jamstvo nezlomljivosti

Vse v tej izdaji je dodatno (additive):

• Obstoječi odjemalci POST /v1/dpp/validate lahko brez sprememb prezrejo novo polje eu_compliance.
• Baterijski poteki ostajajo nespremenjeni.
• market_countries je izbirno polje in privzeto znaša [].

Podrobnosti so v dnevniku sprememb in naši politiki različic API.

Začnite

• Dokumentacija za tekstilni DPP — shema, pravilo o mikroplastiki, izbira ESPR
• Dokumentacija za skladnost z EU — katalog pravil, predogled v živo, simulator
• Začnite brezplačno — brezplačni paket, nadzorna plošča + API
• Sledite na GitHubu — težave, izdaje SDK, načrt razvoja

Če imate obsežen katalog tekstilnih potnih listov ali morate revidirati tveganje AGEC/Francija, pišite nam — pripravljeni smo na pilotne stranke med 500 in 50.000 SKU-ji.