DOCS

Créer un envoi

Landed Cost•
AccueilPour les fournisseurs de logistique 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'acheminement et créé des commandes.

GraphQL

Ce guide est conçu pour les utilisateurs qui sont déjà intégrés à l'API Zonos et qui ont besoin de créer des envois pour des commandes existantes dans leur système. Si vous êtes une plateforme d'expédition et souhaitez offrir la création d'envois Zonos à vos clients, consultez notre guide API d'envoi.

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

Remarque : Si vous utilisez une application de droits et taxes avec une plateforme qui synchronise automatiquement les numéros de suivi avec Zonos, ou si vous expédiez directement via le Dashboard, ces mutations ne sont pas nécessaires.

Créer des envois via l'API 

Après avoir calculé un Landed Cost et créé une commande, vous pouvez envoyer des numéros de suivi et d'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 que vous n'avez pas besoin de modifier les détails des articles ou des parties. Il prend en charge les numéros de suivi optionnels, les centres de traitement, la sélection du niveau de service et l'assurance de valeur déclarée.

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

Variables de base

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

Avec Centre de Distribution

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

Avec suivi personnalisé

1
2
3
4
5
6
7
{
  "input": {
    "generateLabel": false,
    "orderId": "order_12345678-1234-1234-1234-123456789ghi",
    "trackingNumbers": ["tracking_example_1", "tracking_example_2"]
  }
}

Avec niveau de service

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

Avec assurance de valeur déclarée

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

Valeur déclarée

Définissez "isDeclaredValue": true pour activer la couverture de valeur déclarée pour tous les articles de votre expédition. Zonos revendique automatiquement la pleine valeur de tous les articles soumis dans la commande ; les commerçants ne peuvent pas modifier ce montant. Cela fixe la responsabilité maximale que le transporteur acceptera en cas de perte, de dommage ou de vol pendant le transport. Cette fonctionnalité n'est prise en charge que pour les expéditions UPS, FedEx et DHL. Zonos gère automatiquement la mise en œuvre 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, afin que vous n'ayez pas à gérer les exigences différentes des transporteurs.

Limitations d'UPS : UPS ne couvre que les valeurs comprises entre 100 et 50 000 USD et traite la valeur déclarée au niveau du carton. Pour les expéditions multi-cartons, les commerçants doivent diviser l'expédition pour désigner la couverture par carton. UPS génère également un formulaire d'assurance supplémentaire qui doit être imprimé avec les étiquettes.

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

Annuler un envoi 

Pour annuler une étiquette créée, utilisez la mutation suivante pour 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 ou restauré.

Mutation

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

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

Réserver une démo

Des questions?

Obtenir de l'aide
© 2025 Zonoszonos.com
Sur cette page :
  • Créer un envoi pour des commandes existantes
  • Créer des envois via l'API
  • Annuler un envoi