Ativar impressão de etiquetas
Siga as etapas abaixo para permitir que seus clientes recuperem rótulos Zonos de sua plataforma.
Permitir credenciais API
O Zonos APIé acessível por umcredentialToken. Sua plataforma precisará oferecer aos clientes a capacidade de inserir seuscredentialTokendo Zonos Dashboardem sua plataforma. A partir daqui, você poderá fazer solicitações a Zonos em nome deles.
Criar uma remessa
Para recuperar umlabel, você deverá criar umshipmentque olabelestará associado. Zonos gerencia esse processo com um fluxo de trabalho que criashipmentselabelsno mesmo pedido. Ao realizar esta mutação, você não precisa passar por umserviceLevelcomo usaremos oserviceLevelusado desde olandedCostque está vinculado aoorder. Para oorderId, você pode usar o ID do pedido Zonos ou oaccountOrderNumberisso provavelmente já estará em seu sistema.
Quando uma remessa e etiquetas forem criadas com sucesso, devolveremos as etiquetas como umlabelImageque é umBASE64_ENCODED_IMAGE, ou como umurlde onde o rótulo pode ser obtido.
Use esse fluxo de trabalho ao criar uma remessa para um pedido existente e não precisar modificar detalhes do item ou da festa. Ele oferece suporte a números de rastreamento opcionais, centros de distribuição, 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 documentFilingOpções variáveis:
- **Com Centro de Cumprimento:**Adicionar
"fulfillmentCenter": "fulfillment_center_12345"para especificar o local de origem - **Com rastreamento personalizado:**Definir
"generateLabel": falsee adicione"trackingNumbers": ["tracking_1", "tracking_2"] - **Com nível de serviço:**Adicionar
"serviceLevel": "dhl.express_example"para selecionar um serviço de operadora específico - **Com Seguro de Valor Declarado:**Adicionar
"isDeclaredValue": truepara permitir a cobertura do valor declarado - **Com serviços especiais:**Veja o guia de serviços especiaispara baterias, gelo seco, mercadorias perigosas e opções de assinatura.
Valor declarado
Definir"isDeclaredValue": truepara permitir a cobertura do valor declarado para todos os itens da sua remessa. Zonos reivindica automaticamente o valor total de todos os itens enviados no pedido; os comerciantes não podem modificar esse valor. Isto define a responsabilidade máxima que a transportadora aceitará em caso de perda, dano ou roubo durante o transporte. Este recurso é compatível apenas com remessas UPS, FedEx e DHL. Zonos lida automaticamente com a implementação específica da operadora quando você habilita o valor declarado, incluindo os parâmetros apropriados em nossas chamadas API para essas operadoras, para que você não precise gerenciar requisitos de operadoras diferentes.
Limitações do UPS: A UPS cobre apenas valores entre 100-50.000 USD e processa o valor declarado no nível da caixa. Para remessas com várias caixas, os comerciantes devem dividir a remessa para designar a cobertura por caixa. A UPS também gera um formulário de seguro adicional que deve ser impresso junto com as etiquetas.
FedEx e DHL: Processar o valor declarado no nível da remessa sem restrições adicionais.
Serviços especiais
UsarspecialServicesem uma caixa para indicar requisitos especiais de manuseio para baterias, gelo seco, mercadorias perigosas ou requisitos de assinatura. Veja o guia de serviços especiaispara detalhes completos e exemplos.
Desbloqueio de UPS ShipStation: Envios de várias peças não são suportados. Quando um pedido é enviado em várias caixas, o campo de referência é duplicado, fazendo com que a correspondência do número do pedido falhe no back-end. Os comerciantes que precisam de remessas de várias peças devem criar a etiqueta em Zonos Dashboard. As remessas de caixa única não são afetadas.
Anular uma remessa
Caso um cliente queira anular umshipment, você pode usar a seguinte mutação que anulará todoslabelsamarrado aoshipment.
mutation { shipmentStatusUpdate( input: { shipment: "shipment_f1fe4dbd-e471-49fa-94e7-84e369083223" status: VOIDED note: "Voiding shipment" } ) { id status }}
Crie remessas a partir da sua plataforma
Dê aos clientes a capacidade de criar remessas e etiquetas Zonos a partir de sua plataforma.
Este guia foi desenvolvido para desenvolvedores de plataformas de remessa que desejam integrar recursos de criação de remessas Zonos em sua plataforma para seus clientes. Se você já estiver usando o Zonos API e precisar apenas criar remessas para pedidos existentes, consulte nosso guia de criação de remessa.
Se você é uma plataforma de remessa que oferece suporte a clientes Zonos que enviam remessas internacionais, a integração com Zonos para a criação de remessas deve ser uma consideração importante. Isso permitirá que você ofereça a experiência mais integrada para seus comerciantes e seus clientes, aproveitando os recursos existentes da sua plataforma e permitindo que Zonos gerencie a criação da remessa, etiqueta e documentação alfandegária de apoio.
As vantagens de usar Zonos para criar remessas incluem:
Este guia orientará você nas etapas para implementar uma integração completa de ponta a ponta que permitirá que você ligue para Zonos para remessas de sua plataforma.