Testovanie

Ako testovať API integráciu s digitálnym poštárom?

Krátka odpoveď

Testujte nielen úspešné odoslanie, ale aj chyby. Pripravte vzorové XML, nevalidné XML, nesprávneho adresáta, timeout, opakovaný pokus, webhook so stavom doručená a export dôkazov. Až keď prejde celý cyklus, integrácia je pripravená na ostrý režim.

Sandbox

Bez ostrých dokladov

Testy robte na syntetických dátach a oddelenom prostredí.

Scenáre

Úspech aj chyba

Nevalidné XML je rovnako dôležitý test ako úspešné doručenie.

Statusy

Webhooky a polling

Overte, či sa stav dostane späť do ERP.

Dôkazy

Auditný export

Test skončí až uložením reportu a statusov.

Podrobné vysvetlenie

Doručovací partner je kritická externá závislosť. Testy majú pokryť techniku aj proces: autentifikáciu, limity, odpovede API, mapovanie stavov, idempotenciu a obnovu po výpadku. Výsledky testov ukladajte ako regresnú evidenciu, aby sa pri ďalšej zmene vedelo, čo sa má zopakovať.

Ako to vyplýva zo zákona

Zákon neurčuje testovací scenár, ale ostrá prevádzka musí byť schopná preukázať odoslanie, doručenie a prijatie. Testovanie má overiť, že tieto dôkazy reálne vznikajú.

Praktické príklady

  • Sandbox prijme validné XML a vráti transakčné ID.
  • Nevalidné XML sa odmietne s konkrétnou chybou.
  • Webhook príde dvakrát a systém ho nespracuje duplicitne.

Najčastejšie chyby

  • „Stačí jeden úspešný send.“ Bez chybových scenárov integrácia nie je overená.
  • „Sandbox dáta môžu byť reálne.“ Používajte syntetické dáta.
  • „Statusy otestujeme neskôr.“ Bez statusov neviete preukázať doručenie.

Záver

API integráciu testujte ako celý životný cyklus dokladu, nie iba ako jedno volanie send.

Právny základ

  • Zákon č. 222/2004 Z. z. o DPH, § 76a
  • SLA a technická dokumentácia doručovacieho partnera
  • Interný testovací protokol

Súvisiace otázky

Nie je to právne poradenstvo. Zdroje: zákon č. 222/2004 Z. z. o DPH, Finančná správa SR eFaktúra FAQ, OpenPeppol BIS Billing 3.0 a interný validačný model eFaktúra centra. Overené 7. 7. 2026.