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:
Faturamento de taxas e impostos de terceiros - Garantiremos que você ou o número da conta da operadora do seu comerciante seja usado para despesas de envio enquanto as contas de impostos e taxas chegam a Zonos.
Flexibilidade - Em vez de realizar trabalho de desenvolvimento para garantir que você possa gerar rótulos de conformidade com sua plataforma, integre-se ao nosso API e deixe a conformidade transfronteiriça em constante mudança conosco.
Documentação alfandegária precisa - Quando você usa Zonos para gerar etiquetas, garantimos que os detalhes corretos sejam repassados à transportadora para garantir que o pacote passe pela alfândega rapidamente.
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.
Siga as etapas abaixo para permitir que seus clientes recuperem rótulos Zonos de sua plataforma.
1
Permitir credenciais API
O Zonos API é acessível por um credentialToken. Sua plataforma precisará oferecer aos clientes a capacidade de inserir seus credentialToken do Zonos Dashboard em sua plataforma. A partir daqui, você poderá fazer solicitações a Zonos em nome deles.
2
Criar uma remessa
Para recuperar um label, você deverá criar um shipment ao qual o label estará associado. Zonos gerencia esse processo com um fluxo de trabalho que cria shipments e labels na mesma solicitação. Ao realizar esta mutação, você não precisa passar por um serviceLevel como usaremos o serviceLevel usado desde o landedCost que está vinculado ao order. Para o orderId, você pode usar o ID do pedido Zonos ou o accountOrderNumber que provavelmente já estará em seu sistema.
Quando uma remessa e etiquetas forem criadas com sucesso, devolveremos as etiquetas como um labelImage que é um BASE64_ENCODED_IMAGE, ou como um url de 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 parte. 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.
Comerciantes do Shopify
Shopify passa um valor nulo para person na parte de origem. Como resultado, orderId por si só não funcionará para comerciantes do Shopify - use a Criação avançada de remessa em vez disso e forneça detalhes completos da parte, incluindo person.
Com Centro de Cumprimento: Adicionar "fulfillmentCenter": "fulfillment_center_12345" para especificar o local de origem
Com rastreamento personalizado: Definir "generateLabel": false e 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": true para permitir a cobertura do valor declarado
Com serviços especiais: Veja o guia de serviços especiais para baterias, gelo seco, mercadorias perigosas e opções de assinatura.
Valor declarado
Definir "isDeclaredValue": true para 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
Usar specialServices em uma caixa para indicar requisitos especiais de manuseio para baterias, gelo seco, mercadorias perigosas ou requisitos de assinatura. Veja o guia de serviços especiais para 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 no Zonos Dashboard. As remessas de caixa única não são afetadas.
3
Anular uma remessa
Caso um cliente queira anular um shipment, você pode usar a seguinte mutação que anulará todos os labels amarrados ao shipment.
Integração de remessa de plataforma
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.
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 um
credentialToken. Sua plataforma precisará oferecer aos clientes a capacidade de inserir seuscredentialTokendo Zonos Dashboard em sua plataforma. A partir daqui, você poderá fazer solicitações a Zonos em nome deles.Criar uma remessa
Para recuperar um
label, você deverá criar umshipmentao qual olabelestará associado. Zonos gerencia esse processo com um fluxo de trabalho que criashipmentselabelsna mesma solicitação. 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 oaccountOrderNumberque provavelmente já estará em seu sistema.Quando uma remessa e etiquetas forem criadas com sucesso, devolveremos as etiquetas como um
labelImageque é 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 parte. 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.
Shopify passa um valor nulo para
personna parte de origem. Como resultado,orderIdpor si só não funcionará para comerciantes do Shopify - use a Criação avançada de remessa em vez disso e forneça detalhes completos da parte, incluindoperson.mutation CreateShipment($input: ShipmentCreateWorkflowInput!) {shipmentCreateWorkflow(input: $input) {idstatustrackingDetails {number}serviceLevel {idnamecarrier {idname}}shipmentCartons {idcarton {idwidthlengthheightweightitemsitemidamountdescriptionlabelurltrackingNumberiddocumentFilingOpções variáveis:
"fulfillmentCenter": "fulfillment_center_12345"para especificar o local de origem"generateLabel": falsee adicione"trackingNumbers": ["tracking_1", "tracking_2"]"serviceLevel": "dhl.express_example"para selecionar um serviço de operadora específico"isDeclaredValue": truepara permitir a cobertura do valor declaradoValor 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
Usar
specialServicesem uma caixa para indicar requisitos especiais de manuseio para baterias, gelo seco, mercadorias perigosas ou requisitos de assinatura. Veja o guia de serviços especiais para 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 no Zonos Dashboard. As remessas de caixa única não são afetadas.
Anular uma remessa
Caso um cliente queira anular um
shipment, você pode usar a seguinte mutação que anulará todos oslabelsamarrados aoshipment.mutation {shipmentStatusUpdate(input: {shipment: "shipment_f1fe4dbd-e471-49fa-94e7-84e369083223"status: VOIDEDnote: "Voiding shipment"}) {idstatus}}CartonCreateWorkflowInput ItemCreateWorkflowInput PartyCreateWorkflowInput ShipmentCreateWorkflowInput
cartonsCreateWorkflow itemCreateWorkflow partyCreateWorkflow shipmentCreateWorkflow shipmentStatusUpdate
Esta página foi útil?