DOCS

Create a shipment

/

Opret en forsendelse

Opret en forsendelse med Zonos API.

GraphQL

Hvis du er integreret med Zonos API'et og er godkendt til at sende uden for Dashboard, skal du oprette en forsendelse og angive sporingsnumre ved hjælp af shipmentCreateWorkflow mutation. Du kan også bruge disse mutationer til at informere Zonos om indenlandske forsendelser til cross-docking faciliteter.

Hvis du bruger en told- og skatteapp og sender med en platform, der synkroniserer sporingsnumre til Zonos eller sender i Dashboard, behøver du ikke at bruge denne mutation.

Opret en forsendelse via API'et 

Når en Landed Cost er blevet beregnet, og en ordre er blevet oprettet, kan du sende os sporingsnumre og andre forsendelsesdetaljer via API'et.

Brug denne anmodning, når du informerer Zonos om en forsendelse, men ikke har brug for en label. Du vil videregive oplysninger om parties og shipmentCartons, der er knyttet til ordren. Ved at give os disse oplysninger vil vi være i stand til at vide, om ordren er blevet opfyldt delvist eller i sin helhed.

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
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
mutation {
  partyCreateWorkflow(
    input: [
      {
        location: {
          administrativeArea: "Utah"
          administrativeAreaCode: "UT"
          countryCode: US
          line1: "123 Test Street"
          locality: "St George"
          postalCode: "84770"
        }
        person: { companyName: "test Corp", phone: "8018565714" }
        type: ORIGIN
      }
      {
        location: {
          administrativeArea: "Quebec"
          administrativeAreaCode: "QC"
          countryCode: CA
          line1: "2147 Pitfield Blvd"
          locality: "Pierrefonds"
          postalCode: "H9H 3C7"
        }
        person: {
          email: "test@gmail.com"
          firstName: "firstName"
          lastName: "lastName"
          phone: "5022303021"
          companyName: "goProTest"
          metadata: { key: "key", value: "value" }
        }
        type: DESTINATION
      }
    ]
  ) {
    type
    id
    organization
  }
  shipmentCreateWorkflow(
    input: {
      trackingNumber: "test_tracking_num_5"
      orderId: "order_c535c9c8-88a1-4dde-b938-7dd7f776beee"
      serviceLevel: "service_level_720198b0-43ce-409e-a5bb-0c6e91a43fad"
      shipmentCartons: [
        {
          dimensionalUnit: "INCH"
          length: 10
          width: 10
          height: 10
          weightUnit: "POUND"
          weight: 10
          trackingNumber: "1234567890"
          items: [{ itemReference: "someothersku4345" }]
        }
      ]
    }
  ) {
    id
    status
    tracking {
      id
      number
    }
    shipmentCartons {
      id
      tracking {
        number
      }
      carton {
        id
        length
        width
        height
        dimensionalUnit
        weight
        weightUnit
      }
    }
  }
}

Annullering af en forsendelse 

I tilfælde af at du ønsker at annullere en label, der er blevet oprettet, kan du bruge følgende mutation til at annullere forsendelsen. Hvis der er blevet oprettet labels for forsendelsen, vil de også blive annulleret. Når en forsendelse er blevet annulleret, kan den ikke opdateres.

Anmodning

1
2
3
4
5
6
7
8
9
10
11
12
mutation {
  shipmentStatusUpdate(
    input: {
      shipment: "shipment_f1fe4dbd-e471-49fa-94e7-84e369083223"
      status: VOIDED
      note: "Voiding shipment"
    }
  ) {
    id
    status
  }
}

Var denne side nyttig?