◆ ePošťák API

Ako chcete napojiť svoje ERP?

Niekoľko jednoduchých spôsobov, ako pripojíte aplikáciu alebo ERP do siete Peppol. Vyberte, čo váš softvér dokáže vytvoriť.

Čo dokáže váš softvér vytvoriť?

Vaša voľba: Connector

Connector prijíma business JSON a riadi celý bežný ERP workflow až po doručenie, príjem a obchodnú odpoveď.

Prečo Connector

  • 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
  • SAPI aj Enterprise API sú plnohodnotné cesty, nemusíte migrovať

Kto môže platiť: Kto platí, neurčuje rozhranie, ale typ spolupráce v ďalšom kroku: firma sama (aj keď ju napája technický partner), alebo integrátor za všetky svoje firmy.

Connector · business JSONilustračné
POST /api/v1/connector/documents
Idempotency-Key: invoice-2026-0042

{
  "customerRef": "erp-vzor",
  "externalId": "invoice-2026-0042",
  "delivery": "send",
  "type": "invoice",
  "number": "2026-0042",
  "issueDate": "2026-07-15",
  "dueDate": "2026-07-29",
  "currency": "EUR",
  "buyerReference": "ODD-IT",
  "recipient": { "country": "SK", "taxId": "2120123456" },
  "lines": [{
    "description": "Mesačná licencia",
    "quantity": 1,
    "unit": "C62",
    "unitPrice": 100,
    "vatRate": 23,
    "taxTreatment": "standard"
  }]
}

Connector si vyskúšate zadarmo v sandboxe s dvoma testovacími firmami.

Pre koho napájate a kto platí?

Kto platí API
Vaša firma — podľa spotreby

Majiteľ alebo správca si API objedná v Nastavenia → Prepojenie s účtovným programom a hneď si vytvorí kľúč. Dodávate program viacerým firmám a každá si kľúč vloží sama? Žiadosť nepotrebujete.

Vaše rozhodnutie

Connector · Napájam svoju firmu

Kto platí: Vaša firma — podľa spotreby.

  1. Objednáte API v Nastaveniach a vytvoríte kľúč sk_live_*.
  2. Napojíte ERP podľa dokumentácie Connector.
  3. Platíte len za odoslané a prijaté dokumenty.
Otvoriť nastavenia API
REST API zdarma na testovanie

Tri rozhrania. Jedna cena.

Sandbox je zdarma. V produkcii platíte len za odoslané a prijaté dokumenty — bez paušálu a bez poplatku za zriadenie.

Celý API cenník
PásmoOdoslaniePríjem
Pásmo 01
1 – 1 000 dok./mes.
Odoslanie0,10 €
Príjem0,08 €
Pásmo 02
1 001 – 2 000 dok./mes.
Odoslanie0,08 €
Príjem0,07 €
Pásmo 03
2 001 – 5 000 dok./mes.
Odoslanie0,06 €
Príjem0,06 €
Pásmo 04
5 001 – 20 000 dok./mes.
Odoslanie0,05 €
Príjem0,05 €
Pásmo 05
20 001+ dok./mes.
Odoslanie0,04 €
Príjem0,04 €

Enterprise doplnok — AMQPS/RabbitMQ, Kafka alebo Edge Connector. Voliteľné rozšírenie Enterprise API pre AMQPS fronty v RabbitMQ, Kafka topics alebo hybridný či on-premise Edge Connector. Implementácia, prevádzka a licencia sa naceňujú individuálne podľa rozsahu.

Ako začať

Od žiadosti o sandbox po produkčnú prevádzku

Najprv bezpečne otestujete integráciu v testovacej sieti Peppol. Zmluvu a fakturáciu riešite až potom.

  1. Požiadajte o sandbox

    Vyplňte krátku žiadosť na dev.epostak.sk/dev.

  2. Získajte bezplatný testovací prístup

    Do pár minút dostanete e-mailom účet a dve testovacie firmy. Vlastnú firmu so skutočným DIČ pripravíme v pracovný deň do 4 hodín, dovtedy skúšate s verejnými demo účtami z dokumentácie. Sandbox je oddelený od produkcie a bez záväzku.

  3. Otestujte celý tok a vyberte API

    V testovacej sieti Peppol overíte odosielanie, príjem a stavy. Vyberiete Connector, SAPI alebo Enterprise API.

  4. Požiadajte o produkčný prístup

    Zvolíte, či platí integrátor alebo jednotlivé firmy. Žiadosť, zmluvu a oprávnenia overíme.

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 váš systém vytvára hotové UBL 2.1, zvoľte SAPI. Ak odovzdáva údaje faktúry v JSON-e bez UBL, zvoľte Connector. Enterprise API zvoľte, keď potrebujete riadiť jednotlivé technické kroky a webhooky.

◆ Otázky z praxe

Na čo sa integrátori pýtajú najčastejšie

Môže ERP automatizovať vytvorenie pozvánky a sledovať jej stav?

Áno. Enterprise Core API umožňuje z ERP vytvoriť pozvánku pre konkrétnu firmu a sledovať jej stav. Použijete existujúci partnerský prístup; SAPI štandard sa nemení. Oprávnená osoba firmy musí súhlas sama potvrdiť. Prijatý súhlas ešte nepotvrdzuje dokončenie aktivácie a účtovania. Jednorazový odkaz bezpečne uložte; vytvorenie pozvánky pri neistej odpovedi neopakujte naslepo. Presný postup a príklady sú v API dokumentácii v časti Onboarding klienta — Automatizácia z ERP.

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, multi-firma oprávnenia a export dokladov do účtovných programov priamo integrátorovi.

Ako získam prístup do sandboxu?

Vyplňte krátku žiadosť na dev.epostak.sk/dev; prístup s testovacími firmami dostanete e-mailom do pár minút. Vlastnú firmu alebo webové schránky pripravíme v pracovný deň do 4 hodín, dovtedy môžete skúšať s verejnými demo účtami z dokumentácie. 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 majú jeden vlastný kľúč, ktorým cez SAPI, Enterprise API aj Connector obsluhujú všetky firmy, ktoré im povolili prístup. Pri technickom partnerovi platí API každá firma sama, spravovaný integrátor platí za všetky firmy jednou faktúrou. Prístup platí vždy len pre konkrétnu firmu a v rozsahu, ktorý firma schválila, a firma ho môže kedykoľvek odvolať. Vlastný kľúč firmy partner nikdy nedostane.

Kto objednáva a platí API službu?

Sú tri možnosti. Priama firma si API objedná sama v Nastaveniach → API, platí ho sama a dostane vlastný kľúč (sk_live_*). Pri technickom partnerovi platí každá firma tiež sama podľa cenníka, ale napojí ju dodávateľ softvéru: ten podpíše bezplatnú zmluvu o technickom partnerstve a používa jeden vlastný kľúč (sk_int_*) pre všetky firmy, ktoré mu dali súhlas. Pri spravovanom integrátorovi platí za všetky firmy dodávateľ softvéru jednou faktúrou. Sandbox je bezplatný; produkčné používanie sa od 1. 6. 2026 účtuje podľa cenníka a skutočného objemu dokumentov.

Spravujem ERP pre viacero firiem a každá firma si bude platiť sama. Mám byť technický partner, alebo si každá firma vytvorí vlastný API kľúč?

Cena pre firmu je v oboch prípadoch rovnaká (cenník podľa objemu) a vy ako technický partner neplatíte nič. Rozdiel je v tom, kto robí ktorý krok. Na začiatku si každá firma v oboch prípadoch vyberie ePošťák ako digitálneho poštára na portáli Finančnej správy a aktivuje si schránku. Bez technického partnerstva sa potom firma prihlási, v Nastaveniach → API odsúhlasí objednávku, vygeneruje kľúč a odovzdá vám ho; vy spravujete samostatný kľúč pre každú firmu a pri jeho zmene či zrušení ste závislí od firmy. Ako technický partner máte jeden vlastný kľúč a do sandboxu dostanete testovacie firmy. Firme pošlete odkaz na pripojenie, ktorý vytvoríte v Partner Dashboarde alebo priamo z ERP cez API. Firma ho jedným potvrdením odsúhlasí a zároveň si tým objedná API; žiadny kľúč nevytvára ani neposiela. V Partner Dashboarde vidíte všetky pripojené firmy a stav ich pripojenia a firma môže súhlas kedykoľvek odvolať. Technické partnerstvo odporúčame, ak ERP prevádzkujete centrálne a pripájate viac firiem. Ak je ERP nainštalované u každej firmy samostatne a nemáte vlastnú centrálnu službu, cez ktorú inštalácie komunikujú, technické partnerstvo vám väčšinou nepomôže: do každej inštalácie patrí vlastný kľúč danej firmy, lebo partnerský kľúč platí pre všetky vaše firmy a má zostať len vo vašej správe.

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.

Začnite žiadosťou o sandbox

Vyplňte krátku žiadosť na dev.epostak.sk/dev a účet s dvoma testovacími firmami dostanete e-mailom do pár minút. Vlastnú firmu so skutočným DIČ pripravíme v pracovný deň do 4 hodín, dovtedy skúšate s verejnými demo účtami z dokumentácie. Testovacie prostredie je zdarma a netýka sa ostrých faktúr.

Kto podpisuje a kto platí, určuje typ spolupráce, nie rozhranie ani formát údajov. Priama firma si API objedná sama a používa vlastný kľúč. Pri technickom partnerovi podpíše dodávateľ softvéru bezplatnú zmluvu o technickom partnerstve a každá firma si API objedná a platí sama jedným potvrdením odkazu od partnera. Spravovaný integrátor podpíše integrátorskú zmluvu a platí za všetky svoje firmy. White Label (služba pod vlastnou značkou) sa objednáva v rámci žiadosti spravovaného integrátora.