Poštár Cloud Logo postar-cloud.sk
Späť na domovskú stránku

API pre účtovné a ERP systémy

REST rozhranie Poštár Cloud · Posledná aktualizácia: 22. októbra 2026

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.

Úplná technická dokumentácia (OpenAPI, autentifikácia, limity, webhooky, implementačné poznámky):
zk.postar-cloud.sk/sapi/docs
Dokumentácia je len na čítanie. Rozhranie si vyskúšate vlastným klientom so schváleným API kľúčom.

Čo poskytujeme

ČasťObsahStav
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

Prečo štandard

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á.

Prostredia

  • Produkcia: https://zk.postar-cloud.sk/sapi, produkčná sieť Peppol.
  • Test: samostatná inštancia s vlastným Access Pointom v testovacej sieti Peppol a vlastnými API kľúčmi. O prístup požiadajte na podpora@postar-cloud.sk.

Dostupnosť a limity

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.

Oficiálne zdroje

  • sapi-sk.sk — špecifikácia SAPI-SK (OpenAPI)
  • eFaktúra na portáli Finančnej správy SR

Potrebujete pomoc s integráciou alebo testovacie prístupové údaje? Napíšte nám na podpora@postar-cloud.sk alebo si pozrite partnerský program.

postar-cloud.sk

Váš digitálny kuriér. Spája faktúry, doklady, platby, účtovné systémy a archiváciu na jednom mieste.

E-Works s. r. o.
Vojtaššákova 648, 027 44 Tvrdošín
IČO: 55810802 | DIČ: 2122091598 | IČ DPH: SK2122091598
Zapísaná v OR Okresného súdu Žilina, odd. Sro, vl. č. 84349/L
podpora@postar-cloud.sk | +421 949 364 809

Produkt

Funkcie Cenník Ako to funguje

Zdroje

E-faktúra 2027 API Dokumentácia

Firma

Kontakt Ochrana súkromia Obchodné podmienky Podmienky siete Peppol
GoPay Visa Mastercard Maestro Verified by Visa Mastercard SecureCode

© 2026 Poštár Cloud. Vyvinuté na Slovensku pre E-Works s. r. o.