DOCS
Landed Cost•
InícioPara fornecedores logísticos Landed Cost Criar um Envio

Criar um envio para pedidos existentes

Crie remessas e etiquetas com a API de Zonos após calcular landed costs e criar pedidos.

GraphQL

Este guia é projetado para usuários já integrados com a API de Zonos que precisam criar remessas para pedidos existentes no seu sistema. Se for uma plataforma de envio e, em vez disso, quiser oferecer a criação de envios de Zonos para seus clientes, consulte nosso Guia da API de envio.

Se estiver integrado com a API de Zonos e tiver aprovação para enviar para fora de Dashboard, use a mutação shipmentCreateWorkflow para criar envios e fornecer informações de acompanhamento. Estas mutações também permitem informar Zonos sobre envios nacionais a centros de cross-docking.

Nota: Se você usa um aplicativo de tarifas e impostos com uma plataforma que sincroniza automaticamente os números de rastreamento com Zonos ou se envia diretamente através de Dashboard, essas mutações não são necessárias.

Criar envios através da 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 você criar um envio para um pedido existente e não precisa modificar os detalhes de artigos ou partes. Aceita números de rastreamento opcionais, centros de fulfillment, seleção de nível de serviço e seguro de valor declarado.

1mutation CreateShipment($input: ShipmentCreateWorkflowInput!) {
2 shipmentCreateWorkflow(input: $input) {
3 id
4 status
5 trackingDetails {
6 number
7 }
8 serviceLevel {
9 id
10 name
11 carrier {
12 id
13 name
14 }
15 }
16 shipmentCartons {
17 id
18 carton {
19 id
20 width
21 length
22 height
23 weight
24 items {
25 item {
26 id
27 amount
28 description
29 }
30 }
31 }
32 label {
33 url
34 trackingNumber
35 id
36 documentFiling
37 }
38 }
39 }
40}

Opções de variáveis:

  • Com centro de fulfillment: Agregue "fulfillmentCenter": "fulfillment_center_12345" para indicar a localização de origem
  • Com rastreamento personalizado: Defina "generateLabel": false e agregue "trackingNumbers": ["tracking_1", "tracking_2"]
  • Com nível de serviço: Agregue "serviceLevel": "dhl.express_example" para seleccionar um serviço específico de transportador
  • Com seguro de valor declarado: Agregue "isDeclaredValue": true para ativar a cobertura de valor declarada

Valor declarado

Defina "isDeclaredValue": true para habilitar a cobertura de valor declarada para todos os artigos de sua remessa. Zonos reclama automaticamente o valor total de todos os artigos enviados no pedido; os comerciantes não podem modificar esse valor. Isto estabelece a responsabilidade máxima que o transportador aceitará em caso de perda, dano ou roubo durante o trânsito. Esta função só é compatível com remessas de UPS, FedEx e DHL. O Zonos gere automaticamente a implementação específica do transportador quando permite o valor declarado, incluindo os parâmetros apropriados nas nossas chamadas à API a estes transportadores, pelo que não necessita de gerir diferentes requisitos de transportadores.

Limitações de UPS: UPS só cobre valores entre 100,01 e 50.000 USD e processa o valor declarado a nível de caixa. Para envios de várias caixas, os comerciantes devem dividir o envio para designar a cobertura por caixa. UPS também gera um formulário de seguro adicional (UPS Control Log) que deve ser impresso com as etiquetas para valores declarados superiores a 999 USD.

FedEx e DHL: Processam o valor declarado a nível de envio sem restrições adicionais.

Serviços especiais

Use specialServices numa caixa para indicar requisitos de manipulação especial para baterias, gelo seco, mercadorias perigosas ou requisitos de assinatura. Veja a Guia de Serviços Especiais para detalhes e exemplos completos.

Anular um envio 

Para cancelar uma etiqueta criada, use a seguinte mutação para anular o envio. As etiquetas associadas também serão automaticamente anuladas. Tenha em mente que uma vez anulado um envio, não pode ser atualizado nem restaurado.

1mutation {
2 shipmentStatusUpdate(
3 input: {
4 shipment: "shipment_12345678-1234-1234-1234-123456789stu"
5 status: VOIDED
6 note: "Voiding shipment"
7 }
8 ) {
9 id
10 status
11 }
12}
GraphQL API ReferenceTypes, inputs, and operations used in this guide
INPUTS

CartonCreateWorkflowInput ItemCreateWorkflowInput PartyCreateWorkflowInput ShipmentCreateWorkflowInput

MUTATIONS

cartonsCreateWorkflow itemCreateWorkflow partyCreateWorkflow shipmentCreateWorkflow shipmentStatusUpdate

Esta página foi útil?

Obter suporte·Documentos legais·© 2026 Zonos
Nesta página:
  • Criar um envio para pedidos existentes
  • Criar envios através da API
  • Anular um envio