Guides

• Authentication — API keys vs OAuth2 vs JWT login — when to use which.
• Errors — Error envelope, common error codes, troubleshooting.
• Getting started — Onboard in five steps — key, create, validate, send, track. The full Slovak Peppol 5-corner flow, end to end.
• Idempotency — When and how to use Idempotency-Key.
• Pagination — page_size limits, response envelope, iteration recipes for invoices and customers.
• Partner API — Acting for your client companies with a partner API key - create, validate and send, track Peppol delivery and FS reporting separately, and download the documents as they were sent or received.
• Rate limits — Token bucket per identity, plan-tier budgets, 429 + Retry-After handling.
• Receiving invoices — Inbound Peppol path through Oxalis, validation, storage, and how integrators consume the document.
• End-to-end delivery in sandbox — How sandbox delivery really works, and how to test a full send → receive flow between two sandbox companies.
• Testing & sandbox — How to test your integration safely against the eFakturuj sandbox endpoint.
• SAPI-SK connector — Send your own ready-made UBL through eFakturuj's Access Point — token, send, status, receive, acknowledge.
• Sending invoices — Full lifecycle from customer lookup → draft → validate → send → track.
• Cookbook: send & receive with webhooks — A start-to-finish recipe — create a key, register webhooks, then create → validate → send an invoice over Peppol and watch the webhooks fire on both sides.
• Versioning — /api/v1 path-versioning, deprecation policy, breaking-change definition.
• Webhooks — Subscribing endpoints, signature verification, retry policy.