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

Criar um envio para encomendas existentes

Crie envios e etiquetas com a API da Zonos depois de calcular landed costs e criar encomendas.

GraphQL

Este guia destina-se a utilizadores já integrados com a API da Zonos que precisam de criar envios para encomendas existentes no seu sistema. Se for uma plataforma de envios e pretender oferecer a criação de envios da Zonos aos seus clientes, consulte o nosso guia da API de envios.

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

Nota: Se utilizar uma aplicação de direitos e impostos com uma plataforma que sincroniza automaticamente os números de rastreio com a Zonos, ou se enviar diretamente através do Dashboard, estas mutações não são necessárias.

Criar envios através da API 

Depois de calcular um Landed Cost e criar uma encomenda, pode enviar números de rastreio e outros detalhes do envio para a Zonos através da API.

Utilize este fluxo de trabalho quando estiver a criar um envio para uma encomenda existente e não precisar de modificar os detalhes dos artigos ou das partes. Suporta números de rastreio opcionais, centros de fulfillment, seleção do 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: Adicione "fulfillmentCenter": "fulfillment_center_12345" para especificar o local de origem
  • Com rastreio personalizado: Defina "generateLabel": false e adicione "trackingNumbers": ["tracking_1", "tracking_2"]
  • Com nível de serviço: Adicione "serviceLevel": "dhl.express_example" para selecionar um serviço específico da transportadora
  • Com seguro de valor declarado: Adicione "isDeclaredValue": true para ativar a cobertura de valor declarado

Valor declarado

Defina "isDeclaredValue": true para ativar a cobertura de valor declarado para todos os artigos do seu envio. A Zonos declara automaticamente o valor total de todos os artigos submetidos na encomenda; os comerciantes não podem modificar este montante. Isto define a responsabilidade máxima que a transportadora aceitará em caso de perda, dano ou roubo durante o trânsito. Esta funcionalidade só é suportada para envios UPS, FedEx e DHL. A Zonos trata automaticamente da implementação específica de cada transportadora quando ativa o valor declarado, incluindo os parâmetros adequados nas nossas chamadas à API destas transportadoras, pelo que não precisa de gerir os diferentes requisitos das transportadoras.

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

FedEx e DHL: processam o valor declarado ao nível do envio, sem restrições adicionais.

Serviços especiais

Utilize specialServices numa caixa para indicar requisitos de manuseamento especial para baterias, gelo seco, mercadorias perigosas ou requisitos de assinatura. Consulte o guia de serviços especiais para obter todos os detalhes e exemplos.

Anular um envio 

Para cancelar uma etiqueta criada, utilize a seguinte mutação para anular o envio. Todas as etiquetas associadas também serão anuladas automaticamente. Tenha em atenção que, depois de 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 apoio·Documentos legais·© 2026 Zonos
Nesta página:
  • Criar um envio para encomendas existentes
  • Criar envios através da API
  • Anular um envio