Přejít na obsah
Zpět na články
Technologie9 min čteníAktualizováno:

Certifikát KSeF, nebo token: jak napojit CRM a e-shop na API KSeF 2.0

Jak se CRM, e-shop nebo B2B portál přihlašuje do API KSeF 2.0, polského systému e-faktur: token, nebo certifikát KSeF, platnost tokenů po roce 2026 podle návrhu z 27. 10. 2026, jak získat certifikát, certifikát offline a prostředí TEST a DEMO.

Ve zkratce

  • CRM, e-shop nebo B2B portál, který sám odesílá faktury do KSeF (Krajowy System e-Faktur, polský systém e-faktur), se do API KSeF 2.0 přihlašuje tokenem KSeF, nebo certifikátem KSeF pro ověřování. Obě metody fungují souběžně.
  • Podle platné vyhlášky fungují tokeny do 31. prosince 2026. Polské ministerstvo financí oznámilo, že metoda zůstane, a návrh změny vyhlášky z 27. října 2026 počítá s platností stávajících tokenů do 30. listopadu 2027 a nových nejvýše 365 dní. K 14. listopadu 2026 jde o návrh.
  • Certifikát KSeF platí nejvýše 2 roky. Žádáte o něj v aplikaci Aplikacja Podatnika KSeF 2.0 (bezplatná aplikace ministerstva financí) nebo přes API, po přihlášení přes Profil Zaufany (polská státní elektronická identita), kvalifikovaným podpisem nebo kvalifikovanou pečetí. Tokenem certifikát neobjednáte.
  • Pro faktury v režimu offline potřebujete samostatný certifikát offline: bez něj systém nevygeneruje druhý QR kód.
  • Integraci nejdřív ověříte v prostředí TEST, potom v DEMO a teprve nakonec v produkci.

Jak se CRM nebo e-shop přihlašuje do API KSeF 2.0?

Program, který odesílá faktury do KSeF bez zásahu člověka, se nepřihlašuje heslem. Při každém připojení projde krátkým postupem: stáhne z KSeF jednorázovou výzvu, potvrdí ji tokenem nebo podpisem certifikátem a výměnou dostane přístupový token, kterým odesílá a stahuje faktury. Přístupový token platí něco přes deset minut, obnovovací token nejvýše 7 dní. Potom se systém musí ověřit znovu.

Ověřování v API KSeF 2.0 krok za krokem (dokumentace polského ministerstva financí, stav k 14. 11. 2026)
KrokVolání APICo je třeba vědět
1. VýzvaPOST /auth/challengeVýzva platí 10 minut.
2a. CertifikátPOST /auth/xades-signatureSystém podepíše dokument XML s výzvou a NIP (polské DIČ) podpisem XAdES: certifikátem KSeF, kvalifikovaným podpisem nebo kvalifikovanou pečetí.
2b. Token KSeFPOST /auth/ksef-tokenSystém odešle token spojený s časovou značkou z výzvy, zašifrovaný veřejným klíčem polského ministerstva financí.
3. StavGET /auth/{referenceNumber}Dotazování, dokud ověření neskončí. Ověření kvalifikovaného podpisu u jeho vydavatele může trvat déle, certifikát KSeF se ověří hned.
4. Přístupové tokenyPOST /auth/token/redeemVrátí přístupový a obnovovací token. Druhé volání se stejným ověřovacím tokenem skončí chybou.
5. ObnoveníPOST /auth/token/refreshNový přístupový token bez nového přihlášení, dokud platí obnovovací token.
Zdroj: dokumentace API KSeF 2.0 polského ministerstva financí na GitHubu (ověřování).

Token, nebo certifikát KSeF: co zvolit pro integraci?

Podle FAQ polského ministerstva financí fungují token a certifikát souběžně a externí systém může používat jedno, nebo druhé. Liší se způsobem získání, platností a tím, co dalšího umožňují.

Token KSeF a certifikát KSeF v integraci (stav k 14. 11. 2026)
VlastnostToken KSeFCertifikát KSeF (ověřování)
Co to jeŘetězec znaků vygenerovaný v KSeF s pevně daným rozsahem oprávnění, např. odesílání a čtení faktur.Elektronické potvrzení identity osoby nebo firmy s párem klíčů. Soukromý klíč zůstává u vás.
Jak ho získatVygenerujete ho v aplikaci Aplikacja Podatnika KSeF 2.0 nebo přes API (POST /tokens) po přihlášení.Žádost v aplikaci Aplikacja Podatnika KSeF 2.0 nebo přes API, po přihlášení přes Profil Zaufany, kvalifikovaným podpisem nebo kvalifikovanou pečetí.
PlatnostPlatné předpisy: do 31. 12. 2026. Návrh z 27. 10. 2026: stávající do 30. 11. 2027, nové nejvýše 365 dní.Nejvýše 2 roky, v době platnosti ho lze obnovit.
OprávněníZapsaná v tokenu. Změna rozsahu znamená nový token.Certifikát je neobsahuje: KSeF ověřuje oprávnění osoby nebo firmy, na kterou byl vystaven.
Požadavky na systémŠifrování tokenu veřejným klíčem ministerstva financí.Podpis XAdES ověřovacího dokumentu.
OmezeníPo přihlášení tokenem certifikát KSeF nevytvoříte.Do aplikace Aplikacja Podatnika KSeF se jím nepřihlásíte: slouží systémům, které se připojují přes API.
Podklad: § 6 a § 13 vyhlášky z 12. 12. 2025 (Dz.U. 2025 poz. 1815), stránka ministerstva financí o certifikátech KSeF, FAQ ke KSeF 2.0 a dokumentace API.

Token je na začátek jednodušší, protože systém nemusí podepisovat dokumenty XAdES. Certifikát má delší a předvídatelnou platnost a v integraci, kterou stavíte dnes, má ještě jednu výhodu: nezávisí na tom, jak dopadne změna předpisů o tokenech. Nejbezpečnější je postavit integraci tak, aby šel způsob přihlášení změnit v nastavení, bez úprav programu.

Jak získat certifikát KSeF krok za krokem?

Od února 2026 žádáte o certifikát v aplikaci Aplikacja Podatnika KSeF 2.0 nebo přes API KSeF 2.0. Modul certifikátů a oprávnění (Moduł Certyfikatów i Uprawnień, MCU), ve kterém se certifikáty vydávaly od listopadu 2025, fungoval do konce ledna 2026. V aplikaci to vypadá takto:

  1. Přihlaste se do aplikace Aplikacja Podatnika KSeF 2.0 přes Profil Zaufany (přes login.gov.pl), kvalifikovaným podpisem nebo kvalifikovanou pečetí firmy. Zkontrolujte, že pracujete v kontextu správného NIP.
  2. Otevřete záložku „Certyfikaty“ (certifikáty) a zvolte „Wnioskuj o certyfikat“ (požádat o certifikát). Údaje pro žádost aplikace převezme z přihlášení.
  3. Zvolte použití: ověřování, nebo režim offline. Jeden certifikát má jedno použití, takže pro obě potřebujete dvě žádosti.
  4. Zabezpečte soukromý klíč. Pár klíčů vzniká při žádosti a na ministerstvo jde jen veřejný klíč. Bez soukromého klíče je certifikát nepoužitelný, a kdo ho má, může jednat vaším jménem v rozsahu vašich oprávnění.
  5. Stáhněte certifikát a nahrajte ho do systému spolu se soukromým klíčem, bezpečným kanálem. Klíč neposílejte e-mailem.
  6. Zapište si datum platnosti. Další certifikát můžete objednat ještě před vypršením předchozího. Nastavte si připomenutí nejméně měsíc předem.

Systém může o certifikát požádat i sám, přes API: ověří limity (GET /certificates/limits), stáhne údaje pro žádost (GET /certificates/enrollments/data), odešle žádost CSR ve formátu PKCS#10 (POST /certificates/enrollments), zkontroluje stav a stáhne certifikát (POST /certificates/retrieve). Dokumentace připouští klíče RSA 2048 a EC P-256 a doporučuje EC. Certifikát může zneplatnit jen jeho vlastník, např. po úniku klíče (POST /certificates/{numer}/revoke), a zneplatněný certifikát už nelze obnovit.

Čí certifikát má mít firemní systém?

Certifikát potvrzuje identitu, ale nedává oprávnění. KSeF při každém připojení ověřuje, co smí osoba nebo firma, na kterou byl certifikát vystaven. Podle FAQ polského ministerstva financí může certifikát získat fyzická osoba identifikovaná číslem NIP nebo PESEL (polské rodné číslo) a firma, která se přihlašuje kvalifikovanou pečetí. Certifikát firmy lze sdílet se zaměstnanci, certifikát polské OSVČ (JDG) je osobní.

  • Certifikát firmy (kvalifikovaná pečeť): integrace nezávisí na jedné osobě. Rozumná volba pro CRM nebo e-shop, který vystavuje faktury za celou firmu.
  • Certifikát zaměstnance: funguje, dokud má tento zaměstnanec v KSeF oprávnění pro firmu. Když odejde a o oprávnění přijde, systém přestane faktury odesílat.
  • Účetní kancelář nebo externí dodavatel: přihlašuje se vlastním certifikátem a jedná v rozsahu oprávnění, která mu firma udělila. Návrh změny vyhlášky z 27. října 2026 počítá také s certifikátem vystaveným v kontextu jednoho určeného NIP, tedy platným jen pro konkrétního klienta. Jde o návrh.

Kdy je potřeba certifikát KSeF pro režim offline?

Když fakturu vystavujete bez připojení ke KSeF, musíte ji označit dvěma QR kódy. První umožňuje ověřit fakturu v KSeF, druhý potvrzuje identitu vystavitele a vyžaduje certifikát KSeF pro režim offline. Takový certifikát neslouží k přihlášení a certifikát pro přihlášení QR kód nepodepíše. Lhůty pro dodatečné odeslání faktury podle dokumentace API:

Režimy offline v KSeF 2.0 a lhůty pro dodatečné odeslání faktury
RežimKdyLhůta pro odeslání do KSeF
offline24Z jakéhokoli důvodu, rozhodnutí poplatníkaDo následujícího pracovního dne po datu vystavení
offline (nedostupnost)Vyhlášená nedostupnost KSeFDo následujícího pracovního dne po skončení nedostupnosti
nouzovýVyhlášená porucha KSeFDo 7 pracovních dnů od skončení poruchy
úplná poruchaPorucha vyhlášená ve sdělovacích prostředcíchFaktura bez QR kódů a bez povinnosti dodatečně ji odeslat do KSeF
Zdroj: režimy offline v dokumentaci API KSeF 2.0.

Pro systém to znamená čtyři věci: odeslání faktury s označením režimu offline, datum vystavení převzaté výhradně z pole P_1, oba QR kódy na výtisku i v PDF a hlídání lhůty pro dodatečné odeslání. E-shop nebo CRM bez certifikátu offline během nedostupnosti KSeF správnou fakturu pro firmu nevystaví.

Kde integraci s KSeF testovat: TEST, DEMO, nebo produkce?

Prostředí API KSeF 2.0 (dokumentace polského ministerstva financí z 16. 3. 2026)
ProstředíAdresa APIK čemu slouží
TESTapi-test.ksef.mf.gov.plPrvní testy integrace. Fiktivní čísla NIP, certifikáty si vygenerujete sami, data mohou vidět i jiní integrátoři. Servisní odstávky v době 16-18 h.
DEMO (předprodukční)api-demo.ksef.mf.gov.plPoslední kontrola v konfiguraci blízké produkci. Bez skutečných faktur a dat firem.
Produkceapi.ksef.mf.gov.plFaktury s plnými právními účinky.
Specifikace OpenAPI je na adrese prostředí s doplňkem /docs/v2. Ministerstvo poskytuje také oficiální klientské knihovny v C# a Javě.

V prostředí TEST ověříte přihlášení, odeslání faktury, odmítnutí, opravnou fakturu a režim offline. V prostředí DEMO totéž zopakujete s certifikátem, který použijete v produkci. Skutečné faktury do žádného z těchto prostředí neposílejte.

Co musí integrace zvládat kromě přihlášení?

  • Obnova přístupu: obnovování přístupového tokenu a nové přihlášení, když vyprší obnovovací token.
  • Připomenutí platnosti: upozornění před koncem platnosti certifikátu nebo tokenu, zaslané osobě, která může vygenerovat nový.
  • Bezpečné uložení: token a soukromý klíč v trezoru na tajné údaje nebo v šifrované konfiguraci, nikdy v kódu programu ani v tabulce.
  • Vyměnitelný způsob přihlášení: přechod z tokenu na certifikát bez přestavby integrace.
  • Faktury: odesílání FA(3), číslo KSeF a UPO (úřední potvrzení o přijetí) u faktury, zpracování odmítnutých faktur, opravné faktury s číslem KSeF původní faktury, stahování přijatých faktur a limity požadavků API.

Způsoby, jak napojit e-shop a CRM na KSeF, i s cenami (aplikace ministerstva financí, fakturační program, plugin, API brána, přímá integrace), jsme shrnuli v článku KSeF v CRM a e-shopu: 5 způsobů napojení a termíny pro rok 2027 v checklistu KSeF 2027. Pojmy najdete ve slovníku IT pojmů.

Kdy stačí hotový program a kdy je potřeba integrace?

Pokud vystavujete faktury ve fakturačním programu nebo na platformě e-shopu s podporou KSeF, nahrajete certifikát nebo token tam podle návodu dodavatele a programátora nepotřebujete. Integrace s API má smysl, když faktura vzniká ve vašem CRM, B2B portálu nebo systému objednávek, když máte několik zdrojů faktur, nebo když chcete, aby se číslo KSeF vracelo k objednávce a platbě.

UNSEEN takové integrace dodává od 1 400 EUR bez DPH (UN·Connect) a finanční modul s KSeF od 6 850 EUR bez DPH (UN·Finance). Odesílání faktur do KSeF jsme postavili mimo jiné v CRM pro firmu z oboru OZE: faktura vystavená v systému odejde do KSeF i s UPO a přijaté faktury se vracejí do systému. Celý rozsah popisujeme na stránce faktury z CRM a e-shopu do KSeF.

Nejčastější otázky k certifikátu a tokenu KSeF

Přestane token KSeF fungovat 31. prosince 2026?

Podle platné vyhlášky se lze tokenem přihlašovat do 31. prosince 2026. Polské ministerstvo financí oznámilo, že metoda zůstane, a návrh změny vyhlášky z 27. října 2026 počítá s platností stávajících tokenů do 30. listopadu 2027 a nových nejvýše 365 dní. Dokud změna nebude vyhlášena, platí 31. prosinec 2026.

Kde vygenerovat certifikát KSeF?

V aplikaci Aplikacja Podatnika KSeF 2.0, v záložce „Certyfikaty“, nebo přes API KSeF 2.0. Dříve, od listopadu 2025 do konce ledna 2026, vydával certifikáty Modul certifikátů a oprávnění (MCU).

Jak dlouho platí certifikát KSeF?

Nejvýše 2 roky od vytvoření nebo od počátečního data uvedeného v žádosti. Před koncem platnosti ho lze obnovit.

Přihlásím se certifikátem KSeF do aplikace Aplikacja Podatnika?

Ne. Certifikát pro ověřování slouží systémům, které se ke KSeF připojují přes API, např. fakturačním programům, e-shopům a CRM. Do aplikace Aplikacja Podatnika se přihlašujete přes Profil Zaufany, kvalifikovaným podpisem nebo kvalifikovanou pečetí.

Je pro faktury offline potřeba samostatný certifikát?

Ano. Druhý QR kód na faktuře offline vyžaduje certifikát KSeF pro režim offline. Certifikát pro přihlášení ho nenahradí a jeden certifikát nemůže mít obě použití.

Lze tokenem KSeF objednat certifikát?

Ne. Po přihlášení tokenem certifikát KSeF nevytvoříte. K žádosti je potřeba přihlášení přes Profil Zaufany, kvalifikovaným podpisem nebo kvalifikovanou pečetí.

Historie aktualizací

  • První verze. Způsoby ověřování, platnost tokenů a certifikátů, prostředí a režimy offline jsme ověřili 14. 11. 2026 ve sbírce Dziennik Ustaw, v RCL, na stránkách polského ministerstva financí a v dokumentaci API KSeF 2.0.

Zdroje

  1. Vyhláška polského ministra financí a hospodářství z 12. prosince 2025 o používání KSeF, Dz.U. 2025 poz. 1815 (§ 6, § 13) (ověřeno 14. 11. 2026)
  2. RCL: návrh vyhlášky, kterou se mění vyhláška o používání KSeF (27. 10. 2026) (ověřeno 14. 11. 2026)
  3. Polské ministerstvo financí: certifikáty KSeF (ověřeno 14. 11. 2026)
  4. Polské ministerstvo financí: otázky a odpovědi ke KSeF 2.0 (ověřeno 14. 11. 2026)
  5. Dokumentace API KSeF 2.0: ověřování (ověřeno 14. 11. 2026)
  6. Dokumentace API KSeF 2.0: certifikáty KSeF (ověřeno 14. 11. 2026)
  7. Dokumentace API KSeF 2.0: tokeny KSeF (ověřeno 14. 11. 2026)
  8. Dokumentace API KSeF 2.0: režimy offline (ověřeno 14. 11. 2026)
  9. Dokumentace API KSeF 2.0: prostředí (ověřeno 14. 11. 2026)
  10. Infor.pl: změny v KSeF od roku 2027, návrh novely vyhlášky (9. 11. 2026) (sekundární zdroj)

Článek má informativní charakter a není daňovým poradenstvím: v daňových otázkách se řiďte svým účetním nebo daňovým poradcem.

Potřebujete individuální radu?

Domluvte si bezplatnou konzultaci. Projdeme vaše podnikání a navrhneme konkrétní řešení.

Domluvit bezplatnou konzultaci (30 min)

Analytické a marketingové cookies jen s vaším souhlasem. Podrobnosti najdete v zásadách ochrany osobních údajů.