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 je v novih nastavitvah postopek naročanja vaš sistem ne bo spremenil statusa teh naročil po tem, ko je status SHIPPED (tj. na primer stanje DELIVERED ali RETURNED), bo MALL Partner API 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 državo 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://marketplaceapiv2.docs.apiary.io/#reference/orders/getupdate-order

2. Vlaganje pošiljk in tiskanje nalepk

Ustvarjena je bila nova končna točka za ustvarjanje števila paketov in tiskanje nalepk. Posodobitve števila paketov so dovoljene samo v stanju SHIPPING. Ko preklopite naročilo v stanje SHIPPED vedno lahko prikličete le zadnjo shranjeno različico nalepk in ne morete spremeniti števila nalepk.

Nalepke lahko prikličete v dveh formatih - pdf in zpl. Oba formata sta privzeto samodejno na voljo.

Klicanje nalepk https://marketplaceapiv2.docs.apiary.io/#reference/orders/create-order-labels/create-new-order-labels

Številke paketov za naročilo https://marketplaceapiv2.docs.apiary.io/#reference/orders/return-order-consignments/returns-order-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://marketplaceapiv2.docs.apiary.io/#reference/orders/order-by-status/generate-labels-for-selected-mdp-orders

3. Informacije o neprevzetem paketu

Pošiljke, ki jih stranka ne bo prevzela, bodo vrnjene vam.

Informacije o tem, ali je pošiljka trenutno na voljo za prevzem (ali jo bo dostavna služba dostavila v vaše skladišče), so na voljo v objektu naročila.

Za določitev take pošiljke se uporablja naslednje

• parameter mdp = true
• naročilo je v statusu POŠLANO
• 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č.