◆ 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.
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í?
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.
Connector · Napájam svoju firmu
Kto platí: Vaša firma — podľa spotreby.
- Objednáte API v Nastaveniach a vytvoríte kľúč sk_live_*.
- Napojíte ERP podľa dokumentácie Connector.
- Platíte len za odoslané a prijaté dokumenty.
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.
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.
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.
Požiadajte o sandbox
Vyplňte krátku žiadosť na dev.epostak.sk/dev.
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.
Otestujte celý tok a vyberte API
V testovacej sieti Peppol overíte odosielanie, príjem a stavy. Vyberiete Connector, SAPI alebo Enterprise API.
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.
Na čo sa integrátori pýtajú najčastejšie
Môže ERP automatizovať vytvorenie pozvánky a sledovať jej stav?
Ktoré integračné rozhranie si mám vybrať?
Aký je rozdiel medzi Connectorom, SAPI a Enterprise API?
Ako získam prístup do sandboxu?
Aké formáty môžem posielať cez API?
Zabezpečuje API odosielanie, príjem aj stav doručenia?
Čo sa stane, ak príjemca nie je v Peppol alebo nepodporuje dokument?
Môžem cez jednu integráciu spravovať viacero firiem?
Kto objednáva a platí API službu?
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ľúč?
Podporuje ePošťák API prílohy k faktúre?
V akých programovacích jazykoch sú dostupné 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.