Przewodnik · ERP / synchronizacja statusu

Faktura jest w KSeF, ale nie widać jej w ERP

Taki objaw zwykle wskazuje na problem integracyjny po stronie systemu lokalnego, a nie na błąd samego XML.

Typ

Przewodnik

Warstwa

ERP / synchronizacja statusu

Skutek

Ostrzeżenie

Typowy komunikat GoKSeF

Dokument jest widoczny w KSeF lub w Aplikacji Podatnika, ale ERP nadal nie pokazuje numeru KSeF, UPO albo nawet samego faktu wysyłki.

Najczęściej zawodzi powiązanie dokumentu lokalnego z odpowiedzią KSeF: identyfikator sesji, identyfikator dokumentu, numer KSeF albo mechanizm odświeżania statusu.

Jak to poprawić

  1. 1 Potwierdź, że dokument istnieje w KSeF i zapisz jego numer KSeF oraz status końcowy.
  2. 2 Sprawdź, po jakim kluczu ERP wiąże lokalny dokument z odpowiedzią KSeF.
  3. 3 Zweryfikuj, czy integracja nie zgubiła identyfikatora sesji albo wyniku odpytywania.
  4. 4 Uruchom bezpieczną synchronizację statusu i pobieranie UPO bez ponownej wysyłki faktury.
  5. 5 Sprawdź logi kolejki, webhooka lub pollera odpowiedzialnego za odświeżanie odpowiedzi zwrotnej.

Sprawdź przed ponowną walidacją

  • ERP ma poprawny numer KSeF i właściwy status dokumentu.
  • UPO zostało pobrane albo jasno wiadomo, dlaczego jeszcze go nie ma.
  • Nie ma potrzeby ponownej wysyłki.

FAQ

Czy skoro dokument jest w KSeF, to mogę zignorować ERP?
Nie. Trzeba odtworzyć spójny stan w systemie lokalnym, bo inaczej kolejne operacje mogą opierać się na błędnych danych.
Czy to oznacza błąd walidacji?
Zwykle nie. To częściej problem synchronizacji statusu i identyfikatorów niż samego FA(3).

Powiązane artykuły

Przewodnik · KSeF API / status

Faktura wysłana do KSeF, ale brak numeru KSeF albo UPO

Dokument został przekazany do KSeF, ale numer KSeF albo UPO nie są jeszcze dostępne.

Przewodnik · KSeF API / status

Faktura w trakcie przetwarzania w KSeF — co to znaczy

Status przetwarzania nie musi oznaczać błędu, ale wymaga świadomej kontroli i dalszej diagnostyki.

Przewodnik · KSeF API / status

Brak UPO w KSeF — jak diagnozować problem

Sam brak UPO nie przesądza jeszcze, czy problem dotyczy wysyłki, pobrania potwierdzenia czy synchronizacji statusu.

Przewodnik · KSeF API / status

Ponowna wysyłka faktury do KSeF kończy się duplikatem

Kolejna wysyłka nie rozwiązuje problemu, jeżeli poprzednia próba została już przyjęta albo utknęła bez prawidłowego odtworzenia statusu.

Sprawdź poprawiony plik

Po poprawieniu danych źródłowych wygeneruj XML ponownie i sprawdź nowy plik w GoKSeF.

Przejdź do walidatora Inne błędy