Conectando o Odoo

A conexão com o Odoo é feita por uma API key gerada no próprio Odoo. Quem costuma gerar a chave é o administrador da base — o ideal é que ela pertença a um usuário dedicado à integração, e nenhuma senha de usuário é usada.

Esta integração está em homologação: a conexão funciona normalmente, mas as consultas no chat ainda estão em validação.

Antes de começar

• A API externa do Odoo só existe no plano Custom. Em outros planos, a conexão não funciona.
• A integração cobre o Odoo Online e o Odoo.sh (bases no endereço suaempresa.odoo.com). Instalação própria fica fora.
• Peça ao administrador do Odoo:
  • o endereço da base (ex.: suaempresa.odoo.com);
  • uma API key, gerada em Preferências → Segurança da conta → Nova chave de API, de preferência com um usuário dedicado à integração;
  • a data de validade que o Odoo mostra ao criar a chave — o Odoo limita a validade a no máximo três meses.

Passo a passo

1. Acesse Configurações → Integrações na Toca.
2. Localize o card Odoo e clique no botão de conexão.
3. Preencha os campos:
   • Endereço da base — ex.: suaempresa.odoo.com.
   • API key — a chave gerada no Odoo.
   • Validade da chave (opcional) — a data que o Odoo mostrou ao criar a chave. Com ela, a Toca avisa antes de a chave vencer.
4. Salve. O card fica marcado como conectado.

O que a Toca acessa

Com a conexão ativa, a Toca lê faturas e lançamentos contábeis, pedidos de venda e de compra, estoque, produtos e contatos — conforme os módulos que a empresa tiver instalado. A integração é somente leitura: a Toca não cria, não altera e não exclui nada no Odoo.

Manutenção da conexão

A API key do Odoo expira em no máximo três meses, sem renovação automática. Quando vencer, gere uma chave nova no Odoo e atualize-a no card em Configurações → Integrações. Se você informou a validade ao conectar, a Toca avisa antes da data. A chave também deixa de funcionar se o administrador a revogar no Odoo.

Problemas comuns

• Erro de autenticação logo após conectar — confira se a chave foi colada sem espaços extras. Em base recém-contratada, o motivo mais comum é o plano: só o plano Custom tem API externa.
• Erro de autenticação numa conexão que funcionava — a chave provavelmente venceu (a validade máxima é de três meses) ou foi revogada. Peça uma chave nova ao administrador e atualize o card.
• Endereço não aceito — o campo aceita bases do Odoo Online e do Odoo.sh (suaempresa.odoo.com). Instalação própria não é coberta por esta integração.