Salta ai contenuti
qr3.app Docs

DPP Tessile

DPP Tessile

Oltre allo schema per le batterie della Fase 4a, qr3.app supporta a partire da Q3.3 uno schema DPP tessile completo basato sulla legge francese Loi AGEC (obblighi di informazione ai sensi dell’Art. R. 541-227 e seguenti del Code de l’environnement), con campi predisposti per l’atteso atto delegato ESPR per i prodotti tessili, non ancora adottato. È possibile creare, validare, distribuire tramite QR e verificare in tempo reale la conformità UE dei passaporti tessili prima del salvataggio, esattamente come per il flusso delle batterie.

Selezionare la categoria

Durante la creazione di un passaporto, category: "textile" definisce lo schema:

{
  "category": "textile",
  "gtin": "04012345678901",
  "product_name": "Organic Cotton T-Shirt",
  "manufacturer": "EcoWear GmbH",
  "origin_country": "PT",
  "landing_locale": "de",
  "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
  }
}

Campi obbligatori (AGEC)

CampoID di controllo internoContenuto
fiber_composition[]A1Tutte le percentuali di fibre, somma = 100%
fiber_composition[].recycled_pctA1Percentuale di materiale riciclato per fibra (default 0)
country_weaving_knittingA2Paese di tessitura/maglieria (ISO 3166-1 alpha-2)
country_dyeing_printingA3Paese di tintura/stampa
country_assemblyA4Paese di confezionamento/assemblaggio
contains_microplasticsA5Obbligatorio true se le fibre sintetiche rappresentano > 50%
svhc_substances[]A6Sostanze REACH SVHC a partire da una concentrazione dello 0,1%, con numero CAS

Regola sulle microplastiche: Se la composizione contiene più del 50% di fibre sintetiche (poliestere, acrilico, poliammide, elastan, …), deve essere impostato contains_microplastics: true — altrimenti l’endpoint risponderà con 422. In questo caso, la vista HTML per i consumatori mostrerà un box di avviso arancione ben visibile con il testo obbligatorio francese AGEC (e, per gli acquirenti DE/EN, un blocco aggiuntivo “Mention obligatoire (marché français)” non appena "FR" ∈ market_countries). qr3.app richiede il flag con più del 50% di fibre sintetiche — corrispondendo esattamente all’obbligo di informazione AGEC stesso (Art. R. 541-228 XI Code de l’environnement).

Campi opt-in ESPR

Questi campi sono opzionali, ma sbloccano il badge ESPR-ready nella dashboard e nel visualizzatore per i consumatori:

  • durability_class — classe di durabilità A–E
  • recyclability_class — classe di riciclabilità A–E
  • expected_lifetime_wash_cycles — cicli di lavaggio previsti
  • expected_lifetime_years — durata di vita prevista in anni
  • pef_carbon_footprint_kg — Product Environmental Footprint (CO₂eq)
  • recyclability_pct — percentuale di materiale riciclabile
  • repair_instructions_url — link HTTPS alle istruzioni di riparazione
  • spare_parts_available_until — data ISO fino alla quale sono disponibili i pezzi di ricambio
  • disassembly_url — link HTTPS alle istruzioni di smontaggio
  • take_back_info — informazioni sul ritiro in testo libero

Non appena tutti i campi da B7 a B15 sono impostati, il validatore UE emette il badge informativo TEXTILE_ESPR_READY.

Paesi di vendita (market_countries)

market_countries: string[] è un campo di base su tutte le categorie DPP (ISO 3166-1 alpha-2, max. 32 voci). Gestisce due meccanismi:

  1. HTML per i consumatori: Non appena "FR" è incluso e l’utente non apre la pagina in francese, il testo obbligatorio AGEC viene fornito anche in francese sotto la dicitura “Mention obligatoire (marché français)”.
  2. Validatore UE (vedere Conformità UE): si attivano le regole specifiche per la Francia — la catena AGEC diventa un error, i termini di greenwashing (biodégradable, écologique, …) vengono promossi da warning a error.

Linter per il Greenwashing

Il validatore scansiona product_name e fiber_composition[].material confrontandoli con una lista di divieti curata in DE/EN/FR. Le corrispondenze (ad es. “natural”, “biodegradable”, “umweltfreundlich”) appaiono come problema TEXTILE_GREENWASHING — warning al di fuori dell’UE, error non appena il mercato include FR.

Best practice: utilizzare solo termini dimostrabili e specifici ("Organic Cotton" invece di "Natural"; “100% riciclato” invece di “ecologico”).

Validazione prima del salvataggio

qr3.app fornisce un’anteprima in tempo reale nella dashboard (vedere Conformità UE) — è possibile visualizzare le corrispondenze AGEC, gli avvisi di greenwashing e lo stato ESPR-ready prima che il passaporto venga salvato:

Terminal window
curl -X POST https://qr3.app/v1/dpp/validate \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d @textile-payload.json

La risposta contiene la sezione eu_compliance con compliant, espr_ready, issues[] e un riepilogo per gravità (errors / warnings / info).

Vista consumatore

La vista HTML per i consumatori all’indirizzo https://qr3.app/01/{GTIN}/21/{SERIAL} mostra:

  • Box di avviso AGEC (se le microplastiche sono rilevanti), incluso il blocco obbligatorio FR per il mercato FR
  • Catena di tracciabilità: tessitura/maglieria → tintura/stampa → confezionamento (con badge delle bandiere)
  • Arricchimento delle fibre: paese di origine + percentuale di materiale riciclato per ciascuna fibra
  • Elenco SVHC (REACH) con nomi, numeri CAS e concentrazioni
  • Sezione Durabilità (ESPR): cicli di lavaggio, durata di vita, PEF-CO₂, URL di riparazione, pezzi di ricambio
  • Sezione Riciclabilità: %, classe, URL di smontaggio, ritiro
  • Paesi di vendita

Importazione massiva (Bulk)

L’importazione massiva in formato CSV/XLSX tramite POST /v1/dpp/import supporta i prodotti tessili — modello disponibile all’indirizzo GET /v1/dpp/import/templates/textile?format=xlsx (o ?format=csv). Per i dettagli, vedere il Riferimento API.

Passaggi successivi

  • Creazione nella dashboard: /dashboard/dpp/new → selezionare la categoria Tessile, compilare i campi, osservare l’anteprima in tempo reale, salvare.
  • Verificare la conformità UE: Vedere Conformità UE per i dettagli sulle regole.
  • Onboarding GS1: Registrare i codici GTIN e verificare la proprietà — vedere Identificatori GS1 & Onboarding.