Komunikaty błędów i rozwiązania według pakietu ERP. Ten artykuł omawia błędy specyficzne dla każdego pakietu. W przypadku ogólnych problemów z API, webhookami i łącznością: zobacz Rozwiązywanie problemów z integracjami.

Komunikaty błędów z prefiksem U4 pochodzą z Unit4 ERPx. Rozwiązanie leży prawie zawsze po stronie oprogramowania, a nie w eConnect. Klient może pobrać plik XML z platformy i przekazać go administratorowi Unit4.

Kompensacja DueDate: Unit4 nie może przetwarzać faktur bez DueDate/PaymentDueDate (pole nie jest wymagane w XML). eConnect domyślnie ustawia PaymentDueDate na IssueDate (datę faktury) plus 30 dni, gdy to pole jest puste. Jest to standardowe Rule Based Enrichment, konfigurowane dla każdego klienta jako PrivateObject w PSB (zazwyczaj z Id unit4-setDueDate-30days).

Faktura zaksięgowana, ale brakuje załącznika PDF: wcześniejsze przerwy w połączeniu po stronie Unit4, gdzie PDF był tracony, są teraz ponawiane (potwierdzone przez Platform & Integracje, maj 2026). Pozostałe przypadki: zobacz ścieżkę diagnostyczną poniżej.

UBW to klasyczna nazwa Agresso/UBW; w ramach eConnect używamy jej jako aliasu wyszukiwania obok Unit4 ERPx, gdzie odbywa się to przekazywanie.

Symptom: faktura przychodząca (często nie-Peppol) została ręcznie wysłana e-mailem na @trust.econnect.eu, jest widoczna na platformie, ale jeszcze nie znajduje się w UBW/Agresso lub połączonym pakiecie finansowym. Zobacz także Email Receiver w celu obsługi wpływu przez ten adres.

Najpierw dokonaj tego rozróżnienia, przed eskalacją:

1. Tymczasowe opóźnienie wsadowe lub przekazywania: dokument prawidłowo znajduje się na platformie, ale automatyczny proces odbioru lub księgowania klienta musi jeszcze zadziałać lub jest właśnie w toku. To zwykle rozwiązuje się samo; nie ma awarii.
2. Trwale nie dotarła: po oczekiwanym uruchomieniu faktura nadal jest nieobecna. Kontynuuj wtedy z Diagnostyka: faktura nie dotarła do ERPx bez komunikatu błędu poniżej (typ integracji, documentId/consignmentId, Events, idempotentność między Autopilot i ERPx).

Przy nowym zgłoszeniu:

1. Potwierdź widoczność i status faktury na platformie.
2. Zapytaj o typ integracji lub pakiet ERP (UBW/Agresso, Unit4 ERPx przez Autopilot, SFTP/PSB, ...) oraz czy automatyczny proces już działał dzisiaj.
3. Proces jeszcze nie działał lub jest w toku? Zaczekaj wtedy chwilę i potwierdź po uruchomieniu. Nie eskaluj przedwczesnie.
4. Proces działał i faktura wciąż trwale nie występuje? Zbierz identyfikatory i postępuj według ścieżki diagnostycznej poniżej.

Nie istnieje sztywne SLA w godzinach między przesłaniem przez Email Receiver a przetworzeniem w UBW/ERPx.

Ta ścieżka dotyczy skarg takich jak „Zaksięgowane w eConnect, ale niewidoczne w ERPx" lub „Faktura wydaje się nigdy nie dotrzeć, brak komunikatu w Document Journal".

Kontekst: Trasa Autopilot -- Unit4 ERPx jest idempotentna (dopasowanie na numer faktury + klient + dostawca). W przypadku dopasowania ERPx nie jest ponownie wywoływany i przesyłany jest tylko brakujący PDF, podczas gdy platforma nadal wyświetla Booked. Pusty Document Journal dla drugiego przesłania nie oznacza zatem, że faktura zaginęła, ale zazwyczaj że została aktywowana weryfikacja idempotentna.

Sprawdź to najpierw u partnera Unit4 z wieloma fakturami:

0. Tylko dostawa, brak dziennika: status Delivered/Odebrano w skrzynce odbiorczej z 0 wynikami w Document Journals oznacza, że jeszcze nie doszło do żadnej próby księgowania Autopilot (Booked/Booking failed). Najpierw prześlij ponownie faktury do połączonego oprogramowania; badanie Events zacznij tylko po tym. Zobacz Autopilot -- Dzienniki dokumentów.
1. Rozdziel strony: klient odbierający (użytkownik ERPx) nie jest tym samym, co dostawca na fakturze, ani tym samym, co ewentualna strona pośrednia w dołączonym logu.
2. Właściwy log lub dokument: sprawdź, czy załącznik lub log eConnect to zgłaszany dokument (numer faktury, dostawca do odbiorcy). Błędny log to inny dokument; nie zaczynaj na nim badania ERPx.
3. Identyfikator na zgłoszoną fakturę: co najmniej numer faktury, najlepiej także documentId lub consignmentId. Wiele brakujących numerów faktur to odrębne dokumenty; Booked na fakturze A nie obejmuje faktury B.
4. Booked plus błąd duplikatu (np. invoice number already exists, lub po ponownym przesłaniu): często ten sam numer faktury został wysłany ponownie. Platforma może pokazywać Booked na wcześniejszym księgowaniu; to nie jest dowód, że inny numer faktury jest w ERPx. Potwierdź to przez Events (krok 3 poniżej) lub istniejącą rejestrację ERPx.

Kroki:

Transformacja ABWInvoice została zbudowana na podstawie oryginalnych dokumentów testowych. Niestandardowe warianty dokumentów (np. faktury w formacie swobodnym) mogą kończyć się niepowodzeniem z "API400: Initializing failed". Rozwiązanie: wniosek o zmianę do zespołu deweloperskiego w celu rozszerzenia transformacji.

Komunikaty błędów z prefiksem BC pochodzą z Business Central. Mały wpływ ze strony eConnect; klient musi sprawdzić konfigurację BC.

Prefiks w nawiasach kwadratowych wskazuje typ odpowiedzi, którą eConnect otrzymał od Business Central podczas księgowania faktury:

• [BC400] -- żądanie odrzucone przez Business Central (BC zwróciło błąd typu 400). Jest to prawie zawsze błąd walidacji lub relacji tabeli w konfiguracji BC klienta (np. brakująca wartość w powiązanej tabeli lub pole niespełniające warunku BC). Tekst bezpośrednio po [BC400]: (jak Internal_InvalidTableRelation lub Application_FieldValidationException) nazywa konkretny błąd BC i wskazuje pole lub tabelę do poprawienia.
• [BCBadRequest] / [BCNotFound] / [BCTooManyRequests] -- podobne odpowiedzi po stronie BC (odrzucone żądanie, nie znaleziono, limit szybkości).
• [API400] -- odrzucone przez samo API eConnect, dla BC (np. nieprawidłowe ustawienie połączenia).

We wszystkich przypadkach prefiksu BC rozwiązanie leży po stronie BC (konfiguracja klienta); eConnect ma tu mały wpływ.

Znana awaria? Najpierw sprawdź status.exact.com pod kątem aktualnych awarii Exact -- niezależnie od własnej strony statusu eConnect (support.econnect.eu/status/). Awaria po stronie Exact (np. Exact Online, Exact API) czasem wyjaśnia błędy, które nie wynikają z integracji eConnect.

Połączenie: SOAP-enterprise, tylko odbieranie (zakupy). Konfiguracja: Połącz ECI Inventive.

Dwie przyczyny, nie mylić ich:

1. Zakłócenie platformy eConnect: na przykład brakujące załączniki PDF. Sprawdź status faktury w Skrzynce odbiorczej eConnect.
2. Własny błąd walidacji payloadu po stronie Inventive: poza zakresem wsparcia eConnect. Administrator Inventive to bada.

Status "przetworzone" w Skrzynce odbiorczej eConnect oznacza, że eConnect prawidłowo dostarczył faktury. Jeśli faktura wciąż brakuje w Inventive, sprawdź najpierw payload/import Inventive (zadania wsadowe), nie ponownie odbiór eConnect.

Dla każdego pakietu ERP obowiązują następujące kroki:

1. Testuj połączenie: wszystkie pakiety wymagają portu 443 do punktu końcowego eConnect.
2. Odwołaj integrację oprogramowania: Platforma > Połączenia > Odwołaj klucz > usuń też z połączonego oprogramowania.
3. Prześlij dokumenty ponownie: Skrzynka odbiorcza/nadawcza > trzy kropki > "Prześlij ponownie pobieranie API". Przy oznaczeniu jako duplikat, najpierw "Oznacz jako oryginał".