Dokumentácia

Integrujte eFaktúra Agent API: vystavujte a odosielajte faktúry cez Peppol, spravujte zákazníkov a doklady priamo z vašej aplikácie. Začnite v sandboxe, potom prepnite naostro.

Kde získate API kľúč?

Záleží, kto ste. Firma s vlastným systémom (e-shop, ERP), ktorá fakturuje za seba: kľúč máte priamo v aplikácii: fa.efaktura.sk → Nastavenia → API kľúče, bez schvaľovania. Softvérový vendor alebo white-label partner, ktorý integruje pre viacero firiem: partnerský developer portál na pozvánku. Podrobný rozcestník (vrátane SAPI-SK): Prístup a účty. Dokumentácia nižšie platí pre obe cesty rovnako.

Rýchly štart

1. Vytvorte si sandbox (test) kľúč: v aplikácii (efk_test_…) alebo v partnerskom portáli (efk_pk_test_…). 2. Zavolajte API s hlavičkami X-API-Key a X-Organization-Id. 3. Otestujte odoslanie faktúry cez Peppol v sandboxe (reálna Peppol TEST sieť, žiadne kredity). 4. Keď je všetko hotové, požiadajte o produkčný kľúč.

Prístup a účty

Firma vs. partner vs. SAPI-SK: kto potrebuje čo a kde to získa.

Rýchly štart

End-to-end tutoriál s curl: org → enroll → faktúra → Peppol → stav → webhook.

Autentifikácia

API kľúče, hlavičky, test vs. produkcia.

API kľúče a scopes

Katalóg scopes, predvolená množina a najčastejšie 403 pasce.

Faktúry

POST /v1/agent/invoices: payload, sadzby DPH, Peppol kompletnosť.

Prijímanie a stavy

Stav odoslaní, príchodzie doklady a vzťah k webhookom.