eFaktúra Developers

Integrácia cez API a Peppol

Vystavujte faktúry, odosielajte ich cez Peppol a spravujte zákazníkov priamo z vašej aplikácie. Najprv otestujte všetko v sandboxe, potom prepnite na ostro.

API referencia Sandbox quickstart Partnerský portál

Sandbox

Sandbox je ten istý API ako produkcia — rozhoduje len prefix kľúča. Žiadna iná doména, žiadne nastavenie Finančnej správy.

efk_pk_test_… (sandbox)

Mock doručenie, žiadne kredity, žiadny metering, žiadne reálne odoslanie na Peppol. Faktúra skončí v stave delivered. Ideálne na vývoj.

efk_pk_live_… (produkcia)

Reálne odoslanie cez Peppol Access Point, účtovanie kreditov a metering.

Base URL (sandbox aj live)

https://api.efaktura.sk/v1/agent

Autentifikácia

Hlavička X-API-Key + X-Organization-Id (UUID organizácie z GET /v1/agent/organizations).

Príklad — 2 kroky

1. Vystav faktúru

curl -X POST https://api.efaktura.sk/v1/agent/invoices \
  -H "X-API-Key: efk_pk_test_..." \
  -H "X-Organization-Id: <org-uuid>" \
  -H "Content-Type: application/json" \
  -d '{ "customer": { "name": "Test s.r.o." }, "items": [ ... ] }'

2. Odošli ju cez Peppol (sandbox)

curl -X POST https://api.efaktura.sk/v1/agent/peppol/send/<invoiceId> \
  -H "X-API-Key: efk_pk_test_..." \
  -H "X-Organization-Id: <org-uuid>"
# → 202 { "data": { "status": "queued", ... } }
# sandbox: mock doručenie, žiadne kredity, žiadne FS, faktúra "delivered"

Ako získať API kľúč

API kľúče (test aj live) vám vystaví váš eFaktúra partner manažér. Self-service správa kľúčov, prehľad volaní a webhookov pribudne do tohto portálu čoskoro.