DOCS

Create a shipment

/

Creare una spedizione

Creare una spedizione con l'API di Zonos.

GraphQL

Se sei integrato con l'API di Zonos e sei approvato per spedire al di fuori del Dashboard, dovrai creare una spedizione e fornire numeri di tracciamento utilizzando la mutazione shipmentCreateWorkflow. Puoi anche utilizzare queste mutazioni per informare Zonos riguardo le spedizioni domestiche verso strutture di cross-docking.

Se stai utilizzando un'app per Dazi e Tasse e spedendo con una piattaforma che sincronizza i numeri di tracciamento con Zonos o spedendo nel Dashboard, non sarà necessario utilizzare questa mutazione.

Creare una spedizione tramite l'API 

Una volta calcolato un Landed Cost e creato un ordine, puoi inviarci i numeri di tracciamento e altri dettagli della spedizione tramite l'API.

Dettagli della spedizione
Crea etichette con spedizione

Utilizza questa richiesta quando informi Zonos riguardo a una spedizione ma non hai bisogno di un'etichetta. Fornirai dettagli su parties e shipmentCartons che sono legati all'ordine. Fornendoci questi dettagli saremo in grado di sapere se l'ordine è stato evaso parzialmente o nella sua interezza.

Mutazione

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

Annullare una spedizione 

Nel caso in cui desideri annullare un'etichetta che è stata creata, puoi utilizzare la seguente mutazione per annullare la spedizione. Se sono state create etichette per la spedizione, anche queste verranno annullate. Una volta che una spedizione è stata annullata, non può essere aggiornata.

Richiesta

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

Questa pagina è stata utile?