API PPWR do integracji opakowań, dokumentów i raportów

Katalog + dostępny zapas → konfiguracja zestawu → rezerwacja → zużycie albo zwolnienie. Alternatywnie zapisz zużycie zestawu bez rezerwacji lub jawne linie packing-consumptions. Wybierz jedną ścieżkę dla paczki.

1. GET /catalog-items
2. GET /catalog-items/{catalogItemId}/inventory
3. GET /packaging-systems/{recordId}/configuration
4. POST /packaging-systems/{recordId}/reservations
5. POST /packing-reservations/{recordId}/consume
6. GET /packaging-systems/{systemId}/usages

Upload → status wersji → przegląd pliku → analiza/propozycje → decyzja faktu → powiązanie dowodu. Dokument, wersja i fakt mają różne UUID oraz niezależne statusy.

1. POST /documents
2. GET /document-versions/{recordId}
3. POST /document-versions/{recordId}/decision
4. POST /document-versions/{recordId}/analyze
5. GET /evidence-proposals?item={catalogItemId}
6. POST /evidence-proposals/{proposalId}/decision

Pobierz szablon tam, gdzie dostępny → prześlij plik → poczekaj na podgląd → sprawdź wiersze → apply → odczytaj status i raport błędów. Sam upload nie zatwierdza zmian.

1. POST /imports
2. GET /imports/{recordId}
3. GET /imports/{importId}/rows
4. POST /imports/{recordId}/apply
5. GET /imports/{recordId}/result.csv

Dane/dowody → szkic → publikacja → grant odbiorcy. Nowa wersja wymaga osobnego dostępu. Subskrypcje i aktualizacje dotyczą użytkownika klucza; obserwowanie nie oznacza adopcji danych.

1. POST /passports
2. POST /passports/{recordId}/publish
3. POST /passports/{recordId}/shares
4. GET /sharing-grants
5. POST /sharing-grants/{recordId}/revoke

Eksport katalogu/ocen/przepływów działa w kolejce. ROP i odpady: nagłówek → pozycje → przegląd → eksport. BDO: źródła → kwalifikacja → snapshot → eksport. Żadna z tych ścieżek nie składa automatycznie deklaracji do urzędu.

1. POST /reports
2. GET /reports/{recordId}
3. GET /reports/{recordId}/download

Odczytaj źródła → przygotuj współczynniki → wskaż opakowanie/zestaw i ewentualną historyczną podstawę → oblicz → odczytaj snapshot. Wynik nie obejmuje automatycznie całego cyklu życia.

1. GET /carbon-factors/reference
2. POST /carbon-factors
3. POST /carbon-calculations
4. GET /carbon-calculations/{recordId}

Kolejność: kontrahenci i opcjonalne foldery/rodziny → katalog → części i rynki. Historia danych służy później do odtwarzania podstaw operacji.

1. GET /dictionaries
2. POST /parties
3. POST /catalog-items
4. POST /catalog-items/{catalogItemId}/components
5. PUT /catalog-items/{catalogItemId}/markets
6. GET /catalog-items/{catalogItemId}/data-versions

supply-events prowadzi zdarzenia i bilans. flows służy danym raportowym. Ruch może już tworzyć powiązany przepływ: nie wysyłaj obu dla tego samego faktu gospodarczego.

1. POST /catalog-items/{catalogItemId}/supply-events
2. GET /catalog-items/{catalogItemId}/supply-summary
3. GET /catalog-items/{catalogItemId}/inventory
4. GET /flows

Utwórz prośbę → sprawdź pozycje → wyślij e-mail → odbierz pliki → oceń odpowiedzi. Dostawca korzysta z publicznego linku, integrator z klucza organizacji.

1. GET /issues
2. POST /supplier-requests
3. GET /supplier-requests/{requestId}/lines
4. POST /supplier-requests/{recordId}/send
5. POST /supplier-requests/{recordId}/lines/{lineId}/review

Ustal opakowanie, rynek i rolę; przygotuj zatwierdzone źródła. Twórz tylko rejestry dotyczące danego zastosowania. Wpis, przegląd i wynik reguł to różne etapy. Dossier poprzedza deklarację UE.

1. GET /catalog-items/{catalogItemId}/markets
2. POST /assessments
3. GET /assessments/{recordId}
4. POST /assessments/{recordId}/review
5. GET /catalog-items/{catalogItemId}/ppwr-summary

System obiegu → dokumentacja i potwierdzenia rynku → jednostki → zdarzenia obrotu/przegląd → agregacje i okresowe cele. System obiegu nie jest zestawem pakowym.

1. POST /ppwr/reuse-systems
2. POST /catalog-items/{catalogItemId}/ppwr/reuse-units
3. GET /ppwr/reuse-statistics

Specjalistyczne rejestry dokumentacyjne. Kaucje opisują opakowanie i udział w systemie, bez obsługi pieniędzy; HoReCa i informacje odbiorców przechowują oceny i dowody.

1. POST /ppwr/deposit-schemes
2. GET /ppwr/deposit-schemes/{recordId}
3. POST /ppwr/deposit-schemes/{recordId}/review

Zarejestruj żądanie/sprawę → dodaj odpowiedź lub zdarzenia i dowody doręczenia → przeprowadź przegląd tam, gdzie dostępny. Złożenia zewnętrzne dokumentują działania wykonane poza aplikacją.

1. POST /ppwr/authority-requests
2. GET /ppwr/authority-requests/{recordId}
3. GET /audit-log

Dossier porządkuje dokumentację techniczną opakowania. Jego zatwierdzony zapis może być podstawą deklaracji UE; plik PDF jest generowany osobną operacją. Rejestr deklaracji UE powiązanych z dossier konkretnego opakowania, treścią, podpisem i dowodem. Utworzenie rekordu nie podpisuje dokumentu za producenta.

1. POST /catalog-items/{catalogItemId}/ppwr/conformity-dossiers
2. POST /catalog-items/{catalogItemId}/ppwr/conformity-dossiers/{recordId}/review
3. POST /catalog-items/{catalogItemId}/ppwr/eu-declarations
4. POST /catalog-items/{catalogItemId}/ppwr/eu-declarations/{recordId}/review
5. POST /catalog-items/{catalogItemId}/generated-documents

Roczne sprawozdania ROP z pozycjami i przeglądem. Eksport wykorzystuje zapisany wynik; nie oznacza złożenia w krajowym portalu.

1. POST /ppwr/epr-reports
2. POST /ppwr/epr-reports/{parentId}/lines
3. GET /ppwr/epr-reports/{parentId}/lines
4. POST /ppwr/epr-reports/{recordId}/review
5. GET /ppwr/epr-reports/{recordId}/export

Przygotowanie danych opakowaniowych do raportu BDO: źródła, klasyfikacja, snapshot i eksport. API nie składa automatycznie rocznego sprawozdania w BDO ani nie opłaca zobowiązania.

1. GET /bdo-reports/sources?year=2025
2. POST /bdo-reports/classifications
3. POST /bdo-reports
4. GET /bdo-reports/{recordId}
5. GET /bdo-reports/{recordId}/download?format=xlsx

Endpoint HTTPS, zdarzenia i sekret konfiguruje uprawniona osoba w Administracja → Integracje. Odbiorca sprawdza X-PPWR-Signature w formacie t=TIMESTAMP,v1=HEX: HMAC-SHA256 z tekstu timestamp + kropka + surowe body, kluczem jest cały sekret whsec_… (bez dekodowania). Porównuj podpis w stałym czasie i dopuszczaj odchylenie czasu do 300 sekund. Trwale deduplikuj po id zdarzenia z body, sprawdź schema_version i organization_id, a dopiero po zapisie do własnej kolejki odpowiedz 2xx. Kolejność nie jest gwarantowana. Ponowienia zachowują id zdarzenia i body, ale mają świeży podpis. Dla zmiany zasobu odczytaj aktualny stan z API; webhook nie zawiera pełnych danych dokumentu. Schemat body i katalog typów zdarzeń są w sekcji Webhooks kontraktu.