e-Doręczenia API - jak zintegrować firmowy system z e-Doręczeniami

Skrzynka do e-Doręczeń działa, ale ktoś w firmie musi codziennie się do niej logować, sprawdzać nowe wiadomości i ręcznie przenosić dokumenty do systemu, w którym faktycznie toczy się sprawa. Przy kilku pismach miesięcznie to nie problem. Przy setkach - to wąskie gardło, które rośnie razem ze skalą.

Skala akurat rośnie szybko. Na początku sierpnia 2026 r. w Bazie Adresów Elektronicznych działało już 4,6 mln aktywnych adresów, a łączny wolumen przesyłek zbliżył się do 100 mln, z czego ponad 50 mln nadano od początku samego 2026 roku. Od 1 października 2026 r. obowiązek posiadania adresu do e-Doręczeń obejmie też wszystkie firmy zarejestrowane w CEIDG do końca 2024 r. - czyli praktycznie cały sektor mikro- i małych przedsiębiorstw. Ręczna obsługa korespondencji przestaje się skalować nie dlatego, że ktoś źle zorganizował proces, tylko dlatego, że wolumen przerósł możliwości pojedynczej osoby przy skrzynce.

To właśnie tutaj wchodzi API. Ten artykuł wyjaśnia, czym różni się integracja z rządowym protokołem od integracji przez kwalifikowanego dostawcę, co realnie można zrobić przez API e-Doręczeń i jak porównać ofertę dostawców, zanim zdecydujesz się na konkretną integrację.

Kluczowe informacje

• e-Doręczenia API pozwala połączyć system firmowy (ERP, CRM, DMS) z usługą e-Doręczeń, tak aby wysyłka, odbiór i pobieranie dowodów doręczenia odbywały się automatycznie, bez logowania do skrzynki
• integracja bezpośrednio z rządowym UA API/SE API to inny poziom złożoności niż integracja przez API kwalifikowanego dostawcy, który tę złożoność już obsłużył
• w Polsce działa 4 kwalifikowanych dostawców usług e-Doręczeń: Asseco Data Systems (Certum), Autenti, Poczta Polska i PWPW (eDO Post) - każdy oferuje API na innych warunkach
• na początku sierpnia 2026 r. w Polsce działało 4,6 mln aktywnych adresów do e-Doręczeń, a łączny wolumen zbliżył się do 100 mln przesyłek
• Search Engine API w wersji 4 (wdrożonej produkcyjnie 15 kwietnia 2025 r.) pozwala podmiotom niepublicznym wyszukiwać jednorazowo do 1000 adresów ADE
• integracja przez API kwalifikowanego dostawcy nie oznacza rezygnacji z Krajowego Systemu e-Doręczeń - dostawca działa w jego ramach i przejmuje techniczną warstwę integracji za klienta
  
  

Co to jest e-Doręczenia API?

e-Doręczenia API to interfejs programistyczny, który pozwala połączyć system firmowy z usługą e-Doręczeń, tak by wysyłka i odbiór korespondencji elektronicznej odbywały się automatycznie, bez logowania do skrzynki.

W praktyce oznacza to, że system, w którym firma już pracuje - ERP, CRM albo DMS/system obiegu dokumentów - dostaje i wysyła korespondencję z e-Doręczeń tym samym kanałem, którym obsługuje inne dokumenty. Nikt nie musi przełączać się między aplikacjami, żeby sprawdzić, czy przyszło pismo z urzędu.

Podstawą prawną usługi jest ustawa o doręczeniach elektronicznych (tekst jednolity Dz.U. 2026 poz. 3). Rolę podmiotu realizującego usługę pełni kwalifikowany dostawca - to on odpowiada za techniczne połączenie z Krajowym Systemem e-Doręczeń i za utrzymanie API, z którego korzysta system firmowy.

UA API rządu a API dostawcy - dwa różne poziomy integracji

To rozróżnienie jest źródłem większości nieporozumień przy planowaniu integracji, dlatego warto je ustalić na starcie: UA API i SE API to rządowy protokół, którym systemy klasy EZD łączą się bezpośrednio z Krajowym Systemem e-Doręczeń. API kwalifikowanego dostawcy to osobna warstwa - interfejs, przez który firma integruje własny system z usługą e-Doręczeń, bez dotykania rządowego protokołu bezpośrednio.

Chronologia wersji rządowego API pokazuje, jak szybko ten protokół się zmienia. Search Engine API w wersji 4 wdrożono produkcyjnie 15 kwietnia 2025 r. - umożliwia masowe wyszukiwanie do 1000 adresów ADE dla podmiotów niepublicznych. Systemy EZD miały obowiązek aktualizacji do wersji 3 UA API do 31 grudnia 2025 r., a starsze wersje UA API (1 i 2) zostały faktycznie wyłączone na produkcji z dniem 1 stycznia 2026 r. Numer wersji to informacja, która szybko się starzeje - każda integracja oparta bezpośrednio na UA API/SE API musi odsyłać do bieżącej dokumentacji rządowej, a nie do statycznej instrukcji sprzed kilku miesięcy.

Zespoły IT, które zamiast skorzystać z gotowego API kwalifikowanego dostawcy, próbują zbudować integrację bezpośrednio z rządowym UA API/SE API od zera, a potem utrzymywać ją przy każdej aktualizacji wersji protokołu - to zjawisko, które w tym artykule nazywamy syndromem wynajdywania koła. Koszt takiej decyzji nie ujawnia się od razu. Ujawnia się przy pierwszej wymuszonej aktualizacji wersji, kiedy zespół, który zbudował integrację "u siebie", musi ją przepisywać, zamiast skorzystać z API dostawcy, który tę aktualizację obsłużył za wszystkich swoich klientów jednocześnie.

Nie oznacza to, że Autenti "zastępuje" rządowy system e-Doręczeń. Autenti, jako kwalifikowany dostawca, działa w ramach Krajowego Systemu e-Doręczeń i obsługuje techniczną warstwę integracji za klienta - firma nie rezygnuje z niczego, tylko przenosi ciężar utrzymania protokołu na dostawcę, który robi to zawodowo.

Kiedy integracja bezpośrednia z UA API ma sens, a kiedy nie

Integracja bezpośrednio z rządowym UA API ma sens praktycznie tylko wtedy, gdy firma sama jest dostawcą systemu klasy EZD i integracja z e-Doręczeniami jest częścią jej produktu. Dla firmy, która chce po prostu połączyć swój ERP, CRM czy DMS z e-Doręczeniami, integracja przez API kwalifikowanego dostawcy oznacza mniej utrzymania, jedno źródło wsparcia technicznego i brak konieczności śledzenia każdej aktualizacji rządowego protokołu.

Co można zrobić przez e-Doręczenia API

Zakres operacji dostępnych przez API zależy od konkretnego dostawcy, ale na wyższym poziomie ogólności obejmuje zwykle:

Czego API nie obsłuży

Niektóre czynności administracyjne - jak zarządzanie uprawnieniami użytkowników skrzynki czy zmiana danych rejestrowych adresu - zwykle wymagają panelu dostawcy, nie samego API. Warto to sprawdzić przed podpisaniem umowy, jeśli firma planuje w pełni zautomatyzowany proces bez ręcznej interwencji.

Jak wypada API u czterech kwalifikowanych dostawców

Na rynku działają 4 kwalifikowani dostawcy usług e-Doręczeń: Asseco Data Systems (Certum), Autenti, Poczta Polska oraz PWPW (eDO Post). Żadne źródło publicznie dostępne nie porównuje ich API obok siebie w jednym miejscu - to dokładnie ten research, którego szuka IT Manager na etapie wyboru dostawcy.

Dane w tabeli odzwierciedlają stan na dzień publikacji artykułu (sierpień 2026). Zakres API, limity i modele cenowe dostawców zmieniają się szybciej niż sama ustawa, dlatego przed podjęciem decyzji warto zweryfikować aktualną ofertę bezpośrednio u dostawcy.

Zespoły IT, które próbowały zbudować integrację samodzielnie z rządowym API, biorą na siebie koszt utrzymania kodu przy każdej wymuszonej aktualizacji wersji protokołu - a to koszt, który przy integracji przez kwalifikowanego dostawcę praktycznie znika, bo dostawca aktualizuje własne API centralnie dla wszystkich klientów.

Przykład: automatyczne kierowanie korespondencji do właściwego działu

Firma z kilkoma oddziałami albo grupa spółek dzieląca jedną skrzynkę do e-Doręczeń stoi przed konkretnym problemem operacyjnym: kto ma sprawdzać, do której spółki lub działu trafiła dana wiadomość, i jak szybko to zrobić, zanim minie termin odpowiedzi.

Same reguły automatyczne nie są funkcją API e-Doręczeń - to mechanizm po stronie systemu zewnętrznego (ERP, CRM albo DMS), który odbiera dane przez API i na ich podstawie decyduje, do którego działu albo podmiotu skierować daną przesyłkę. API dostarcza dane o wiadomości (nadawcę, typ pisma, powiązany numer sprawy), a logika kierowania i dalsze zarządzanie przesyłką odbywają się już w oprogramowaniu, z którym e-Doręczenia zostały zintegrowane.

Dla organizacji, które już dziś obsługują korespondencję dla kilku podmiotów z jednej skrzynki, to sposób na wyeliminowanie ręcznego etapu, który najczęściej odpowiada za opóźnienia. Więcej o samym mechanizmie reguł automatycznych i o tym, jak wygląda to w praktyce w grupie spółek, znajdziesz w artykule o elektronicznym biurze podawczym z regułami automatycznymi w e-Doręczeniach oraz w tekście o zarządzaniu e-Doręczeniami w grupie spółek.

Co sprawdzić przed integracją e-Doręczeń przez API

Zanim zespół IT zacznie pracę nad integracją, warto przejść przez kilka punktów, które decydują o tym, ile realnie potrwa wdrożenie:

1. Certyfikat do uwierzytelnienia - sprawdź, jakiego certyfikatu wymaga dostawca do autoryzacji połączenia między systemami.
2. Środowisko testowe - upewnij się, że dostawca udostępnia środowisko, w którym można przetestować integrację przed przejściem na produkcję.
3. Mapowanie procesu - określ, które dokumenty i jakie statusy mają automatycznie trafiać do systemu firmowego, a które wymagają ręcznej decyzji.
4. Sprawdzenie gotowych integracji - zanim zespół zacznie budować połączenie od zera, warto zweryfikować, czy dostawca ma już gotową integrację z systemem, którego firma używa (np. WEBCON, Enova365 albo popularne systemy EZD). Więcej o tym, na co zwrócić uwagę na etapie technicznym, znajdziesz na stronie integracji Autenti.
5. Wdrożenie produkcyjne z okresem równoległej pracy - nowy proces powinien działać obok starego przez pewien czas, zanim firma całkowicie wyłączy ręczną obsługę skrzynki.

Sugerowanie, że integracja z API jest trywialna w każdym przypadku, byłoby nieuczciwe wobec czytelnika - realny czas wdrożenia zależy od tego, ile systemów firma łączy naraz i jak bardzo złożone jest mapowanie procesu.

Ile kosztuje integracja i na jakim planie dostępne jest API

To pytanie, które najczęściej pojawia się dopiero po czasie poświęconym na research techniczny - i to błąd, którego można uniknąć. API e-Doręczeń u kwalifikowanych dostawców jest zwykle częścią oferty korporacyjnej albo planu dla dużych organizacji, a nie funkcją dostępną w każdym wariancie usługi.

W przypadku Autenti dostęp do API do wysyłki, odbioru, dowodów i wyszukiwania w rejestrach publicznych jest dostępny w wariancie korporacyjnym, przeznaczonym dla organizacji, które faktycznie potrzebują automatyzacji na poziomie systemu, a nie pojedynczych kont użytkowników. Zanim zespół IT zainwestuje czas w dokumentację techniczną, warto sprawdzić cennik e-Doręczeń Autenti, żeby wiedzieć, czy organizacja w ogóle kwalifikuje się do planu z dostępem do API.

Dla programistów, którzy chcą zobaczyć szczegóły techniczne API, publiczna dokumentacja jest dostępna pod adresem developers.autenti.com.

Kiedy warto skorzystać z wsparcia wdrożeniowego

Integracja API to nie tylko kwestia techniczna - to też decyzja o tym, kto w organizacji będzie odpowiadał za utrzymanie połączenia po wdrożeniu. Samodzielne wdrożenie ma sens, gdy firma integruje jeden prosty system i ma zespół IT, który zna już podobne integracje API. Wsparcie partnera wdrożeniowego zyskuje na znaczeniu, gdy w grę wchodzi kilka systemów naraz, wiele oddziałów albo spółek dzielących jedną skrzynkę, albo gdy zespół IT jest już obciążony innymi projektami.

Przy wolumenie zbliżającym się do 100 mln przesyłek w skali kraju, ręczne procesy stają się jedynym wąskim gardłem w organizacjach, które odkładają integrację na później. Autenti, jako partner w cyfrowej transformacji, oferuje wsparcie doradcze i onboarding dla organizacji, które integrują e-Doręczenia z wieloma systemami naraz - sprawdź ofertę na stronie e-Doręczenia dla dużych firm.

Jeśli firma ma już skrzynkę u innego dostawcy i rozważa zmianę - na przykład dlatego, że obecny dostawca nie oferuje API na dostępnym dla firmy planie - warto wiedzieć, że sam adres do doręczeń elektronicznych zostaje ten sam. Proces zmiany dostawcy opisuje artykuł jak przenieść skrzynkę i zmienić dostawcę e-Doręczeń.

FAQ: e-Doręczenia API

Czym różni się UA API od API dostawcy usługi e-Doręczeń?

UA API to rządowy protokół integracji systemów EZD bezpośrednio z Krajowym Systemem e-Doręczeń. API dostawcy to osobna warstwa, przez którą firma integruje własny system z usługą e-Doręczeń, bez konieczności utrzymywania połączenia z rządowym protokołem samodzielnie.

Czy muszę integrować się bezpośrednio z rządowym API, czy mogę przez dostawcę?

Nie musisz integrować się bezpośrednio z rządowym UA API/SE API. Większość firm korzysta z API udostępnianego przez kwalifikowanego dostawcę, który przejmuje techniczną warstwę integracji z Krajowym Systemem e-Doręczeń.

Jakie operacje można wykonać przez API e-Doręczeń?

Zakres zależy od dostawcy, ale zwykle obejmuje wysyłkę i odbiór korespondencji, pobieranie dowodów doręczenia oraz wyszukiwanie adresatów w rejestrach publicznych.

Czy przez API mogę zarządzać skrzynkami i użytkownikami?

Zwykle nie w pełnym zakresie. Zarządzanie uprawnieniami użytkowników i część czynności administracyjnych odbywa się przez panel dostawcy, a nie przez samo API.

Co jest wymagane technicznie do integracji (certyfikat, token, środowisko testowe)?

Integracja wymaga zwykle certyfikatu do uwierzytelnienia połączenia, dostępu do środowiska testowego przed wdrożeniem produkcyjnym oraz mapowania procesu, które określa, jakie dokumenty i statusy mają trafiać automatycznie do systemu firmowego.

Jak długo trwa integracja e-Doręczeń z systemem firmowym?

Czas zależy od liczby integrowanych systemów i złożoności mapowania procesu. Integracja jednego systemu z gotowym połączeniem u dostawcy trwa zwykle krócej niż wdrożenie obejmujące kilka systemów i wiele oddziałów jednocześnie.

Na jakim planie cenowym dostępne jest API?

U większości kwalifikowanych dostawców, w tym u Autenti, API jest dostępne w wariancie korporacyjnym lub dla dużych organizacji, a nie w podstawowym planie usługi. Szczegóły warto sprawdzić bezpośrednio w aktualnym cenniku dostawcy.

Czy mogę zmienić dostawcę, jeśli już mam integrację przez API?

Tak. Adres do doręczeń elektronicznych pozostaje ten sam niezależnie od zmiany dostawcy, co obniża barierę wejścia dla firm, które chcą przenieść integrację do innego kwalifikowanego dostawcy.

Jeśli Twoja firma łączy kilka systemów albo kilka oddziałów z jedną skrzynką e-Doręczeń, sprawdź, jak wygląda integracja e-Doręczeń przez API dla organizacji Twojej skali.