Procura um conector Odoo porque o ERP, sozinho, raramente chega: há uma loja online que gera encomendas, um banco que envia extratos, uma plataforma de pagamento, um software de faturação certificado a respeitar e folhas de cálculo que ninguém quer abandonar. A integração Odoo é o conjunto de ligações que impede a sua equipa de reescrever os mesmos dados em três sítios. Esta página explica o que a API Odoo oferece, o que se resolve com extensões já existentes, o que exige desenvolvimento e, sobretudo, como delimitar cada fluxo para que alguém o mantenha.
Não somos integrador nem representamos o editor: pomos a sua empresa em contacto com um integrador de Odoo adequado ao projeto, e é esse profissional que realiza e mantém as ligações.
O que é um conector Odoo, na prática
Um conector é qualquer mecanismo que move ou sincroniza dados entre o Odoo e outro sistema. Existem três famílias, com custos de manutenção muito diferentes:
- Funcionalidade nativa: o Odoo já traz a ligação nos seus módulos (por exemplo, fornecedores de pagamento no comércio eletrónico). É a opção mais estável, porque acompanha cada versão.
- Extensão de terceiros: um módulo instalado a partir de uma loja de aplicações. Poupa desenvolvimento, mas a qualidade e a manutenção dependem do autor.
- Integração à medida: um programa que fala com o Odoo pela API, escrito para o seu processo.
A comunidade Odoo é uma vantagem aqui: a empresa anuncia 50 aplicações principais e uma comunidade que contribuiu com mais de 50 000 aplicações adicionais. Essa abundância tem um reverso: nem todas são mantidas, e a escolha de uma extensão é uma decisão de risco, não apenas de funcionalidade. Para ver o que já existe no núcleo, consulte os módulos do Odoo.
A API Odoo: JSON-2, e o que fazer com XML-RPC
A documentação da API externa apresenta o JSON-2 como a API corrente. Descreve chaves de API, direitos de acesso, escolha da base de dados e transações. O XML-RPC e o JSON-RPC aparecem como históricos, com um guia de migração para o JSON-2.
Três consequências práticas para um dirigente ou um DSI:
- Integrações novas: devem nascer em JSON-2. Pedir hoje um desenvolvimento em XML-RPC é comprar uma dívida.
- Integrações herdadas: se um script antigo fala em XML-RPC ou JSON-RPC, inclua a migração no plano da próxima atualização de versão.
- Segurança: a chave de API pertence a um utilizador com direitos próprios. Crie um utilizador técnico por integração, com os acessos mínimos, e nunca reutilize a conta de uma pessoa.
Um ponto contratual que apanha muita gente de surpresa: o acesso à API externa faz parte das funções reservadas à formulação Custom. A Custom custa 44,90 EUR por utilizador e por mês (com desconto, a partir de 56,90 EUR, durante 12 meses), enquanto a Standard custa 24,90 EUR por utilizador e por mês (a partir de 31,10 EUR, também com desconto de 12 meses). Se o seu projeto depende de integrações por API, a escolha da formulação é uma decisão de arquitetura. Os detalhes de custo estão em preços do Odoo.
Quanto à licença, o Odoo 19 Community é distribuído sob LGPLv3, e o Odoo 19 Enterprise sob a licença Odoo Enterprise Edition v1.0, utilizável apenas com uma subscrição Enterprise válida para o número correto de utilizadores. Antes de escrever uma extensão, confirme com o integrador em que edição vai correr.
Onde correr o Odoo condiciona a integração
O Odoo implanta-se em Odoo Online (SaaS), em Odoo.sh (formulação Custom) ou nas suas instalações (formulação Custom). Para uma integração, a diferença é concreta:
| Modo de alojamento | Margem para extensões e integrações | Ponto de atenção |
|---|---|---|
| Odoo Online | Limitada ao que a plataforma permite | Confirmar antes se o módulo ou conector pretendido é aceite |
| Odoo.sh | Ampla, com código próprio | Os custos de Odoo.sh não estão incluídos na formulação |
| Nas suas instalações | Total, com a sua infraestrutura | Rede, cópias de segurança e atualizações ficam consigo |
Aprofundamos a escolha em alojamento e cloud do Odoo.
Comércio eletrónico: lojas, marketplaces e pagamentos
É a integração mais pedida pelas PME portuguesas com venda online. O módulo de comércio eletrónico do Odoo gere catálogo e variantes, contas de clientes, B2B e B2C, carrinhos abandonados, modos de entrega, devoluções e faturação, com vários sites. Liga-se a mais de vinte fornecedores de pagamento (Stripe, PayPal, Adyen, Mollie, Razorpay…) e distribui produtos através do Google Merchant Center, do TikTok, do Facebook ou do Instagram.
O que se deve decidir antes de ligar uma loja:
- Quem é o mestre do catálogo? Se a loja e o ERP criam produtos, haverá duplicados. Uma só origem.
- Quem é o mestre do stock? O stock disponível para venda deve vir do ERP, em tempo útil.
- Como se tratam devoluções e reembolsos? O reembolso no pagamento tem de ter uma nota de crédito correspondente.
- Como se emite o documento fiscal? Ver a secção seguinte: não é um pormenor.
Se a sua operação é sobretudo online, veja também o nosso guia de ERP para comércio eletrónico. A parte de stock e compras que alimenta a loja está em stocks e compras no Odoo.
Faturação certificada, SAF-T (PT) e ATCUD: o conector que não pode falhar
Em Portugal, uma integração que gera faturas não é apenas técnica: é fiscal. Qualquer fluxo que crie, altere ou anule documentos de venda tem de respeitar o software de faturação certificado pela AT, o ATCUD e o código QR nos documentos, e permitir o ficheiro SAF-T (PT) coerente com o que foi emitido. A sua contabilista certificada ou o seu contabilista certificado deve validar o desenho antes de entrar em produção, não depois da primeira inspeção.
Regras de bom senso para os fluxos:
- Um documento fiscal tem um só emissor. Se a loja emite e o ERP também, a sequência fica comprometida.
- Evite integrações que alterem documentos já comunicados; prefira notas de crédito.
- Registe cada falha de sincronização num ecrã que a equipa de contabilidade consiga consultar.
O enquadramento está nos nossos guias sobre SAF-T (PT) e ERP e sobre software de faturação certificado. Para a vertente de contabilidade do Odoo em si, consulte contabilidade e finanças no Odoo.
Bancos, pagamentos e tesouraria
A ligação ao banco serve duas coisas: receber extratos para a reconciliação e, em certos casos, enviar ordens de pagamento a fornecedores. Seja qual for a solução, pergunte ao integrador:
- Em que formato o seu banco disponibiliza os movimentos e com que periodicidade?
- A reconciliação é automática, assistida ou manual? Quem trata as exceções?
- Quem aprova um lote de pagamentos, e onde fica o registo dessa aprovação?
Convém tratar a segurança como requisito de projeto: credenciais bancárias não se guardam em ficheiros de configuração partilhados, e as permissões do utilizador técnico limitam-se ao necessário.
Outras integrações frequentes
Ferramentas de escritório e correio
A ligação com folhas de cálculo, calendário e correio eletrónico evita exportações manuais. Para os relatórios, muitas empresas começam pelos relatórios do próprio Odoo e só depois acrescentam uma ferramenta de BI quando o volume ou o cruzamento de fontes o justifica.
Business intelligence
Uma ferramenta de BI lê os dados do Odoo, normalmente por API ou por uma réplica da base, para cruzar vendas, stock e tesouraria. O cuidado é o mesmo de sempre: definir um indicador uma única vez, com uma fórmula única, para que a direção comercial e a financeira falem do mesmo número.
EDI, trocas com grandes clientes e transportadores
Quando um grande cliente impõe um formato de troca eletrónica de documentos, ou um transportador exige etiquetas e manifestos, a integração passa a ser parte do contrato comercial. Peça ao integrador um quadro dos formatos, dos prazos de resposta e do que acontece quando uma mensagem é rejeitada.
Assinatura eletrónica e documentos
Contratos, propostas e documentos de recursos humanos podem ser assinados em ferramentas externas. A questão a esclarecer é onde fica o documento assinado e quem tem acesso: no ERP, no serviço de assinatura, ou nos dois.
Planeamento industrial e logística
Num contexto produtivo, as ligações a máquinas, balanças ou sistemas de armazém pedem um cuidado particular com o tempo real. Veja o que o Odoo oferece em produção no Odoo e o enquadramento por sector em Odoo por sector.
Como delimitar um fluxo de integração, passo a passo
Uma integração mal definida é a primeira fonte de derrapagem de prazo. Peça (e escreva) uma ficha por fluxo, com estes campos:
| Campo | Pergunta a responder |
|---|---|
| Objetivo | Que tarefa manual elimina este fluxo? |
| Origem e destino | Quem envia, quem recebe, em que sentido? |
| Dado mestre | Qual sistema tem a última palavra sobre cada campo? |
| Frequência | Em tempo real, por lotes, a pedido? |
| Volumes | Quantas linhas num dia normal e num pico? (sem inventar: peça medição) |
| Erros | O que acontece quando falha? Quem é avisado? |
| Fiscal | Cria ou altera documentos fiscais? Quem valida? |
| Responsável | Quem corrige quando o fluxo para? |
| Versão | Como se testa a cada atualização do Odoo? |
Depois, ordene os fluxos por valor: comece por aqueles que eliminam retrabalho diário e deixe para uma segunda fase os que são apenas cómodos. Em projetos novos, esta ordenação faz parte da mise en place do Odoo.
Quem mantém uma integração depois da entrada em produção
Um conector não é um objeto que se entrega e esquece. Muda o Odoo, muda a loja, muda o banco, muda a AT. Por isso, a pergunta decisiva é sempre a mesma: quem responde quando o fluxo para?
Boas práticas a pedir no contrato:
- Documentação de cada fluxo (a ficha acima, atualizada).
- Ambiente de teste onde as atualizações se validam antes da produção.
- Monitorização: um alerta quando um fluxo falha, em vez de uma descoberta no fecho do mês.
- Contrato de suporte que diga se as integrações estão cobertas e em que condições. Veja suporte e manutenção do Odoo.
- Responsável interno pelos dados, normalmente alguém de finanças ou de operações, que saiba dizer o que está certo.
Quando uma integração herdada já falha ou ninguém a compreende, uma revisão independente costuma ser mais barata do que corrigir às cegas: ver auditoria e recuperação de projeto Odoo. E se a integração exige regras próprias que nenhum módulo cobre, enquadre-a primeiro como personalização do Odoo.
Atualizar de versão sem partir as integrações
As integrações são o ponto mais frágil numa mudança de versão. Antes de decidir atualizar, o integrador deve inventariar cada extensão e cada fluxo, confirmar se o autor já suporta a versão de destino e planear testes com dados reais. Uma extensão sem manutenção pode bloquear a atualização inteira. Para o resto do processo, consulte migração do Odoo.
Como escolher o integrador certo para as suas ligações
Nem todos os integradores têm a mesma experiência em integrações. Ao receber propostas, procure respostas concretas a estas perguntas:
- Já fizeram integrações com o mesmo tipo de loja, banco ou sistema de faturação que o seu?
- Como tratam a certificação fiscal e o ATCUD num fluxo de vendas?
- Quem escreve e quem mantém o código das integrações, e onde fica esse código?
- Como se garante que uma atualização do Odoo não interrompe a operação?
O processo completo de seleção está em como escolher um parceiro Odoo; o princípio de pedir várias propostas comparáveis explica-se em como funciona a mise en relation.
Em resumo
Um bom conector Odoo é pouco vistoso: nativo quando possível, extensão mantida quando adequada, API em JSON-2 quando é preciso construir, e sempre com um responsável, uma ficha de fluxo e uma validação fiscal para tudo o que toca em faturação. Se tem um projeto em curso, descreva as ligações de que precisa no formulário: o pedido é gratuito e serve para o pôr em contacto com um integrador adequado.
Perguntas frequentes
Qual é a API atual do Odoo para integrações?
A documentação da API externa apresenta o JSON-2 como a API corrente, com chaves de API, direitos de acesso, escolha da base de dados e transações. O XML-RPC e o JSON-RPC são tratados como históricos, e existe um guia de migração para o JSON-2. Quem herdou integrações antigas deve prever essa migração.
Preciso da formulação Custom para usar a API Odoo?
Sim. O acesso à API externa faz parte das funções reservadas à formulação Custom da Odoo. Se a sua base está na formulação Standard, uma integração por API externa obriga a rever o plano contratado antes de qualquer desenvolvimento.
Um conector Odoo comprado numa loja de extensões chega ou é preferível um desenvolvimento à medida?
Depende do fluxo. Um conector existente serve bem quando o seu processo é corrente e a extensão é mantida ao ritmo das versões do Odoo. Se o fluxo tem regras próprias, o desenvolvimento à medida evita contornos, mas implica um responsável pela manutenção a cada atualização.
O Odoo liga-se a uma loja online e a meios de pagamento?
O módulo de comércio eletrónico do Odoo gere catálogo, variantes, contas de clientes, B2B e B2C, carrinhos abandonados, entregas, devoluções e faturação. Liga-se a mais de vinte fornecedores de pagamento, como Stripe, PayPal, Adyen ou Mollie, e publica produtos no Google Merchant Center, TikTok, Facebook ou Instagram.
Quem mantém uma integração Odoo depois de entrar em produção?
Deve ficar escrito antes do arranque. Normalmente o integrador assegura a manutenção técnica no âmbito de um contrato de suporte, e a empresa nomeia um responsável interno pelos dados. Sem esta divisão, uma falha num fluxo fica sem dono e só se descobre no fecho do mês.
Fontes
Os nomes de software mencionados são marcas dos respetivos editores, citadas a título meramente informativo. Este site é independente e não é afiliado a nenhum editor.