Rövid áttekintés
Az ügyfél az OrderWs felé 4 féle kérést indíthat, amit az alábbi metódusok írnak le:
- createOrder(): megrendelés létrehozása a Hibridlevél rendszerében
- getProof(): a megrendelés feldolgozása után a küldemény(ek)ről minta kérése
- rejectOrder(): a minták megtekintése után a megrendelés érvénytelenítése
- approveOrder(): a minták megtekintése után a megrendelés elfogadása
A megrendelés beküldésének és elfogadásának folyamat megegyezik a fent említett metódusok sorrendjével:
- először beküldésre kerül a megrendelés vagy megrendelések
- miután a minták előálltak a megrendelésben lévő küldeményekről, kétféle módon folytatódhat a folyamat:
- a minták helyesek és a megrendelés kiküldésre kerülhet vagy a minták között van hibás, ezért a megrendelés nem kerülhet kiküldésre
Részletes bemutatás
Az alábbiakban bemutatjuk, hogy a fenti 4 metódust mikor és hogyan lehet használni.
1. createOrder():
| Erőforrás neve | Kérés típusa | Uri | Paraméterek | Sikeres kérés esetén válaszkód |
|---|---|---|---|---|
| createOrder | Post | /rest/v2/order | 201 |
A folyamat első lépése, minden esetben ezzel kell kezdeni. Ezzel a kéréssel tudja az ügyfél elküldeni felénk a megrendelését, ami tartalmazza a küldeményeket. A kérésben json formátumban szerepelnie kell a megrendelés adatainak. Az adatok megadásához itt talál segítséget: Order készítése. A sikeres beküldést egy 201-es válasz kód jelenti. Validációs hibák esetén 400-as válasz kód fog visszamenni az ügyfél felé, valamint a hibásan megadott értékek és a javításukhoz szükséges információk.
2. getProof()
| Erőforrás neve | Kérés típusa | Uri | Paraméterek | Sikeres kérés esetén válaszkód |
|---|---|---|---|---|
| getProof | Get | /rest/v2/order/{orderId}/consignment/{consignmentSequenceNumber}/proof |
| 200 |
A beküldés utáni következő lépés. Beküldés után a rendszer az átadott adatok alapján elkészíti a küldeményekhez tartozó mintákat. Ezek a minták PDF típusú fájlokként jönnek létre, amit ez a metódus base64 enkódolt formátumban fog visszajuttatni a mintát lekérő felé. A visszaküldött adatokból a fogadó oldalon elő lehet állítani a minta PDF fájlt. Ez a metódus, ahol a paraméter lista is sejteti, csak 1 küldeményhez tartozó minta PDF fájlt tud visszaadni.
Overview
Content Tools