Usluga dostave u MALL dostupna je ne samo na partnerskom portalu, već i putem API-ja. Ako ste već stvorili vezu, možete napraviti relativno jednostavne prilagodbe za pozivanje dodatnih funkcija.
1. Provjera statusa narudžbi
Narudžbe s aktivnom uslugom dostave u MALL prepoznajete po parametru mdp = true.
Provjerite da u novim postavkama proces narudžbe Vaš sustav neće promijeniti status ovih narudžbi nakon što status POSLANO (tj. na primjer, o statusu DOSTAVLJENO ili VRACENO), MALL Partner API će odbiti takve pozive.
Za razliku od izvornih postavki, sustav vam više neće dopuštati da odmah promijenite status narudžbe u status POSLANO (preskoči stanje DOSTAVA). Uvijek je potrebno prebaciti se na stanje DOSTAVA, u kojem se kreiraju pošiljke. Sustav će vam omogućiti prebacivanje na status POSLANO nakon vašeg zahtjeva za oznaku (vidi dolje).
Naš sustav će automatski dodati broj za praćenje i URL vašoj narudžbi, a narudžbu ćete moći preuzeti putem API-ja tek nakon što se status POSLANO.
Ako želite saznati podatke o određenoj narudžbi, na primjer prethodno spomenuti broj za praćenje pošiljke, upotrijebite standardni poziv za detalje narudžbe. https://mpapi-docs.mallgroup.com/#/Orders/get_v2_orders__orderId_
Stara endpoint za određene podatke o narudžbi je zastarjela. Neće raditi s uslugama dostave na prodajno mjesto.
2. Izrada pošiljki i ispis naljepnica
Dostupna je krajnja točka za stvaranje broja paketa i ispis naljepnica. Ažuriranja broja paketa dopuštena su samo u stanju SHIPPED. Nakon što narudžbu prebacite u stanje SHIPPED, možete vidjeti samo posljednju spremljenu verziju naljepnica i broj naljepnica ne može se mijenjati.
Štítky je možné volat ve dvou formátech – pdf a zpl. Oba formáty jsou v defaultním nastavení automaticky dostupné.
Oznake poziva https://mpapi-docs.mallgroup.com/#/Orders/post_orders_labels
Brojevi paketa narudžbe https://mpapi-docs.mallgroup.com/#/Orders/get_orders__orderId__consignments
Pro zefektivnění volání můžete využít volbu pro hromadné volání štítků, která Vám umožní i určení první pozice štítku (1. – 4.) v případě pdf formátu.
https://mpapi-docs.mallgroup.com/#/Orders/post_orders_labels_bulk
3. Informacije o nepreuzetim pošiljkama
Pošiljke koje kupac nije preuzeo bit će vam vraćene.
Informacije o tome je li pošiljka trenutno dostupna za preuzimanje (ili će je dostaviti služba za preuzimanje u vaše skladište) dostupne su na objektu narudžbe.
Za određivanje takve pošiljke primjenjuje se sljedeće:
- parametar mdp = true
- narudžba je u statusu SHIPPED
- parametar ready_to_return = true
4. Čitanje promjena narudžbi
Za učinkovito dobivanje informacija o promjenama pojedinačnih narudžbi preporučujemo korištenje webhook u kombinaciji s detaljima narudžbe poziva.
Ako imate dodatnih pitanja, možete nas kontaktirati putem Centra za pomoć .