Conectar o Odoo: receber pedidos e clientes, consultar estoque
Crie uma API Key no Odoo em My Profile → Account Security, preencha a URL da instância, o banco de dados, o usuário e a API Key no Integration, teste, mapeie e ative.
O conector do Odoo traz pedidos de venda e clientes do seu ERP Odoo para este sistema e pode consultar as quantidades de estoque mantidas no Odoo. Ele lê dados do Odoo: não devolve alterações de estoque ao Odoo, não traz faturas e não envia fulfillment ao Odoo. Uma conexão por instância e banco de dados do Odoo.
Pré-requisitos#
- Uma instância do Odoo à qual você consiga entrar e o login de um usuário do Odoo para a integração.
- Para o Odoo Online: o acesso à API externa exige o plano Custom. Em qualquer outro plano do Odoo Online, nenhum conjunto de valores vai conectar: verifique o plano antes de começar.
- Você conhece o endereço da sua instância (por exemplo https://mycompany.odoo.com; auto-hospedado: o endereço do seu servidor) e o nome do banco de dados, no seletor de banco de dados da página de login do Odoo; no Odoo Online, geralmente é o subdomínio.
- Permissão no Odoo para abrir My Profile e criar uma API Key na aba Account Security.
Obter credenciais#
- Entre no Odoo com o usuário da integração, clique no avatar no canto superior direito e abra My Profile.
- Abra a aba Account Security e clique em New API Key.
- Copie a API Key que o Odoo cria. Nesta conexão, a API Key é usada no lugar da senha ao entrar, então não há uma senha separada para procurar: a própria chave cumpre o papel de senha.
- Anote ao mesmo tempo os outros três valores: o endereço da instância, o nome do banco de dados do seletor da página de login do Odoo (no Odoo Online, geralmente o subdomínio) e o login desse mesmo usuário.
Preencher no Integration#
- Abra Integration → Marketplace → Odoo → Nova conexão.
- base_url, obrigatório, URL da instância do Odoo: o endereço da sua instância, por exemplo https://mycompany.odoo.com. Numa instância auto-hospedada, preencha o endereço do seu servidor. Deve começar com http:// ou https://.
- database, obrigatório, nome do banco de dados: o nome exibido no seletor de banco de dados da página de login do Odoo, por exemplo mycompany. No Odoo Online, geralmente é o subdomínio do endereço da sua instância.
- username, obrigatório, usuário (login): o login do usuário do Odoo para a integração, por exemplo admin. Use o login do mesmo usuário que criou a API Key: a forma exata do login depende da sua instância.
- api_key, obrigatório, API key: cole a API Key copiada de My Profile → Account Security → New API Key. É um campo do tipo senha, é usado no lugar da senha e é guardado como segredo.
Testar a conexão#
Clique em Testar a conexão. O teste executa duas etapas reais. Primeiro, pede a versão à instância, sem entrar, para confirmar que o endereço responde e ler a versão do servidor. Depois, entra de verdade com seu database, username e api_key, com a chave no papel de senha, e só um login bem-sucedido conta como aprovado. Ou seja, um endereço correto com uma chave errada não aprova: o endereço prova que a instância responde, e o login prova as credenciais. Se base_url estiver ausente ou não começar com http:// ou https://, o teste para com MISSING_BASE_URL; se database, username ou api_key estiver ausente, para com MISSING_CREDENTIALS, porque os três são necessários para o login real.
Mapping / escolher modelo#
Escolha o mapping padrão do Odoo. Ele trabalha com os modelos padrão do Odoo: os pedidos de venda vêm de sale.order, os clientes de res.partner e as consultas de estoque leem product.product. Depois que o teste aprovar, execute uma extração e confira um pedido real lado a lado (número do pedido, cliente, linhas e quantidades) e compare a quantidade de um produto com o que o Odoo mostra, antes de ativar. Se um campo da sua instância diferir do modelo padrão, ajuste esse campo no mapping em vez de renomear algo no Odoo.
Ativar#
Após ativar, a conexão traz pedidos de venda e clientes do Odoo para este sistema na frequência definida, e as consultas de estoque leem as quantidades atuais do Odoo. Acompanhe as primeiras extrações em Runs / Logs e compare com o Odoo antes de deixar a conexão sem supervisão.
O que esta conexão não faz: não devolve alterações de estoque ao Odoo, não traz faturas do Odoo e não envia fulfillment nem resultados de envio ao Odoo. Continue cuidando disso no próprio Odoo, ou nos sistemas onde o trabalho realmente acontece.
Perguntas frequentes#
O endereço abre bem, mas o teste falha com AUTH_FAILED
A instância responde (a etapa de versão respondeu), mas o login real foi recusado. Isso significa que database, username ou api_key não corresponde: os três valores devem pertencer juntos, e a chave deve ser a do mesmo usuário do username. Um endereço correto sozinho nunca aprova este teste.
Crie uma API Key nova para o usuário da integração (avatar no canto superior direito → My Profile → aba Account Security → New API Key), copie exatamente no campo api_key, confira database no seletor da página de login do Odoo e username como o login desse usuário, e teste novamente.
O teste para com MISSING_CREDENTIALS ou MISSING_BASE_URL
Um dos quatro campos está vazio ou o endereço não serve. MISSING_BASE_URL significa que base_url está ausente ou não começa com http:// ou https://. MISSING_CREDENTIALS significa que database, username ou api_key está ausente, e o teste não consegue entrar de verdade sem os três.
Preencha os quatro campos conforme a etapa de preencher no Integration: base_url com o endereço completo da instância, incluindo http:// ou https://, database e username completos, e api_key colada inteira, sem cortar nada. Salve e teste novamente.
Todos os valores parecem certos, mas o Odoo Online continua sem conectar
Seu plano do Odoo Online não inclui acesso à API externa. Só o plano Custom abre a API externa no Odoo Online, então em outro plano a instância responde no navegador, mas as chamadas externas à API não estão disponíveis: os valores não são o problema.
Verifique primeiro o plano da instância do Odoo Online. Mude a instância para o plano Custom e teste a mesma conexão novamente com os mesmos quatro valores: enquanto isso, não fique mudando os valores.
Conectado, mas nenhum pedido de venda chega
A conexão está funcionando (o teste entrou de verdade), mas não há nada novo para trazer: o banco de dados do Odoo não tem pedidos de venda novos no intervalo de extração, ou os pedidos existentes não são pedidos de venda em sale.order.
Crie ou confirme um pedido de venda no Odoo, verifique se ele pertence ao mesmo banco de dados que a conexão usa, execute uma extração manual e confirme que o pedido aparece na prévia ou em Runs / Logs.