Skapa försändelser via API
Efter att ha beräknat en Landed Cost och skapat en order kan ni skicka spårningsnummer och andra försändelsedetaljer till Zonos via API.
Använd det här flödet när ni skapar en försändelse för en befintlig order och inte behöver ändra artikel- eller party-detaljer. Det stöder valfria spårningsnummer, fulfillment centers, val av servicenivå och försäkran om deklarerat värde.
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 } } }}Variabelalternativ:
- Med fulfillment center: Lägg till
"fulfillmentCenter": "fulfillment_center_12345"för att ange ursprungsplatsen - Med egen spårning: Sätt
"generateLabel": falseoch lägg till"trackingNumbers": ["tracking_1", "tracking_2"] - Med servicenivå: Lägg till
"serviceLevel": "dhl.express_example"för att välja en specifik transportörstjänst - Med försäkran om deklarerat värde: Lägg till
"isDeclaredValue": trueför att aktivera täckning för deklarerat värde
Deklarerat värde
Sätt "isDeclaredValue": true för att aktivera täckning för deklarerat värde för alla artiklar i er försändelse. Zonos gör automatiskt anspråk på det fulla värdet av alla artiklar som skickats in i ordern; handlare kan inte ändra detta belopp. Detta sätter det maximala ansvar som transportören accepterar vid förlust, skada eller stöld under transport. Denna funktion stöds endast för UPS-, FedEx- och DHL-försändelser. Zonos hanterar automatiskt den transportörsspecifika implementeringen när ni aktiverar deklarerat värde, inklusive lämpliga parametrar i våra API-anrop till dessa transportörer, så ni behöver inte hantera olika transportörskrav.
UPS-begränsningar: UPS täcker endast värden mellan 100,01–50 000 USD och behandlar deklarerat värde på kartongnivå. För försändelser med flera kartonger måste handlare dela upp försändelsen för att ange täckning per kartong. UPS genererar också ett ytterligare försäkringsformulär (UPS Control Log) som måste skrivas ut med etiketterna för deklarerade värden över 999 USD.
FedEx och DHL: Behandlar deklarerat värde på försändelsenivå utan ytterligare begränsningar.
Specialtjänster
Använd specialServices på en kartong för att ange särskilda hanteringskrav för batterier, torr-is, farligt gods eller signaturkrav. Se guiden för specialtjänster för fullständiga detaljer och exempel.
Annullera en försändelse
För att avbryta en skapad etikett, använd följande mutation för att annullera försändelsen. Eventuella associerade etiketter annulleras också automatiskt. Observera att när en försändelse har annullerats kan den inte uppdateras eller återställas.
mutation { shipmentStatusUpdate( input: { shipment: "shipment_12345678-1234-1234-1234-123456789stu" status: VOIDED note: "Voiding shipment" } ) { id status }}
Skapa en försändelse för befintliga ordrar
Skapa försändelser och etiketter med Zonos API efter att ha beräknat landed costs och skapat ordrar.
GraphQL
Den här guiden är avsedd för användare som redan är integrerade med Zonos API och behöver skapa försändelser för befintliga ordrar i sitt system. Om ni är en fraktplattform och vill erbjuda Zonos försändelseskapande till era kunder i stället, se vår Shipment API-guide.
Om ni är integrerade med Zonos API och godkända att skicka utanför Dashboard, använd mutationen
shipmentCreateWorkflowför att skapa försändelser och lämna spårningsinformation. Dessa mutationer låter er också informera Zonos om inrikesförsändelser till cross-docking-anläggningar.Obs: Om ni använder en Duty and Tax-app med en plattform som automatiskt synkar spårningsnummer till Zonos, eller om ni skickar direkt via Dashboard, krävs inte dessa mutationer.