DOCS
Landed Cost•
AccueilPour les prestataires logistiques Landed Cost Créer un envoi

Créer un envoi pour des commandes existantes

Créez des envois et des étiquettes avec l'API Zonos après avoir calculé les coûts d'acquittement et créé des commandes.

GraphQL

Ce guide s'adresse aux utilisateurs déjà intégrés à l'API Zonos qui doivent créer des envois pour des commandes existantes dans leur système. Si vous êtes une plateforme d'expédition et souhaitez proposer la création d'envois Zonos à vos clients à la place, consultez notre guide API Shipment.

Si vous êtes intégré à l'API Zonos et autorisé à expédier en dehors de Dashboard, utilisez la mutation shipmentCreateWorkflow pour créer des envois et fournir les informations de suivi. Ces mutations permettent également d'informer Zonos des envois domestiques vers des centres de cross-docking.

Remarque : Si vous utilisez une application Duty and Tax avec une plateforme qui synchronise automatiquement les numéros de suivi vers Zonos, ou si vous expédiez directement via Dashboard, ces mutations ne sont pas requises.

Créer des envois via l'API 

Après avoir calculé un Landed Cost et créé une commande, vous pouvez envoyer les numéros de suivi et autres détails d'envoi à Zonos via l'API.

Utilisez ce flux de travail lorsque vous créez un envoi pour une commande existante et n'avez pas besoin de modifier les détails d'articles ou de parties. Il prend en charge les numéros de suivi facultatifs, les centres de fulfillment, la sélection du niveau de service et l'assurance valeur déclarée.

1mutation CreateShipment($input: ShipmentCreateWorkflowInput!) {
2 shipmentCreateWorkflow(input: $input) {
3 id
4 status
5 trackingDetails {
6 number
7 }
8 serviceLevel {
9 id
10 name
11 carrier {
12 id
13 name
14 }
15 }
16 shipmentCartons {
17 id
18 carton {
19 id
20 width
21 length
22 height
23 weight
24 items {
25 item {
26 id
27 amount
28 description
29 }
30 }
31 }
32 label {
33 url
34 trackingNumber
35 id
36 documentFiling
37 }
38 }
39 }
40}

Options de variables :

  • Avec centre de fulfillment : Ajoutez "fulfillmentCenter": "fulfillment_center_12345" pour spécifier le lieu d'origine
  • Avec suivi personnalisé : Définissez "generateLabel": false et ajoutez "trackingNumbers": ["tracking_1", "tracking_2"]
  • Avec niveau de service : Ajoutez "serviceLevel": "dhl.express_example" pour sélectionner un service transporteur spécifique
  • Avec assurance valeur déclarée : Ajoutez "isDeclaredValue": true pour activer la couverture de valeur déclarée

Valeur déclarée

Définissez "isDeclaredValue": true pour activer la couverture de valeur déclarée pour tous les articles de votre envoi. Zonos réclame automatiquement la valeur totale de tous les articles soumis dans la commande ; les marchands ne peuvent pas modifier ce montant. Cela définit la responsabilité maximale que le transporteur acceptera en cas de perte, dommage ou vol pendant le transit. Cette fonctionnalité n'est prise en charge que pour les envois UPS, FedEx et DHL. Zonos gère automatiquement l'implémentation spécifique au transporteur lorsque vous activez la valeur déclarée, y compris les paramètres appropriés dans nos appels API à ces transporteurs, vous n'avez donc pas besoin de gérer les exigences propres à chaque transporteur.

Limitations UPS : UPS ne couvre que les valeurs comprises entre 100,01 et 50 000 USD et traite la valeur déclarée au niveau du colis. Pour les envois multi-colis, les marchands doivent diviser l'envoi pour désigner la couverture par colis. UPS génère également un formulaire d'assurance supplémentaire (UPS Control Log) qui doit être imprimé avec les étiquettes pour les valeurs déclarées supérieures à 999 USD.

FedEx et DHL : Traitent la valeur déclarée au niveau de l'envoi sans restrictions supplémentaires.

Services spéciaux

Utilisez specialServices sur un colis pour indiquer les exigences de manutention spéciale pour les batteries, la glace carbonique, les marchandises dangereuses ou les exigences de signature. Consultez le guide des services spéciaux pour tous les détails et des exemples.

Annuler un envoi 

Pour annuler une étiquette créée, utilisez la mutation suivante afin d'annuler l'envoi. Toutes les étiquettes associées seront également annulées automatiquement. Notez qu'une fois qu'un envoi est annulé, il ne peut pas être mis à jour ni restauré.

1mutation {
2 shipmentStatusUpdate(
3 input: {
4 shipment: "shipment_12345678-1234-1234-1234-123456789stu"
5 status: VOIDED
6 note: "Voiding shipment"
7 }
8 ) {
9 id
10 status
11 }
12}
GraphQL API ReferenceTypes, inputs, and operations used in this guide
INPUTS

CartonCreateWorkflowInput ItemCreateWorkflowInput PartyCreateWorkflowInput ShipmentCreateWorkflowInput

MUTATIONS

cartonsCreateWorkflow itemCreateWorkflow partyCreateWorkflow shipmentCreateWorkflow shipmentStatusUpdate

Cette page a-t-elle été utile?

Obtenir de l'aide·Documents juridiques·© 2026 Zonos
Sur cette page :
  • Créer un envoi pour des commandes existantes
  • Créer des envois via l'API
  • Annuler un envoi