Dokumentácia pre integrácie na lookup, validáciu, odoslanie, prijímanie, webhooky a auditné výstupy. Popisuje odporúčaný spôsob nasadenia, bezpečnostné pravidlá a integračné scenáre.
Dostupné endpointy sa môžu líšiť podľa prostredia a typu nasadenia. Produkčné kľúče patria na server a nie do prehliadača. Verejný frontend nemá volať súkromné produkčné trasy priamo.
Privátne API kľúče patria na server, nie do browser JS. Odošielanie a retry majú používať Idempotency-Key.
Endpointy počítajú nielen s odoslaním, ale aj s prijatím, approvals, response kódmi, evidence packom a archive flowom.
Integrátor potrebuje krátky quickstart, payload examples, retry rules, webhooks a jasný rozdiel medzi test a prod režimom.
Pre enterprise klientov je dôležitý plne automatizovaný tok: systém prijme feed, validuje ho, skonvertuje, odošle a vráti finálne artefakty späť do archívu alebo ERP.
Integrácia počíta s JSON/XML feedom, dávkovým spracovaním a bezpečnými kanálmi ako SFTP. Interface Control Document môže mať podobu OpenAPI/Swagger špecifikácie doplnenej o mapping a retry pravidlá.
Pri chybe má systém vrátiť detailný dôvod, rule ID, XML uzol a odporúčanú opravu. Zdrojem opravy ostáva pôvodný systém a VerifyEU vracia výsledok späť cez webhook.
Enterprise klienti často potrebujú dostať späť finálne XML aj PDF, mať portál na prehľad spracovaných faktúr a vedieť pripraviť vlastnú PDF šablónu podľa brandingu.
Kontrakt pre feed, mapping, error catalog, versioning a checklist pre enterprise tímy.
Delivery lifecycle, callback payloady, signature model, retries a event ordering.
Návrat finálneho XML/PDF, custom template balík a archive handoff do interného systému klienta.
Promotion checklist, test payloady, idempotency guardrails a cutover pravidlá pred ostrým štartom.
Rule IDs, severity, XML path, remediation hints a owner model pre enterprise triage.
Naming conventions, manifesty, ACK súbory, partial retry a traceability pre korporátne feedy.
EU data residency, audit logs, retention a enterprise prevádzkový model pre technické review.
SSO, lifecycle a role governance pre korporátne tenanty a integračné tímy.
Pay-go API, plány pre účtovníkov a enterprise middleware v jednom komerčnom modeli.
Oddelenie admin, accountant a developer oprávnení vrátane API keys a audit roly.
Prioritný zoznam systémov pre slovenský trh so stavom kompatibility. Import už pracuje s POHODA XML, KROS exportmi, Money/MRP CSV a ISDOC; ďalšie priame konektory pribúdajú postupne.
Technická baseline pre edge headers, CORS, payload controls, auth a enterprise hardening.
Status page, webhook delivery log, correlation IDs a incident reporting pre enterprise support.
e-Discovery bundle pre klientov, ktorí potrebujú XML/PDF/log export za obdobie.
Rules, PO matching, disputes a smart intake pre pokročilejšie automatizačné scenáre.
Factur-X, clearance a roaming ako multi-country smer pre ďalšie integrácie.
Lookup partnera v tvare 0245:2020123456. Výstup: registrácia, názov, supportované dokumenty, stav pripravenosti a odporúčaný kanál.
XML validácia vracia rule_id, závažnosť problému a odporúčanie na opravu. Pri lokálnom prehľade má byť vždy jasne označené, že nejde o produkčný výsledok.
Excel, CSV alebo pripravené exporty na vstupe a ZIP s pripravenými XML alebo dávkovým reportom na výstupe. Vhodné pre postupný prechod bez nového ERP.
Príprava a odoslanie dokumentu cez pripojeného certifikovaného partnera s dôrazom na Idempotency-Key, transportné ID, evidence a následné response eventy.
Prehľad ACK, NACK, rejection a ďalších udalostí vrátane významu pre biznis a časovej osi spracovania.
Balík pre audit alebo internú kontrolu: payload, zhrnutie validácie, response udalosti, verzia pravidiel a časová os spracovania.
Ukážky nižšie slúžia ako sandbox alebo server-side integračný vzor. Produkčná URL, autorizácia a dostupné endpointy závisia od zvoleného nasadenia.
Transportná vrstva potvrdila doručenie do siete alebo príjemcu.
Transportný alebo business rejection. Typicky otvára remediation flow.
Podmienené prijatie, timeout alebo konflikt workflow dát.
Dokument bol uzavretý a označený na archiváciu s evidence packom.
Finálne XML a PDF sú pripravené na návrat do interného archívu alebo billing systému klienta.
Nízko dôveryhodné vstupy majú ísť cez human review, nie cez autonómne odoslanie.
Peppol ID, DIČ, IBAN a partner identifiers treba validovať ešte pred batchom.
ACK neznamená business prijatie. Workflow má vedieť čakať na ďalší response event.
Pri nepripravenom partnerovi treba vrátiť odporúčaný kanál, nie iba hlášku “partner not found”.