Usługa MALL Delivery jest dostępna nie tylko w portalu partnerskim, ale także poprzez API. Jeśli masz już połączenie, możesz dokonać stosunkowo prostych zmian, aby wywołać dodatkowe funkcje.
1. Wywołanie statusów zamówień
Możesz zidentyfikować zamówienia z aktywną usługą MALL Delivery za pomocą parametru mdp = true.
Upewnij się w nowych ustawieniach proces zamówienia Twój system nie będzie przełączał statusu tych zamówień według statusu SHIPPED (czyli na przykład status DELIVERED lub RETURNED), MALL Partner API odrzuci takie połączenia.
W porównaniu z pierwotnymi ustawieniami system nie pozwala już na natychmiastowe przełączenie statusu zamówienia na status SHIPPED (status pomiń SHIPPING). Zawsze konieczne jest przejście do stanu SHIPPING, w którym przesyłki są umieszczone. System pozwala na przejście do stanu SHIPPED dopiero po złożeniu wniosku o etykietę (patrz poniżej).
Numer śledzenia i adres URL zostaną automatycznie dodane do naszego zamówienia, abyś mógł złożyć zamówienie, a będziesz mógł go pobrać przez API dopiero po statusie SHIPPED.
Jeśli chcesz poznać dane dotyczące konkretnego zamówienia, takie jak wspomniany numer śledzenia przesyłki, skorzystaj ze standardowego wywołania szczegółów zamówienia. https://marketplaceapiv2.docs.apiary.io/#reference/orders/getupdate-order
2. Tworzenie przesyłek i drukowanie etykiet
Utworzono nowy punkt końcowy do tworzenia liczby opakowań i drukowania etykiet. Aktualizacje liczby paczek są dozwolone tylko w statusie SHIPPING. Po przełączeniu zamówienia na status SHIPPED zawsze możesz zadzwonić tylko do ostatniej zapisanej wersji etykiet i nie możesz już zmienić ich numeru.
Etykiety można wywoływać w dwóch formatach - pdf i zpl. Oba formaty są domyślnie dostępne automatycznie.
Etykiety połączeń https://marketplaceapiv2.docs.apiary.io/#reference/orders/create-order-labels/create-new-order-labels
Numery paczek zamówień https://marketplaceapiv2.docs.apiary.io/#reference/orders/return-order-consignments/returns-order-consignments
Aby zwiększyć efektywność połączeń, możesz skorzystać z opcji masowego wywoływania etykiet, co pozwoli również określić pierwszą pozycję etykiety (1 - 4) w przypadku formatu pdf.
3. Informacje o nieodebranych przesyłkach
Przesyłki, które nie zostały odebrane przez klienta, zostaną Ci zwrócone.
Informacja o tym, czy przesyłka jest aktualnie dostępna do odbioru (lub czy zostanie dostarczona przez firmę kurierską do Twojego magazynu) jest dostępna w obiekcie zamówienia.
Do ustalenia takiej przesyłki ma zastosowanie
- parametr mdp = true
- zamówienie jest w stanie WYSYŁANE
- parametr ready_to_return = true
4. Odczytywanie zmian w zamówieniach
W celu sprawnego pozyskiwania informacji o zmianach w poszczególnych zamówieniach zalecamy korzystanie webhooku w połączeniu z rozmową o szczegółach zamówienia.
W przypadku dodatkowych pytań można się z nami skontaktować poprzez Centrum Pomocy.