DOCS

Opprett en forsendelse

Opprett en forsendelse

Opprett forsendelser med Zonos API ved hjelp av GraphQL-mutasjoner.

GraphQL

Hvis du er integrert med Zonos API og godkjent for å sende utenfor Dashboard, bruk shipmentCreateWorkflow-mutasjonen for å opprette forsendelser og gi sporingsinformasjon. Disse mutasjonene lar deg også informere Zonos om innenlands forsendelser til cross-docking-fasiliteter.

Merk: Hvis du bruker en avgifts- og skatteapp med en plattform som automatisk synkroniserer sporingsnumre til Zonos, eller hvis du sender direkte gjennom Dashboard, er ikke disse mutasjonene nødvendige.

Opprett forsendelser via API 

Etter å ha beregnet Landed Cost og opprettet en bestilling, kan du sende sporingsnumre og andre forsendelsesdetaljer til Zonos gjennom API-et.

Bruk dette arbeidsflyten når du oppretter en forsendelse for en eksisterende bestilling og ikke trenger å endre vare- eller partydetaljer. Den støtter valgfrie sporingsnumre, oppfyllingssentre og valg av tjenestenivå.

Mutasjon

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

Grunnleggende variabler

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

Med oppfyllingssenter

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

Med tilpasset 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 tjenestenivå

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

Annullere en forsendelse 

For å kansellere en opprettet etikett, bruk følgende mutasjon for å annullere forsendelsen. Eventuelle tilknyttede etiketter vil også bli annullert automatisk. Vær oppmerksom på at når en forsendelse er annullert, kan den ikke oppdateres eller gjenopprettes.

Mutasjon

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 siden nyttig?