DOCS

Opret en forsendelse

Opret en forsendelse

Opret forsendelser med Zonos API ved hjælp af GraphQL-mutationer.

GraphQL

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 og service niveau valg.

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

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?