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 seguimento opcionais, centros de fulfillment, seleção de nível de serviço e seguro de valor declarado.
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 } } }}Opções de variáveis:
- Com centro de fulfillment: Agregue
"fulfillmentCenter": "fulfillment_center_12345"para indicar a localização de origem - Com seguimento personalizado: Defina
"generateLabel": falsee 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 certeza de valor declarado:** Agregue
"isDeclaredValue": truepara activar a cobertura de valor declarada
Valor declarado
Definir "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 cartão. Para envios de vários cartões, os comerciantes devem dividir o envio para designar a cobertura por cartão. 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: Procesam o valor declarado a nível de envio sem restrições adicionais.
Serviços especiais
Use specialServices num cartão 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 marca criada, use a seguinte mutação para anular o envio. As marcas associadas também serão automaticamente anuladas. Tenha em mente que uma vez anulado um envio, não pode ser atualizado nem restaurado.
mutation { shipmentStatusUpdate( input: { shipment: "shipment_12345678-1234-1234-1234-123456789stu" status: VOIDED note: "Voiding shipment" } ) { id status }}
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 quiser oferecer a criação de envios de Zonos para seus clientes, consulte nossa 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
shipmentCreateWorkflowPara 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 uma 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.