DOCS

UPS Unlock

UPS Unlock

Automatice o faturamento de tarifas e impostos para Zonos para envio de UPS processados fora de Dashboard.

UPS Unlock permite-lhe gerar remessas compatíveis com Zonos desde sua própria plataforma de envio, em vez de utilizar Zonos Dashboard. Ao adicionar um número de referência específico ao processar remessas de UPS, UPS valida e atualiza automaticamente os dados de envio através de Zonos, incluindo descrições aduaneiras, HS codes, números de conta de tarifas, tax IDs e valores de mercadorias. Isto elimina a necessidade de configurar regras ou integrações complexas para passar esta informação à sua plataforma de envio. Em vez disso, UPS recupera os dados diretamente do Zonos, reduzindo o risco de discrepâncias ou informações faltantes e minimizando o tempo de configuração e manutenção manual.

Configurar o UPS Unlock 

  1. Contate de suporte Zonos - Antes de activar UPS Unlock, contate Zonos Support para garantir que a sua conta de UPS está configurada corretamente. Este processo normalmente demora 24-48 horas a ser completado.
  2. Habilite UPS Unlock em Dashboard - Vá a Zonos Dashboard → Settings → Rates → UPS e active UPS Unlock em Enable
  3. Configure os seus números de referência - Pelo menos um número de referência deve começar com zx ou zx-. Sempre que pelo menos uma referência comece com zx (mesmo que o valor seja só zx), Zonos irá digitalizar todos os números de referência para encontrar um ID de pedido de 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 de Zonos)
      • Referência 1: zx, Referência 2: ORDER123 (dividido em dois campos de referência)

Como funciona 

Uma vez que tiver UPS Unlock configurado, as remessas de UPS farão referência aos dados do pedido de Zonos. Isso funciona esse processo:

  1. UPS chama automaticamente Zonos para validar o pedido com os campos de referência fornecidos
  2. Zonos valida e devolve detalhes aduaneiros atualizados para UPS - Zonos valida que o envio corresponda à cotação original comprobando:
    1. Os artigos do envio correspondem aos da cotação
    2. As quantidades são menores ou iguais às quantidades cotadas
    3. Os números de parte correspondem aos product IDs ou SKUs da cotação
    4. Os detalhes de destino (país/província) coincidem com a cotação
  3. UPS processa seu envio com informações de conformidade
  4. UPS chama Zonos para criar o registo de envio com número de seguimento
  5. Zonos registra o envio no pedido

Coincidência de referências 

Quando UPS chama Zonos com uma referência como zx-ORDER123, Zonos remove o prefixo e procura o pedido. O valor após o prefixo (ORDER123 Neste exemplo, compara-se com três campos no pedido de Zonos:

CampoDescriçãoExemplo
Order IDO UUID do pedido de Zonosorder_0jy1vh6gygcks
Account order numberSeu número de pedido do comercianteORD-12345, #1001
Zonos order IDIdentificador curto de Zonoszo-1232423

Zonos devolve o pedido coincidente mais recente. Se não estiver coincidência, é devolvido um erro.

Requisitos

Para que UPS Unlock tenha sucesso, o pedido deve cumprir esses requisitos:

  • Landed Cost Guarantee (LCG) - O pedido deve ter sido criado através do fluxo de Checkout de Zonos com um landed cost garantido. Os pedidos criados fora de Zonos não podem ser utilizados com UPS Unlock.
  • Origen/destino coincidentes - Os países de expedição e de destino devem coincidir com a cotação original. Para envios para Canadá ou Brasil, a província também deve coincidir.
  • Produtos coincidentes - Os números de parte devem corresponder aos produtos IDs ou SKUs da cotação, e as quantidades não podem exceder as quantidades cotadas.

Códigos de erro 

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

CódigoMensagemCausa
10001Shipper number not foundO número de remetente de UPS não está registado com Zonos
10002No Zonos order found for any of the provided reference IDsNenhum pedido coincide com nenhuma referência (após remover o prefixo)
10003Invalid reference IDs. Não prefix of zx- foundNenhuma das referências tem o prefixo zx ou zx-
10006The requested order is not guaranteedO pedido existe mas não tem Landed Cost Guarantee
10010ShipFrom.CountryCode mesmatchO país de origem não coincide com a origem cotadas
10011ShipTo.CountryCode mesmatchO país de destino não coincide com o destino cotados
10012ShipTo.StateProvinceCode mesmatchPara envios CA/BR, a província não coincide
10013No matching Product on quote with PartNumberO SKU/productId do produto não é encontrado no pedido
10015Quantity exceeds the quoted quantityA quantidade solicitada é maior do que a cotadas

Integração com o ShipStation 

Os usuários do ShipStation podem configurar UPS Unlock adicionando o prefixo zx upstream (mediante API antes que os pedidos cheguem a ShipStation) ou dentro de ShipStation usando configurações de Label Messages e Automation Rules. Isto permite que o prefixo zx e o ID do pedido são incluídos em remessas de UPS processados através de ShipStation, ativando UPS Unlock. Após completar passos de configuração iniciais, você pode começar a configurar ShipStation para funcionar com UPS Unlock.

Adicionar zx upstream

Se você pode adicionar o prefixo zx upstream (antes que os pedidos cheguem a ShipStation), só precisa configurar seus Label Messages para mostrar o número de pedidos zx:

Configuração do Label Messages

  1. Acceda à configuração de Label Messages: Vá a SettingsPrintingPrinting Setup, depois clique em Document Options para Label
  2. Configure Label Messages: Na seção Label Messages, pode definir até 3 mensagens personalizadas que aparecerão como números de referência nas marcas de UPS. Label Messages só aceitam valores preestabelecidos como "Custom Field 1", "Order #", etc.
  3. Configure seus Messages para usar Order Number: Configure Message #1 em [Order #]. Se você já tem um #1, adicione um #2 ou #3
  4. ** Gravar a configuração** para aplicar a sua configuração

Após a conclusão, a ShipStation colocará automaticamente o seu número de pedido no seu rótulo, que inclui o prefixo zx configurado.

Adicionar zx na ShipStation

Se não conseguir adicionar o prefixo zx upstream (antes de os pedidos chegarem à ShipStation), deverá configurar seus Label Messages e Automation Rules para mostrar o prefixo zx e o número de pedido utilizando dois Label Messages separados:

Passo 1: Configuração do Label Messages

Configure seus Label Messages para mostrar tanto o prefixo como o número de pedido:

  1. Acceda à configuração de Label Messages: Vá a SettingsPrintingPrinting Setup, depois clique em Document Options para Label
  2. Configure Label Messages: Na seção Label Messages, pode definir até 3 mensagens personalizadas que aparecerão como números de referência nas marcas de UPS.
  3. Configure seus Messages:
    • Configure Message #1 em [Custom Field 1] (isto será completado com "zx" por regra de automação)
    • Configure Message #2 em [Order #] (selecione do menu suspenso)
  4. ** Gravar a configuração** para aplicar a sua configuração

Passo 2: Configuração do Automation Rules

Depois de configurar seu Label Messages, crie uma regra de automação para completar o Custom Field 1 com o prefixo zx. Vá a SettingsAutomationAutomation Rules e clique em Create a Rule.

Regla para pedidos UPS de Zonos:

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

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

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

Uma vez completado, a ShipStation completa automaticamente Custom Field 1 com zx e Message #2 com o número de pedido para pedidos internacionais de UPS. Estes aparecem nas suas marcas de UPS como duas linhas de referência separadas.

Importante: A configuração de Label Message em ShipStation é uma mudança global que afeta todos os transportadores. A abordagem de regras de automação permite que UPS Unlock funcione sem problemas para pedidos de Zonos enquanto mantém seus Label Messages preferidos para outras remessas.

Esta página foi útil?