DOCS

Skapa en försändelse

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.

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

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
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

1
2
3
4
5
6
{
  "input": {
    "generateLabel": true,
    "orderId": "order_12345678-1234-1234-1234-123456789abc"
  }
}

Med uppfyllningscenter

1
2
3
4
5
6
7
{
  "input": {
    "generateLabel": true,
    "orderId": "order_12345678-1234-1234-1234-123456789def",
    "fulfillmentCenter": "fulfillment_center_12345"
  }
}

Med anpassad spårning

1
2
3
4
5
6
7
{
  "input": {
    "generateLabel": false,
    "orderId": "order_12345678-1234-1234-1234-123456789ghi",
    "trackingNumbers": ["tracking_example_1", "tracking_example_2"]
  }
}

Med servicenivå

1
2
3
4
5
6
7
{
  "input": {
    "generateLabel": true,
    "orderId": "order_12345678-1234-1234-1234-123456789jkl",
    "serviceLevel": "dhl.express_example"
  }
}

Med deklarerad värdeförsäkring

1
2
3
4
5
6
7
{
  "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

1
2
3
4
5
6
7
8
9
10
11
12
mutation {
  shipmentStatusUpdate(
    input: {
      shipment: "shipment_12345678-1234-1234-1234-123456789stu"
      status: VOIDED
      note: "Voiding shipment"
    }
  ) {
    id
    status
  }
}

Var den här sidan till hjälp?