Dodawanie dokumentu do RPW przez API EZD RP

Dodawanie dokumentu do RPW (Rejestru Przesyłek Wpływających) to jeden z najczęstszych scenariuszy integracji API EZD RP — używany m.in. w integracji z systemem FK (faktura wchodzi do RPW), systemem rekrutacji (wniosek wchodzi do RPW), KSeF (faktura z KSeF rejestrowana automatycznie).

Sekwencja wywołań

1. Pobierz upload-token — POST /upload-token z kluczem API
2. Wgraj plik — POST /files z plikiem PDF + upload-tokenem. Otrzymujesz `id_pliku`
3. Dodaj dokument do RPW — POST /rpw z metadanymi + `id_pliku`
4. Otrzymaj numer RPW — w odpowiedzi otrzymujesz numer rejestracyjny dokumentu
5. (opcjonalnie) Subskrybuj webhook — by dostać powiadomienie o dekretacji / przekazaniu

Wymagane metadane

• Nadawca — dane osoby/instytucji nadającej
• Data wpływu (lub czas wpływu)
• Typ przesyłki — np. 'list polecony', 'e-Doręczenie', 'KSeF', 'osobiście'
• Tytuł / opis — krótki opis treści
• JRWA klasa (opcjonalnie, można uzupełnić później)
• Komórka odbierająca (opcjonalnie, można dekretować po wpływie)
• ID pliku — z poprzedniego kroku (POST /files)

Przykład: faktura z KSeF do RPW

EZD RP robi to automatycznie wbudowanym mechanizmem (od stycznia 2026). Ale jeśli musisz to zrealizować ręcznie z innego systemu FK:

1. Pobierz fakturę z KSeF (PDF wizualizacji + XML)
2. Pobierz upload-token, wgraj PDF
3. POST /rpw z metadanymi: nadawca = wystawca faktury, typ = 'faktura KSeF', tytuł = 'Faktura nr X od Y', JRWA = klasa dla faktur
4. Zapisz numer RPW po stronie systemu FK do referencji

Typowe błędy