Criar um envio via API
Depois que um Landed Cost foi calculado e um pedido foi criado, você pode nos enviar números de rastreamento e outros detalhes do envio via API.
Detalhes do envio
Criar etiquetas com remessa
Use esta solicitação quando estiver informando a Zonos sobre um envio
mas não precisar de um rótulo. Você passará detalhes sobre partes
e caixas de envio
que estão vinculadas ao pedido
. Ao nos fornecer esses detalhes, poderemos saber se o pedido foi atendido parcialmente ou na íntegra.
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
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
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
}
}
}
}
Anulação de um envio
No caso de desejar cancelar um rótulo que foi criado, você pode usar a seguinte mutação para anular o envio. Se rótulos tiverem sido criados para o envio, eles também serão anulados. Uma vez que um envio tenha sido anulado, ele não pode ser atualizado.
Solicitação
1
2
3
4
5
6
7
8
9
10
11
12
mutation {
shipmentStatusUpdate(
input: {
shipment: "shipment_f1fe4dbd-e471-49fa-94e7-84e369083223"
status: VOIDED
note: "Voiding shipment"
}
) {
id
status
}
}
Criar um envio
Crie um envio com a API Zonos.GraphQL
Se você está integrado com a API Zonos e está aprovado para enviar fora do Painel, será necessário criar um envio e fornecer números de rastreamento usando a mutação
shipmentCreateWorkflow
. Você também pode usar essas mutações para informar a Zonos sobre envios domésticos para instalações de cross-docking.Se você estiver usando um aplicativo de Impostos e Taxas e enviando com uma plataforma que sincroniza números de rastreamento com a Zonos ou enviando no Painel, não será necessário usar essa mutação.