Tekstylny DPP jest już dostępny: sprawdź zgodność z przepisami UE w kilka sekund — zanim zapiszesz

Oprócz ścieżki dla baterii, qr3.app udostępnia teraz drugą kompletną kategorię DPP: tekstylia zgodne z francuską ustawą Loi AGEC (Décret 2022-748) z polami przygotowanymi pod kątem oczekiwanego, jeszcze nieprzyjętego aktu delegowanego ESPR. Jednocześnie wbudowaliśmy walidator UE działający na żywo wewnątrz panelu — zanim zapiszesz paszport i zanim wystawisz produkt na nowym rynku.

W skrócie, trzy rzeczy, których nie dostaniesz na typowych platformach QR:

Kompletny schemat tekstylnego DPP obejmujący obowiązkowy łańcuch AGEC oraz opcjonalne pola ESPR.
Podgląd na żywo wewnątrz formularza tworzenia, który natychmiast oznacza naruszenia AGEC i greenwashing.
Symulator zgodności na stronie szczegółów, który odpowiada na pytanie: „co się stanie, jeśli jutro dodam Francję do moich rynków?".

Dlaczego tekstylny DPP ma znaczenie już dziś

Akt delegowany ESPR dla tekstyliów nie został jeszcze przyjęty — plan prac Komisji tymczasowo przewiduje jego przyjęcie na rok 2027, a jego wymogi mają zasadniczo zastosowanie nie wcześniej niż 18 miesięcy po wejściu w życie. Nie możesz czekać do tego czasu, ponieważ część regulacji jest już prawnie wiążąca dzisiaj:

Loi AGEC (Francja, od 2023-01-01): obowiązkowy łańcuch pochodzenia, ostrzeżenie o mikroplastiku, transparentność REACH-SVHC, zakaz niejasnych deklaracji środowiskowych.
Od 2025 roku AGEC obejmuje producentów, importerów i innych operatorów wprowadzających tekstylia na rynek francuski z rocznym obrotem z objętych produktów przekraczającym 10 mln € i co najmniej 10 000 jednostek rocznie (od 2023 roku: 50 mln € i 25 000 jednostek; od 2024 roku: 20 mln € i 10 000 jednostek).
Liczba wezwań do zaprzestania praktyk greenwashingu osiągnęła we Francji rekordowy poziom w 2024 roku — „natural", „biodegradable" czy „écologique" bez dowodów jest droższe niż sprint dokumentacyjny.

Jeśli wysyłasz tekstylia do UE (lub choćby tylko do Francji), uporządkowanie stosu DPP już teraz jest tańsze niż paniczna migracja, gdy zacznie obowiązywać akt delegowany ESPR.

Schemat tekstylny w pigułce

Budujemy bezpośrednio na obowiązkowym katalogu pól 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
  }
}

Pola obowiązkowe obejmują cztery zasady AGEC, których francuskie organy egzekwują najczęściej:

Wewnętrzny identyfikator testu	Pole	Co robi walidator
A1	`fiber_composition[].recycled_pct`	Wszystkie udziały procentowe włókien muszą sumować się do 100%
A2–A4	`country_weaving_knitting / dyeing_printing / assembly`	Trzy kraje wymagane zawsze, gdy FR jest na liście rynków
A5	`contains_microplastics`	Wymuszone na `true`, gdy udział włókien syntetycznych przekracza 50%
A6	`svhc_substances[]`	Numer CAS + stężenie wymagane od 0,1%

Dodatkowo obsługujemy opcjonalne pola ESPR (trwałość, ślad węglowy PEF CO₂, adres URL do napraw, termin dostępności części zamiennych, klasa recyklowalności). Gdy wszystkie z nich są wypełnione, panel wyświetla odznakę ESPR-ready — idealne dla producentów, którzy inwestują czas teraz, aby być gotowym bez migracji, gdy akt delegowany ESPR zacznie obowiązywać.

Podgląd na żywo: zobacz błędy, zanim zapiszesz

Typowy przepływ wyglądał kiedyś tak: wypełnij formularz → zapisz → przejdź do strony szczegółów → przeczytaj błędy zgodności → wróć do formularza. To boli w momencie, gdy tworzysz całą partię.

Od tego wydania walidator UE działa bezstanowo wewnątrz formularza tworzenia:

POST /v1/dpp/validate zwraca teraz dodatkowe pole eu_compliance z compliant, espr_ready, issues[] oraz podsumowaniem pogrupowanym według wagi, obok walidacji Zod.
Panel renderuje problemy bezpośrednio pod panelem walidacji, pogrupowane według error / warning / info.
Banner zabezpieczający zapis pojawia się nad przyciskami wysyłania („2 błędy i 1 ostrzeżenie — zapisać mimo to?"), gdy tylko problemy pozostają. Zapis nie jest blokowany, ale czarno na białym widzisz, co akceptujesz.

Dla Ciebie jako dewelopera oznacza to: możesz uruchomić walidator wszędzie — wewnątrz własnego przepływu importu, w sprawdzeniu CI, w haku 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'

Symulator zgodności: „a co, jeśli dodam Francję?"

Funkcja, której osobiście chciałem najbardziej, to symulator zgodności na stronie szczegółów istniejącego DPP. Typowy scenariusz:

Masz w systemie 500 paszportów tekstylnych, wszystkie dla rynku niemieckiego. Wchodzi dział sprzedaży: „W przyszłym miesiącu wchodzimy do Francji". Pytanie: które z Twoich paszportów nagle łamią AGEC?

Otwórz paszport w panelu, a w sekcji zgodności UE pojawi się nowa karta: Symulator zgodności.

Kliknij chip FR (obok presetów DE/AT/FR/IT/ES/NL) lub wpisz własny kod ISO.
Opcjonalnie: przełącz status z draft na live.
Przycisk Preview EU impact.

Interfejs natychmiast pokazuje Ci, bez zapisywania paszportu:

Nowe karty błędów (np. TEXTILE_AGEC_REQUIRED na ścieżce pola textile_data.country_weaving_knitting).
Ostrzeżenie o greenwashingu, które eskaluje z warning do error, ponieważ FR jest na liście rynków.
Znacznik preview.changed_fields wskazujący dokładnie, które pola uległyby zmianie.

Gdy jesteś zadowolony, Save changes wypycha różnicę przez PUT /v1/dpp/:id. Jeśli nie — Reset, i nic się nie stało.

Pod maską stoi za tym jeden nowy punkt końcowy:

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 scala poprawkę w pamięci z istniejącym DPP i uruchamia walidator UE na wyniku — bez dostępu do zapisu. Pusty korpus żądania jest dozwolony i zwraca aktualny werdykt.

Dlaczego to coś więcej niż „miło mieć"

Trzy powody, dla których symulator nie jest gadżetem:

Sprawdzenie przed sprzedażą przy ekspansji rynkowej. Dział sprzedaży może w 60 sekund odpowiedzieć, które produkty są gotowe na FR i jak kosztowne byłoby wdrożenie.
Oddzielenie operacji na danych od operacji compliance. Compliance nie musi już gonić za każdym defektem danych — uruchom symulator raz, przefiltruj czysto, otwórz zgłoszenia.
Przyjazny dla agentów AI. Punkt końcowy ma dokładnie taki sam kształt jak POST /v1/dpp/validate. Agent Cursor lub Claude może wywołać go bezpośrednio z zadania takiego jak „znajdź paszporty gotowe na FR" — bez pośredniego mini-skryptu.

Wciąż API-first

Wszystko, co widoczne w panelu, jest dostępne przez API:

POST /v1/dpp/validate — bezstanowy walidator dla przepływów tworzenia.
POST /v1/dpp/:id/validate-update — bezstanowy walidator dla częściowych aktualizacji (symulator).
GET /v1/dpp/:id/eu-compliance — trwałe sprawdzenie dla istniejących paszportów (świetne do CI).
POST /v1/dpp/import — masowy import CSV/XLSX z nowymi szablonami tekstylnymi (GET /v1/dpp/import/templates/textile?format=xlsx).
GET /01/{GTIN}/21/{SERIAL} — widok konsumenta z polem ostrzeżenia AGEC o mikroplastiku, łańcuchem pochodzenia, listą SVHC, sekcją trwałości.

Wszystkie trzy punkty końcowe walidatora zwracają ten sam kształt EuComplianceResult. Dzięki temu grupowanie problemów i renderowanie wagi budujesz dokładnie raz.

Gwarancja braku zmian łamiących kompatybilność

Wszystko w tym wydaniu jest addytywne:

Istniejący klienci POST /v1/dpp/validate mogą ignorować nowe pole eu_compliance bez żadnych zmian.
Przepływy dla baterii pozostają niezmienione.
market_countries jest opcjonalne i domyślnie przyjmuje wartość [].

Szczegóły znajdziesz w changelogu oraz w naszej polityce wersjonowania API.

Jak zacząć

Dokumentacja tekstylnego DPP — schemat, zasada mikroplastiku, opcjonalne ESPR
Dokumentacja zgodności z UE — katalog zasad, podgląd na żywo, symulator
Zacznij za darmo — plan darmowy, panel + API
Obserwuj na GitHub — zgłoszenia, wydania SDK, roadmapa

Jeśli masz duży katalog paszportów tekstylnych lub potrzebujesz audytu ryzyka AGEC/Francji, porozmawiaj z nami — jesteśmy gotowi na klientów pilotażowych w przedziale od 500 do 50 000 SKU.