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.
Rýchly štart
1. Prihláste sa do partnerského portálu a vytvorte si sandbox (test) kľúč (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ľúč.
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.
Validácia
Preflight EN 16931 + Peppol kontrola UBL XML pred odoslaním.
API referencia
Kompletná OpenAPI referencia (Scalar) so živým try-it módom.
Webhooky
Eventy, podpis, overenie a opakovania doručení.
Chybové kódy
Tvar chýb a referencia všetkých kódov.
Rate limity
Limity, hlavičky a správne riešenie 429.
Onboarding na produkciu
Firma na ostrý Peppol: FS webhook → potvrdenie e-mailom (claim).
Spustenie naostro
Checklist prechodu zo sandboxu do produkcie.
Changelog
Datovaný prehľad zmien API a portálu.