Proč zkušenost z KSeF přenáším 1:1 na ViDA a PEPPOL

Často dostanu otázku: „KSeF je polská věc. Proč o ní mluvíš, když jsme v Česku a řešíme EU?" Odpověď je, že integrace na KSeF a integrace na ViDA nebo PEPPOL je z velké části ta samá práce. Mění se formát zprávy a koncový systém. Nemění se mašinérie pod tím.

Tenhle článek vysvětluje, proč to tak je. Technicky, ne marketingově.

Tři systémy, jedna kategorie problému

KSeF, PEPPOL access point i ViDA digital reporting mají společné to, co dělá integraci těžkou:

• Jsou asynchronní. Odešlete dokument a potvrzení přijde později, jiným kanálem. Mezi tím musíte stav někde držet.
• Mají rate limity. Při dávkovém odesílání narazíte na strop. Bez fronty a řízení tempa se zastaví celá fakturace.
• Občas jsou nedostupné. Státní i síťové systémy mají výpadky a údržby. Vaše fakturace kvůli tomu nesmí spadnout.
• Mají vlastní stav. Session, tokeny, validační kola, potvrzovací doklady. Cizí SDK do toho přidává své zvláštnosti.

Když systém má dvě a více těchto vlastností, nejde o jednoduché HTTP volání. Jde o dlouhoběžící stavový workflow. A ten potřebuje stejnou architekturu bez ohledu na to, jestli odesíláte do Varšavy, na PEPPOL access point, nebo reportujete přeshraniční fakturu podle ViDA.

Co se mění a co ne

Mění se formát. KSeF má polské strukturované XML FA(3). PEPPOL používá BIS Billing 3.0, což je UBL 2.1 a zároveň CIUS evropské normy EN 16931 — platná faktura v BIS Billing 3.0 je tím pádem v souladu s EN 16931. ViDA staví přeshraniční B2B reporting přímo na EN 16931. Český národní formát ISDOC je také z rodiny UBL, ale je to samostatný národní dialekt a není automaticky konformní s EN 16931 — mapování je potřeba dělat explicitně. Stejně tak FA(3) z KSeF je národní dialekt, který se na EN 16931 mapuje, nerovná se mu.

Takže ano, mapování formátů je reálná práce a každý systém má svoje. Ale to je převodní vrstva na okraji. Jádro integrace — to, co rozhoduje, jestli neztratíte fakturu — je u všech tří stejné.

Mašinérie, která je u všech tří identická

Tohle je seznam, který stavím u KSeF a který přenáším beze změny na PEPPOL i ViDA reporting:

Idempotentní odeslání

Každý dokument dostane deterministický idempotency key. Když se odeslání zopakuje — a ono se zopakuje kvůli retry, restartu nebo race condition — systém pozná, že tohle už řešil, a nevytvoří duplicitu. U KSeF to znamená duplicitní fakturu ve státním systému. U PEPPOL duplicitní zprávu u příjemce. Stejné riziko, stejné řešení.

Retry s exponenciálním backoffem

Přechodné chyby a timeouty jsou normální, ne výjimka. Místo ručně psané smyčky použiju battle-tested retry s rostoucími rozestupy, které nezahltí protistranu, když má problém. Access point i státní brána reagují na zátěž stejně — couvnout a zkusit znovu později.

Rate limiting jako sdílený stav

Limity musíte respektovat i při běhu na více instancích. Počítadlo v paměti jednoho procesu nestačí. Potřebujete sdílený token-bucket, typicky přes Redis, aby si instance navzájem nepřebíraly kvótu. PEPPOL access pointy i KSeF mají svoje stropy — princip je jeden.

Reconciliation job

Tohle skoro každý vynechá a je to nejdůležitější díl. Periodický job se ptá: sedí realita? Má každý dokument potvrzení? Neuvízlo něco ve stavu „pending"? Nevznikl orphan? Bez reconciliation nevíte, jestli to funguje — jen doufáte. U KSeF kontrolujete UPO. U PEPPOL doručení přes 4-corner model. U ViDA reporting odeslaný v termínu.

Audit log a alerting

Každý přechod stavu generuje strukturovaný event. Na terminální selhání a uvíznuté stavy jde alert — dřív, než se z toho stane problém u kontroly. Tiché varování v logu bez alertu je odložený dluh. U regulovaného reportingu je auditní stopa navíc požadavek, ne luxus.

Anti-corruption layer

Cizí SDK obalím vlastní vrstvou, aby jeho zvláštnosti — cizí error stringy, číselné kódy, session TTL — neprosakovaly do business logiky. Když vyjde nová verze brány nebo se změní access point, měním jedno místo. Tahle vrstva je důvod, proč je přenos z KSeF na PEPPOL hlavně práce na převodní vrstvě formátu, ne přepis celého systému.

Proč to tvrdím: ověřeno v produkci

Tohle nejsou teze ze slidu. Mašinérii výše jsem postavil na napojení fakturace na KSeF a ověřil na více než 40 000 dokumentech se 100% doručením. Když předchozí fire-and-forget pipeline tiše ztratila faktury, forenzně jsem dohledal a obnovil 15 141 chybějících dokumentů. Retry, reconciliation a monitoring běží v produkci a hlídají, aby se to nestalo znovu.

To je důkaz, že durable integrace na regulovaný státní systém funguje pod reálnou zátěží. A protože jádro je stejné, je to zároveň důkaz připravenosti na PEPPOL a ViDA — ne slib, ale odběhaná míle na nejnáročnějším z té trojice.

Časová osa, kvůli které to není akademické

Pořadí, ve kterém na tyhle systémy narazíte:

• 1. února 2026 — KSeF povinný pro velké polské plátce (obrat 2024 nad 200 mil. PLN). Od tohoto data musí umět přijímat přes KSeF každý. Tato fáze je podle dostupných zdrojů už v provozu.
• 1. dubna 2026 — KSeF povinné vystavování pro ostatní usazené plátce (kromě nejmenšího segmentu).
• 1. ledna 2026 — Belgie zavádí PEPPOL pro B2B (s tříměsíční tolerancí do 31. března 2026). PEPPOL přestává být jen B2G téma.
• 1. ledna 2027 — KSeF dopadá na nejmenší plátce a teprve od tohoto data se rozbíhají pokuty za chyby (přechodné úlevy a odklad sankcí jsou dvě různé věci s vlastními termíny — papírové faktury pro malé do 30. září 2026, offline režim do 31. prosince 2026).
• 1. ledna 2030 — ViDA: ruší se nutnost souhlasu příjemce s e-fakturou a členské státy mohou zavádět domácí mandáty bez výjimky EU. (Některé sekundární zdroje 2030 dílčí termíny slévají; nejčistší čtení je: souhlas pryč a domácí mandáty povolené k 1. 1. 2030, přeshraniční mandát k 1. 7. 2030.)
• 1. července 2030 — ViDA: e-fakturace podle EN 16931 povinná pro přeshraniční B2B uvnitř EU. Faktura musí být vystavena do 10 dnů od zdanitelného plnění a reportována při vystavení. Není to doslova real-time — operativní číslo je těch 10 dnů.
• 1. ledna 2035 — ViDA: domácí režimy zavedené před 1. 1. 2024 (Itálie, Polsko, Francie) se musí srovnat s modelem EN 16931. (Posunuto z původně navrhovaného 2027.)

Pro Česko platí: dnes tu není žádný národní B2B mandát. B2B e-fakturace je dobrovolná a vyžaduje souhlas příjemce. Tlak přijde přes ViDA, pravděpodobně až po roce 2030 — ne přes klon KSeF. Pro B2G se přijímá ISDOC nebo PEPPOL BIS Billing 3.0. (Jakékoli tvrzení o „povinné CZ B2B fakturaci od 2027" plete dohromady samostatný plán EET 2.0 a je nepřesné.) Konkrétní technické požadavky ViDA pro rok 2030 — národní schémata, konektivita — se ještě dolaďují, takže detaily ber jako pohyblivé podle aktuálního znění.

Závěr

KSeF je dnes jediný živý, povinný deadline z té trojice. PEPPOL je interoperabilní vrstva pod vším a ViDA je celoevropská síla, která žene každý členský stát a jeho ERP k EN 16931 a reportingu blízko reálnému času. Formáty se liší. Architektura, která rozhoduje o tom, jestli neztratíte ani jednu fakturu, je stejná.

Proto zkušenost z KSeF nepřenáším volně. Přenáším ji 1:1 na to, co přijde.

FAQ

Když je KSeF polský, k čemu mi to je v Česku? KSeF je nejtěžší veřejně dostupná instance kategorie „regulovaný asynchronní systém s vlastním stavem". Architektura ověřená na KSeF — idempotence, retry, reconciliation, rate limiting, audit log — je přesně to, co budete potřebovat pro PEPPOL a ViDA reporting, které na ČR dopadnou přes EU legislativu. Mění se formát, ne jádro.

Stačí mi koupit PEPPOL access point a mám hotovo? Access point vyřeší transport a routing po síti. Nevyřeší to, co se stane uvnitř vaší aplikace, když odeslání selže, když brána vrátí timeout, nebo když potřebujete dohledat, jestli každý dokument doopravdu prošel. To je durable workflow ve vašem systému — stejná práce jako u KSeF.

Musím něco dělat hned, když má ČR mandát až po 2030? Pokud fakturujete do Polska nebo máte polské entity, KSeF se vás týká v roce 2026 přímo. Pro čistě český provoz není tlak okamžitý, ale ViDA termíny (přeshraniční B2B od 1. 7. 2030) jsou pevné a ERP systémy se na ně připravují už teď. Pro provozní spolehlivost si polské termíny vždy ověřte proti aktuálnímu znění polského ministerstva financí — Polsko KSeF v minulosti odkládalo, i když únorová fáze 2026 je už podle zdrojů v produkci.