API prepojenie
Máte vlastný fakturačný softvér a zákazníci sa vás pýtajú na eFaktúru? Napojte svoje riešenie na KROS Fakturáciu cez API a povinnosť elektronickej fakturácie vyriešite bez toho, aby ste museli budovať a certifikovať vlastného digitálneho poštára.
Prečo sa vás táto téma týka
Od 1. januára 2027 musia platitelia DPH na Slovensku vystavovať faktúry ako štruktúrovaný elektronický doklad (EN 16931, v praxi Peppol BIS Billing 3.0) a doručovať ho výhradne cez certifikovaného digitálneho poštára. Prijímať takéto faktúry musí takmer každý podnikateľ, vrátane neplatiteľov DPH.
Ak vaši zákazníci fakturujú vo vašom softvéri, môžu od vás očakávať riešenie pre eFaktúru. Budovanie a certifikácia vlastného Access Pointu je pre väčšinu dodávateľov softvéru samostatná investícia, ktorá sa neoplatí popri hlavnom produkte.
Riešením je napojenie na existujúceho, už certifikovaného poskytovateľa, ktorým môže byť práve KROS.
Ako to funguje
Vaše riešenie posiela a prijíma doklady cez aplikáciu KROS Fakturácia, ktorá zabezpečuje úlohu digitálneho poštára a komunikáciu so sieťou Peppol. Vy sa nemusíte starať o certifikáciu, formát dokladu ani samotné doručenie. Sústredíte sa na prepojenie vlastného softvéru s naším API.
Tok dokladu:
Odosielanie: váš softvér → (API) → KROS Fakturácia → KROS digitálny poštár → Peppol → odberateľ
Príjem: odberateľ → Peppol → KROS digitálny poštár → KROS eFaktúra → (API) → váš softvér
Podmienky napojenia
Riešenie funguje, keď sú splnené všetky 3 podmienky súčasne:
- Registrácia zákazníka – váš koncový zákazník si na finančnej správe zvolí a zaregistruje KROS ako svojho digitálneho poštára (pre odosielanie aj príjem).
- Licencia KROS Fakturácia s API – váš koncový zákazník má zakúpenú licenciu KROS Fakturácia vrátane licencie na API (ide o jeho zmluvný vzťah s KROS).
- Vlastný doplnok – vy si na vlastné náklady zrealizujete prepojenie svojho softvéru s KROS Fakturáciou podľa dostupnej dokumentácie.
Bez licencie KROS Fakturácia s API na strane koncového zákazníka riešenie nie je funkčné. Nejde o samostatnú/white-label službu digitálneho poštára.
Technické informácie pre vývojárov
Rozsah API, autorizačné modely (odporúčame Integration Consent), webhooky, chyby, limity aj kontakt na integračnú podporu nájdete v technickej dokumentácii.
Odporúčaný postup na začiatok
- Overte si s obchodným tímom KROS, či váš scenár do modelu zapadá (typ dokladov, objemy, špecifiká ako EDI či hromadná fakturácia).
- Zabezpečte u koncového zákazníka licenciu KROS Fakturácia s API a jeho registráciu KROS ako digitálneho poštára na finančnej správe.
- Naštudujte si dokumentáciu na developer.kros.sk, zvoľte autorizačný model (odporúčame Integration Consent) a navrhnite mapovanie dát.
- Implementujte a otestujte doplnok pre odosielanie aj príjem vrátane spracovania stavov a chýb.
- Nasaďte u pilotného zákazníka s dostatočnou rezervou pred 1. januárom 2027.
Čo KROS v tomto modeli neponúka
- Digitálneho poštára ako samostatnú alebo white-label službu bez licencie KROS Fakturácia.
- Priamy prístup do siete Peppol mimo produktov KROS.
- Vývoj, testovanie ani prevádzku doplnku na vašej strane – integráciu si zabezpečujete sami.
- Preberanie zodpovednosti za dáta a procesy, ktoré vznikajú vo vašom softvéri.
Kontaktujte nás
Máte otázky alebo sa chcete dozvedieť viac? Vyplňte kontaktný formulár a my sa vám ozveme.