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ń
- Pobierz upload-token — POST /upload-token z kluczem API
- Wgraj plik — POST /files z plikiem PDF + upload-tokenem. Otrzymujesz `id_pliku`
- Dodaj dokument do RPW — POST /rpw z metadanymi + `id_pliku`
- Otrzymaj numer RPW — w odpowiedzi otrzymujesz numer rejestracyjny dokumentu
- (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:
- Pobierz fakturę z KSeF (PDF wizualizacji + XML)
- Pobierz upload-token, wgraj PDF
- POST /rpw z metadanymi: nadawca = wystawca faktury, typ = 'faktura KSeF', tytuł = 'Faktura nr X od Y', JRWA = klasa dla faktur
- Zapisz numer RPW po stronie systemu FK do referencji
Typowe błędy
Co najczęściej idzie nie tak
- Brak `id_pliku` w POST /rpw → dokument bez załącznika
- Niepoprawna klasa JRWA → odrzucenie lub trafienie w zły obieg
- Duplikaty (brak idempotencji w retry) → ten sam dokument 2× w RPW
- Nieobsłużony rate-limit → części dokumentów brak
- Brak retry logiki → przy chwilowej awarii sieci dokument ginie
Konsultacja integracji RPW
Pomożemy zaprojektować integrację dodawania dokumentów do RPW z systemu zewnętrznego.
Umów konsultację