Dev sandbox15 minútEnterprise API

15-minútový ERP Test Lab

Jeden riadený postup pre integrátora: získa JWT, overí demo Peppol participantov, spustí preflight, odošle sandbox doklad, overí webhook podpis a stiahne evidence bundle.

Spustiť labSandbox účty v docs
Sandbox prihlasovacie údaje

Verejné demo údaje sú použiteľné v snippete aj v runneri.

Demo integrátor
<sandbox_integrator_client_id>
<sandbox_integrator_client_secret>
Test odosielateľ
0245:0000000001
f2cea3cf-f29e-4ea2-9e76-b06a312ec9ab
Test prijímateľ
0245:0000000002
b1022d80-5016-4dad-a8d2-53685cab1701
Sprievodca integráciou

Flow ako Swagger, ale zložený podľa reálneho ERP scenára

Swagger ukáže endpointy. Tento lab ukazuje poradie volaní, hlavičky, demo firmu a čo má ERP vyhodnotiť po každom kroku.

Scenár testu

Happy path

Všetky kroky idú cez živý sandbox proxy.

Priebeh integrácie
Stav, HTTP a trvanie každého kroku v jednom behu.
Exporty integrácie

Completion report, Postman a sandbox config

Po behu labu si integrátor odnesie testovací dôkaz, Postman collection, OpenAPI sandbox a .env export pre ERP.

Uložené behy

História test labu

localStorage

Po spustení celého labu tu ostane krátka história behov pre implementátora.

Sandbox JWT
POST /api/v1/auth/token
sandbox session chýbadocumentId zatiaľ nie
kopírovateľná ukážka volania
curl -s -X POST https://dev.epostak.sk/api/v1/auth/token \
  -H "Content-Type: application/json" \
  -d '{
    "grant_type": "client_credentials",
    "client_id": "<sandbox_integrator_client_id>",
    "client_secret": "<sandbox...ecret>"
  }'

# export TOKEN="<access_token from response>"
Odpoveď labu
Spustite prvý krok. Odpoveď API sa zobrazí tu.
Checklist pred produkciou

Čo musí ERP vedieť pred produkciou

Lab je len prvý smoke test. Pred živým klientom musí integrátor dokázať, že vie bezpečne rotovať tokeny, deduplikovať send, overovať webhooky a uložiť dôkazový balík.

  • JWT získaný cez client_credentials
  • X-Firm-Id posielané pri integrátorskom kľúči
  • Preflight číta decision, canSend a errors[]
  • Send používa Idempotency-Key
  • Webhook podpis overený cez HMAC-SHA256
  • Evidence bundle uložený v ERP audit traili

Technická dokumentácia

Presné parametre, response schémy, error kódy a sandbox účty ostávajú v Enterprise docs.

Enterprise docs

SAPI vs Enterprise

Rozdiel medzi štandardným rozhraním a rozšíreným Enterprise API ostáva na samostatnej stránke.

API integrácia

Produkčný prístup

Produkčný obchodný režim si vyberáte nezávisle od API rozhrania. Koncová firma môže platiť sama cez vlastné sk_live_* credentials; integrátor môže platiť súhrnne cez managed sk_int_*. Connector je vhodný pre business JSON a customerRef, Enterprise pridáva širšie riadenie toku a SAPI ostáva prenositeľný 8-endpointový profil.

Požiadať o produkčný prístup