Élő a textil DPP: ellenőrizd az EU-megfelelőséget másodpercek alatt — még mentés előtt

Az akkumulátor-sáv mellé a qr3.app mostantól egy második teljes DPP-kategóriát is szállít: a textileket a francia Loi AGEC (Décret 2022-748) és az ESPR felhatalmazáson alapuló jogi aktus tervezete alapján. Ezzel egyidejűleg beépítettünk egy élő EU-validátort, amely a vezérlőpulton belül fut — még mielőtt elmentenél egy útlevelet, és még mielőtt egy terméket egy új piacon listáznál.

Röviden — három dolog, amit a tipikus QR-platformokon nem kapsz meg:

Teljes textil DPP séma, amely tartalmazza az AGEC kötelező láncot és az ESPR opcionális elemeit.
Élő előnézet a létrehozó űrlapon belül, amely azonnal jelzi az AGEC-szabálysértéseket és a greenwashinget.
Megfelelőségi szimulátor a részletoldalon, amely megválaszolja: „mi történik, ha holnap hozzáadom Franciaországot a piacaimhoz?”

Miért fontos már ma a textil DPP

Az ESPR textil felhatalmazáson alapuló jogi aktus még tervezet — a központi EU DPP-nyilvántartás 2026-07-19-én indul. Nem várhatsz eddig, mert a szabályozás egy szelete már ma jogilag kötelező:

Loi AGEC (Franciaország, 2023-01-01 óta): kötelező származási lánc, mikroműanyag-figyelmeztetés, REACH-SVHC átláthatóság, a homályos környezeti állítások tilalma.
2025-től az AGEC azokra a textilértékesítőkre vonatkozik, akiknek árbevétele meghaladja a 10 millió eurót, vagy a 10 000 darabot. A kisebb gyártók 2027-ben követik őket, és 2028-ra szinte mindenki.
A greenwashing miatti felszólító levelek rekordszintet értek el Franciaországban 2024-ben — a „natural”, „biodegradable” vagy „écologique” bizonyíték nélkül drágább, mint egy dokumentációs sprint.

Ha textileket szállítasz az EU-ba (vagy akár csak Franciaországba), a DPP-stacked felépítése most olcsóbb, mint 2027-ben pánikszerűen migrálni.

A textil séma egy pillantásra

Közvetlenül az AGEC kötelező mezőkatalógusára építünk:

{
  "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
  }
}

A kötelező mezők lefedik azt a négy AGEC-szabályt, amelyet a francia hatóságok a leggyakrabban érvényesítenek:

AGEC cikk	Mező	Mit csinál a validátor
A1	`fiber_composition[].recycled_pct`	Az összes szálszázaléknak összesen 100%-ot kell kiadnia
A2–A4	`country_weaving_knitting / dyeing_printing / assembly`	Három ország kötelező, valahányszor FR szerepel a piacok között
A5	`contains_microplastics`	`true`-ra kényszerítve, ha a szintetikus szálak aránya ≥ 50%
A6	`svhc_substances[]`	CAS-szám + koncentráció szükséges 0,1%-tól

Ezen felül opcionális ESPR-mezőket is támogatunk (tartósság, PEF CO₂, javítási URL, alkatrész-határidő, újrahasznosíthatósági osztály). Ha mindegyik ki van töltve, a vezérlőpult megjelenít egy ESPR-ready jelvényt — tökéletes azoknak a gyártóknak, akik most fektetnek időt abba, hogy 2027-ben migráció nélkül szállíthassanak.

Élő előnézet: lásd a hibákat még mentés előtt

A tipikus folyamat korábban így nézett ki: töltsd ki az űrlapot → ments → ugorj a részletoldalra → olvasd el a megfelelőségi hibákat → menj vissza az űrlaphoz. Ez pont akkor fáj, amikor egy egész köteget hozol létre.

E kiadás óta az EU-validátor stateless módon fut a létrehozó űrlapon belül:

A POST /v1/dpp/validate mostantól a Zod-validáció mellett egy extra eu_compliance mezőt is visszaad, compliant, espr_ready, issues[] értékekkel és egy súlyosság szerint csoportosított összegzéssel.
A vezérlőpult a hibákat közvetlenül a validációs panel alatt jeleníti meg, error / warning / info szerint csoportosítva.
A küldés gombok felett egy mentésvédő banner jelenik meg („2 hiba és 1 figyelmeztetés — mégis mented?”), valahányszor problémák maradnak. A mentés nincs letiltva, de fehéren-feketén látod, mit fogadsz el.

Számodra mint fejlesztő számára ez azt jelenti: a validátort bárhova beépítheted — a saját importfolyamatodba, egy CI-ellenőrzésbe, egy Cursor-ügynök hookjába.

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'

A megfelelőségi szimulátor: „mi van, ha hozzáadom Franciaországot?”

A funkció, amelyet személy szerint a leginkább szerettem volna, a megfelelőségi szimulátor egy meglévő DPP részletoldalán. Tipikus forgatókönyv:

500 textilútleveled van a rendszerben, mindegyik a német piacra. Bejön az értékesítés: „Jövő hónapban terjeszkedünk Franciaországba.” A kérdés: melyik útleveled töri meg hirtelen az AGEC-et?

Nyiss meg egy útlevelet a vezérlőpulton, és az EU-megfelelőség szakasz alatt megjelenik egy új kártya: Megfelelőségi szimulátor.

Kattints az FR chipre (a DE/AT/FR/IT/ES/NL előbeállítások mellett), vagy írj be egy egyedi ISO-kódot.
Opcionális: állítsd át a státuszt draft-ról live-ra.
Preview EU impact gomb.

A felület azonnal megmutatja neked, anélkül, hogy elmentené az útlevelet:

Új hibakártyák (pl. TEXTILE_AGEC_REQUIRED a textile_data.country_weaving_knitting mezőútvonalon).
Egy greenwashing-figyelmeztetés, amely warning-ból error-ra súlyosbodik, mert az FR a piacok között van.
Egy preview.changed_fields címke, amely pontosan megjelöli, mely mezők változnának meg.

Amikor elégedett vagy, a Save changes a PUT /v1/dpp/:id segítségével küldi el a deltát. Ha nem — Reset, és semmi sem történt.

A motorháztető alatt ez egyetlen új végpont:

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" }'

A worker memóriában összefésüli a patchet a meglévő DPP-vel, és lefuttatja az EU-validátort az eredményen — írási hozzáférés nélkül. Az üres törzs megengedett, és az aktuális verdiktet adja vissza.

Miért több ez egy „jó, ha van” funkciónál

Három ok, amiért a szimulátor nem csupán látványelem:

Értékesítés előtti ellenőrzés a piaci terjeszkedéshez. Az értékesítés 60 másodperc alatt megválaszolhatja, mely termékek FR-készek, és milyen drága lenne egy bevezetés.
Válaszd szét az adatműveleteket a megfelelőségi műveletektől. A megfelelőségi csapatnak már nem kell minden adathibát üldöznie — futtasd le egyszer a szimulátort, szűrj tisztán, nyiss jegyeket.
AI-ügynök-barát. A végpont pontosan ugyanolyan alakú, mint a POST /v1/dpp/validate. Egy Cursor- vagy Claude-ügynök közvetlenül meghívhatja egy olyan feladatból, mint „keresd meg az FR-kész útleveleket” — anélkül, hogy egy miniszkript lenne közöttük.

Továbbra is API-first

Minden, ami a vezérlőpulton látható, elérhető az API-n keresztül:

POST /v1/dpp/validate — stateless validátor a létrehozási folyamatokhoz.
POST /v1/dpp/:id/validate-update — stateless validátor a részleges frissítésekhez (a szimulátor).
GET /v1/dpp/:id/eu-compliance — perzisztens ellenőrzés a meglévő útlevelekhez (kiváló CI-hez).
POST /v1/dpp/import — CSV/XLSX tömeges import új textilsablonokkal (GET /v1/dpp/import/templates/textile?format=xlsx).
GET /01/{GTIN}/21/{SERIAL} — fogyasztói nézet az AGEC mikroműanyag-figyelmeztető dobozzal, származási lánccal, SVHC-listával és tartóssági szakasszal.

Mindhárom validátor-végpont ugyanazt az EuComplianceResult alakot adja vissza. Így a problémacsoportosítást és a súlyosság megjelenítését pontosan egyszer építed fel.

Kompatibilitási garancia

E kiadás minden eleme additív:

A meglévő POST /v1/dpp/validate kliensek változtatás nélkül figyelmen kívül hagyhatják az új eu_compliance mezőt.
Az akkumulátoros folyamatok változatlanok.
A market_countries opcionális, alapértelmezett értéke [].

A részletek a changelogban és az API-verziókezelési irányelvünkben találhatók.

Vágj bele

Textil DPP dokumentáció — séma, mikroműanyag-szabály, ESPR opt-in
EU-megfelelőségi dokumentáció — szabálykatalógus, élő előnézet, szimulátor
Kezdd el ingyen — ingyenes csomag, vezérlőpult + API
Kövess minket GitHubon — hibajegyek, SDK-kiadások, roadmap

Ha nagy textilútlevél-katalógusod van, vagy AGEC/Franciaország-kockázatot kell auditálnod, beszéljünk — felkészültünk a 500 és 50 000 SKU közötti pilot ügyfelekre.