E-faktúra priamo z vášho systému
Ak už máte vlastný systém, nepotrebujete ďalšiu aplikáciu — potrebujete rozhranie. Verejne dokumentované REST API, štandardizované SAPI-SK aj oddelený sandbox, v ktorom si integráciu otestujete bez toho, aby čokoľvek odišlo do siete.
Štyri spôsoby napojenia
SAPI-SK
Štandardizované slovenské rozhranie podľa špecifikácie SAPI-SK v1.0.0. Rovnaký tvar u každého poskytovateľa, autentifikácia cez OAuth2 alebo API kľúč.
Fakturix API
Vlastné REST API s OpenAPI dokumentáciou — doklady, kontakty, sklad, banka, exporty aj daňové výkazy.
Partnerské rozhranie
Jeden kľúč, neobmedzený počet klientskych firiem. Pre účtovné softvéry, ERP a sprostredkovateľov pod vlastnou značkou.
Konektor pre Windows
Ak sa do systému nedá zasahovať, doklady vyzdvihne zo zdieľaného priečinka a odošle ich cez API.
Odoslanie dokladu je jedno volanie
Doklad pošlete v UBL 2.1, my ho zvalidujeme, doručíme protistrane a vrátime stav. Hlavička Idempotency-Key chráni pred duplicitou pri opakovaní.
- Odoslanie, príjem a stav doručenia vrátane MLS
- Validácia pred odoslaním podľa EN 16931
- Webhooky namiesto obťahovania dokola
- Sandbox oddelený kľúčom, rovnaká base URL
curl -X POST https://api.fakturix.sk/api/v1/sapi/document/send \
-H 'X-API-Key: sk_live_...' \
-H 'Idempotency-Key: FA-2027-0042' \
-H 'Content-Type: application/xml' \
--data-binary @faktura.xml
{
"documentId": "9f1c2e7a-...",
"status": "SENT",
"receiver": "0245:2020123456",
"transmissionId": "c8d1..."
}Čo v rozhraní nájdete
Dokumentácia je verejná a bez registrácie — pozrieť si ju môžete skôr, než sa rozhodnete.
- Odoslanie a príjem dokladov v UBL 2.1 podľa EN 16931 a PEPPOL BIS 3.0
- Validácia dokladu pred odoslaním vrátane slovenských pravidiel
- Stav doručenia a potvrdenia z prijímajúceho prístupového bodu
- Webhooky na udalosti — doručené, prijaté, zamietnuté, nová faktúra
- Idempotencia pri odosielaní a opakovanie pri výpadku protistrany
- Oddelený sandbox a produkcia, rozlíšené API kľúčom
Validáciu si viete vyskúšať aj bez integrácie — validátor e-faktúry používa to isté rozhranie a je verejný.
Dokumentácia: Fakturix API, SAPI-SK a partnerské API. Technické otázky píšte na support@fakturix.sk.
Pre e-shopy
Ak predávate firmám, faktúra musí od roku 2027 odísť elektronicky.
Máme pluginy pre WooCommerce, PrestaShop, Shopify a Shoptet — objednávka sa premení na doklad a odošle sa sama. Pri predaji spotrebiteľom sa nič nemení, tam zostáva PDF na e-mail.
Čo pri integrácii zdrží najviac
Veci, ktoré sme už vyriešili, aby ste ich nemuseli riešiť vy.
Duplicitné doklady
Hlavička Idempotency-Key zabezpečí, že opakované odoslanie tej istej požiadavky nevytvorí druhú faktúru — vráti pôvodnú. Nutné pri retry logike aj pri výpadku siete.
Testovanie bez následkov
Sandbox je oddelený od produkcie a rozlišuje sa kľúčom, base URL zostáva rovnaká. Simuluje sa aj potvrdenie o doručení, do siete PEPPOL nič neodíde.
Vlastné číslovanie
Ak si doklady číslujete sami, vaše číslo prevezmeme. Nechcete číslovať? Vygenerujeme ho z číselného radu aj s PDF.
Zistenie stavu bez pollingu
Webhooky na zmenu stavu dokladu — odoslané, doručené, odmietnuté. Nemusíte sa opakovane pýtať, ozveme sa sami.
Validácia pred odoslaním
Doklad skontrolujeme voči EN 16931, slovenskému profilu PEPPOL BIS 3.0 aj §74 zákona o DPH. Chybu dostanete vy, nie odberateľ.
Hlásenie Finančnej správe
Povinné hlásenie do systému IS EFA beží automaticky pri odoslaní. Neimplementujete ho, nestaráte sa oň.
Čo potrebujete vedieť pred začiatkom
Praktické odpovede na to, čo sa nás vývojári pýtajú ako prvé.
- Dokumentácia je verejná a na jej prezretie nepotrebujete registráciu
- Autentifikácia je bežný Bearer token, žiadne certifikáty ani podpisovanie
- Odosielať viete hotové UBL 2.1, alebo nám poslať JSON a XML zostavíme my
- Rozhranie SAPI-SK je štandardizované — implementujete raz, funguje aj inde
- Príjem dokladov je zadarmo bez ohľadu na objem
- Odosielanie sa účtuje podľa plánu, pri vyšších objemoch dohodou
Ak píšete integráciu pre viac klientskych firiem naraz — účtovný softvér, ERP alebo SaaS — pozrite sa radšej na partnerské rozhranie. Rieši jeden kľúč pre neobmedzený počet firiem namiesto samostatného účtu pre každú.
Časté otázky
Aký je rozdiel medzi vaším API a SAPI-SK?
SAPI-SK je štandardizované slovenské rozhranie, ktoré má rovnaký tvar u každého poskytovateľa — integrujete raz a viete prejsť inam. Naše vlastné API je bohatšie: okrem doručovania rieši aj vystavovanie dokladov, sklad, banku či exporty.
Dá sa integrácia otestovať bez ostrých faktúr?
Áno. Sandbox je oddelený od produkcie a rozlišuje sa API kľúčom — base URL je rovnaká. Odoslanie sa simuluje vrátane potvrdení o doručení, do siete PEPPOL nič neodíde.
Ako riešite duplicity pri opakovanom volaní?
Odoslanie prijíma hlavičku Idempotency-Key. Ak volanie zopakujete po timeoute s rovnakým kľúčom, dostanete pôvodnú odpoveď namiesto druhého odoslania.
Vieme registrovať klientov cez API?
PEPPOL účastníka nezakladá API — daňový subjekt si poskytovateľa vyberá sám na portáli Finančnej správy. Po jeho voľbe dostaneme podnet priamo my, alebo si ho prevezmete vy a prepošlete cez partnerské rozhranie.
Koľko to stojí?
API nie je viazané na plán. Pri bežnom používaní platia sadzby zvoleného plánu, pri väčších objemoch a integrátoroch máme cenu podľa počtu dokladov.
Máte hotové pluginy pre e-shopy?
Áno — WooCommerce, PrestaShop, Shopify a Shoptet. Objednávka sa premení na doklad a odošle sa sama.
Pripravte sa na rok 2027 už teraz
Príjem PEPPOL faktúr máte zadarmo v každom pláne. Účet si založíte na IČO za pár minút — bez karty a bez skúšobnej doby.