SAPI-SK: overview
SAPI-SK (Standardised Access Point Interface) is a Slovak open standard that defines a unified interface between Peppol Access Points ("digital mail carriers") and accounting or ERP software. You integrate once, and can send and receive e-invoices through any provider that supports the standard.
What SAPI-SK is
The standard is developed under the Slovak Financial Administration and the OpenPeppol community as a voluntary, provider-independent layer. eFaktúra implements version v1.0: every interaction (authentication, sending, receiving, acknowledgment) has its own normative request and response schema. You can find the official specification at www.sapi-sk.sk.
Why use SAPI-SK
Instead of a specific AP's proprietary API, you connect to one standardized contract. If you switch providers (or use more than one), you don't have to rewrite your integration. eFaktúra is your Access Point: it handles validation, transport over the Peppol network, and archiving.
Basic information
The base URL is https://api.efaktura.sk/sapi. All document calls are protected by an OAuth 2.0 access token (Bearer) and the X-Peppol-Participant-Id header, which specifies the organization (Peppol participant) you're acting on behalf of.
Endpoint overview
| Method | Path | Description |
|---|---|---|
| POST | /auth/token | Exchange client credentials for an access + refresh token. |
| GET | /auth/token/status | Access token status and expiry (refresh recommendation). |
| POST | /auth/renew | Renew tokens via a refresh token (with rotation). |
| POST | /auth/revoke | Invalidate a refresh token (idempotent). |
| POST | /document/send | Send a document (UBL XML) for delivery over Peppol. |
| GET | /document/receive | List received documents (cursor pagination). |
| GET | /document/receive/{id} | Detail and content of a specific received document. |
| POST | /document/receive/{id}/acknowledge | Acknowledge receipt of a document (idempotent). |
Credentials
Generate the client ID and client secret in the partner developer portal (developers.efaktura.sk → SAPI-SK, path /dashboard/sapi; access is invite-only, not inside the eFaktúra app). The secret is shown only once upon creation, so store it securely. See the next steps in the Authentication (OAuth2) section.
Credits
Sending via SAPI-SK is billed exactly like any other e-invoice send: first the plan's free monthly quota is drawn down, then credits (a free promo applies through 2026). Receiving documents is always free.