# PPWR Link — Przewodnik integratora — wybierz swój proces PPWR Link API łączy katalog opakowań, dokumenty i zdarzenia z procesami sklepu, ERP lub WMS. Jedna operacja oznacza konkretną metodę HTTP i ścieżkę, nie osobny moduł biznesowy. Wybierz obszary potrzebne integracji; nie musisz wdrażać wszystkich rejestrów PPWR. Dokumentacja jest publiczna, dane organizacji wymagają klucza. API organizacji PPWR Link. Identyfikatory zasobów są UUID. Klucz jest przypisany do jednej organizacji; zakresy klucza i uprawnienia użytkownika obowiązują jednocześnie. Operacje zapisu wymagają Idempotency-Key, chyba że wskazano inaczej. Wartości dziesiętne mas przesyłaj jako tekst. Status oceny nie jest automatycznym potwierdzeniem zgodności. ## Zanim wykonasz pierwsze żądanie 1. Utwórz osobny klucz integracji w Administracja → Organizacje → Klucze API. Klucz należy do użytkownika i jednej organizacji. Muszą być spełnione jednocześnie zakres tokenu, uprawnienie organizacyjne, aktywne członkostwo, weryfikacja e-mail i ewentualna polityka MFA oraz IP. Konto z rolą właściciela nie omija zakresów tokenu. 2. Wyślij `GET /organizations` z `Authorization: Bearer ` i `Accept: application/json`. Zapisz `data[0].id` jako `organizationId`. Nie używaj sluga firmy ani identyfikatora liczbowego. API nie wymaga sesji, cookies ani tokenu CSRF. 3. Pobierz `/organizations/{organizationId}/dictionaries`. Kody materiałów, krajów i opublikowanych reguł pochodzą z tego zasobu. Enum określonego pola zawsze sprawdzaj w schemacie operacji. 4. Dla JSON ustaw `Content-Type: application/json`. Uploady to `multipart/form-data` z plikiem w polu `file`; bibliotekę HTTP pozostaw odpowiedzialną za boundary. `X-Locale: pl|en` wybiera komunikaty. ## Format i zależności danych - Odczyt szczegółów zwraca obiekt bez otoczki `data`. Większość list zwraca `data`, `links.next` i `requestId`. Idź po `links.next` aż do `null`. Wyjątek: źródła BDO używają `page`, `total` i `summary`, a lista organizacji nie jest paginowana. - `id` i referencje do zasobów są publicznymi UUID. `catalogItemId` to opakowanie, `recordId` zasób wskazany w URL; `parentId` jest np. sprawozdaniem, nie opakowaniem. Wszystkie powiązania muszą być dostępne w organizacji klucza, poza jawnym udostępnieniem paszportu. - Katalog używa camelCase (`massG`, `internalCode`, `stockUnit`), większość pozostałych zasobów snake_case. Zachowaj pisownię ze schematu. `version` dokumentu, `revision` rekordu i `data_version` podstawy historycznej to różne wartości. - Liczby dziesiętne podawaj z kropką; masy deklarowane w schemacie jako string przesyłaj jako tekst. Masa opakowania to gramy na jednostkę bazową. Jednostki bazowe to `piece`, `m`, `m2`, `kg`, `l`, `m3`. Dostępne przeliczenia konkretnego opakowania pobierz z `/inventory`. Nie zastępuj `piece` skrótem `pcs`. Jednostki wymiarów są w nazwach pól (`length_mm`, `thickness_um`). - Przykładowe UUID, rewizje i hashe zastąp wartościami pobranymi z API. Zapis z syntetycznymi identyfikatorami nie zadziała. Daty zdarzeń opisują rzeczywisty dzień operacji; sprawdź ograniczenie `before_or_equal:today`. ## Zapisy, ponowienia i statusy - `Idempotency-Key` jest obowiązkowy tylko tam, gdzie widnieje w parametrach operacji. Zapisz losowy klucz 16–100 znaków wraz z treścią żądania. Po timeoutcie ponów tę samą operację z tą samą treścią i kluczem. Zmiana treści z tym samym kluczem daje 409. Odtworzona odpowiedź reprezentuje pierwotny zapis; aktualny stan pobierz GET. - Aktualizacja katalogu PATCH używa `If-Match` z ETag ostatniego GET. Inne operacje przyjmują `revision`, `catalog_revision` lub `market_revision`. Nie zwiększaj rewizji samodzielnie. Przy konflikcie odczytaj rekord ponownie i uzgodnij zmianę. - 200: odczyt lub zakończona akcja; 201: utworzony zapis; 202: przyjęto pracę do kolejki. Upload pliku może zwrócić 201 przed skanowaniem. Zatwierdzenie dokumentu i wynik przetwarzania pliku są osobnymi statusami. - 401: brak ważnego klucza; 403: zakres, rola, IP lub polityka dostępu; 404: zasób nie istnieje albo jest poza organizacją/dostępem; 409: konflikt rewizji, konfiguracji lub idempotencji; 422: pola albo warunki biznesowe; 429: limit, respektuj `Retry-After`; 500: sprawdź stan i ponawiaj bez zmiany klucza idempotencji. Błędy mają `error.code`, `error.message`, `error.fields`, `error.requestId`. Zachowaj także nagłówek `X-Request-ID` do diagnostyki. Limit ogólny: 120 żądań/minutę na użytkownika, dobór opakowania dodatkowo 10/minutę. ## Granice interfejsu Metody opisane poniżej stanowią dostępny kontrakt; nie dopisuj operacji PUT/DELETE przez analogię. Zarządzanie użytkownikami, rolami, kluczami i konfiguracją webhooków pozostaje w panelu. Sekcja OpenAPI `webhooks` opisuje zdarzenia wysyłane do odbiorcy, nie endpointy służące do tworzenia webhooków. W API nie ma płatności kaucji ani automatycznego złożenia rocznego sprawozdania BDO. Rejestr i decyzja wewnętrzna nie są decyzją urzędu. Ograniczenia poszczególnych obszarów są opisane przy metodach. ## Odbieranie webhooków 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. Pełne schematy pól, enum, wymagania warunkowe i formaty odpowiedzi: kontrakt OpenAPI. https://ppwrlink.pl/api/openapi.json?locale=pl Poniższe ścieżki są względne wobec /api/v1/organizations/{organizationId}, chyba że wskazano inaczej. Szczegółowe pola i uprawnienia znajdziesz przy każdej metodzie Swaggera. ## Pakowanie zamówień i magazyn 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` ## Pliki, dowody i powiązania 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` ## Importy i arkusze 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` ## Paszporty i dostęp odbiorców 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` ## Raporty, ROP, BDO i recyklat 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` ## Współczynniki i ślad materiałów 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}` ## Katalog i struktura opakowań 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` ## Ruchy fizyczne i przepływy raportowe 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` ## Współpraca z dostawcami i braki 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` ## Oceny i dokumentacja techniczna PPWR 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` ## Ponowne użycie i egzemplarze zwrotne 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` ## Kaucje, gastronomia i informacje 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` ## Sprawy, złożenia i audyt 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 i deklaracja UE 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` ## Sprawozdanie ROP 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` ## Dane i eksport BDO 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` ## Opis wszystkich operacji ### Start i słowniki Pobierz organizację klucza, następnie słowniki. Zachowuj publiczne UUID i kody; nazwy są prezentacyjne. #### GET /organizations Identyfikator organizacji do API Organizacja to granica dostępu. Klucz zwraca wyłącznie przypisaną organizację; ten zasób nie tworzy firm ani członkostw. Pierwsze wywołanie integracji: zapisz data[0].id i używaj go w organizationId. Nie wymaga dodatkowego zakresu modułowego poza ważnym, dopuszczonym kluczem. #### GET /organizations/{organizationId}/dictionaries Słowniki Kraje, materiały, kategorie i formaty opakowań, role gospodarcze, typy dokumentów oraz opublikowane zestawy reguł. Używaj kodów, nie tłumaczonych etykiet. Pobierz słowniki przed budowaniem formularzy lub mapowaniem danych źródłowych. rule_sets zawiera tylko opublikowane reguły; brak zestawu nie oznacza pozytywnej oceny. Zakres klucza: catalog:read. Uprawnienie w organizacji: catalog.view. ### Katalog i struktura opakowań Kolejność: kontrahenci i opcjonalne foldery/rodziny → katalog → części i rynki. Historia danych służy później do odtwarzania podstaw operacji. #### GET /organizations/{organizationId}/catalog-items Opakowania — Lista Kartoteka pojedynczego rodzaju opakowania lub materiału, np. karton, taśma, folia. Nie jest produktem sprzedawanym przez sklep ani konkretną przesyłką. Skład, dokumenty, rynki i ruchy mają osobne zasoby. Pobierz listę rekordów dostępnych dla organizacji klucza. Zakres klucza: catalog:read. Uprawnienie w organizacji: catalog.view. Lista używa `per_page` (1–100, domyślnie 50) i kursora. Następne żądanie wykonaj pod adresem `links.next`; null kończy listę. Stosuj tylko filtry wymienione w parametrach tej metody. #### POST /organizations/{organizationId}/catalog-items Opakowania — Dodaj Kartoteka pojedynczego rodzaju opakowania lub materiału, np. karton, taśma, folia. Nie jest produktem sprzedawanym przez sklep ani konkretną przesyłką. Skład, dokumenty, rynki i ruchy mają osobne zasoby. Utwórz rekord z danych opisanych w requestBody. Odpowiedź zawiera publiczne id do dalszego odczytu i powiązań. Zakres klucza: catalog:write. Uprawnienie w organizacji: catalog.create. Ta operacja wymaga `Idempotency-Key`. Ponowienie: ta sama metoda, ścieżka, klucz i dane. Nową operację oznacz nowym kluczem; nie obchodź konfliktu przez losowanie klucza bez sprawdzenia poprzedniego wyniku. Przykład pokazuje strukturę. Zastąp UUID, rewizje, daty i configuration_hash rzeczywistymi wartościami; kody jednostek i materiałów muszą odpowiadać konfiguracji opakowania. ```json { "internalCode": "BOX-001", "name": "Shipping box", "sourcingType": "purchased", "massG": "240", "mainMaterialCode": "corrugated_cardboard", "stockUnit": "piece", "stockTracked": true, "foodContactStatus": "no", "reuseType": "single_use" } ``` #### GET /organizations/{organizationId}/catalog-items/{catalogItemId} Opakowania — Szczegóły Kartoteka pojedynczego rodzaju opakowania lub materiału, np. karton, taśma, folia. Nie jest produktem sprzedawanym przez sklep ani konkretną przesyłką. Skład, dokumenty, rynki i ruchy mają osobne zasoby. Pobierz szczegóły istniejącego rekordu. UUID weź z listy lub odpowiedzi tworzenia tego samego rodzaju zasobu. Zakres klucza: catalog:read. Uprawnienie w organizacji: catalog.view. #### PATCH /organizations/{organizationId}/catalog-items/{catalogItemId} Opakowania — Aktualizuj Kartoteka pojedynczego rodzaju opakowania lub materiału, np. karton, taśma, folia. Nie jest produktem sprzedawanym przez sklep ani konkretną przesyłką. Skład, dokumenty, rynki i ruchy mają osobne zasoby. Zaktualizuj wskazany rekord, uwzględniając wymaganą kontrolę rewizji. Sprawdź schemat: PUT nie oznacza, że pola nieobecne zostaną usunięte. Zakres klucza: catalog:write. Uprawnienie w organizacji: catalog.update. Przykład pokazuje strukturę. Zastąp UUID, rewizje, daty i configuration_hash rzeczywistymi wartościami; kody jednostek i materiałów muszą odpowiadać konfiguracji opakowania. ```json { "name": "Shipping box 300 × 200 × 150 mm" } ``` #### POST /organizations/{organizationId}/catalog-items/{catalogItemId}/archive Opakowania — Archiwizuj Kartoteka pojedynczego rodzaju opakowania lub materiału, np. karton, taśma, folia. Nie jest produktem sprzedawanym przez sklep ani konkretną przesyłką. Skład, dokumenty, rynki i ruchy mają osobne zasoby. Archiwizuj rekord. Historia pozostaje dostępna; archiwalnego zasobu nie należy wybierać do nowych operacji. Zakres klucza: catalog:write. Uprawnienie w organizacji: catalog.archive. Ta operacja wymaga `Idempotency-Key`. Ponowienie: ta sama metoda, ścieżka, klucz i dane. Nową operację oznacz nowym kluczem; nie obchodź konfliktu przez losowanie klucza bez sprawdzenia poprzedniego wyniku. #### GET /organizations/{organizationId}/catalog-items/{catalogItemId}/components Komponenty — Lista Części składające się na jedno opakowanie, z parametrami i materiałami. Nie są liniami zestawu do wysyłki. Dodanie części zmienia rewizję karty i aktualność ocen. Pobierz listę rekordów dostępnych dla organizacji klucza. Zakres klucza: catalog:read. Uprawnienie w organizacji: catalog.view. Lista używa `per_page` (1–100, domyślnie 50) i kursora. Następne żądanie wykonaj pod adresem `links.next`; null kończy listę. Stosuj tylko filtry wymienione w parametrach tej metody. #### POST /organizations/{organizationId}/catalog-items/{catalogItemId}/components Komponenty — Dodaj Części składające się na jedno opakowanie, z parametrami i materiałami. Nie są liniami zestawu do wysyłki. Dodanie części zmienia rewizję karty i aktualność ocen. Utwórz rekord z danych opisanych w requestBody. Odpowiedź zawiera publiczne id do dalszego odczytu i powiązań. Zakres klucza: catalog:write. Uprawnienie w organizacji: catalog.update. Ta operacja wymaga `Idempotency-Key`. Ponowienie: ta sama metoda, ścieżka, klucz i dane. Nową operację oznacz nowym kluczem; nie obchodź konfliktu przez losowanie klucza bez sprawdzenia poprzedniego wyniku. #### GET /organizations/{organizationId}/catalog-items/{catalogItemId}/components/{recordId} Komponenty — Szczegóły Części składające się na jedno opakowanie, z parametrami i materiałami. Nie są liniami zestawu do wysyłki. Dodanie części zmienia rewizję karty i aktualność ocen. Pobierz szczegóły istniejącego rekordu. UUID weź z listy lub odpowiedzi tworzenia tego samego rodzaju zasobu. Zakres klucza: catalog:read. Uprawnienie w organizacji: catalog.view. #### GET /organizations/{organizationId}/catalog-items/{catalogItemId}/data-versions Historia danych opakowania — Lista Niezmienna podstawa danych historycznego opakowania: rewizja, parametry, części i hash. Publiczna projekcja nie zawiera prywatnych dokumentów ani faktów. data_version nie jest numerem aktualnej rewizji. Pobierz listę rekordów dostępnych dla organizacji klucza. Zakres klucza: catalog:read. Uprawnienie w organizacji: catalog.view. Lista używa `per_page` (1–100, domyślnie 50) i kursora. Następne żądanie wykonaj pod adresem `links.next`; null kończy listę. Stosuj tylko filtry wymienione w parametrach tej metody. #### GET /organizations/{organizationId}/catalog-items/{catalogItemId}/data-versions/{recordId} Historia danych opakowania — Szczegóły Niezmienna podstawa danych historycznego opakowania: rewizja, parametry, części i hash. Publiczna projekcja nie zawiera prywatnych dokumentów ani faktów. data_version nie jest numerem aktualnej rewizji. Pobierz szczegóły istniejącego rekordu. UUID weź z listy lub odpowiedzi tworzenia tego samego rodzaju zasobu. Zakres klucza: catalog:read. Uprawnienie w organizacji: catalog.view. #### GET /organizations/{organizationId}/catalog-items/{catalogItemId}/markets Rynki — Lista Scenariusze użycia opakowania na rynkach: kraj docelowy, pochodzenie, rola gospodarcza i data. Lista pokazuje aktywne scenariusze. Dodanie rynku nie tworzy przyjęcia ani wydania magazynowego. Pobierz listę rekordów dostępnych dla organizacji klucza. Zakres klucza: catalog:read. Uprawnienie w organizacji: catalog.view. Lista używa `per_page` (1–100, domyślnie 50) i kursora. Następne żądanie wykonaj pod adresem `links.next`; null kończy listę. Stosuj tylko filtry wymienione w parametrach tej metody. #### PUT /organizations/{organizationId}/catalog-items/{catalogItemId}/markets Rynki — Aktualizuj Scenariusze użycia opakowania na rynkach: kraj docelowy, pochodzenie, rola gospodarcza i data. Lista pokazuje aktywne scenariusze. Dodanie rynku nie tworzy przyjęcia ani wydania magazynowego. Prześlij pełną docelową listę markets: pominięty kraj zostaje usunięty z aktywnych scenariuszy, pusta lista usuwa wszystkie. market_revision pobierz z revision karty; market_details jest mapą kodów krajów z rolą i datą. Zakres klucza: catalog:write. Uprawnienie w organizacji: catalog.update. Ta operacja wymaga `Idempotency-Key`. Ponowienie: ta sama metoda, ścieżka, klucz i dane. Nową operację oznacz nowym kluczem; nie obchodź konfliktu przez losowanie klucza bez sprawdzenia poprzedniego wyniku. Przykład pokazuje strukturę. Zastąp UUID, rewizje, daty i configuration_hash rzeczywistymi wartościami; kody jednostek i materiałów muszą odpowiadać konfiguracji opakowania. ```json { "market_revision": 1, "markets": [ "PL" ], "market_details": { "PL": { "origin_country": "PL", "economic_role": "filler_packer", "assessment_date": "2026-09-29" } } } ``` #### GET /organizations/{organizationId}/catalog-items/{catalogItemId}/markets/{recordId} Rynki — Szczegóły Scenariusze użycia opakowania na rynkach: kraj docelowy, pochodzenie, rola gospodarcza i data. Lista pokazuje aktywne scenariusze. Dodanie rynku nie tworzy przyjęcia ani wydania magazynowego. Pobierz szczegóły istniejącego rekordu. UUID weź z listy lub odpowiedzi tworzenia tego samego rodzaju zasobu. Zakres klucza: catalog:read. Uprawnienie w organizacji: catalog.view. #### POST /organizations/{organizationId}/catalog-items/{catalogItemId}/restore Opakowania — Przywróć Kartoteka pojedynczego rodzaju opakowania lub materiału, np. karton, taśma, folia. Nie jest produktem sprzedawanym przez sklep ani konkretną przesyłką. Skład, dokumenty, rynki i ruchy mają osobne zasoby. Przywróć archiwalny rekord do bieżącej pracy. Wymagana rewizja pochodzi z ostatniego odczytu. Zakres klucza: catalog:write. Uprawnienie w organizacji: catalog.archive. Ta operacja wymaga `Idempotency-Key`. Ponowienie: ta sama metoda, ścieżka, klucz i dane. Nową operację oznacz nowym kluczem; nie obchodź konfliktu przez losowanie klucza bez sprawdzenia poprzedniego wyniku. #### GET /organizations/{organizationId}/families Rodziny opakowań — Lista Rodzina grupuje opakowania pod wspólną identyfikacją producenta i dokumentacją. Nie zastępuje folderu ani zestawu zużywanego przy pakowaniu. Pobierz listę rekordów dostępnych dla organizacji klucza. Zakres klucza: catalog:read. Uprawnienie w organizacji: catalog.view. Lista używa `per_page` (1–100, domyślnie 50) i kursora. Następne żądanie wykonaj pod adresem `links.next`; null kończy listę. Stosuj tylko filtry wymienione w parametrach tej metody. #### POST /organizations/{organizationId}/families Rodziny opakowań — Dodaj Rodzina grupuje opakowania pod wspólną identyfikacją producenta i dokumentacją. Nie zastępuje folderu ani zestawu zużywanego przy pakowaniu. Utwórz rekord z danych opisanych w requestBody. Odpowiedź zawiera publiczne id do dalszego odczytu i powiązań. Zakres klucza: catalog:write. Uprawnienie w organizacji: catalog.create. Ta operacja wymaga `Idempotency-Key`. Ponowienie: ta sama metoda, ścieżka, klucz i dane. Nową operację oznacz nowym kluczem; nie obchodź konfliktu przez losowanie klucza bez sprawdzenia poprzedniego wyniku. #### GET /organizations/{organizationId}/families/{recordId} Rodziny opakowań — Szczegóły Rodzina grupuje opakowania pod wspólną identyfikacją producenta i dokumentacją. Nie zastępuje folderu ani zestawu zużywanego przy pakowaniu. Pobierz szczegóły istniejącego rekordu. UUID weź z listy lub odpowiedzi tworzenia tego samego rodzaju zasobu. Zakres klucza: catalog:read. Uprawnienie w organizacji: catalog.view. #### PUT /organizations/{organizationId}/families/{recordId} Rodziny opakowań — Aktualizuj Rodzina grupuje opakowania pod wspólną identyfikacją producenta i dokumentacją. Nie zastępuje folderu ani zestawu zużywanego przy pakowaniu. Zaktualizuj wskazany rekord, uwzględniając wymaganą kontrolę rewizji. Sprawdź schemat: PUT nie oznacza, że pola nieobecne zostaną usunięte. Zakres klucza: catalog:write. Uprawnienie w organizacji: catalog.update. Ta operacja wymaga `Idempotency-Key`. Ponowienie: ta sama metoda, ścieżka, klucz i dane. Nową operację oznacz nowym kluczem; nie obchodź konfliktu przez losowanie klucza bez sprawdzenia poprzedniego wyniku. #### GET /organizations/{organizationId}/folders Foldery — Lista Własne drzewo folderów organizacji porządkuje katalog. Folder nie jest kategorią PPWR; parent jest UUID innego folderu, a folder karty ustawia się w katalogu. Pobierz listę rekordów dostępnych dla organizacji klucza. Zakres klucza: catalog:read. Uprawnienie w organizacji: catalog.view. Lista używa `per_page` (1–100, domyślnie 50) i kursora. Następne żądanie wykonaj pod adresem `links.next`; null kończy listę. Stosuj tylko filtry wymienione w parametrach tej metody. #### POST /organizations/{organizationId}/folders Foldery — Dodaj Własne drzewo folderów organizacji porządkuje katalog. Folder nie jest kategorią PPWR; parent jest UUID innego folderu, a folder karty ustawia się w katalogu. Utwórz rekord z danych opisanych w requestBody. Odpowiedź zawiera publiczne id do dalszego odczytu i powiązań. Zakres klucza: catalog:write. Uprawnienie w organizacji: catalog.create. Ta operacja wymaga `Idempotency-Key`. Ponowienie: ta sama metoda, ścieżka, klucz i dane. Nową operację oznacz nowym kluczem; nie obchodź konfliktu przez losowanie klucza bez sprawdzenia poprzedniego wyniku. Przykład pokazuje strukturę. Zastąp UUID, rewizje, daty i configuration_hash rzeczywistymi wartościami; kody jednostek i materiałów muszą odpowiadać konfiguracji opakowania. ```json { "name": "E-commerce" } ``` #### GET /organizations/{organizationId}/folders/{recordId} Foldery — Szczegóły Własne drzewo folderów organizacji porządkuje katalog. Folder nie jest kategorią PPWR; parent jest UUID innego folderu, a folder karty ustawia się w katalogu. Pobierz szczegóły istniejącego rekordu. UUID weź z listy lub odpowiedzi tworzenia tego samego rodzaju zasobu. Zakres klucza: catalog:read. Uprawnienie w organizacji: catalog.view. #### PUT /organizations/{organizationId}/folders/{recordId} Foldery — Aktualizuj Własne drzewo folderów organizacji porządkuje katalog. Folder nie jest kategorią PPWR; parent jest UUID innego folderu, a folder karty ustawia się w katalogu. Zaktualizuj wskazany rekord, uwzględniając wymaganą kontrolę rewizji. Sprawdź schemat: PUT nie oznacza, że pola nieobecne zostaną usunięte. Zakres klucza: catalog:write. Uprawnienie w organizacji: catalog.update. Ta operacja wymaga `Idempotency-Key`. Ponowienie: ta sama metoda, ścieżka, klucz i dane. Nową operację oznacz nowym kluczem; nie obchodź konfliktu przez losowanie klucza bez sprawdzenia poprzedniego wyniku. #### DELETE /organizations/{organizationId}/folders/{recordId} Foldery — Usuń Własne drzewo folderów organizacji porządkuje katalog. Folder nie jest kategorią PPWR; parent jest UUID innego folderu, a folder karty ustawia się w katalogu. Usuń pusty folder z aktualną revision. Folder zawierający opakowania lub podfoldery zwraca 422; najpierw przenieś jego zawartość. Opakowania nie są kasowane. Zakres klucza: catalog:write. Uprawnienie w organizacji: catalog.update. Ta operacja wymaga `Idempotency-Key`. Ponowienie: ta sama metoda, ścieżka, klucz i dane. Nową operację oznacz nowym kluczem; nie obchodź konfliktu przez losowanie klucza bez sprawdzenia poprzedniego wyniku. #### GET /organizations/{organizationId}/parties Kontrahenci — Lista Kontrahenci pełnią role dostawcy, producenta lub odbiorcy. UUID można powiązać z kartą opakowania. Publiczne API udostępnia listę, szczegóły i tworzenie z pól schematu; nie wystawia pełnej edycji adresów, osób kontaktowych ani wyszukiwania po NIP z panelu. Pobierz listę rekordów dostępnych dla organizacji klucza. Zakres klucza: catalog:read. Uprawnienie w organizacji: suppliers.manage. Lista używa `per_page` (1–100, domyślnie 50) i kursora. Następne żądanie wykonaj pod adresem `links.next`; null kończy listę. Stosuj tylko filtry wymienione w parametrach tej metody. #### POST /organizations/{organizationId}/parties Kontrahenci — Dodaj Kontrahenci pełnią role dostawcy, producenta lub odbiorcy. UUID można powiązać z kartą opakowania. Publiczne API udostępnia listę, szczegóły i tworzenie z pól schematu; nie wystawia pełnej edycji adresów, osób kontaktowych ani wyszukiwania po NIP z panelu. Utwórz rekord z danych opisanych w requestBody. Odpowiedź zawiera publiczne id do dalszego odczytu i powiązań. Zakres klucza: catalog:write. Uprawnienie w organizacji: suppliers.manage. Ta operacja wymaga `Idempotency-Key`. Ponowienie: ta sama metoda, ścieżka, klucz i dane. Nową operację oznacz nowym kluczem; nie obchodź konfliktu przez losowanie klucza bez sprawdzenia poprzedniego wyniku. #### GET /organizations/{organizationId}/parties/{recordId} Kontrahenci — Szczegóły Kontrahenci pełnią role dostawcy, producenta lub odbiorcy. UUID można powiązać z kartą opakowania. Publiczne API udostępnia listę, szczegóły i tworzenie z pól schematu; nie wystawia pełnej edycji adresów, osób kontaktowych ani wyszukiwania po NIP z panelu. Pobierz szczegóły istniejącego rekordu. UUID weź z listy lub odpowiedzi tworzenia tego samego rodzaju zasobu. Zakres klucza: catalog:read. Uprawnienie w organizacji: suppliers.manage. ### Pakowanie zamówień i magazyn 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. #### GET /organizations/{organizationId}/catalog-items/{catalogItemId}/inventory Stan magazynowy Stan konkretnego opakowania oraz jego przeliczenia jednostek. Rozróżniaj stan fizyczny, zarezerwowany i dostępny; przy stock_tracked=false nie traktuj wyniku jako potwierdzenia dostępności magazynowej. Odczytaj stock i units przed przeliczeniem ilości. Przy kilku historycznych wersjach wybierz data_version; serwer nie zakłada automatycznego FIFO. Zakres klucza: flows:read. Uprawnienie w organizacji: catalog.view. #### GET /organizations/{organizationId}/packaging-systems Zestawy do pakowania — Lista Zestaw do pakowania to receptura, np. karton + taśma + wypełnienie. Nie jest systemem kaucyjnym ani systemem ponownego użycia. Archiwalne zestawy filtruj parametrem archived. Pobierz listę rekordów dostępnych dla organizacji klucza. Zakres klucza: catalog:read. Uprawnienie w organizacji: catalog.view. Lista używa `per_page` (1–100, domyślnie 50) i kursora. Następne żądanie wykonaj pod adresem `links.next`; null kończy listę. Stosuj tylko filtry wymienione w parametrach tej metody. #### POST /organizations/{organizationId}/packaging-systems Zestawy do pakowania — Dodaj Zestaw do pakowania przechowuje recepturę jednej paczki. Konfiguracja wylicza ilości, masę i dostępność; dopiero zużycie lub rozliczenie rezerwacji zapisuje wykorzystanie składników. Utwórz rekord z danych opisanych w requestBody. Odpowiedź zawiera publiczne id do dalszego odczytu i powiązań. Zakres klucza: catalog:write. Uprawnienie w organizacji: catalog.create. Ta operacja wymaga `Idempotency-Key`. Ponowienie: ta sama metoda, ścieżka, klucz i dane. Nową operację oznacz nowym kluczem; nie obchodź konfliktu przez losowanie klucza bez sprawdzenia poprzedniego wyniku. #### GET /organizations/{organizationId}/packaging-systems/{recordId} Zestawy do pakowania — Szczegóły Zestaw do pakowania to receptura, np. karton + taśma + wypełnienie. Nie jest systemem kaucyjnym ani systemem ponownego użycia. Archiwalne zestawy filtruj parametrem archived. Pobierz szczegóły istniejącego rekordu. UUID weź z listy lub odpowiedzi tworzenia tego samego rodzaju zasobu. Zakres klucza: catalog:read. Uprawnienie w organizacji: catalog.view. #### PUT /organizations/{organizationId}/packaging-systems/{recordId} Zestawy do pakowania — Aktualizuj Zestaw do pakowania przechowuje recepturę jednej paczki. Konfiguracja wylicza ilości, masę i dostępność; dopiero zużycie lub rozliczenie rezerwacji zapisuje wykorzystanie składników. Zaktualizuj wskazany rekord, uwzględniając wymaganą kontrolę rewizji. Sprawdź schemat: PUT nie oznacza, że pola nieobecne zostaną usunięte. Zakres klucza: catalog:write. Uprawnienie w organizacji: catalog.update. Ta operacja wymaga `Idempotency-Key`. Ponowienie: ta sama metoda, ścieżka, klucz i dane. Nową operację oznacz nowym kluczem; nie obchodź konfliktu przez losowanie klucza bez sprawdzenia poprzedniego wyniku. #### POST /organizations/{organizationId}/packaging-systems/{recordId}/archive Zestawy do pakowania — Archiwizuj Zestaw do pakowania przechowuje recepturę jednej paczki. Konfiguracja wylicza ilości, masę i dostępność; dopiero zużycie lub rozliczenie rezerwacji zapisuje wykorzystanie składników. Archiwizuj rekord. Historia pozostaje dostępna; archiwalnego zasobu nie należy wybierać do nowych operacji. Zakres klucza: catalog:write. Uprawnienie w organizacji: catalog.archive. Ta operacja wymaga `Idempotency-Key`. Ponowienie: ta sama metoda, ścieżka, klucz i dane. Nową operację oznacz nowym kluczem; nie obchodź konfliktu przez losowanie klucza bez sprawdzenia poprzedniego wyniku. #### GET /organizations/{organizationId}/packaging-systems/{recordId}/configuration Zestawy do pakowania — Konfiguracja do pakowania Zestaw do pakowania przechowuje recepturę jednej paczki. Konfiguracja wylicza ilości, masę i dostępność; dopiero zużycie lub rozliczenie rezerwacji zapisuje wykorzystanie składników. Pobierz skład, configuration_hash i revision przed rezerwacją/zużyciem. ready opisuje kompletność konfiguracji, nie gwarancję zapasu; sprawdź available_sets oraz all_stock_tracked. Zakres klucza: catalog:read. Uprawnienie w organizacji: catalog.view. #### POST /organizations/{organizationId}/packaging-systems/{recordId}/consumptions Zestawy do pakowania — Zapisz zużycie zestawu Zestaw do pakowania przechowuje recepturę jednej paczki. Konfiguracja wylicza ilości, masę i dostępność; dopiero zużycie lub rozliczenie rezerwacji zapisuje wykorzystanie składników. Zapisz faktyczne zużycie receptury dla order_reference. Prześlij revision i configuration_hash z konfiguracji oraz sets_count. Zapis wszystkich składników jest atomowy; nie wysyłaj dodatkowego packing-consumptions dla tej samej paczki. Zakres klucza: flows:write. Uprawnienie w organizacji: catalog.update. Ta operacja wymaga `Idempotency-Key`. Ponowienie: ta sama metoda, ścieżka, klucz i dane. Nową operację oznacz nowym kluczem; nie obchodź konfliktu przez losowanie klucza bez sprawdzenia poprzedniego wyniku. Przykład pokazuje strukturę. Zastąp UUID, rewizje, daty i configuration_hash rzeczywistymi wartościami; kody jednostek i materiałów muszą odpowiadać konfiguracji opakowania. ```json { "revision": 1, "configuration_hash": "aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa", "sets_count": 1, "order_reference": "STORE-1/ORDER-100/PARCEL-1", "event_on": "2026-09-29", "country": "PL" } ``` #### POST /organizations/{organizationId}/packaging-systems/{recordId}/items Zestawy do pakowania — Dodaj pozycję Zestaw do pakowania przechowuje recepturę jednej paczki. Konfiguracja wylicza ilości, masę i dostępność; dopiero zużycie lub rozliczenie rezerwacji zapisuje wykorzystanie składników. Dodaj linię receptury; podanie line aktualizuje istniejącą linię. revision odnosi się do zestawu. Po zapisie pobierz nową konfigurację i hash. Zakres klucza: catalog:write. Uprawnienie w organizacji: catalog.update. Ta operacja wymaga `Idempotency-Key`. Ponowienie: ta sama metoda, ścieżka, klucz i dane. Nową operację oznacz nowym kluczem; nie obchodź konfliktu przez losowanie klucza bez sprawdzenia poprzedniego wyniku. #### DELETE /organizations/{organizationId}/packaging-systems/{recordId}/items/{lineId} Zestawy do pakowania — Usuń składnik Zestaw do pakowania przechowuje recepturę jednej paczki. Konfiguracja wylicza ilości, masę i dostępność; dopiero zużycie lub rozliczenie rezerwacji zapisuje wykorzystanie składników. Usuń linię wskazanego zestawu z kontrolą jego rewizji. Odpowiedź zawiera id i nową revision zestawu. Historia zużycia pozostaje. Zakres klucza: catalog:write. Uprawnienie w organizacji: catalog.update. Ta operacja wymaga `Idempotency-Key`. Ponowienie: ta sama metoda, ścieżka, klucz i dane. Nową operację oznacz nowym kluczem; nie obchodź konfliktu przez losowanie klucza bez sprawdzenia poprzedniego wyniku. #### POST /organizations/{organizationId}/packaging-systems/{recordId}/reservations Rezerwacje dla zamówień — Dodaj Rezerwacja zestawu na zamówienie blokuje dostępne materiały, ale jeszcze nie tworzy zużycia. Stany: held, released, consumed; wygasła rezerwacja jest rozpoznawana także po expires_at, zanim zmieni się zapisany status. Zarezerwuj zestaw na 1–168 godzin. Wymagane są kontrolowane stany wszystkich składników, aktualna konfiguracja i dostępny zapas. Zachowaj UUID rezerwacji do release albo consume. Zakres klucza: flows:write. Uprawnienie w organizacji: catalog.update. Ta operacja wymaga `Idempotency-Key`. Ponowienie: ta sama metoda, ścieżka, klucz i dane. Nową operację oznacz nowym kluczem; nie obchodź konfliktu przez losowanie klucza bez sprawdzenia poprzedniego wyniku. Przykład pokazuje strukturę. Zastąp UUID, rewizje, daty i configuration_hash rzeczywistymi wartościami; kody jednostek i materiałów muszą odpowiadać konfiguracji opakowania. ```json { "revision": 1, "configuration_hash": "aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa", "sets_count": 1, "order_reference": "STORE-1/ORDER-100/PARCEL-1", "country": "PL", "expires_in_hours": 24 } ``` #### POST /organizations/{organizationId}/packaging-systems/{recordId}/restore Zestawy do pakowania — Przywróć Zestaw do pakowania przechowuje recepturę jednej paczki. Konfiguracja wylicza ilości, masę i dostępność; dopiero zużycie lub rozliczenie rezerwacji zapisuje wykorzystanie składników. Przywróć archiwalny rekord do bieżącej pracy. Wymagana rewizja pochodzi z ostatniego odczytu. Zakres klucza: catalog:write. Uprawnienie w organizacji: catalog.archive. Ta operacja wymaga `Idempotency-Key`. Ponowienie: ta sama metoda, ścieżka, klucz i dane. Nową operację oznacz nowym kluczem; nie obchodź konfliktu przez losowanie klucza bez sprawdzenia poprzedniego wyniku. #### GET /organizations/{organizationId}/packaging-systems/{systemId}/items Skład zestawu do pakowania — Lista Linie receptury: opakowanie, ilość, jednostka, rola i wskazanie opakowania zewnętrznego. item jest UUID kartoteki, line jest UUID pozycji zestawu. Pobierz listę rekordów dostępnych dla organizacji klucza. Zakres klucza: catalog:read. Uprawnienie w organizacji: catalog.view. Lista używa `per_page` (1–100, domyślnie 50) i kursora. Następne żądanie wykonaj pod adresem `links.next`; null kończy listę. Stosuj tylko filtry wymienione w parametrach tej metody. #### GET /organizations/{organizationId}/packaging-systems/{systemId}/usages Wykorzystanie zestawów — Lista Historia wykorzystania zestawu zawiera zapisany skład i zdarzenia zużycia. Odczyt historyczny nie powinien korzystać z dzisiejszej receptury. Pobierz listę rekordów dostępnych dla organizacji klucza. Zakres klucza: flows:read. Uprawnienie w organizacji: catalog.view. Lista używa `per_page` (1–100, domyślnie 50) i kursora. Następne żądanie wykonaj pod adresem `links.next`; null kończy listę. Stosuj tylko filtry wymienione w parametrach tej metody. #### POST /organizations/{organizationId}/packing-consumptions Zużycie w zamówieniu — Dodaj Jednorazowe pakowanie z jawnie podanymi składnikami, bez receptury zestawu. Każda linia odwołuje się do karty opakowania i jej rewizji; zapis jest atomowy. Zapisz linie zużycia dla unikalnej referencji zamówienia/paczki. Każde item występuje raz. Wymagana dostępność przy kontroli stanu; w razie błędu żadna linia nie zostaje częściowo odjęta. Zakres klucza: flows:write. Uprawnienie w organizacji: catalog.update. Ta operacja wymaga `Idempotency-Key`. Ponowienie: ta sama metoda, ścieżka, klucz i dane. Nową operację oznacz nowym kluczem; nie obchodź konfliktu przez losowanie klucza bez sprawdzenia poprzedniego wyniku. Przykład pokazuje strukturę. Zastąp UUID, rewizje, daty i configuration_hash rzeczywistymi wartościami; kody jednostek i materiałów muszą odpowiadać konfiguracji opakowania. ```json { "order_reference": "STORE-1/ORDER-100/PARCEL-1", "event_on": "2026-09-29", "country": "PL", "lines": [ { "item": "11111111-1111-4111-8111-111111111111", "revision": 1, "quantity": 1, "unit": "piece", "reusable": false } ] } ``` #### POST /organizations/{organizationId}/packing-recommendations Dobór opakowania — Zaproponuj opakowanie Dobór opakowania do wymiarów produktów jest obliczeniem na podstawie katalogu i konfiguracji. Wynik może zawierać wykluczenia i braki danych; nie jest rezerwacją ani zapisem zużycia. Oblicz kandydatów bez zapisu i bez Idempotency-Key. Sprawdź powody wykluczeń, wymiary i ilości; wybrany kandydat wymaga osobnej rezerwacji/zużycia. Maksymalnie 100 sztuk produktów, limit 10 żądań/min. Zakres klucza: flows:read. Uprawnienie w organizacji: catalog.view. #### GET /organizations/{organizationId}/packing-reservations Rezerwacje dla zamówień — Lista Rezerwacja zestawu na zamówienie blokuje dostępne materiały, ale jeszcze nie tworzy zużycia. Stany: held, released, consumed; wygasła rezerwacja jest rozpoznawana także po expires_at, zanim zmieni się zapisany status. Pobierz listę rekordów dostępnych dla organizacji klucza. Zakres klucza: flows:read. Uprawnienie w organizacji: catalog.view. Lista używa `per_page` (1–100, domyślnie 50) i kursora. Następne żądanie wykonaj pod adresem `links.next`; null kończy listę. Stosuj tylko filtry wymienione w parametrach tej metody. #### GET /organizations/{organizationId}/packing-reservations/{recordId} Rezerwacje dla zamówień — Szczegóły Rezerwacja zestawu na zamówienie blokuje dostępne materiały, ale jeszcze nie tworzy zużycia. Stany: held, released, consumed; wygasła rezerwacja jest rozpoznawana także po expires_at, zanim zmieni się zapisany status. Pobierz szczegóły istniejącego rekordu. UUID weź z listy lub odpowiedzi tworzenia tego samego rodzaju zasobu. Zakres klucza: flows:read. Uprawnienie w organizacji: catalog.view. #### POST /organizations/{organizationId}/packing-reservations/{recordId}/consume Rezerwacje dla zamówień — Zapisz zużycie zestawu Rezerwacja zestawu na zamówienie blokuje dostępne materiały, ale jeszcze nie tworzy zużycia. Stany: held, released, consumed; wygasła rezerwacja jest rozpoznawana także po expires_at, zanim zmieni się zapisany status. Rozlicz aktywną rezerwację jako rzeczywiste pakowanie. Odpowiedź jest rekordem wykorzystania zestawu, nie rezerwacją. Numer zamówienia, kraj i skład pochodzą z rezerwacji. Wygasłej rezerwacji nie można wykorzystać. Zakres klucza: flows:write. Uprawnienie w organizacji: catalog.update. Ta operacja wymaga `Idempotency-Key`. Ponowienie: ta sama metoda, ścieżka, klucz i dane. Nową operację oznacz nowym kluczem; nie obchodź konfliktu przez losowanie klucza bez sprawdzenia poprzedniego wyniku. Przykład pokazuje strukturę. Zastąp UUID, rewizje, daty i configuration_hash rzeczywistymi wartościami; kody jednostek i materiałów muszą odpowiadać konfiguracji opakowania. ```json { "revision": 1, "event_on": "2026-09-29" } ``` #### POST /organizations/{organizationId}/packing-reservations/{recordId}/release Rezerwacje dla zamówień — Zwolnij rezerwację Rezerwacja zestawu na zamówienie blokuje dostępne materiały, ale jeszcze nie tworzy zużycia. Stany: held, released, consumed; wygasła rezerwacja jest rozpoznawana także po expires_at, zanim zmieni się zapisany status. Zwolnij aktywną rezerwację z jej revision. Przywraca dostępność bez raportowania zużycia; nie odwraca już wykorzystanej rezerwacji. Zakres klucza: flows:write. Uprawnienie w organizacji: catalog.update. Ta operacja wymaga `Idempotency-Key`. Ponowienie: ta sama metoda, ścieżka, klucz i dane. Nową operację oznacz nowym kluczem; nie obchodź konfliktu przez losowanie klucza bez sprawdzenia poprzedniego wyniku. Przykład pokazuje strukturę. Zastąp UUID, rewizje, daty i configuration_hash rzeczywistymi wartościami; kody jednostek i materiałów muszą odpowiadać konfiguracji opakowania. ```json { "revision": 1 } ``` ### Ruchy fizyczne i przepływy raportowe 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. #### GET /organizations/{organizationId}/catalog-items/{catalogItemId}/supply-events Rejestr dostaw — Lista Rejestr fizycznych przyjęć, produkcji, wydań, zużycia, stanu otwarcia i korekt. Zachowuje ilość, jednostkę, kontrahenta, dzień i podstawę historyczną. Wykorzystuj go do stanów i identyfikowalności. Pobierz listę rekordów dostępnych dla organizacji klucza. Zakres klucza: flows:read. Uprawnienie w organizacji: catalog.view. Lista używa `per_page` (1–100, domyślnie 50) i kursora. Następne żądanie wykonaj pod adresem `links.next`; null kończy listę. Stosuj tylko filtry wymienione w parametrach tej metody. #### POST /organizations/{organizationId}/catalog-items/{catalogItemId}/supply-events Rejestr dostaw — Dodaj Rejestr fizycznych przyjęć, produkcji, wydań, zużycia, stanu otwarcia i korekt. Zachowuje ilość, jednostkę, kontrahenta, dzień i podstawę historyczną. Wykorzystuj go do stanów i identyfikowalności. Wybierz direction. received/supplied wymagają kontrahenta; used wymaga usage_channel, a ecommerce także transaction_reference. Podaj quantity+unit albo quantity_units, nigdy oba warianty. Korekty wymagają note. data_version identyfikuje historyczną podstawę zużywanego zapasu. Zakres klucza: flows:write. Uprawnienie w organizacji: catalog.update. Ta operacja wymaga `Idempotency-Key`. Ponowienie: ta sama metoda, ścieżka, klucz i dane. Nową operację oznacz nowym kluczem; nie obchodź konfliktu przez losowanie klucza bez sprawdzenia poprzedniego wyniku. Przykład pokazuje strukturę. Zastąp UUID, rewizje, daty i configuration_hash rzeczywistymi wartościami; kody jednostek i materiałów muszą odpowiadać konfiguracji opakowania. ```json { "catalog_revision": 1, "direction": "received", "quantity": 100, "unit": "piece", "counterparty_name": "Example supplier", "counterparty_country": "PL", "counterparty_address": "Example street 1, 00-001 Warsaw", "event_on": "2026-09-29", "reusable_at_event": "no" } ``` #### GET /organizations/{organizationId}/catalog-items/{catalogItemId}/supply-events/{recordId} Rejestr dostaw — Szczegóły Rejestr fizycznych przyjęć, produkcji, wydań, zużycia, stanu otwarcia i korekt. Zachowuje ilość, jednostkę, kontrahenta, dzień i podstawę historyczną. Wykorzystuj go do stanów i identyfikowalności. Pobierz szczegóły istniejącego rekordu. UUID weź z listy lub odpowiedzi tworzenia tego samego rodzaju zasobu. Zakres klucza: flows:read. Uprawnienie w organizacji: catalog.view. #### GET /organizations/{organizationId}/catalog-items/{catalogItemId}/supply-summary Bilans dostaw Bilans zdarzeń konkretnego opakowania, w tym dostępność i podział podstaw historycznych. Jest wynikiem rejestru, nie osobnym miejscem zapisu stanu. Odczytaj bilans przed wydaniem i ponownie po zapisie. Nie zapisuj go lokalnie jako niezmiennego stanu magazynu. Zakres klucza: flows:read. Uprawnienie w organizacji: catalog.view. #### GET /organizations/{organizationId}/flows Przepływy — Lista Przepływy do raportowania placed/used zawierają ilość i masę. Ręczny zapis /flows nie aktualizuje fizycznego magazynu. Nie duplikuj tu przepływu już utworzonego przez zdarzenie zużycia. Pobierz listę rekordów dostępnych dla organizacji klucza. Zakres klucza: flows:read. Uprawnienie w organizacji: reports.view. Lista używa `per_page` (1–100, domyślnie 50) i kursora. Następne żądanie wykonaj pod adresem `links.next`; null kończy listę. Stosuj tylko filtry wymienione w parametrach tej metody. #### POST /organizations/{organizationId}/flows Przepływy — Dodaj Przepływy do raportowania placed/used zawierają ilość i masę. Ręczny zapis /flows nie aktualizuje fizycznego magazynu. Nie duplikuj tu przepływu już utworzonego przez zdarzenie zużycia. Dodaj samodzielny zapis raportowy placed lub used. mass_g jest masą tego przepływu; podaj ją jawnie. Zapis nie tworzy supply-event i nie odejmuje zapasu. Zakres klucza: flows:write. Uprawnienie w organizacji: reports.export. Ta operacja wymaga `Idempotency-Key`. Ponowienie: ta sama metoda, ścieżka, klucz i dane. Nową operację oznacz nowym kluczem; nie obchodź konfliktu przez losowanie klucza bez sprawdzenia poprzedniego wyniku. #### GET /organizations/{organizationId}/flows/{recordId} Przepływy — Szczegóły Przepływy do raportowania placed/used zawierają ilość i masę. Ręczny zapis /flows nie aktualizuje fizycznego magazynu. Nie duplikuj tu przepływu już utworzonego przez zdarzenie zużycia. Pobierz szczegóły istniejącego rekordu. UUID weź z listy lub odpowiedzi tworzenia tego samego rodzaju zasobu. Zakres klucza: flows:read. Uprawnienie w organizacji: reports.view. ### Pliki, dowody i powiązania 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. #### POST /organizations/{organizationId}/catalog-items/{catalogItemId}/generated-documents Dokumenty — Generuj Dokument to metadane powiązane z opakowaniem; plik i jego przegląd należą do konkretnej wersji. Upload, skanowanie, analiza AI i akceptacja danych są oddzielnymi krokami. Wygeneruj obsługiwany rodzaj dokumentu na podstawie karty i catalog_revision. Wymagania zależą od kind; draft deklaracji nie staje się podpisaną deklaracją przez sam eksport PDF. Zakres klucza: documents:upload. Uprawnienie w organizacji: documents.upload. Ta operacja wymaga `Idempotency-Key`. Ponowienie: ta sama metoda, ścieżka, klucz i dane. Nową operację oznacz nowym kluczem; nie obchodź konfliktu przez losowanie klucza bez sprawdzenia poprzedniego wyniku. #### GET /organizations/{organizationId}/catalog-items/{catalogItemId}/traceability Identyfikowalność Powiązania identyfikacyjne i dokumentacyjne łączą opakowanie, kody dostawcy/producenta, rodzinę i źródła. To nie rejestr fizycznego transportu lub magazynu. Pobierz powiązania dokumentacyjne aktualne na dzień odczytu. Do fizycznych przyjęć i wydań użyj supply-events. Zakres klucza: documents:read. Uprawnienie w organizacji: documents.view. #### POST /organizations/{organizationId}/catalog-items/{catalogItemId}/traceability Identyfikowalność — Powiąż Powiązania identyfikacyjne i dokumentacyjne łączą opakowanie, kody dostawcy/producenta, rodzinę i źródła. To nie rejestr fizycznego transportu lub magazynu. Powiąż zatwierdzoną wersję dokumentu z opakowaniem i typem link_type. version jest UUID pliku, revision rewizją karty opakowania. Zakres klucza: evidence:review. Uprawnienie w organizacji: evidence.review. Ta operacja wymaga `Idempotency-Key`. Ponowienie: ta sama metoda, ścieżka, klucz i dane. Nową operację oznacz nowym kluczem; nie obchodź konfliktu przez losowanie klucza bez sprawdzenia poprzedniego wyniku. #### GET /organizations/{organizationId}/document-versions/{recordId} Wersje dokumentów — Szczegóły Wersja dokumentu identyfikuje konkretny plik oraz processing_status, review_status, terminy i rewizję. Zatwierdzenie nie zastępuje zakończenia bezpiecznego przetwarzania pliku. Pobierz szczegóły istniejącego rekordu. UUID weź z listy lub odpowiedzi tworzenia tego samego rodzaju zasobu. Zakres klucza: documents:read. Uprawnienie w organizacji: documents.view. #### POST /organizations/{organizationId}/document-versions/{recordId}/analyze Dokumenty — Analizuj Dokument to metadane powiązane z opakowaniem; plik i jego przegląd należą do konkretnej wersji. Upload, skanowanie, analiza AI i akceptacja danych są oddzielnymi krokami. Zleć analizę dopuszczonej wersji dokumentu. Odpowiedź 200 potwierdza przyjęcie akcji, nie zakończenie AI. Sprawdzaj wersję i listę evidence-proposals; propozycje wymagają decyzji człowieka. Zakres klucza: evidence:review. Uprawnienie w organizacji: evidence.review. Ta operacja wymaga `Idempotency-Key`. Ponowienie: ta sama metoda, ścieżka, klucz i dane. Nową operację oznacz nowym kluczem; nie obchodź konfliktu przez losowanie klucza bez sprawdzenia poprzedniego wyniku. #### POST /organizations/{organizationId}/document-versions/{recordId}/decision Dokumenty — Decyzja Dokument to metadane powiązane z opakowaniem; plik i jego przegląd należą do konkretnej wersji. Upload, skanowanie, analiza AI i akceptacja danych są oddzielnymi krokami. Zatwierdź, odrzuć lub wycofaj wersję, podając jej revision i reason. Poza documents.view akcja wymaga documents.approve dla approved/rejected albo documents.revoke dla revoked. Przetwarzanie musi mieć status review_required; zatwierdzenie/odrzucenie dotyczy unreviewed/in_review, a wycofanie approved. Przy dual_control zatwierdzenie własnego pliku wymaga roli właściciela lub administratora; pozostałe konta wymagają innego recenzenta. Wygenerowanego szkicu deklaracji nie zatwierdza się jako podpisanego dokumentu. Zakres klucza: documents:review. Uprawnienie w organizacji: documents.view. Ta operacja wymaga `Idempotency-Key`. Ponowienie: ta sama metoda, ścieżka, klucz i dane. Nową operację oznacz nowym kluczem; nie obchodź konfliktu przez losowanie klucza bez sprawdzenia poprzedniego wyniku. #### GET /organizations/{organizationId}/document-versions/{recordId}/download Dokumenty — Pobierz Dokument to metadane powiązane z opakowaniem; plik i jego przegląd należą do konkretnej wersji. Upload, skanowanie, analiza AI i akceptacja danych są oddzielnymi krokami. Pobierz plik jako odpowiedź binarną, nie JSON. Błąd zwracany jest nadal w formacie JSON; najpierw sprawdź status HTTP i Content-Type. Zakres klucza: documents:read. Uprawnienie w organizacji: documents.view. #### POST /organizations/{organizationId}/document-versions/{recordId}/evidence-proposals Dokumenty — Zaproponuj dane Dokument to metadane powiązane z opakowaniem; plik i jego przegląd należą do konkretnej wersji. Upload, skanowanie, analiza AI i akceptacja danych są oddzielnymi krokami. Dodaj propozycję wartości z lokalizacją i cytatem z dokumentu. Musi istnieć opakowanie powiązane z dokumentem. Akceptację wykonuje osobna metoda evidence decision. source_page musi istnieć w odczytanym tekście wersji, a source_text być dokładnym cytatem. Dla MASS_G użyj g, WIDTH_MM/LENGTH_MM/HEIGHT_MM — mm. DfR wymaga %, exact, metody i wyniku w cytacie; pomiary chemiczne dodatkowo raportu laboratoryjnego i UUID części. Brakujący odczyt strony uzupełnia się w panelu; API nie wystawia transkrypcji stron. Zakres klucza: evidence:review. Uprawnienie w organizacji: evidence.review. Ta operacja wymaga `Idempotency-Key`. Ponowienie: ta sama metoda, ścieżka, klucz i dane. Nową operację oznacz nowym kluczem; nie obchodź konfliktu przez losowanie klucza bez sprawdzenia poprzedniego wyniku. #### POST /organizations/{organizationId}/documents Dokumenty — Prześlij plik Dokument to metadane powiązane z opakowaniem; plik i jego przegląd należą do konkretnej wersji. Upload, skanowanie, analiza AI i akceptacja danych są oddzielnymi krokami. Prześlij plik i metadane. Odpowiedź jest wersją dokumentu: jej id służy do pobrania/analizy/decyzji, a document wskazuje rekord dokumentu. Przetwarzanie odbywa się w kolejce; poczekaj na jego status. Zakres klucza: documents:upload. Uprawnienie w organizacji: documents.upload. Prześlij rzeczywisty plik w multipart/form-data. Nie wysyłaj ścieżki lokalnej ani ciągu base64 w JSON. Odczytaj UUID i status przetwarzania z odpowiedzi/zasobu. Ta operacja wymaga `Idempotency-Key`. Ponowienie: ta sama metoda, ścieżka, klucz i dane. Nową operację oznacz nowym kluczem; nie obchodź konfliktu przez losowanie klucza bez sprawdzenia poprzedniego wyniku. #### GET /organizations/{organizationId}/documents Dokumenty — Lista Dokument to metadane powiązane z opakowaniem; plik i jego przegląd należą do konkretnej wersji. Upload, skanowanie, analiza AI i akceptacja danych są oddzielnymi krokami. Pobierz listę rekordów dostępnych dla organizacji klucza. Zakres klucza: documents:read. Uprawnienie w organizacji: documents.view. Lista używa `per_page` (1–100, domyślnie 50) i kursora. Następne żądanie wykonaj pod adresem `links.next`; null kończy listę. Stosuj tylko filtry wymienione w parametrach tej metody. #### GET /organizations/{organizationId}/documents/{documentId}/versions Wersje dokumentów — Lista Wersja dokumentu identyfikuje konkretny plik oraz processing_status, review_status, terminy i rewizję. Zatwierdzenie nie zastępuje zakończenia bezpiecznego przetwarzania pliku. Pobierz listę rekordów dostępnych dla organizacji klucza. Zakres klucza: documents:read. Uprawnienie w organizacji: documents.view. Lista używa `per_page` (1–100, domyślnie 50) i kursora. Następne żądanie wykonaj pod adresem `links.next`; null kończy listę. Stosuj tylko filtry wymienione w parametrach tej metody. #### GET /organizations/{organizationId}/documents/{recordId} Dokumenty — Szczegóły Dokument to metadane powiązane z opakowaniem; plik i jego przegląd należą do konkretnej wersji. Upload, skanowanie, analiza AI i akceptacja danych są oddzielnymi krokami. Pobierz szczegóły istniejącego rekordu. UUID weź z listy lub odpowiedzi tworzenia tego samego rodzaju zasobu. Zakres klucza: documents:read. Uprawnienie w organizacji: documents.view. #### POST /organizations/{organizationId}/documents/{recordId}/versions Dokumenty — Dodaj wersję Dokument to metadane powiązane z opakowaniem; plik i jego przegląd należą do konkretnej wersji. Upload, skanowanie, analiza AI i akceptacja danych są oddzielnymi krokami. Dodaj kolejny plik do istniejącego dokumentu wskazanego recordId. Powstaje nowa wersja z odrębnym przetwarzaniem i przeglądem; poprzednie historie nie są nadpisywane. Zakres klucza: documents:upload. Uprawnienie w organizacji: documents.upload. Prześlij rzeczywisty plik w multipart/form-data. Nie wysyłaj ścieżki lokalnej ani ciągu base64 w JSON. Odczytaj UUID i status przetwarzania z odpowiedzi/zasobu. Ta operacja wymaga `Idempotency-Key`. Ponowienie: ta sama metoda, ścieżka, klucz i dane. Nową operację oznacz nowym kluczem; nie obchodź konfliktu przez losowanie klucza bez sprawdzenia poprzedniego wyniku. #### GET /organizations/{organizationId}/evidence-proposals Propozycje danych — Lista Propozycje faktów odczytanych z dokumentu mają źródło, wartość i status. Lista może być ograniczona poufnością dokumentów. Sama propozycja nie jest zatwierdzonym dowodem. Pobierz listę rekordów dostępnych dla organizacji klucza. Zakres klucza: evidence:review. Uprawnienie w organizacji: evidence.review. Lista używa `per_page` (1–100, domyślnie 50) i kursora. Następne żądanie wykonaj pod adresem `links.next`; null kończy listę. Stosuj tylko filtry wymienione w parametrach tej metody. #### POST /organizations/{organizationId}/evidence-proposals/{proposalId}/decision Weryfikacja danych — Decyzja Decyzja nad propozycją faktu jest oddzielna od zatwierdzenia całego pliku. Służy akceptacji wartości, akceptacji po korekcie albo odrzuceniu z uzasadnieniem. Użyj accepted, acceptedModified lub rejected. Przy acceptedModified wymagane acceptedValue. Wymaga revision propozycji i note. Ta metoda nie korzysta z Idempotency-Key; po timeoutcie odczytaj propozycję przed kolejną decyzją. Zakres klucza: evidence:review. Uprawnienie w organizacji: evidence.review. Przykład pokazuje strukturę. Zastąp UUID, rewizje, daty i configuration_hash rzeczywistymi wartościami; kody jednostek i materiałów muszą odpowiadać konfiguracji opakowania. ```json { "decision": "accepted", "revision": 1, "note": "Checked against the cited document page." } ``` #### GET /organizations/{organizationId}/evidence-proposals/{recordId} Propozycje danych — Szczegóły Propozycje faktów odczytanych z dokumentu mają źródło, wartość i status. Lista może być ograniczona poufnością dokumentów. Sama propozycja nie jest zatwierdzonym dowodem. Pobierz szczegóły istniejącego rekordu. UUID weź z listy lub odpowiedzi tworzenia tego samego rodzaju zasobu. Zakres klucza: evidence:review. Uprawnienie w organizacji: evidence.review. ### Współpraca z dostawcami i braki Utwórz prośbę → sprawdź pozycje → wyślij e-mail → odbierz pliki → oceń odpowiedzi. Dostawca korzysta z publicznego linku, integrator z klucza organizacji. #### GET /organizations/{organizationId}/issues Braki danych — Lista Braki i zadania wykryte w organizacji. API udostępnia ich listę i szczegóły; nie wystawia tworzenia ani zamykania zadań przez analogiczne POST/PATCH. Pobierz listę rekordów dostępnych dla organizacji klucza. Zakres klucza: supplier-requests:read. Uprawnienie w organizacji: issues.manage. Lista używa `per_page` (1–100, domyślnie 50) i kursora. Następne żądanie wykonaj pod adresem `links.next`; null kończy listę. Stosuj tylko filtry wymienione w parametrach tej metody. #### GET /organizations/{organizationId}/issues/{recordId} Braki danych — Szczegóły Braki i zadania wykryte w organizacji. API udostępnia ich listę i szczegóły; nie wystawia tworzenia ani zamykania zadań przez analogiczne POST/PATCH. Pobierz szczegóły istniejącego rekordu. UUID weź z listy lub odpowiedzi tworzenia tego samego rodzaju zasobu. Zakres klucza: supplier-requests:read. Uprawnienie w organizacji: issues.manage. #### GET /organizations/{organizationId}/supplier-requests Prośby do dostawców — Lista Prośba do dostawcy zbiera dokumenty dla wskazanych pozycji. Utworzenie prośby nie wysyła wiadomości; wysyłkę wykonuje osobna metoda. Dostawca może odpowiedzieć przez publiczny link bez konta. Pobierz listę rekordów dostępnych dla organizacji klucza. Zakres klucza: supplier-requests:read. Uprawnienie w organizacji: supplier_requests.view. Lista używa `per_page` (1–100, domyślnie 50) i kursora. Następne żądanie wykonaj pod adresem `links.next`; null kończy listę. Stosuj tylko filtry wymienione w parametrach tej metody. #### POST /organizations/{organizationId}/supplier-requests Prośby do dostawców — Dodaj Prośba do dostawcy zbiera dokumenty dla wskazanych pozycji. Utworzenie prośby nie wysyła wiadomości; wysyłkę wykonuje osobna metoda. Dostawca może odpowiedzieć przez publiczny link bez konta. Utwórz rekord z danych opisanych w requestBody. Odpowiedź zawiera publiczne id do dalszego odczytu i powiązań. Zakres klucza: supplier-requests:write. Uprawnienie w organizacji: supplier_requests.create. Ta operacja wymaga `Idempotency-Key`. Ponowienie: ta sama metoda, ścieżka, klucz i dane. Nową operację oznacz nowym kluczem; nie obchodź konfliktu przez losowanie klucza bez sprawdzenia poprzedniego wyniku. #### GET /organizations/{organizationId}/supplier-requests/{recordId} Prośby do dostawców — Szczegóły Prośba do dostawcy zbiera dokumenty dla wskazanych pozycji. Utworzenie prośby nie wysyła wiadomości; wysyłkę wykonuje osobna metoda. Dostawca może odpowiedzieć przez publiczny link bez konta. Pobierz szczegóły istniejącego rekordu. UUID weź z listy lub odpowiedzi tworzenia tego samego rodzaju zasobu. Zakres klucza: supplier-requests:read. Uprawnienie w organizacji: supplier_requests.view. #### POST /organizations/{organizationId}/supplier-requests/{recordId}/cancel Prośby do dostawców — Anuluj Prośba do dostawcy zbiera dokumenty dla wskazanych pozycji. Utworzenie prośby nie wysyła wiadomości; wysyłkę wykonuje osobna metoda. Dostawca może odpowiedzieć przez publiczny link bez konta. Anuluj prośbę z aktualną revision. Nie usuwa już przesłanych plików ani historii odpowiedzi. Zakres klucza: supplier-requests:write. Uprawnienie w organizacji: supplier_requests.send. Ta operacja wymaga `Idempotency-Key`. Ponowienie: ta sama metoda, ścieżka, klucz i dane. Nową operację oznacz nowym kluczem; nie obchodź konfliktu przez losowanie klucza bez sprawdzenia poprzedniego wyniku. #### POST /organizations/{organizationId}/supplier-requests/{recordId}/lines/{lineId}/review Prośby do dostawców — Przegląd pozycji Prośba do dostawcy zbiera dokumenty dla wskazanych pozycji. Utworzenie prośby nie wysyła wiadomości; wysyłkę wykonuje osobna metoda. Dostawca może odpowiedzieć przez publiczny link bez konta. Oceń odpowiedź dla lineId należącej do tej prośby. revision odnosi się do prośby; decyzja pozycji nie zastępuje przeglądu wersji dokumentu. Przy accepted wymagane są zatwierdzone dokumenty i zaakceptowane dowody powiązane z opakowaniem; samo przesłanie pliku nie wystarcza. Zakres klucza: supplier-requests:write. Uprawnienie w organizacji: evidence.review. Ta operacja wymaga `Idempotency-Key`. Ponowienie: ta sama metoda, ścieżka, klucz i dane. Nową operację oznacz nowym kluczem; nie obchodź konfliktu przez losowanie klucza bez sprawdzenia poprzedniego wyniku. #### POST /organizations/{organizationId}/supplier-requests/{recordId}/send Prośby do dostawców — Wyślij Prośba do dostawcy zbiera dokumenty dla wskazanych pozycji. Utworzenie prośby nie wysyła wiadomości; wysyłkę wykonuje osobna metoda. Dostawca może odpowiedzieć przez publiczny link bez konta. Wyślij e-mail z prośbą na podany adres, z kontrolą revision prośby. To akcja zewnętrzna: przygotuj treść i adres przed wywołaniem; powtórzenia obsługuj tym samym kluczem idempotencji. Zakres klucza: supplier-requests:write. Uprawnienie w organizacji: supplier_requests.send. Ta operacja wymaga `Idempotency-Key`. Ponowienie: ta sama metoda, ścieżka, klucz i dane. Nową operację oznacz nowym kluczem; nie obchodź konfliktu przez losowanie klucza bez sprawdzenia poprzedniego wyniku. #### GET /organizations/{organizationId}/supplier-requests/{requestId}/lines Pozycje próśb — Lista Pozycje określają, jakiego dokumentu brakuje dla opakowania. Ich decyzje i odpowiedzi są częścią konkretnej prośby, identyfikowanej przez requestId. Pobierz listę rekordów dostępnych dla organizacji klucza. Zakres klucza: supplier-requests:read. Uprawnienie w organizacji: supplier_requests.view. Lista używa `per_page` (1–100, domyślnie 50) i kursora. Następne żądanie wykonaj pod adresem `links.next`; null kończy listę. Stosuj tylko filtry wymienione w parametrach tej metody. ### Importy i arkusze 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. #### GET /organizations/{organizationId}/import-templates/codes.csv Arkusz mapowań kodów — Pobierz Arkusz CSV mapowań indeksów opakowania, dostawcy i producenta. populated=1 zwraca obecne dane; wynik prześlij jako import code_mappings. Pobierz plik jako odpowiedź binarną, nie JSON. Błąd zwracany jest nadal w formacie JSON; najpierw sprawdź status HTTP i Content-Type. Zakres klucza: imports:run. Uprawnienie w organizacji: imports.run. #### GET /organizations/{organizationId}/import-templates/documents.csv Arkusz danych dokumentów — Pobierz Arkusz CSV do aktualizacji metadanych istniejących dokumentów. populated=1 wypełnia go danymi organizacji. Nie służy do przesyłania plików PDF. Pobierz plik jako odpowiedź binarną, nie JSON. Błąd zwracany jest nadal w formacie JSON; najpierw sprawdź status HTTP i Content-Type. Zakres klucza: imports:run. Uprawnienie w organizacji: imports.run. #### GET /organizations/{organizationId}/imports Importy — Lista Import jest osobną pracą z etapem podglądu przed zastosowaniem. Obsługiwane typy: catalog, partners, document_metadata, code_mappings. Metadane dokumentów nie są uploadem ich plików. Pobierz listę rekordów dostępnych dla organizacji klucza. Zakres klucza: imports:run. Uprawnienie w organizacji: imports.run. Lista używa `per_page` (1–100, domyślnie 50) i kursora. Następne żądanie wykonaj pod adresem `links.next`; null kończy listę. Stosuj tylko filtry wymienione w parametrach tej metody. #### POST /organizations/{organizationId}/imports Importy — Dodaj Import jest osobną pracą z etapem podglądu przed zastosowaniem. Obsługiwane typy: catalog, partners, document_metadata, code_mappings. Metadane dokumentów nie są uploadem ich plików. Prześlij CSV/XLSX z type i opcjonalnym mapowaniem kolumn. Odpowiedź 202 zwraca id importu; poczekaj na gotowy podgląd, sprawdź wiersze, dopiero potem wywołaj apply. Zakres klucza: imports:run. Uprawnienie w organizacji: imports.run. Prześlij rzeczywisty plik w multipart/form-data. Nie wysyłaj ścieżki lokalnej ani ciągu base64 w JSON. Odczytaj UUID i status przetwarzania z odpowiedzi/zasobu. Ta operacja wymaga `Idempotency-Key`. Ponowienie: ta sama metoda, ścieżka, klucz i dane. Nową operację oznacz nowym kluczem; nie obchodź konfliktu przez losowanie klucza bez sprawdzenia poprzedniego wyniku. Odpowiedź 202 potwierdza przyjęcie do kolejki. Pobieraj zasób GET według otrzymanego `id`, aż zakończy pracę; nie traktuj statusu `queued` jako gotowego pliku. #### GET /organizations/{organizationId}/imports/{importId}/rows Wiersze importu — Lista Wiersze importu pokazują dane wejściowe, walidację i planowane/wykonane zmiany. Pobierz je po przygotowaniu podglądu i sprawdź błędy przed apply. Pobierz listę rekordów dostępnych dla organizacji klucza. Zakres klucza: imports:run. Uprawnienie w organizacji: imports.run. Lista używa `per_page` (1–100, domyślnie 50) i kursora. Następne żądanie wykonaj pod adresem `links.next`; null kończy listę. Stosuj tylko filtry wymienione w parametrach tej metody. #### GET /organizations/{organizationId}/imports/{recordId} Importy — Szczegóły Import jest osobną pracą z etapem podglądu przed zastosowaniem. Obsługiwane typy: catalog, partners, document_metadata, code_mappings. Metadane dokumentów nie są uploadem ich plików. Pobierz szczegóły istniejącego rekordu. UUID weź z listy lub odpowiedzi tworzenia tego samego rodzaju zasobu. Zakres klucza: imports:run. Uprawnienie w organizacji: imports.run. #### POST /organizations/{organizationId}/imports/{recordId}/apply Importy — Zastosuj Import jest osobną pracą z etapem podglądu przed zastosowaniem. Obsługiwane typy: catalog, partners, document_metadata, code_mappings. Metadane dokumentów nie są uploadem ich plików. Zleć zastosowanie przygotowanego importu. Kontroluj wyniki wierszy i status completed/completed_with_errors; ponowienie nie oznacza ponownego bezwarunkowego nadpisania danych. Zakres klucza: imports:run. Uprawnienie w organizacji: imports.run. Ta operacja wymaga `Idempotency-Key`. Ponowienie: ta sama metoda, ścieżka, klucz i dane. Nową operację oznacz nowym kluczem; nie obchodź konfliktu przez losowanie klucza bez sprawdzenia poprzedniego wyniku. Odpowiedź 202 potwierdza przyjęcie do kolejki. Pobieraj zasób GET według otrzymanego `id`, aż zakończy pracę; nie traktuj statusu `queued` jako gotowego pliku. #### GET /organizations/{organizationId}/imports/{recordId}/result.csv Importy — Pobierz Import jest osobną pracą z etapem podglądu przed zastosowaniem. Obsługiwane typy: catalog, partners, document_metadata, code_mappings. Metadane dokumentów nie są uploadem ich plików. Pobierz plik jako odpowiedź binarną, nie JSON. Błąd zwracany jest nadal w formacie JSON; najpierw sprawdź status HTTP i Content-Type. Zakres klucza: imports:run. Uprawnienie w organizacji: imports.run. ### Oceny i dokumentacja techniczna PPWR 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. #### GET /organizations/{organizationId}/assessments Oceny — Lista Ocena łączy opakowanie, scenariusz rynku, datę i zestaw reguł. Jest innym zasobem niż szczegółowa karta techniczna PPWR. Status przeglądu i aktualność wyniku są rozłączne. Pobierz listę rekordów dostępnych dla organizacji klucza. Zakres klucza: assessments:read. Uprawnienie w organizacji: assessments.view. Lista używa `per_page` (1–100, domyślnie 50) i kursora. Następne żądanie wykonaj pod adresem `links.next`; null kończy listę. Stosuj tylko filtry wymienione w parametrach tej metody. #### POST /organizations/{organizationId}/assessments Oceny — Dodaj Ocena łączy opakowanie, scenariusz rynku, datę i zestaw reguł. Jest innym zasobem niż szczegółowa karta techniczna PPWR. Status przeglądu i aktualność wyniku są rozłączne. Utwórz rekord z danych opisanych w requestBody. Odpowiedź zawiera publiczne id do dalszego odczytu i powiązań. Zakres klucza: assessments:run. Uprawnienie w organizacji: assessments.run. Ta operacja wymaga `Idempotency-Key`. Ponowienie: ta sama metoda, ścieżka, klucz i dane. Nową operację oznacz nowym kluczem; nie obchodź konfliktu przez losowanie klucza bez sprawdzenia poprzedniego wyniku. #### GET /organizations/{organizationId}/assessments/{recordId} Oceny — Szczegóły Ocena łączy opakowanie, scenariusz rynku, datę i zestaw reguł. Jest innym zasobem niż szczegółowa karta techniczna PPWR. Status przeglądu i aktualność wyniku są rozłączne. Pobierz szczegóły istniejącego rekordu. UUID weź z listy lub odpowiedzi tworzenia tego samego rodzaju zasobu. Zakres klucza: assessments:read. Uprawnienie w organizacji: assessments.view. #### POST /organizations/{organizationId}/assessments/{recordId}/review Oceny — Przegląd Ocena łączy opakowanie, scenariusz rynku, datę i zestaw reguł. Jest innym zasobem niż szczegółowa karta techniczna PPWR. Status przeglądu i aktualność wyniku są rozłączne. Zapisz decyzję przeglądu i uzasadnienie. Pobierz później szczegóły, aby sprawdzić status. Decyzja jest zapisem wewnętrznym tego rejestru. Zakres klucza: assessments:review. Uprawnienie w organizacji: assessments.publish. Ta operacja wymaga `Idempotency-Key`. Ponowienie: ta sama metoda, ścieżka, klucz i dane. Nową operację oznacz nowym kluczem; nie obchodź konfliktu przez losowanie klucza bez sprawdzenia poprzedniego wyniku. #### GET /organizations/{organizationId}/catalog-items/{catalogItemId}/ppwr-summary Podsumowanie PPWR Bieżące podsumowanie techniczne opakowania na podaną datę zawiera screening i recyklowalność. Nie tworzy ani nie publikuje oceny; uwzględnia dostępność wymaganej metodyki i źródeł. Parametr date wybiera datę podsumowania; domyślnie dzień bieżący. Interpretuj cały obiekt statusu recyklowalności, nie samą literę klasy. Zakres klucza: ppwr:read. Uprawnienie w organizacji: catalog.view. #### GET /organizations/{organizationId}/catalog-items/{catalogItemId}/ppwr/biobased Materiały biopochodne — Lista Informacje i dowody dotyczące biopochodnego pochodzenia materiału. Nie są automatycznie dowodem kompostowalności lub recyklowalności. Pobierz listę rekordów dostępnych dla organizacji klucza. Zakres klucza: ppwr:read. Uprawnienie w organizacji: catalog.view. Lista używa `per_page` (1–100, domyślnie 50) i kursora. Następne żądanie wykonaj pod adresem `links.next`; null kończy listę. Stosuj tylko filtry wymienione w parametrach tej metody. #### POST /organizations/{organizationId}/catalog-items/{catalogItemId}/ppwr/biobased Materiały biopochodne — Dodaj Informacje i dowody dotyczące biopochodnego pochodzenia materiału. Nie są automatycznie dowodem kompostowalności lub recyklowalności. Utwórz rekord z danych opisanych w requestBody. Odpowiedź zawiera publiczne id do dalszego odczytu i powiązań. Dla rejestru technicznego: przygotuj opakowanie lub rekord nadrzędny, wymagane wersje dokumentów i datę oceny; utwórz wpis, pobierz jego UUID, a następnie użyj /review, jeżeli ta metoda istnieje. Źródła muszą spełniać warunki danego rejestru. Decyzja może wymagać innego recenzenta; 403/422 nie oznacza, że klucz technicznie nie działa. Zapis ani zatwierdzenie nie zastępują opublikowanej metodyki oceny. Zakres klucza: ppwr:write. Uprawnienie w organizacji: catalog.update. Ta operacja wymaga `Idempotency-Key`. Ponowienie: ta sama metoda, ścieżka, klucz i dane. Nową operację oznacz nowym kluczem; nie obchodź konfliktu przez losowanie klucza bez sprawdzenia poprzedniego wyniku. #### GET /organizations/{organizationId}/catalog-items/{catalogItemId}/ppwr/biobased/{recordId} Materiały biopochodne — Szczegóły Informacje i dowody dotyczące biopochodnego pochodzenia materiału. Nie są automatycznie dowodem kompostowalności lub recyklowalności. Pobierz szczegóły istniejącego rekordu. UUID weź z listy lub odpowiedzi tworzenia tego samego rodzaju zasobu. Zakres klucza: ppwr:read. Uprawnienie w organizacji: catalog.view. #### POST /organizations/{organizationId}/catalog-items/{catalogItemId}/ppwr/biobased/{recordId}/review Materiały biopochodne — Przegląd Informacje i dowody dotyczące biopochodnego pochodzenia materiału. Nie są automatycznie dowodem kompostowalności lub recyklowalności. Zapisz decyzję przeglądu i uzasadnienie. Pobierz później szczegóły, aby sprawdzić status. Decyzja jest zapisem wewnętrznym tego rejestru. Dla rejestru technicznego: przygotuj opakowanie lub rekord nadrzędny, wymagane wersje dokumentów i datę oceny; utwórz wpis, pobierz jego UUID, a następnie użyj /review, jeżeli ta metoda istnieje. Źródła muszą spełniać warunki danego rejestru. Decyzja może wymagać innego recenzenta; 403/422 nie oznacza, że klucz technicznie nie działa. Zapis ani zatwierdzenie nie zastępują opublikowanej metodyki oceny. Zakres klucza: ppwr:review. Uprawnienie w organizacji: evidence.review. Ta operacja wymaga `Idempotency-Key`. Ponowienie: ta sama metoda, ścieżka, klucz i dane. Nową operację oznacz nowym kluczem; nie obchodź konfliktu przez losowanie klucza bez sprawdzenia poprzedniego wyniku. #### GET /organizations/{organizationId}/catalog-items/{catalogItemId}/ppwr/chemical-safety Bezpieczeństwo chemiczne — Lista Karta bezpieczeństwa chemicznego: części, wyniki badań, metody analityczne, wyjątki i dowody. Wprowadzone liczby muszą mieć właściwe źródła; zapis karty nie publikuje reguły zgodności. Pobierz listę rekordów dostępnych dla organizacji klucza. Zakres klucza: ppwr:read. Uprawnienie w organizacji: catalog.view. Lista używa `per_page` (1–100, domyślnie 50) i kursora. Następne żądanie wykonaj pod adresem `links.next`; null kończy listę. Stosuj tylko filtry wymienione w parametrach tej metody. #### POST /organizations/{organizationId}/catalog-items/{catalogItemId}/ppwr/chemical-safety Bezpieczeństwo chemiczne — Dodaj Karta bezpieczeństwa chemicznego: części, wyniki badań, metody analityczne, wyjątki i dowody. Wprowadzone liczby muszą mieć właściwe źródła; zapis karty nie publikuje reguły zgodności. Utwórz rekord z danych opisanych w requestBody. Odpowiedź zawiera publiczne id do dalszego odczytu i powiązań. Dla rejestru technicznego: przygotuj opakowanie lub rekord nadrzędny, wymagane wersje dokumentów i datę oceny; utwórz wpis, pobierz jego UUID, a następnie użyj /review, jeżeli ta metoda istnieje. Źródła muszą spełniać warunki danego rejestru. Decyzja może wymagać innego recenzenta; 403/422 nie oznacza, że klucz technicznie nie działa. Zapis ani zatwierdzenie nie zastępują opublikowanej metodyki oceny. Zakres klucza: ppwr:write. Uprawnienie w organizacji: catalog.update. Ta operacja wymaga `Idempotency-Key`. Ponowienie: ta sama metoda, ścieżka, klucz i dane. Nową operację oznacz nowym kluczem; nie obchodź konfliktu przez losowanie klucza bez sprawdzenia poprzedniego wyniku. #### GET /organizations/{organizationId}/catalog-items/{catalogItemId}/ppwr/chemical-safety/{recordId} Bezpieczeństwo chemiczne — Szczegóły Karta bezpieczeństwa chemicznego: części, wyniki badań, metody analityczne, wyjątki i dowody. Wprowadzone liczby muszą mieć właściwe źródła; zapis karty nie publikuje reguły zgodności. Pobierz szczegóły istniejącego rekordu. UUID weź z listy lub odpowiedzi tworzenia tego samego rodzaju zasobu. Zakres klucza: ppwr:read. Uprawnienie w organizacji: catalog.view. #### POST /organizations/{organizationId}/catalog-items/{catalogItemId}/ppwr/chemical-safety/{recordId}/review Bezpieczeństwo chemiczne — Przegląd Karta bezpieczeństwa chemicznego: części, wyniki badań, metody analityczne, wyjątki i dowody. Wprowadzone liczby muszą mieć właściwe źródła; zapis karty nie publikuje reguły zgodności. Zapisz decyzję przeglądu i uzasadnienie. Pobierz później szczegóły, aby sprawdzić status. Decyzja jest zapisem wewnętrznym tego rejestru. Dla rejestru technicznego: przygotuj opakowanie lub rekord nadrzędny, wymagane wersje dokumentów i datę oceny; utwórz wpis, pobierz jego UUID, a następnie użyj /review, jeżeli ta metoda istnieje. Źródła muszą spełniać warunki danego rejestru. Decyzja może wymagać innego recenzenta; 403/422 nie oznacza, że klucz technicznie nie działa. Zapis ani zatwierdzenie nie zastępują opublikowanej metodyki oceny. Zakres klucza: ppwr:review. Uprawnienie w organizacji: evidence.review. Ta operacja wymaga `Idempotency-Key`. Ponowienie: ta sama metoda, ścieżka, klucz i dane. Nową operację oznacz nowym kluczem; nie obchodź konfliktu przez losowanie klucza bez sprawdzenia poprzedniego wyniku. #### GET /organizations/{organizationId}/catalog-items/{catalogItemId}/ppwr/communications Etykiety i komunikaty — Lista Rejestr treści etykiet i oświadczeń z językiem, zakresem oraz źródłami. Schemat zależy od kind i subject_code. To zapis oceny komunikatu, nie drukowanie gotowych etykiet. Pobierz listę rekordów dostępnych dla organizacji klucza. Zakres klucza: ppwr:read. Uprawnienie w organizacji: catalog.view. Lista używa `per_page` (1–100, domyślnie 50) i kursora. Następne żądanie wykonaj pod adresem `links.next`; null kończy listę. Stosuj tylko filtry wymienione w parametrach tej metody. #### POST /organizations/{organizationId}/catalog-items/{catalogItemId}/ppwr/communications Etykiety i komunikaty — Dodaj Rejestr treści etykiet i oświadczeń z językiem, zakresem oraz źródłami. Schemat zależy od kind i subject_code. To zapis oceny komunikatu, nie drukowanie gotowych etykiet. Utwórz rekord z danych opisanych w requestBody. Odpowiedź zawiera publiczne id do dalszego odczytu i powiązań. Dla rejestru technicznego: przygotuj opakowanie lub rekord nadrzędny, wymagane wersje dokumentów i datę oceny; utwórz wpis, pobierz jego UUID, a następnie użyj /review, jeżeli ta metoda istnieje. Źródła muszą spełniać warunki danego rejestru. Decyzja może wymagać innego recenzenta; 403/422 nie oznacza, że klucz technicznie nie działa. Zapis ani zatwierdzenie nie zastępują opublikowanej metodyki oceny. Zakres klucza: ppwr:write. Uprawnienie w organizacji: catalog.update. Ta operacja wymaga `Idempotency-Key`. Ponowienie: ta sama metoda, ścieżka, klucz i dane. Nową operację oznacz nowym kluczem; nie obchodź konfliktu przez losowanie klucza bez sprawdzenia poprzedniego wyniku. #### GET /organizations/{organizationId}/catalog-items/{catalogItemId}/ppwr/communications/{recordId} Etykiety i komunikaty — Szczegóły Rejestr treści etykiet i oświadczeń z językiem, zakresem oraz źródłami. Schemat zależy od kind i subject_code. To zapis oceny komunikatu, nie drukowanie gotowych etykiet. Pobierz szczegóły istniejącego rekordu. UUID weź z listy lub odpowiedzi tworzenia tego samego rodzaju zasobu. Zakres klucza: ppwr:read. Uprawnienie w organizacji: catalog.view. #### POST /organizations/{organizationId}/catalog-items/{catalogItemId}/ppwr/communications/{recordId}/review Etykiety i komunikaty — Przegląd Rejestr treści etykiet i oświadczeń z językiem, zakresem oraz źródłami. Schemat zależy od kind i subject_code. To zapis oceny komunikatu, nie drukowanie gotowych etykiet. Zapisz decyzję przeglądu i uzasadnienie. Pobierz później szczegóły, aby sprawdzić status. Decyzja jest zapisem wewnętrznym tego rejestru. Dla rejestru technicznego: przygotuj opakowanie lub rekord nadrzędny, wymagane wersje dokumentów i datę oceny; utwórz wpis, pobierz jego UUID, a następnie użyj /review, jeżeli ta metoda istnieje. Źródła muszą spełniać warunki danego rejestru. Decyzja może wymagać innego recenzenta; 403/422 nie oznacza, że klucz technicznie nie działa. Zapis ani zatwierdzenie nie zastępują opublikowanej metodyki oceny. Zakres klucza: ppwr:review. Uprawnienie w organizacji: evidence.review. Ta operacja wymaga `Idempotency-Key`. Ponowienie: ta sama metoda, ścieżka, klucz i dane. Nową operację oznacz nowym kluczem; nie obchodź konfliktu przez losowanie klucza bez sprawdzenia poprzedniego wyniku. #### GET /organizations/{organizationId}/catalog-items/{catalogItemId}/ppwr/compostability Kompostowalność — Lista Karta kompostowalności z zakresem zastosowania, badaniami i dowodami. Sama nazwa materiału nie potwierdza spełnienia wymagań. Pobierz listę rekordów dostępnych dla organizacji klucza. Zakres klucza: ppwr:read. Uprawnienie w organizacji: catalog.view. Lista używa `per_page` (1–100, domyślnie 50) i kursora. Następne żądanie wykonaj pod adresem `links.next`; null kończy listę. Stosuj tylko filtry wymienione w parametrach tej metody. #### POST /organizations/{organizationId}/catalog-items/{catalogItemId}/ppwr/compostability Kompostowalność — Dodaj Karta kompostowalności z zakresem zastosowania, badaniami i dowodami. Sama nazwa materiału nie potwierdza spełnienia wymagań. Utwórz rekord z danych opisanych w requestBody. Odpowiedź zawiera publiczne id do dalszego odczytu i powiązań. Dla rejestru technicznego: przygotuj opakowanie lub rekord nadrzędny, wymagane wersje dokumentów i datę oceny; utwórz wpis, pobierz jego UUID, a następnie użyj /review, jeżeli ta metoda istnieje. Źródła muszą spełniać warunki danego rejestru. Decyzja może wymagać innego recenzenta; 403/422 nie oznacza, że klucz technicznie nie działa. Zapis ani zatwierdzenie nie zastępują opublikowanej metodyki oceny. Zakres klucza: ppwr:write. Uprawnienie w organizacji: catalog.update. Ta operacja wymaga `Idempotency-Key`. Ponowienie: ta sama metoda, ścieżka, klucz i dane. Nową operację oznacz nowym kluczem; nie obchodź konfliktu przez losowanie klucza bez sprawdzenia poprzedniego wyniku. #### GET /organizations/{organizationId}/catalog-items/{catalogItemId}/ppwr/compostability/{recordId} Kompostowalność — Szczegóły Karta kompostowalności z zakresem zastosowania, badaniami i dowodami. Sama nazwa materiału nie potwierdza spełnienia wymagań. Pobierz szczegóły istniejącego rekordu. UUID weź z listy lub odpowiedzi tworzenia tego samego rodzaju zasobu. Zakres klucza: ppwr:read. Uprawnienie w organizacji: catalog.view. #### POST /organizations/{organizationId}/catalog-items/{catalogItemId}/ppwr/compostability/{recordId}/review Kompostowalność — Przegląd Karta kompostowalności z zakresem zastosowania, badaniami i dowodami. Sama nazwa materiału nie potwierdza spełnienia wymagań. Zapisz decyzję przeglądu i uzasadnienie. Pobierz później szczegóły, aby sprawdzić status. Decyzja jest zapisem wewnętrznym tego rejestru. Dla rejestru technicznego: przygotuj opakowanie lub rekord nadrzędny, wymagane wersje dokumentów i datę oceny; utwórz wpis, pobierz jego UUID, a następnie użyj /review, jeżeli ta metoda istnieje. Źródła muszą spełniać warunki danego rejestru. Decyzja może wymagać innego recenzenta; 403/422 nie oznacza, że klucz technicznie nie działa. Zapis ani zatwierdzenie nie zastępują opublikowanej metodyki oceny. Zakres klucza: ppwr:review. Uprawnienie w organizacji: evidence.review. Ta operacja wymaga `Idempotency-Key`. Ponowienie: ta sama metoda, ścieżka, klucz i dane. Nową operację oznacz nowym kluczem; nie obchodź konfliktu przez losowanie klucza bez sprawdzenia poprzedniego wyniku. #### GET /organizations/{organizationId}/catalog-items/{catalogItemId}/ppwr/conformity-dossiers Dokumentacja zgodności — Lista Dossier porządkuje dokumentację techniczną opakowania. Jego zatwierdzony zapis może być podstawą deklaracji UE; plik PDF jest generowany osobną operacją. Pobierz listę rekordów dostępnych dla organizacji klucza. Zakres klucza: ppwr:read. Uprawnienie w organizacji: catalog.view. Lista używa `per_page` (1–100, domyślnie 50) i kursora. Następne żądanie wykonaj pod adresem `links.next`; null kończy listę. Stosuj tylko filtry wymienione w parametrach tej metody. #### POST /organizations/{organizationId}/catalog-items/{catalogItemId}/ppwr/conformity-dossiers Dokumentacja zgodności — Dodaj Dossier porządkuje dokumentację techniczną opakowania. Jego zatwierdzony zapis może być podstawą deklaracji UE; plik PDF jest generowany osobną operacją. Utwórz rekord z danych opisanych w requestBody. Odpowiedź zawiera publiczne id do dalszego odczytu i powiązań. Dla rejestru technicznego: przygotuj opakowanie lub rekord nadrzędny, wymagane wersje dokumentów i datę oceny; utwórz wpis, pobierz jego UUID, a następnie użyj /review, jeżeli ta metoda istnieje. Źródła muszą spełniać warunki danego rejestru. Decyzja może wymagać innego recenzenta; 403/422 nie oznacza, że klucz technicznie nie działa. Zapis ani zatwierdzenie nie zastępują opublikowanej metodyki oceny. Zakres klucza: ppwr:write. Uprawnienie w organizacji: catalog.update. Ta operacja wymaga `Idempotency-Key`. Ponowienie: ta sama metoda, ścieżka, klucz i dane. Nową operację oznacz nowym kluczem; nie obchodź konfliktu przez losowanie klucza bez sprawdzenia poprzedniego wyniku. #### GET /organizations/{organizationId}/catalog-items/{catalogItemId}/ppwr/conformity-dossiers/{recordId} Dokumentacja zgodności — Szczegóły Dossier porządkuje dokumentację techniczną opakowania. Jego zatwierdzony zapis może być podstawą deklaracji UE; plik PDF jest generowany osobną operacją. Pobierz szczegóły istniejącego rekordu. UUID weź z listy lub odpowiedzi tworzenia tego samego rodzaju zasobu. Zakres klucza: ppwr:read. Uprawnienie w organizacji: catalog.view. #### POST /organizations/{organizationId}/catalog-items/{catalogItemId}/ppwr/conformity-dossiers/{recordId}/review Dokumentacja zgodności — Przegląd Dossier porządkuje dokumentację techniczną opakowania. Jego zatwierdzony zapis może być podstawą deklaracji UE; plik PDF jest generowany osobną operacją. Zapisz decyzję przeglądu i uzasadnienie. Pobierz później szczegóły, aby sprawdzić status. Decyzja jest zapisem wewnętrznym tego rejestru. Dla rejestru technicznego: przygotuj opakowanie lub rekord nadrzędny, wymagane wersje dokumentów i datę oceny; utwórz wpis, pobierz jego UUID, a następnie użyj /review, jeżeli ta metoda istnieje. Źródła muszą spełniać warunki danego rejestru. Decyzja może wymagać innego recenzenta; 403/422 nie oznacza, że klucz technicznie nie działa. Zapis ani zatwierdzenie nie zastępują opublikowanej metodyki oceny. Zakres klucza: ppwr:review. Uprawnienie w organizacji: evidence.review. Ta operacja wymaga `Idempotency-Key`. Ponowienie: ta sama metoda, ścieżka, klucz i dane. Nową operację oznacz nowym kluczem; nie obchodź konfliktu przez losowanie klucza bez sprawdzenia poprzedniego wyniku. #### GET /organizations/{organizationId}/catalog-items/{catalogItemId}/ppwr/empty-space Pusta przestrzeń — Lista Techniczna ocena pustej przestrzeni dla danych wymiarów, zawartości i metody. Nie jest doborem kartonu ani zapisem faktycznego pakowania zamówienia. Pobierz listę rekordów dostępnych dla organizacji klucza. Zakres klucza: ppwr:read. Uprawnienie w organizacji: catalog.view. Lista używa `per_page` (1–100, domyślnie 50) i kursora. Następne żądanie wykonaj pod adresem `links.next`; null kończy listę. Stosuj tylko filtry wymienione w parametrach tej metody. #### POST /organizations/{organizationId}/catalog-items/{catalogItemId}/ppwr/empty-space Pusta przestrzeń — Dodaj Techniczna ocena pustej przestrzeni dla danych wymiarów, zawartości i metody. Nie jest doborem kartonu ani zapisem faktycznego pakowania zamówienia. Utwórz rekord z danych opisanych w requestBody. Odpowiedź zawiera publiczne id do dalszego odczytu i powiązań. Dla rejestru technicznego: przygotuj opakowanie lub rekord nadrzędny, wymagane wersje dokumentów i datę oceny; utwórz wpis, pobierz jego UUID, a następnie użyj /review, jeżeli ta metoda istnieje. Źródła muszą spełniać warunki danego rejestru. Decyzja może wymagać innego recenzenta; 403/422 nie oznacza, że klucz technicznie nie działa. Zapis ani zatwierdzenie nie zastępują opublikowanej metodyki oceny. Zakres klucza: ppwr:write. Uprawnienie w organizacji: catalog.update. Ta operacja wymaga `Idempotency-Key`. Ponowienie: ta sama metoda, ścieżka, klucz i dane. Nową operację oznacz nowym kluczem; nie obchodź konfliktu przez losowanie klucza bez sprawdzenia poprzedniego wyniku. #### GET /organizations/{organizationId}/catalog-items/{catalogItemId}/ppwr/empty-space/{recordId} Pusta przestrzeń — Szczegóły Techniczna ocena pustej przestrzeni dla danych wymiarów, zawartości i metody. Nie jest doborem kartonu ani zapisem faktycznego pakowania zamówienia. Pobierz szczegóły istniejącego rekordu. UUID weź z listy lub odpowiedzi tworzenia tego samego rodzaju zasobu. Zakres klucza: ppwr:read. Uprawnienie w organizacji: catalog.view. #### POST /organizations/{organizationId}/catalog-items/{catalogItemId}/ppwr/empty-space/{recordId}/review Pusta przestrzeń — Przegląd Techniczna ocena pustej przestrzeni dla danych wymiarów, zawartości i metody. Nie jest doborem kartonu ani zapisem faktycznego pakowania zamówienia. Zapisz decyzję przeglądu i uzasadnienie. Pobierz później szczegóły, aby sprawdzić status. Decyzja jest zapisem wewnętrznym tego rejestru. Dla rejestru technicznego: przygotuj opakowanie lub rekord nadrzędny, wymagane wersje dokumentów i datę oceny; utwórz wpis, pobierz jego UUID, a następnie użyj /review, jeżeli ta metoda istnieje. Źródła muszą spełniać warunki danego rejestru. Decyzja może wymagać innego recenzenta; 403/422 nie oznacza, że klucz technicznie nie działa. Zapis ani zatwierdzenie nie zastępują opublikowanej metodyki oceny. Zakres klucza: ppwr:review. Uprawnienie w organizacji: evidence.review. Ta operacja wymaga `Idempotency-Key`. Ponowienie: ta sama metoda, ścieżka, klucz i dane. Nową operację oznacz nowym kluczem; nie obchodź konfliktu przez losowanie klucza bez sprawdzenia poprzedniego wyniku. #### GET /organizations/{organizationId}/catalog-items/{catalogItemId}/ppwr/eu-declarations Deklaracje zgodności UE — Lista Rejestr deklaracji UE powiązanych z dossier konkretnego opakowania, treścią, podpisem i dowodem. Utworzenie rekordu nie podpisuje dokumentu za producenta. Pobierz listę rekordów dostępnych dla organizacji klucza. Zakres klucza: ppwr:read. Uprawnienie w organizacji: catalog.view. Lista używa `per_page` (1–100, domyślnie 50) i kursora. Następne żądanie wykonaj pod adresem `links.next`; null kończy listę. Stosuj tylko filtry wymienione w parametrach tej metody. #### POST /organizations/{organizationId}/catalog-items/{catalogItemId}/ppwr/eu-declarations Deklaracje zgodności UE — Dodaj Rejestr deklaracji UE powiązanych z dossier konkretnego opakowania, treścią, podpisem i dowodem. Utworzenie rekordu nie podpisuje dokumentu za producenta. Utwórz rekord z danych opisanych w requestBody. Odpowiedź zawiera publiczne id do dalszego odczytu i powiązań. Dla rejestru technicznego: przygotuj opakowanie lub rekord nadrzędny, wymagane wersje dokumentów i datę oceny; utwórz wpis, pobierz jego UUID, a następnie użyj /review, jeżeli ta metoda istnieje. Źródła muszą spełniać warunki danego rejestru. Decyzja może wymagać innego recenzenta; 403/422 nie oznacza, że klucz technicznie nie działa. Zapis ani zatwierdzenie nie zastępują opublikowanej metodyki oceny. Zakres klucza: ppwr:write. Uprawnienie w organizacji: catalog.update. Ta operacja wymaga `Idempotency-Key`. Ponowienie: ta sama metoda, ścieżka, klucz i dane. Nową operację oznacz nowym kluczem; nie obchodź konfliktu przez losowanie klucza bez sprawdzenia poprzedniego wyniku. #### GET /organizations/{organizationId}/catalog-items/{catalogItemId}/ppwr/eu-declarations/{recordId} Deklaracje zgodności UE — Szczegóły Rejestr deklaracji UE powiązanych z dossier konkretnego opakowania, treścią, podpisem i dowodem. Utworzenie rekordu nie podpisuje dokumentu za producenta. Pobierz szczegóły istniejącego rekordu. UUID weź z listy lub odpowiedzi tworzenia tego samego rodzaju zasobu. Zakres klucza: ppwr:read. Uprawnienie w organizacji: catalog.view. #### POST /organizations/{organizationId}/catalog-items/{catalogItemId}/ppwr/eu-declarations/{recordId}/review Deklaracje zgodności UE — Przegląd Rejestr deklaracji UE powiązanych z dossier konkretnego opakowania, treścią, podpisem i dowodem. Utworzenie rekordu nie podpisuje dokumentu za producenta. Zapisz decyzję przeglądu i uzasadnienie. Pobierz później szczegóły, aby sprawdzić status. Decyzja jest zapisem wewnętrznym tego rejestru. Dla rejestru technicznego: przygotuj opakowanie lub rekord nadrzędny, wymagane wersje dokumentów i datę oceny; utwórz wpis, pobierz jego UUID, a następnie użyj /review, jeżeli ta metoda istnieje. Źródła muszą spełniać warunki danego rejestru. Decyzja może wymagać innego recenzenta; 403/422 nie oznacza, że klucz technicznie nie działa. Zapis ani zatwierdzenie nie zastępują opublikowanej metodyki oceny. Zakres klucza: ppwr:review. Uprawnienie w organizacji: evidence.review. Ta operacja wymaga `Idempotency-Key`. Ponowienie: ta sama metoda, ścieżka, klucz i dane. Nową operację oznacz nowym kluczem; nie obchodź konfliktu przez losowanie klucza bez sprawdzenia poprzedniego wyniku. #### GET /organizations/{organizationId}/catalog-items/{catalogItemId}/ppwr/minimization Minimalizacja — Lista Ocena minimalizacji masy i objętości z kryteriami funkcjonalnymi i dokumentacją. Wynik zależy od danych oraz przeglądu, nie od samej deklaracji liczbowej. Pobierz listę rekordów dostępnych dla organizacji klucza. Zakres klucza: ppwr:read. Uprawnienie w organizacji: catalog.view. Lista używa `per_page` (1–100, domyślnie 50) i kursora. Następne żądanie wykonaj pod adresem `links.next`; null kończy listę. Stosuj tylko filtry wymienione w parametrach tej metody. #### POST /organizations/{organizationId}/catalog-items/{catalogItemId}/ppwr/minimization Minimalizacja — Dodaj Ocena minimalizacji masy i objętości z kryteriami funkcjonalnymi i dokumentacją. Wynik zależy od danych oraz przeglądu, nie od samej deklaracji liczbowej. Utwórz rekord z danych opisanych w requestBody. Odpowiedź zawiera publiczne id do dalszego odczytu i powiązań. Dla rejestru technicznego: przygotuj opakowanie lub rekord nadrzędny, wymagane wersje dokumentów i datę oceny; utwórz wpis, pobierz jego UUID, a następnie użyj /review, jeżeli ta metoda istnieje. Źródła muszą spełniać warunki danego rejestru. Decyzja może wymagać innego recenzenta; 403/422 nie oznacza, że klucz technicznie nie działa. Zapis ani zatwierdzenie nie zastępują opublikowanej metodyki oceny. Zakres klucza: ppwr:write. Uprawnienie w organizacji: catalog.update. Ta operacja wymaga `Idempotency-Key`. Ponowienie: ta sama metoda, ścieżka, klucz i dane. Nową operację oznacz nowym kluczem; nie obchodź konfliktu przez losowanie klucza bez sprawdzenia poprzedniego wyniku. #### GET /organizations/{organizationId}/catalog-items/{catalogItemId}/ppwr/minimization/{recordId} Minimalizacja — Szczegóły Ocena minimalizacji masy i objętości z kryteriami funkcjonalnymi i dokumentacją. Wynik zależy od danych oraz przeglądu, nie od samej deklaracji liczbowej. Pobierz szczegóły istniejącego rekordu. UUID weź z listy lub odpowiedzi tworzenia tego samego rodzaju zasobu. Zakres klucza: ppwr:read. Uprawnienie w organizacji: catalog.view. #### POST /organizations/{organizationId}/catalog-items/{catalogItemId}/ppwr/minimization/{recordId}/review Minimalizacja — Przegląd Ocena minimalizacji masy i objętości z kryteriami funkcjonalnymi i dokumentacją. Wynik zależy od danych oraz przeglądu, nie od samej deklaracji liczbowej. Zapisz decyzję przeglądu i uzasadnienie. Pobierz później szczegóły, aby sprawdzić status. Decyzja jest zapisem wewnętrznym tego rejestru. Dla rejestru technicznego: przygotuj opakowanie lub rekord nadrzędny, wymagane wersje dokumentów i datę oceny; utwórz wpis, pobierz jego UUID, a następnie użyj /review, jeżeli ta metoda istnieje. Źródła muszą spełniać warunki danego rejestru. Decyzja może wymagać innego recenzenta; 403/422 nie oznacza, że klucz technicznie nie działa. Zapis ani zatwierdzenie nie zastępują opublikowanej metodyki oceny. Zakres klucza: ppwr:review. Uprawnienie w organizacji: evidence.review. Ta operacja wymaga `Idempotency-Key`. Ponowienie: ta sama metoda, ścieżka, klucz i dane. Nową operację oznacz nowym kluczem; nie obchodź konfliktu przez losowanie klucza bez sprawdzenia poprzedniego wyniku. #### GET /organizations/{organizationId}/catalog-items/{catalogItemId}/ppwr/packaging-classification Klasyfikacja opakowania — Lista Udokumentowana klasyfikacja opakowania i jego zastosowania. Nie zastępuje organizacyjnych folderów katalogu. Pobierz listę rekordów dostępnych dla organizacji klucza. Zakres klucza: ppwr:read. Uprawnienie w organizacji: catalog.view. Lista używa `per_page` (1–100, domyślnie 50) i kursora. Następne żądanie wykonaj pod adresem `links.next`; null kończy listę. Stosuj tylko filtry wymienione w parametrach tej metody. #### POST /organizations/{organizationId}/catalog-items/{catalogItemId}/ppwr/packaging-classification Klasyfikacja opakowania — Dodaj Udokumentowana klasyfikacja opakowania i jego zastosowania. Nie zastępuje organizacyjnych folderów katalogu. Utwórz rekord z danych opisanych w requestBody. Odpowiedź zawiera publiczne id do dalszego odczytu i powiązań. Dla rejestru technicznego: przygotuj opakowanie lub rekord nadrzędny, wymagane wersje dokumentów i datę oceny; utwórz wpis, pobierz jego UUID, a następnie użyj /review, jeżeli ta metoda istnieje. Źródła muszą spełniać warunki danego rejestru. Decyzja może wymagać innego recenzenta; 403/422 nie oznacza, że klucz technicznie nie działa. Zapis ani zatwierdzenie nie zastępują opublikowanej metodyki oceny. Zakres klucza: ppwr:write. Uprawnienie w organizacji: catalog.update. Ta operacja wymaga `Idempotency-Key`. Ponowienie: ta sama metoda, ścieżka, klucz i dane. Nową operację oznacz nowym kluczem; nie obchodź konfliktu przez losowanie klucza bez sprawdzenia poprzedniego wyniku. #### GET /organizations/{organizationId}/catalog-items/{catalogItemId}/ppwr/packaging-classification/{recordId} Klasyfikacja opakowania — Szczegóły Udokumentowana klasyfikacja opakowania i jego zastosowania. Nie zastępuje organizacyjnych folderów katalogu. Pobierz szczegóły istniejącego rekordu. UUID weź z listy lub odpowiedzi tworzenia tego samego rodzaju zasobu. Zakres klucza: ppwr:read. Uprawnienie w organizacji: catalog.view. #### POST /organizations/{organizationId}/catalog-items/{catalogItemId}/ppwr/packaging-classification/{recordId}/review Klasyfikacja opakowania — Przegląd Udokumentowana klasyfikacja opakowania i jego zastosowania. Nie zastępuje organizacyjnych folderów katalogu. Zapisz decyzję przeglądu i uzasadnienie. Pobierz później szczegóły, aby sprawdzić status. Decyzja jest zapisem wewnętrznym tego rejestru. Dla rejestru technicznego: przygotuj opakowanie lub rekord nadrzędny, wymagane wersje dokumentów i datę oceny; utwórz wpis, pobierz jego UUID, a następnie użyj /review, jeżeli ta metoda istnieje. Źródła muszą spełniać warunki danego rejestru. Decyzja może wymagać innego recenzenta; 403/422 nie oznacza, że klucz technicznie nie działa. Zapis ani zatwierdzenie nie zastępują opublikowanej metodyki oceny. Zakres klucza: ppwr:review. Uprawnienie w organizacji: evidence.review. Ta operacja wymaga `Idempotency-Key`. Ponowienie: ta sama metoda, ścieżka, klucz i dane. Nową operację oznacz nowym kluczem; nie obchodź konfliktu przez losowanie klucza bez sprawdzenia poprzedniego wyniku. #### GET /organizations/{organizationId}/catalog-items/{catalogItemId}/ppwr/recyclability Recyklowalność — Lista Ocena projektowania do recyklingu i powiązanych dowodów. Odróżnia dane robocze od oficjalnej metodyki i wyniku. Nie generuje brakujących urzędowych wag ani automatycznej klasy zgodności. Pobierz listę rekordów dostępnych dla organizacji klucza. Zakres klucza: ppwr:read. Uprawnienie w organizacji: catalog.view. Lista używa `per_page` (1–100, domyślnie 50) i kursora. Następne żądanie wykonaj pod adresem `links.next`; null kończy listę. Stosuj tylko filtry wymienione w parametrach tej metody. #### POST /organizations/{organizationId}/catalog-items/{catalogItemId}/ppwr/recyclability Recyklowalność — Dodaj Ocena projektowania do recyklingu i powiązanych dowodów. Odróżnia dane robocze od oficjalnej metodyki i wyniku. Nie generuje brakujących urzędowych wag ani automatycznej klasy zgodności. Utwórz rekord z danych opisanych w requestBody. Odpowiedź zawiera publiczne id do dalszego odczytu i powiązań. Dla rejestru technicznego: przygotuj opakowanie lub rekord nadrzędny, wymagane wersje dokumentów i datę oceny; utwórz wpis, pobierz jego UUID, a następnie użyj /review, jeżeli ta metoda istnieje. Źródła muszą spełniać warunki danego rejestru. Decyzja może wymagać innego recenzenta; 403/422 nie oznacza, że klucz technicznie nie działa. Zapis ani zatwierdzenie nie zastępują opublikowanej metodyki oceny. Zakres klucza: ppwr:write. Uprawnienie w organizacji: catalog.update. Ta operacja wymaga `Idempotency-Key`. Ponowienie: ta sama metoda, ścieżka, klucz i dane. Nową operację oznacz nowym kluczem; nie obchodź konfliktu przez losowanie klucza bez sprawdzenia poprzedniego wyniku. #### GET /organizations/{organizationId}/catalog-items/{catalogItemId}/ppwr/recyclability/{recordId} Recyklowalność — Szczegóły Ocena projektowania do recyklingu i powiązanych dowodów. Odróżnia dane robocze od oficjalnej metodyki i wyniku. Nie generuje brakujących urzędowych wag ani automatycznej klasy zgodności. Pobierz szczegóły istniejącego rekordu. UUID weź z listy lub odpowiedzi tworzenia tego samego rodzaju zasobu. Zakres klucza: ppwr:read. Uprawnienie w organizacji: catalog.view. #### POST /organizations/{organizationId}/catalog-items/{catalogItemId}/ppwr/recyclability/{recordId}/review Recyklowalność — Przegląd Ocena projektowania do recyklingu i powiązanych dowodów. Odróżnia dane robocze od oficjalnej metodyki i wyniku. Nie generuje brakujących urzędowych wag ani automatycznej klasy zgodności. Zapisz decyzję przeglądu i uzasadnienie. Pobierz później szczegóły, aby sprawdzić status. Decyzja jest zapisem wewnętrznym tego rejestru. Dla rejestru technicznego: przygotuj opakowanie lub rekord nadrzędny, wymagane wersje dokumentów i datę oceny; utwórz wpis, pobierz jego UUID, a następnie użyj /review, jeżeli ta metoda istnieje. Źródła muszą spełniać warunki danego rejestru. Decyzja może wymagać innego recenzenta; 403/422 nie oznacza, że klucz technicznie nie działa. Zapis ani zatwierdzenie nie zastępują opublikowanej metodyki oceny. Zakres klucza: ppwr:review. Uprawnienie w organizacji: evidence.review. Ta operacja wymaga `Idempotency-Key`. Ponowienie: ta sama metoda, ścieżka, klucz i dane. Nową operację oznacz nowym kluczem; nie obchodź konfliktu przez losowanie klucza bez sprawdzenia poprzedniego wyniku. #### GET /organizations/{organizationId}/catalog-items/{catalogItemId}/ppwr/restricted-formats Ograniczenia formatów — Lista Ocena zastosowania ograniczeń formatu i wyjątków dla konkretnego opakowania. Wymaga opisu zastosowania oraz wskazanych dowodów, nie tylko kodu materiału. Pobierz listę rekordów dostępnych dla organizacji klucza. Zakres klucza: ppwr:read. Uprawnienie w organizacji: catalog.view. Lista używa `per_page` (1–100, domyślnie 50) i kursora. Następne żądanie wykonaj pod adresem `links.next`; null kończy listę. Stosuj tylko filtry wymienione w parametrach tej metody. #### POST /organizations/{organizationId}/catalog-items/{catalogItemId}/ppwr/restricted-formats Ograniczenia formatów — Dodaj Ocena zastosowania ograniczeń formatu i wyjątków dla konkretnego opakowania. Wymaga opisu zastosowania oraz wskazanych dowodów, nie tylko kodu materiału. Utwórz rekord z danych opisanych w requestBody. Odpowiedź zawiera publiczne id do dalszego odczytu i powiązań. Dla rejestru technicznego: przygotuj opakowanie lub rekord nadrzędny, wymagane wersje dokumentów i datę oceny; utwórz wpis, pobierz jego UUID, a następnie użyj /review, jeżeli ta metoda istnieje. Źródła muszą spełniać warunki danego rejestru. Decyzja może wymagać innego recenzenta; 403/422 nie oznacza, że klucz technicznie nie działa. Zapis ani zatwierdzenie nie zastępują opublikowanej metodyki oceny. Zakres klucza: ppwr:write. Uprawnienie w organizacji: catalog.update. Ta operacja wymaga `Idempotency-Key`. Ponowienie: ta sama metoda, ścieżka, klucz i dane. Nową operację oznacz nowym kluczem; nie obchodź konfliktu przez losowanie klucza bez sprawdzenia poprzedniego wyniku. #### GET /organizations/{organizationId}/catalog-items/{catalogItemId}/ppwr/restricted-formats/{recordId} Ograniczenia formatów — Szczegóły Ocena zastosowania ograniczeń formatu i wyjątków dla konkretnego opakowania. Wymaga opisu zastosowania oraz wskazanych dowodów, nie tylko kodu materiału. Pobierz szczegóły istniejącego rekordu. UUID weź z listy lub odpowiedzi tworzenia tego samego rodzaju zasobu. Zakres klucza: ppwr:read. Uprawnienie w organizacji: catalog.view. #### POST /organizations/{organizationId}/catalog-items/{catalogItemId}/ppwr/restricted-formats/{recordId}/review Ograniczenia formatów — Przegląd Ocena zastosowania ograniczeń formatu i wyjątków dla konkretnego opakowania. Wymaga opisu zastosowania oraz wskazanych dowodów, nie tylko kodu materiału. Zapisz decyzję przeglądu i uzasadnienie. Pobierz później szczegóły, aby sprawdzić status. Decyzja jest zapisem wewnętrznym tego rejestru. Dla rejestru technicznego: przygotuj opakowanie lub rekord nadrzędny, wymagane wersje dokumentów i datę oceny; utwórz wpis, pobierz jego UUID, a następnie użyj /review, jeżeli ta metoda istnieje. Źródła muszą spełniać warunki danego rejestru. Decyzja może wymagać innego recenzenta; 403/422 nie oznacza, że klucz technicznie nie działa. Zapis ani zatwierdzenie nie zastępują opublikowanej metodyki oceny. Zakres klucza: ppwr:review. Uprawnienie w organizacji: evidence.review. Ta operacja wymaga `Idempotency-Key`. Ponowienie: ta sama metoda, ścieżka, klucz i dane. Nową operację oznacz nowym kluczem; nie obchodź konfliktu przez losowanie klucza bez sprawdzenia poprzedniego wyniku. #### GET /organizations/{organizationId}/catalog-items/{catalogItemId}/ppwr/role-duties Obowiązki podmiotów — Lista Karta obowiązków wynikających z roli firmy na aktywnym rynku. scenario musi należeć do wskazanego opakowania; zakup lub własna produkcja nie zastępują roli gospodarczej. Pobierz listę rekordów dostępnych dla organizacji klucza. Zakres klucza: ppwr:read. Uprawnienie w organizacji: catalog.view. Lista używa `per_page` (1–100, domyślnie 50) i kursora. Następne żądanie wykonaj pod adresem `links.next`; null kończy listę. Stosuj tylko filtry wymienione w parametrach tej metody. #### POST /organizations/{organizationId}/catalog-items/{catalogItemId}/ppwr/role-duties Obowiązki podmiotów — Dodaj Karta obowiązków wynikających z roli firmy na aktywnym rynku. scenario musi należeć do wskazanego opakowania; zakup lub własna produkcja nie zastępują roli gospodarczej. Utwórz rekord z danych opisanych w requestBody. Odpowiedź zawiera publiczne id do dalszego odczytu i powiązań. Dla rejestru technicznego: przygotuj opakowanie lub rekord nadrzędny, wymagane wersje dokumentów i datę oceny; utwórz wpis, pobierz jego UUID, a następnie użyj /review, jeżeli ta metoda istnieje. Źródła muszą spełniać warunki danego rejestru. Decyzja może wymagać innego recenzenta; 403/422 nie oznacza, że klucz technicznie nie działa. Zapis ani zatwierdzenie nie zastępują opublikowanej metodyki oceny. Zakres klucza: ppwr:write. Uprawnienie w organizacji: catalog.update. Ta operacja wymaga `Idempotency-Key`. Ponowienie: ta sama metoda, ścieżka, klucz i dane. Nową operację oznacz nowym kluczem; nie obchodź konfliktu przez losowanie klucza bez sprawdzenia poprzedniego wyniku. #### GET /organizations/{organizationId}/catalog-items/{catalogItemId}/ppwr/role-duties/{recordId} Obowiązki podmiotów — Szczegóły Karta obowiązków wynikających z roli firmy na aktywnym rynku. scenario musi należeć do wskazanego opakowania; zakup lub własna produkcja nie zastępują roli gospodarczej. Pobierz szczegóły istniejącego rekordu. UUID weź z listy lub odpowiedzi tworzenia tego samego rodzaju zasobu. Zakres klucza: ppwr:read. Uprawnienie w organizacji: catalog.view. #### POST /organizations/{organizationId}/catalog-items/{catalogItemId}/ppwr/role-duties/{recordId}/review Obowiązki podmiotów — Przegląd Karta obowiązków wynikających z roli firmy na aktywnym rynku. scenario musi należeć do wskazanego opakowania; zakup lub własna produkcja nie zastępują roli gospodarczej. Zapisz decyzję przeglądu i uzasadnienie. Pobierz później szczegóły, aby sprawdzić status. Decyzja jest zapisem wewnętrznym tego rejestru. Dla rejestru technicznego: przygotuj opakowanie lub rekord nadrzędny, wymagane wersje dokumentów i datę oceny; utwórz wpis, pobierz jego UUID, a następnie użyj /review, jeżeli ta metoda istnieje. Źródła muszą spełniać warunki danego rejestru. Decyzja może wymagać innego recenzenta; 403/422 nie oznacza, że klucz technicznie nie działa. Zapis ani zatwierdzenie nie zastępują opublikowanej metodyki oceny. Zakres klucza: ppwr:review. Uprawnienie w organizacji: evidence.review. Ta operacja wymaga `Idempotency-Key`. Ponowienie: ta sama metoda, ścieżka, klucz i dane. Nową operację oznacz nowym kluczem; nie obchodź konfliktu przez losowanie klucza bez sprawdzenia poprzedniego wyniku. ### Ponowne użycie i egzemplarze zwrotne System obiegu → dokumentacja i potwierdzenia rynku → jednostki → zdarzenia obrotu/przegląd → agregacje i okresowe cele. System obiegu nie jest zestawem pakowym. #### GET /organizations/{organizationId}/catalog-items/{catalogItemId}/ppwr/reuse-assessments Ocena ponownego użycia — Lista Ocena zdolności opakowania do ponownego użycia, z wymaganiami technicznymi i dowodami. Nie jest ewidencją faktycznych obrotów pojedynczej sztuki. Pobierz listę rekordów dostępnych dla organizacji klucza. Zakres klucza: ppwr:read. Uprawnienie w organizacji: catalog.view. Lista używa `per_page` (1–100, domyślnie 50) i kursora. Następne żądanie wykonaj pod adresem `links.next`; null kończy listę. Stosuj tylko filtry wymienione w parametrach tej metody. #### POST /organizations/{organizationId}/catalog-items/{catalogItemId}/ppwr/reuse-assessments Ocena ponownego użycia — Dodaj Ocena zdolności opakowania do ponownego użycia, z wymaganiami technicznymi i dowodami. Nie jest ewidencją faktycznych obrotów pojedynczej sztuki. Utwórz rekord z danych opisanych w requestBody. Odpowiedź zawiera publiczne id do dalszego odczytu i powiązań. Dla rejestru technicznego: przygotuj opakowanie lub rekord nadrzędny, wymagane wersje dokumentów i datę oceny; utwórz wpis, pobierz jego UUID, a następnie użyj /review, jeżeli ta metoda istnieje. Źródła muszą spełniać warunki danego rejestru. Decyzja może wymagać innego recenzenta; 403/422 nie oznacza, że klucz technicznie nie działa. Zapis ani zatwierdzenie nie zastępują opublikowanej metodyki oceny. Zakres klucza: ppwr:write. Uprawnienie w organizacji: catalog.update. Ta operacja wymaga `Idempotency-Key`. Ponowienie: ta sama metoda, ścieżka, klucz i dane. Nową operację oznacz nowym kluczem; nie obchodź konfliktu przez losowanie klucza bez sprawdzenia poprzedniego wyniku. #### GET /organizations/{organizationId}/catalog-items/{catalogItemId}/ppwr/reuse-assessments/{recordId} Ocena ponownego użycia — Szczegóły Ocena zdolności opakowania do ponownego użycia, z wymaganiami technicznymi i dowodami. Nie jest ewidencją faktycznych obrotów pojedynczej sztuki. Pobierz szczegóły istniejącego rekordu. UUID weź z listy lub odpowiedzi tworzenia tego samego rodzaju zasobu. Zakres klucza: ppwr:read. Uprawnienie w organizacji: catalog.view. #### POST /organizations/{organizationId}/catalog-items/{catalogItemId}/ppwr/reuse-assessments/{recordId}/review Ocena ponownego użycia — Przegląd Ocena zdolności opakowania do ponownego użycia, z wymaganiami technicznymi i dowodami. Nie jest ewidencją faktycznych obrotów pojedynczej sztuki. Zapisz decyzję przeglądu i uzasadnienie. Pobierz później szczegóły, aby sprawdzić status. Decyzja jest zapisem wewnętrznym tego rejestru. Dla rejestru technicznego: przygotuj opakowanie lub rekord nadrzędny, wymagane wersje dokumentów i datę oceny; utwórz wpis, pobierz jego UUID, a następnie użyj /review, jeżeli ta metoda istnieje. Źródła muszą spełniać warunki danego rejestru. Decyzja może wymagać innego recenzenta; 403/422 nie oznacza, że klucz technicznie nie działa. Zapis ani zatwierdzenie nie zastępują opublikowanej metodyki oceny. Zakres klucza: ppwr:review. Uprawnienie w organizacji: evidence.review. Ta operacja wymaga `Idempotency-Key`. Ponowienie: ta sama metoda, ścieżka, klucz i dane. Nową operację oznacz nowym kluczem; nie obchodź konfliktu przez losowanie klucza bez sprawdzenia poprzedniego wyniku. #### GET /organizations/{organizationId}/catalog-items/{catalogItemId}/ppwr/reuse-units Jednostki wielokrotnego użytku — Lista Identyfikowane egzemplarze wielokrotnego użytku. item jest rodzajem opakowania; jednostka zwrotna identyfikuje konkretną sztukę o własnej historii zdarzeń. Pobierz listę rekordów dostępnych dla organizacji klucza. Zakres klucza: ppwr:read. Uprawnienie w organizacji: catalog.view. Lista używa `per_page` (1–100, domyślnie 50) i kursora. Następne żądanie wykonaj pod adresem `links.next`; null kończy listę. Stosuj tylko filtry wymienione w parametrach tej metody. #### POST /organizations/{organizationId}/catalog-items/{catalogItemId}/ppwr/reuse-units Jednostki wielokrotnego użytku — Dodaj Identyfikowane egzemplarze wielokrotnego użytku. item jest rodzajem opakowania; jednostka zwrotna identyfikuje konkretną sztukę o własnej historii zdarzeń. Utwórz rekord z danych opisanych w requestBody. Odpowiedź zawiera publiczne id do dalszego odczytu i powiązań. Dla rejestru technicznego: przygotuj opakowanie lub rekord nadrzędny, wymagane wersje dokumentów i datę oceny; utwórz wpis, pobierz jego UUID, a następnie użyj /review, jeżeli ta metoda istnieje. Źródła muszą spełniać warunki danego rejestru. Decyzja może wymagać innego recenzenta; 403/422 nie oznacza, że klucz technicznie nie działa. Zapis ani zatwierdzenie nie zastępują opublikowanej metodyki oceny. Zakres klucza: ppwr:write. Uprawnienie w organizacji: catalog.update. Ta operacja wymaga `Idempotency-Key`. Ponowienie: ta sama metoda, ścieżka, klucz i dane. Nową operację oznacz nowym kluczem; nie obchodź konfliktu przez losowanie klucza bez sprawdzenia poprzedniego wyniku. #### GET /organizations/{organizationId}/catalog-items/{catalogItemId}/ppwr/reuse-units/{recordId} Jednostki wielokrotnego użytku — Szczegóły Identyfikowane egzemplarze wielokrotnego użytku. item jest rodzajem opakowania; jednostka zwrotna identyfikuje konkretną sztukę o własnej historii zdarzeń. Pobierz szczegóły istniejącego rekordu. UUID weź z listy lub odpowiedzi tworzenia tego samego rodzaju zasobu. Zakres klucza: ppwr:read. Uprawnienie w organizacji: catalog.view. #### GET /organizations/{organizationId}/ppwr/refill-stations Stacje ponownego napełniania — Lista Karty punktów ponownego napełniania z warunkami i dokumentacją. API nie steruje urządzeniem dozującym ani sprzedażą detaliczną. Pobierz listę rekordów dostępnych dla organizacji klucza. Zakres klucza: ppwr:read. Uprawnienie w organizacji: reports.view. Lista używa `per_page` (1–100, domyślnie 50) i kursora. Następne żądanie wykonaj pod adresem `links.next`; null kończy listę. Stosuj tylko filtry wymienione w parametrach tej metody. #### POST /organizations/{organizationId}/ppwr/refill-stations Stacje ponownego napełniania — Dodaj Karty punktów ponownego napełniania z warunkami i dokumentacją. API nie steruje urządzeniem dozującym ani sprzedażą detaliczną. Utwórz rekord z danych opisanych w requestBody. Odpowiedź zawiera publiczne id do dalszego odczytu i powiązań. Dla rejestru technicznego: przygotuj opakowanie lub rekord nadrzędny, wymagane wersje dokumentów i datę oceny; utwórz wpis, pobierz jego UUID, a następnie użyj /review, jeżeli ta metoda istnieje. Źródła muszą spełniać warunki danego rejestru. Decyzja może wymagać innego recenzenta; 403/422 nie oznacza, że klucz technicznie nie działa. Zapis ani zatwierdzenie nie zastępują opublikowanej metodyki oceny. Zakres klucza: ppwr:write. Uprawnienie w organizacji: reports.export. Ta operacja wymaga `Idempotency-Key`. Ponowienie: ta sama metoda, ścieżka, klucz i dane. Nową operację oznacz nowym kluczem; nie obchodź konfliktu przez losowanie klucza bez sprawdzenia poprzedniego wyniku. #### GET /organizations/{organizationId}/ppwr/refill-stations/{recordId} Stacje ponownego napełniania — Szczegóły Karty punktów ponownego napełniania z warunkami i dokumentacją. API nie steruje urządzeniem dozującym ani sprzedażą detaliczną. Pobierz szczegóły istniejącego rekordu. UUID weź z listy lub odpowiedzi tworzenia tego samego rodzaju zasobu. Zakres klucza: ppwr:read. Uprawnienie w organizacji: reports.view. #### POST /organizations/{organizationId}/ppwr/refill-stations/{recordId}/review Stacje ponownego napełniania — Przegląd Karty punktów ponownego napełniania z warunkami i dokumentacją. API nie steruje urządzeniem dozującym ani sprzedażą detaliczną. Zapisz decyzję przeglądu i uzasadnienie. Pobierz później szczegóły, aby sprawdzić status. Decyzja jest zapisem wewnętrznym tego rejestru. Dla rejestru technicznego: przygotuj opakowanie lub rekord nadrzędny, wymagane wersje dokumentów i datę oceny; utwórz wpis, pobierz jego UUID, a następnie użyj /review, jeżeli ta metoda istnieje. Źródła muszą spełniać warunki danego rejestru. Decyzja może wymagać innego recenzenta; 403/422 nie oznacza, że klucz technicznie nie działa. Zapis ani zatwierdzenie nie zastępują opublikowanej metodyki oceny. Zakres klucza: ppwr:review. Uprawnienie w organizacji: evidence.review. Ta operacja wymaga `Idempotency-Key`. Ponowienie: ta sama metoda, ścieżka, klucz i dane. Nową operację oznacz nowym kluczem; nie obchodź konfliktu przez losowanie klucza bez sprawdzenia poprzedniego wyniku. #### GET /organizations/{organizationId}/ppwr/reuse-market-confirmations Potwierdzenia rynków ponownego użycia — Lista Potwierdzenia dotyczące systemu ponownego użycia na wskazanym rynku i okresie. Łączą dane systemu z dowodami konkretnego zastosowania. Pobierz listę rekordów dostępnych dla organizacji klucza. Zakres klucza: ppwr:read. Uprawnienie w organizacji: catalog.view. Lista używa `per_page` (1–100, domyślnie 50) i kursora. Następne żądanie wykonaj pod adresem `links.next`; null kończy listę. Stosuj tylko filtry wymienione w parametrach tej metody. #### POST /organizations/{organizationId}/ppwr/reuse-market-confirmations Potwierdzenia rynków ponownego użycia — Dodaj Potwierdzenia dotyczące systemu ponownego użycia na wskazanym rynku i okresie. Łączą dane systemu z dowodami konkretnego zastosowania. Utwórz rekord z danych opisanych w requestBody. Odpowiedź zawiera publiczne id do dalszego odczytu i powiązań. Dla rejestru technicznego: przygotuj opakowanie lub rekord nadrzędny, wymagane wersje dokumentów i datę oceny; utwórz wpis, pobierz jego UUID, a następnie użyj /review, jeżeli ta metoda istnieje. Źródła muszą spełniać warunki danego rejestru. Decyzja może wymagać innego recenzenta; 403/422 nie oznacza, że klucz technicznie nie działa. Zapis ani zatwierdzenie nie zastępują opublikowanej metodyki oceny. Zakres klucza: ppwr:write. Uprawnienie w organizacji: catalog.update. Ta operacja wymaga `Idempotency-Key`. Ponowienie: ta sama metoda, ścieżka, klucz i dane. Nową operację oznacz nowym kluczem; nie obchodź konfliktu przez losowanie klucza bez sprawdzenia poprzedniego wyniku. #### GET /organizations/{organizationId}/ppwr/reuse-market-confirmations/{recordId} Potwierdzenia rynków ponownego użycia — Szczegóły Potwierdzenia dotyczące systemu ponownego użycia na wskazanym rynku i okresie. Łączą dane systemu z dowodami konkretnego zastosowania. Pobierz szczegóły istniejącego rekordu. UUID weź z listy lub odpowiedzi tworzenia tego samego rodzaju zasobu. Zakres klucza: ppwr:read. Uprawnienie w organizacji: catalog.view. #### POST /organizations/{organizationId}/ppwr/reuse-market-confirmations/{recordId}/review Potwierdzenia rynków ponownego użycia — Przegląd Potwierdzenia dotyczące systemu ponownego użycia na wskazanym rynku i okresie. Łączą dane systemu z dowodami konkretnego zastosowania. Zapisz decyzję przeglądu i uzasadnienie. Pobierz później szczegóły, aby sprawdzić status. Decyzja jest zapisem wewnętrznym tego rejestru. Dla rejestru technicznego: przygotuj opakowanie lub rekord nadrzędny, wymagane wersje dokumentów i datę oceny; utwórz wpis, pobierz jego UUID, a następnie użyj /review, jeżeli ta metoda istnieje. Źródła muszą spełniać warunki danego rejestru. Decyzja może wymagać innego recenzenta; 403/422 nie oznacza, że klucz technicznie nie działa. Zapis ani zatwierdzenie nie zastępują opublikowanej metodyki oceny. Zakres klucza: ppwr:review. Uprawnienie w organizacji: evidence.review. Ta operacja wymaga `Idempotency-Key`. Ponowienie: ta sama metoda, ścieżka, klucz i dane. Nową operację oznacz nowym kluczem; nie obchodź konfliktu przez losowanie klucza bez sprawdzenia poprzedniego wyniku. #### GET /organizations/{organizationId}/ppwr/reuse-statistics Statystyki ponownego użycia Agregacje danych systemów i egzemplarzy ponownego użycia. Wyniki odzwierciedlają zapisany zakres, nie zastępują okresowego zestawu celów ani pełnej oceny zgodności. Pobierz agregaty zapisanych obrotów i systemów. Nie zmienia żadnej karty ani zdarzenia. Zakres klucza: ppwr:read. Uprawnienie w organizacji: catalog.view. #### GET /organizations/{organizationId}/ppwr/reuse-systems Systemy ponownego użycia — Lista Organizacja obiegu wielokrotnego użytku i jej dokumentacja. To system uczestników i zasad zwrotu, a nie receptura kartonu z taśmą w packaging-systems. Pobierz listę rekordów dostępnych dla organizacji klucza. Zakres klucza: ppwr:read. Uprawnienie w organizacji: catalog.view. Lista używa `per_page` (1–100, domyślnie 50) i kursora. Następne żądanie wykonaj pod adresem `links.next`; null kończy listę. Stosuj tylko filtry wymienione w parametrach tej metody. #### POST /organizations/{organizationId}/ppwr/reuse-systems Systemy ponownego użycia — Dodaj Organizacja obiegu wielokrotnego użytku i jej dokumentacja. To system uczestników i zasad zwrotu, a nie receptura kartonu z taśmą w packaging-systems. Utwórz rekord z danych opisanych w requestBody. Odpowiedź zawiera publiczne id do dalszego odczytu i powiązań. Dla rejestru technicznego: przygotuj opakowanie lub rekord nadrzędny, wymagane wersje dokumentów i datę oceny; utwórz wpis, pobierz jego UUID, a następnie użyj /review, jeżeli ta metoda istnieje. Źródła muszą spełniać warunki danego rejestru. Decyzja może wymagać innego recenzenta; 403/422 nie oznacza, że klucz technicznie nie działa. Zapis ani zatwierdzenie nie zastępują opublikowanej metodyki oceny. Zakres klucza: ppwr:write. Uprawnienie w organizacji: catalog.update. Ta operacja wymaga `Idempotency-Key`. Ponowienie: ta sama metoda, ścieżka, klucz i dane. Nową operację oznacz nowym kluczem; nie obchodź konfliktu przez losowanie klucza bez sprawdzenia poprzedniego wyniku. #### GET /organizations/{organizationId}/ppwr/reuse-systems/{recordId} Systemy ponownego użycia — Szczegóły Organizacja obiegu wielokrotnego użytku i jej dokumentacja. To system uczestników i zasad zwrotu, a nie receptura kartonu z taśmą w packaging-systems. Pobierz szczegóły istniejącego rekordu. UUID weź z listy lub odpowiedzi tworzenia tego samego rodzaju zasobu. Zakres klucza: ppwr:read. Uprawnienie w organizacji: catalog.view. #### POST /organizations/{organizationId}/ppwr/reuse-systems/{recordId}/review Systemy ponownego użycia — Przegląd Organizacja obiegu wielokrotnego użytku i jej dokumentacja. To system uczestników i zasad zwrotu, a nie receptura kartonu z taśmą w packaging-systems. Zapisz decyzję przeglądu i uzasadnienie. Pobierz później szczegóły, aby sprawdzić status. Decyzja jest zapisem wewnętrznym tego rejestru. Dla rejestru technicznego: przygotuj opakowanie lub rekord nadrzędny, wymagane wersje dokumentów i datę oceny; utwórz wpis, pobierz jego UUID, a następnie użyj /review, jeżeli ta metoda istnieje. Źródła muszą spełniać warunki danego rejestru. Decyzja może wymagać innego recenzenta; 403/422 nie oznacza, że klucz technicznie nie działa. Zapis ani zatwierdzenie nie zastępują opublikowanej metodyki oceny. Zakres klucza: ppwr:review. Uprawnienie w organizacji: evidence.review. Ta operacja wymaga `Idempotency-Key`. Ponowienie: ta sama metoda, ścieżka, klucz i dane. Nową operację oznacz nowym kluczem; nie obchodź konfliktu przez losowanie klucza bez sprawdzenia poprzedniego wyniku. #### GET /organizations/{organizationId}/ppwr/reuse-targets Cele ponownego użycia — Lista Okresowy zestaw danych do obliczeń udziału ponownego użycia. Najpierw utwórz zestaw, następnie pozycje i przeprowadź przegląd całości. Pobierz listę rekordów dostępnych dla organizacji klucza. Zakres klucza: ppwr:read. Uprawnienie w organizacji: reports.view. Lista używa `per_page` (1–100, domyślnie 50) i kursora. Następne żądanie wykonaj pod adresem `links.next`; null kończy listę. Stosuj tylko filtry wymienione w parametrach tej metody. #### POST /organizations/{organizationId}/ppwr/reuse-targets Cele ponownego użycia — Dodaj Okresowy zestaw danych do obliczeń udziału ponownego użycia. Najpierw utwórz zestaw, następnie pozycje i przeprowadź przegląd całości. Utwórz rekord z danych opisanych w requestBody. Odpowiedź zawiera publiczne id do dalszego odczytu i powiązań. Dla rejestru technicznego: przygotuj opakowanie lub rekord nadrzędny, wymagane wersje dokumentów i datę oceny; utwórz wpis, pobierz jego UUID, a następnie użyj /review, jeżeli ta metoda istnieje. Źródła muszą spełniać warunki danego rejestru. Decyzja może wymagać innego recenzenta; 403/422 nie oznacza, że klucz technicznie nie działa. Zapis ani zatwierdzenie nie zastępują opublikowanej metodyki oceny. Zakres klucza: ppwr:write. Uprawnienie w organizacji: reports.export. Ta operacja wymaga `Idempotency-Key`. Ponowienie: ta sama metoda, ścieżka, klucz i dane. Nową operację oznacz nowym kluczem; nie obchodź konfliktu przez losowanie klucza bez sprawdzenia poprzedniego wyniku. #### GET /organizations/{organizationId}/ppwr/reuse-targets/{parentId}/lines Pozycje celów ponownego użycia — Lista Pozycje okresowego zestawu ponownego użycia. parentId identyfikuje zestaw danych, a pola określają wkład do mianownika/licznika zgodnie ze schematem. Pobierz listę rekordów dostępnych dla organizacji klucza. Zakres klucza: ppwr:read. Uprawnienie w organizacji: reports.view. Lista używa `per_page` (1–100, domyślnie 50) i kursora. Następne żądanie wykonaj pod adresem `links.next`; null kończy listę. Stosuj tylko filtry wymienione w parametrach tej metody. #### POST /organizations/{organizationId}/ppwr/reuse-targets/{parentId}/lines Pozycje celów ponownego użycia — Dodaj Pozycje okresowego zestawu ponownego użycia. parentId identyfikuje zestaw danych, a pola określają wkład do mianownika/licznika zgodnie ze schematem. Utwórz rekord z danych opisanych w requestBody. Odpowiedź zawiera publiczne id do dalszego odczytu i powiązań. Dla rejestru technicznego: przygotuj opakowanie lub rekord nadrzędny, wymagane wersje dokumentów i datę oceny; utwórz wpis, pobierz jego UUID, a następnie użyj /review, jeżeli ta metoda istnieje. Źródła muszą spełniać warunki danego rejestru. Decyzja może wymagać innego recenzenta; 403/422 nie oznacza, że klucz technicznie nie działa. Zapis ani zatwierdzenie nie zastępują opublikowanej metodyki oceny. Zakres klucza: ppwr:write. Uprawnienie w organizacji: reports.export. Ta operacja wymaga `Idempotency-Key`. Ponowienie: ta sama metoda, ścieżka, klucz i dane. Nową operację oznacz nowym kluczem; nie obchodź konfliktu przez losowanie klucza bez sprawdzenia poprzedniego wyniku. #### GET /organizations/{organizationId}/ppwr/reuse-targets/{parentId}/lines/{recordId} Pozycje celów ponownego użycia — Szczegóły Pozycje okresowego zestawu ponownego użycia. parentId identyfikuje zestaw danych, a pola określają wkład do mianownika/licznika zgodnie ze schematem. Pobierz szczegóły istniejącego rekordu. UUID weź z listy lub odpowiedzi tworzenia tego samego rodzaju zasobu. Zakres klucza: ppwr:read. Uprawnienie w organizacji: reports.view. #### GET /organizations/{organizationId}/ppwr/reuse-targets/{recordId} Cele ponownego użycia — Szczegóły Okresowy zestaw danych do obliczeń udziału ponownego użycia. Najpierw utwórz zestaw, następnie pozycje i przeprowadź przegląd całości. Pobierz szczegóły istniejącego rekordu. UUID weź z listy lub odpowiedzi tworzenia tego samego rodzaju zasobu. Zakres klucza: ppwr:read. Uprawnienie w organizacji: reports.view. #### POST /organizations/{organizationId}/ppwr/reuse-targets/{recordId}/review Cele ponownego użycia — Przegląd Okresowy zestaw danych do obliczeń udziału ponownego użycia. Najpierw utwórz zestaw, następnie pozycje i przeprowadź przegląd całości. Zapisz decyzję przeglądu i uzasadnienie. Pobierz później szczegóły, aby sprawdzić status. Decyzja jest zapisem wewnętrznym tego rejestru. Dla rejestru technicznego: przygotuj opakowanie lub rekord nadrzędny, wymagane wersje dokumentów i datę oceny; utwórz wpis, pobierz jego UUID, a następnie użyj /review, jeżeli ta metoda istnieje. Źródła muszą spełniać warunki danego rejestru. Decyzja może wymagać innego recenzenta; 403/422 nie oznacza, że klucz technicznie nie działa. Zapis ani zatwierdzenie nie zastępują opublikowanej metodyki oceny. Zakres klucza: ppwr:review. Uprawnienie w organizacji: evidence.review. Ta operacja wymaga `Idempotency-Key`. Ponowienie: ta sama metoda, ścieżka, klucz i dane. Nową operację oznacz nowym kluczem; nie obchodź konfliktu przez losowanie klucza bez sprawdzenia poprzedniego wyniku. #### GET /organizations/{organizationId}/ppwr/reuse-units/{parentId}/events Zdarzenia jednostek zwrotnych — Lista Zdarzenia obrotu konkretnego egzemplarza zwrotnego, przypisane do parentId jednostki. Zapis i przegląd zdarzenia są osobnymi operacjami. Pobierz listę rekordów dostępnych dla organizacji klucza. Zakres klucza: ppwr:read. Uprawnienie w organizacji: catalog.view. Lista używa `per_page` (1–100, domyślnie 50) i kursora. Następne żądanie wykonaj pod adresem `links.next`; null kończy listę. Stosuj tylko filtry wymienione w parametrach tej metody. #### POST /organizations/{organizationId}/ppwr/reuse-units/{parentId}/events Zdarzenia jednostek zwrotnych — Dodaj Zdarzenia obrotu konkretnego egzemplarza zwrotnego, przypisane do parentId jednostki. Zapis i przegląd zdarzenia są osobnymi operacjami. Utwórz rekord z danych opisanych w requestBody. Odpowiedź zawiera publiczne id do dalszego odczytu i powiązań. Dla rejestru technicznego: przygotuj opakowanie lub rekord nadrzędny, wymagane wersje dokumentów i datę oceny; utwórz wpis, pobierz jego UUID, a następnie użyj /review, jeżeli ta metoda istnieje. Źródła muszą spełniać warunki danego rejestru. Decyzja może wymagać innego recenzenta; 403/422 nie oznacza, że klucz technicznie nie działa. Zapis ani zatwierdzenie nie zastępują opublikowanej metodyki oceny. Zakres klucza: ppwr:write. Uprawnienie w organizacji: catalog.update. Ta operacja wymaga `Idempotency-Key`. Ponowienie: ta sama metoda, ścieżka, klucz i dane. Nową operację oznacz nowym kluczem; nie obchodź konfliktu przez losowanie klucza bez sprawdzenia poprzedniego wyniku. #### GET /organizations/{organizationId}/ppwr/reuse-units/{parentId}/events/{recordId} Zdarzenia jednostek zwrotnych — Szczegóły Zdarzenia obrotu konkretnego egzemplarza zwrotnego, przypisane do parentId jednostki. Zapis i przegląd zdarzenia są osobnymi operacjami. Pobierz szczegóły istniejącego rekordu. UUID weź z listy lub odpowiedzi tworzenia tego samego rodzaju zasobu. Zakres klucza: ppwr:read. Uprawnienie w organizacji: catalog.view. #### POST /organizations/{organizationId}/ppwr/reuse-units/{parentId}/events/{recordId}/review Zdarzenia jednostek zwrotnych — Przegląd Zdarzenia obrotu konkretnego egzemplarza zwrotnego, przypisane do parentId jednostki. Zapis i przegląd zdarzenia są osobnymi operacjami. Zapisz decyzję przeglądu i uzasadnienie. Pobierz później szczegóły, aby sprawdzić status. Decyzja jest zapisem wewnętrznym tego rejestru. Dla rejestru technicznego: przygotuj opakowanie lub rekord nadrzędny, wymagane wersje dokumentów i datę oceny; utwórz wpis, pobierz jego UUID, a następnie użyj /review, jeżeli ta metoda istnieje. Źródła muszą spełniać warunki danego rejestru. Decyzja może wymagać innego recenzenta; 403/422 nie oznacza, że klucz technicznie nie działa. Zapis ani zatwierdzenie nie zastępują opublikowanej metodyki oceny. Zakres klucza: ppwr:review. Uprawnienie w organizacji: evidence.review. Ta operacja wymaga `Idempotency-Key`. Ponowienie: ta sama metoda, ścieżka, klucz i dane. Nową operację oznacz nowym kluczem; nie obchodź konfliktu przez losowanie klucza bez sprawdzenia poprzedniego wyniku. ### Kaucje, gastronomia i informacje Specjalistyczne rejestry dokumentacyjne. Kaucje opisują opakowanie i udział w systemie, bez obsługi pieniędzy; HoReCa i informacje odbiorców przechowują oceny i dowody. #### GET /organizations/{organizationId}/ppwr/deposit-schemes Oceny opakowań w systemach kaucyjnych — Lista Karty oceny opakowania w systemie kaucyjnym: rynek, format, pojemność, wyłączenia, uczestnictwo i dowody. Nie obsługują naliczania, pobierania ani zwrotu pieniędzy, automatów ani rozliczeń operatora. Pobierz listę rekordów dostępnych dla organizacji klucza. Zakres klucza: ppwr:read. Uprawnienie w organizacji: reports.view. Lista używa `per_page` (1–100, domyślnie 50) i kursora. Następne żądanie wykonaj pod adresem `links.next`; null kończy listę. Stosuj tylko filtry wymienione w parametrach tej metody. #### POST /organizations/{organizationId}/ppwr/deposit-schemes Oceny opakowań w systemach kaucyjnych — Dodaj Karty oceny opakowania w systemie kaucyjnym: rynek, format, pojemność, wyłączenia, uczestnictwo i dowody. Nie obsługują naliczania, pobierania ani zwrotu pieniędzy, automatów ani rozliczeń operatora. Utwórz rekord z danych opisanych w requestBody. Odpowiedź zawiera publiczne id do dalszego odczytu i powiązań. Dla rejestru technicznego: przygotuj opakowanie lub rekord nadrzędny, wymagane wersje dokumentów i datę oceny; utwórz wpis, pobierz jego UUID, a następnie użyj /review, jeżeli ta metoda istnieje. Źródła muszą spełniać warunki danego rejestru. Decyzja może wymagać innego recenzenta; 403/422 nie oznacza, że klucz technicznie nie działa. Zapis ani zatwierdzenie nie zastępują opublikowanej metodyki oceny. Zakres klucza: ppwr:write. Uprawnienie w organizacji: reports.export. Ta operacja wymaga `Idempotency-Key`. Ponowienie: ta sama metoda, ścieżka, klucz i dane. Nową operację oznacz nowym kluczem; nie obchodź konfliktu przez losowanie klucza bez sprawdzenia poprzedniego wyniku. #### GET /organizations/{organizationId}/ppwr/deposit-schemes/{recordId} Oceny opakowań w systemach kaucyjnych — Szczegóły Karty oceny opakowania w systemie kaucyjnym: rynek, format, pojemność, wyłączenia, uczestnictwo i dowody. Nie obsługują naliczania, pobierania ani zwrotu pieniędzy, automatów ani rozliczeń operatora. Pobierz szczegóły istniejącego rekordu. UUID weź z listy lub odpowiedzi tworzenia tego samego rodzaju zasobu. Zakres klucza: ppwr:read. Uprawnienie w organizacji: reports.view. #### POST /organizations/{organizationId}/ppwr/deposit-schemes/{recordId}/review Oceny opakowań w systemach kaucyjnych — Przegląd Karty oceny opakowania w systemie kaucyjnym: rynek, format, pojemność, wyłączenia, uczestnictwo i dowody. Nie obsługują naliczania, pobierania ani zwrotu pieniędzy, automatów ani rozliczeń operatora. Zapisz decyzję przeglądu i uzasadnienie. Pobierz później szczegóły, aby sprawdzić status. Decyzja jest zapisem wewnętrznym tego rejestru. Dla rejestru technicznego: przygotuj opakowanie lub rekord nadrzędny, wymagane wersje dokumentów i datę oceny; utwórz wpis, pobierz jego UUID, a następnie użyj /review, jeżeli ta metoda istnieje. Źródła muszą spełniać warunki danego rejestru. Decyzja może wymagać innego recenzenta; 403/422 nie oznacza, że klucz technicznie nie działa. Zapis ani zatwierdzenie nie zastępują opublikowanej metodyki oceny. Zakres klucza: ppwr:review. Uprawnienie w organizacji: evidence.review. Ta operacja wymaga `Idempotency-Key`. Ponowienie: ta sama metoda, ścieżka, klucz i dane. Nową operację oznacz nowym kluczem; nie obchodź konfliktu przez losowanie klucza bez sprawdzenia poprzedniego wyniku. #### GET /organizations/{organizationId}/ppwr/end-user-information Informacje dla odbiorców — Lista Rejestr informacji przekazywanych odbiorcom: treść, temat, kanał, język i dowód. Nie jest usługą masowego wysyłania kampanii. Pobierz listę rekordów dostępnych dla organizacji klucza. Zakres klucza: ppwr:read. Uprawnienie w organizacji: reports.view. Lista używa `per_page` (1–100, domyślnie 50) i kursora. Następne żądanie wykonaj pod adresem `links.next`; null kończy listę. Stosuj tylko filtry wymienione w parametrach tej metody. #### POST /organizations/{organizationId}/ppwr/end-user-information Informacje dla odbiorców — Dodaj Rejestr informacji przekazywanych odbiorcom: treść, temat, kanał, język i dowód. Nie jest usługą masowego wysyłania kampanii. Utwórz rekord z danych opisanych w requestBody. Odpowiedź zawiera publiczne id do dalszego odczytu i powiązań. Dla rejestru technicznego: przygotuj opakowanie lub rekord nadrzędny, wymagane wersje dokumentów i datę oceny; utwórz wpis, pobierz jego UUID, a następnie użyj /review, jeżeli ta metoda istnieje. Źródła muszą spełniać warunki danego rejestru. Decyzja może wymagać innego recenzenta; 403/422 nie oznacza, że klucz technicznie nie działa. Zapis ani zatwierdzenie nie zastępują opublikowanej metodyki oceny. Zakres klucza: ppwr:write. Uprawnienie w organizacji: reports.export. Ta operacja wymaga `Idempotency-Key`. Ponowienie: ta sama metoda, ścieżka, klucz i dane. Nową operację oznacz nowym kluczem; nie obchodź konfliktu przez losowanie klucza bez sprawdzenia poprzedniego wyniku. #### GET /organizations/{organizationId}/ppwr/end-user-information/{recordId} Informacje dla odbiorców — Szczegóły Rejestr informacji przekazywanych odbiorcom: treść, temat, kanał, język i dowód. Nie jest usługą masowego wysyłania kampanii. Pobierz szczegóły istniejącego rekordu. UUID weź z listy lub odpowiedzi tworzenia tego samego rodzaju zasobu. Zakres klucza: ppwr:read. Uprawnienie w organizacji: reports.view. #### POST /organizations/{organizationId}/ppwr/end-user-information/{recordId}/review Informacje dla odbiorców — Przegląd Rejestr informacji przekazywanych odbiorcom: treść, temat, kanał, język i dowód. Nie jest usługą masowego wysyłania kampanii. Zapisz decyzję przeglądu i uzasadnienie. Pobierz później szczegóły, aby sprawdzić status. Decyzja jest zapisem wewnętrznym tego rejestru. Dla rejestru technicznego: przygotuj opakowanie lub rekord nadrzędny, wymagane wersje dokumentów i datę oceny; utwórz wpis, pobierz jego UUID, a następnie użyj /review, jeżeli ta metoda istnieje. Źródła muszą spełniać warunki danego rejestru. Decyzja może wymagać innego recenzenta; 403/422 nie oznacza, że klucz technicznie nie działa. Zapis ani zatwierdzenie nie zastępują opublikowanej metodyki oceny. Zakres klucza: ppwr:review. Uprawnienie w organizacji: evidence.review. Ta operacja wymaga `Idempotency-Key`. Ponowienie: ta sama metoda, ścieżka, klucz i dane. Nową operację oznacz nowym kluczem; nie obchodź konfliktu przez losowanie klucza bez sprawdzenia poprzedniego wyniku. #### GET /organizations/{organizationId}/ppwr/horeca HoReCa — Lista Oceny dotyczące sprzedaży i pakowania w gastronomii, wraz z zakresem działalności i wyjątkami. To rejestr dokumentacyjny, nie system POS. Pobierz listę rekordów dostępnych dla organizacji klucza. Zakres klucza: ppwr:read. Uprawnienie w organizacji: reports.view. Lista używa `per_page` (1–100, domyślnie 50) i kursora. Następne żądanie wykonaj pod adresem `links.next`; null kończy listę. Stosuj tylko filtry wymienione w parametrach tej metody. #### POST /organizations/{organizationId}/ppwr/horeca HoReCa — Dodaj Oceny dotyczące sprzedaży i pakowania w gastronomii, wraz z zakresem działalności i wyjątkami. To rejestr dokumentacyjny, nie system POS. Utwórz rekord z danych opisanych w requestBody. Odpowiedź zawiera publiczne id do dalszego odczytu i powiązań. Dla rejestru technicznego: przygotuj opakowanie lub rekord nadrzędny, wymagane wersje dokumentów i datę oceny; utwórz wpis, pobierz jego UUID, a następnie użyj /review, jeżeli ta metoda istnieje. Źródła muszą spełniać warunki danego rejestru. Decyzja może wymagać innego recenzenta; 403/422 nie oznacza, że klucz technicznie nie działa. Zapis ani zatwierdzenie nie zastępują opublikowanej metodyki oceny. Zakres klucza: ppwr:write. Uprawnienie w organizacji: reports.export. Ta operacja wymaga `Idempotency-Key`. Ponowienie: ta sama metoda, ścieżka, klucz i dane. Nową operację oznacz nowym kluczem; nie obchodź konfliktu przez losowanie klucza bez sprawdzenia poprzedniego wyniku. #### GET /organizations/{organizationId}/ppwr/horeca/{recordId} HoReCa — Szczegóły Oceny dotyczące sprzedaży i pakowania w gastronomii, wraz z zakresem działalności i wyjątkami. To rejestr dokumentacyjny, nie system POS. Pobierz szczegóły istniejącego rekordu. UUID weź z listy lub odpowiedzi tworzenia tego samego rodzaju zasobu. Zakres klucza: ppwr:read. Uprawnienie w organizacji: reports.view. #### POST /organizations/{organizationId}/ppwr/horeca/{recordId}/review HoReCa — Przegląd Oceny dotyczące sprzedaży i pakowania w gastronomii, wraz z zakresem działalności i wyjątkami. To rejestr dokumentacyjny, nie system POS. Zapisz decyzję przeglądu i uzasadnienie. Pobierz później szczegóły, aby sprawdzić status. Decyzja jest zapisem wewnętrznym tego rejestru. Dla rejestru technicznego: przygotuj opakowanie lub rekord nadrzędny, wymagane wersje dokumentów i datę oceny; utwórz wpis, pobierz jego UUID, a następnie użyj /review, jeżeli ta metoda istnieje. Źródła muszą spełniać warunki danego rejestru. Decyzja może wymagać innego recenzenta; 403/422 nie oznacza, że klucz technicznie nie działa. Zapis ani zatwierdzenie nie zastępują opublikowanej metodyki oceny. Zakres klucza: ppwr:review. Uprawnienie w organizacji: evidence.review. Ta operacja wymaga `Idempotency-Key`. Ponowienie: ta sama metoda, ścieżka, klucz i dane. Nową operację oznacz nowym kluczem; nie obchodź konfliktu przez losowanie klucza bez sprawdzenia poprzedniego wyniku. ### Raporty, ROP, BDO i recyklat 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. #### POST /organizations/{organizationId}/bdo-reports Raporty BDO — Dodaj 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. Utwórz utrwalony raport ze źródeł i kwalifikacji dla roku. Odpowiedź 201 zwraca ReportRun ze statusem prepared albo needs_review, nie queued. settlement_mode określa sposób rozliczenia; not_calculated nie wylicza opłaty. Wskazanie źródeł i danych rozliczeniowych nie wykonuje wysyłki do BDO. Zakres klucza: reports:run. Uprawnienie w organizacji: reports.export. Ta operacja wymaga `Idempotency-Key`. Ponowienie: ta sama metoda, ścieżka, klucz i dane. Nową operację oznacz nowym kluczem; nie obchodź konfliktu przez losowanie klucza bez sprawdzenia poprzedniego wyniku. #### POST /organizations/{organizationId}/bdo-reports/classifications Raporty BDO — Klasyfikuj 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. Przypisz kwalifikację źródła do raportowania. Nie zmienia wcześniej utrwalonego raportu; dla zmienionych kwalifikacji utwórz nowy raport. sources zawiera klucze flow:UUID albo supply:UUID z GET sources; nie same UUID kart opakowań. Zakres klucza: reports:run. Uprawnienie w organizacji: reports.export. Ta operacja wymaga `Idempotency-Key`. Ponowienie: ta sama metoda, ścieżka, klucz i dane. Nową operację oznacz nowym kluczem; nie obchodź konfliktu przez losowanie klucza bez sprawdzenia poprzedniego wyniku. #### GET /organizations/{organizationId}/bdo-reports/sources Raporty BDO — Dane źródłowe 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. Pobierz dane źródłowe dla wskazanego okresu; sprawdź parametry stronicowania tej operacji. Zakres klucza: reports:read. Uprawnienie w organizacji: reports.view. #### GET /organizations/{organizationId}/bdo-reports/{recordId} Raporty BDO — Zapisany stan 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. Pobierz utrwalony stan danych powiązany z tym zapisem. Bieżące zmiany kartotek nie przeliczają automatycznie tego wyniku. Zakres klucza: reports:read. Uprawnienie w organizacji: reports.view. #### GET /organizations/{organizationId}/bdo-reports/{recordId}/download Raporty BDO — Pobierz 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. Pobierz plik jako odpowiedź binarną, nie JSON. Błąd zwracany jest nadal w formacie JSON; najpierw sprawdź status HTTP i Content-Type. Zakres klucza: reports:read. Uprawnienie w organizacji: reports.export. #### GET /organizations/{organizationId}/ppwr/epr-authorizations Zezwolenia ROP — Lista Rejestr zezwoleń dotyczących odpowiedzialności producenta i ich dowodów. Zapis nie wysyła wniosku do urzędu i nie wydaje zezwolenia. Pobierz listę rekordów dostępnych dla organizacji klucza. Zakres klucza: ppwr:read. Uprawnienie w organizacji: reports.view. Lista używa `per_page` (1–100, domyślnie 50) i kursora. Następne żądanie wykonaj pod adresem `links.next`; null kończy listę. Stosuj tylko filtry wymienione w parametrach tej metody. #### POST /organizations/{organizationId}/ppwr/epr-authorizations Zezwolenia ROP — Dodaj Rejestr zezwoleń dotyczących odpowiedzialności producenta i ich dowodów. Zapis nie wysyła wniosku do urzędu i nie wydaje zezwolenia. Utwórz rekord z danych opisanych w requestBody. Odpowiedź zawiera publiczne id do dalszego odczytu i powiązań. Dla rejestru technicznego: przygotuj opakowanie lub rekord nadrzędny, wymagane wersje dokumentów i datę oceny; utwórz wpis, pobierz jego UUID, a następnie użyj /review, jeżeli ta metoda istnieje. Źródła muszą spełniać warunki danego rejestru. Decyzja może wymagać innego recenzenta; 403/422 nie oznacza, że klucz technicznie nie działa. Zapis ani zatwierdzenie nie zastępują opublikowanej metodyki oceny. Zakres klucza: ppwr:write. Uprawnienie w organizacji: reports.export. Ta operacja wymaga `Idempotency-Key`. Ponowienie: ta sama metoda, ścieżka, klucz i dane. Nową operację oznacz nowym kluczem; nie obchodź konfliktu przez losowanie klucza bez sprawdzenia poprzedniego wyniku. #### GET /organizations/{organizationId}/ppwr/epr-authorizations/{recordId} Zezwolenia ROP — Szczegóły Rejestr zezwoleń dotyczących odpowiedzialności producenta i ich dowodów. Zapis nie wysyła wniosku do urzędu i nie wydaje zezwolenia. Pobierz szczegóły istniejącego rekordu. UUID weź z listy lub odpowiedzi tworzenia tego samego rodzaju zasobu. Zakres klucza: ppwr:read. Uprawnienie w organizacji: reports.view. #### POST /organizations/{organizationId}/ppwr/epr-authorizations/{recordId}/review Zezwolenia ROP — Przegląd Rejestr zezwoleń dotyczących odpowiedzialności producenta i ich dowodów. Zapis nie wysyła wniosku do urzędu i nie wydaje zezwolenia. Zapisz decyzję przeglądu i uzasadnienie. Pobierz później szczegóły, aby sprawdzić status. Decyzja jest zapisem wewnętrznym tego rejestru. Dla rejestru technicznego: przygotuj opakowanie lub rekord nadrzędny, wymagane wersje dokumentów i datę oceny; utwórz wpis, pobierz jego UUID, a następnie użyj /review, jeżeli ta metoda istnieje. Źródła muszą spełniać warunki danego rejestru. Decyzja może wymagać innego recenzenta; 403/422 nie oznacza, że klucz technicznie nie działa. Zapis ani zatwierdzenie nie zastępują opublikowanej metodyki oceny. Zakres klucza: ppwr:review. Uprawnienie w organizacji: evidence.review. Ta operacja wymaga `Idempotency-Key`. Ponowienie: ta sama metoda, ścieżka, klucz i dane. Nową operację oznacz nowym kluczem; nie obchodź konfliktu przez losowanie klucza bez sprawdzenia poprzedniego wyniku. #### GET /organizations/{organizationId}/ppwr/epr-registrations Rejestracje ROP — Lista Rejestracje producenta dla rynku: identyfikacja, zakres, okres i dokumenty. Odrębne od utworzenia organizacji czy konta użytkownika w PPWR Link. Pobierz listę rekordów dostępnych dla organizacji klucza. Zakres klucza: ppwr:read. Uprawnienie w organizacji: reports.view. Lista używa `per_page` (1–100, domyślnie 50) i kursora. Następne żądanie wykonaj pod adresem `links.next`; null kończy listę. Stosuj tylko filtry wymienione w parametrach tej metody. #### POST /organizations/{organizationId}/ppwr/epr-registrations Rejestracje ROP — Dodaj Rejestracje producenta dla rynku: identyfikacja, zakres, okres i dokumenty. Odrębne od utworzenia organizacji czy konta użytkownika w PPWR Link. Utwórz rekord z danych opisanych w requestBody. Odpowiedź zawiera publiczne id do dalszego odczytu i powiązań. Dla rejestru technicznego: przygotuj opakowanie lub rekord nadrzędny, wymagane wersje dokumentów i datę oceny; utwórz wpis, pobierz jego UUID, a następnie użyj /review, jeżeli ta metoda istnieje. Źródła muszą spełniać warunki danego rejestru. Decyzja może wymagać innego recenzenta; 403/422 nie oznacza, że klucz technicznie nie działa. Zapis ani zatwierdzenie nie zastępują opublikowanej metodyki oceny. Zakres klucza: ppwr:write. Uprawnienie w organizacji: reports.export. Ta operacja wymaga `Idempotency-Key`. Ponowienie: ta sama metoda, ścieżka, klucz i dane. Nową operację oznacz nowym kluczem; nie obchodź konfliktu przez losowanie klucza bez sprawdzenia poprzedniego wyniku. #### GET /organizations/{organizationId}/ppwr/epr-registrations/{recordId} Rejestracje ROP — Szczegóły Rejestracje producenta dla rynku: identyfikacja, zakres, okres i dokumenty. Odrębne od utworzenia organizacji czy konta użytkownika w PPWR Link. Pobierz szczegóły istniejącego rekordu. UUID weź z listy lub odpowiedzi tworzenia tego samego rodzaju zasobu. Zakres klucza: ppwr:read. Uprawnienie w organizacji: reports.view. #### POST /organizations/{organizationId}/ppwr/epr-registrations/{recordId}/review Rejestracje ROP — Przegląd Rejestracje producenta dla rynku: identyfikacja, zakres, okres i dokumenty. Odrębne od utworzenia organizacji czy konta użytkownika w PPWR Link. Zapisz decyzję przeglądu i uzasadnienie. Pobierz później szczegóły, aby sprawdzić status. Decyzja jest zapisem wewnętrznym tego rejestru. Dla rejestru technicznego: przygotuj opakowanie lub rekord nadrzędny, wymagane wersje dokumentów i datę oceny; utwórz wpis, pobierz jego UUID, a następnie użyj /review, jeżeli ta metoda istnieje. Źródła muszą spełniać warunki danego rejestru. Decyzja może wymagać innego recenzenta; 403/422 nie oznacza, że klucz technicznie nie działa. Zapis ani zatwierdzenie nie zastępują opublikowanej metodyki oceny. Zakres klucza: ppwr:review. Uprawnienie w organizacji: evidence.review. Ta operacja wymaga `Idempotency-Key`. Ponowienie: ta sama metoda, ścieżka, klucz i dane. Nową operację oznacz nowym kluczem; nie obchodź konfliktu przez losowanie klucza bez sprawdzenia poprzedniego wyniku. #### GET /organizations/{organizationId}/ppwr/epr-reports Sprawozdania ROP — Lista Roczne sprawozdania ROP z pozycjami i przeglądem. Eksport wykorzystuje zapisany wynik; nie oznacza złożenia w krajowym portalu. Pobierz listę rekordów dostępnych dla organizacji klucza. Zakres klucza: ppwr:read. Uprawnienie w organizacji: reports.view. Lista używa `per_page` (1–100, domyślnie 50) i kursora. Następne żądanie wykonaj pod adresem `links.next`; null kończy listę. Stosuj tylko filtry wymienione w parametrach tej metody. #### POST /organizations/{organizationId}/ppwr/epr-reports Sprawozdania ROP — Dodaj Roczne sprawozdania ROP z pozycjami i przeglądem. Eksport wykorzystuje zapisany wynik; nie oznacza złożenia w krajowym portalu. Utwórz rekord z danych opisanych w requestBody. Odpowiedź zawiera publiczne id do dalszego odczytu i powiązań. Dla rejestru technicznego: przygotuj opakowanie lub rekord nadrzędny, wymagane wersje dokumentów i datę oceny; utwórz wpis, pobierz jego UUID, a następnie użyj /review, jeżeli ta metoda istnieje. Źródła muszą spełniać warunki danego rejestru. Decyzja może wymagać innego recenzenta; 403/422 nie oznacza, że klucz technicznie nie działa. Zapis ani zatwierdzenie nie zastępują opublikowanej metodyki oceny. Zakres klucza: ppwr:write. Uprawnienie w organizacji: reports.export. Ta operacja wymaga `Idempotency-Key`. Ponowienie: ta sama metoda, ścieżka, klucz i dane. Nową operację oznacz nowym kluczem; nie obchodź konfliktu przez losowanie klucza bez sprawdzenia poprzedniego wyniku. #### GET /organizations/{organizationId}/ppwr/epr-reports/{parentId}/lines Pozycje sprawozdań ROP — Lista Kategorie i masy rocznego sprawozdania ROP. parentId jest UUID sprawozdania. Uzupełnij pozycje przed przeglądem sprawozdania. Pobierz listę rekordów dostępnych dla organizacji klucza. Zakres klucza: ppwr:read. Uprawnienie w organizacji: reports.view. Lista używa `per_page` (1–100, domyślnie 50) i kursora. Następne żądanie wykonaj pod adresem `links.next`; null kończy listę. Stosuj tylko filtry wymienione w parametrach tej metody. #### POST /organizations/{organizationId}/ppwr/epr-reports/{parentId}/lines Pozycje sprawozdań ROP — Dodaj Kategorie i masy rocznego sprawozdania ROP. parentId jest UUID sprawozdania. Uzupełnij pozycje przed przeglądem sprawozdania. Utwórz rekord z danych opisanych w requestBody. Odpowiedź zawiera publiczne id do dalszego odczytu i powiązań. Dla rejestru technicznego: przygotuj opakowanie lub rekord nadrzędny, wymagane wersje dokumentów i datę oceny; utwórz wpis, pobierz jego UUID, a następnie użyj /review, jeżeli ta metoda istnieje. Źródła muszą spełniać warunki danego rejestru. Decyzja może wymagać innego recenzenta; 403/422 nie oznacza, że klucz technicznie nie działa. Zapis ani zatwierdzenie nie zastępują opublikowanej metodyki oceny. Zakres klucza: ppwr:write. Uprawnienie w organizacji: reports.export. Ta operacja wymaga `Idempotency-Key`. Ponowienie: ta sama metoda, ścieżka, klucz i dane. Nową operację oznacz nowym kluczem; nie obchodź konfliktu przez losowanie klucza bez sprawdzenia poprzedniego wyniku. #### GET /organizations/{organizationId}/ppwr/epr-reports/{parentId}/lines/{recordId} Pozycje sprawozdań ROP — Szczegóły Kategorie i masy rocznego sprawozdania ROP. parentId jest UUID sprawozdania. Uzupełnij pozycje przed przeglądem sprawozdania. Pobierz szczegóły istniejącego rekordu. UUID weź z listy lub odpowiedzi tworzenia tego samego rodzaju zasobu. Zakres klucza: ppwr:read. Uprawnienie w organizacji: reports.view. #### GET /organizations/{organizationId}/ppwr/epr-reports/{recordId} Sprawozdania ROP — Szczegóły Roczne sprawozdania ROP z pozycjami i przeglądem. Eksport wykorzystuje zapisany wynik; nie oznacza złożenia w krajowym portalu. Pobierz szczegóły istniejącego rekordu. UUID weź z listy lub odpowiedzi tworzenia tego samego rodzaju zasobu. Zakres klucza: ppwr:read. Uprawnienie w organizacji: reports.view. #### GET /organizations/{organizationId}/ppwr/epr-reports/{recordId}/export Sprawozdania ROP — Pobierz Roczne sprawozdania ROP z pozycjami i przeglądem. Eksport wykorzystuje zapisany wynik; nie oznacza złożenia w krajowym portalu. Pobierz plik jako odpowiedź binarną, nie JSON. Błąd zwracany jest nadal w formacie JSON; najpierw sprawdź status HTTP i Content-Type. Zakres klucza: reports:read. Uprawnienie w organizacji: reports.export. #### POST /organizations/{organizationId}/ppwr/epr-reports/{recordId}/review Sprawozdania ROP — Przegląd Roczne sprawozdania ROP z pozycjami i przeglądem. Eksport wykorzystuje zapisany wynik; nie oznacza złożenia w krajowym portalu. Zapisz decyzję przeglądu i uzasadnienie. Pobierz później szczegóły, aby sprawdzić status. Decyzja jest zapisem wewnętrznym tego rejestru. Dla rejestru technicznego: przygotuj opakowanie lub rekord nadrzędny, wymagane wersje dokumentów i datę oceny; utwórz wpis, pobierz jego UUID, a następnie użyj /review, jeżeli ta metoda istnieje. Źródła muszą spełniać warunki danego rejestru. Decyzja może wymagać innego recenzenta; 403/422 nie oznacza, że klucz technicznie nie działa. Zapis ani zatwierdzenie nie zastępują opublikowanej metodyki oceny. Zakres klucza: ppwr:review. Uprawnienie w organizacji: evidence.review. Ta operacja wymaga `Idempotency-Key`. Ponowienie: ta sama metoda, ścieżka, klucz i dane. Nową operację oznacz nowym kluczem; nie obchodź konfliktu przez losowanie klucza bez sprawdzenia poprzedniego wyniku. #### GET /organizations/{organizationId}/ppwr/plant-year-pcr Recyklat w zakładzie — Lista Roczny zapis zawartości recyklatu na poziomie zakładu z masami i dowodami. Nie jest stanem magazynowym recyklatu ani pełnym ERP produkcji. Pobierz listę rekordów dostępnych dla organizacji klucza. Zakres klucza: ppwr:read. Uprawnienie w organizacji: reports.view. Lista używa `per_page` (1–100, domyślnie 50) i kursora. Następne żądanie wykonaj pod adresem `links.next`; null kończy listę. Stosuj tylko filtry wymienione w parametrach tej metody. #### POST /organizations/{organizationId}/ppwr/plant-year-pcr Recyklat w zakładzie — Dodaj Roczny zapis zawartości recyklatu na poziomie zakładu z masami i dowodami. Nie jest stanem magazynowym recyklatu ani pełnym ERP produkcji. Utwórz rekord z danych opisanych w requestBody. Odpowiedź zawiera publiczne id do dalszego odczytu i powiązań. Dla rejestru technicznego: przygotuj opakowanie lub rekord nadrzędny, wymagane wersje dokumentów i datę oceny; utwórz wpis, pobierz jego UUID, a następnie użyj /review, jeżeli ta metoda istnieje. Źródła muszą spełniać warunki danego rejestru. Decyzja może wymagać innego recenzenta; 403/422 nie oznacza, że klucz technicznie nie działa. Zapis ani zatwierdzenie nie zastępują opublikowanej metodyki oceny. Zakres klucza: ppwr:write. Uprawnienie w organizacji: reports.export. Ta operacja wymaga `Idempotency-Key`. Ponowienie: ta sama metoda, ścieżka, klucz i dane. Nową operację oznacz nowym kluczem; nie obchodź konfliktu przez losowanie klucza bez sprawdzenia poprzedniego wyniku. #### GET /organizations/{organizationId}/ppwr/plant-year-pcr/{recordId} Recyklat w zakładzie — Szczegóły Roczny zapis zawartości recyklatu na poziomie zakładu z masami i dowodami. Nie jest stanem magazynowym recyklatu ani pełnym ERP produkcji. Pobierz szczegóły istniejącego rekordu. UUID weź z listy lub odpowiedzi tworzenia tego samego rodzaju zasobu. Zakres klucza: ppwr:read. Uprawnienie w organizacji: reports.view. #### POST /organizations/{organizationId}/ppwr/plant-year-pcr/{recordId}/review Recyklat w zakładzie — Przegląd Roczny zapis zawartości recyklatu na poziomie zakładu z masami i dowodami. Nie jest stanem magazynowym recyklatu ani pełnym ERP produkcji. Zapisz decyzję przeglądu i uzasadnienie. Pobierz później szczegóły, aby sprawdzić status. Decyzja jest zapisem wewnętrznym tego rejestru. Dla rejestru technicznego: przygotuj opakowanie lub rekord nadrzędny, wymagane wersje dokumentów i datę oceny; utwórz wpis, pobierz jego UUID, a następnie użyj /review, jeżeli ta metoda istnieje. Źródła muszą spełniać warunki danego rejestru. Decyzja może wymagać innego recenzenta; 403/422 nie oznacza, że klucz technicznie nie działa. Zapis ani zatwierdzenie nie zastępują opublikowanej metodyki oceny. Zakres klucza: ppwr:review. Uprawnienie w organizacji: evidence.review. Ta operacja wymaga `Idempotency-Key`. Ponowienie: ta sama metoda, ścieżka, klucz i dane. Nową operację oznacz nowym kluczem; nie obchodź konfliktu przez losowanie klucza bez sprawdzenia poprzedniego wyniku. #### GET /organizations/{organizationId}/ppwr/waste-reports Raporty odpadów — Lista Okresowe raporty gospodarki odpadami z pozycjami, dowodami i przeglądem. Eksport wymaga określenia odbiorcy authority albo producer. Pobierz listę rekordów dostępnych dla organizacji klucza. Zakres klucza: ppwr:read. Uprawnienie w organizacji: reports.view. Lista używa `per_page` (1–100, domyślnie 50) i kursora. Następne żądanie wykonaj pod adresem `links.next`; null kończy listę. Stosuj tylko filtry wymienione w parametrach tej metody. #### POST /organizations/{organizationId}/ppwr/waste-reports Raporty odpadów — Dodaj Okresowe raporty gospodarki odpadami z pozycjami, dowodami i przeglądem. Eksport wymaga określenia odbiorcy authority albo producer. Utwórz rekord z danych opisanych w requestBody. Odpowiedź zawiera publiczne id do dalszego odczytu i powiązań. Dla rejestru technicznego: przygotuj opakowanie lub rekord nadrzędny, wymagane wersje dokumentów i datę oceny; utwórz wpis, pobierz jego UUID, a następnie użyj /review, jeżeli ta metoda istnieje. Źródła muszą spełniać warunki danego rejestru. Decyzja może wymagać innego recenzenta; 403/422 nie oznacza, że klucz technicznie nie działa. Zapis ani zatwierdzenie nie zastępują opublikowanej metodyki oceny. Zakres klucza: ppwr:write. Uprawnienie w organizacji: reports.export. Ta operacja wymaga `Idempotency-Key`. Ponowienie: ta sama metoda, ścieżka, klucz i dane. Nową operację oznacz nowym kluczem; nie obchodź konfliktu przez losowanie klucza bez sprawdzenia poprzedniego wyniku. #### GET /organizations/{organizationId}/ppwr/waste-reports/{parentId}/lines Pozycje raportów odpadów — Lista Pozycje raportu odpadów powiązane z parentId raportu. Nie są kartą przekazania odpadu w zewnętrznym systemie BDO. Pobierz listę rekordów dostępnych dla organizacji klucza. Zakres klucza: ppwr:read. Uprawnienie w organizacji: reports.view. Lista używa `per_page` (1–100, domyślnie 50) i kursora. Następne żądanie wykonaj pod adresem `links.next`; null kończy listę. Stosuj tylko filtry wymienione w parametrach tej metody. #### POST /organizations/{organizationId}/ppwr/waste-reports/{parentId}/lines Pozycje raportów odpadów — Dodaj Pozycje raportu odpadów powiązane z parentId raportu. Nie są kartą przekazania odpadu w zewnętrznym systemie BDO. Utwórz rekord z danych opisanych w requestBody. Odpowiedź zawiera publiczne id do dalszego odczytu i powiązań. Dla rejestru technicznego: przygotuj opakowanie lub rekord nadrzędny, wymagane wersje dokumentów i datę oceny; utwórz wpis, pobierz jego UUID, a następnie użyj /review, jeżeli ta metoda istnieje. Źródła muszą spełniać warunki danego rejestru. Decyzja może wymagać innego recenzenta; 403/422 nie oznacza, że klucz technicznie nie działa. Zapis ani zatwierdzenie nie zastępują opublikowanej metodyki oceny. Zakres klucza: ppwr:write. Uprawnienie w organizacji: reports.export. Ta operacja wymaga `Idempotency-Key`. Ponowienie: ta sama metoda, ścieżka, klucz i dane. Nową operację oznacz nowym kluczem; nie obchodź konfliktu przez losowanie klucza bez sprawdzenia poprzedniego wyniku. #### GET /organizations/{organizationId}/ppwr/waste-reports/{parentId}/lines/{recordId} Pozycje raportów odpadów — Szczegóły Pozycje raportu odpadów powiązane z parentId raportu. Nie są kartą przekazania odpadu w zewnętrznym systemie BDO. Pobierz szczegóły istniejącego rekordu. UUID weź z listy lub odpowiedzi tworzenia tego samego rodzaju zasobu. Zakres klucza: ppwr:read. Uprawnienie w organizacji: reports.view. #### GET /organizations/{organizationId}/ppwr/waste-reports/{recordId} Raporty odpadów — Szczegóły Okresowe raporty gospodarki odpadami z pozycjami, dowodami i przeglądem. Eksport wymaga określenia odbiorcy authority albo producer. Pobierz szczegóły istniejącego rekordu. UUID weź z listy lub odpowiedzi tworzenia tego samego rodzaju zasobu. Zakres klucza: ppwr:read. Uprawnienie w organizacji: reports.view. #### GET /organizations/{organizationId}/ppwr/waste-reports/{recordId}/export Raporty odpadów — Pobierz Okresowe raporty gospodarki odpadami z pozycjami, dowodami i przeglądem. Eksport wymaga określenia odbiorcy authority albo producer. Pobierz plik jako odpowiedź binarną, nie JSON. Błąd zwracany jest nadal w formacie JSON; najpierw sprawdź status HTTP i Content-Type. Zakres klucza: reports:read. Uprawnienie w organizacji: reports.export. #### POST /organizations/{organizationId}/ppwr/waste-reports/{recordId}/review Raporty odpadów — Przegląd Okresowe raporty gospodarki odpadami z pozycjami, dowodami i przeglądem. Eksport wymaga określenia odbiorcy authority albo producer. Zapisz decyzję przeglądu i uzasadnienie. Pobierz później szczegóły, aby sprawdzić status. Decyzja jest zapisem wewnętrznym tego rejestru. Dla rejestru technicznego: przygotuj opakowanie lub rekord nadrzędny, wymagane wersje dokumentów i datę oceny; utwórz wpis, pobierz jego UUID, a następnie użyj /review, jeżeli ta metoda istnieje. Źródła muszą spełniać warunki danego rejestru. Decyzja może wymagać innego recenzenta; 403/422 nie oznacza, że klucz technicznie nie działa. Zapis ani zatwierdzenie nie zastępują opublikowanej metodyki oceny. Zakres klucza: ppwr:review. Uprawnienie w organizacji: evidence.review. Ta operacja wymaga `Idempotency-Key`. Ponowienie: ta sama metoda, ścieżka, klucz i dane. Nową operację oznacz nowym kluczem; nie obchodź konfliktu przez losowanie klucza bez sprawdzenia poprzedniego wyniku. #### GET /organizations/{organizationId}/reports Raporty — Lista Eksporty katalogu, ocen i przepływów do CSV/XLSX. Zlecenie zamraża dane wejściowe, worker przygotowuje plik. Pobieraj dopiero po completed. Pobierz listę rekordów dostępnych dla organizacji klucza. Zakres klucza: reports:read. Uprawnienie w organizacji: reports.view. Lista używa `per_page` (1–100, domyślnie 50) i kursora. Następne żądanie wykonaj pod adresem `links.next`; null kończy listę. Stosuj tylko filtry wymienione w parametrach tej metody. #### POST /organizations/{organizationId}/reports Raporty — Dodaj Eksporty katalogu, ocen i przepływów do CSV/XLSX. Zlecenie zamraża dane wejściowe, worker przygotowuje plik. Pobieraj dopiero po completed. Zleć eksport typu catalog, assessments lub flows do CSV, albo wariantu z końcówką _xlsx. Zachowaj id, sprawdzaj GET /reports/{id}, a po completed pobierz /download. Zakres klucza: reports:run. Uprawnienie w organizacji: reports.export. Ta operacja wymaga `Idempotency-Key`. Ponowienie: ta sama metoda, ścieżka, klucz i dane. Nową operację oznacz nowym kluczem; nie obchodź konfliktu przez losowanie klucza bez sprawdzenia poprzedniego wyniku. Odpowiedź 202 potwierdza przyjęcie do kolejki. Pobieraj zasób GET według otrzymanego `id`, aż zakończy pracę; nie traktuj statusu `queued` jako gotowego pliku. #### GET /organizations/{organizationId}/reports/{recordId} Raporty — Szczegóły Eksporty katalogu, ocen i przepływów do CSV/XLSX. Zlecenie zamraża dane wejściowe, worker przygotowuje plik. Pobieraj dopiero po completed. Pobierz szczegóły istniejącego rekordu. UUID weź z listy lub odpowiedzi tworzenia tego samego rodzaju zasobu. Zakres klucza: reports:read. Uprawnienie w organizacji: reports.view. #### GET /organizations/{organizationId}/reports/{recordId}/download Raporty — Pobierz Eksporty katalogu, ocen i przepływów do CSV/XLSX. Zlecenie zamraża dane wejściowe, worker przygotowuje plik. Pobieraj dopiero po completed. Pobierz plik jako odpowiedź binarną, nie JSON. Błąd zwracany jest nadal w formacie JSON; najpierw sprawdź status HTTP i Content-Type. Zakres klucza: reports:read. Uprawnienie w organizacji: reports.export. ### Paszporty i dostęp odbiorców Dane/dowody → szkic → publikacja → grant odbiorcy. Nowa wersja wymaga osobnego dostępu. Subskrypcje i aktualizacje dotyczą użytkownika klucza; obserwowanie nie oznacza adopcji danych. #### GET /organizations/{organizationId}/passport-subscriptions Obserwowane paszporty — Lista Osobiste obserwowanie paszportu otrzymanego przez udostępnienie. Wymaga aktualnego dostępu i nie nadaje praw do przyszłych wersji. Pobierz listę rekordów dostępnych dla organizacji klucza. Zakres klucza: passports:read. Uprawnienie w organizacji: catalog.view. Lista używa `per_page` (1–100, domyślnie 50) i kursora. Następne żądanie wykonaj pod adresem `links.next`; null kończy listę. Stosuj tylko filtry wymienione w parametrach tej metody. #### POST /organizations/{organizationId}/passport-subscriptions/{recordId}/unsubscribe Obserwowane paszporty — Przestań obserwować Osobiste obserwowanie paszportu otrzymanego przez udostępnienie. Wymaga aktualnego dostępu i nie nadaje praw do przyszłych wersji. Wyłącz osobistą subskrypcję. Nie cofa udostępnienia nadanego przez właściciela paszportu. Zakres klucza: passports:write. Uprawnienie w organizacji: catalog.view. Ta operacja wymaga `Idempotency-Key`. Ponowienie: ta sama metoda, ścieżka, klucz i dane. Nową operację oznacz nowym kluczem; nie obchodź konfliktu przez losowanie klucza bez sprawdzenia poprzedniego wyniku. #### GET /organizations/{organizationId}/passport-subscriptions/{recordId}/updates Aktualizacje paszportów — Lista Zmiany paszportów obserwowanych przez użytkownika klucza. Odczyt sprawdza bieżący dostęp do porównywanych wersji; open oznacza odczyt aktualizacji. Pobierz listę rekordów dostępnych dla organizacji klucza. Zakres klucza: passports:read. Uprawnienie w organizacji: catalog.view. Lista używa `per_page` (1–100, domyślnie 50) i kursora. Następne żądanie wykonaj pod adresem `links.next`; null kończy listę. Stosuj tylko filtry wymienione w parametrach tej metody. #### GET /organizations/{organizationId}/passport-updates/{recordId} Aktualizacje paszportów — Szczegóły Zmiany paszportów obserwowanych przez użytkownika klucza. Odczyt sprawdza bieżący dostęp do porównywanych wersji; open oznacza odczyt aktualizacji. Pobierz szczegóły istniejącego rekordu. UUID weź z listy lub odpowiedzi tworzenia tego samego rodzaju zasobu. Zakres klucza: passports:read. Uprawnienie w organizacji: catalog.view. #### POST /organizations/{organizationId}/passport-updates/{recordId}/open Aktualizacje paszportów — Otwórz aktualizację Zmiany paszportów obserwowanych przez użytkownika klucza. Odczyt sprawdza bieżący dostęp do porównywanych wersji; open oznacza odczyt aktualizacji. Oznacz aktualizację jako otwartą i pobierz jej szczegóły, po sprawdzeniu dostępu. To nie akceptacja nowych danych do własnego katalogu. Zakres klucza: passports:write. Uprawnienie w organizacji: catalog.view. Ta operacja wymaga `Idempotency-Key`. Ponowienie: ta sama metoda, ścieżka, klucz i dane. Nową operację oznacz nowym kluczem; nie obchodź konfliktu przez losowanie klucza bez sprawdzenia poprzedniego wyniku. #### GET /organizations/{organizationId}/passports Paszporty — Lista Wersjonowany snapshot danych opakowania. Osobno tworzysz szkic, publikujesz i udostępniasz go organizacji. Udostępnienie jest odrębne od publikacji; nowa wersja nie dziedziczy automatycznie dostępu. Pobierz listę rekordów dostępnych dla organizacji klucza. Zakres klucza: passports:read. Uprawnienie w organizacji: catalog.view. Lista używa `per_page` (1–100, domyślnie 50) i kursora. Następne żądanie wykonaj pod adresem `links.next`; null kończy listę. Stosuj tylko filtry wymienione w parametrach tej metody. #### POST /organizations/{organizationId}/passports Paszporty — Dodaj Wersjonowany snapshot danych opakowania. Osobno tworzysz szkic, publikujesz i udostępniasz go organizacji. Udostępnienie jest odrębne od publikacji; nowa wersja nie dziedziczy automatycznie dostępu. Utwórz szkic ze snapshotem opakowania i zatwierdzonych danych. Zachowaj id paszportu; przed publikacją muszą być spełnione warunki aktualności i przeglądu. Zakres klucza: passports:write. Uprawnienie w organizacji: passports.manage. Ta operacja wymaga `Idempotency-Key`. Ponowienie: ta sama metoda, ścieżka, klucz i dane. Nową operację oznacz nowym kluczem; nie obchodź konfliktu przez losowanie klucza bez sprawdzenia poprzedniego wyniku. Przykład pokazuje strukturę. Zastąp UUID, rewizje, daty i configuration_hash rzeczywistymi wartościami; kody jednostek i materiałów muszą odpowiadać konfiguracji opakowania. ```json { "item": "11111111-1111-4111-8111-111111111111" } ``` #### GET /organizations/{organizationId}/passports/{recordId} Paszporty — Szczegóły Wersjonowany snapshot danych opakowania. Osobno tworzysz szkic, publikujesz i udostępniasz go organizacji. Udostępnienie jest odrębne od publikacji; nowa wersja nie dziedziczy automatycznie dostępu. Pobierz szczegóły istniejącego rekordu. UUID weź z listy lub odpowiedzi tworzenia tego samego rodzaju zasobu. Zakres klucza: passports:read. Uprawnienie w organizacji: catalog.view. #### POST /organizations/{organizationId}/passports/{recordId}/publish Paszporty — Publikuj Wersjonowany snapshot danych opakowania. Osobno tworzysz szkic, publikujesz i udostępniasz go organizacji. Udostępnienie jest odrębne od publikacji; nowa wersja nie dziedziczy automatycznie dostępu. Opublikuj szkic po kontroli dostępu, dowodów i aktualności podstawy. Zmiana danych od utworzenia szkicu może zablokować publikację; utwórz aktualny szkic zamiast nadpisywać stary snapshot. Zakres klucza: passports:write. Uprawnienie w organizacji: passports.manage. Ta operacja wymaga `Idempotency-Key`. Ponowienie: ta sama metoda, ścieżka, klucz i dane. Nową operację oznacz nowym kluczem; nie obchodź konfliktu przez losowanie klucza bez sprawdzenia poprzedniego wyniku. #### POST /organizations/{organizationId}/passports/{recordId}/shares Paszporty — Udostępnij Wersjonowany snapshot danych opakowania. Osobno tworzysz szkic, publikujesz i udostępniasz go organizacji. Udostępnienie jest odrębne od publikacji; nowa wersja nie dziedziczy automatycznie dostępu. Nadaj organizacji recipient dostęp do konkretnej wersji, z purpose, terminem i opcjami allow_download/allow_adoption. Nie jest to publiczna publikacja danych wszystkich odbiorców. Zakres klucza: passports:write. Uprawnienie w organizacji: sharing_grants.manage. Ta operacja wymaga `Idempotency-Key`. Ponowienie: ta sama metoda, ścieżka, klucz i dane. Nową operację oznacz nowym kluczem; nie obchodź konfliktu przez losowanie klucza bez sprawdzenia poprzedniego wyniku. #### GET /organizations/{organizationId}/passports/{recordId}/snapshot Paszporty — Zapisany stan Wersjonowany snapshot danych opakowania. Osobno tworzysz szkic, publikujesz i udostępniasz go organizacji. Udostępnienie jest odrębne od publikacji; nowa wersja nie dziedziczy automatycznie dostępu. Pobierz utrwalony stan danych powiązany z tym zapisem. Bieżące zmiany kartotek nie przeliczają automatycznie tego wyniku. Zakres klucza: passports:read. Uprawnienie w organizacji: passports.manage. #### POST /organizations/{organizationId}/received-passports/{recordId}/subscription Obserwowane paszporty — Dodaj Osobiste obserwowanie paszportu otrzymanego przez udostępnienie. Wymaga aktualnego dostępu i nie nadaje praw do przyszłych wersji. Obserwuj otrzymany paszport wskazany recordId. Identyfikator dotyczy otrzymanej wersji; operacja ponownie sprawdza jej aktywne udostępnienie. Zakres klucza: passports:write. Uprawnienie w organizacji: catalog.view. Ta operacja wymaga `Idempotency-Key`. Ponowienie: ta sama metoda, ścieżka, klucz i dane. Nową operację oznacz nowym kluczem; nie obchodź konfliktu przez losowanie klucza bez sprawdzenia poprzedniego wyniku. #### GET /organizations/{organizationId}/sharing-grants Udostępnienia paszportów — Lista Uprawnienia odbiorcy do konkretnej wersji paszportu z celem, terminem i opcjami pobrania/adopcji. Nie są rolami użytkowników w organizacji. Pobierz listę rekordów dostępnych dla organizacji klucza. Zakres klucza: passports:read. Uprawnienie w organizacji: sharing_grants.manage. Lista używa `per_page` (1–100, domyślnie 50) i kursora. Następne żądanie wykonaj pod adresem `links.next`; null kończy listę. Stosuj tylko filtry wymienione w parametrach tej metody. #### GET /organizations/{organizationId}/sharing-grants/{recordId} Udostępnienia paszportów — Szczegóły Uprawnienia odbiorcy do konkretnej wersji paszportu z celem, terminem i opcjami pobrania/adopcji. Nie są rolami użytkowników w organizacji. Pobierz szczegóły istniejącego rekordu. UUID weź z listy lub odpowiedzi tworzenia tego samego rodzaju zasobu. Zakres klucza: passports:read. Uprawnienie w organizacji: sharing_grants.manage. #### POST /organizations/{organizationId}/sharing-grants/{recordId}/revoke Paszporty — Cofnij dostęp Wersjonowany snapshot danych opakowania. Osobno tworzysz szkic, publikujesz i udostępniasz go organizacji. Udostępnienie jest odrębne od publikacji; nowa wersja nie dziedziczy automatycznie dostępu. Cofnij grant wskazany recordId. Nie usuwa paszportu ani historii, ale blokuje dalszy dostęp przez to udostępnienie. Zakres klucza: passports:write. Uprawnienie w organizacji: sharing_grants.manage. Ta operacja wymaga `Idempotency-Key`. Ponowienie: ta sama metoda, ścieżka, klucz i dane. Nową operację oznacz nowym kluczem; nie obchodź konfliktu przez losowanie klucza bez sprawdzenia poprzedniego wyniku. ### Współczynniki i ślad materiałów 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. #### GET /organizations/{organizationId}/carbon-calculations Obliczenia śladu węglowego — Lista Kalkulacja śladu pozyskania materiałów dla opakowania lub zestawu z jawnymi współczynnikami. To nie pełne LCA transportu, energii i końca życia. incomplete ma total_kg_co2e=null. Pobierz listę rekordów dostępnych dla organizacji klucza. Zakres klucza: reports:read. Uprawnienie w organizacji: reports.view. Lista używa `per_page` (1–100, domyślnie 50) i kursora. Następne żądanie wykonaj pod adresem `links.next`; null kończy listę. Stosuj tylko filtry wymienione w parametrach tej metody. #### POST /organizations/{organizationId}/carbon-calculations Obliczenia śladu węglowego — Dodaj Kalkulacja śladu pozyskania materiałów dla opakowania lub zestawu z jawnymi współczynnikami. To nie pełne LCA transportu, energii i końca życia. incomplete ma total_kg_co2e=null. Utwórz rekord z danych opisanych w requestBody. Odpowiedź zawiera publiczne id do dalszego odczytu i powiązań. Zakres klucza: reports:run. Uprawnienie w organizacji: reports.export. Ta operacja wymaga `Idempotency-Key`. Ponowienie: ta sama metoda, ścieżka, klucz i dane. Nową operację oznacz nowym kluczem; nie obchodź konfliktu przez losowanie klucza bez sprawdzenia poprzedniego wyniku. #### GET /organizations/{organizationId}/carbon-calculations/{recordId} Obliczenia śladu węglowego — Szczegóły Kalkulacja śladu pozyskania materiałów dla opakowania lub zestawu z jawnymi współczynnikami. To nie pełne LCA transportu, energii i końca życia. incomplete ma total_kg_co2e=null. Pobierz szczegóły istniejącego rekordu. UUID weź z listy lub odpowiedzi tworzenia tego samego rodzaju zasobu. Zakres klucza: reports:read. Uprawnienie w organizacji: reports.view. #### GET /organizations/{organizationId}/carbon-factors Współczynniki emisji — Lista Źródła i wersjonowane współczynniki emisji wykorzystywane przez kalkulacje. Własny współczynnik musi mieć jednostkę, zakres i źródło; archiwizacja nie zmienia dawnych wyników. Pobierz listę rekordów dostępnych dla organizacji klucza. Zakres klucza: reports:read. Uprawnienie w organizacji: reports.view. Lista używa `per_page` (1–100, domyślnie 50) i kursora. Następne żądanie wykonaj pod adresem `links.next`; null kończy listę. Stosuj tylko filtry wymienione w parametrach tej metody. #### POST /organizations/{organizationId}/carbon-factors Współczynniki emisji — Dodaj Źródła i wersjonowane współczynniki emisji wykorzystywane przez kalkulacje. Własny współczynnik musi mieć jednostkę, zakres i źródło; archiwizacja nie zmienia dawnych wyników. Utwórz rekord z danych opisanych w requestBody. Odpowiedź zawiera publiczne id do dalszego odczytu i powiązań. Zakres klucza: reports:run. Uprawnienie w organizacji: reports.export. Ta operacja wymaga `Idempotency-Key`. Ponowienie: ta sama metoda, ścieżka, klucz i dane. Nową operację oznacz nowym kluczem; nie obchodź konfliktu przez losowanie klucza bez sprawdzenia poprzedniego wyniku. #### GET /organizations/{organizationId}/carbon-factors/reference Współczynniki emisji — Katalog źródłowy Źródła i wersjonowane współczynniki emisji wykorzystywane przez kalkulacje. Własny współczynnik musi mieć jednostkę, zakres i źródło; archiwizacja nie zmienia dawnych wyników. Pobierz katalog referencyjny, zakresy i jednostki przed wyborem współczynników. Nie zakładaj, że każdy materiał ma gotowy współczynnik dla każdego regionu i okresu. Zakres klucza: reports:read. Uprawnienie w organizacji: reports.view. #### GET /organizations/{organizationId}/carbon-factors/{recordId} Współczynniki emisji — Szczegóły Źródła i wersjonowane współczynniki emisji wykorzystywane przez kalkulacje. Własny współczynnik musi mieć jednostkę, zakres i źródło; archiwizacja nie zmienia dawnych wyników. Pobierz szczegóły istniejącego rekordu. UUID weź z listy lub odpowiedzi tworzenia tego samego rodzaju zasobu. Zakres klucza: reports:read. Uprawnienie w organizacji: reports.view. #### POST /organizations/{organizationId}/carbon-factors/{recordId}/archive Współczynniki emisji — Archiwizuj Źródła i wersjonowane współczynniki emisji wykorzystywane przez kalkulacje. Własny współczynnik musi mieć jednostkę, zakres i źródło; archiwizacja nie zmienia dawnych wyników. Archiwizuj rekord. Historia pozostaje dostępna; archiwalnego zasobu nie należy wybierać do nowych operacji. Zakres klucza: reports:run. Uprawnienie w organizacji: reports.export. Ta operacja wymaga `Idempotency-Key`. Ponowienie: ta sama metoda, ścieżka, klucz i dane. Nową operację oznacz nowym kluczem; nie obchodź konfliktu przez losowanie klucza bez sprawdzenia poprzedniego wyniku. ### Sprawy, złożenia i audyt 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ą. #### GET /organizations/{organizationId}/audit-log Dziennik audytu — Lista Dziennik zdarzeń organizacji z filtrem dat. Projekcja redaguje sekrety; to ślad audytowy, nie interfejs odtwarzania lub cofania dowolnej operacji. Pobierz listę rekordów dostępnych dla organizacji klucza. Zakres klucza: audit:read. Uprawnienie w organizacji: audit.view. Lista używa `per_page` (1–100, domyślnie 50) i kursora. Następne żądanie wykonaj pod adresem `links.next`; null kończy listę. Stosuj tylko filtry wymienione w parametrach tej metody. #### GET /organizations/{organizationId}/ppwr/authority-requests Żądania organów — Lista Ewidencja otrzymanych żądań organu, terminów i materiałów do przygotowania. Nie odbiera automatycznie urzędowej korespondencji. Pobierz listę rekordów dostępnych dla organizacji klucza. Zakres klucza: ppwr:read. Uprawnienie w organizacji: issues.manage lub evidence.review. Lista używa `per_page` (1–100, domyślnie 50) i kursora. Następne żądanie wykonaj pod adresem `links.next`; null kończy listę. Stosuj tylko filtry wymienione w parametrach tej metody. #### POST /organizations/{organizationId}/ppwr/authority-requests Żądania organów — Dodaj Ewidencja otrzymanych żądań organu, terminów i materiałów do przygotowania. Nie odbiera automatycznie urzędowej korespondencji. Utwórz rekord z danych opisanych w requestBody. Odpowiedź zawiera publiczne id do dalszego odczytu i powiązań. Dla rejestru technicznego: przygotuj opakowanie lub rekord nadrzędny, wymagane wersje dokumentów i datę oceny; utwórz wpis, pobierz jego UUID, a następnie użyj /review, jeżeli ta metoda istnieje. Źródła muszą spełniać warunki danego rejestru. Decyzja może wymagać innego recenzenta; 403/422 nie oznacza, że klucz technicznie nie działa. Zapis ani zatwierdzenie nie zastępują opublikowanej metodyki oceny. Zakres klucza: ppwr:write. Uprawnienie w organizacji: issues.manage. Ta operacja wymaga `Idempotency-Key`. Ponowienie: ta sama metoda, ścieżka, klucz i dane. Nową operację oznacz nowym kluczem; nie obchodź konfliktu przez losowanie klucza bez sprawdzenia poprzedniego wyniku. #### GET /organizations/{organizationId}/ppwr/authority-requests/{parentId}/responses Odpowiedzi organom — Lista Odpowiedzi i dowody doręczenia powiązane z żądaniem organu. Zapis potwierdzenia nie wysyła pisma w zewnętrznym kanale urzędowym. Pobierz listę rekordów dostępnych dla organizacji klucza. Zakres klucza: ppwr:read. Uprawnienie w organizacji: issues.manage lub evidence.review. Lista używa `per_page` (1–100, domyślnie 50) i kursora. Następne żądanie wykonaj pod adresem `links.next`; null kończy listę. Stosuj tylko filtry wymienione w parametrach tej metody. #### POST /organizations/{organizationId}/ppwr/authority-requests/{parentId}/responses Odpowiedzi organom — Dodaj Odpowiedzi i dowody doręczenia powiązane z żądaniem organu. Zapis potwierdzenia nie wysyła pisma w zewnętrznym kanale urzędowym. Utwórz rekord z danych opisanych w requestBody. Odpowiedź zawiera publiczne id do dalszego odczytu i powiązań. Dla rejestru technicznego: przygotuj opakowanie lub rekord nadrzędny, wymagane wersje dokumentów i datę oceny; utwórz wpis, pobierz jego UUID, a następnie użyj /review, jeżeli ta metoda istnieje. Źródła muszą spełniać warunki danego rejestru. Decyzja może wymagać innego recenzenta; 403/422 nie oznacza, że klucz technicznie nie działa. Zapis ani zatwierdzenie nie zastępują opublikowanej metodyki oceny. Zakres klucza: ppwr:write. Uprawnienie w organizacji: issues.manage. Ta operacja wymaga `Idempotency-Key`. Ponowienie: ta sama metoda, ścieżka, klucz i dane. Nową operację oznacz nowym kluczem; nie obchodź konfliktu przez losowanie klucza bez sprawdzenia poprzedniego wyniku. #### GET /organizations/{organizationId}/ppwr/authority-requests/{parentId}/responses/{recordId} Odpowiedzi organom — Szczegóły Odpowiedzi i dowody doręczenia powiązane z żądaniem organu. Zapis potwierdzenia nie wysyła pisma w zewnętrznym kanale urzędowym. Pobierz szczegóły istniejącego rekordu. UUID weź z listy lub odpowiedzi tworzenia tego samego rodzaju zasobu. Zakres klucza: ppwr:read. Uprawnienie w organizacji: issues.manage lub evidence.review. #### POST /organizations/{organizationId}/ppwr/authority-requests/{parentId}/responses/{recordId}/review Odpowiedzi organom — Przegląd Odpowiedzi i dowody doręczenia powiązane z żądaniem organu. Zapis potwierdzenia nie wysyła pisma w zewnętrznym kanale urzędowym. Zapisz decyzję przeglądu i uzasadnienie. Pobierz później szczegóły, aby sprawdzić status. Decyzja jest zapisem wewnętrznym tego rejestru. Dla rejestru technicznego: przygotuj opakowanie lub rekord nadrzędny, wymagane wersje dokumentów i datę oceny; utwórz wpis, pobierz jego UUID, a następnie użyj /review, jeżeli ta metoda istnieje. Źródła muszą spełniać warunki danego rejestru. Decyzja może wymagać innego recenzenta; 403/422 nie oznacza, że klucz technicznie nie działa. Zapis ani zatwierdzenie nie zastępują opublikowanej metodyki oceny. Zakres klucza: ppwr:review. Uprawnienie w organizacji: evidence.review. Ta operacja wymaga `Idempotency-Key`. Ponowienie: ta sama metoda, ścieżka, klucz i dane. Nową operację oznacz nowym kluczem; nie obchodź konfliktu przez losowanie klucza bez sprawdzenia poprzedniego wyniku. #### GET /organizations/{organizationId}/ppwr/authority-requests/{recordId} Żądania organów — Szczegóły Ewidencja otrzymanych żądań organu, terminów i materiałów do przygotowania. Nie odbiera automatycznie urzędowej korespondencji. Pobierz szczegóły istniejącego rekordu. UUID weź z listy lub odpowiedzi tworzenia tego samego rodzaju zasobu. Zakres klucza: ppwr:read. Uprawnienie w organizacji: issues.manage lub evidence.review. #### GET /organizations/{organizationId}/ppwr/external-submissions Rejestr złożeń w systemach zewnętrznych — Lista Rejestr złożeń wykonanych w systemach zewnętrznych, z referencjami i dowodami. Utworzenie wpisu nie wykonuje wysyłki do tych systemów. Pobierz listę rekordów dostępnych dla organizacji klucza. Zakres klucza: ppwr:read. Uprawnienie w organizacji: reports.view. Lista używa `per_page` (1–100, domyślnie 50) i kursora. Następne żądanie wykonaj pod adresem `links.next`; null kończy listę. Stosuj tylko filtry wymienione w parametrach tej metody. #### POST /organizations/{organizationId}/ppwr/external-submissions Rejestr złożeń w systemach zewnętrznych — Dodaj Rejestr złożeń wykonanych w systemach zewnętrznych, z referencjami i dowodami. Utworzenie wpisu nie wykonuje wysyłki do tych systemów. Utwórz rekord z danych opisanych w requestBody. Odpowiedź zawiera publiczne id do dalszego odczytu i powiązań. Dla rejestru technicznego: przygotuj opakowanie lub rekord nadrzędny, wymagane wersje dokumentów i datę oceny; utwórz wpis, pobierz jego UUID, a następnie użyj /review, jeżeli ta metoda istnieje. Źródła muszą spełniać warunki danego rejestru. Decyzja może wymagać innego recenzenta; 403/422 nie oznacza, że klucz technicznie nie działa. Zapis ani zatwierdzenie nie zastępują opublikowanej metodyki oceny. Zakres klucza: ppwr:write. Uprawnienie w organizacji: reports.export. Ta operacja wymaga `Idempotency-Key`. Ponowienie: ta sama metoda, ścieżka, klucz i dane. Nową operację oznacz nowym kluczem; nie obchodź konfliktu przez losowanie klucza bez sprawdzenia poprzedniego wyniku. #### GET /organizations/{organizationId}/ppwr/external-submissions/{recordId} Rejestr złożeń w systemach zewnętrznych — Szczegóły Rejestr złożeń wykonanych w systemach zewnętrznych, z referencjami i dowodami. Utworzenie wpisu nie wykonuje wysyłki do tych systemów. Pobierz szczegóły istniejącego rekordu. UUID weź z listy lub odpowiedzi tworzenia tego samego rodzaju zasobu. Zakres klucza: ppwr:read. Uprawnienie w organizacji: reports.view. #### POST /organizations/{organizationId}/ppwr/external-submissions/{recordId}/review Rejestr złożeń w systemach zewnętrznych — Przegląd Rejestr złożeń wykonanych w systemach zewnętrznych, z referencjami i dowodami. Utworzenie wpisu nie wykonuje wysyłki do tych systemów. Zapisz decyzję przeglądu i uzasadnienie. Pobierz później szczegóły, aby sprawdzić status. Decyzja jest zapisem wewnętrznym tego rejestru. Dla rejestru technicznego: przygotuj opakowanie lub rekord nadrzędny, wymagane wersje dokumentów i datę oceny; utwórz wpis, pobierz jego UUID, a następnie użyj /review, jeżeli ta metoda istnieje. Źródła muszą spełniać warunki danego rejestru. Decyzja może wymagać innego recenzenta; 403/422 nie oznacza, że klucz technicznie nie działa. Zapis ani zatwierdzenie nie zastępują opublikowanej metodyki oceny. Zakres klucza: ppwr:review. Uprawnienie w organizacji: evidence.review. Ta operacja wymaga `Idempotency-Key`. Ponowienie: ta sama metoda, ścieżka, klucz i dane. Nową operację oznacz nowym kluczem; nie obchodź konfliktu przez losowanie klucza bez sprawdzenia poprzedniego wyniku. #### GET /organizations/{organizationId}/ppwr/formal-cases Sprawy i działania naprawcze — Lista Sprawy formalne i działania naprawcze dla opakowania. Zdarzenia historii dokumentują kolejne czynności i dowody, nie zastępują decyzji organu. Pobierz listę rekordów dostępnych dla organizacji klucza. Zakres klucza: ppwr:read. Uprawnienie w organizacji: issues.manage lub evidence.review. Lista używa `per_page` (1–100, domyślnie 50) i kursora. Następne żądanie wykonaj pod adresem `links.next`; null kończy listę. Stosuj tylko filtry wymienione w parametrach tej metody. #### POST /organizations/{organizationId}/ppwr/formal-cases Sprawy i działania naprawcze — Dodaj Sprawy formalne i działania naprawcze dla opakowania. Zdarzenia historii dokumentują kolejne czynności i dowody, nie zastępują decyzji organu. Utwórz rekord z danych opisanych w requestBody. Odpowiedź zawiera publiczne id do dalszego odczytu i powiązań. Dla rejestru technicznego: przygotuj opakowanie lub rekord nadrzędny, wymagane wersje dokumentów i datę oceny; utwórz wpis, pobierz jego UUID, a następnie użyj /review, jeżeli ta metoda istnieje. Źródła muszą spełniać warunki danego rejestru. Decyzja może wymagać innego recenzenta; 403/422 nie oznacza, że klucz technicznie nie działa. Zapis ani zatwierdzenie nie zastępują opublikowanej metodyki oceny. Zakres klucza: ppwr:write. Uprawnienie w organizacji: issues.manage. Ta operacja wymaga `Idempotency-Key`. Ponowienie: ta sama metoda, ścieżka, klucz i dane. Nową operację oznacz nowym kluczem; nie obchodź konfliktu przez losowanie klucza bez sprawdzenia poprzedniego wyniku. #### GET /organizations/{organizationId}/ppwr/formal-cases/{parentId}/events Historia spraw — Lista Historia działań sprawy: ustalenia, odpowiedzi, działania i zamknięcie zgodnie z typem zdarzenia. parentId jest UUID sprawy. Pobierz listę rekordów dostępnych dla organizacji klucza. Zakres klucza: ppwr:read. Uprawnienie w organizacji: issues.manage lub evidence.review. Lista używa `per_page` (1–100, domyślnie 50) i kursora. Następne żądanie wykonaj pod adresem `links.next`; null kończy listę. Stosuj tylko filtry wymienione w parametrach tej metody. #### POST /organizations/{organizationId}/ppwr/formal-cases/{parentId}/events Historia spraw — Dodaj Historia działań sprawy: ustalenia, odpowiedzi, działania i zamknięcie zgodnie z typem zdarzenia. parentId jest UUID sprawy. Utwórz rekord z danych opisanych w requestBody. Odpowiedź zawiera publiczne id do dalszego odczytu i powiązań. Dla rejestru technicznego: przygotuj opakowanie lub rekord nadrzędny, wymagane wersje dokumentów i datę oceny; utwórz wpis, pobierz jego UUID, a następnie użyj /review, jeżeli ta metoda istnieje. Źródła muszą spełniać warunki danego rejestru. Decyzja może wymagać innego recenzenta; 403/422 nie oznacza, że klucz technicznie nie działa. Zapis ani zatwierdzenie nie zastępują opublikowanej metodyki oceny. Zakres klucza: ppwr:write. Uprawnienie w organizacji: issues.manage. Ta operacja wymaga `Idempotency-Key`. Ponowienie: ta sama metoda, ścieżka, klucz i dane. Nową operację oznacz nowym kluczem; nie obchodź konfliktu przez losowanie klucza bez sprawdzenia poprzedniego wyniku. #### GET /organizations/{organizationId}/ppwr/formal-cases/{parentId}/events/{recordId} Historia spraw — Szczegóły Historia działań sprawy: ustalenia, odpowiedzi, działania i zamknięcie zgodnie z typem zdarzenia. parentId jest UUID sprawy. Pobierz szczegóły istniejącego rekordu. UUID weź z listy lub odpowiedzi tworzenia tego samego rodzaju zasobu. Zakres klucza: ppwr:read. Uprawnienie w organizacji: issues.manage lub evidence.review. #### GET /organizations/{organizationId}/ppwr/formal-cases/{recordId} Sprawy i działania naprawcze — Szczegóły Sprawy formalne i działania naprawcze dla opakowania. Zdarzenia historii dokumentują kolejne czynności i dowody, nie zastępują decyzji organu. Pobierz szczegóły istniejącego rekordu. UUID weź z listy lub odpowiedzi tworzenia tego samego rodzaju zasobu. Zakres klucza: ppwr:read. Uprawnienie w organizacji: issues.manage lub evidence.review.