Włącz drukowanie etykiet
Postępuj zgodnie z poniższymi krokami, aby umożliwić klientom pobieranie etykiet Zonos ze Twojej platformy.
Zezwól na poświadczenia API
Interfejs API Zonos jest dostępny za pomocą credentialToken. Twoja platforma będzie musiała dać klientom możliwość wprowadzenia ich credentialToken z Pulpitu nawigacyjnego Zonos do Twojej platformy. Stąd będziesz mógł wysyłać żądania do Zonos w ich imieniu.
Utwórz wysyłkę
Aby pobrać label, musisz utworzyć shipment, z którym label będzie powiązana. Zonos zarządza tym procesem za pomocą przepływu pracy, który tworzy shipments i labels w tym samym żądaniu. Podczas wykonywania tej mutacji nie musisz przekazywać serviceLevel, ponieważ użyjemy serviceLevel używanego z landedCost powiązanego z order. Dla orderId możesz użyć identyfikatora zamówienia Zonos lub accountOrderNumber, który prawdopodobnie będzie już w Twoim systemie.
Gdy wysyłka i etykiety są tworzone pomyślnie, zwracamy etykiety jako labelImage, które to BASE64_ENCODED_IMAGE, lub jako url, gdzie etykietę można pobrać.
Użyj tego przepływu pracy podczas tworzenia wysyłki dla istniejącego zamówienia i nie musisz modyfikować szczegółów artykułu lub strony. Obsługuje opcjonalne numery śledzenia, centra spełniania, wybór poziomu usług i ubezpieczenie zgłoszonej wartości.
mutation CreateShipment($input: ShipmentCreateWorkflowInput!) { shipmentCreateWorkflow(input: $input) { id status trackingDetails { number } serviceLevel { id name carrier { id name } } shipmentCartons { id carton { id width length height weight items { item { id amount description label url trackingNumber id documentFilingOpcje zmiennych:
- Z Centrum Spełniania: Dodaj
"fulfillmentCenter": "fulfillment_center_12345", aby określić lokalizację pochodzenia - Z Niestandardowym Śledzeniem: Ustaw
"generateLabel": falsei dodaj"trackingNumbers": ["tracking_1", "tracking_2"] - Z Poziomem Usług: Dodaj
"serviceLevel": "dhl.express_example", aby wybrać określoną usługę przewoźnika - Ze Zdeklarowanym Ubezpieczeniem Wartości: Dodaj
"isDeclaredValue": true, aby włączyć ubezpieczenie zadeklarowanej wartości - Ze Specjalnymi Usługami: Zapoznaj się z przewodnikiem usług specjalnych dotyczącym baterii, suchego lodu, towarów niebezpiecznych i opcji podpisu.
Zadeklarowana wartość
Ustaw "isDeclaredValue": true, aby włączyć ubezpieczenie zadeklarowanej wartości dla wszystkich artykułów w wysyłce. Zonos automatycznie ubezpiecza pełną wartość wszystkich artykułów przesłanych w zamówieniu; handlowcy nie mogą zmienić tej kwoty. Ustawia to maksymalną odpowiedzialność, którą przewoźnik zaakceptuje w przypadku utraty, uszkodzenia lub kradzieży podczas transportu. Ta funkcja jest obsługiwana tylko dla wysyłek UPS, FedEx i DHL. Zonos automatycznie obsługuje implementację specyficzną dla przewoźnika, gdy włączysz zadeklarowaną wartość, w tym odpowiednie parametry w naszych wywołaniach API do tych przewoźników, więc nie musisz zarządzać różnymi wymaganiami przewoźnika.
Ograniczenia UPS: UPS pokrywa tylko wartości od 100 do 50 000 USD i przetwarza zadeklarowaną wartość na poziomie kartonu. W przypadku wysyłek wielokartonowych handlowcy muszą podzielić wysyłkę, aby wyznaczić pokrycie na karton. UPS generuje również dodatkowy formularz ubezpieczenia, który musi być drukowany razem z etykietami.
FedEx i DHL: Przetwarzają zadeklarowaną wartość na poziomie wysyłki bez dodatkowych ograniczeń.
Usługi specjalne
Użyj specialServices na kartonie, aby wskazać specjalne wymagania obsługi baterii, suchego lodu, towarów niebezpiecznych lub wymogów podpisu. Zapoznaj się z przewodnikiem usług specjalnych w celu uzyskania pełnych szczegółów i przykładów.
Odblokowanie ShipStation UPS: Wysyłki wieloczęściowe nie są obsługiwane. Gdy zamówienie wysyła się w wielu pudełkach, pole referencyjne jest duplikowane, co powoduje niepowodzenie dopasowania numeru zamówienia na zapleczu. Handlowcy wymagający wysyłek wieloczęściowych powinni zamiast tego utworzyć etykietę na Pulpicie nawigacyjnym Zonos. Wysyłki jednopudełkowe nie są zagrożone.
Anuluj wysyłkę
W przypadku, gdy klient chce anulować shipment, możesz użyć następującej mutacji, która anuluje wszystkie labels powiązane z shipment.
mutation { shipmentStatusUpdate( input: { shipment: "shipment_f1fe4dbd-e471-49fa-94e7-84e369083223" status: VOIDED note: "Voiding shipment" } ) { id status }}
Utwórz wysyłki ze swojej platformy
Daj klientom możliwość tworzenia wysyłek Zonos i etykiet ze swojej platformy.
Ten przewodnik jest przeznaczony dla deweloperów platform wysyłkowych, którzy chcą zintegrować możliwości tworzenia wysyłek Zonos do swojej platformy dla swoich klientów. Jeśli już używasz interfejsu API Zonos i potrzebujesz tylko tworzyć wysyłki dla istniejących zamówień, zobacz nasz przewodnik tworzenia wysyłek.
Jeśli jesteś platformą wysyłkową obsługującą klientów Zonos wysyłających towary międzynarodowo, integracja z Zonos dla tworzenia wysyłek powinna być głównym priorytetem. Pozwoli to zaoferować najbardziej bezproblemowe doświadczenie dla Twoich handlowców i ich klientów, wykorzystując istniejące funkcje Twojej platformy, przy jednoczesnym pozwoleniu Zonos na zarządzanie tworzeniem wysyłki, etykiety i obsługującą dokumentacją celną.
Zalety używania Zonos do tworzenia wysyłek obejmują:
Ten przewodnik przeprowadzi Cię przez kroki potrzebne do wdrożenia kompletnej integracji end-to-end, która pozwoli Ci dzwonić do Zonos w sprawie wysyłek ze swojej platformy.