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) in osnutku delegiranega akta 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 je še vedno v fazi osnutka — osrednji register EU DPP zaživi 19. 7. 2026. 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 prodajalce tekstila s prihodki nad 10 mio. EUR ali več kot 10.000 enotami. Manjši proizvajalci sledijo leta 2027, skoraj vsi pa do leta 2028.
• Š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 leta 2027.

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 leta 2027 začeli prodajati brez selitve.

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 "X-Workspace-Id: $WS_ID" \
  -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 "X-Workspace-Id: $WS_ID" \
  -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.