SAPI referencia
SAPI odosielanie
Odošlete hotový Peppol UBL 2.1 dokument cez SAPI a overíte jeho stav.
Predpoklady
- Platný token zo /sapi/v1/auth/token a oprávnenie konať za odosielajúcu firmu.
- Dokument s kompletnými fakturačnými údajmi a Peppol BIS Billing profilom.
- Na sledovanie outbound stavu potrebujete Enterprise API so scope documents:read; pri centrálnom sk_int_* kľúči aj X-Firm-Id odosielajúcej firmy.
Postup odoslania
Získajte token
POST /sapi/v1/auth/token. Priamy firemný prístup alebo kľúč so scopedFirmId je obmedzený na jednu firmu. Centrálny partnerský token môže obsluhovať oprávnené firmy výberom X-Peppol-Participant-Id.
Odošlite dokument
POST /sapi/v1/document/send s UBL 2.1 dokumentom. Príjemca musí byť dostupný participant v Peppol sieti.
Overte stav a dôkaz
SAPI nemá outbound status endpoint. providerDocumentId zo send odpovede overte cez Enterprise GET /api/v1/documents/{id}/status alebo /events so scope documents:read; úspešná HTTP odpoveď nie je potvrdenie doručenia.
curl -X POST "https://epostak.sk/sapi/v1/document/send" \
-H "Authorization: Bearer <SAPI_TOKEN>" \
-H "Idempotency-Key: <UUID>" \
-H "X-Peppol-Participant-Id: 0245:<SENDER_DIC>" \
-H "Content-Type: application/json" \
-d '{
"metadata": {
"documentId": "INV-2026-001",
"documentTypeId": "<PEPPOL_DOCUMENT_TYPE_ID>",
"processId": "<PEPPOL_PROCESS_ID>",
"senderParticipantId": "0245:<SENDER_DIC>",
"receiverParticipantId": "0245:<RECEIVER_DIC>",
"creationDateTime": "2026-09-20T10:00:00Z"
},
"payload": "<Invoice xmlns=\"urn:oasis:names:specification:ubl:schema:xsd:Invoice-2\">...</Invoice>",
"payloadFormat": "XML"
}'Čo si pri odoslaní strážiť
- X-Peppol-Participant-Id nerozširuje oprávnenia tokenu. Centrálne partnerské prístupy vyžadujú platnú väzbu a súhlas pre vybranú firmu; firemne obmedzený kľúč nemožno použiť pre inú firmu.
- Príjemca musí byť platný Peppol participant; neznámy participant nie je odložená doručiteľnosť.
- Úspešná odpoveď znamená prijatie na spracovanie, nie doručenie príjemcovi.
Očakávaný výsledok
Dokument je prijatý na odoslanie. Ak máte Enterprise documents:read, providerDocumentId môžete sledovať cez status alebo events endpoint až po výsledok doručenia.
Keď to nefunguje
- 401 alebo expirovaný token: obnovte token cez /sapi/v1/auth/renew.
- Dokument neprejde: chýbajúce alebo neplatné fakturačné údaje, prípadne nesprávny profil dokumentu.
- Príjemca nedostupný: overte, že ide o existujúceho participanta v Peppol sieti.