Dê aos clientes a possibilidade de criar envios e etiquetas Zonos a partir da sua plataforma.
Este guia destina-se a programadores de plataformas de envio que pretendam integrar as funcionalidades de criação de envios da Zonos na sua plataforma, para os seus clientes. Se já utiliza a API da Zonos e só precisa de criar envios para encomendas existentes, consulte antes o nosso guia de criação de envios.
Se é uma plataforma de envio que dá suporte a clientes Zonos que fazem envios internacionais, a integração com a Zonos para a criação de envios deve ser uma prioridade. Desta forma, poderá oferecer a experiência mais fluida aos seus comerciantes e aos clientes destes, tirando partido das funcionalidades existentes da sua plataforma e deixando a Zonos gerir a criação do envio, da etiqueta e da documentação aduaneira de suporte.
As vantagens de utilizar a Zonos para criar envios incluem:
Faturação de direitos e impostos a terceiros - Garantimos que o número de conta da transportadora (seu ou do seu comerciante) é utilizado para os custos de envio, enquanto as faturas de direitos e impostos são enviadas à Zonos.
Flexibilidade - Em vez de desenvolver trabalho para garantir que consegue gerar etiquetas em conformidade com a sua plataforma, integre-se com a nossa API e deixe connosco a conformidade transfronteiriça, que está em constante mudança.
Documentação aduaneira precisa - Quando utiliza a Zonos para gerar etiquetas, garantimos que os dados corretos são transmitidos à transportadora, para que a encomenda passe rapidamente pela alfândega.
Este guia orienta-o pelos passos necessários para implementar uma integração completa, de ponta a ponta, que lhe permitirá chamar a Zonos para criar envios a partir da sua plataforma.
Siga os passos abaixo para permitir que os seus clientes obtenham etiquetas Zonos a partir da sua plataforma.
1
Permitir credenciais da API
A API da Zonos é acessível através de um credentialToken. A sua plataforma terá de dar aos clientes a possibilidade de introduzirem na sua plataforma o respetivo credentialToken obtido no Zonos Dashboard. A partir daí, poderá fazer pedidos à Zonos em nome deles.
2
Criar um envio
Para obter um label, é necessário criar um shipment ao qual o label ficará associado. A Zonos gere este processo com um fluxo de trabalho que cria shipments e labels no mesmo pedido. Ao executar esta mutação, não precisa de indicar um serviceLevel, pois utilizaremos o serviceLevel do landedCost associado à order. Para o orderId, pode utilizar o ID de encomenda da Zonos ou o accountOrderNumber, que provavelmente já existe no seu sistema.
Quando um envio e as respetivas etiquetas são criados com sucesso, devolvemos as etiquetas como um labelImage, que é um BASE64_ENCODED_IMAGE, ou como um url a partir do qual a etiqueta pode ser obtida.
Utilize este fluxo de trabalho quando estiver a criar um envio para uma encomenda existente e não precisar de alterar os dados dos artigos ou das partes. Suporta números de seguimento opcionais, centros de distribuição, seleção do nível de serviço e seguro de valor declarado.
Comerciantes Shopify
A Shopify transmite um valor nulo para person na parte de origem. Por isso, o orderId por si só não funciona para comerciantes Shopify; utilize antes o separador Criação avançada de envios e forneça os dados completos das partes, incluindo person.
Com centro de distribuição: Adicione "fulfillmentCenter": "fulfillment_center_12345" para especificar o local de origem
Com seguimento 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
Com serviços especiais: Consulte o guia de serviços especiais para baterias, gelo seco, mercadorias perigosas e opções de assinatura.
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 alterar este montante. Este valor define a responsabilidade máxima que a transportadora aceita em caso de perda, dano ou roubo durante o transporte. Esta funcionalidade só é suportada em envios UPS, FedEx e DHL. Quando ativa o valor declarado, a Zonos trata automaticamente da implementação específica de cada transportadora, incluindo os parâmetros adequados nas nossas chamadas à API dessas transportadoras, pelo que não precisa de gerir os diferentes requisitos de cada uma.
Limitações da UPS: a UPS só cobre valores entre 100 e 50 000 USD e processa o valor declarado ao nível da caixa. Em envios com várias caixas, os comerciantes têm de dividir o envio para definir a cobertura por caixa. A UPS gera também um formulário de seguro adicional que tem de ser impresso juntamente com as etiquetas.
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 especiais de manuseamento para baterias, gelo seco, mercadorias perigosas ou requisitos de assinatura. Consulte o guia de serviços especiais para obter todos os detalhes e exemplos.
ShipStation UPS Unlock: os envios com vários volumes não são suportados. Quando uma encomenda é enviada em várias caixas, o campo de referência é duplicado, o que faz com que a correspondência do número de encomenda falhe no back-end. Os comerciantes que precisem de envios com vários volumes devem criar a etiqueta no Zonos Dashboard. Os envios com uma única caixa não são afetados.
3
Anular um envio
Caso um cliente pretenda anular um shipment, pode utilizar a seguinte mutação, que anula todos os labels associados ao shipment.
Integração de envios na plataforma
Crie envios a partir da sua plataforma
Dê aos clientes a possibilidade de criar envios e etiquetas Zonos a partir da sua plataforma.
Este guia destina-se a programadores de plataformas de envio que pretendam integrar as funcionalidades de criação de envios da Zonos na sua plataforma, para os seus clientes. Se já utiliza a API da Zonos e só precisa de criar envios para encomendas existentes, consulte antes o nosso guia de criação de envios.
Se é uma plataforma de envio que dá suporte a clientes Zonos que fazem envios internacionais, a integração com a Zonos para a criação de envios deve ser uma prioridade. Desta forma, poderá oferecer a experiência mais fluida aos seus comerciantes e aos clientes destes, tirando partido das funcionalidades existentes da sua plataforma e deixando a Zonos gerir a criação do envio, da etiqueta e da documentação aduaneira de suporte.
As vantagens de utilizar a Zonos para criar envios incluem:
Este guia orienta-o pelos passos necessários para implementar uma integração completa, de ponta a ponta, que lhe permitirá chamar a Zonos para criar envios a partir da sua plataforma.
Ativar a impressão de etiquetas
Siga os passos abaixo para permitir que os seus clientes obtenham etiquetas Zonos a partir da sua plataforma.
Permitir credenciais da API
A API da Zonos é acessível através de um
credentialToken. A sua plataforma terá de dar aos clientes a possibilidade de introduzirem na sua plataforma o respetivocredentialTokenobtido no Zonos Dashboard. A partir daí, poderá fazer pedidos à Zonos em nome deles.Criar um envio
Para obter um
label, é necessário criar umshipmentao qual olabelficará associado. A Zonos gere este processo com um fluxo de trabalho que criashipmentselabelsno mesmo pedido. Ao executar esta mutação, não precisa de indicar umserviceLevel, pois utilizaremos oserviceLeveldolandedCostassociado àorder. Para oorderId, pode utilizar o ID de encomenda da Zonos ou oaccountOrderNumber, que provavelmente já existe no seu sistema.Quando um envio e as respetivas etiquetas são criados com sucesso, devolvemos as etiquetas como um
labelImage, que é umBASE64_ENCODED_IMAGE, ou como umurla partir do qual a etiqueta pode ser obtida.Utilize este fluxo de trabalho quando estiver a criar um envio para uma encomenda existente e não precisar de alterar os dados dos artigos ou das partes. Suporta números de seguimento opcionais, centros de distribuição, seleção do nível de serviço e seguro de valor declarado.
A Shopify transmite um valor nulo para
personna parte de origem. Por isso, oorderIdpor si só não funciona para comerciantes Shopify; utilize antes o separador Criação avançada de envios e forneça os dados completos das partes, incluindoperson.mutation CreateShipment($input: ShipmentCreateWorkflowInput!) {shipmentCreateWorkflow(input: $input) {idstatustrackingDetails {number}serviceLevel {idnamecarrier {idname}}shipmentCartons {idcarton {idwidthlengthheightweightitems {itemidamountdescriptionlabelurltrackingNumberiddocumentFilingOpções de 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 específico da transportadora"isDeclaredValue": truepara ativar a cobertura de valor declaradoValor declarado
Defina
"isDeclaredValue": truepara 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 alterar este montante. Este valor define a responsabilidade máxima que a transportadora aceita em caso de perda, dano ou roubo durante o transporte. Esta funcionalidade só é suportada em envios UPS, FedEx e DHL. Quando ativa o valor declarado, a Zonos trata automaticamente da implementação específica de cada transportadora, incluindo os parâmetros adequados nas nossas chamadas à API dessas transportadoras, pelo que não precisa de gerir os diferentes requisitos de cada uma.Limitações da UPS: a UPS só cobre valores entre 100 e 50 000 USD e processa o valor declarado ao nível da caixa. Em envios com várias caixas, os comerciantes têm de dividir o envio para definir a cobertura por caixa. A UPS gera também um formulário de seguro adicional que tem de ser impresso juntamente com as etiquetas.
FedEx e DHL: processam o valor declarado ao nível do envio, sem restrições adicionais.
Serviços especiais
Utilize
specialServicesnuma caixa para indicar requisitos especiais de manuseamento para baterias, gelo seco, mercadorias perigosas ou requisitos de assinatura. Consulte o guia de serviços especiais para obter todos os detalhes e exemplos.ShipStation UPS Unlock: os envios com vários volumes não são suportados. Quando uma encomenda é enviada em várias caixas, o campo de referência é duplicado, o que faz com que a correspondência do número de encomenda falhe no back-end. Os comerciantes que precisem de envios com vários volumes devem criar a etiqueta no Zonos Dashboard. Os envios com uma única caixa não são afetados.
Anular um envio
Caso um cliente pretenda anular um
shipment, pode utilizar a seguinte mutação, que anula todos oslabelsassociados 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?