REST / JSON APIKONTRAKT v1.23.0DOSTUPNÉ OD BALÍKA BIZ

Verejné integračné API
eFakturaPRO

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

3 000 – 20 000Zahrnutých API volaní / mesiac (BIZ, PRO, MAX)
od 3 €Cena za 10 000 volaní pri dokúpení bez DPH
10 000Volaní v zákazníckom Sandboxe na testovanie
1 200 / minOchranný HTTP rate limit celej platformy
SCENÁRE POUŽITIA

Čo všetko môžete s integračným API vyriešiť

Navrhnuté pre vývojárov, systémových integrátorov aj firemné IT tímy. Žiadne uzavreté monolity.

💻

Vlastné aplikácie & interné CRM

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.

  • Prepojenie cez stabilné externalId
  • Overenie oprávnení cez GET /capabilities
  • Granulárne prístupové práva pre jednotlivé kľúče
🛒

E-shopy & objednávkové systémy

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

  • Ochrana pred duplicitami cez Idempotency-Key
  • Okamžité stiahnutie oficiálneho PDF pre zákazníka
  • Fakturačný tok až 60 dokladov/hodina a 300/24 hodín
📈

ERP & Dátové prehľady (BI)

Synchronizujte číselníky, stav skladu a finančné toky do externých analytických systémov, Power BI či Tableau bez manuálneho exportovania tabuliek.

  • Čítanie zoznamu vystavených faktúr a úhrad
  • Čítanie položiek katalógu a skladových zásob
  • Účtovné udalosti a peňažný denník (podľa balíka)
⚡

Automatizácie: Make, Zapier & n8n

Prepojte eFakturaPRO s no-code a low-code nástrojmi. Udalosti posielame na váš HTTPS webhook endpoint s bezpečným overením podpisu.

  • Pripojenie cez štandardné HTTP REST požiadavky
  • Udalosti invoice.created, payment.created
  • Automatické opakované doručenie pri výpadku servera
ℹ️ Poznámka: Pripájate sa cez štandardný HTTP modul; nesľubujeme uzavreté proprietárne konektory.
ROZSAH KONTRAKTU 1.23.0

13 funkčných oblastí verejného API a ich presné hranice

Hráme s otvorenými kartami. Tu je presný zoznam toho, čo rozhranie umožňuje a kde sú jeho bezpečnostné a systémové hranice.

🏛️

Firma a číslovanie

Čo umožňuje:

Čítať identifikačné údaje firmy (IČO, DIČ, IČ DPH, sídlo) a nastavené číselné rady.

Hranica & limit:

Čítanie číselného radu iba vracia nastavenia a masku; nepridelí vopred nové číslo.

👥

Obchodní partneri

Čo umožňuje:

Zoznam, detail, vyhľadávanie, vytvorenie alebo bezpečný upsert partnera cez stabilné externalId.

Hranica & limit:

Kľúč pracuje výhradne s partnermi firmy priradenej ku kľúču; nevidí cudzie subjekty.

📄

Faktúry a koncepty

Čo umožňuje:

Zoznam dokladov, filtrovanie, detail, položky, vytvorenie konceptu (draft) a vystavenie faktúry.

Hranica & limit:

Vytvorenie konceptu nevystaví doklad. Vystavenie vyžaduje samostatné scope invoice.write a platné údaje.

📎

PDF a prílohy

Čo umožňuje:

Vyžiadať generovanie PDF, sledovať priebeh asynchrónnej úlohy, stiahnuť hotové PDF a sprístupnené prílohy.

Hranica & limit:

Generovanie prebieha aj asynchrónne; sprístupňuje iba existujúce podporované artefakty.

💳

Úhrady

Čo umožňuje:

Čítať históriu úhrad a zaevidovať úhradu k existujúcej vystavenej faktúre.

Hranica & limit:

Evidencia úhrady v systéme nie je bankový prevod a neodosiela žiadne reálne peniaze.

📦

Katalóg a sklad

Čo umožňuje:

Čítať položky cenníka, služby, skladové karty a aktuálne dostupné skladové množstvá.

Hranica & limit:

Iba čítanie; API neposkytuje endpointy pre všeobecné skladové zápisy, príjemky a výdajky.

📥

Náklady (došlé faktúry)

Čo umožňuje:

Čítať hlavičky nákladov, sumy, dodávateľa, podporované prílohy a pôvodné zdrojové artefakty vrátane dostupného XML.

Hranica & limit:

Neumožňuje ľubovoľnú editáciu nákladov ani prístup k interným systémovým súborom mimo schválených artefaktov.

📤

Vstupné doklady

Čo umožňuje:

Odovzdať jeden súbor (PDF/JPG/PNG do 25 MiB) alebo štruktúrovaný JSON do frontu na spracovanie.

Hranica & limit:

Prijatie súboru serverom neznamená automaticky dokončené vyťaženie ani zaúčtovanie.

🏦

Banka a pohyby

Čo umožňuje:

Čítať uložené bankové účty, importované výpisy a pohyby; získať návrh priradenia k faktúre, proforme či nákladu.

Hranica & limit:

Náhľad návrhu nemení párovanie ani účtovníctvo; API nevykonáva platby ani neodosiela prevody.

🔁

Opakované faktúry

Čo umožňuje:

Čítať zoznam nastavených pravidiel pravidelnej fakturácie a ich detail.

Hranica & limit:

Iba čítanie pravidiel; bez možnosti tvorby, úpravy alebo manuálneho spúšťania pravidiel cez API.

📊

Účtovníctvo

Čo umožňuje:

Čí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.

Hranica & limit:

Dostupné podľa programu (PRO/MAX); neslúži na všeobecný účtovný zápis mimo generovaných dokladov.

✉️

E-mailové odosielanie

Čo umožňuje:

Vytvoriť faktúru a automaticky ju odoslať zákazníkovi cez pripojený účet Gmail alebo Microsoft Outlook.

Hranica & limit:

Vyžaduje pripojený poštový účet vo firme a scope email.send; uplatňujú sa aj limity poskytovateľa e-mailu.

⚡

Webhooky (asynchrónne notifikácie)

Čo umožňuje:

Automatické doručovanie udalostí o partneroch, dokladoch, úhradách a ePoštárovi na váš HTTPS endpoint.

Hranica & limit:

Podpisované HMAC kľúčom; príjemca musí overovať podpis a počítať s možnou duplicitou pri sieťovom retry.

PEPPOL & EN 16931

ePoštár v rámci spoločného API

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

1
Validácia & Preview konceptu pred odoslaním

Pred produkčným odoslaním overíte štruktúru dokladu cez náhľad bez rizika odoslania chybnej faktúry.

2
Sledovanie operácie, stavov MLS a artefaktov

Transparentné stavy doručenia. Zrušenie odoslania je možné výhradne v stave, ktorý povoľuje kontrakt.

3
Prijaté e-faktúry, archivácia a explicitný ACK

Lokálny inbox, vyžiadanie importu do nákladov a trvalé potvrdenie prevzatia po splnení podmienok.

4
Export archívu a webhook epostar.document.updated

Vyžiadanie firemného ZIP archívu a okamžitá notifikácia pri akejkoľvek zmene stavu doručenia.

⚠️ Zásadné integračné pravidlá ePoštára

  • HTTP 202 neznamená doručenie: Kód 202 Accepted potvrdzuje len prijatie požiadavky serverom na spracovanie.
  • TDD stav je samostatný: Hlásenie daňových dát Finančnej správe SR (TDD) je oddelené od doručenia partnerovi.
  • TDD je do 31. 12. 2026 neaktívne: Povinné štátne oznamovanie sa v súlade s legislatívou automaticky aktivuje od 1. 1. 2027 v časovom pásme Europe/Bratislava.
  • Jeden kľúč neotvára cudzie firmy: Každý API kľúč je striktne zviazaný s jednou oprávnenou firmou s dokončenou aktiváciou.
  • API volania nie sú ePoštár kredity: Mesačná kvóta API volaní sa míňa na HTTP dopyty; odosielanie eFaktúr čerpá samostatný fond ePoštára.
MESAČNÉ KVÓTY & PODMIENKY

Mesačné API limity podľa predplatného

Veľmi štedré základné rozsahy zahrnuté priamo v cene programov BIZ, PRO a MAX. Žiadne viazané zmluvy ani skryté aktivačné poplatky.

ProgramCena predplatnéhoMesačný limit API volaníÚčtovná nadstavba cez APIZahrnuté odoslania ePoštárom
FREE0 €❌ Nie (iba web & app)❌ Nie0 (iba bežná B2C fakturácia)
PLUSod 4,90 € / mes.❌ Nie (iba web & app)❌ Nie10 / mes. (cez web/app)
XXLpre účtovné kancelárieod 30 € / mes.❌ Nie (mantinel: bez verejného API)Plné podvojné aj jednoduchéZdieľaný fond kancelárie
BIZ10 € / mes.3 000 volaní / mes.Bez účtovnej nadstavby30 e-faktúr / mes. (360 / rok)
PRO15 € / mes.10 000 volaní / mes.Jednoduché účtovníctvo & SK peňažný denník50 e-faktúr / mes. (600 / rok)
MAX20 € / mes.20 000 volaní / mes.Podvojné účtovníctvo, denník & analytika100 e-faktúr / mes. (1 200 / rok)

📋 Pravidlá čerpania a obnovy mesačných limitov

🔄
Mesačná obnova podľa fakturácie

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

👥
Spoločný limit pre celú firmu

Limit platí spoločne pre všetky vygenerované API kľúče danej firmy. Vytvorenie ďalšieho kľúča nezvyšuje celkový objem volaní.

🛡️
Čo limit míňa a čo je zadarmo

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: 10 000 volaní

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.

Po vyčerpaní zahrnutých a dokúpených spoplatňovaných volaní API vracia HTTP 429 Too Many Requests s aplikačným chybovým kódom API_MONTHLY_QUOTA_EXCEEDED. Čerpanie, zostatok a presný termín obnovy vidíte v reálnom čase v sekcii Kredity aj v nastaveniach Prepojení.
FLEXIBILNÉ DOKUPOVANIE

Potrebujete viac volaní? Dokupovanie už od 3 € / 10 000 volaní

Žiadne drahé upgrady na enterprise plány. Ponúkame dve transparentné možnosti rozšírenia bez viazanosti (ceny bez DPH).

MOŽNOSŤ A: FLEXIBILNÁ PREMENA

Premena zakúpených AI kreditov na API volania

Máte zakúpený kreditný balíček? Jednoducho si prevediete časť kreditov na API volania v pomere:

1 zakúpený kredit = 500 API volaní20 kreditov = 10 000 API volaní
Pôvodný balík kreditovCena balíka bez DPHEfektívna cena za 10 000 volaní
50 kreditov19,90 €7,96 €
100 kreditov29,90 €5,98 €
300 kreditov59,90 €3,99 €
1 000 kreditov149,90 €3,00 €
  • Prevod používateľ ručne potvrdí: 20 kreditov sa odpočíta, 10 000 volaní pribudne.
  • Automatické míňanie AI kreditov na API nebude zapnuté (výhradne na váš podnet).
  • Mesačné zahrnuté AI kredity z paušálu sa do prevodu nezahŕňajú (iba zakúpené kredity z balíčkov).
  • Prevedené volania zachovávajú pôvodnú expiráciu kreditov (nepredlžuje sa).
MOŽNOSŤ B: SAMOSTATNÉ API BALÍKY

Priamy nákup balíkov API volaní (Platnosť 12 mesiacov)

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íkCena bez DPHCena 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
  • Samostatný API balík nevyžaduje nákup veľkého AI kreditného balíka.
  • Platnosť je celých 12 mesiacov od pripísania po zaplatení.
  • Pomerná cena zodpovedá veľkým kreditným balíkom už od 3 € bez DPH / 10 000 volaní.
RATE LIMITING & OCHRANA

⚙️ Spoločné technické limity produkcie (pre BIZ, PRO, MAX)

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 / minVšeobecná ochrana HTTP API

1 200 požiadaviek za 60 sekúnd na Bearer token / IP adresu.

60 / hodinaFakturačný tok za 60 minút

Kontrola sa vyhodnocuje za API kľúč aj za celú firmu súčasne.

300 / 24 hodínFakturačný tok za 24 hodín

Kĺzavé okno (rolling window, nie polnočný reset). Počíta spracované a dokončené požiadavky.

300 / 24 hOdosielanie cez e-mail

Zasielanie dokladov cez pripojený Gmail/Outlook účet firmy (+ limity poskytovateľa).

1 MiBMax. veľkosť JSON dokladu

1 048 576 bajtov pre požiadavku na vytvorenie faktúry alebo konceptu.

25 MiBMax. upload jedného súboru

26 214 400 bajtov pre jeden nahrávaný vstupný súbor na spracovanie.

Pri prekročení rýchlostného limitu vracia server HTTP 429 Too Many Requests s hlavičkami Retry-After a retryAfterSeconds.
SECURITY FIRST

Bezpečnosť a spoľahlivosť integrácie

Navrhnuté tak, aby vaše kľúče nemohli napáchať škody ani v prípade chyby v klientskej aplikácii.

IZOLÁCIA FIRIEM

1 Kľúč = 1 Firma

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ľúč.

GRANULÁRNE SCOPES

Prístupové práva po operáciách

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.

JEDNORAZOVÉ ZOBRAZENIE

Ochrana tajomstva (Secret)

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.

IDEMPOTENCIA

Ochrana hlavičkou Idempotency-Key

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.

Dostupné prístupové rozsahy (Scopes)

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.
INTERAKTÍVNY VÝVOJÁRSKY NÁSTROJ

Vyskúšajte API priamo v aplikácii: Izolovaný Sandbox

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

🔒 app.efakturapro.sk/IntegrationAutomationSettings?sandboxOnly=true
Izolovaný Sandbox · 10 000 volaní
Kompletné rozhranie sandboxu (3 panely)
Kompletné rozhranie sandboxu (3 panely): Prehľadné trojstĺpcové prostredie: vľavo katalóg operácií a formulár, v strede živý kód požiadavky/odpovede s ID kľúčom, vpravo interaktívny asistent.
⚡

Okamžitý cURL a JSON

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.

🛡️

100 % bezpečná izolácia

Žiadne ostré doklady, žiadne bankové pohyby ani ePoštár správy. Testujete v bezpečnom prostredí bez rizika omylu.

🔄

Tlačidlo „Obnoviť sandbox“

Kedykoľvek môžete jedným kliknutím vyčistiť vytvorené testovacie dáta a začať s čistým štítom odznova.

KÓD & UKÁŽKY

Jednoduché volanie s jasnými odpoveďami

Rozhranie komunikuje cez štandardné metódy HTTP (GET, POST), formát JSON a autentifikačnú hlavičku Bearer.

GET /company — Overenie firmy a číselných radov
Požiadavka (cURL)
curl --fail --silent --show-error \
  "https://api.efakturapro.sk/api/v1/integrations/company" \
  -H "Authorization: Bearer $EFAKTURAPRO_API_KEY"
Odpoveď (JSON)
{
  "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
      }
    ]
  }
}

Ako začať v 5 krokoch

1

Otvorte Prepojenia

V prihlásenej firme s balíkom BIZ, PRO alebo MAX prejdite do sekcie Nastavenia ➔ Prepojenia.

2

Vyberte oprávnenia

Zaškrtnite iba tie scopes, ktoré vaša integrácia skutočne potrebuje, a vytvorte API kľúč.

3

Uložte tajomstvo

Skopírujte vygenerovaný kľúč a uložte ho do premenných prostredia vášho servera.

4

Overte spojenie

Zavolajte GET /capabilities a GET /company a overte návratový kód 200 OK.

5

Otestujte scenár

Najprv vytvorte testovací koncept cez POST /invoice-drafts a ostré vystavenie zapnite až s platnými dátami.

🛡️

Transparentné systémové hranice

Aby sme predišli nedorozumeniam, uvádzame, čo toto API zámerne nepodporuje:

  • Nie všeobecné CRUD pre celú appku: API neslúži na ovládanie každej interné obrazovky; sprístupňuje vybrané integračné operácie.
  • Predplatné XXL nemá verejné API: Multilicencia XXL pre účtovné kancelárie slúži na správu účtovníctva firiem a neposkytuje verejné integračné API.
  • Bez všeobecných skladových zápisov: Cez API môžete čítať skladové karty a množstvá, nie robiť manuálne skladové príjemky/výdajky.
  • Bez všeobecného účtovného zápisu: Peňažný denník a účtovné udalosti sú na čítanie; zápis prebieha výhradne cez podporované doklady.
  • Bez bankových prevodov: Náhľad návrhu párovania nemení účtovníctvo a neposiela žiadne skutočné peniaze.
  • Bez editácie pravidiel opakovaných faktúr: Zoznam a detaily pravidiel sa iba čítajú; úprava prebieha vo webovom rozhraní.
  • Bez proprietárnych pluginov: Pre Make/Zapier/n8n poskytujeme štandardné REST endpointy a webhooky, nie uzavreté certifikované appky.
  • API volania nie sú ePoštár kredity: Volania neslúžia na odosielanie do Peppolu ani neovplyvňujú kapacitu archívu dokladov.
ČASTO KLADENÉ OTÁZKY

Všetko, čo potrebujete vedieť pred integráciou

V ktorých balíkoch je verejné integračné API dostupné a koľko stojí?▼

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.

Ako presne sa počítajú mesačné API limity a kedy sa obnovujú?▼

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.

Aký limit má zákaznícky sandbox na testovanie?▼

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.

Čo sa stane po vyčerpaní mesačného limitu a ako si dokúpim ďalšie 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.

Aký je rozdiel medzi API volaniami a ePoštár kreditmi?▼

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.

Aké sú technické ochranné limity rýchlosti (rate limiting)?▼

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.

Máte hotové natívne pluginy pre Make, Zapier alebo n8n?▼

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.

Umožňuje API všeobecné zápisy do skladu, peňažného denníka a banky?▼

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.

Ako funguje ochrana pred duplicitami (Idempotency-Key)?▼

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.

Pripravení na integráciu s eFakturaPRO?

Otvorte si oficiálnu špecifikáciu OpenAPI kontraktu 1.23.0 alebo si vytvorte svoj prvý API kľúč v administrácii.