Crear envíos a través de la API
Después de calcular un Landed Cost y crear un pedido, puedes enviar números de seguimiento y otros detalles del envío a Zonos a través de la API.
Utiliza este flujo de trabajo cuando estés creando un envío para un pedido existente y no necesites modificar los detalles del artículo o de la parte. Soporta números de seguimiento opcionales, centros de cumplimiento y selección de nivel de servicio.
Mutación
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 Básicas
1
2
3
4
5
6
{
"input": {
"generateLabel": true,
"orderId": "order_12345678-1234-1234-1234-123456789abc"
}
}
Con Centro de Cumplimiento
1
2
3
4
5
6
7
{
"input": {
"generateLabel": true,
"orderId": "order_12345678-1234-1234-1234-123456789def",
"fulfillmentCenter": "fulfillment_center_12345"
}
}
Con Seguimiento Personalizado
1
2
3
4
5
6
7
{
"input": {
"generateLabel": false,
"orderId": "order_12345678-1234-1234-1234-123456789ghi",
"trackingNumbers": ["tracking_example_1", "tracking_example_2"]
}
}
Con Nivel de Servicio
1
2
3
4
5
6
7
{
"input": {
"generateLabel": true,
"orderId": "order_12345678-1234-1234-1234-123456789jkl",
"serviceLevel": "dhl.express_example"
}
}
Anular un envío
Para cancelar una etiqueta creada, utiliza la siguiente mutación para anular el envío. Cualquier etiqueta asociada también será anulada automáticamente. Ten en cuenta que una vez que un envío es anulado, no se puede actualizar ni restaurar.
Mutación
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
}
}
Crear un envío
Crea envíos con la API de Zonos utilizando mutaciones GraphQL.
GraphQL
Si estás integrado con la API de Zonos y aprobado para enviar fuera del Dashboard, utiliza la mutación
shipmentCreateWorkflowpara crear envíos y proporcionar información de seguimiento. Estas mutaciones también te permiten informar a Zonos sobre envíos nacionales a instalaciones de cross-docking.Nota: Si estás utilizando una aplicación de Duty and Tax con una plataforma que sincroniza automáticamente los números de seguimiento a Zonos, o si estás enviando directamente a través del Dashboard, estas mutaciones no son necesarias.