Prvý slovenský digitálny poštár s kompletným API pre e-fakturáciu a ERP

Od 1. januára 2027 budú všetky slovenské firmy povinné posielať a prijímať faktúry elektronicky cez sieť Peppol. Zatiaľ čo väčšina digitálnych poštárov stavia iba webové rozhranie a jednoduchý formulár na fakturáciu, ePošťák ide opačnou cestou — postavili sme kompletné REST API, ktoré pokrýva celý životný cyklus faktúry: odoslanie, príjem, validáciu, archiváciu, reporting pre Finančnú správu aj pripojenie na ktorýkoľvek ERP alebo účtovný softvér. Nechceli sme len ďalší portál — chceli sme infraštruktúru, na ktorej môžu vývojári, integrátori a ERP dodávatelia stavať vlastné riešenia.

V tomto článku vysvetlíme, prečo je „kompletné API" pre e-fakturáciu dôležité, ako sa líšime od ostatných uchádzačov o certifikáciu, ako jednoducho sa dá pripojiť cez naše SDK v šiestich jazykocha prečo sa firmy s vlastným ERP systémom rozhodujú pre nás.

Povinnosť e-fakturácie od roku 2027 nie je len administratívna zmena. Týka sa úplne každého toku faktúry vo firme — od e-shopu cez ERP až po účtovný softvér. Ak firma vystaví mesačne desať faktúr, stačí jej webový formulár digitálneho poštára. Ale ak ich má päťsto, alebo ak faktúry vznikajú automaticky v ERP systéme, ručné prepisovanie do portálu je mŕtva cesta.

API rozhoduje o troch veciach: rýchlosti (faktúra sa odošle automaticky v sekunde po vystavení v ERP), spoľahlivosti(žiadne ručné chyby, žiadne zabudnuté faktúry) a škálovaní (rovnako funguje pre 10 aj 10 000 faktúr mesačne). Podrobný rozbor automatizácie nájdete aj v článku Automatizácia fakturačného toku cez e-faktúru.

„Kompletné" v našom ponímaní znamená, že nad našou sieťou viete postaviť úplne celýprodukt — nielen odoslať faktúru, ale aj overiť príjemcu, prijať prichádzajúce faktúry, validovať ich podľa EN 16931, reagovať na ne fakturačnou odpoveďou, reportovať do Finančnej správy a archivovať po zákonnú dobu desať rokov. Toto je všetko, čo kompletné API pokrýva:

Na Slovensku vzniká spoločný otvorený štandard pre komunikáciu s digitálnymi poštármi — tzv. SAPI (Standard API špecifikácia od PASR). Nie je povinný zo zákona, no PASR ho odporúča každému certifikovanému poštárovi, aby mali dodávatelia ERP a fakturačných softvérov jednotné rozhranie. Raz implementované volania potom fungujú proti ktorémukoľvek poštárovi, ktorý SAPI podporuje. ePošťák sa k tomuto štandardu hlási a implementuje ho v plnom rozsahu.

Enterprise APIje naše vlastné rozšírenie nad SAPI — prináša funkcie, ktoré SAPI štandard nepokrýva: OCR, správu viacerých firiem pod jedným účtom, hromadné operácie, rozšírenú archiváciu, webhooky s retry logikou a reporting. Je určené integrátorom, ktorí chcú postaviť plnohodnotné riešenie pre koncových zákazníkov.

Nevyžadujeme, aby ste si písali HTTP volania ručne. Oficiálne SDK sme pripravili v šiestich jazykoch, aby ste mohli odoslať prvú faktúru v jazyku, v ktorom už píšete zvyšok aplikácie. TypeScript SDK je publikovaný na npm, ostatné SDK sú dostupné na GitHube.

Kompletné odoslanie faktúry v TypeScripte vyzerá takto:

import { EPostak } from "@epostak/sdk";

const client = new EPostak({ apiKey: "sk_live_..." });

const result = await client.documents.send({
  receiverPeppolId: "0245:1234567890",
  invoiceNumber: "FV-2026-001",
  issueDate: "2026-04-23",
  dueDate: "2026-05-07",
  items: [
    { description: "Konzultácia", quantity: 10, unitPrice: 50, vatRate: 23 },
  ],
});

console.log(result.peppolMessageId);

Desať riadkov kódu — faktúra validovaná, odoslaná cez Peppol, archivovaná a nahlásená na FS SR.

Namiesto toho, aby ste sa museli každých pár minút pýtať „prišla mi nová faktúra?", webhooky obrátia smer komunikácie — my vám zavoláme, len čo sa niečo stane. Nastavíte jeden endpoint na svojej strane a prihlásite sa na tieto udalosti:

Každá udalosť obsahuje identifikátor dokumentu, firmu a časovú pečiatku. Každé volanie je kryptograficky podpísané, aby ste si overili, že reálne prišlo z ePošťáka. Pri dočasnom výpadku vašej strany webhook inteligentne opakuje volanie, kým prejde.

Nie každá prichádzajúca faktúra je elektronická. Stále vám chodia papierové faktúry, PDF v maile alebo nascanované dokumenty. Pošlete obrázok alebo PDF a vrátime štruktúrované dáta, ktoré môžete rovno poslať do svojho účtovného systému alebo ich automaticky pretransformovať na plnohodnotnú Peppol e-faktúru.

Extrakcia pokrýva dodávateľa (IČO, DIČ, IČ DPH, adresa), odberateľa, položky faktúry, sumy, DPH sadzby, termíny splatnosti aj bankové spojenie — všetko podľa európskej normy EN 16931, takže výstup je kompatibilný s celým Peppol ekosystémom.

Pretože naše API je postavené na otvorenej špecifikácii OpenAPI 3.1, môže ho zavolať doslova čokoľvek — od moderného Node.js servera po dvadsať rokov starú Delphi aplikáciu cez jednoduchý HTTP klient. V praxi najčastejšie vidíme tieto scenáre:

Cesta od „chcem to vyskúšať" po prvú odoslanú faktúru cez API trvá doslova pár minút. Netreba volať obchodníka, netreba čakať na schválenie, netreba vypĺňať PDF formuláre.

1. 01

   Testovacie prostredie

   Testovacie kľúče a sandbox nájdete priamo v dokumentácii Enterprise API — môžete skúšať hneď, bez registrácie. Produkčné kľúče vydávame na požiadanie: napíšte nám na info@epostak.sk a kľúč dostanete obratom.

   Dokumentácia Enterprise API →
2. 02

   Inštalácia SDK

   TypeScript SDK nainštalujete jedným príkazom: npm install @epostak/sdk. Pre Python, PHP, Javu, C#/.NET a Ruby je zdrojový kód dostupný na GitHube — naklonujete a zabuildíte ako lokálnu knižnicu. SDK má typované schémy, editor napovedá polia a chyby chytí už pri písaní.

   Dokumentácia pre vývojárov →
3. 03

   Prvé volanie

   Zavoláte jeden príkaz na odoslanie faktúry. API vráti identifikátor správy — od tohto okamihu vidíte stav doručenia v reálnom čase cez webhook.

   Príklady pre vývojárov →