DOCS

Créer un envoi

Créer un envoi

Créez des envois avec l'API Zonos en utilisant des mutations GraphQL.

GraphQL

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 des commandes et la sélection du niveau de service.

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

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 était-elle utile?