Domov eFaktúry Developer portal ICD & OpenAPI VerifyEU
Test vs prod

Sandbox a production režim

Enterprise klient potrebuje viac než len endpoint. Potrebuje vedieť, čo sa testuje v sandboxe, čo patrí až do produkcie, ako vyzerá promotion checklist a že produkčné doručovanie eFaktúr prebieha cez pripojeného certifikovaného partnera.

Sandbox cieľ

Overiť mapping, validáciu, webhook callbacks, artifact return a retry logiku cez demo/mock provider bez rizika produkčných faktúr alebo finančných dopadov.

Production cieľ

Spustiť stabilný M2M tok s idempotency, monitoringom, audit stopou a doručovaním cez pripojeného certifikovaného partnera.

Rozdiel medzi prostrediami

Oblasť
Sandbox
Production
Payloady
Test scenáre, syntetické firmy, vzorové XML/PDF a simulované corner cases.
Reálne firemné dáta a schválené integračné feedy.
Callbacky
Webhook endpointy na test infraštruktúre s bohatým logovaním.
Produkčné endpointy s podpisom, retry a SLA monitoringom.
Artefakty
Artifact return na test storage alebo sandbox archive bucket.
Finálne XML/PDF a evidence bundle pre interný archív klienta.
Support
Rýchla iterácia nad mappingom, rule packmi a remediation flowom.
Incident ownership, change control a release okná.
Risk
Bez finančného dopadu, primárne technické overenie cez demo/mock provider.
Compliance, príprava doručenia cez pripojeného certifikovaného partnera a auditná zodpovednosť.

Promotion checklist

Potvrdiť povinné polia, identifikátory, tax logiku, prílohy a PDF potreby.

Otestovať idempotentné retry, validation fail flow a oneskorené webhook callbacky.

Skontrolovať transmission ID, rule version, response timeline a artifact bundle handoff.

Uzavrieť rollout čas, kontakty pre incidenty a fallback postup pri prvom produkčnom behu.

Sample request headers

POST /api/intake/invoices Authorization: Bearer $API_KEY Idempotency-Key: vz-2026-00418 X-Environment: sandbox X-Correlation-Id: rollout-01

V produkcii má byť rozdiel medzi sandbox a prod čitateľný aj v logoch, artifact storage a webhook receiveroch, nie len v názve endpointu.

Live cutover snapshot

Konektory pilot/active
Webhook endpoints
Readiness score
Kritické gaps
Snapshot sa skladá z connectorov, webhookov a readiness vrstvy, teda z toho, čo typicky rozhoduje o cutover pripravenosti.
Načítavam cutover snapshot…