Integracija API-ja za dostavo MALL

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.

Etikete lahko pridobite 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

Za poenostavitev klica lahko uporabite možnost množičnega klica etiket (bulk label call), ki vam omogoča tudi določitev položaja prve etikete (1., 2., 3. ali 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č.