Błędy integracji

Gdzie szukać błędów

Nie wysyłamy e-maili o pojedynczych błędach, dlatego zaglądaj na listę Odebrane transakcje. W kolumnie Integracje każda transakcja ma plakietkę z nazwą systemu księgowego: zielona oznacza, że żądanie przeszło, czerwona, że wystąpił błąd. Po kliknięciu transakcji karta danej integracji pokazuje status z komunikatem błędu oraz Obiekt odpowiedzi z surową odpowiedzią systemu księgowego. Awarie techniczne po naszej stronie monitorujemy sami.

Co oznaczają komunikaty

Komunikat błędu przekazujemy wprost z systemu księgowego, więc opisuje on prawdziwą przyczynę odrzucenia żądania. Najczęstsze klasy:

Klasa błędu	Przykłady	Co zrobić
Dane nabywcy	brak wymaganych pól, błędny NIP lub kod pocztowy	Popraw dane transakcji przyciskiem Edytuj (jak to zrobić) i ponów wykonanie
Konfiguracja integracji	nieprawidłowy token API, zła nazwa konta, brakujące ustawienie	Wejdź w konfigurację integracji, użyj przycisku testu połączenia, popraw i ponów
Chwilowy problem systemu księgowego	limit zapytań, przerwa techniczna	Odczekaj i ponów wykonanie bez zmian
Blokada subskrypcji	komunikat o braku aktywnej subskrypcji	Opłać subskrypcję; po aktywacji ponowisz wykonanie integracji

Błędy specyficzne dla Fakturowni (np. walidacja NIP działu, np_tax_kind, brak numeru KSeF) zebraliśmy na stronie najczęstsze problemy.

Jak reagować krok po kroku

1. Otwórz transakcję i przeczytaj komunikat w karcie integracji.
2. Usuń przyczynę: popraw dane transakcji (Edytuj) albo konfigurację integracji.
3. Kliknij Uruchom wykonanie integracji ponownie. Przy udanym wykonaniu ponowienie wystawi duplikat dokumentu, więc ponawiaj je tylko świadomie, np. gdy poprzednia faktura została skorygowana.
4. Sprawdź nowy status i numer faktury w karcie integracji.

Jeśli komunikat jest niejasny albo błąd się powtarza mimo poprawek, napisz na [email protected] albo na czacie i podaj identyfikator transakcji: zajrzymy w szczegóły, a w razie potrzeby zregenerujemy dane z eventu Stripe.