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 oraz towarzyszącej dokumentacji celnej.
Zalety używania Zonos do tworzenia wysyłek obejmują:
Rozliczenia stron trzecich ceł i podatków - Zapewnimy, że Twój numer rachunku przewoźnika lub numer rachunku Twojego handlowca jest używany do opłat za wysyłkę, podczas gdy rachunki za cło i podatek trafiają do Zonos.
Elastyczność - Zamiast wykonywać prace programistyczne, aby upewnić się, że możesz generować zgodne etykiety przy użyciu swojej platformy, zintegruj się z naszym API i pozostaw zmieniające się przepisy transgraniczne nam.
Dokładna dokumentacja celna - Gdy używasz Zonos do generowania etykiet, zapewniamy, że odpowiednie szczegóły są przekazywane przewoźnikowi, aby pakiet szybko przeszedł kontrolę celną.
Ten przewodnik przeprowadzi Cię przez kroki potrzebne do wdrożenia kompletnej integracji end-to-end, która pozwoli Ci wysyłać żądania do Zonos w sprawie wysyłek ze swojej platformy.
Postępuj zgodnie z poniższymi krokami, aby umożliwić klientom pobieranie etykiet Zonos z Twojej platformy.
1
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.
2
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.
Handlowcy Shopify
Shopify przekazuje wartość null dla person w stronie pochodzenia. W rezultacie samo orderId nie będzie działać dla handlowców Shopify — zamiast tego użyj karty Zaawansowane tworzenie wysyłki i podaj pełne szczegóły strony, w tym person.
Z Centrum Spełniania: Dodaj "fulfillmentCenter": "fulfillment_center_12345", aby określić lokalizację pochodzenia
Z Niestandardowym Śledzeniem: Ustaw "generateLabel": false i 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.
3
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.
Integracja wysyłki platformy
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 oraz towarzyszącej dokumentacji celnej.
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 wysyłać żądania do Zonos w sprawie wysyłek ze swojej platformy.
Włącz drukowanie etykiet
Postępuj zgodnie z poniższymi krokami, aby umożliwić klientom pobieranie etykiet Zonos z 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 ichcredentialTokenz 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órymlabelbędzie powiązana. Zonos zarządza tym procesem za pomocą przepływu pracy, który tworzyshipmentsilabelsw tym samym żądaniu. Podczas wykonywania tej mutacji nie musisz przekazywaćserviceLevel, ponieważ użyjemyserviceLevelużywanego zlandedCostpowiązanego zorder. DlaorderIdmożesz użyć identyfikatora zamówienia Zonos lubaccountOrderNumber, który prawdopodobnie będzie już w Twoim systemie.Gdy wysyłka i etykiety są tworzone pomyślnie, zwracamy etykiety jako
labelImage, które toBASE64_ENCODED_IMAGE, lub jakourl, 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.
Shopify przekazuje wartość null dla
personw stronie pochodzenia. W rezultacie samoorderIdnie będzie działać dla handlowców Shopify — zamiast tego użyj karty Zaawansowane tworzenie wysyłki i podaj pełne szczegóły strony, w tymperson.mutation CreateShipment($input: ShipmentCreateWorkflowInput!) {shipmentCreateWorkflow(input: $input) {idstatustrackingDetails {number}serviceLevel {idnamecarrier {idname}}shipmentCartons {idcarton {idwidthlengthheightweightitems {item {idamountdescriptionlabelurltrackingNumberiddocumentFilingOpcje zmiennych:
"fulfillmentCenter": "fulfillment_center_12345", aby określić lokalizację pochodzenia"generateLabel": falsei dodaj"trackingNumbers": ["tracking_1", "tracking_2"]"serviceLevel": "dhl.express_example", aby wybrać określoną usługę przewoźnika"isDeclaredValue": true, aby włączyć ubezpieczenie zadeklarowanej wartościZadeklarowana 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
specialServicesna 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 wszystkielabelspowiązane zshipment.mutation {shipmentStatusUpdate(input: {shipment: "shipment_f1fe4dbd-e471-49fa-94e7-84e369083223"status: VOIDEDnote: "Voiding shipment"}) {idstatus}}CartonCreateWorkflowInput ItemCreateWorkflowInput PartyCreateWorkflowInput ShipmentCreateWorkflowInput
cartonsCreateWorkflow itemCreateWorkflow partyCreateWorkflow shipmentCreateWorkflow shipmentStatusUpdate
Was this page helpful?