API integrácia digitálneho poštára pre ERP a integrátorov
Dobrovoľná e-fakturácia 2026 · Povinná od 1. januára 2027
ePošťák je prvý certifikovaný slovenský digitálny poštár s verejným REST API. Cez sandbox zdarma a SAPI/Enterprise API odošlete e-faktúry cez Peppol BIS 3.0 do 39 krajín — od €0,06 za doručený dokument.
API integrácia digitálneho poštára pre napojenie ERP, účtovných softvérov a vlastných riešení na Peppol sieť. Automatizácia fakturácie cez SAPI štandard (Finančná správa SR), Enterprise API s 40+ endpointmi, webhooky, OCR, multi-firma. Dokumentácia v slovenčine aj angličtine.
SDK v 6 jazykoch • OpenAPI 3.1 • Self-service sandbox na dev.epostak.sk/integrator • produkcia až po go-live
const token = "eyJhbGciOiJSUzI1NiIs..."
// Odoslanie e-faktúry cez Peppol
const response = await fetch("https://epostak.sk/api/v1/documents/send", {
method: "POST",
headers: { Authorization: `Bearer ${token}`, "Content-Type": "application/json" },
body: JSON.stringify({
receiverPeppolId: "0245:0000000001",
invoiceNumber: "FAK-2026-001",
items: [{ description: "Vývoj softvéru", quantity: 8, unitPrice: 125, vatRate: 23 }],
})
})
console.log(await response.json())Vyberte si rozhranie
SAPI štandard, plné Enterprise API a Connector ako najkratšia cesta pre ERP do Peppol siete cez ePošťák.
Prečo Enterprise API stojí za to
Pay-per-success cena od €0,06 za dokument neznamená "lacné API". V každej cene je zahrnutá plná prevádzková zodpovednosť.
- 0199.5
Platformové SLA 99,5 %
Dostupnosť našej API platformy podľa VOP. Status page oddeľuje ePošťák platformu od Peppol siete a externého doručovania.
- 0224/7
Podpora 24/7
Email, telefón, Slack kanál. Priemerná prvá odpoveď pod 15 minút. Priamy kontakt na engineering tím.
- 03AI
OCR extrakcia z PDF
AI parsovanie scanovaných faktúr na štruktúrované dáta. Vrátane bulk endpointu — v cene, nie ako addon.
- 0410y+
Denné zálohy + archív
UBL, PDF a transportné dôkazy sú dostupné podľa zvoleného plánu a retenčných pravidiel vo VOP. Denné encrypted zálohy mimo primárnu lokalitu.
Od sandbox po produkciu
Tri kroky k integrácii e-fakturácie cez certifikovaný digitálny poštár.
- 01
Získajte sandbox
Zaregistrujte sa na dev.epostak.sk/integrator. Po overení emailu a schválení sandbox integrátora si vytvoríte testovacie API kľúče a sandbox firmy. Produkčný integrátor je oddelený a dostupný až po schválenom go-live a podpísanej zmluve.
- 02
Integrujte
SDK v 6 jazykoch: TypeScript na npm, Python/PHP/.NET/Java/Ruby ako zdrojové kódy na GitHube.
- 03
Spustite produkciu
Od €0,06/dok, bez fixného poplatku. White-label — vaši klienti neplatia za poštára.
Čo pokrýva API integrácia digitálneho poštára
Aktuálny stav k máju 2026. Sandbox a všetky endpointy sú dostupné už dnes — pripravené na povinnú e-fakturáciu od 1. januára 2027.
- 01
Dokumenty
Odosielanie a príjem e-faktúr cez Peppol, sledovanie stavu, AS4 potvrdenky.
- POST /api/v1/documents/send
- GET /api/v1/documents/inbox
- GET /api/v1/documents/{id}/status
- 02
Validácia a konverzia
Validácia UBL proti Peppol BIS 3.0, konverzia JSON↔XML, preflight check.
- POST /api/v1/documents/validate
- POST /api/v1/documents/convert
- POST /api/v1/documents/preflight
- 03
AI extrakcia
Extrakcia fakturačných dát z PDF a obrázkov. Jednotlivo aj hromadne (50 súborov).
- POST /api/v1/extract
- POST /api/v1/extract/batch
- 04
Webhooky
Real-time notifikácie, HTTPS validácia, história doručení, filtrovanie.
- POST /api/v1/webhooks
- GET /api/v1/webhooks/{id}/deliveries
- POST /api/v1/webhooks/{id}/test
- 05
Správa firiem
Multi-firma prístup, priradenie podľa DIČ alebo IČO, Peppol ID registrácia, bulk.
- GET /api/v1/firms
- POST /api/v1/firms/assign
- POST /api/v1/firms/assign/batch
- 06
Peppol sieť
SMP lookup, Peppol Directory (3,6M+ záznamov), overenie IČO.
- GET /api/v1/peppol/participants/resolve
- POST /api/v1/peppol/participants/batch
- GET /api/v1/peppol/directory/search
SDK v 6 jazykoch
TypeScript SDK je publikované na npm. Python, PHP, .NET, Java a Ruby SDK sú dostupné ako zdrojové kódy na GitHube.
Príklady API integrácie — cURL, Python, Node.js
Aktualizované máj 2026. Reálny POST /api/v1/documents/send request a ukážka webhook payloadu pre document.delivered event. Plnú referenciu nájdete v SAPI dokumentácii alebo v Enterprise API dokumentácii.
curl -X POST https://epostak.sk/api/v1/documents/send \
-H "Authorization: Bearer eyJhbGciOiJSUzI1NiIs..." \
-H "Content-Type: application/json" \
-H "Idempotency-Key: inv-2026-001" \
-d '{
"receiverPeppolId": "0245:0000000001",
"invoiceNumber": "FAK-2026-001",
"currency": "EUR",
"items": [
{"description": "Vývoj softvéru", "quantity": 8, "unitPrice": 125, "vatRate": 23}
]
}'SAPI vs Enterprise API vs Connector
SAPI je štandardizované rozhranie Finančnej správy SR. Enterprise API je plné technické rozhranie ePošťáku. Connector je jednoduchý riadený tok nad Enterprise API pre rýchle ERP napojenie.
| Vlastnosť | SAPI štandard | Enterprise API | Connector |
|---|---|---|---|
| 01Autentifikácia | OAuth 2.0 | API kľúč vymenený za JWT cez /api/v1/auth/token | Rovnaké Enterprise API prihlasovanie |
| 02Počet API volaní | 8 (core) | 40+ (rozšírené) | Krátky riadený tok pre odoslanie, frontu faktúr (nahrať teraz, odoslať neskôr), stav, prijaté faktúry, udalosti a potvrdenie |
| 03Webhooky | — | ✓ (HMAC SHA-512) | Voliteľné; pravidelné čítanie funguje bez nastavovania webhooku |
| 04OCR z PDF | — | ✓ (AI extrakcia) | Cez Enterprise API, keď ho integrátor potrebuje |
| 05Konverzia UBL ↔ PDF | — | ✓ | Cez rovnaký documentId v Enterprise API |
| 06Multi-firma (white-label) | — | ✓ (neobmedzený počet) | Používa rovnaké integrátorské oprávnenia |
| 07Bulk operácie | — | ✓ (až 500/request) | Optimalizované pre najčastejší ERP tok a celý životný cyklus faktúry |
| 08Klientske knižnice | OpenAPI + HTTP príklady | 6 SDK: npm + GitHub zdroj | Metódy Connectora v SDK vrátane fronty faktúr + HTTP príklady |
| 09SLA | platformové 99,5 % | platformové 99,5 % | Rovnaká infraštruktúra a platformové SLA ako Enterprise API |
| 10Cena | od €0,06/dokument | od €0,06/dokument | Rovnaký objemový model, menej integračnej práce |
| 11Vhodné pre | softvéry s SAPI implementáciou | ERP, integrátori, white-label | ERP, ktoré chce rýchle testovacie napojenie do siete Peppol |
Aktuálne k máju 2026
Najnovšie míľniky API integrácie digitálneho poštára. Sledujeme Peppol roadmap a regulačný kalendár Finančnej správy SR.
- Máj 202601
SDK v 6 jazykoch a OpenAPI aktualizované
Verejná dokumentácia používa aktuálne /api/v1/documents/send a /api/v1/documents/* endpointy, JWT autentifikáciu a rozlišuje npm-publikovaný TypeScript SDK od GitHub-source SDK pre Python/PHP/.NET/Java/Ruby.
- Apríl 202602
Peppol testbed: 10/10 passed
Všetkých 10 testovacích scenárov SK Peppol (billing aj self-billing) prešlo. Pripravené na produkciu.
- Marec 202603
OpenPeppol member
ePošťák je certifikovaný Peppol prístupový bod a člen OpenPeppol. Doručujeme do 39 krajín.
Kompletnú časovú os a plán nasadenia nájdete v roadmape. Pre kontext, prečo ePošťák existuje a kto za ním stojí, pozrite certifikovaný digitálny poštár.
Transparentné ceny bez skrytých poplatkov
Platné pre dobrovoľnú e-fakturáciu v roku 2026 a povinnú e-fakturáciu od 1. januára 2027. Integrátor platí za všetky firmy — klientské firmy neplatia nič za digitálneho poštára. Objem sa počíta naprieč všetkými spravovanými firmami.
| Objem | Cena/dok |
|---|---|
| 1 – 1 000 | 0,10 € |
| 1 001 – 2 000 | 0,08 € |
| 2 001+ | 0,06 € |
| 5 000+ | Individuálne |
| Objem | Cena/dok |
|---|---|
| 1 – 1 000 | 0,08 € |
| 1 001 – 2 000 | 0,07 € |
| 2 001+ | 0,06 € |
| 5 000+ | Individuálne |
objemové zľavy sa počítajú naprieč všetkými spravovanými firmami, nie per-firma. Ak spravujete 20 firiem a každá odošle 100 dokumentov mesačne, celkový objem je 2 000 dokumentov.
Pre koho je API integrácia digitálneho poštára
Integrátori a ERP poskytovatelia, ktorí potrebujú napojenie účtovného softvéru na Peppol sieť — alebo automatizáciu fakturácie pre svoje firmy a klientov.
- 01
ERP systémy
Automatické odosielanie a príjem e-faktúr priamo z vášho ERP cez Peppol.
- 02
Fakturačné softvéry
Pridajte Peppol do vašej aplikácie. White-label — vaši klienti vidia vašu značku.
- 03
Účtovné platformy
Multi-firma API prístup. Spravujte desiatky firiem z jedného účtu.
- 04
Custom aplikácie
REST API s dokumentáciou v SK + EN. Postavte vlastné riešenie.
Časté otázky
Integrujte e-fakturáciu do vášho softvéru ešte dnes
Sandbox zadarmo, SDK v 6 jazykoch, dokumentácia v SK + EN, technická podpora.