Prepojte vaše vlastné systémy, ERP, e-shopy, firemné portály a automatizačné scenáre priamo s eFakturaPRO. Štedré mesačné limity 3 000 až 20 000 volaní v cene predplatného, samostatný Sandbox s 10 000 volaniami a dokupovanie už od 3 € bez DPH za 10 000 volaní.
Navrhnuté pre vývojárov, systémových integrátorov aj firemné IT tímy. Žiadne uzavreté monolity.
Napojte zákaznícke portály, klientske zóny a vlastné backoffice nástroje. Vytvárajte partnerov, vystavujte faktúry a sťahujte vygenerované PDF s QR platbami.
externalIdGET /capabilitiesAutomatizujte fakturáciu z WooCommerce, Shoptetu, Prestashopu či vlastného košíka. Vystavenie zálohových aj ostrých faktúr, evidencia úhrad z platobných brán.
Idempotency-KeySynchronizujte číselníky, stav skladu a finančné toky do externých analytických systémov, Power BI či Tableau bez manuálneho exportovania tabuliek.
Prepojte eFakturaPRO s no-code a low-code nástrojmi. Udalosti posielame na váš HTTPS webhook endpoint s bezpečným overením podpisu.
invoice.created, payment.createdHráme s otvorenými kartami. Tu je presný zoznam toho, čo rozhranie umožňuje a kde sú jeho bezpečnostné a systémové hranice.
Čítať identifikačné údaje firmy (IČO, DIČ, IČ DPH, sídlo) a nastavené číselné rady.
Čítanie číselného radu iba vracia nastavenia a masku; nepridelí vopred nové číslo.
Zoznam, detail, vyhľadávanie, vytvorenie alebo bezpečný upsert partnera cez stabilné externalId.
Kľúč pracuje výhradne s partnermi firmy priradenej ku kľúču; nevidí cudzie subjekty.
Zoznam dokladov, filtrovanie, detail, položky, vytvorenie konceptu (draft) a vystavenie faktúry.
Vytvorenie konceptu nevystaví doklad. Vystavenie vyžaduje samostatné scope invoice.write a platné údaje.
Vyžiadať generovanie PDF, sledovať priebeh asynchrónnej úlohy, stiahnuť hotové PDF a sprístupnené prílohy.
Generovanie prebieha aj asynchrónne; sprístupňuje iba existujúce podporované artefakty.
Čítať históriu úhrad a zaevidovať úhradu k existujúcej vystavenej faktúre.
Evidencia úhrady v systéme nie je bankový prevod a neodosiela žiadne reálne peniaze.
Čítať položky cenníka, služby, skladové karty a aktuálne dostupné skladové množstvá.
Iba čítanie; API neposkytuje endpointy pre všeobecné skladové zápisy, príjemky a výdajky.
Čítať hlavičky nákladov, sumy, dodávateľa, podporované prílohy a pôvodné zdrojové artefakty vrátane dostupného XML.
Neumožňuje ľubovoľnú editáciu nákladov ani prístup k interným systémovým súborom mimo schválených artefaktov.
Odovzdať jeden súbor (PDF/JPG/PNG do 25 MiB) alebo štruktúrovaný JSON do frontu na spracovanie.
Prijatie súboru serverom neznamená automaticky dokončené vyťaženie ani zaúčtovanie.
Čítať uložené bankové účty, importované výpisy a pohyby; získať návrh priradenia k faktúre, proforme či nákladu.
Náhľad návrhu nemení párovanie ani účtovníctvo; API nevykonáva platby ani neodosiela prevody.
Čítať zoznam nastavených pravidiel pravidelnej fakturácie a ich detail.
Iba čítanie pravidiel; bez možnosti tvorby, úpravy alebo manuálneho spúšťania pravidiel cez API.
Čítať účtovné udalosti; pri SK jednoduchom účtovníctve peňažný denník a kategórie, pri podvojnom denníkové zápisy a analytické účty.
Dostupné podľa programu (PRO/MAX); neslúži na všeobecný účtovný zápis mimo generovaných dokladov.
Vytvoriť faktúru a automaticky ju odoslať zákazníkovi cez pripojený účet Gmail alebo Microsoft Outlook.
Vyžaduje pripojený poštový účet vo firme a scope email.send; uplatňujú sa aj limity poskytovateľa e-mailu.
Automatické doručovanie udalostí o partneroch, dokladoch, úhradách a ePoštárovi na váš HTTPS endpoint.
Podpisované HMAC kľúčom; príjemca musí overovať podpis a počítať s možnou duplicitou pri sieťovom retry.
ePoštár nie je samostatný oddelený svet – využíva rovnaký bezpečný integračný základ, no riadi sa samostatnými oprávneniami (scope) a pravidlami overenej slovenskej firmy. API volania (dopyty) a ePoštár kredity (odoslania faktúr do Peppolu) sú striktne oddelené.
Pred produkčným odoslaním overíte štruktúru dokladu cez náhľad bez rizika odoslania chybnej faktúry.
Transparentné stavy doručenia. Zrušenie odoslania je možné výhradne v stave, ktorý povoľuje kontrakt.
Lokálny inbox, vyžiadanie importu do nákladov a trvalé potvrdenie prevzatia po splnení podmienok.
Vyžiadanie firemného ZIP archívu a okamžitá notifikácia pri akejkoľvek zmene stavu doručenia.
Veľmi štedré základné rozsahy zahrnuté priamo v cene programov BIZ, PRO a MAX. Žiadne viazané zmluvy ani skryté aktivačné poplatky.
| Program | Cena predplatného | Mesačný limit API volaní | Účtovná nadstavba cez API | Zahrnuté odoslania ePoštárom |
|---|---|---|---|---|
| FREE | 0 € | ❌ Nie (iba web & app) | ❌ Nie | 0 (iba bežná B2C fakturácia) |
| PLUS | od 4,90 € / mes. | ❌ Nie (iba web & app) | ❌ Nie | 10 / mes. (cez web/app) |
| XXLpre účtovné kancelárie | od 30 € / mes. | ❌ Nie (mantinel: bez verejného API) | Plné podvojné aj jednoduché | Zdieľaný fond kancelárie |
| BIZ | 10 € / mes. | 3 000 volaní / mes. | Bez účtovnej nadstavby | 30 e-faktúr / mes. (360 / rok) |
| PRO | 15 € / mes. | 10 000 volaní / mes. | Jednoduché účtovníctvo & SK peňažný denník | 50 e-faktúr / mes. (600 / rok) |
| MAX | 20 € / mes. | 20 000 volaní / mes. | Podvojné účtovníctvo, denník & analytika | 100 e-faktúr / mes. (1 200 / rok) |
Limit sa obnovuje podľa vášho mesačného fakturačného obdobia (nie kalendárneho mesiaca). Pri ročnom predplatnom prebieha obnova taktiež mesačne. Nevyužité zahrnuté volania sa do ďalšieho mesiaca neprenášajú.
Limit platí spoločne pre všetky vygenerované API kľúče danej firmy. Vytvorenie ďalšieho kľúča nezvyšuje celkový objem volaní.
Započítavajú sa iba úspešné požiadavky; každá stránka zoznamu samostatne. Chybové odpovede (4xx, 5xx) a rozpoznané duplicitné požiadavky (idempotencia) limit nemíňajú. Interné používanie webovej a mobilnej aplikácie limit nemíňa.
Zákaznícky sandbox má samostatný limit 10 000 volaní, ktorý je úplne nezávislý od vašej produkčnej kvóty a nečerpá vám ostré volania.
API_MONTHLY_QUOTA_EXCEEDED. Čerpanie, zostatok a presný termín obnovy vidíte v reálnom čase v sekcii Kredity aj v nastaveniach Prepojení.Žiadne drahé upgrady na enterprise plány. Ponúkame dve transparentné možnosti rozšírenia bez viazanosti (ceny bez DPH).
Máte zakúpený kreditný balíček? Jednoducho si prevediete časť kreditov na API volania v pomere:
| Pôvodný balík kreditov | Cena balíka bez DPH | Efektívna cena za 10 000 volaní |
|---|---|---|
| 50 kreditov | 19,90 € | 7,96 € |
| 100 kreditov | 29,90 € | 5,98 € |
| 300 kreditov | 59,90 € | 3,99 € |
| 1 000 kreditov | 149,90 € | 3,00 € |
Nechcete kupovať AI kredity? Kúpte si priamo balík API volaní s dlhou platnosťou celých 12 mesiacov od úhrady.
| Samostatný API balík | Cena bez DPH | Cena za 10 000 volaní | Platnosť |
|---|---|---|---|
| 10 000 volaní | 8 € | 8,00 € | 12 mesiacov |
| 50 000 volaní | 30 € | 6,00 € | 12 mesiacov |
| 100 000 volaní | 40 € | 4,00 € | 12 mesiacov |
| 300 000 volaní | 90 € | 3,00 € | 12 mesiacov |
Tieto limity slúžia na ochranu stability celej infraštruktúry pred zahltením a DDoS útokmi. Platia rovnako pre BIZ, PRO aj MAX bez ohľadu na zakúpený objem.
1 200 požiadaviek za 60 sekúnd na Bearer token / IP adresu.
Kontrola sa vyhodnocuje za API kľúč aj za celú firmu súčasne.
Kĺzavé okno (rolling window, nie polnočný reset). Počíta spracované a dokončené požiadavky.
Zasielanie dokladov cez pripojený Gmail/Outlook účet firmy (+ limity poskytovateľa).
1 048 576 bajtov pre požiadavku na vytvorenie faktúry alebo konceptu.
26 214 400 bajtov pre jeden nahrávaný vstupný súbor na spracovanie.
Retry-After a retryAfterSeconds.Navrhnuté tak, aby vaše kľúče nemohli napáchať škody ani v prípade chyby v klientskej aplikácii.
API kľúč patrí výhradne jednej konkrétnej firme. Jeden kľúč nikdy neotvára prístup k cudzím firmám ani k celému zákazníckemu účtu. Pre každú integráciu (e-shop, CRM, účtovníctvo) môžete vytvoriť samostatný kľúč.
Každému kľúču pridelíte presne tie oprávnenia, ktoré potrebuje (napr. iba čítanie dokladov alebo iba tvorba konceptov). Ostré vystavenie a ePoštár vyžadujú explicitné oprávnenie.
Hodnota tajného kľúča sa v administrácii zobrazí iba jedenkrát pri vygenerovaní. Nikdy ju nevkladajte do verejných skriptov ani do prehliadača; patrí výhradne na váš zabezpečený server.
Pri zápisoch môžete poslať vlastný identifikačný kľúč. Ak pri výpadku siete odošlete rovnakú požiadavku znova, server vráti pôvodne vytvorený výsledok bez duplicitného zaúčtovania.
company.readČítanie údajov firmyIdentifikačné údaje, IČO, DIČ, IČ DPH a nastavené číselné rady.client.readČítanie partnerovZoznam odberateľov a dodávateľov, kontakty a adresy.client.writeZápis partnerovVytvorenie a aktualizácia cez stabilné externalId.invoice.readČítanie dokladovVyhľadávanie, detaily faktúr, položky, stavy a úhrady.invoice.draft.writeTvorba konceptovVytvorenie predpripraveného konceptu (draft) na kontrolu.invoice.writeVystavovanie faktúrOstré vystavenie podporovaného dokladu a pridelenie čísla.payment.readČítanie úhradZoznam prijatých a priradených úhrad k faktúram.payment.writeZápis úhradZaevidovanie úhrady k existujúcej faktúre v systéme.email.sendOdosielanie e-mailomOdoslanie vystaveného dokladu cez pripojený Gmail alebo Outlook.epostar.readePoštár schránkaČítanie prijatých e-faktúr, priebeh operácií a správy MLS.epostar.sendePoštár odosielaniePožiadavka na produkčné odoslanie dokladu do siete Peppol.epostar.archiveePoštár archívVyžiadanie firemného exportu archívu e-faktúr a sťahovanie.Žiadne zložité nastavovanie Postmana naslepo. Priamo v rozhraní eFakturaPRO máte k dispozícii plnohodnotnú testovaciu konzolu so 69 operáciami, samostatnou kvótou 10 000 volaní a živým generátorom požiadaviek.

Každé pole formulára okamžite aktualizuje technickú požiadavku, ktorú si môžete na jedno kliknutie skopírovať do vášho kódu.
Žiadne ostré doklady, žiadne bankové pohyby ani ePoštár správy. Testujete v bezpečnom prostredí bez rizika omylu.
Kedykoľvek môžete jedným kliknutím vyčistiť vytvorené testovacie dáta a začať s čistým štítom odznova.
Rozhranie komunikuje cez štandardné metódy HTTP (GET, POST), formát JSON a autentifikačnú hlavičku Bearer.
curl --fail --silent --show-error \
"https://api.efakturapro.sk/api/v1/integrations/company" \
-H "Authorization: Bearer $EFAKTURAPRO_API_KEY"{
"success": true,
"data": {
"company": {
"id": "cmp_98f41e0a",
"businessName": "Vzorová Slovenská Firma s. r. o.",
"ico": "54321098",
"dic": "2120987654",
"icDph": "SK2120987654",
"isVatPayer": true,
"currency": "EUR"
},
"numberSequences": [
{
"id": "seq_inv_2026",
"type": "INVOICE",
"prefix": "2026",
"mask": "{YYYY}{NNNN}",
"nextNumber": 142
}
]
}
}V prihlásenej firme s balíkom BIZ, PRO alebo MAX prejdite do sekcie Nastavenia ➔ Prepojenia.
Zaškrtnite iba tie scopes, ktoré vaša integrácia skutočne potrebuje, a vytvorte API kľúč.
Skopírujte vygenerovaný kľúč a uložte ho do premenných prostredia vášho servera.
Zavolajte GET /capabilities a GET /company a overte návratový kód 200 OK.
Najprv vytvorte testovací koncept cez POST /invoice-drafts a ostré vystavenie zapnite až s platnými dátami.
Aby sme predišli nedorozumeniam, uvádzame, čo toto API zámerne nepodporuje:
Verejné produkčné REST API je súčasťou predplatných BIZ (10 € / mes. – 3 000 volaní mesačne), PRO (15 € / mes. – 10 000 volaní mesačne) a MAX (20 € / mes. – 20 000 volaní mesačne). V programoch FREE a PLUS verejné API nie je sprístupnené. Predplatné XXL pre účtovné kancelárie taktiež verejné integračné API neobsahuje, keďže je optimalizované pre vedenie agendy klientov. K programu BIZ, PRO ani MAX sa neplatí žiadny povinný príplatok za licenciu API – základný limit je v cene predplatného.
Základné limity sú: BIZ 3 000 volaní/mesiac, PRO 10 000 volaní/mesiac, MAX 20 000 volaní/mesiac. Limit platí spoločne pre všetky API kľúče firmy. Obnova limitu prebieha podľa mesačného fakturačného obdobia (nie kalendárneho mesiaca). Aj pri ročnej platbe predplatného prebieha obnova mesačne. Nevyužité zahrnuté volania sa do ďalšieho mesiaca neprenášajú.
Započítavajú sa iba úspešné požiadavky; každá stránka zoznamu samostatne. Chybové odpovede (4xx, 5xx) a rozpoznané duplicitné požiadavky (idempotencia) limit nemíňajú. Interné používanie webovej a mobilnej aplikácie limit taktiež nemíňa.
Čerpanie, zostatok a termín obnovy zobrazujeme v sekcii Kredity aj v nastaveniach API. Po vyčerpaní volaní API vracia HTTP 429 s kódom API_MONTHLY_QUOTA_EXCEEDED.
Zákaznícky sandbox má samostatný oddelený limit 10 000 volaní, ktorý je úplne nezávislý od vašej produkčnej kvóty. Testovacie volania v sandboxe vám nemíňajú produkčné volania.
Naše API má veľmi štedré základné rozsahy (až 20 000 volaní mesačne). Ak potrebujete viac, dokupovanie je k dispozícii už od 3 € bez DPH za 10 000 volaní. Máte dve rovnocenné možnosti:
1. Premena zakúpených AI kreditov: 1 zakúpený kredit = 500 API volaní (20 kreditov = 10 000 volaní). Podľa zakúpeného balíka vás 10 000 volaní vyjde na 3,00 € až 7,96 € bez DPH. Prevod používateľ ručne potvrdí v rozhraní; automatické míňanie AI kreditov na API nie je zapnuté. Zahrnuté mesačné AI kredity sa neprevádzajú.
2. Samostatný API balík s platnosťou 12 mesiacov: Priamy nákup balíka API volaní (10 000 volaní za 8 €, 50 000 za 30 €, 100 000 za 40 €, 300 000 za 90 € bez DPH) s platnosťou celých 12 mesiacov od úhrady.
Tieto pojmy striktne oddeľujeme. API volania (HTTP požiadavky na REST endpointy) slúžia na komunikáciu vášho systému s eFakturaPRO (hľadanie dokladov, čítanie skladov, tvorba konceptov). ePoštár kredity predstavujú počet odoslaných elektronických faktúr do štátnej a európskej siete Peppol. Každý program má zahrnutú kvótu ePoštára (BIZ 30, PRO 50, MAX 100 e-faktúr/mesiac). Príjem e-faktúr je vo všetkých platených programoch 0 € neobmedzene.
Okrem mesačných kvót chráni stabilitu servera rýchlostný limiter: 1 200 požiadaviek za 60 sekúnd (spoločná HTTP ochrana). Pre fakturačný tok platí 60 požiadaviek za posledných 60 minút a 300 za posledných 24 hodín (kĺzavé okno za kľúč aj za celú firmu súčasne). Odosielanie pripojeným e-mailom je obmedzené na 300 za 24 hodín na firmu. Maximálna veľkosť JSON dokladu je 1 MiB a nahrávaného vstupného súboru 25 MiB.
eFakturaPRO poskytuje univerzálne REST HTTP API a odchádzajúce webhooky s HMAC podpisom. V platformách Make, Zapier, n8n alebo Activepieces sa pripojíte pomocou štandardných HTTP modulov („HTTP / Webhook trigger“). Nesľubujeme hotové proprietárne konektory v katalógoch týchto platforiem ani certifikované aplikácie tretích strán.
Nie. API zámerne neposkytuje voľné zápisy na ľubovoľné účty ani nekontrolované manuálne skladové pohyby. Čítať môžete skladové karty a zostatky, čítať peňažný denník a účtovné udalosti (podľa balíka PRO/MAX) a sťahovať bankové výpisy či návrhy párovania. API taktiež neodosiela reálne peniaze z bankového účtu.
Pri podporovaných zápisoch (vytvorenie konceptu, faktúry, úhrady) môžete poslať hlavičku Idempotency-Key. Ak požiadavka z dôvodu sieťového výpadku zlyhá a odošlete ju znova s rovnakým kľúčom a rovnakým telom, server vráti pôvodný výsledok bez duplicitného vytvorenia dokladu. Zmena payloadu pri rovnakom kľúči vedie ku konfliktu.
Otvorte si oficiálnu špecifikáciu OpenAPI kontraktu 1.23.0 alebo si vytvorte svoj prvý API kľúč v administrácii.