7.bledy-przy-wysylaniu

Najczęstsze komunikaty o błędach przy wysyłaniu faktur przez eConnect, z przyczynami i rozwiązaniami.

Podczas wysyłania faktury przez platformę eConnect może pojawić się komunikat o błędzie. Większość błędów jest związana z brakującymi lub nieprawidłowymi danymi w fakturze. Poniżej opisane są najczęstsze komunikaty, ich przyczyny i sposoby rozwiązania.

Nieznane błędy / błędy walidacji identyfikatora
Nieznany błąd podczas wywoływania zdarzenia aplikacji

Ten ogólny komunikat o błędzie jest wywoływany przez walidację przed wysyłką w interfejsie platformy. Platforma sprawdza przed wysyłką, czy wartość identyfikatora (np. OINO, numer rejestrowy) odpowiada oczekiwanemu formatowi. Jeśli ta weryfikacja się nie powiedzie, pojawia się ten komunikat o błędzie.

Częsty przykład: schemeID 0190 (OINO) wymaga dokładnie 20 cyfr. Jeśli wartość zawiera prefix — np. NL:OINO:00000001001932779000 zamiast po prostu 00000001001932779000 — walidacja kończy się niepowodzeniem.

Uwaga: ten błąd może wystąpić również w przypadku faktur utworzonych przez API, nie tylko ręcznie.

Rozwiązanie: sprawdzenie wartości identyfikatora i usunięcie ewentualnych prefiksów lub nieprawidłowych znaków. Wartość musi dokładnie odpowiadać oczekiwanemu formatowi dla schemeID (np. 20 cyfr dla OINO, 8 cyfr dla numeru rejestrowego).

Ogólna zasada -- wpisuj tylko wartość numeryczną; platforma automatycznie dodaje prefiks schemeID. Dotyczy to wszystkich schematów identyfikacji, nie tylko OINO. Jeśli użytkownik również samodzielnie wpisuje prefiks (np. 0088:1234567890123 podczas gdy schemat jest już ustawiony na GLN/0088), walidacja formatu kończy się błędem. Przykład GLN (schemeID 0088, GS1): wybierz schemat GLN i wpisz w polu wartości tylko cyfry GLN -- bez 0088: na początku.

Numer OIN z apostrofem: faktura dostarczona jako dokument wewnętrzny

Jeśli dostawca umieszcza apostrof przed numerem OIN w XML (znany artefakt Excela), routing Peppol kończy się niepowodzeniem. Starszy system rozpoznaje fakturę i dostarcza ją wewnętrznie — odbiorca nie widzi faktury w swojej skrzynce zobowiązań, ale otrzymuje e-mail powiadomienia z linkiem.

Rozwiązanie: proś dostawcę o podanie numeru OIN bez apostrofu w XML i o sprawdzenie ustawień eksportu Excela.

Błędy walidacji (kody BR)

Platforma waliduje każdą fakturę zgodnie z obowiązującymi standardami Peppol i NLCIUS przed wysłaniem. Kody błędów zaczynające się od BR (Business Rule) wskazują, która reguła nie została spełniona.

BR-NL-1: Dostawca nieprawidłowo ustawiony

Własna organizacja (dostawca) nie jest prawidłowo wybrana w fakturze. Dzieje się tak, gdy pole dostawcy zostało ręcznie zmienione lub gdy organizacja nie została jeszcze aktywowana.

Rozwiązanie: kliknięcie ikony ołówka obok "Dostawca" i ponowne wybranie własnej organizacji. Jeśli organizacja nie została jeszcze aktywowana, należy to zrobić zgodnie z artykułem Dodawanie i aktywacja organizacji.

BR-CL-24: Nieobsługiwany typ załącznika

Dodany załącznik ma typ MIME, który nie jest dozwolony w aktualnej walidacji Peppol BIS Billing V3. Dozwolone typy załączników to (BT-125):

TypOpisPDF (application/pdf)Najczęstszy załącznikPNG (image/png)ObrazJPEG (image/jpeg)ObrazCSV (text/csv)Dane arkusza kalkulacyjnego jako tekstXLSX (application/vnd.openxmlformats-officedocument.spreadsheetml.sheet)Arkusz ExcelODS (application/vnd.oasis.opendocument.spreadsheet)Arkusz OpenDocument

application/xml nie jest dozwolony jako typ MIME załącznika w aktualnej walidacji BIS Billing V3. XML jako załącznik należy do EN 16931-1:2026 i przyszłej wersji Peppol (prawdopodobnie BIS Billing 4.0) — nie dodawaj załącznika XML, aby rozwiązać problem BR-CL-24.

Częsta przyczyna (Business Central i inne systemy ERP): system ERP automatycznie dołącza pliki przypisane do zaksiegośowanej faktury. Załącznik z niedozwolonym typem (np. dokument Word) powoduje błąd BR-CL-24.

Rozwiązanie:

  1. Sprawdź, jakie załączniki są przypisane do faktury w systemie ERP (Business Central: Zaksiegośowana faktura sprzedaży > Załączniki).
  2. Usuń lub zastąp załączniki z niedozwolonym typem — np. przekonwertuj dokument Word na PDF.
  3. Wyślij fakturę ponownie.
BR-CL-23: Jednostka (unit code) nierozpoznana

Jednostka wpisana przy pozycji faktury nie jest rozpoznawana jako prawidłowy kod UN/ECE. Dzieje się tak przy użyciu skrótu lub własnej nazwy.

Rozwiązanie: użycie standardowej jednostki z listy wyboru, takiej jak "Sztuki" (EA), "Godziny" (HUR) lub "Dni" (DAY).

BR-CL-25 / BR-NL-BFR-2: OrganisatieID i Wyślij przez niezgodne

Typ identyfikatora w polu "OrganisatieID" nie zgadza się z typem w polu "Wyślij przez". Na przykład: OrganisatieID jest ustawione na OIN, ale "Wyślij przez" na KvK.

Rozwiązanie: upewnienie się, że oba pola używają tego samego typu identyfikatora.

BR-S-02: Brak numeru VAT

Numer VAT dostawcy jest nieobecny w fakturze.

Rozwiązanie: uzupełnienie numeru VAT w ustawieniach organizacji.

Jeżeli Twoja organizacja nie posiada numeru VAT (np. fundacja, organ publiczny lub usługodawca zdrowotny świadczący wyłącznie usługi zwolnione z VAT)? Nie używaj wartości zastępczej NL000000000B01. Zamiast tego wybierz kategorię VAT 'O' — poza zakresem VAT podczas wystawiania faktury. Przy kategorii 'O' obowiązek podania numeru VAT znika, a faktura spełnia standard Peppol. Zob. także Odwrotne obciążenie VAT i kategoria VAT O po objaśnienie kodów kategorii VAT.

Organizacje zwolnione z VAT: kategoria O

Fundacje, niektóre organy publiczne i usługodawcy zdrowotni świadczący wyłącznie usługi zwolnione z VAT nie posiadają numeru VAT. Podczas tworzenia faktury na platformie pojawia się wymog podania numeru VAT dostawcy.

Rozwiązanie: Wybierz kategorię VAT 'O' — poza zakresem VAT (kod UNCL5305 O, "Services outside scope of tax") w formularzu fakturowania. Przy kategorii 'O' wymog interfejsu dla pola numer VAT znika i faktura może zostać wysłana bez numeru VAT dostawcy.

Nie używaj fikcyjnych numerów VAT takich jak NL000000000B01 — to nie jest przewidziane rozwiązanie dla tego scenariusza. Kategoria 'O' jest prawidłowym wybórem dla organizacji bez obowiązku VAT.

Różnica 'E' i 'O': Kategoria VAT 'E' (Exempt from VAT) jest przeznaczona dla podatników VAT fakturujących określoną transakcję zwolnioną. Kategoria 'E' wymaga numeru VAT. Kategoria 'O' jest dla organizacji bez jakiegokolwiek obowiązku VAT.

BR-NL-BFR-3: IBAN wymagany

Przy fakturowaniu instytucji rządowych wymagany jest numer IBAN.

Rozwiązanie: uzupełnienie numeru IBAN w danych płatności faktury.

NL-R-005 / NL-R-003: CompanyID nie zawiera numeru rejestrowego

Błąd ten występuje, gdy CompanyID zawiera numer VAT zamiast numeru rejestrowego lub OIN.

Technicznie: EndpointID i CompanyID to dwa oddzielne pola o różnym przeznaczeniu. EndpointID określa routing przez Peppol i akceptuje każdy typ z listy kodów EAS. CompanyID identyfikuje podmiot prawny.

Rozwiązanie: sprawdzenie UBL generowanego przez system i upewnienie się, że CompanyID zawiera numer rejestrowy lub OIN.

BR-AE-10: odwrotne obciążenie VAT (AE) bez powodu zwolnienia

Warianty wyszukiwania: „BR-AE-10”, „SOAP:CLIENTBR-AE-10”, „Reverse charge shall have a VAT exemption reason”, „BT-120”, „BT-121”, „brak powodu zwolnienia odwrotne obciążenie”, „faktury odrzucone reverse charge”.

BR-AE-10 występuje, gdy kategoria VAT AE (Reverse Charge) w zestawieniu VAT (BG-23) nie zawiera powodu zwolnienia: ani BT-121 (kod), ani BT-120 (tekst, np. „Reverse charge”). To błąd w dostarczonym UBL z ERP lub pakietu fakturującego -- eConnect waliduje fakturę, ale nie modyfikuje automatycznie pól AE.

Rozwiązanie:

  1. Sprawdź, czy każda pozycja lub doliczenie faktury z kategorią VAT AE ma stawkę VAT 0%.
  2. W eksporcie UBL systemu źródłowego uzupełnij pole TaxExemptionReason (BT-120) i/lub kod (BT-121) dla każdego zestawienia AE.
  3. Zwaliduj fakturę wcześniej przez Document Validator.
  4. Wyślij ponownie skorygowaną fakturę -- ponowne wysłanie oryginalnego, błędnego XML nie rozwiązuje tego problemu.

Zob. także Odwrotne obciążenie VAT: kody K, AE i G po pełne wyjaśnienie kodów odwrotnego obciążenia VAT.

BR-CO-10 / BR-CO-13 / BR-CO-14 / BR-S-* / BR-E-*: błędne obliczenie kwoty VAT

Te reguły walidacji EN 16931 sprawdzają, czy zestawienie VAT i sumy faktury są wzajemnie spójne. Wartości są obliczane przez wysyłane oprogramowanie — nie są to pola, które można poprawić w interfejsie eConnect.

Kod błęduCo sprawdza regułaBR-CO-10Suma kwot pozycji musi odpowiadać kwocie całkowitej bez VATBR-CO-13Kwota całkowita bez VAT = suma pozycji minus rabaty plus dopłaty na poziomie fakturyBR-CO-14Kwota całkowita VAT = suma VAT według kategoriiBR-S-01Zestawienie VAT zawiera co najmniej jedną kategorię S dla pozycji ze stawką podstawowąBR-S-08Obliczenie VAT według stawki odpowiada pozycjom podrzędnymBR-E-02/03/04Faktura z kategorią E (Exempt from VAT) wymaga numeru VAT dostawcy lub identyfikatora podatkowegoBR-CO-12Suma dopłat na poziomie faktury (BT-108) musi być równa sumie poszczególnych dopłat dokumentu (BT-99)BR-E-01Dla pozycji faktury, dopłaty lub rabatu dokumentu z kategorią VAT 'Zwolniony z VAT' (E) zestawienie VAT musi zawierać co najmniej jeden odpowiadający powód zwolnienia Exempt

Warianty wyszukiwania BR-CO-12 / BR-E-01: "BR-CO-12", "BR-E-01", "ChargeTotalAmount", "BT-108", "suma dopłat się nie zgadza", "koszty wysyłki nie na pozycji faktury", "Shipping costs AllowanceCharge", "brak zestawienia Exempt".

BR-CO-12 występuje, gdy suma dopłat na poziomie faktury nie zgadza się z sumą poszczególnych dopłat dokumentu — na przykład gdy koszty wysyłki są ujęte jako osobny AllowanceCharge na poziomie faktury (ChargeIndicator=true, powód "Shipping costs" / kod FC). Jest to prawidłowy UBL; zobacz Dopłaty i rabaty po strukturę. BR-E-01 występuje, gdy pozycja faktury, dopłata lub rabat dokumentu z kategorią VAT 'Zwolniony z VAT' (E) nie ma odpowiadającego zestawienia Exempt w podsumowaniu VAT.

Częsta przyczyna: zaokrąglanie VAT od każdej pozycji zamiast według stawki VAT lub niezgodność między kwotami pozycji a rabatami na poziomie faktury.

Rozwiązanie: skontaktowanie się z dostawcą wysyłanego oprogramowania w celu korekty. eConnect nie może poprawiać tych wartości, ponieważ obliczenie jest ustalone w dostarczonym XML.

BR-S-08 -- druga przyczyna: brak lub pusta ilość na pozycji faktury

Warianty wyszukiwania: „Invalid payload BR-S-08”, „Delivery Failed BR-S-08”, „podsumowanie VAT się nie zgadza”, „pozycja faktury bez ilości”, „brak ilości pozycji faktury”, „BT-116”, „VAT category taxable amount”.

Oprócz błędów zaokrąglenia BR-S-08 występuje również, gdy pozycja faktury nie ma ilości (lub ma pustą ilość) (Invoiced quantity / BT-129). W takim przypadku kwota pozycji bez VAT jest nieprawidłowa (ilość x cena jednostkowa plus dopłaty pozycji minus rabaty pozycji), przez co suma pozycji odbiega od VAT category taxable amount (BT-116) w zestawieniu VAT dla Standard rated. Dosłowny komunikat błędu często wygląda tak: Invalid payload. [BR-S-08]-For each different value of VAT category rate (BT-119) where the VAT category code (BT-118) is Standard rated, the VAT category taxable amount (BT-116)....

Różnica względem błędów xs:decimal: w sekcji „'nie jest prawidłowym xs:decimal'” powyżej samo pole kwoty nie jest prawidłową liczbą dziesiętną (puste lub notacja naukowa). Przy BR-S-08 pole kwoty jest prawidłową liczbą, ale obliczenie między kwotami pozycji a zestawieniem VAT się nie zgadza.

Lista kontrolna pierwszej linii (przed eskalacją do dostawcy oprogramowania):

  1. Sprawdź wszystkie pozycje faktury pod kątem wypełnionej ilości i kwoty pozycji bez VAT.
  2. Kwota pozycji = ilość x cena jednostkowa (plus dopłaty pozycji, minus rabaty pozycji); żadnych pustych pól kwoty.
  3. Zleć ponowne obliczenie sum VAT w systemie źródłowym.
  4. Wyślij skorygowaną fakturę przez Peppol. Ponowne wysłanie tego samego dokumentu bez korekty nie rozwiązuje BR-S-08 -- Wyślij ponownie w skrzynce wychodzącej nie zmienia kwot pozycji ani VAT (ten sam zakres ponownego wysyłania co przy R120 powyżej).
  5. Błąd nadal występuje przy kompletnych ilościach? Wtedy chodzi o błąd zaokrąglenia lub inny błąd obliczeniowy w ERP lub eksporcie UBL -- przekaż do dostawcy oprogramowania.

Kategoria VAT E vs. O: czy organizacja nie posiada numeru VAT (fundacja, organ publiczny, ochrona zdrowia)? Użyj kategorii O (poza zakresem VAT) — zob. sekcję »Organizacje zwolnione z VAT: kategoria O« powyżej. Kategoria E zawsze wymaga numeru VAT.

PEPPOL-EN16931-R120: rabat liniowy przekracza cenę artykułu

R120 to reguła obliczeniowa, która sprawdza, czy LineExtensionAmount = (Quantity × PriceAmount ÷ BaseQuantity) + dopłaty − rabaty. R120 nie zabrania wprost kwot ujemnych; walidacja kończy się niepowodzeniem, gdy obliczenie nie jest spójne. Zdarza się to często, gdy rabat na poziomie pozycji (AllowanceCharge na poziomie pozycji) przekracza cenę artykułu.

Rozwiązanie: użyj kwoty netto korekty bezpośrednio jako PriceAmount i pomiń element AllowanceCharge w linii. Szczegóły i przykład XML znajdziesz w artykule o dopłatach i rabatach.

Błędy specyficzne dla krajów
Fakturowanie do Belgii: belgijski ID Peppol i format BE:EN

Belgijskie ID Peppol mogą mieć dwie formy:

PrefixZnaczenie0208:Belgijski numer przedsiębiorstwa (KBO), musi być zarejestrowany jako pierwszy9925:Belgijski numer VAT (BE + 10 cyfr; BE1xxxxxxxxx jest ważny od 2025)

Format numeru VAT: BE plus dokładnie 10 cyfr (dodać wiodące zera jeśli potrzebne). Weryfikacja numeru VAT możliwa za pomocą narzędzia VIES Komisji Europejskiej (ec.europa.eu/taxation_customs/vies).

Opcja Peppol nie pojawia się dla belgijskiego dłużnika? Sprawdzenie, z jakim typem identyfikatora dłużnik jest zarejestrowany w Peppol. Niektóre belgijskie organizacje są zarejestrowane tylko przez 0208: (KBO), a nie przez 9925: (VAT). W takim przypadku spróbować numeru KBO: numer VAT bez BE na początku (np. dla BE0123456789 numer przedsiębiorstwa to 0123456789; dla BE1xxxxxxxxx to 1xxxxxxxxx -- oba prefiksy są ważne).

Inne: ujemne kwoty pozycji nie są dozwolone w fakturach belgijskich; użyć ujemnej ilości z pozytywną ceną.

Fakturowanie do Niemiec (XRechnung): kody błędów BR-DE-*

Kody błędów BR-DE-* to niemieckie reguły walidacji specyficzne dla XRechnung.

Brak Leitweg-ID (EAS 0204): częsty przy fakturowaniu do niemieckich organów publicznych. Należy zażądać Leitweg-ID od zamawiającej instytucji i dodać jako identyfikator ze schemeID 0204.

PDF nieakceptowany: od 1 stycznia 2025 roku Niemcy wprowadziły obowiązek odbierania e-faktur. Zwykły PDF często nie jest już wystarczający. Wysyłanie faktury jako XRechnung lub ZUGFeRD.

Fakturowanie do Polski (KSeF): odrzucenie i błędy certyfikatów

Odrzucenie KSeF: często spowodowane nieprawidłowym formatem XML FA_VAT. Jednostka PSB eConnect normalnie obsługuje poprawną transformację do polskiego formatu KSeF.

Błędy certyfikatów: mogą wystąpić, jeśli certyfikaty KSeF nie są prawidłowo zainstalowane lub wygasły.

Limit zapytań: KSeF stosuje limity na liczbę zapytań. eConnect stosuje przetwarzanie wsadowe, aby temu zapobiegać.

Kody błędów UWV (UWV001–UWV018)

UWV stosuje własne reguły walidacji poza standardową walidacją Peppol/NLCIUS.

  • UWV Duży Przepływ Gotówki (reintegracja, szkolenia, świadczenia): OIN 00000004191771249000
  • UWV Mały Przepływ Gotówki (zarządzanie): OIN 00000004172892677000
KodPoleOpisUWV001.1supplierPartyNameBrak nazwy dostawcyUWV001.2supplierStreetNameBrak ulicy dostawcyUWV001.6supplierVatNumberBrak numeru VAT dostawcyUWV001.8lineInvoicedQuantityBrak ilości w pozycji fakturyUWV001.9pricePerUnitBrak ceny za jednostkęUWV001.10lineTotalExVatBrak kwoty netto w pozycjiUWV001.11lineVatPercentageBrak stawki VAT w pozycjiUWV001.12lineVatAmountBrak kwoty VAT w pozycjiUWV001.13vatBreakDownZestawienie VAT bez stawek z pozycjiUWV001.14totalAmountInclVatBrak kwoty całkowitej bruttoUWV001.15totalAmountExclVatBrak kwoty całkowitej nettoUWV001.16invoiceDateBrak daty fakturyUWV002.1supplierEndpointIdNie można określić EndpointID dostawcyUWV002.2supplierCocNumberBrak numeru rejestrowego dostawcyUWV004supplierContactEmailBrak adresu e-mail osoby kontaktowej dostawcyUWV006supplierIbanBrak numeru IBAN dostawcyUWV007currencyNieprawidłowa walutaUWV009orderNumberBrak prawidłowego numeru zamówienia lub wiele numerówUWV010costCenterBrak centrum kosztowego (Mały Przepływ Gotówki)UWV012invoiceNumberNumer faktury dłuższy niż 30 znakówUWV013orderLineNumberBrak numeru pozycji zamówienia w pozycji fakturyUWV014productCodeBrak kodu produktu w pozycji faktury (Duży Przepływ Gotówki)UWV015articleNumberBrak numeru artykułu w pozycji fakturyUWV016itemDescriptionBrak opisu w pozycji fakturyUWV018--Brak pozycji faktury z kwotą > 0,00

Rozwiązanie dla kodu UWV: uzupełnienie brakującego pola na fakturze. Seria UWV001 dotyczy wymaganych pól dostawcy; seria UWV002 elementów identyfikacji.

"Peppol dostarczenie nieudane"

Ten komunikat pojawia się w Skrzynce nadawczej, gdy faktura nie mogła zostać dostarczona do odbiorcy przez sieć Peppol. Możliwe przyczyny:

  • Odbiorca nie jest zarejestrowany w Peppol: odbiorca nie posiada aktywnej rejestracji Peppol. Platforma automatycznie oferuje e-mail fallback.
  • EndpointID nieprawidłowe: adres Peppol odbiorcy jest nieprawidłowy. Należy sprawdzić numer rejestrowy lub OIN wpisany jako kontrahent.
  • Problem techniczny po stronie odbiorcy: faktura została prawidłowo wysłana, ale nie mogła zostać przetworzona przez system odbiorcy.

Przy nieudanym dostarczeniu można ponownie wysłać fakturę, korygując EndpointID.

"Pole Dostawca jest puste"

Pole dostawcy nie zawiera danych. Dzieje się tak, gdy organizacja nie została wybrana lub nie została aktywowana.

Rozwiązanie: kliknięcie ikony ołówka obok pola dostawcy i wybranie organizacji. Jeśli organizacja nie została jeszcze aktywowana, należy najpierw wykonać kroki opisane w artykule Dodawanie i aktywacja organizacji.

Numer VAT ze spacjami lub kropkami

Numer VAT musi być wpisany bez spacji, kropek lub myślników, łącznie z kodem kraju. Prawidłowy format dla Holandii to NL123456789B01. Belgijskie numery VAT muszą być wpisane jako BE plus dokładnie 10 cyfr, bez separatorów.

Kwota znika przy wpisywaniu

Jeśli wpisana kwota znika przy przejściu do następnego kroku, pole prawdopodobnie zawiera niedozwolone znaki. Pole kwoty akceptuje wyłącznie cyfry z przecinkiem jako separatorem dziesiętnym. Kwoty należy wpisywać jako 100,00, nie jako € 100,00 ani 100.00.

Czerwona ikona stop przy wysyłaniu (walidacja formularza, puste pola wymagane)

Warianty wyszukiwania: "czerwona ikona stop wysyłanie", "czerwone kółko wysyłanie", "faktury nie można wysłać", "wysyłanie się nie udaje", "ikona stop faktura", "notatka faktury wymagana", "IBAN konto bankowe wymagane", "więcej informacji notatka faktury", "dane płatności IBAN puste", "pola wymagane wysyłanie faktury".

Przy wysyłaniu ręcznej faktury sprzedaży może pojawić się czerwona ikona stop: faktura nie zostaje wysłana. Przyczyną jest walidacja formularza po stronie klienta -- nie jest to błąd Peppol ani sieciowy, ani wada platformy. Dłużnik/OIN, dostępność Peppol i numer zamówienia mogą być już poprawne, a mimo to wysyłanie kończy się niepowodzeniem, ponieważ inne wymagane pole pozostało puste.

Sprawdź te dwa pola:

  1. Notatka faktury (sekcja Więcej informacji) -- wpisz krótką notatkę lub referencję, np. numer zamówienia lub referencję uzgodnioną z odbiorcą.
  2. IBAN konto bankowe (sekcja Dane płatności) -- wpisz IBAN, na który ma wpłynąć płatność, w razie potrzeby przez Zmień. IBAN na poziomie organizacji jest opcjonalny, ale puste pole IBAN na samej fakturze może mimo to blokować wysyłkę.

Różnica względem innych blokad:

  • Przycisk wysyłania nie reaguje lub pokazuje symbole zastępcze: zob. "Przycisk wysyłania Peppol nie reaguje" poniżej (automatyczne tłumaczenie przeglądarki).
  • Faktura pozostaje w wersjach roboczych: zob. odpowiednią sekcję (ustawienie organizacji lub brak "Wyślij przez").

Wysyłanie nadal się nie udaje po uzupełnieniu obu pól? Poproś o zrzut ekranu z dokładnym komunikatem błędu, a nie tylko z ikoną stop.

Numer rachunku bankowego niepoprawnie sformatowany (IBAN dane płatności)

Warianty wyszukiwania: "numer rachunku bankowego niepoprawnie sformatowany", "rachunek bankowy niepoprawnie sformatowany", "IBAN niepoprawnie sformatowany", "błąd formatu IBAN", "spacje w IBAN", "formatowanie IBAN dane płatności", "błąd IBAN przy wysyłaniu faktury ręcznej".

Przy wysyłaniu ręcznej faktury sprzedaży może pojawić się komunikat, że numer rachunku bankowego lub IBAN nie jest poprawnie sformatowany, nawet jeśli numer jest merytorycznie poprawny. Przyczyną jest walidacja formatu przed wysłaniem dla IBAN lub rachunku bankowego w sekcji Dane płatności -- nie jest to błąd Peppol ani sieciowy. Spacje, myślniki lub inne separatory (albo brak kodu kraju) powodują, że kontrola kończy się niepowodzeniem.

Rozwiązanie:

  1. Otwórz fakturę i przejdź do Dane płatności (IBAN lub rachunek bankowy).
  2. Wpisz pełny IBAN jako jeden ciąg znaków: kod kraju plus cyfry/litery, bez spacji, myślników ani innych separatorów (forma: NL00BANK0123456789).
  3. Nie używaj starego numeru rachunku bez kodu kraju -- niderlandzkie rachunki zaczynają się od NL.
  4. Zapisz i wyślij fakturę ponownie.

Różnica względem innych blokad:

  • Puste pole IBAN z czerwoną ikoną stop przy polach wymaganych -- zob. "Czerwona ikona stop przy wysyłaniu" powyżej.
  • "ID niepoprawnie sformatowane" dotyczy formatu identyfikatora/schemeID, nie rachunku bankowego -- zob. sekcje o nieznanych błędach/walidacji identyfikatora powyżej.

Komunikat nadal się pojawia? Poproś o dokładną zawartość pola (w tym spacje lub znaki) oraz dosłowny komunikat błędu lub zrzut ekranu.

Przycisk wysyłania Peppol nie reaguje, ekran ładowania zawiesza się lub interfejs pokazuje symbole zastępcze (automatyczne tłumaczenie przeglądarki)

Warianty wyszukiwania: "przycisk wysyłania nie reaguje", "ekran ładowania zawiesza się przy wysyłaniu", "dziwny tekst na fakturze", "dziwna nazwa dostawcy", "nielogiczna jednostka na fakturze", "organizacja pokazuje dziwny tekst", "logowanie wielokrotnie w celu zapisania", "ponowne logowanie w celu wysłania", "pola faktury przetłumaczone", "tłumaczenie przeglądarki podczas tworzenia faktury", "nie mogę się zalogować", "dziwny tekst na stronie logowania".

Jeśli przycisk wysyłania nie reaguje lub ekran ładowania zawiesza się podczas wysyłania faktury Peppol i widoczna jest nieprzetłumaczona składnia szablonu, np. {{invoice.data.supplierDetails.name}} zamiast wprowadzonych wartości, przyczyną jest prawdopodobnie automatyczne tłumaczenie przeglądarki.

Ten sam wzorzec może wystąpić podczas tworzenia (nowej) faktury: nielogiczne lub "przetłumaczone" etykiety/wartości pol, m.in. dostawca, organizacja i jednostka, gdzie zapisanie lub wysłanie udaje się tylko po wielokrotnym ponownym zalogowaniu. Ma to tę samą przyczynę co symbole zastępcze na przycisku wysyłania -- nie jest to defekt produktu i nie jest powodem do ponownej instalacji oprogramowania klienckiego (platforma działa wyłącznie w przeglądarce).

To samo występuje na stronie logowania platform.econnect.eu i w innych miejscach interfejsu: teksty symboli zastępczych lub surowe klucze i18n (na przykład {{lang.text}} lub I18N_COLLABRR_WS.*) zamiast normalnych etykiet. Użytkownicy często zgłaszają to jako „nie mogę się zalogować”. Zobacz także Logowanie i 2FA.

Automatyczne tłumaczenie stron w przeglądarce (Chrome lub Edge) ingeruje w DOM platformy. Powoduje to nieprawidłowe działanie przycisków i sprawia, że symbole zastępcze szablonu lub i18n, albo nielogiczne etykiety pol, pozostają widoczne.

Rozwiązanie (kolejność pierwszej linii):

  1. Wyłącz automatyczne tłumaczenie w przeglądarce dla platformy eConnect (w tym platform.econnect.eu).
  2. Twarde odświeżenie (Ctrl+F5) i zaloguj się ponownie; ponownie otwórz lub utwórz fakturę, jeśli potrzebne.
  3. Wciąż nie działa? Wyczyść pamięć podręczną przeglądarki i/lub wypróbuj inną przeglądarkę.
  4. Problem się utrzymuje? Poproś o zrzut ekranu strony faktury wraz z przeglądarką i jej wersją.
Błąd przy wysyłaniu bez konkretnego tekstu błędu, nie jest to szeroka awaria

Warianty wyszukiwania: "błąd przy wysyłaniu", "przerywany błąd portalu", "działa po ponownym uruchomieniu", "błąd wysyłania bez szczegółów", "komunikat błędu bez treści".

Czasami użytkownik zgłasza błąd przy wysyłaniu przez platformę, bez podania dokładnego tekstu błędu lub zrzutu ekranu. Bez tej treści nie ma wystarczających informacji do rzetelnej diagnozy; nie jest to znana szeroka awaria.

Możliwy pierwszy krok (nie potwierdzona przyczyna):

  1. Wyczyść pamięć podręczną przeglądarki i/lub wypróbuj inną przeglądarkę.
  2. Jeśli to nie pomoże, poproś o więcej kontekstu: dokładny komunikat błędu lub zrzut ekranu, godzinę i numer faktury.

Nie mylić z:

  • Przycisk wysyłania nie reaguje, ekran ładowania zawiesza się, lub nielogiczne etykiety/symbole zastępcze -- zobacz "Przycisk wysyłania Peppol nie reaguje" wyżej (automatyczne tłumaczenie przeglądarki, z własną kolejnością pierwszej linii).
  • Status SentRetry lub SentError po akceptacji -- zobacz sekcję o automatycznym ponownym doręczeniu Peppol dalej na tej stronie; to mechanizm ponownej próby po stronie serwera, nie problem z pamięcią podręczną przeglądarki.
Identyfikator dostawcy jest wymagany

Ten komunikat pojawia się, gdy ręcznie przesyłasz fakturę XML i w pliku brakuje pola EndpointID dostawcy. W interfejsie platformy jest to pole "Partij-ID" w sekcji "Dostawca".

Rozwiązanie: wybierz wartość z własnej organizacji z listy rozwijanej. Jeśli lista nie pokazuje właściwego wyniku, wybierz ponownie dostawcę, aby odświeżyć powiązanie.

„Nie znaleziono identyfikatorów aktywowanych do wysyłki dla firmy dostawcy”

Warianty wyszukiwania: „Nie znaleziono identyfikatorów aktywowanych do wysyłki dla firmy dostawcy”, identyfikatory aktywowane do wysyłki, „weryfikacja dostawcy jeszcze nie wykonana”, wysyłanie faktury nowa administracja, dwie organizacje z i bez sp. z o.o., identyfikatory niezweryfikowane.

Ten komunikat, oraz zgłaszane przez klienta „weryfikacja dostawcy jeszcze nie wykonana” przy pierwszej fakturze lub nowej administracji, zwykle nie wskazuje na osobny krok KYC dostawcy. Przyczyna niemal zawsze leży w jednym z tych czterech punktów.

Lista kontrolna (w kolejności):

  1. Czy wybrano właściwą organizację dostawcy? Przy dwóch podobnych organizacjach (np. ta sama nazwa z i bez „sp. z o.o.”) mogła zostać wybrana niewłaściwa. Użyj ikony ołówka, aby wybrać organizację ze zweryfikowanymi identyfikatorami -- organizacja bez zweryfikowanych identyfikatorów nie może wysyłać.
  2. Czy organizacja jest aktywowana? Jeszcze nie aktywowana: najpierw aktywuj przez Dodawanie i aktywacja organizacji.
  3. Czy przełącznik „Wysyłanie” jest włączony? Przejdź do Organizacje → twoja organizacja → Szczegóły i sprawdź, czy co najmniej jeden identyfikator (najlepiej NIP/REGON) ma włączony przełącznik Wysyłanie. Dla aktywowanej organizacji zwykle jest to już włączone.
  4. Czy numer VAT jest poprawny? Sprawdź numer VAT zarówno dostawcy, jak i dłużnika pod kątem kodu kraju i separatorów -- zob. BR-CO-09 powyżej. Błąd formatu VAT może wystąpić równocześnie z tym komunikatem.

Jeśli komunikat utrzymuje się po tych czterech krokach, wyślij fakturę ponownie po poprawieniu danych organizacji lub faktury.

Faktura pozostaje w wersjach roboczych

Jeśli faktura nie może zostać wysłana i pozostaje w folderze "Wersje robocze", należy sprawdzić dwa elementy:

  1. Wysyłanie włączone: sprawdzenie w ustawieniach organizacji, czy opcja "Wysyłanie dokumentów" jest aktywowana.
  2. Wyślij przez ustawione: w sekcji "Kontrahent" obok OrganisatieID musi być wybrana opcja "Wyślij przez". Bez tego ustawienia faktura nie może zostać wysłana.
Błędy transportu i przetwarzania
Prefix przestrzeni nazw XML odrzucony przez odbiorcę

Platforma eConnect czasem używa prefiksu przestrzeni nazw w generowanych fakturach UBL (np. <urn:Invoice xmlns:urn="...">). Obie formy — z prefiksem i bez — są technicznie prawidłowym XML.

Odbiorca odrzucający faktury na podstawie prefiksu przestrzeni nazw nie jest zgodny z Peppol. Prefix przestrzeni nazw nie jest konfigurowalny dla poszczególnych odbiorców.

Komunikat do klienta: faktura jest technicznie prawidłowa. Odbiorca musi używać prawidłowego parsera XML obsługującego zarówno przestrzenie nazw z prefiksem, jak i domyślne. Odrzucenie na podstawie prefiksu przestrzeni nazw nie jest dozwolone w Peppol.

Kody błędów EBMS (poziom transportu AS4)

Kody błędów EBMS, takie jak EBMS:0003 i EBMS:0004, są błędami transportu AS4 w komunikacji między punktami dostępu. Klienci widzą SentError lub SentRetry na platformie — sam kod EBMS nie jest widoczny w interfejsie klienta.

Działanie: odesłanie klienta do TechSupport. TechSupport może zapoznać się ze szczegółami błędu przez ślad audytów i Application Insights.

Status 40: wystąpił błąd podczas przetwarzania

Kod błędu status 40 oznacza, że dokument nie został pomyślnie przetworzony. Dwie możliwe przyczyny:

  1. Błąd przetwarzania IDR: IDR nie może przetworzyć dokumentu i zwraca status 40.
  2. Odrzucenie po stronie platformy: IDR przetworzył dokument, ale platforma następnie ustawia go na status 40 (np. z powodu błędu walidacji po konwersji).

Diagnostyka: pracownik eConnect musi zbadać w CloudWatch, jakie etapy przetwarzania przeszedł dokument.

Ponowne wysłanie faktury z poprawną referencją

Przez opcję Wyślij ponownie w skrzynce wychodzącej można ponownie przesłać już wysłaną fakturę. Przed faktycznym wysyłaniem można jeszcze zmienić pola takie jak referencja (numer zamówienia, OrderReference). Faktura zostaje wysłana ponownie z tym samym numerem faktury, ale z poprawną referencją.

To zalecane podejście, gdy odbiorca odrzuca fakturę z powodu błędnego numeru zamówienia lub innego błędu referencji. Pozwala uniknąć konieczności wystawiania korekty i nowej faktury.

Peppol: maksymalnie 1 referencja zamówienia (OrderReference) na fakturę

W aktualnym standardzie Peppol BIS Billing 3.0 i NLCIUS obsługiwana jest tylko 1 referencja zamówienia (OrderReference) na fakturę. Jest to ograniczenie wynikające z normy europejskiej EN 16931. Jeśli faktura obejmuje kilka zamówień, dostawca musi wysyłać osobne faktury.

AdditionalDocumentReference może zawierać dodatkowe referencje innych typów (projekt, umowa lub referencja nabywcy), ale nie wiele OrderReference.

Przyszłość: Znowelizowana EN 16931-1:2026 (formalnie zatwierdzona przez CEN 13 marca 2026) dodaje obsługę wielu zamówień na fakturę. Oczekuje się, że zostanie to uwzględnione w przyszłej wersji standardu Peppol (możliwie BIS Billing 4.0). Do tego czasu obowiązuje aktualne ograniczenie 1 OrderReference na fakturę w BIS Billing 3.0 i NLCIUS.

Faktura odrzucona: brakujący lub nieznany numer zamówienia

Jeśli faktura zostaje odrzucona z powodu brakującego lub nieznanego numeru zamówienia, należy rozróżnić dwa poziomy.

1. Referencja jest obowiązkowa zgodnie z EN 16931. Referencja -- numer zamówienia lub inna referencja (BuyerReference, referencja umowy lub projektu) -- jest wymagana. Faktura bez żadnej referencji nie spełnia podstawowych reguł normy.

2. eConnect domyślnie nie odrzuca na podstawie treści referencji. Jedyną sytuacją, w której platforma odrzuca na tym punkcie, jest brak jakiejkolwiek referencji.

3. Konfiguracja specyficzna dla klienta może być bardziej rygorystyczna. Rzeczywiste odrzucenie zależy od konfiguracji odbiorcy. W określonej konfiguracji faktura może zostać odrzucona, jeśli referencja jest nieznana u tego odbiorcy. Jest to zależne od konfiguracji i nie jest standardowym zachowaniem platformy eConnect.

Działanie:

  • Wyślij fakturę ponownie za pomocą opcji Wyślij ponownie (patrz powyższa sekcja) z prawidłową referencją.
  • Jeśli numer zamówienia jest nieznany, skontaktuj się z odbiorcą w sprawie pożądanej procedury.
InvoiceSentError: faktura w stanie końcowym, nie są wymagane dalsze działania

Faktura ze stanem końcowym InvoiceSentError (po błędzie walidacji 4xx) nie podejmuje więcej prób dostarczenia. Tylko błędy 5xx są ponawiane (maksymalnie 8 prób, około 35 godzin). W przypadku błędu 4xx podejmowana jest tylko jedna próba; nic więcej nie jest wysyłane do odbiorcy.

Nie ma punktu końcowego DELETE dla faktur sprzedaży (salesInvoice). Wysłana lub odrzucona faktura sprzedaży jest zdarzeniem istotnym dla audytu i pozostaje dostępna w ścieżce audytu przez 90 dni. Jeśli faktura była nieprawidłowa, wystaw notę kredytową lub fakturę korygującą zgodnie ze standardowym przepływem księgowym.

'nie jest prawidłowym xs:decimal': notacja naukowa w polach kwoty

Błędy walidacji takie jak TaxInclusiveAmount '-1.336061E6' nie jest prawidłowym xs:decimal występują, ponieważ system źródłowy serializuje kwotę numeryczną w notacji naukowej (np. -1.336061E6 dla -1 336 061,00). Pola kwoty UBL są typu xs:decimal, który nie zezwala na notację E.

Częsta przyczyna: system źródłowy przechowuje kwoty wewnętrznie jako double/float i używa domyślnej konwersji łańcucha, która automatycznie przełącza się na notację wykładniczą dla bardzo dużych lub bardzo małych wartości.

Rozwiązanie po stronie klienta: zaktualizować system źródłowy, aby kwoty były zawsze zapisywane jako zwykły łańcuch dziesiętny (np. za pomocą typów decimal/BigDecimal lub wzorca dziesiętnego niezależnego od ustawień regionalnych, bez separatorów tysięcy i bez notacji E).

Po stronie eConnect: nie można poprawić automatycznie -- wartość jest już nieprawidłowa w dostarczonym XML. Skierować do dostawcy pakietu oprogramowania.

Status 'doręczono' ale odbiorca nie otrzymał faktury

Status Doręczono oznacza, że odbierający punkt dostępu (dostawca usług Peppol dłużnika) technicznie zaakceptował dokument i potwierdził tę akceptację. eConnect otrzymuje returnedMessageId (format GUID@econnect.eu): dowód, że faktura dotarła do punktu dostępu odbiorcy.

Jeśli dłużnik twierdzi, że nie otrzymał faktury, podczas gdy status pokazuje 'Doręczono', dokument został doręczony do punktu dostępu dłużnika, ale nie jest jeszcze widoczny w jego własnym oprogramowaniu lub księgowości. Jest to problem dalszego przetwarzania po stronie odbiorcy.

Kroki do rozwiązania:

  1. Potwierdzić klientowi, że faktura została pomyślnie wysłana do punktu dostępu Peppol dłużnika oraz że eConnect otrzymał potwierdzenie doręczenia.
  2. Doradzić klientowi, aby poprosił dłużnika o kontakt z jego własnym dostawcą usług Peppol. Można przekazać returnedMessageId: za pomocą tego identyfikatora odbierający punkt dostępu może zlokalizować dokument.
  3. Dalsze działania leżą po stronie punktu dostępu dłużnika; eConnect jako strona wysyłająca nie ma wglądu poza punkt doręczenia.
Pomylenie: próba dodania organizacji odbiorcy jako własnej organizacji

Warianty wyszukiwania: „dodaj organizację” przy fakturze, portal dostawcy, nazwa organizacji + numer KRS w prawym górnym rogu, nie można edytować istniejącego wiersza organizacji, nie można zmienić nazwy istniejącej organizacji, zrzut ekranu organizacji klienta w prawym górnym rogu, komunikat o identyfikatorze przy dodawaniu organizacji (dostawca), dodaj własną organizację osobno, dłużnik jako własna organizacja, dodaj odbiorcę faktury do środowiska, aktywuj organizację dłużnika administracji publicznej, odbiorca musi być w środowisku, rejestracja pod własnym OIN gminy, OIN klienta jako własna organizacja, fakturowanie gminy z własnym OIN, OIN odbiorcy to nie własny identyfikator, schemat 0190 dłużnik.

Nowi użytkownicy -- zwłaszcza przechodzący z innych usług e-fakturowania -- czasami próbują dodać organizację odbierającą jako własną organizację na platformie podczas wysyłania faktury. Nie jest to konieczne i powoduje komunikat o błędzie.

Aby wysłać fakturę do odbiorcy, ta organizacja nie musi znajdować się na własnym koncie: podczas tworzenia faktury wybieram odbiorcę za pomocą pola wyszukiwania dłużnika. Można szukać po numerze KRS, nazwie firmy lub numerze OIN.


Komunikat o błędzie pojawia się nadal i nie jest opisany powyżej? Skontaktuj się przez support.econnect.eu.

Skontaktuj się ze wsparciem

Powiązane artykuły