Enterprise referencia
Enterprise príjem
Preberiete prijaté dokumenty v Enterprise API, overíte ich stav a potvrdíte prevzatie po uložení.
Predpoklady
- Enterprise prístup a firemný kontext cieľovej firmy.
- Rozhodnutie, či použijete udalosti alebo pull režim.
Postup prevzatia
Prečítajte prijaté dokumenty
GET /api/v1/documents/inbox a detail cez /{id}.
Potvrďte prevzatie po uložení
POST /api/v1/documents/inbox/{id}/acknowledge až po úspešnom uložení dokladu.
Rozlíšte potvrdenie a obchodnú odpoveď
Obchodná odpoveď na doklad je samostatné volanie, nie potvrdenie prevzatia.
Prevádzkové pravidlá príjmu
- Potvrdenie pošlite až po uložení dokladu; príjemca sa potom spolieha na váš systém.
- Udalosti a pull kombinujte tak, aby ste po výpadku vedeli dorovnať stav čítaním.
- Rozlíšte technickú správu od obchodnej odpovede; nie sú to tie isté stavy.
Očakávaný výsledok
Prijaté dokumenty sú uložené, potvrdené a prípadná obchodná odpoveď je evidovaná oddelene.
Keď to nefunguje
- Potvrdenie pred uložením môže spôsobiť vynechanie dokladu pri spracovaní nepotvrdených položiek. Doklad však nemaže ani neblokuje opätovné stiahnutie; obnovte ho cez detail. Potvrdenie je lokálne, zdieľané v rámci firmy a nemení stav odosielateľa.
- Chýbajúca obchodná odpoveď: potvrdenie prevzatia ju nenahrádza.