Integrate via API and Peppol

Issue invoices, send them over Peppol and manage customers straight from your application. Test everything in the sandbox first, then flip to live.

Documentation API reference

Sandbox

The sandbox is the same API as production. Only the key prefix decides. No separate domain, no tax-authority setup.

efk_pk_test_… (sandbox)

Mock delivery, no credits, no metering, nothing actually sent to Peppol. The invoice ends up delivered. Ideal for development.

efk_pk_live_… (production)

Real sending through the Peppol Access Point, credit charging and metering.

Base URL (sandbox and live)

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

Authentication

X-API-Key header + X-Organization-Id (the organization UUID from GET /v1/agent/organizations).

Example: 2 steps

1. Issue an invoice

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. Send it over 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 delivery, no credits, no tax authority, invoice ends "delivered"

How to get an API key

After signing in to the portal you can create sandbox (test) keys immediately in the API keys section; production (live) keys are issued by your eFaktúra partner manager after approval. The portal also offers self-service webhooks (HMAC-SHA256 signed, with replay protection and key rotation), plus an overview of calls and documents.