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.
• 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.
• Testing & sandbox — How to test your integration safely against the eFakturuj sandbox endpoint.
• 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.