DOCS

Create a shipment

/

Créer un envoi

Créez un envoi avec l'API Zonos.

GraphQL

Si vous êtes intégré à l'API Zonos et que vous êtes approuvé pour expédier en dehors du tableau de bord, vous devrez créer un envoi et fournir des numéros de suivi en utilisant la mutation shipmentCreateWorkflow. Vous pouvez également utiliser ces mutations pour informer Zonos des envois nationaux vers des installations de cross-docking.

Si vous utilisez une application de droits et taxes et que vous expédiez avec une plateforme qui synchronise les numéros de suivi avec Zonos ou que vous expédiez dans le tableau de bord, vous n'aurez pas besoin d'utiliser cette mutation.

Créer un envoi via l'API 

Une fois que le Landed Cost a été calculé et qu'une commande a été créée, vous pouvez nous envoyer les numéros de suivi et d'autres détails d'expédition via l'API.

Détails de l'envoi
Créer des étiquettes avec expédition

Utilisez cette demande lorsque vous informez Zonos d'un envoi mais que vous n'avez pas besoin d'une étiquette. Vous transmettrez des détails sur les parties et les colis d'expédition liés à la commande. En nous fournissant ces détails, nous saurons si la commande a été exécutée partiellement ou entièrement.

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

Annulation d'un envoi 

Dans le cas où vous souhaitez annuler une étiquette qui a été créée, vous pouvez utiliser la mutation suivante pour annuler l'envoi. Si des étiquettes ont été créées pour l'envoi, elles seront également annulées. Une fois qu'un envoi a été annulé, il ne peut pas être mis à jour.

Demande

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

Cette page était-elle utile?


Des questions ?

Contactez-nous.