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.

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.

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.

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.

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.

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.

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.

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.

• Shipping: Enables UPS shipping services, such as preparing packages for shipment, managing returns, and cancelling scheduled shipments.

• 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.

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.

Na seção Credenciais, copie 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.

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.

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.