UPS Unlock

O UPS Unlock permite que você gere remessas em conformidade com o Zonos a partir da sua própria plataforma de envio, em vez de usar o Zonos Dashboard. Ao adicionar um número de referência específico ao processar remessas de UPS, a UPS valida e atualiza automaticamente os dados de envio através do Zonos, incluindo descrições aduaneiras, códigos HS, números de conta de tarifas, IDs fiscais e valores de mercadorias. Isso elimina a necessidade de configurar regras ou integrações complexas para passar essas informações à sua plataforma de envio. Em vez disso, a UPS recupera os dados diretamente do Zonos, reduzindo o risco de discrepâncias ou informações ausentes e minimizando o tempo de configuração e manutenção manual.

Configurar o UPS Unlock 

1. Contate o suporte Zonos - Antes de ativar o UPS Unlock, entre em contato com Zonos Support para garantir que sua conta UPS esteja configurada corretamente. Esse processo normalmente leva de 24 a 48 horas para ser concluído.
2. Habilite o UPS Unlock no Dashboard - Acesse Zonos Dashboard → Settings → Rates → UPS e ative UPS Unlock para Enable
3. Configure seus números de referência - Pelo menos um número de referência deve começar com zx ou zx-. Desde que pelo menos uma referência comece com zx (mesmo que o valor seja apenas zx), o Zonos verificará todos os números de referência para encontrar um ID de pedido do Zonos ou número de pedido de conta correspondente.
   • Exemplos:
     • zxORDER123 ou zx-ORDER123 (formato combinado com número de pedido do comerciante)
     • zxorder_0jy1vh6gygcks ou zx-order_0jy1vh6gygcks (formato combinado com ID de pedido do Zonos)
     • Referência 1: zx, Referência 2: ORDER123 (dividido em dois campos de referência)

Como funciona 

Depois de configurar o UPS Unlock, as remessas de UPS farão referência aos dados de pedido do Zonos. Veja como esse processo funciona:

1. A UPS chama automaticamente o Zonos para validar o pedido com os campos de referência fornecidos
2. O Zonos valida e retorna os detalhes aduaneiros atualizados para a UPS - o Zonos valida se a remessa corresponde à cotação original verificando:
   1. Se os itens da remessa correspondem aos da cotação
   2. Se as quantidades são menores ou iguais às quantidades cotadas
   3. Se os números de peça correspondem aos IDs de produto ou SKUs da cotação
   4. Se os detalhes de destino (país/província) correspondem à cotação
3. A UPS processa sua remessa com as informações de conformidade
4. A UPS chama o Zonos para criar o registro da remessa com o número de rastreamento
5. O Zonos registra a remessa no pedido

Correspondência de referência 

Quando a UPS chama o Zonos com uma referência como zx-ORDER123, o Zonos remove o prefixo e busca o pedido. O valor após o prefixo (ORDER123 neste exemplo) é comparado com três campos no pedido do Zonos:

O Zonos retorna o pedido correspondente mais recente. Se nenhuma correspondência for encontrada, um erro é retornado.

Requisitos

Para que o UPS Unlock funcione, o pedido deve atender a estes requisitos:

• Landed Cost Guarantee (LCG) - O pedido deve ter sido criado através do fluxo de checkout do Zonos com um landed cost garantido. Pedidos criados fora do Zonos não podem ser usados com o UPS Unlock.
• Origem/destino correspondentes - Os países de origem e destino do envio devem corresponder à cotação original. Para remessas para o Canadá ou o Brasil, a província também deve corresponder.
• Produtos correspondentes - Os números de peça devem corresponder aos IDs de produto ou SKUs da cotação, e as quantidades não podem exceder as quantidades cotadas.

Códigos de erro 

Se a validação falhar, a UPS recebe uma resposta de erro do Zonos. Os códigos de erro comuns incluem:

Integração com o ShipStation 

Usuários do ShipStation podem configurar o UPS Unlock adicionando o prefixo zx upstream (via API antes que os pedidos cheguem ao ShipStation) ou dentro do ShipStation usando as configurações de Label Messages e Automation Rules. Isso permite que o prefixo zx e o ID do pedido sejam incluídos nas remessas de UPS processadas pelo ShipStation, ativando o UPS Unlock. Após concluir as etapas de configuração iniciais, você pode começar a configurar o ShipStation para funcionar com o UPS Unlock.

Adicionando o zx upstream

Se você conseguir adicionar o prefixo zx upstream (antes de os pedidos chegarem ao ShipStation), você só precisa configurar suas Label Messages para exibir o número de pedido com zx:

Configuração de Label Messages

1. Acesse as configurações de Label Messages: Navegue até Settings → Printing → Printing Setup, depois clique em Document Options para Label
2. Configure as Label Messages: Na seção Label Messages, você pode definir até 3 mensagens personalizadas que aparecerão como números de referência nas etiquetas da UPS. As Label Messages só aceitam valores predefinidos como "Custom Field 1", "Order #", etc.
3. Defina suas mensagens para usar o Order Number: Defina a Message #1 como [Order #]. Se você já tiver uma #1, adicione uma #2 ou #3
4. Salve as configurações para aplicar sua configuração

Depois de concluído, o ShipStation colocará automaticamente o número do seu pedido na etiqueta, incluindo o prefixo zx configurado.

Adicionando o zx no ShipStation

Se você não conseguir adicionar o prefixo zx upstream (antes de os pedidos chegarem ao ShipStation), você precisará configurar suas Label Messages e Automation Rules para exibir o prefixo zx e o número de pedido usando duas Label Messages separadas:

Etapa 1: Configuração de Label Messages

Configure suas Label Messages para exibir tanto o prefixo quanto o número de pedido:

1. Acesse as configurações de Label Messages: Navegue até Settings → Printing → Printing Setup, depois clique em Document Options para Label
2. Configure as Label Messages: Na seção Label Messages, você pode definir até 3 mensagens personalizadas que aparecerão como números de referência nas etiquetas da UPS.
3. Defina suas mensagens:
   • Defina a Message #1 como [Custom Field 1] (isso será preenchido com "zx" pela regra de automação)
   • Defina a Message #2 como [Order #] (selecione no menu suspenso)
4. Salve as configurações para aplicar sua configuração

Etapa 2: Configuração de Automation Rules

Depois de configurar suas Label Messages, crie uma regra de automação para preencher o Custom Field 1 com o prefixo zx. Navegue até Settings → Automation → Automation Rules e clique em Create a Rule.

Regra para pedidos UPS do Zonos:

1. Nome: "Zonos UPS Unlock"
2. Certifique-se de que Active Rule esteja ativado
3. Selecione Orders match these specific criteria
4. Defina os critérios: "International Order" = "True" AND "Carrier" + "Includes" + "UPS"

Nota: Seus critérios de acionamento podem variar de acordo com a configuração do seu ShipStation. Este é um ponto de partida recomendado - personalize as condições com base no seu fluxo de trabalho e nas suas preferências específicas para garantir que o UPS Unlock seja aplicado apenas aos pedidos apropriados.

1. Defina as ações:
   • Action Type: Selecione "Set Custom Field 1..."
   • Custom Field 1: zx (isso define o prefixo)
2. Clique em Save Rule

Depois de concluído, o ShipStation preencherá automaticamente o Custom Field 1 com zx e a Message #2 com o número do pedido para pedidos internacionais da UPS. Esses valores aparecerão nas etiquetas da UPS como duas linhas de referência separadas.

Importante: A configuração de Label Messages no ShipStation é uma alteração global que afeta todas as transportadoras. A abordagem de regras de automação permite que o UPS Unlock funcione perfeitamente para pedidos do Zonos, mantendo suas Label Messages preferidas para outras remessas.