Integração com UPS

A UPS é um serviço de transportadora que se integra ao Odoo para coordenar o envio para todas as regiões. Uma vez integrados, os usuários podem criar métodos de envio que estimam os custos de envio e gerar etiquetas.

Para configurar o conector de remessa da UPS no Odoo, siga estas etapas:

  1. Crie uma conta UPS para obter o número da conta

  2. Crie uma conta de desenvolvedor na UPS para obter credenciais do cliente

  3. Configurar o método de envio no Odoo

Configuração da conta UPS

Para começar, acesse o site da UPS e clique no botão Log In no canto superior direito para fazer login ou criar uma conta UPS.

Depois de fazer login, clique no ícone do perfil no canto superior direito e selecione Contas e pagamentos no menu suspenso.

Mostre como navegar até a página "Contas e pagamentos" na tela inicial.

Na página Contas e opções de pagamento, duas contas devem ser configuradas: uma conta de remessa do Odoo e um cartão de pagamento.

Conta de envio

Para adicionar uma conta de envio do Odoo, selecione Adicionar nova conta no menu suspenso Adicionar método de pagamento e clique em Adicionar.

Exibir a opção "Adicionar uma conta" no menu suspenso.

Na próxima tela, denominada Abrir uma conta de envio, preencha os formulários para configurar o tipo de conta de remessa (por exemplo, Empresa) e se algum item regulamentado será enviado. Em seguida, conclua as três etapas restantes do assistente para Adicionar endereços, Verificar a identidade e Explorar os descontos, sendo que a última opção é opcional.

Quando terminar, envie a solicitação na última página do assistente para concluir a configuração da conta de envio.

Formulário da UPS para preencher as informações de remessa da empresa.

Obter o número da conta

Com a conta de envio configurada, o Número da conta UPS fica disponível. Para acessá-lo, navegue até Perfil ‣ Contas e pagamentos e consulte o campo Número da conta de envio.

O campo "Número" da conta para a conta de envio.

Cartão de pagamento

Volte para a página Contas e pagamentos e selecione a opção Adicionar cartão de pagamento no menu suspenso Adicionar um método de pagamento. Em seguida, preencha o formulário para adicionar as informações do cartão de crédito.

Mostre a opção "Adicionar cartão de pagamento" no menu suspenso.

Configuração da conta de desenvolvedor UPS

Em seguida, faça login na conta de desenvolvedor UPS para gerar a chave de desenvolvedor. Para começar, clique no ícone do perfil no canto superior direito e escolha a opção Aplicativos no menu suspenso.

Opção "Aplicativos" da lista suspensa depois de clicar no ícone da foto do perfil.

Adicionar aplicativo

Em seguida, clique no botão Adicionar aplicativos para começar a preencher o formulário. No campo Preciso de credenciais de API porque *, selecione Quero integrar a tecnologia UPS em minha empresa.

No próximo rótulo, Escolher uma conta para associar a essas credenciais. *, selecione Adicionar conta existente no menu suspenso do campo correspondente e, em seguida, selecione o número da conta vinculado à conta da UPS criada na etapa anterior.

Formulário para preencher o número da conta da UPS.

Clique em Próximo e vá para o formulário Adicionar aplicativo e preencha os campos:

  • Nome do aplicativo: Digite o nome para identificar o aplicativo.

  • Callback URL: Type the URL of the Odoo database, in the format: https://databaseName.odoo.com. Do not include www in the URL.

Na seção Adicionar produtos à direita, procure e clique no ícone + (adição) para adicionar os seguintes produtos ao aplicativo:

  • Autorização (OAuth): Usado para gerar o token de autorização para solicitar informações da API da UPS.

  • Validação de endereço: Valida endereços no nível de rua nos Estados Unidos e em Porto Rico.

  • Localizador: Permite a pesquisa de locais de expedição da UPS com base no tipo e nos serviços disponíveis.

  • Documentos sem papel: Permite o carregamento de imagens de documentos para vincular às remessas.

  • Envio: Habilita os serviços de remessa da UPS, como a preparação de pacotes para envio, o gerenciamento de devoluções e o cancelamento de remessas programadas.

  • Avaliação: Compare os serviços de entrega e os preços de frete

Por fim, clique em Salvar e aceite os termos e condições da UPS.

Veja também

Catálogo API da UPS

Mostrar o formulário "Adicionar aplicativos", onde os detalhes do aplicativo são configurados.

ID do cliente e segredo do cliente

Com o novo aplicativo criado, na página Perfil ‣ Meus aplicativos ‣ Aplicativo, selecione o aplicativo na seção Credenciais para visualizar as credenciais da UPS.

Mostre o aplicativo recém-criado na seção "Meus aplicativos".

Na seção Credenciais, copie a chave ID do cliente e Segredo do cliente.

Exibir a chave "ID do cliente" e "Segredo do cliente".

Configuração no Odoo

Com as credenciais obtidas, configure o método de envio da UPS no Odoo acessando app Inventário ‣ Configuração ‣ Métodos de envio.

Na página Métodos de envio, clique no botão Novo.

Nota

Para métodos de envio UPS existentes cujo Provedor é UPS Legacy, arquive-o e crie um novo método de envio usando UPS.

No campo Provedor, selecione UPS. Isso revela a aba UPS – Configuração, na qual vários campos devem ser inseridos. Para obter instruções detalhadas sobre como configurar os outros campos do método de envio, consulte a documentação Configurar transportadora terceirizada.

Na aba UPS – Configuração, preencha os seguintes campos:

  • Número da conta UPS: (obrigatório) Obtenha o número da conta do portal da UPS.

  • UPS – ID do cliente: (obrigatório) Obtenha ID do cliente do site do desenvolvedor UPS.

  • UPS – Segredo do cliente: (obrigatório) Obtenha a chave Segredo do cliente no site do desenvolvedor UPS.

  • UPS – Tipo de serviço: Selecione no menu suspenso o tipo de serviço de envio.

  • UPS – Tipo de pacote: (obrigatório) Selecione no menu suspenso o tipo de pacote que é compatível com o serviço de envio.

  • Unidade de peso do pacote: A unidade de medida do peso do pacote.

  • Unidade de tamanho do pacote: A unidade de medida para as dimensões do pacote.

  • Formato da etiqueta: Escolha o formato das etiquetas de remessa: PDF, ZPL, EPL ou SPL.

Mostre a aba "UPS – Configuração" no formulário Métodos de envio.

Na seção Opções, os seguintes recursos estão disponíveis:

  • Cobrança Minha conta: Cobrar a conta UPS do usuário para envio no aplicativo e-Commerce.

  • Coleta na entrega: Cobrar o pagamento dos clientes pelo envio após a entrega da remessa.

  • Gerar etiqueta de devolução: Imprime a etiqueta de devolução do pedido após a validação da ordem de entrega.

  • Impostos pagos por: Selecione se os impostos ou outras taxas serão cobrados do Emissor ou Destinatário do pedido.