DOCS

Criar um envio

Landed Cost•
InícioPara provedores de logística Landed Cost Criar um envio

Criar um envio para pedidos existentes

Crie envios e etiquetas com a API Zonos após calcular os custos de importação e criar pedidos.

GraphQL

Este guia é projetado para usuários que já estão integrados com a API Zonos e precisam criar envios para pedidos existentes em seu sistema. Se você é uma plataforma de envio e deseja oferecer a criação de envios Zonos aos seus clientes, consulte nosso guia da API de Envio.

Se você está integrado com a API Zonos e aprovado para enviar fora do Dashboard, use a mutação shipmentCreateWorkflow para 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 Imposto e Taxa com uma plataforma que sincroniza automaticamente números de rastreamento com a Zonos, ou se estiver enviando diretamente através do Dashboard, essas mutações não são necessárias.

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 detalhes de itens ou partes. Ele suporta números de rastreamento opcionais, centros de atendimento, seleção de nível de serviço e seguro de valor declarado.

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"
  }
}

Com seguro de valor declarado

1
2
3
4
5
6
7
{
  "input": {
    "generateLabel": true,
    "orderId": "order_12345678-1234-1234-1234-123456789mno",
    "isDeclaredValue": true
  }
}

Valor declarado

Defina "isDeclaredValue": true para habilitar a cobertura de valor declarado para todos os itens em seu envio. Zonos automaticamente reivindica o valor total de todos os itens submetidos no pedido; os comerciantes não podem modificar esse valor. Isso define a responsabilidade máxima que a transportadora aceitará em caso de perda, dano ou roubo durante o transporte. Este recurso é suportado apenas para envios da UPS, FedEx e DHL. Zonos gerencia automaticamente a implementação específica da transportadora quando você habilita o valor declarado, incluindo os parâmetros apropriados em nossas chamadas de API para essas transportadoras, para que você não precise gerenciar diferentes requisitos de transportadoras.

Limitações da UPS: A UPS cobre apenas valores entre 100-50.000 USD e processa o valor declarado no nível da caixa. Para envios com múltiplas caixas, os comerciantes devem dividir o envio para designar a cobertura por caixa. A UPS também gera um formulário de seguro adicional que deve ser impresso com os rótulos.

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

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
  }
}

Esta página foi útil?

Agendar uma demonstração

Perguntas?

Obter suporte
© 2025 Zonoszonos.com
Nesta página:
  • Criar um envio para pedidos existentes
  • Criar envios via API
  • Anular um envio