API do Odoo: modelos, registros e ERP com agentes de IA
O Odoo oferece uma API externa que dá acesso aos modelos do ERP, como contatos, vendas, compras, estoque, contabilidade e CRM, com as mesmas regras de permissão dos usuários. É usada por integradores e empresas que conectam o Odoo a outros sistemas. O acesso é com usuário e chave de API, nas edições que permitem acesso externo.
Os grandes recursos da API, em português claro.
Buscar e ler registros de qualquer modelo, com filtros.
Criar, atualizar e arquivar registros.
Cotações, pedidos, oportunidades e clientes.
Produtos, movimentações e pedidos de compra.
Faturas, pagamentos e lançamentos, conforme permissões.
Chamar ações do ERP, como confirmar um pedido.
Como se acessa a API do Odoo.
- Com credencial da sua empresaUsuário do Odoo com chave de API gerada nas preferências, usada nas chamadas XML-RPC ou JSON-RPC. As permissões seguem as do usuário.
- Documentação oficialwww.odoo.com/documentation
- O acesso externo depende da edição e do plano do Odoo.
- Use usuário com permissões mínimas; a API respeita as regras do usuário.
- Lançamentos contábeis devem ter aprovação.
- api odoo
- odoo api
- odoo external api
- odoo xmlrpc
- integração odoo api
- odoo api documentação
O que um agente do iTeam faz com a API do Odoo.
O agente lê o pedido no e-mail, monta a cotação no Odoo e manda ao vendedor para aprovar.
O agente olha estoque mínimo e propõe pedidos de compra para aprovação.
O agente lista faturas vencidas e envia lembretes, registrando no histórico.
O cliente pergunta o status e o agente consulta entrega e fatura no Odoo.
Da credencial ao agente trabalhando, com aprovação.
Usuário de integração
Crie um usuário no Odoo com grupos de acesso mínimos e gere a chave de API.
Cofre e modelos permitidos
Guarde no cofre do iTeam e defina quais modelos e ações cada agente pode usar.
Teste em base de teste
Use uma base de testes, se houver, e aprove confirmações e lançamentos no início.
Dúvidas sobre a API do Odoo.
A API do Odoo é gratuita?
Depende da edição. A API faz parte do Odoo, mas o acesso externo pode exigir plano específico no Odoo Online. Confira as condições atuais.
Preciso programar para usar a API do Odoo com o iTeam?
Não necessariamente. A ferramenta HTTP do iTeam lê a documentação da API e aprende os endpoints, e o time de implantação configura credenciais, permissões e testes com você.
O Odoo tem API REST?
A API externa tradicional do Odoo usa XML-RPC e JSON-RPC. Versões e módulos podem trazer outras opções; confira a documentação da sua versão.
A API XML-RPC do Odoo ainda é a forma recomendada de integrar um agente?
Não: a documentação oficial marca as APIs XML-RPC e JSON-RPC como obsoletas desde o Odoo 19, com a API JSON-2 como substituta, chamada em /json/2/ com bearer token. A remoção das antigas está prevista em versão futura, e as fontes citam datas diferentes. Para projetos novos, comece pela JSON-2.
Como o agente de IA se autentica no Odoo?
Com a chave de API gerada nas preferências do usuário, usada em vez da senha, e as permissões são as do próprio usuário. Crie um usuário de integração com os direitos mínimos de acesso e gere a chave dele. Em ambientes com várias bases, informe a base nos cabeçalhos da chamada.
O acesso externo à API do Odoo depende do plano?
Depende no Odoo Online: a documentação diz que o acesso externo aos dados só existe nos planos personalizados, e não nos planos One App Free e Standard. Em instalações próprias, o acesso é controlado por você. Confirme na página oficial o plano contratado antes de planejar o agente.
O Odoo oferece uma API HTTP moderna ou só XML-RPC?
Oferece a API JSON-2, a partir do Odoo 19, com caminho de modelo e método, corpo JSON e bearer token. Não é um REST clássico por recurso, mas se aproxima na prática. As APIs XML-RPC e JSON-RPC anteriores são obsoletas. Confira a documentação da sua versão para o padrão exato.
O que o agente pode fazer com os modelos do Odoo?
Ler registros de contatos, vendas, compras, estoque e contabilidade, criar e editar registros e chamar métodos de modelo, como confirmar um pedido. As permissões do usuário de integração limitam tudo. Um uso comum: o agente consulta pedidos atrasados e cria atividades de cobrança. A confirmação de pedidos e lançamentos passa por aprovação.
Existe ambiente de testes do Odoo para validar o agente?
Existe, de forma prática: é possível criar uma base de teste ou um ambiente de homologação, no Odoo.sh ou em servidor próprio, copiando dados anonimizados. Confira na documentação as regras do seu plano. Teste ali o usuário de integração e as permissões antes de ligar o agente à base de produção.
Lançamentos contábeis feitos pelo agente no Odoo precisam de aprovação?
Precisam: lançamentos afetam balanço e impostos. O agente deve criar o lançamento em rascunho, com o documento de origem, e o contador conferir e confirmar. Evite que o usuário de integração tenha o direito de postar lançamentos. A trilha de auditoria do iTeam registra quem pediu e quem aprovou.
Quando um agente de IA com o Odoo não compensa?
Quando o Odoo está pouco usado, cheio de cadastros duplicados, ou quando o plano não libera acesso externo. Também compensa pouco se o que você precisa é um relatório fixo que o próprio Odoo gera. Funciona bem em empresas com muita operação no Odoo e equipes que gastam tempo conferindo e cruzando dados.
Outras APIs da categoria.
Times de IA prontos que usam Odoo.
Controle de estoque e reposição
Os agentes leem vendas e saldo no Bling, no Tiny, no Omie ou no Odoo, preveem a demanda e montam a sugestão de compra para você aprovar.
Compras e cotações
O pedido de compra entra, as cotações saem para os fornecedores, as respostas viram um quadro comparativo e quem aprova decide com o histórico na tela…
