DOCS

Opret en forsendelse

Opret en forsendelse for eksisterende ordrer

Opret forsendelser og etiketter med Zonos API efter at have beregnet landed costs og oprettet ordrer.

GraphQL

Denne guide er designet til brugere, der allerede er integreret med Zonos API og har brug for at oprette forsendelser for eksisterende ordrer i deres system. Hvis du er en forsendelsesplatform og ønsker at tilbyde Zonos forsendelsesoprettelse til dine kunder i stedet, se vores Forsendelses-API-guide.

Hvis du er integreret med Zonos API og godkendt til at sende uden for Dashboard, skal du bruge shipmentCreateWorkflow-mutation til at oprette forsendelser og give sporingsinformation. Disse mutationer giver dig også mulighed for at informere Zonos om indenlandske forsendelser til cross-docking faciliteter.

Bemærk: Hvis du bruger en told- og skatteapp med en platform, der automatisk synkroniserer sporingsnumre til Zonos, eller hvis du sender direkte gennem Dashboard, er disse mutationer ikke nødvendige.

Opret forsendelser via API 

Efter at have beregnet en Landed Cost og oprettet en ordre, kan du sende sporingsnumre og andre forsendelsesdetaljer til Zonos gennem API'en.

Brug dette workflow, når du opretter en forsendelse for en eksisterende ordre og ikke har brug for at ændre vare- eller partydetaljer. Det understøtter valgfrie sporingsnumre, opfyldelsescentre, service niveau valg og erklæret værdi forsikring.

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
      }
    }
  }
}

Basisvariabler

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

Med Opfyldelsescenter

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

Med brugerdefineret sporing

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 serviceniveau

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

Med erklæret værdi forsikring

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

Erklæret værdi

Sæt "isDeclaredValue": true for at aktivere dækning af erklæret værdi for alle varer i din forsendelse. Zonos kræver automatisk den fulde værdi af alle varer, der er indsendt i ordren; handlende kan ikke ændre dette beløb. Dette sætter den maksimale ansvarlighed, som transportøren vil acceptere i tilfælde af tab, skade eller tyveri under transport. Denne funktion understøttes kun for UPS, FedEx og DHL forsendelser. Zonos håndterer automatisk den transportør-specifikke implementering, når du aktiverer erklæret værdi, herunder de relevante parametre i vores API-opkald til disse transportører, så du ikke behøver at håndtere forskellige transportørkrav.

UPS begrænsninger: UPS dækker kun værdier mellem 100-50.000 USD og behandler erklæret værdi på kartonniveau. For forsendelser med flere kartoner skal handlende opdele forsendelsen for at angive dækning pr. karton. UPS genererer også en ekstra forsikringsformular, der skal printes sammen med etiketterne.

FedEx og DHL: Behandler erklæret værdi på forsendelsesniveau uden yderligere restriktioner.

Annuller en forsendelse 

For at annullere en oprettet etiket, brug følgende mutation til at annullere forsendelsen. Eventuelle tilknyttede etiketter vil også blive annulleret automatisk. Bemærk, at når en forsendelse er annulleret, kan den ikke opdateres eller gendannes.

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 denne side nyttig?