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
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
{
"input": {
"generateLabel": true,
"orderId": "order_12345678-1234-1234-1234-123456789abc"
}
}
Avec Centre de Distribution
{
"input": {
"generateLabel": true,
"orderId": "order_12345678-1234-1234-1234-123456789def",
"fulfillmentCenter": "fulfillment_center_12345"
}
}
Avec suivi personnalisé
{
"input": {
"generateLabel": false,
"orderId": "order_12345678-1234-1234-1234-123456789ghi",
"trackingNumbers": ["tracking_example_1", "tracking_example_2"]
}
}
Avec niveau de service
{
"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
mutation {
shipmentStatusUpdate(
input: {
shipment: "shipment_12345678-1234-1234-1234-123456789stu"
status: VOIDED
note: "Voiding shipment"
}
) {
id
status
}
}
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.