Integracija API-ja usluge dostave u trgovački centar

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.

Oznake se mogu pozvati u dva formata – pdf i zpl. Oba formata su automatski dostupna prema zadanim postavkama.

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

Kako bi poziv bio učinkovitiji, možete koristiti opciju za masovno pozivanje oznaka, koja će vam također omogućiti da odredite prvu poziciju oznake (1. - 4.) u slučaju PDF formata.

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ć .