Storitev MALL Delivery je na voljo ne le na partnerskem portalu, temveč tudi prek vmesnika API. Če že imate povezavo, lahko z razmeroma preprostimi prilagoditvami prikličete dodatne funkcije.
1. Stanje naročila za klic
Naročila z aktivno storitvijo dostave MALL je mogoče prepoznati s parametrom mdp = true.
Prepričajte se, da v novih nastavitvah postopek naročanja vaš sistem ne bo spremenil statusa teh naročil po tem, ko bodo prešla v status SHIPPED (tj. na primer stanje DELIVERED ali RETURNED), MALL Partner API bo zavrnil takšne klice.
V primerjavi s prvotnimi nastavitvami vam sistem ne bo več omogočal takojšnjega preklopa statusa naročila na SHIPPED (preskok stanja SHIPPING). Vedno je treba preklopiti na SHIPPINGv katerem so shranjene pošiljke. Sistem vam omogoča, da preklopite na status SHIPPED po vaši zahtevi za nalepko (glej spodaj).
Številko za sledenje in url bo naš sistem samodejno dodal vašemu naročilu, vi pa jo boste lahko prenesli prek API šele po tem, ko bo status SHIPPED.
Če želite poiskati podatke o določenem naročilu, kot je zgoraj omenjena številka za sledenje, uporabite standardni klic s podrobnostmi naročila. https://mpapi-docs.mallgroup.com/#/Orders/get_v2_orders__orderId_
Stara točka za podrobnosti o naročilih je zastarela. (GET/orders/{orderId}) Ne bo delovala z dostavnimi opcijami za prevzemna mesta.
2. Kreiranje pošiljk in tiskanje nalepk
Na voljo je končna točka (endpoint) za ustvarjanje števila paketov in tiskanje nalepk. Posodobitve števila paketov so dovoljene samo v stanju SHIPPING. Ko naročilo preklopite v status SHIPPING, lahko dostopate le do zadnje shranjene različice nalepke. Števila nalepk ne morete več spremeniti.
Nalepke lahko prikličete v dveh formatih - pdf in zpl. Oba formata sta privzeto samodejno na voljo.
Končne točke:
Klicanje nalepk: https://mpapi-docs.mallgroup.com/#/Orders/post_orders_labels
Številke paketov naročil: https://mpapi-docs.mallgroup.com/#/Orders/get_orders__orderId__consignments
Če želite poenostaviti klic, lahko uporabite možnost množičnega klica nalepk, ki vam omogoča tudi določitev prvega položaja nalepke (od 1. do 4.) v primeru formata pdf.
https://mpapi-docs.mallgroup.com/#/Orders/post_orders_labels_bulk
Informacije o neprevzetih pošiljkah
Pošiljke, ki jih stranke ne bodo prevzele, bodo vrnjene k vam.
Informacija o tem, ali je pošiljka trenutno na voljo za prevzem (ali da jo bo dostavna služba dostavila v vaše skladišče), je na voljo na objektu naročila.
Za določitev takšne pošiljke velja naslednje:
- parameter mdp = true
- naročilo je v statusu SHIPPED (Odpravljeno/Poslano)
- parameter ready_to_return = true
4. Branje sprememb naročil
Za učinkovito pridobivanje informacij o spremembah posameznih naročil priporočamo uporabo webhook v kombinaciji s klicem podrobnosti naročila.
Če imate dodatna vprašanja, nas lahko kontaktirate prek FAQ, Centra za pomoč.