Nižšie je prehľad. Úplnú referenciu vrátane schém, príkladov a tlačidla Try it nájdete v interaktívnej dokumentácii.
štandard
SAPI-SK
Osem endpointov štandardizovaného rozhrania, interaktívne.
platformaEnterprise API
Faktúry, webhooky, notifikácie, kredit a správa organizácie.
SAPI-SK štandard
| Metóda | Endpoint | Popis |
|---|---|---|
| POST | /sapi/auth/token | Vydá prístupový token |
| POST | /sapi/auth/renew | Obnoví token cez refresh_token |
| POST | /sapi/auth/revoke | Zneplatní token |
| GET | /sapi/auth/token/status | Zistí platnosť a či je čas na obnovu |
| POST | /sapi/document/send | Odošle dokument do siete Peppol |
| GET | /sapi/document/receive | Zoznam prijatých dokumentov |
| GET | /sapi/document/receive/{id} | Vráti prijatý dokument ako JSON (XML v poli payload) |
| POST | /sapi/document/receive/{id}/acknowledge | Potvrdí prevzatie dokumentu |
| GET | /sapi/health | Stav služby bez autentifikácie — rovnaké telo ako /health (200 / 503) |
Enterprise API
| Metóda | Endpoint | Popis |
|---|---|---|
| POST | /api/v1/invoices | Vytvorí a odošle faktúru |
| GET | /api/v1/invoices | Zoznam faktúr, stránkovaný kurzorom |
| GET | /api/v1/invoices/{id} | Detail faktúry vrátane stavu |
| GET | /api/v1/invoices/{id}/xml | Pôvodné UBL XML |
| GET | /api/v1/invoices/{id}/pdf | PDF vizualizácia faktúry |
| GET | /api/v1/invoices/search | Fulltextové vyhľadávanie faktúr, stránkované kurzorom; s scope=archive namiesto aktuálnych v archivovaných faktúrach |
| DELETE | /api/v1/invoices/{id} | Zruší faktúru, kým je PENDING alebo VALIDATING |
| POST | /api/v1/documents/validate | Predbežná validácia dokumentu — bez odoslania, bez kreditu |
| GET | /api/v1/participants/{peppolId}/reachability | Overí, či je príjemca v sieti a podporuje daný typ dokumentu |
| POST | /api/v1/webhooks | Zaregistruje webhook |
| POST | /api/v1/webhooks/{id}/test | Pošle testovaciu udalosť |
| GET | /api/v1/billing/balance | Zostatok kreditu |
| POST | /api/v1/sapi-clients | Vytvorí SAPI klienta |
documents/validate a participants/{peppolId}/reachability slúžia na kontrolu pred
odoslaním: overia dokument aj dosiahnuteľnosť príjemcu, nevytvárajú faktúru a
nespotrebúvajú kredit. Tvar odpovede, význam poľa reason a limity rozoberá článok
Predbežná validácia.