◆ 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
  • Existujúce SAPI a Enterprise API integrácie ostávajú podporované

Kto môže platiť: Koncová firma môže objednať a platiť vlastný Connector, alebo ho spravuje integrátor, ktorý platí súhrnne za autorizované 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.

Požiadať o sandboxOtvoriť Connector dokumentáciu

Pre koho napájate a kto platí?

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

Majiteľ alebo správca si API objedná v Nastaveniach → API a integrácie a hneď si vytvorí kľúč.

Otvoriť nastavenia API
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 €

Kaja Solutions je zatiaľ neplatiteľ DPH, uvedené sumy sú konečné. Žiadosť o registráciu pre DPH máme podanú.

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

    Pošlite nám e-mail pre prístup. Firma, rozhranie a účel sú voliteľné.

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

    Operátor vytvorí účet a dve testovacie firmy. 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.

Požiadať o sandboxOtvoriť produkčnú aktiváciuCelý onboardingový postup

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.

◆ 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 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.

Začnite žiadosťou o sandbox

Stačí e-mail pre prístup. Operátor pripraví účet a dve testovacie firmy.

info@epostak.skPožiadať o produkčný prístup
Technické zdrojeAPI dokumentáciaSDK v 6 jazykochEnterprise Core OpenAPIEnterprise Full OpenAPIERP Test LabeFaktúra validatorVizualizácia e-faktúryCenník

Obchodný 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.