Co zrobić, gdy faktura się nie wystawiła - przyczyny i naprawa

Najczęstsze przyczyny, dla których faktura się nie wystawiła

Gdy faktura się nie wystawiła, prawie zawsze stoi za tym jedna z kilku powtarzalnych przyczyn. Zanim zaczniesz szukać winy w samym systemie fakturowym, warto sprawdzić te najczęstsze scenariusze, bo w większości przypadków problem leży w danych zamówienia, a nie w awarii oprogramowania.

Oto błędy, które najczęściej blokują wystawienie dokumentu:

• Błędny lub nieistniejący NIP - literówka, brak cyfry albo numer, którego nie ma w bazie podatników. System fakturowy odrzuca taki dokument przy fakturach B2B.
• Brak danych nabywcy - puste pole adresu, nazwy firmy lub kraju. Faktura VAT ma obowiązkowy zestaw pól i bez nich nie powstanie.
• Wygasły token API - klucz autoryzujący połączenie z systemem fakturowym przestał działać, więc żądanie kończy się błędem 401.
• Błąd API systemu fakturowego - chwilowa niedostępność serwisu, przerwa techniczna albo przekroczony limit zapytań (rate limit).
• Niepoprawne mapowanie stawki VAT - produkt ma stawkę, której docelowy system nie akceptuje, albo brak przypisanej stawki.
• Duplikat numeru dokumentu - próba wystawienia faktury z numerem, który już istnieje.

Rozróżnienie przyczyny jest ważne, bo każda z nich wymaga innego działania. Błędny NIP poprawiasz w danych zamówienia, wygasły token odnawiasz w konfiguracji integracji, a chwilowy błąd API zwykle wystarczy po prostu ponowić.

To praktyczny przewodnik, a nie porada podatkowa. Zakres obowiązkowych elementów faktury i zasady jej wystawiania reguluje ustawa o VAT - konkretne wątpliwości warto skonsultować z księgowym i sprawdzić aktualne przepisy, bo bywają zmieniane.

Błędne dane nabywcy - NIP, adres i wymagane pola

Najczęstszą pojedynczą przyczyną, dla której faktura się nie wystawiła, są błędne lub niekompletne dane nabywcy. Przy sprzedaży na marketplace dane przychodzą w formacie platformy i nie zawsze mapują się idealnie na pola wymagane przez system fakturowy.

Przy fakturach dla firm krytyczny jest NIP. Warto zweryfikować go zawczasu - dla kontrahenta krajowego na Białej liście podatników VAT, a dla klienta z Unii w bazie VIES. Numer z literówką albo nieaktywny zostanie odrzucony, a Ty zobaczysz błąd dopiero w momencie wystawiania.

Drugą grupą są pola obowiązkowe. Faktura VAT musi zawierać określony zestaw danych, a ich brak blokuje wygenerowanie dokumentu. Jeśli nie masz pewności, co dokładnie musi się znaleźć na fakturze, sprawdź co musi zawierać faktura VAT. Najczęściej brakuje:

• nazwy firmy lub imienia i nazwiska nabywcy,
• pełnego adresu (ulica, kod pocztowy, miejscowość),
• kraju przy sprzedaży zagranicznej,
• poprawnej stawki VAT przy pozycjach z nietypowym opodatkowaniem.

Dobra praktyka to walidacja danych jeszcze przed wysłaniem do systemu fakturowego. NavyFlame sprawdza kompletność danych nabywcy i poprawność stawek na etapie przetwarzania zamówienia, więc część błędów wychwytujesz, zanim w ogóle dojdzie do nieudanej próby wystawienia.

Błąd API systemu fakturowego - token i limity

Druga rodzina przyczyn nie ma nic wspólnego z danymi - to problemy po stronie połączenia z systemem fakturowym. Tu faktura się nie wystawiła nie dlatego, że dokument był wadliwy, ale dlatego że żądanie nie dotarło lub zostało odrzucone.

Najczęstszy przypadek to wygasły token API. Połączenie z wFirma, inFakt, Fakturownia czy iFirma opiera się na kluczu lub tokenie OAuth, który po pewnym czasie traci ważność. Skutek to błąd autoryzacji i seria nieudanych prób, dopóki nie odnowisz połączenia w konfiguracji integracji.

Kolejne sytuacje związane z API:

Dobra wiadomość jest taka, że błędy API są zwykle przejściowe. System nie poddaje się po pierwszej próbie - wykonuje kilka automatycznych ponowień z rosnącymi odstępami (exponential backoff), więc krótka przerwa techniczna serwisu fakturowego często rozwiązuje się sama, bez Twojej interwencji.

Kolejka błędów DLQ - jak nie zgubić dokumentu

Najgorszy scenariusz przy fakturowaniu masowym to nie sam błąd, lecz zgubienie dokumentu. Jeśli nieudane zamówienie znika bez śladu, po kilku dniach okazuje się, że brakuje faktur, a Ty nie wiesz których. NavyFlame rozwiązuje to mechanizmem kolejki błędów (DLQ, Dead Letter Queue) opisanym szerzej w artykule o monitoringu zamówień i DLQ.

Działa to tak: gdy faktura się nie wystawiła i automatyczne ponowienia się wyczerpały, zamówienie nie przepada. Trafia do DLQ razem z pełnym logiem błędu, który mówi wprost, co poszło nie tak - na przykład „błędny NIP", „wygasły token API" albo „brak adresu nabywcy". Zamiast zgadywać, od razu wiesz, co naprawić.

W sekcji Monitoring widzisz listę wszystkich zatrzymanych zamówień, a licznik DLQ jest widoczny na głównym pulpicie, więc problem nie umknie Twojej uwadze. Dodatkowo system wysyła powiadomienia email i w panelu, gdy coś wpadnie do kolejki - nie musisz wchodzić i sprawdzać ręcznie.

Proces odzyskiwania faktury jest prosty:

1. Otwierasz DLQ i czytasz opis błędu przy zatrzymanym zamówieniu.
2. Naprawiasz przyczynę - poprawiasz NIP lub adres, odnawiasz token, korygujesz numerację.
3. Klikasz ponowienie, a system ponawia całe wystawienie od początku.
4. Faktura powstaje w docelowym systemie fakturowym, a zamówienie znika z kolejki.

Najważniejsze jest to, że ponowienie odbywa się jednym kliknięciem i nie wymaga przepisywania danych ani logowania się do systemu fakturowego osobno. Cała logika fakturowania jest po stronie NavyFlame, więc po naprawie błędu po prostu uruchamiasz proces ponownie.

Jak ograniczyć liczbę nieudanych faktur na przyszłość

Naprawianie błędów jest proste, ale jeszcze lepiej, gdy w ogóle się nie pojawiają. Kilka nawyków znacząco zmniejsza ryzyko, że faktura się nie wystawiła w trakcie szczytu sprzedaży, kiedy najmniej masz czasu na ręczne poprawki.

Po pierwsze, weryfikuj NIP i dane firmowe na bieżąco, szczególnie w kanale B2B. Po drugie, pilnuj ważności tokenów API - jeśli korzystasz z połączeń OAuth, odnowienie ustaw zanim wygasną, a nie dopiero gdy posypią się błędy. Po trzecie, ujednolicaj mapowanie stawek VAT, żeby produkty trafiały do systemu fakturowego ze stawką, którą ten akceptuje.

Pomocne jest też zrozumienie, skąd biorą się typowe pomyłki na dokumentach - praktyczny przegląd znajdziesz w artykule o błędach na fakturach i jak ich uniknąć. Im wcześniej wychwycisz problem w danych, tym mniej zamówień wpada do DLQ.

Wreszcie warto rozważyć pełną automatyzację fakturowania z monitoringiem zamiast ręcznego wystawiania. Automatyczny proces z kolejką błędów daje przewidywalność: każde zamówienie albo kończy się fakturą, albo trafia do DLQ z jasną przyczyną. Nic nie ginie po cichu, a Ty zawsze wiesz, ile dokumentów czeka na naprawę i dlaczego.

Najczesciej zadawane pytania