Váš účtovný program alebo ERP systém môže odosielať a prijímať e-faktúry cez sieť Peppol priamo, bez ručnej práce v portáli. Rozhranie Poštár Cloud je postavené podľa štandardu SAPI-SK (Standardised Access Point Interface, Slovakia), ktorý zverejnila Finančná správa SR spolu so slovenskou komunitou Peppol, a dopĺňa ho o rozšírenia SAPIPlus.
| Časť | Obsah | Stav |
|---|---|---|
SAPI-SK 1.0.0/sapi/ |
Autentifikácia OAuth 2.0 (client_credentials, JWT na 15 minút, obnovovací token na 30 dní), odoslanie dokladu do siete Peppol, zoznam prijatých dokladov so stránkovaním, detail a potvrdenie prevzatia. Požiadavky, odpovede aj chyby v tvaroch zo špecifikácie, s idempotentným odoslaním cez Idempotency-Key. |
v prevádzke; niekoľko zámerných odchýlok je popísaných v dokumentácii |
SAPIPlus v1/sapi/plus/v1/ |
Webhooky: notifikácia na vašu HTTPS adresu pri prijatom doklade, pri zmene stavu odoslaného prenosu a pri odpovedi odberateľa, podpísaná HMAC-SHA256, s opakovaním doručenia. Stav odoslaného dokladu: doručenie, potvrdenie od Access Pointu príjemcu (MLS), SK TDD hlásenie a odpoveď odberateľa (Invoice Response: prijaté, odmietnuté s dôvodom, uhradené). Validácia dokladu pred odoslaním. Vyhľadanie príjemcu v sieti Peppol a zistenie, aké doklady vie prijať. Stránkovaný inbox s filtrami podľa smeru, stavu, druhu a dátumu. | v prevádzke |
| Správa kľúčov portál |
API kľúč si založíte v portáli (názov, oprávnenia, allow-list IP adries). client_secret sa zobrazí raz. Kľúč schvaľuje Poštár Cloud; jeden kľúč koná za jednu firmu. V portáli vidíte aj prehľad vlastných API volaní. |
v prevádzke |
| Daňové hlásenia | SK TDD hlásenia pre Finančnú správu vznikajú automaticky po odoslaní aj prijatí dokladu. Integrátor ich nerieši. | v prevádzke |
Integrácia napísaná podľa SAPI-SK funguje s nami aj s inými certifikovanými poskytovateľmi bez prerábania. Preto štandardnú časť rozhrania nerozširujeme: všetko, čo špecifikácia nepozná, je oddelene v SAPIPlus s vlastným verzovaním. Integrácia, ktorá rozšírenia nevyužíva, zostáva plne prenositeľná.
https://zk.postar-cloud.sk/sapi, produkčná sieť Peppol.API je dostupné v balíkoch Business, Pro a Partner (cenník). Technický limit je 60 požiadaviek za minútu z jednej IP adresy; zmluvné limity upravujú obchodné podmienky.
Potrebujete pomoc s integráciou alebo testovacie prístupové údaje? Napíšte nám na podpora@postar-cloud.sk alebo si pozrite partnerský program.