Configurar o UPS Unlock
- 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.
- Habilite UPS Unlock em Dashboard - Vá a Zonos Dashboard → Settings → Rates → UPS e active UPS Unlock em Enable
- Configure os seus números de referência - Pelo menos um número de referência deve começar com
zxouzx-. Sempre que pelo menos uma referência comece comzx(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:
zxORDER123ouzx-ORDER123(formato combinado com número de pedido do comerciante)zxorder_0jy1vh6gygcksouzx-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)
- Exemplos:
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:
- UPS chama automaticamente Zonos para validar o pedido com os campos de referência fornecidos
- Zonos valida e devolve detalhes aduaneiros atualizados para UPS - Zonos valida que o envio corresponda à cotação original comprobando:
- Os artigos do envio correspondem aos da cotação
- As quantidades são menores ou iguais às quantidades cotadas
- Os números de parte correspondem aos product IDs ou SKUs da cotação
- Os detalhes de destino (país/província) coincidem com a cotação
- UPS processa seu envio com informações de conformidade
- UPS chama Zonos para criar o registo de envio com número de seguimento
- 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:
| Campo↕ | Descrição↕ | Exemplo↕ |
|---|---|---|
| Order ID | O UUID do pedido de Zonos | order_0jy1vh6gygcks |
| Account order number | Seu número de pedido do comerciante | ORD-12345, #1001 |
| Zonos order ID | Identificador curto de Zonos | zo-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ódigo↕ | Mensagem↕ | Causa↕ |
|---|---|---|
| 10001 | Shipper number not found | O número de remetente de UPS não está registado com Zonos |
| 10002 | No Zonos order found for any of the provided reference IDs | Nenhum pedido coincide com nenhuma referência (após remover o prefixo) |
| 10003 | Invalid reference IDs. Não prefix of zx- found | Nenhuma das referências tem o prefixo zx ou zx- |
| 10006 | The requested order is not guaranteed | O pedido existe mas não tem Landed Cost Guarantee |
| 10010 | ShipFrom.CountryCode mesmatch | O país de origem não coincide com a origem cotadas |
| 10011 | ShipTo.CountryCode mesmatch | O país de destino não coincide com o destino cotados |
| 10012 | ShipTo.StateProvinceCode mesmatch | Para envios CA/BR, a província não coincide |
| 10013 | No matching Product on quote with PartNumber | O SKU/productId do produto não é encontrado no pedido |
| 10015 | Quantity exceeds the quoted quantity | A 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
- Acceda à configuração de Label Messages: Vá a Settings → Printing → Printing Setup, depois clique em Document Options para Label
- 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.
- Configure seus Messages para usar Order Number: Configure Message #1 em
[Order #]. Se você já tem um #1, adicione um #2 ou #3 - ** 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:
- Acceda à configuração de Label Messages: Vá a Settings → Printing → Printing Setup, depois clique em Document Options para Label
- 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.
- 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)
- Configure Message #1 em
- ** 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 Settings → Automation → Automation Rules e clique em Create a Rule.
Regla para pedidos UPS de Zonos:
- Nome: "Zonos UPS Unlock"
- Certifique-se de que Active Rule está ativado
- Selecione Orders match these specific criteria
- 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.
- Definir as ações:
- Action Type: Selecione "Set Custom Field 1..."
- Custom Field 1:
zx(isto estabelece o prefixo)
- 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.
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.