Zagubione faktury
Fire-and-forget call w requeście: jak KSeF zwróci błąd czy timeout, faktura znika i nikt o tym nie wie.
Od 1.02.2026 KSeF jest w Polsce obowiązkowy dla dużych podatników, od 1.04.2026 dla wszystkich podatników VAT. Wpinamy Was w system państwowy tak, aby wytrzymał awarie, limity, nocną pracę — nie script fire-and-forget, który pada przy pierwszym błędzie.
KSeF to asynchroniczny, rate-limited system państwowy, który pada i ma swój stan. Naiwna integracja wysyła fakturę w HTTP requestie i ma nadzieję. Jak się nie powiedzie, nikt faktury nie znajdzie — a przy obowiązkowej e-fakturze to prosta droga do kary.
Fire-and-forget call w requeście: jak KSeF zwróci błąd czy timeout, faktura znika i nikt o tym nie wie.
KSeF ma awarie i limity. Bez retry i kolejki cała fakturowość Wam stanie.
Bez sprawdzenia „czy rzeczywistość się zgadza?" nie wiecie, czy każda faktura rzeczywiście dotarła i ma potwierdzenie UPO.
Traktujemy External calls jako trwałe, idempotentne, zpersystowalne jednostki pracy — nigdy fire-and-forget. Obcą SDK opatrujemy w anti-corruption layer, żeby jej osobliwości nie przeciękały do Waszej biznes logiki.
Każdy call ma deterministyczny klucz idempotentności — żadnych duplikowanych faktur nawet przy retry.
Przejściowe błędy i timeouty ponawiają się z exponential backoffem, nie ręcznie pisaną pętlą.
Wspólny token-bucket respektuje limity API KSeF nawet przy uruchomieniu na wielu instancjach.
Okresowa weryfikacja, że każda faktura ma potwierdzenie i żadna nie utknęła w stanie „pending".
Śledzimy status wysyłki aż do potwierdzenia UPO — macie dowód, że państwo ją przyjęło.
Structured event przy każdej zmianie stanu + alerty na terminal-failure i utknięte stany.
Dla TrafinOil przez KSeF przechodzi ponad 40 000 faktur, 100% dostarczonych. Podczas forensic recovery odzyskaliśmy dodatkowo 15 141 dokumentów, które poprzedni pipeline po cichu utracił. Nocny dataloader skróciliśmy z 20 godzin do 30 minut — retry, reconciliation i monitoring działają na produkcji.
Napiszcie co rozwiązywacie — jaki macie system i gdzie fakturujecie. Odpowiemy w 24 godziny konkretną propozycją, nie 90-minutowym deck'iem.
Napiszcie co rozwiązywacie — jaki macie system i gdzie fakturujecie. Odpowiemy w 24 godziny konkretną propozycją, nie 90-minutowym deck'iem.