Storitev dostave MALL ni na voljo samo na partnerskem portalu, temveč tudi prek API-ja. Če povezavo že imate, lahko razmeroma preprosto prilagodite klic dodatnih funkcij.
1. Stanja vrstnega reda klicanja
Naročila z aktivno storitvijo dostave MALL lahko prepoznate po parametru mdp = true.
Prepričajte se v novih nastavitvah postopek naročila vaš sistem ne bo spreminjal stanja teh naročil glede na status SHIPPED (tj. na primer status DELIVERED ali RETURNED), API MALL Partner bo takšne klice zavrnil.
V primerjavi s prvotnimi nastavitvami sistem ne omogoča več, da stanje naročila takoj preklopite na status SHIPPED (preskoči stanje SHIPPING). Vedno je treba preiti v stanje SHIPPING, v katerem imajo pošiljke sedež. Sistem vam omogoča preklop v stanje SHIPPED šele po vaši zahtevi za nalepko (glej spodaj).
Številka za sledenje in URL se bosta samodejno dodala k našemu naročilu, tako da ga boste lahko prek API-ja prenesli šele po SHIPPED.
Če želite izvedeti podatke o določenem naročilu, na primer omenjeno številko za sledenje pošiljke, uporabite standardni klic podrobnosti naročila. https://marketplaceapiv2.docs.apiary.io/#reference/orders/getupdate-order
2. Ustvarjanje pošiljk in tiskanje etiket
Ustvarjena je bila nova končna točka za ustvarjanje števila paketov in tiskanje nalepk. Posodobitve števila paketov so dovoljene samo vam v statusu SHIPPING. Ko naročilo preklopite v stanje SHIPPED vedno lahko pokličete samo zadnjo shranjeno različico nalepk in njihove številke ne morete več spremeniti.
Oznake lahko imenujemo v dveh oblikah - pdf in zpl. Obe obliki sta samodejno na voljo privzeto.
Oznake klicev https://marketplaceapiv2.docs.apiary.io/#reference/orders/create-order-labels/create-new-order-labels
Številke paketov naročil https://marketplaceapiv2.docs.apiary.io/#reference/orders/return-order-consignments/returns-order-consignments
Če želite klice narediti učinkovitejše, lahko uporabite možnost za množično klicanje oznak, ki vam bo omogočila tudi določitev prvega mesta oznake (1. - 4.) v primeru pdf.
3. Informacije o nepobranih pošiljkah
Pošiljke, ki jih stranka ni prevzela, vam bodo vrnjene.
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 na predmetu naročila.
Za določitev take pošiljke velja
- parameter mdp = true
- naročilo je v SHIPPED stanju
- parameter ready_to_return = true
4. Branje sprememb naročil
Za učinkovito pridobivanje informacij o spremembah posameznih naročil priporočamo uporabo webhooku v kombinaciji s klicem podrobnosti naročila.
Če imate dodatna vprašanja, nas lahko kontaktirate prek FAQ, Centra za pomoč.