Conectar a UPS: tarifas ao vivo, etiquetas e rastreio

Última atualização 2026-11-01

Crie um app no UPS Developer Kit, cole Client ID / Secret e Shipper Number, teste e comece a cotar e enviar.

O conector da UPS obtém tarifas ao vivo, compra etiquetas e rastreia pela API da UPS. Precisa de uma conta UPS com Shipper Number de 6 dígitos.

Passos: credenciais do app, Shipper Number, teste de tarifa real.

Pré-requisitos#

No UPS Developer Kit, crie um app e anote o Client ID e Client Secret OAuth.
Encontre seu Shipper Number de 6 dígitos na sua conta UPS (o número da conta nas faturas).
Em modo teste use as credenciais sandbox da UPS; em produção, as do app de produção.

Nunca cole credenciais de produção numa conexão de teste, nem use etiqueta de teste num envio real.

Abra Integration → Marketplace → UPS → Nova conexão.
Client ID / Client Secret: cole as credenciais OAuth. Criptografadas em repouso, nunca exibidas.
Shipper Number: seu número de conta UPS de 6 dígitos.
Ambiente: primeiro teste; produção após passar no teste de tarifa.

O teste faz uma cotação real para um pacote de exemplo. Se voltar uma tarifa, auth, conta e rating funcionam.

A UPS não precisa de mapping de pedidos: trabalha com pacotes. Nas configurações, escolha os serviços oferecidos.

Fluxo de envio UPS: cotar, comprar etiqueta, rastrear.

Após ativar, a conexão serve para cotar e comprar etiquetas ao enviar. O rastreio volta automaticamente.

O Client ID / Secret estão incorretos, ou você colou credenciais de teste numa conexão de produção (ou vice-versa).

Verifique primeiro o seletor de ambiente e copie de novo as credenciais daquele ambiente.

O Shipper Number está incorreto, ou a conta não tem esse serviço habilitado.

Verifique o Shipper Number numa fatura da UPS.

As atualizações de rastreio chegam no ritmo da UPS, não na hora.

Se nada chegar em 24 horas, verifique Runs / Logs em busca de erros de webhook.