DOCS

UPS Unlock

Automatize a faturação de direitos aduaneiros e impostos à Zonos para envios UPS processados fora do Dashboard.

O UPS Unlock permite gerar envios em conformidade com a Zonos a partir da sua própria plataforma de envio, em vez de utilizar o Zonos Dashboard. Ao adicionar um número de referência específico ao processar envios UPS, a UPS valida e atualiza automaticamente os dados do envio através da Zonos, incluindo descrições aduaneiras, códigos HS, números de conta de direitos aduaneiros, números de identificação fiscal e valores das mercadorias. Isto elimina a necessidade de configurar regras ou integrações complexas para transmitir estas informações à sua plataforma de envio. Em vez disso, a UPS obtém os dados diretamente da Zonos, reduzindo o risco de discrepâncias ou de informações em falta e minimizando o tempo de configuração e manutenção manual.

Configurar o UPS Unlock 

  1. Contacte o suporte da Zonos - Antes de ativar o UPS Unlock, contacte o Suporte da Zonos para garantir que a sua conta UPS está corretamente configurada. Este processo demora normalmente 24 a 48 horas a ficar concluído.
  2. Ative o UPS Unlock no Dashboard - Aceda a Zonos Dashboard → Settings → Rates → UPS e altere UPS Unlock para Enable
  3. Configure os seus números de referência - Pelo menos um número de referência tem de começar por zx ou zx-. Desde que pelo menos uma referência comece por zx (mesmo que o valor seja apenas zx), a Zonos analisa todos os números de referência para encontrar um ID de encomenda Zonos ou um número de encomenda da conta correspondente.
    • Exemplos:
      • zxORDER123 ou zx-ORDER123 (formato combinado com o número de encomenda do comerciante)
      • zxorder_0jy1vh6gygcks ou zx-order_0jy1vh6gygcks (formato combinado com o ID de encomenda Zonos)
      • Referência 1: zx, Referência 2: ORDER123 (dividido por dois campos de referência)

Como funciona 

Depois de configurar o UPS Unlock, os envios UPS passam a referenciar os dados de encomenda da Zonos. Eis como funciona esse processo:

  1. A UPS contacta automaticamente a Zonos para validar a encomenda com os campos de referência fornecidos
  2. A Zonos valida e devolve à UPS os dados aduaneiros atualizados - A Zonos valida se o envio corresponde à cotação original, verificando se:
    1. Os artigos do envio correspondem aos da cotação
    2. As quantidades são iguais ou inferiores às quantidades cotadas
    3. Os números de peça correspondem aos IDs de produto ou SKUs da cotação
    4. Os dados de destino (país/província) correspondem à cotação
  3. A UPS processa o seu envio com as informações de conformidade
  4. A UPS contacta a Zonos para criar o registo do envio com o número de seguimento
  5. A Zonos regista o envio na encomenda

Correspondência de referências 

Quando a UPS contacta a Zonos com uma referência como zx-ORDER123, a Zonos remove o prefixo e procura a encomenda. O valor após o prefixo (ORDER123 neste exemplo) é comparado com três campos da encomenda Zonos:

Campo↕Descrição↕Exemplo↕
ID da encomendaO UUID da encomenda Zonosorder_0jy1vh6gygcks
Número de encomenda da contaO seu número de encomenda de comercianteORD-12345, #1001
ID de encomenda ZonosIdentificador curto da Zonoszo-1232423

A Zonos devolve a encomenda correspondente mais recente. Se não for encontrada nenhuma correspondência, é devolvido um erro.

Requisitos

Para que o UPS Unlock seja bem-sucedido, a encomenda tem de cumprir estes requisitos:

  • Landed Cost Guarantee (LCG) - A encomenda tem de ter sido criada através do fluxo de checkout da Zonos com um landed cost garantido. As encomendas criadas fora da Zonos não podem ser utilizadas com o UPS Unlock.
  • Origem/destino correspondentes - Os países de expedição e de destino têm de corresponder à cotação original. Para envios para o Canadá ou o Brasil, a província também tem de corresponder.
  • Produtos correspondentes - Os números de peça têm de 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 da Zonos. Os códigos de erro mais comuns incluem:

Código↕Mensagem↕Causa↕
10001Shipper number not foundO número de expedidor UPS não está registado na Zonos
10002No Zonos order found for any of the provided reference IDsNenhuma encomenda corresponde a qualquer referência (após remover o prefixo)
10003Invalid reference IDs. No prefix of zx- foundNenhuma das referências tem o prefixo zx ou zx-
10006The requested order is not guaranteedA encomenda existe, mas não tem Landed Cost Guarantee
10010ShipFrom.CountryCode mismatchO país de expedição não corresponde à origem cotada
10011ShipTo.CountryCode mismatchO país de destino não corresponde ao destino cotado
10012ShipTo.StateProvinceCode mismatchEm envios para CA/BR, a província não corresponde
10013No matching Product on quote with PartNumberO SKU/productId do produto não foi encontrado na encomenda
10015Quantity exceeds the quoted quantityA quantidade pedida é superior à cotada

Integração com o ShipStation 

Os utilizadores do ShipStation podem configurar o UPS Unlock adicionando o prefixo zx a montante (através da API, antes de as encomendas chegarem ao ShipStation) ou no próprio ShipStation, através das configurações de Label Messages e Automation Rules. Isto permite incluir o prefixo zx e o ID da encomenda nos envios UPS processados através do ShipStation, acionando o UPS Unlock. Depois de concluir os passos de configuração iniciais, pode começar a configurar o ShipStation para funcionar com o UPS Unlock.

Adicionar zx a montante

Se conseguir adicionar o prefixo zx a montante (antes de as encomendas chegarem ao ShipStation), só precisa de configurar as suas Label Messages para apresentarem o número de encomenda com zx:

Configuração das Label Messages

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

Depois de concluído, o ShipStation coloca automaticamente o número da encomenda na etiqueta, incluindo o prefixo zx configurado.

Adicionar zx no ShipStation

Se não conseguir adicionar o prefixo zx a montante (antes de as encomendas chegarem ao ShipStation), terá de configurar as suas Label Messages e Automation Rules para apresentarem o prefixo zx e o número de encomenda em duas Label Messages separadas:

Passo 1: Configuração das Label Messages

Configure as suas Label Messages para apresentarem o prefixo e o número de encomenda:

  1. Aceda às definições de Label Messages: Navegue até Settings → Printing → Printing Setup, e, em seguida, clique em Document Options para Label
  2. Configure as Label Messages: Na secção Label Messages, pode definir até 3 mensagens personalizadas que aparecerão como números de referência nas etiquetas UPS.
  3. Defina as suas mensagens:
    • Defina a Message #1 como [Custom Field 1] (será preenchida com "zx" pela regra de automação)
    • Defina a Message #2 como [Order #] (selecione no menu pendente)
  4. Guarde as definições para aplicar a sua configuração

Passo 2: Configuração das Automation Rules

Depois de configurar as 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 encomendas UPS da Zonos:

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

Nota: Os seus critérios de acionamento podem variar consoante a configuração do seu ShipStation. Este é um ponto de partida recomendado - personalize as condições de acordo com o seu fluxo de trabalho e as suas preferências específicas, para garantir que o UPS Unlock é aplicado apenas às encomendas adequadas.

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

Depois de concluído, o ShipStation preenche automaticamente o Custom Field 1 com zx e a Message #2 com o número da encomenda nas encomendas internacionais UPS. Estes valores aparecerão nas etiquetas UPS como duas linhas de referência separadas.

Importante: A configuração das Label Messages no ShipStation é uma alteração global que afeta todas as transportadoras. A abordagem com regras de automação permite que o UPS Unlock funcione sem problemas nas encomendas Zonos, mantendo as suas Label Messages preferidas nos restantes envios.

Esta página foi útil?