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.
Stavy dokumentov
Rozlíšite prijatie API požiadavky, doručenie do Peppol siete, technickú správu a obchodnú odpoveď druhej strany.
- Dokument, ktorý chcete sledovať, a prístup k jeho stavu vo vašom rozhraní.
Štyri rôzne vrstvy
| Vrstva | Čo znamená | Čo neznamená |
|---|---|---|
| HTTP odpoveď API | Požiadavka bola prijatá a spracovaná. | Že dokument už dorazil príjemcovi. |
| Stav dokumentu | Kde sa dokument nachádza v doručovacom procese. | Že príjemca súhlasí s obsahom. |
| Technická správa | Informácia o prenose alebo jeho zlyhaní. | Obchodné potvrdenie alebo reklamácia. |
| Obchodná odpoveď | Reakcia druhej strany na doklad, napríklad potvrdenie alebo námietka. | Automatické zrušenie alebo stiahnutie dokladu. |
Ako získať dôkaz
- Uložte si stav aj čas, kedy ste ho čítali; bez času nie je dôkaz úplný.
- Prijatie u príjemcu overujte v jeho rozhraní alebo podľa dostupného potvrdenia, nie iba u odosielateľa.
- Nesľubujte zákazníkovi stiahnutie doručenej faktúry; doručený doklad sa nedá vziať späť.
Očakávaný výsledok a chyby
Viete presne povedať, v ktorej vrstve sa doklad nachádza, a máte na to dôkaz s časom.
- API vrátilo úspech, ale príjemca nič nemá: dokument je prijatý, nie doručený — skontrolujte stav a doručenie.
- Technická správa prišla neskoro: nevyhlasujte úspech pred jej vyhodnotením.
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.