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.
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
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
mutation {
shipmentStatusUpdate(
input: {
shipment: "shipment_f1fe4dbd-e471-49fa-94e7-84e369083223"
status: VOIDED
note: "Voiding shipment"
}
) {
id
status
}
}
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.