Domov eFaktúry Developer portal Webhook contract VerifyEU
Enterprise feeds

SFTP a batch onboarding

Nie každý enterprise klient chce volať REST endpoint pri každej faktúre. Táto vrstva opisuje, ako má vyzerať dávkový feed cez SFTP alebo importný batch: naming conventions, manifesty, ACK súbory a retry ownership.

1. Drop

Klient uloží batch balík do dohodnutého priečinka so stabilným názvom a kontrolným manifestom.

2. Intake

Middleware vytvorí batch ID, spracuje feed a rozseká ho na jednotlivé dokumenty s trace identifikátormi.

3. Responses

Výsledky sa vracajú cez ACK/NACK súbory, webhook callbacks alebo batch report API.

4. Archive

Final XML/PDF a error report sa vracajú späť do klientovho archívu alebo evidence storage.

Odporúčané naming conventions

/incoming/verizon/2026-04-21/ invoices_2026-04-21_001.zip invoices_2026-04-21_001.manifest.json /outgoing/verizon/2026-04-21/ invoices_2026-04-21_001.ack.json invoices_2026-04-21_001.errors.csv invoices_2026-04-21_001.bundle.zip

Stabilný naming a batch ID sú dôležité pre audit, retry aj support. Chaos v názvoch je častý zdroj enterprise incidentov.

Čo má obsahovať manifest

Jednoznačný identifikátor dávky a korelačný kľúč pre support.

Očakávaný počet faktúr, príloh a hash súborov.

JSON, XML, CSV bridge alebo kombinovaný ZIP balík.

Support owner, callback endpoint a retry pravidlá pre konkrétny batch.

Prevádzkové guardrails

ACK

Prvá odpoveď

Technické potvrdenie prijatia dávky ešte neznamená business acceptance. Potrebný je aj detailný batch report.

Retry

Čiastočné zlyhanie

Batch workflow má vedieť oddeliť dokumenty, ktoré zlyhali, od tých, ktoré prešli, a nevyžadovať celý re-run.

Evidence

Traceability

Každý dokument v batchi má mať väzbu na batch ID, transmission ID a finálny artifact bundle.

Live batch snapshot

Konektory
SFTP / batch ready
Batch runy
Zlyhané záznamy
Snapshot sa opiera o uložený enterprise connector stav a import runy vo workspace appke.

Recent batch activity

Načítavam batch aktivitu…