Vyberáte jedno API. Nie tri vrstvy.
Ako chcete napojiť svoje ERP?
Connector, SAPI a Enterprise API nie sú tri vrstvy, ktoré musíte zapojiť naraz. Vyberiete si jedno rozhranie podľa toho, čo už vaše ERP posiela a koľko technických krokov chcete riadiť.
Digitálny poštár API a e-faktúra API v jednom napojení
Digitálny poštár API je rozhranie, cez ktoré ERP odosiela, prijíma a sleduje e-faktúry v sieti Peppol. E-faktúra API rieši ten istý praktický cieľ: prepojí účtovný alebo fakturačný systém s certifikovanou doručovacou službou bez ručného prepisovania dokladov.
Jednoduché pravidlo: ak ERP odovzdáva údaje faktúry v JSON-e, začnite Connectorom. Ak už vytvárate hotový UBL 2.1 a chcete prenositeľný štandard, zvoľte SAPI. Enterprise API otvorte, keď potrebujete riadiť jednotlivé technické kroky.
Vaša voľba: Connector
Connector
Connector prijíma business JSON a riadi celý bežný ERP workflow až po doručenie, príjem a obchodnú odpoveď.
- Čo posielate
- Business JSON s údajmi dokladu. ePošťák z neho pripraví štandardný dokument a odtieni Peppol mechaniku.
- Kto môže platiť
- Koncová firma môže objednať a platiť vlastný Connector alebo ho môže spravovať integrátor, ktorý platí súhrnne za autorizované firmy. Technická delegácia s platbou každej firmy je určená pre SAPI alebo Enterprise API.
- Odporúčaná cesta pre nový ERP business JSON
- customerRef bez X-Firm-Id a bežné ID príjemcu
- Spravovaný send, stage, príjem, stav a obchodné odpovede
- Existujúce SAPI a Enterprise API integrácie ostávajú podporované
ConnectorJedno spojenie. My zabezpečíme zložitosť.
Aktualizované: 19. júl 2026
Connector preberie zložitú časť integrácie
Bez Connectora
S Connectorom
ConnectorJeden bod pripojenia. Zvyšok integračného toku zabezpečí ePošťák.
Ako začať
Od žiadosti o sandbox po produkčnú prevádzku
Každý schválený záujemca dostane sandbox bezplatne. Najprv si bezpečne otestujete integráciu v testovacej sieti Peppol; až potom riešite zmluvu, fakturáciu a produkčné prístupy.
- 1
Požiadajte o sandbox
Z pracovného e-mailu nám pošlite názov firmy, požadované rozhranie a stručný účel integrácie. Žiadosť manuálne overíme a schválime.
- 2
Získajte bezplatný testovací prístup
Operátor vytvorí integrátorský účet, testovacie firmy a potrebné prístupy. Sandbox je oddelený od produkcie a nevzniká ním platený záväzok.
- 3
Otestujte celý tok a vyberte API
V testovacej sieti Peppol overíte odosielanie, prijímanie, stavy a prácu s firmami. Počas testovania si môžete vybrať Connector, SAPI alebo Enterprise API.
- 4
Požiadajte o produkčný prístup
Po úspešnom sandboxe na stránke aktivácie zvolíte, či platí integrátor alebo jednotlivé firmy. Žiadosť, zmluvu aj produkčné oprávnenia následne overíme.
Otázky z praxe
Na čo sa integrátori pýtajú najčastejšie
Odpovede vychádzajú z opakujúcich sa otázok zákazníkov a z aktuálneho verejného kontraktu rozhraní.
Ktoré integračné rozhranie si mám vybrať?
Connector je odporúčaná spravovaná cesta, ak ERP odovzdáva business JSON. SAPI zvoľte, ak už vytvárate hotový UBL 2.1 a potrebujete prenositeľný štandard Finančnej správy SR. Enterprise API je určené integráciám, ktoré chcú riadiť jednotlivé kroky, webhooky, preflight, hromadné operácie alebo viacero firiem.
Aký je rozdiel medzi Connectorom, SAPI a Enterprise API?
Connector z business JSON pripraví štandardný dokument a riadi bežný send, stage, príjem, stav aj obchodné odpovede. SAPI prenáša hotový UBL 2.1 v štandardnom obale a faktúru z business JSON nevytvára. Enterprise API sprístupňuje pokročilé kroky, udalosti, batch operácie a multi-firma oprávnenia priamo integrátorovi.
Ako získam prístup do sandboxu?
Napíšte z pracovného e-mailu na info@epostak.sk a uveďte názov firmy a účel integrácie. ePošťák partnera overí a operátor manuálne vytvorí sandbox prístup, testovacie firmy a podľa potreby webové schránky. Sandbox je bezplatný a nespúšťa produkčnú viazanosť. Produkcia sa aktivuje samostatne až po go-live kontrole, podpise zmluvy zvoleného partnerského režimu a spolupodpise Kaja Solutions.
Aké formáty môžem posielať cez API?
Connector prijíma business JSON, SAPI prenáša hotový UBL 2.1 a Enterprise API podľa operácie prijíma štruktúrovaný JSON alebo hotové UBL XML. PDF samo osebe nie je e-faktúra; Enterprise nástroje ho môžu použiť ako vstup na extrakciu, výsledný štruktúrovaný dokument však treba skontrolovať a validovať.
Zabezpečuje API odosielanie, príjem aj stav doručenia?
Áno. Connector aj Enterprise API pokrývajú odoslanie, inbox, udalosti a stav dokladu; SAPI poskytuje svoje štandardné operácie na odoslanie a príjem. Prijatie alebo validácia požiadavky ešte nie je dôkaz doručenia. Integrácia má sledovať následný transportný stav alebo udalosť.
Čo sa stane, ak príjemca nie je v Peppol alebo nepodporuje dokument?
Kontrola schopnosti príjemcu a preflight vrátia, či je dokument možné doručiť, a rozlíšia chýbajúce Peppol ID, nepodporovaný typ dokumentu alebo dočasnú chybu vyhľadania. Ak príjemca požadovaný dokument nepodporuje, ePošťák ho nevydáva za doručený.
Môžem cez jednu integráciu spravovať viacero firiem?
Áno. Technický partner aj spravovaný integrátor môžu cez jeden centrálny sk_int_* používať SAPI, Enterprise API aj Connector pre firmy, ktoré im udelili konkrétny odvolateľný súhlas. Pri technickom partnerovi platí spotrebu každá firma zo svojej API objednávky; v spravovanom režime platí integrátor súhrnne. Prístup je vždy viazaný na firmu a schválený rozsah; partner nikdy nedostane firemný sk_live_* tajný kľúč.
Kto objednáva a platí API službu?
Sú tri režimy. Priamy klient podpisuje a platí sám a používa sk_live_*. Technický partner podpisuje bezplatné partnerské oprávnenie a používa centrálny sk_int_*, ale každá koncová firma osobitne podpisuje vlastnú API objednávku, platí Kaja Solutions vlastnú spotrebu a udeľuje partnerovi odvolateľný súhlas. V spravovanom režime podpisuje integrátorskú zmluvu a súhrnne platí integrátor. Sandbox je bezplatný; produkčné používanie sa od 1. 6. 2026 účtuje podľa cenníka a skutočného objemu dokumentov.
Podporuje ePošťák API prílohy k faktúre?
Áno. Enterprise API podporuje najviac 20 príloh, 10 MB na súbor a 15 MB spolu po dekódovaní. Príloha, napríklad PDF alebo dodací list, dopĺňa štruktúrovanú faktúru, ale nenahrádza UBL dokument.
V akých programovacích jazykoch sú dostupné SDK?
SDK sú dostupné v 6 jazykoch: TypeScript/JavaScript, Python, PHP, C#/.NET, Java a Ruby. TypeScript balík je publikovaný ako @epostak/sdk; pri ostatných jazykoch si pred nasadením overte aktuálnu verziu a pokrytie endpointov v repozitári SDK.
Ak už máte vlastnú integračnú architektúru
Začnite žiadosťou o sandbox
Požiadať o sandbox e-mailomePošťák vás overí a operátor manuálne vytvorí prístup.
Požiadať o produkčný prístupObchodný režim je nezávislý od formátu údajov. Pri firemnom sk_live_* podpisuje a platí koncová firma. Pri technickom sk_int_* podpisuje dodávateľ softvéru zmluvu technického partnera, každá firma však osobitne podpisuje vlastnú API objednávku, platí vlastnú spotrebu Kaja Solutions a udeľuje odvolateľný súhlas. Pri spravovanom sk_int_* podpisuje integrátorskú zmluvu a súhrnne platí integrátor. Rámcová API zmluva · VOP / DPA · Cenník