Tekstylny DPP

Oprócz schematu baterii z fazy 4a, qr3.app od wersji Q3.3 obsługuje pełny schemat tekstylnego DPP oparty na francuskiej ustawie Loi AGEC (Dekret 2022-748) oraz akcie delegowanym ESPR-Delegated-Act Textil. Możesz tworzyć, walidować, dostarczać za pomocą kodów QR i sprawdzać zgodność z wymogami UE na żywo przed zapisaniem paszportów tekstylnych, identycznie jak w przypadku przepływu dla baterii.

Wybór kategorii

Podczas tworzenia paszportu schemat jest określany przez category: "textile":

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

Pola obowiązkowe (AGEC)

Pole	Artykuł AGEC	Zawartość
`fiber_composition[]`	A1	Wszystkie udziały włókien, suma = 100 %
`fiber_composition[].recycled_pct`	A1	Zawartość materiału z recyklingu na włókno (domyślnie `0`)
`country_weaving_knitting`	A2	Kraj tkania/dziania (ISO 3166-1 alpha-2)
`country_dyeing_printing`	A3	Kraj barwienia/drukowania
`country_assembly`	A4	Kraj konfekcjonowania/montażu
`contains_microplastics`	A5	Wymagane `true`, gdy włókna syntetyczne stanowią ≥ 50 %
`svhc_substances[]`	A6	Substancje REACH SVHC od stężenia 0,1 % z numerem CAS

Reguła dotycząca mikroplastiku: Jeśli skład zawiera co najmniej 50 % włókien syntetycznych (poliester, akryl, poliamid, elastan itp.), pole contains_microplastics: true musi być ustawione — w przeciwnym razie punkt końcowy (endpoint) zwróci błąd 422. W takim przypadku przeglądarka HTML dla konsumenta wyrenderuje widoczne, pomarańczowe pole ostrzegawcze z obowiązkowym francuskim tekstem AGEC (a dla kupujących z DE/EN dodatkowo informację “Mention obligatoire (marché français)”, gdy tylko "FR" ∈ market_countries).

Pola opcjonalne ESPR (Opt-in)

Pola te są opcjonalne, ale odblokowują plakietkę ESPR-ready w panelu administracyjnym (dashboard) oraz w przeglądarce dla konsumenta:

durability_class — klasa trwałości A–E
recyclability_class — klasa podatności na recykling A–E
expected_lifetime_wash_cycles — oczekiwana liczba cykli prania
expected_lifetime_years — oczekiwana żywotność w latach
pef_carbon_footprint_kg — ślad węglowy produktu (PEF CO₂eq)
recyclability_pct — udział materiału nadającego się do recyklingu
repair_instructions_url — link HTTPS do instrukcji naprawy
spare_parts_available_until — data ISO określająca, do kiedy dostępne są części zamienne
disassembly_url — link HTTPS do instrukcji demontażu
take_back_info — informacje o zwrocie (tekst wolny)

Gdy tylko wszystkie pola od B7 do B15 zostaną ustawione, walidator UE wygeneruje plakietkę informacyjną TEXTILE_ESPR_READY.

Kraje sprzedaży (`market_countries`)

market_countries: string[] to podstawowe pole we wszystkich kategoriach DPP (ISO 3166-1 alpha-2, maks. 32 wpisy). Steruje ono dwoma mechanizmami:

HTML dla konsumenta: Gdy tylko podany zostanie kraj "FR", a użytkownik nie otworzy strony w języku francuskim, obowiązkowy tekst AGEC zostanie dodatkowo wyświetlony w języku francuskim w sekcji “Mention obligatoire (marché français)”.
Walidator UE (patrz Zgodność z wymogami UE): Aktywowane są reguły specyficzne dla Francji — łańcuch AGEC staje się błędem (error), a pojęcia związane z greenwashingem (biodégradable, écologique itp.) są podnoszone z poziomu ostrzeżenia (warning) do błędu (error).

Linter ds. greenwashingu

Walidator skanuje pola product_name oraz fiber_composition[].material pod kątem dopasowań do przygotowanej listy słów zakazanych w językach DE/EN/FR. Trafienia (np. “natural”, “biodegradable”, “umweltfreundlich”) pojawiają się jako problem TEXTILE_GREENWASHING — jako ostrzeżenie (warning) poza UE, a jako błąd (error), gdy tylko rynek obejmuje FR.

Dobra praktyka: Używaj wyłącznie możliwych do zweryfikowania, konkretnych pojęć ("Organic Cotton" zamiast "Natural"; “100 % z recyklingu” zamiast “przyjazny dla środowiska”).

Walidacja przed zapisaniem

qr3.app zapewnia podgląd na żywo w panelu administracyjnym (patrz Zgodność z wymogami UE) — widzisz trafienia AGEC, ostrzeżenia dotyczące greenwashingu oraz status ESPR-ready zanim paszport zostanie zapisany:

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

Odpowiedź zawiera sekcję eu_compliance z polami compliant, espr_ready, issues[] oraz podsumowaniem według stopnia ważności (errors / warnings / info).

Widok dla konsumenta

Widok HTML dla konsumenta pod adresem https://qr3.app/01/{GTIN}/21/{SERIAL} renderuje:

Pole ostrzegawcze AGEC (jeśli dotyczy mikroplastiku), w tym obowiązkowy blok dla rynku FR
Łańcuch pochodzenia: Tkanie/dzianie → Barwienie/drukowanie → Konfekcjonowanie (z flagami państw)
Szczegóły włókien: kraj pochodzenia + udział materiału z recyklingu dla każdego włókna
Lista SVHC (REACH) z nazwami, numerami CAS i stężeniami
Sekcja trwałości (Durability) (ESPR): cykle prania, żywotność, PEF CO₂, URL do instrukcji naprawy, części zamienne
Sekcja podatności na recykling (Recyclability): %, klasa, URL do instrukcji demontażu, informacje o zwrocie
Kraje sprzedaży

Import masowy (Bulk)

Masowy import CSV/XLSX pod adresem POST /v1/dpp/import obsługuje tekstylia — szablon jest dostępny pod adresem GET /v1/dpp/import/templates/textile?format=xlsx (lub ?format=csv). Szczegółowe informacje znajdują się w Dokumentacji API.

Kolejne kroki

Tworzenie w panelu administracyjnym: /dashboard/dpp/new → Wybierz kategorię Tekstylia, wypełnij pola, obserwuj podgląd na żywo (Live-Preview), zapisz.
Sprawdzanie zgodności z wymogami UE: Szczegółowe zasady opisano w sekcji Zgodność z wymogami UE.
Wdrożenie GS1 (Onboarding): Rejestracja kodów GTIN i weryfikacja własności — patrz Identyfikatory GS1 i wdrożenie.

Tekstylny DPP

Tekstylny DPP

Wybór kategorii

Pola obowiązkowe (AGEC)

Pola opcjonalne ESPR (Opt-in)

Kraje sprzedaży (market_countries)

Linter ds. greenwashingu

Walidacja przed zapisaniem

Widok dla konsumenta

Import masowy (Bulk)

Kolejne kroki

Kraje sprzedaży (`market_countries`)