Integracja z e-doręczenia

Hej.
U jednego klienta mam problem z pobraniem e-doręczeń - problematyczna wiadomość została nadana 3 września 2025.
Korzystam UA v2, klasy dostępowe wygenerowane na podstawie ua_api_v.1.0.16.yaml

Chodzi o to, że w pliku yaml attachmentId jest zdefiniowany w następujący sposób:
Attachment:
type: object
properties:
order:
type: integer
description: Numer kolejny załącznika w ramach wiadomości
attachmentId:
type: string
format: uuid
description: UUID załącznika
example: D41568F4-7175-42BB-9503-DAA282180D70
file:
$ref: '#/components/schemas/File'

Teraz otrzymuje attachmentId niezgodny z tym formatem:
"attachmentId": "PWPW-A-DC6527CB-0EB8-4261-BA85-6E833A626325"

Spotkał się ktoś z was takim błędem?

Czy ktoś rozkminił statusy E-doręczeń, które są w odpowiedzi na zapytanie o status wiadomości? W YAMLu (UA API 3.0.8) podane jest, że może to być 9 różnych możliwości:
W trakcie weryfikacji, Przekazana do realizacji, Odrzucona, Nadana, Wysłana, Czeka na doręczenie, Doręczona, Uznana za doręczoną, Niedoręczona

Z kolei w znalezionej dokumentacji API są wymienione jedynie 4: W trakcie weryfikacji, Nadana, Odrzucona oraz Przekazana do realizacji.
Link do dokumentacji, o której wspominam:
https://edoreczenia.poczta-polska.pl/wp-content/uploads/2024/06/Instrukcja_uzytkownka_EZD_v_1.1F.pdf

Streszczając, w dokumentacji pojawia się informacja, że w zależności od rodzaju E-doręczenia (PURDE/PUH) mogą się pojawić statusy:
PURDE:
W trakcie weryfikacji
Nadana
Odrzucona

PUH:
W trakcie weryfikacji
Przekazana do realizacji
Odrzucona

Do znalezienia w kilku miejscach dokumentu, np. na stronie 28.

Nie jest to prawdą, bo dla przesyłek PUH występuje również status Nadana - i co ciekawe, status ten jest taki sam po wystawieniu EPO, czyli faktycznym doręczeniu przesyłki. Nie zmienia się na Doręczona.
Zastanawiam się ile jeszcze jest takich nieścisłości i jakie faktycznie statusy mogą wystąpić w rzeczywistości oraz co one oznaczają, bo nazwy nie są jednoznaczne, dokumentacja jest błędna, a w YAMLu poza ENUMem jakie wartości mogą wystąpić nie ma żadnych dalszych informacji. Inną sprawą jest dlaczego w YAMLu jest 9 różnych możliwości, a w dokumentacji podlinkowanej wyżej 4.

Jest to istotne z punktu widzenia przetwarzania i generalnie statusowania E-doręczenia w systemie zewnętrznym (integrowanym), może ktoś posiada taką informację?

Na int w "Usługi dodatkowe" jest raport z dostarczalności - ale na prod tego nie widzę - wie ktoś może kiedy ten raport będzie udostępniony ?

Czołem grupa,
Wysyłam POST na https://int-ow.edoreczenia.gov.pl/api/se/v4/search/bae-search (tryb drugi, brak reguły, brak zestawu) o treści:
{
"recipientEdasOnly": true,
"recipientEdas": "ADE-jakiś",
"senderEda": "ADE-mój",
"offset": 0,
"limit": 20
}
A odpowiedz z serwera:
{
"timestamp": "2025-11-13T08:25:10.333+00:00",
"status": 404,
"error": "Not Found",
"message": "",
"path": "/api/se/v4/search/bae-search"
}
Ponieważ pracuję w środowisku testowym to czy te adresy ADE to są adresy, które można oficjalnie znaleźć w bazie gov.pl (może zrobili kopie?) , czy są to adresy tylko występujące w środowisku testowym?
Pozdrawiam.

Adresy na testówce są testowe na produkcji produkcyjne

Czołem grupa,
Dla SearchEngine korzystam z adresu: https://int-ow.edoreczenia.gov.pl/api/se/v4/search/eda-confirmation.
A jaki jest adres dla UserAgent?
Widziałem we wcześniejszych postach: https://uaapi-int-ow.poczta-polska.pl/api/v2/

1. Czy autoryzacja jest taka sama dla User Agent jak w SearchEngine?
2. Teraz chyba już obowiązuje v3 dla User Agent?
3. Czy zapytanie (przykładowe) będzie wyglądać tak: GET https://uaapi-int-ow.poczta-polska.pl/api/v3/PL-01234-56789-ABCDE-99/directories ?
   Pozdrawiam.

pro-man napisał(a):

Czołem grupa,
Dla SearchEngine korzystam z adresu: https://int-ow.edoreczenia.gov.pl/api/se/v4/search/eda-confirmation.
A jaki jest adres dla UserAgent?
Widziałem we wcześniejszych postach: https://uaapi-int-ow.poczta-polska.pl/api/v2/

1. Czy autoryzacja jest taka sama dla User Agent jak w SearchEngine?
2. Teraz chyba już obowiązuje v3 dla User Agent?
3. Czy zapytanie (przykładowe) będzie wyglądać tak: GET https://uaapi-int-ow.poczta-polska.pl/api/v3/PL-01234-56789-ABCDE-99/directories ?
   Pozdrawiam.

testowy user agent https://uaapi-int-ow.poczta-polska.pl/api/v3/
testowy search engine https://int-ow.edoreczenia.gov.pl/api/se/v3/
oczywiście numer api na koncu do wybrania
ad1 - tak - oczywiście inne adresy są
ad2 - tak
ad3 - tak

Cześć, podejmuje próbę integracji z api e-doręczęń ale napotkałem chyba znany problem z którym nijak nie moge sobie poradzić.
Po wygenerowaniu plików pem i csr, pobieram certyfikat, następnie udaje mi się uzyskać poprawną odpowiedź z access tokenem, z endpointa https://int-ow.edoreczenia.gov.pl/auth/realms/EDOR/protocol/openid-connect/token?login_hint=ADE.$ADRES_SENDER ale juz po uderzeniu do dowolnej wersji SE API otrzymuję odpowiedź
{"httpCode":"401","id":"00017","errorCodeObjects":[{"errorCode":"SEAPI-00017","language":"PL","message":"Brak autoryzacji"}]} czy jesteście w stanie nakierować mnie co może być nie tak ?
Próbowałem już synchronizacji czasu komputera jak i buforu czasowego nawet do 20s przy polach nbf i iat w payload dla jwt jak i również exp mam ustawione na 300s + od DateTimeOffset.UtcNow.

Każda podpowiedź mile widziana, dzięki i pozdrawiam.

Hej.

Poczta Polska od 1 stycznia wycofuje User Agent v1 i v2.

Więcej tutaj:
https://www.gov.pl/web/e-doreczenia/wylaczenie-1-i-2-wersji-ua-api

I jeszcze więcej tutaj:
https://www.gov.pl/web/e-doreczenia/interfejsy-api

Co ciekawe daty nie są zgodne

Poczta Polska SA wycofuje UA API v.1 oraz v.2 w dniach:
11.01.2026 r. na środowisku PROD.

Hej.

Mam pytanie czy komuś udało się obsłużyć endpoint do wysyłki dużych załączników:

POST /attachments/upload

Co wysyłacie w ciele żądania?
Tablice bajtów z zawartością pliku?
Jakiś obiekt JSON?
Tylko jaki? Projekt Techniczny User Agent-API nie potrafię znaleźć żadnych konkretnych informacji (o przykładach nie wspominając)

Poratujcie

GigaKatowice napisał(a):

Hej.

Mam pytanie czy komuś udało się obsłużyć endpoint do wysyłki dużych załączników:

POST /attachments/upload

Co wysyłacie w ciele żądania?
Tablice bajtów z zawartością pliku?
Jakiś obiekt JSON?
Tylko jaki? Projekt Techniczny User Agent-API nie potrafię znaleźć żadnych konkretnych informacji (o przykładach nie wspominając)

Poratujcie

pakujesz plik do base64 i dołączasz do jsona - w dokumentacji jest to opisane - ale potwierdzam jak na ogólno krajowy projekt to dokumentacja zostawia dużo do życzenia. Jeśli nadal masz problem napisz na priv ale po sylwestrze

Czołem grupa,
Wysyłam żądanie : 'https://uaapi-int-ow.poczta-polska.pl/api/v3/<mój_adres_ade>/drafts/<messageID>/attachments'
dodania do wiadomości roboczej załącznika tak:
{
"fileMetadata":
{
"fileId":"EF051F45-11F4-4C6A-8596-752F7B7C76FF",
"filename":"eDoreczeniaTEST.txt",
"contentType":"text/plain",
"size":15,
"alg":"SHA-3",
"hash":"1682...54B8",
"description":"description"
}
,
"file":"VmFsaWRhdG9yIFRlc3QK"
}
a dostaję z serwera odpowiedź Bad Request 400 i treść błędu:
[
{
"error":"UAAPI0065",
"error_description":"Wrong digest value in request 1682...54B8",
"messageId":"PPSA-E-1429..."
}
]
Nie udało mi się znaleźć błędu: UAAPI0065. Wyliczałem "hash" SHA-3 dla 224, 256, 384 i 512 bitów ale nic się serwerowi nie podoba.
Porównywałem moje wartości "hash" z narzędziami zewnętrznymi dla zawartości "file" i poprawnie wyliczam - a mimo to ciągle dostaję z serwera błąd.
Czy w zapytaniu wysyła się jakąś inna wartość "alg" ?
Jako zawartość pliku wysyłam Validator Test\n jak w przykładzie/dokumentacji.

pro-man napisał(a):

Czołem grupa,
Wysyłam żądanie : 'https://uaapi-int-ow.poczta-polska.pl/api/v3/<mój_adres_ade>/drafts/<messageID>/attachments'
dodania do wiadomości roboczej załącznika tak:
{
"fileMetadata":
{
"fileId":"EF051F45-11F4-4C6A-8596-752F7B7C76FF",
"filename":"eDoreczeniaTEST.txt",
"contentType":"text/plain",
"size":15,
"alg":"SHA-3",
"hash":"1682...54B8",
"description":"description"
}
,
"file":"VmFsaWRhdG9yIFRlc3QK"
}
a dostaję z serwera odpowiedź Bad Request 400 i treść błędu:
[
{
"error":"UAAPI0065",
"error_description":"Wrong digest value in request 1682...54B8",
"messageId":"PPSA-E-1429..."
}
]
Nie udało mi się znaleźć błędu: UAAPI0065. Wyliczałem "hash" SHA-3 dla 224, 256, 384 i 512 bitów ale nic się serwerowi nie podoba.
Porównywałem moje wartości "hash" z narzędziami zewnętrznymi dla zawartości "file" i poprawnie wyliczam - a mimo to ciągle dostaję z serwera błąd.
Czy w zapytaniu wysyła się jakąś inna wartość "alg" ?
Jako zawartość pliku wysyłam Validator Test\n jak w przykładzie/dokumentacji.

Ja dodaję załącznik do wiadomości DRAFT w endpoincie /{eDeliveryAddress}/drafts

 var xAtt = new Attachment() {

               File = new Edor.Api.UA3.FileData() {
                  File = Convert.ToBase64String(File.ReadAllBytes(xFile)),
                  FileMetadata = new FileMetadata() {
                     FileId = Guid.NewGuid().ToString(),
                     Filename = Path.GetFileName(xFile).Replace(" ", "_"),
                     ContentType = XMimeTypes.GetMimeTypeByFileName(xFile),
                     Size = new FileInfo(xFile).Length //Rozmiar trzeba podać poprawny
                  }
               }
            };
            msg.Attachments.Add(xAtt);

Nie liczę hash i mi działa.

Czołem grupa,
Tworzę wiadomość roboczą jako hybrydową. Tworzę ją z konta testowego konta przedsiębiorcy. Wiadomość robocza jest zapisywana, otrzymuję ID wiadomości. Następnie wysyłam wiadomość roboczą i dostaję zwrotnie z serwera: HTTP 400 Bad Request: treść błędu:
[
{
"error":"UAAPI0067",
"error_description":"Service available only for Public entity.",
"messageId":"PPSA-H-09..."
}
]

Z konta przedsiębiorcy nie mogę wysłać wiadomości hybrydowej do adresata publicznego?

Jest awaria edorećzeń czy to tylko u mnie ?

okatse napisał(a):

Jest awaria edorećzeń czy to tylko u mnie ?

Działa w kratkę - raz na jakiś czas coś załapie ale potem znowu nie działa

Witam serdecznie i proszę o pomoc

Wcześnie elektronicznie wysyłałem i 100MB a teraz nie mogę wysłać nawet 20MB. Pliki < 15 MB przechodzą a przecież powinno iść nawet i 500MB, CURL na długi czas więc to nie on ucina

{
"messageMetadata": {
"from": {
"eDeliveryAddress": "AE:PL-45605-23413-VECUE-26",
"address": {
"country": "Polska",
"postalCode": "02-818",
"city": "Warszawa",
"street": "Test",
"buildingNumber": "15",
"houseNumber": ""
},
"contributor": {
"companyName": "Gmina Testowo"
}
},
"to": [
{
"eDeliveryAddress": "AE:PL-32610-53574-HFGUF-28",
"contributor": {
"firstName": "",
"lastName": "",
"companyName": "TEST",
"companyNameContinued": ""
}
}
],
"subject": "test 20MB",
"shippingService": "electronic"
},
"textBody": "test 20MB",
"attachments": [
{
"attachmentId": null,
"file": {
"fileMetadata": {
"fileId": "cdcd4866-c9ca-a590-f32b-c7af5be64d6a",
"filename": "pkpadmin20MB.pdf",
"contentType": "application/pdf",
"size": 19901641,
"alg": "SHA-3",
"hash": "f0130eb022720a2103a6c66b76dd52139aa59efa0c1e530f6c6dd78786548df3",
"description": ""
},
"file": "JVBEYNCg..........=="
}
}
]
}

ma ktoś aktualny link do COI-Projekt-Techniczny-UA-API-5.21.pdf -bo ja mam z 2024 roku

Czy dziś ktoś ma problem z POBIERANIEM edoreczeń z załącznikiem <15MB ?

mógłby ktoś wrzucić SE API 4 – 4.0.0 1.yaml tutaj, mailem albo na jakiś hosting (oficjalnego linka nie znalazłem).
Nie mam dostępu do środowiska testowego a podejrzewam, że tam leży
Na https://www.gov.pl/web/e-doreczenia/interfejsy-api wrzucili tylko UAAPI V3 - 3.0.8 YAML

Ciekawe kiedy naprawią pobieranie wiadomości z załącznikiem większym od 15MB - u mnie wciąż niektóre da sie pobrać a inne nie :(
Zgłaszał ktoś jakieś incydenty do COI ?

Na COI wisi info że Poczta Polska S.A. informuje o planowanych niedostępnościach systemu OW na środowisku PROD.
Usługa e-Doręczenia będzie niedostępna.

03.03.2026 (wtorek) w godzinach 18:00-23:00 [wydanie wersji 1.4.7_P_6]. KTOŚ widział dokumentację o wersji 1,4,7_P_6 ????????????

Czołem grupa. Zabrałem się za foldery użytkownika i od razu błędy.
Nowy folder, wysyłam POST /directories :{"directoryName":"Nowy3","directoryLabel":"Nowy3Etyk"}, w odpowiedzi dostaję 403/Forbidden.
Podejrzałem jak to robią przez www i wysyłany jest POST /directories o postaci: {"directoryName":"Nowy3","directoryLabel":"Nowy3Etyk","permissions":[]}, Jak ja tak zrobię to dostaję taki komunikat: [{"error":"UAAPI0001","error_description":"Field validation error: permissions - Redundant field in method"}]
Zmiany nazwy folderu też nie mogę wykonać, też 403/Forbidden.
Próbowałem też pobrać /rule_list i też dostałem 403/Forbidden.
Użytkownik, na którego się loguję do e-Doręczeń ma role Administrator.
Rozumiem że do utworzonych folderów są uprawnienia, ale nie potrafię nawet stworzyć takiego folderu. Przez stronę www mogę tworzyć foldery użytkownika.
Gdybyście mieli jakąś sugestię co robię nie tak, bo mi się pomysły skończyły.
Pozdrawiam.

Hej.
Czy też macie dziś problemy z autoryzacją w e-doręczeniach?

W trakcie wysyłki żądania https://ow.edoreczenia.gov.pl/auth/realms/EDOR/protocol/openid-connect/token?login_hint=AE:PL-XXX
mam wyjątek:
400 Bad Request ---> System.Exception: [invalid_client] Unable to load public key

Ktoś z was spotkał się z czymś takim?

Czy ktoś może poratować plikiem yaml.dla se api v 4 ? Będę wdzięczny

Czołem grupa,
Chciałbym uzyskać NIP, REGON,KRS na podstawie adresu AE. Chodzi mi o adres AE instytucji: "Urzad testowy Piaty". A jeśli nawet nie posiada żadnego z nich to chociaż jakąś sensowną odpowiedź a nie takie 401, albo 404.
Wysyłam zapytania jako firma. W dokumentacji jest metoda POST https://int-ow.edoreczenia.gov.pl/api/se/v4/search/eda-confirmation no więc podaje dla obu parametrów ten sam adres AE a w odpowiedzi dostaję:
{
"httpCode": "401",
"id": "00017",
"errorCodeObjects": [
{
"errorCode": "SEAPI-00017",
"language": "PL",
"message": "Brak autoryzacji"
}
]
}
Kiedy podstawiam jako parametry wejściowe własny adres AE to dostaję odpowiedź z danymi.
Metoda: https://int-ow.edoreczenia.gov.pl/api/se/v4/search/eda-search sprytnie pomija w wynikach, ten adres AE, który mnie interesuje.
Metoda: https://int-ow.edoreczenia.gov.pl/api/se/v4/search/bae_search (w różnych kombinacjach) zwraca dla interesującego mnie adresu:
{
"httpCode": "404",
"id": "f77....",
"errorCodes": [
{
"errorCode": "SEAPI-00010",
"language": "EN",
"message": "No results found. Please apply less strict criteria."
}
]
}
Oczywiście przez wysłaniem powyższych zapytań, wykonuje autoryzację i używam tokena do dalszej "rozmowie" z serwerem. Proszę o wszelkie uwagi i pozdrawiam poświętach.

wysyłasz taki json
'json' => [
"recipientEdas" => szukany ade,
"senderEda" => twój ade ,
],

Jak nie znajdzie dostajesz 404 z "No results found. Please apply less strict criteria. A jak znajdzie to dostajesz jsona z danymi - nic wiecej nie trzeba

a podaje adres tego co chcesz sprawdzić

Szukałem na forum ale nie znalazłem takie przypadku. Mam problem z wyszukiwarką interesantów. Strzelam na https://int-ow.edoreczenia.gov.pl/api/se/v4/search/bae_search
i moje body wygląda tak:

{
  "recipientEdasOnly": true,
  "recipientEdas": "ADE-szukane",
  "senderEda": "ADE-moje",
  "offset": 0,
  "limit": 20
}

ale otrzymuje błąd:

{
  "errorCode": "00003",
  "language": "PL",
  "message": "Podano niepoprawną wartość enum."
}

Nie bardzo wiem co podaje nie tak, albo czego nie podaje. Wg dokumentacji jak mam recipientEdasOlny: true to tak powinno wyglądać body ale może coś źle rozumiem :D czy ktoś miał taki problem i wie co jest grane?