Criar envios via API
Após calcular um Landed Cost e criar um pedido, você pode enviar números de rastreamento e outros detalhes do envio para Zonos através da API.
Use este fluxo de trabalho quando estiver criando um envio para um pedido existente e não precisar modificar os detalhes do item ou da parte. Ele suporta números de rastreamento opcionais, centros de atendimento e seleção de nível de serviço.
Mutação
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
}
}
}
}
Variáveis Básicas
1
2
3
4
5
6
{
"input": {
"generateLabel": true,
"orderId": "order_12345678-1234-1234-1234-123456789abc"
}
}
Com Centro de Distribuição
1
2
3
4
5
6
7
{
"input": {
"generateLabel": true,
"orderId": "order_12345678-1234-1234-1234-123456789def",
"fulfillmentCenter": "fulfillment_center_12345"
}
}
Com Rastreamento 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"]
}
}
Com Nível de Serviço
1
2
3
4
5
6
7
{
"input": {
"generateLabel": true,
"orderId": "order_12345678-1234-1234-1234-123456789jkl",
"serviceLevel": "dhl.express_example"
}
}
Anular um envio
Para cancelar um rótulo criado, use a seguinte mutação para anular o envio. Quaisquer rótulos associados também serão anulados automaticamente. Observe que, uma vez que um envio é anulado, ele não pode ser atualizado ou restaurado.
Mutação
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
}
}
Criar um envio
Crie envios com a API Zonos usando mutações GraphQL.
GraphQL
Se você está integrado com a API Zonos e aprovado para enviar fora do Dashboard, use a mutação
shipmentCreateWorkflowpara criar envios e fornecer informações de rastreamento. Essas mutações também permitem que você informe Zonos sobre envios domésticos para instalações de cross-docking.Nota: Se você estiver usando um aplicativo de Duty and Tax com uma plataforma que sincroniza automaticamente números de rastreamento com Zonos, ou se estiver enviando diretamente através do Dashboard, essas mutações não são necessárias.