Twórz przesyłki za pośrednictwem API
Po obliczeniu kosztu przywozowego i utworzeniu zamówienia możesz wysłać numery śledzenia i inne szczegóły przesyłki do Zonos za pośrednictwem API.
Użyj tego przepływu pracy, gdy tworzysz przesyłkę dla istniejącego zamówienia i nie musisz modyfikować szczegółów elementów ani stron. Obsługuje opcjonalne numery śledzenia, centra fulfillment, wybór poziomu serwisu i ubezpieczenie deklarowanej 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 documentFiling } } }}Opcje zmiennych:
- Z Centrum Fulfillment: Dodaj
"fulfillmentCenter": "fulfillment_center_12345"aby określić lokalizację pochodzenia - Z niestandardowym śledzeniem: Ustaw
"generateLabel": falsei dodaj"trackingNumbers": ["tracking_1", "tracking_2"] - Z poziomem serwisu: Dodaj
"serviceLevel": "dhl.express_example"aby wybrać konkretny serwis operatora - Z ubezpieczeniem deklarowanej wartości: Dodaj
"isDeclaredValue": trueaby włączyć ubezpieczenie deklarowanej wartości
Wartość deklarowana
Ustaw "isDeclaredValue": true aby włączyć ubezpieczenie deklarowanej wartości dla wszystkich elementów w przesyłce. Zonos automatycznie zgłasza pełną wartość wszystkich elementów przesłanych w zamówieniu; handlowcy nie mogą modyfikować tej kwoty. To ustawia maksymalną odpowiedzialność, którą operator zaakceptuje w przypadku utraty, uszkodzenia lub kradzieży podczas transportu. Ta funkcja jest obsługiwana tylko dla przesyłek UPS, FedEx i DHL. Zonos automatycznie obsługuje wdrożenie specyficzne dla operatora, gdy włączysz wartość deklarowaną, w tym odpowiednie parametry w naszych połączeniach API z tymi operatorami, więc nie musisz zarządzać różnymi wymaganiami operatora.
Ograniczenia UPS: UPS pokrywa tylko wartości między 100,01-50 000 USD i przetwarza wartość deklarowaną na poziomie kartonu. W przypadku przesyłek wielokartonowych handlowcy muszą podzielić przesyłkę, aby wskazać pokrycie na karton. UPS generuje również dodatkowy formularz ubezpieczenia (UPS Control Log), który musi być wydrukowany razem z etykietami dla wartości deklarowanych powyżej 999 USD.
FedEx i DHL: Przetwarzają wartość deklarowaną na poziomie przesyłki bez dodatkowych ograniczeń.
Usługi specjalne
Użyj specialServices na kartonie, aby wskazać specjalne wymagania dotyczące obsługi baterii, suchego lodu, towarów niebezpiecznych lub wymagań podpisu. Aby uzyskać pełne szczegóły i przykłady, zapoznaj się z przewodnikiem usług specjalnych.
Anuluj przesyłkę
Aby anulować utworzoną etykietę, użyj następującej mutacji, aby unieważnić przesyłkę. Wszystkie powiązane etykiety będą również automatycznie unieważnione. Pamiętaj, że po unieważnieniu przesyłki nie można jej aktualizować ani przywracać.
mutation { shipmentStatusUpdate( input: { shipment: "shipment_12345678-1234-1234-1234-123456789stu" status: VOIDED note: "Voiding shipment" } ) { id status }}
Utwórz przesyłkę dla istniejących zamówień
Twórz przesyłki i etykiety za pomocą API Zonos po obliczeniu kosztów przywozowych i utworzeniu zamówień.
GraphQL
Ten przewodnik jest przeznaczony dla użytkowników już zintegrowanych z API Zonos, którzy muszą tworzyć przesyłki dla istniejących zamówień w swoim systemie. Jeśli jesteś platformą wysyłkową i chcesz oferować tworzenie przesyłek Zonos swoim klientom, zamiast tego zobacz nasz przewodnik po API przesyłek.
Jeśli jesteś zintegrowany z API Zonos i masz zatwierdzenie do wysyłania poza Dashboard, użyj mutacji
shipmentCreateWorkflowdo tworzenia przesyłek i dostarczenia informacji śledzenia. Te mutacje pozwalają również powiadomić Zonos o przesyłkach krajowych do urządzeń cross-dockingowych.Uwaga: Jeśli używasz aplikacji Duty and Tax z platformą, która automatycznie synchronizuje numery śledzenia z Zonos, lub wysyłasz bezpośrednio za pośrednictwem Dashboard, te mutacje nie są wymagane.