Domov eFaktúry Developer portal Webhook contract Sandbox VerifyEU
Enterprise contract

ICD a OpenAPI kontrakt

Táto vrstva slúži pre enterprise klientov, ktorí nechcú len “API endpoint”, ale presný integračný kontrakt: čo posielať, ako reagovať na chyby, ako robiť retry, aké eventy očakávať a ako sa mení verzia rozhrania.

Dať technickému tímu kontrakt, podľa ktorého vedia namapovať interný systém bez nejasností a bez improvizácie.

REST API ako prvá voľba, batch ingestion pre väčšie dávky a SFTP pre konzervatívne enterprise prostredia.

Payload model, auth, errors, versioning, retries, signatures, webhook references a rollout checklist.

Čo má ICD obsahovať

Oblasť
Obsah
Dôvod
Feed
REST endpointy, batch upload, SFTP naming convention, accepted MIME types a max veľkosť dávky.
Pripojenie
Schema
JSON/XML request model, required fields, optional fields, mapping notes a country-specific výnimky.
Mapping
Errors
Error catalog s rule_id, severity, field path, remediation hint a retry policy.
Support
Versioning
Verzia API, verzia rule packu, breaking change policy a changelog cadence.
Stabilita
Events
Odkazy na webhook contract, transport IDs, delivery lifecycle a artifact callbacks.
Lifecycle

OpenAPI skeleton

openapi: 3.1.0 info: title: VerifyEU eInvoice Middleware version: 2026-04 paths: /api/intake/invoices: post: summary: Ingest invoice feed parameters: - in: header name: Idempotency-Key required: true requestBody: content: application/json: {} application/xml: {} responses: "202": description: Accepted for processing "422": description: Validation failed /api/messages/{invoiceId}: get: summary: Delivery and business responses /api/artifacts/{invoiceId}: get: summary: Final XML/PDF and archive metadata

Enterprise rollout checklist

1

Mapovanie dát

Potvrdiť povinné polia, company identifiers, tax data, PDF requirements a country-specific pravidlá.

2

Sandbox

Otestovať intake, validate, webhook callbacky a artifact return bez produkčných faktúr.

3

Cutover

Uzavrieť retry policy, archival flow, support ownership a release okno pre prvý ostrý batch.

Env

Sandbox vs Production

Test/prod rozdiel, promotion checklist a cutover guardrails pre enterprise tímy.

Otvoriť režimy →
 Rules

Error Catalog

Rule IDs, severity a remediation hints, ktoré majú byť súčasťou ICD kontraktu.

Otvoriť error catalog →
 Batch

SFTP & Batch

Dávkové feedy, manifesty a naming conventions ako súčasť integračného balíka.

Otvoriť batch onboarding →