Skapa försändelser via API
Efter att ha beräknat en Landed Cost och skapat en beställning kan du skicka spårningsnummer och andra försändelsedetaljer till Zonos genom API:et.
Använd detta arbetsflöde när du skapar en försändelse för en befintlig beställning och inte behöver ändra artikel- eller partydetaljer. Det stöder valfria spårningsnummer, uppfyllandecenter, val av tjänstenivå och deklarerad värdeförsäkring.
Mutation
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
}
}
}
}
Grundläggande variabler
{
"input": {
"generateLabel": true,
"orderId": "order_12345678-1234-1234-1234-123456789abc"
}
}
Med uppfyllningscenter
{
"input": {
"generateLabel": true,
"orderId": "order_12345678-1234-1234-1234-123456789def",
"fulfillmentCenter": "fulfillment_center_12345"
}
}
Med anpassad spårning
{
"input": {
"generateLabel": false,
"orderId": "order_12345678-1234-1234-1234-123456789ghi",
"trackingNumbers": ["tracking_example_1", "tracking_example_2"]
}
}
Med servicenivå
{
"input": {
"generateLabel": true,
"orderId": "order_12345678-1234-1234-1234-123456789jkl",
"serviceLevel": "dhl.express_example"
}
}
Med deklarerad värdeförsäkring
{
"input": {
"generateLabel": true,
"orderId": "order_12345678-1234-1234-1234-123456789mno",
"isDeclaredValue": true
}
}
Deklarerat värde
Ställ in "isDeclaredValue": true för att aktivera täckning för deklarerat värde för alla artiklar i din försändelse. Zonos gör automatiskt anspråk på det fulla värdet av alla artiklar som skickas in i beställningen; handlare kan inte ändra detta belopp. Detta sätter det maximala ansvar som transportören kommer att acceptera 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 transportörspecifik implementering när du aktiverar deklarerat värde, inklusive de lämpliga parametrarna i våra API-anrop till dessa transportörer, så du behöver inte hantera olika transportörers krav.
UPS begränsningar: UPS täcker endast värden mellan 100-50,000 USD och behandlar deklarerat värde på kartonnivå. För fler-kartong försändelser 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 som måste skrivas ut med etiketterna.
FedEx och DHL: Behandlar deklarerat värde på försändelsenivå utan ytterligare begränsningar.
Ogiltigförklara en försändelse
För att avbryta en skapad etikett, använd följande mutation för att ogiltigförklara försändelsen. Eventuella associerade etiketter kommer också att ogiltigförklaras automatiskt. Observera att när en försändelse har ogiltigförklarats kan den inte uppdateras eller återställas.
Mutation
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 beställningar
Skapa försändelser och etiketter med Zonos API efter att ha beräknat landed costs och skapat beställningar.
GraphQL
Denna guide är utformad för användare som redan är integrerade med Zonos API och behöver skapa försändelser för befintliga beställningar i sitt system. Om du är en fraktplattform och vill erbjuda Zonos försändelseskapande till dina kunder istället, se vår Försändelse API-guide.
Om du är integrerad med Zonos API och godkänd för att skicka utanför Dashboard, använd
shipmentCreateWorkflow-mutation för att skapa försändelser och tillhandahålla spårningsinformation. Dessa mutationer tillåter dig också att informera Zonos om inhemska försändelser till cross-docking-anläggningar.Obs: Om du använder en Duty and Tax-app med en plattform som automatiskt synkroniserar spårningsnummer till Zonos, eller om du skickar direkt genom Dashboard, krävs inte dessa mutationer.