Połączenie Unit4 z eConnect: ERPx przez Autopilot, ERP CR przez SFTP i Financials przez HTTPS.
Unit4 oferuje w 2026 trzy warianty, z których każdy ma własną metodę integracji. To, który wariant dotyczy Państwa, zależy od posiadanego produktu Unit4.
Unit4 ERPx łączy się przez Autopilot. Faktury zakupowe są automatycznie wczytywane i księgowane. Konfiguracja jest ustawiana podczas wdrożenia z eConnect.
Konfiguracja Autopilota odbywa się przez kreatora krok po kroku na platformie eConnect:
Uwaga: najpierw przetwórz wszystkie dokumenty przez dotychczasową ścieżkę, zanim przejdziesz na nową. Konfiguracji połączenia klient nie wykonuje samodzielnie — odbywa się ona podczas wdrożenia.
Podczas księgowania przez Unit4 ERPx może pojawić się komunikat [U4OK.JSON]: System.Int32 overflow. Przyczyna: numer faktury jest numerycznie tak duży, że przekracza limit 32-bitowej liczby całkowitej (maksymalnie 2.147.483.647). W tej części przetwarzania Unit4 system nie może obsłużyć numeru. Jest to ograniczenie po stronie Unit4, a nie połączenia eConnect ani naszego kodu integracji.
W praktyce widać to u organizacji stosujących bardzo wysokie serie numerów faktur wychodzących (na przykład wartości znacznie powyżej 2 miliardów).
Co można zrobić? Rozwiązanie musi pochodzić od Unit4. Zmiana numeru faktury w XML źródłowym przez eConnect nie jest wykonalnym obejściem bez ryzyka dla administracji i numeracji. Unit4 ma o tym świadomość i pracuje nad trwałą poprawką. Do tego czasu: eskaluj do administratora lub partnera Unit4 i w razie potrzeby użyj pobrania XML z platformy eConnect (Skrzynka odbiorcza IN), aby udokumentować przypadek.
Unit4 ERP CR (w tym ERP7) i Unit4 Financials by Coda łączą się odpowiednio przez SFTP i HTTPS. Te połączenia enterprise wymagają umowy i są konfigurowane przez Unit4 lub partnera Unit4 we współpracy z eConnect.
Standardową metodą integracji dla Unit4 ERP CR i ERP7 jest SFTP (Secure File Transfer Protocol). Więcej informacji o tym, jak technicznie konfiguruje się połączenie SFTP, znajduje się w artykule Integracja SFTP.
W przeszłości zdarzało się, że faktura została pomyślnie zaksięgowana w Unit4 ERPx, ale załącznik PDF nie został przesłany. Przyczyną było zerwanie połączenia po stronie Unit4, w wyniku którego PDF został utracony. Od maja 2026 takie przypadki są automatycznie ponawiane, co potwierdził zespół Platform & Integraties. W większości sytuacji problem ten nie występuje już ponownie.
Jeśli nadal napotkasz przypadek, w którym faktura jest zaksięgowana, ale brakuje załącznika PDF, jest to przypadek resztkowy. Postępuj wtedy według ścieżki diagnostycznej poniżej, aby ustalić, czy dokument rzeczywiście został utracony, czy chodzi o idempotentne dopasowanie.
Wskazówka: samą fakturę zawsze można pobrać z platformy eConnect (Skrzynka odbiorcza IN, trzy kropki przy dokumencie). W razie potrzeby prześlij dokument ręcznie do administratora Unit4.
Unit4 ERPx nie może przetworzyć faktur zakupowych bez daty płatności (DueDate/PaymentDueDate); pole nie jest wymagane w XML. Gdy przychodzi faktura bez tego pola, eConnect domyślnie ustawia PaymentDueDate na IssueDate (datę faktury) plus 30 dni. Dzięki temu unikamy niepowodzenia księgowania z powodu formalnie brakującego pola, podczas gdy faktyczny termin płatności w praktyce zwykle wynosi 30 dni.
Jest to standardowe Rule Based Enrichment (RBE), konfigurowane per klient jako PrivateObject w PSB (zazwyczaj z Id unit4-setDueDate-30days). Jeśli chcesz użyć innego domyślnego terminu, skontaktuj się z supportem; nie jest to ustawienie self-service.
Ta ścieżka diagnostyczna dotyczy zgłoszeń typu „faktura ma status Booked w eConnect, ale nie widzę jej w ERPx” lub „faktura chyba nigdy nie dotarła, Document Journal nic nie pokazuje”. Tło: trasa Autopilot ↔ Unit4 ERPx jest idempotentna (dopasowanie po numerze faktury, kliencie i dostawcy). Przy dopasowaniu eConnect nie wywołuje ERPx ponownie i przesyła tylko brakujący PDF, podczas gdy platforma nadal pokazuje Booked. Pusty Document Journal dla drugiej prezentacji zwykle nie oznacza utraty faktury, lecz aktywację kontroli idempotentnej. Zobacz także Autopilot — idempotentne księgowanie.
Interpretacja etykiet statusu różni się w zależności od typu połączenia. Ustal, czy chodzi o Autopilot (Unit4 ERPx), inną trasę PSB, bezpośrednie SOAP API czy połączenie SFTP. Zobacz tabelę statusów w Autopilot — statusy księgowania, aby poznać znaczenie dla każdego typu połączenia.
Zanotuj co najmniej jeden z tych dwóch identyfikatorów dokumentu:
documentId (z PSB), lubconsignmentId (z platformy).Jeden z nich wystarczy, aby wyszukać dokument we wszystkich systemach wewnętrznych.
Otwórz dokument w wewnętrznym Management API po documentId lub consignmentId i przejrzyj oś czasu Events. Widać w niej dla każdego kroku, jakie działanie wykonano na dokumencie: odbiór, walidacja, prezentacja do ERPx, ponowienia, idempotentne dopasowanie i upload PDF. W przypadku połączeń SFTP jest to jedyne miejsce, w którym widać status dostarczenia, ponieważ pakiet oprogramowania przez SFTP nie zwraca informacji o statusie.
Czy na osi czasu Events widać, że eConnect rozpoznał fakturę jako istniejącą (ten sam numer faktury, klient i dostawca) i wykonał tylko upload PDF? Wtedy jest to oczekiwane zachowanie. Faktura była już w ERPx z wcześniejszej prezentacji. Przekaż to klientowi; eskalacja nie jest potrzebna.
Tylko gdy oś czasu Events nie daje pełnego obrazu, eskaluj do zespołu technicznego. Podaj co najmniej:
documentId lub consignmentId,partyId odbiorcy,Podczas przetwarzania faktur przez transformację ABWInvoice (używaną w integracjach Agresso/Unit4) może pojawić się komunikat [API400]: Initializing failed. Unhandled error occurred. Przyczyną jest to, że transformacja została zbudowana na podstawie pierwotnych dokumentów testowych. Odbiegające warianty dokumentów (np. faktury free text) zawierają pola, których brakuje w mapowaniu, przez co transformacja kończy się niepowodzeniem.
Trwa wniosek o rozszerzenie transformacji o więcej typów dokumentów. Jeśli napotkasz ten komunikat, skontaktuj się z supportem.
W integracjach Unit4 z walutą obcą (np. USD z kursem) konfiguracja walut jest odpowiedzialnością klienta w środowisku Unit4. eConnect przetwarza to, co dostarcza ERP. Pytania supportowe dotyczące walut obcych kieruj do konfiguracji ERP klienta.
Komunikaty o błędach zaczynające się od prefiksu U4 pochodzą z Unit4 ERPx. Rozwiązanie prawie zawsze leży po stronie Unit4. Plik XML można samodzielnie pobrać z platformy eConnect (Skrzynka odbiorcza IN, trzy kropki przy dokumencie) i przesłać do administratora Unit4.
Mapowanie VAT: różnica między fakturami przychodzącymi i wychodzącymi
Dla faktur przychodzących (Autopilot) eConnect obsługuje mapowanie VAT. Schemat konfiguruje się przez Platforma > Autopilot > Połączenie > Schemat księgowania > ZARZĄDZAJ SCHEMATAMI > VAT. Dla faktur wychodzących eConnect nie wykonuje mapowania VAT: Unit4 musi sam dostarczyć prawidłowe kody UNCL5305 w XML faktury.
To ogólny komunikat o błędzie, który może mieć wiele przyczyn: timeout po stronie Unit4, faktura z więcej niż 200 wierszami, wiersze faktury z kwotą € 0 lub zduplikowane kody VAT w schemacie księgowania. Przedstaw fakturę ponownie przez Skrzynkę odbiorczą IN. Jeśli błąd się utrzymuje, zaksięguj fakturę ręcznie w ERPx i sprawdź schemat VAT pod kątem duplikatów.
Kombinacja dostawcy i numeru faktury już istnieje w Unit4. Sprawdź, czy faktura była wcześniej prezentowana (np. inną trasą) i czy IDR poprawnie rozpoznał numer faktury. Jeśli faktura jest rzeczywiście duplikatem, nie musisz nic robić. Jeśli to inny dokument z tym samym numerem, sprawdź rozpoznanie na platformie eConnect.
XML faktury zawiera kod VAT, którego nie ma w schemacie księgowania Autopilot. Dzieje się to głównie przy fakturach przychodzących e-mailem z odmiennym lub błędnym kodem VAT. Dodaj brakujące mapowanie przez Platforma > Autopilot > Połączenie > Schemat księgowania > ZARZĄDZAJ SCHEMATAMI > VAT albo poproś dostawcę o wysłanie faktury przez Peppol (co skutkuje użyciem standardowych kodów VAT).
Wierzyciel w Unit4 ERPx nie ma ustawionego terminu płatności (warunku płatności). eConnect sam nie przekazuje daty płatności do Unit4. Ustaw termin płatności na karcie dostawcy w Unit4 ERPx.
Dummy Crediteur w Unit4 nie jest aktywny. Aktywuj Dummy Crediteur w Unit4 ERPx i przedstaw faktury ponownie.
Suma faktury wynosi € 0,00. Faktury bez kwoty nie można zaksięgować w Unit4.
Okres księgowy (boekingscyclus) w Unit4 ERPx nie jest poprawnie skonfigurowany lub nie jest aktywny dla danego okresu. Sprawdź i aktywuj właściwy okres księgowy w Unit4.
Identyfikator płatności na fakturze ma więcej niż 27 znaków, czego Unit4 nie akceptuje. Tymczasowo możesz wysłać fakturę jako PDF zamiast przez automatyczne połączenie. Trwale dostawca musi skrócić identyfikator płatności.
Użytkownik machine-to-machine (M2M), przez którego eConnect loguje się do Unit4, ma niewystarczające uprawnienia lub został dezaktywowany. Poproś administratora Unit4 o sprawdzenie i przywrócenie uprawnień użytkownika M2M-eConnect.
Faktura została zaksięgowana na Dummy Crediteur, ale wcześniejszy dokument z tym samym numerem faktury już tam występuje. Najpierw przetwórz istniejącą fakturę na Dummy Crediteur, a następnie przedstaw nową fakturę ponownie.
Konfiguracja routingu w Unit4 ERPx nie ma węzła dla wskazanego workflow. To problem po stronie Unit4. Pobierz XML z platformy eConnect i prześlij go do administratora Unit4, aby dostosować routing.
Dołączony PDF zawiera nieprawidłowy prefiks „data” w danych Base64 (np. dataJVBERi0x... zamiast JVBERi0x...). Dla faktur przychodzących przez IDR jest to korygowane automatycznie. Dla faktur przychodzących bezpośrednio przez Peppol problem ten może nadal występować. Nadawca źródłowy musi poprawić XML.
Unit4 ERPx łączy się przez Autopilot w celu automatycznego odbioru faktur zakupowych. Unit4 ERP CR i ERP7 używają SFTP, a Unit4 Financials by Coda łączy się przez HTTPS. Oba ostatnie warianty wymagają umowy i są konfigurowane przez Unit4 lub partnera Unit4.
W przypadku Unit4 ERPx konfiguracja jest ustawiana podczas wdrożenia z eConnect, a nie samodzielnie przez klienta. W przypadku Unit4 ERP CR i Financials by Coda konfigurację wykonuje Unit4 lub partner Unit4 we współpracy z eConnect.
::e-accordion-item{value="item-3" header="Co zrobić przy komunikacie "Int32 overflow" dla dużych numerów faktur?"} To ograniczenie po stronie Unit4, gdy numer faktury przekracza 2.147.483.647. Rozwiązanie musi pochodzić od Unit4. Eskaluj do administratora lub partnera Unit4 i w razie potrzeby użyj pobrania XML z platformy eConnect, aby udokumentować przypadek. ::
Chcesz połączyć Unit4? Skontaktuj się z Unit4 lub swoim partnerem Unit4 albo z eConnect sales w celu rozmowy wstępnej.
Rozpocznij połączenie