Przegląd statusów błędów API w KSeF

Korzystanie z API KSeF wiąże się z możliwością wystąpienia różnego rodzaju błędów, które są zwracane w postaci kodów i opisów w odpowiedzi serwera. Błędy te mogą dotyczyć struktury XML, autoryzacji, danych kontrahenta, formatu dat czy powiązań dokumentów (np. faktury korygującej).

Statusy błędów w API dzielą się m.in. na:

• Błędy walidacji struktury pliku – np. niezgodność ze schematem XSD,
  
• Błędy autoryzacyjne – np. nieprawidłowy token lub brak uprawnień,
  
• Błędy logiczne – np. faktura odnosi się do nieistniejącego dokumentu,
  
• Błędy systemowe – np. problem po stronie serwera KSeF.
  

Każdy status błędu opatrzony jest unikalnym kodem (np. Błąd 201, Błąd 301) oraz opisem, które należy analizować zgodnie z dokumentacją API udostępnioną przez Ministerstwo Finansów. Dobrą praktyką jest logowanie wszystkich odpowiedzi z KSeF oraz wdrożenie powiadomień dla użytkownika końcowego, jeśli przesyłka została odrzucona.