SAPI referencia
SAPI príjem
Prevezmete prijaté dokumenty cez SAPI a potvrdíte prevzatie po ich uložení.
Predpoklady
- Participant-scoped prístup s oprávnením na čítanie prijatých dokumentov.
- Vlastné úložisko, do ktorého doklad uložíte pred potvrdením.
Postup prevzatia
Zoznam prijatých dokumentov
GET /sapi/v1/document/receive vráti dostupné dokumenty pre vášho participanta.
Stiahnite konkrétny dokument
GET /sapi/v1/document/receive/{documentId} prevezme dokument; uložte ho skôr, než pošlete potvrdenie.
Potvrďte prevzatie
POST /sapi/v1/document/receive/{documentId}/acknowledge až po úspešnom uložení. Potvrdenie nie je obchodná odpoveď.
Čo si pri príjme strážiť
- Potvrdenie mení lokálny stav RECEIVED na ACKNOWLEDGED. Dokument zmizne zo zoznamu filtrovaného na RECEIVED, ale zostáva dostupný na stiahnutie; stav odosielateľa ani transportné potvrdenie nemení.
- Opakovaný download spracujte idempotentne a doklad neukladajte dvakrát.
- Prípadná obchodná odpoveď na faktúru je samostatný krok, nie podmienka technického prevzatia.
Očakávaný výsledok
Doklad je uložený vo vašom systéme a potvrdenie je odoslané až po uložení.
Keď to nefunguje
- Ak ste potvrdili pred uložením, stiahnite dokument znovu cez jeho detail. Nájdete ho aj v zozname so status=ACKNOWLEDGED alebo bez filtra stavu; potvrdenie dokument nemaže.
- Opakovaný download: spracujte ho idempotentne, ten istý doklad neukladajte dvakrát.