Ztracené faktury
Fire-and-forget volání v requestu: když KSeF vrátí chybu nebo timeout, faktura zmizí a nikdo se to nedozví.
// E-fakturace / KSeF
KSeF integrace,
která neztrácí faktury.
Od 1. 2. 2026 je KSeF v Polsku povinný pro velké plátce, od 1. 4. 2026 pro ostatní plátce DPH. Napojíme vás na státní systém tak, aby vydržel výpadky, rate limity i noční provoz — ne fire-and-forget skript, který spadne při první chybě.
Poptat KSeF integraci → Pokuty za nesoulad od 1. 1. 2027. Reálně ověřeno na 15 000+ dokumentech.
// Proč to drhne
Většina KSeF integrací je fire-and-forget. Naše ne.
KSeF je asynchronní, rate-limited státní systém, který občas není dostupný a má vlastní stav. Naivní integrace pošle fakturu v HTTP requestu a doufá. Když to selže, fakturu nikdo nedohledá — a to je při mandatorní e-fakturaci přímá cesta k pokutě.
Výpadky státního systému
KSeF má výpadky a rate limity. Bez retry a fronty se vám zastaví celá fakturace.
Žádná reconciliation
Bez kontroly „sedí realita?" nevíte, jestli každá faktura skutečně dorazila a má UPO potvrzení.
// Co stavíme
Durable integrace, ne skript
Externí volání bereme jako durable, idempotentní, perzistovanou jednotku práce — nikdy ne fire-and-forget. Nad cizí SDK dáváme anti-corruption layer, takže jeho zvláštnosti neprosakují do vaší business logiky.
Idempotentní odeslání
Každé volání má deterministický idempotency key — žádné duplicitní faktury ani při retry.
Retry s backoffem
Přechodné chyby a timeouty se opakují s exponenciálním backoffem, ne ručně psanou smyčkou.
Rate limiting
Sdílený token-bucket respektuje API limity KSeF i při běhu na více instancích.
Reconciliation job
Periodická kontrola, že každá faktura má potvrzení a žádná neuvízla ve stavu „pending".
Status polling & UPO
Sledujeme stav odeslání až po UPO potvrzení — máte důkaz, že stát fakturu přijal.
Audit log & alerting
Strukturovaný event u každého přechodu stavu + alert na terminal-failure a uvíznuté stavy.
// Důkaz
Ověřeno v produkci, ne na slidu
Pro TrafinOil jsme napojili fakturaci na KSeF a obnovili 15 141 chybějících dokumentů z forenzní recovery. Noční dataloader jsme zkrátili z 20 hodin na 30 minut. Retry, reconciliation a monitoring běží v produkci.
15 141 dokumentů obnoveno
40× rychlejší dataloader
0 ztracených faktur
// FAQ
Časté otázky ke KSeF
// Kontakt
KSeF deadline se blíží.
Pojďme to udělat pořádně.
Napište co řešíte — jaký máte systém a kam fakturujete. Odpovíme do 24 hodin s konkrétním návrhem, ne s 90minutovou prezentací.
Poptat KSeF integraci →