Saltar para o conteúdo
Tejobit

Faturação

Integração Odoo

Encomendas, contactos, stock e faturas sincronizados entre o Odoo e os outros sistemas da empresa, com regras desenhadas para o seu processo.

Pedir esta integração Ver todas as integrações

Visão geral

Odoo

O Odoo é um ERP modular de origem belga: vendas, compras, inventário, contabilidade, CRM, projetos e dezenas de outras aplicações sobre a mesma base de dados. Tem localização portuguesa, com plano de contas, impostos e SAF-T, mas cada instalação é diferente e raramente fala sozinha com tudo o resto.

A Tejobit liga o Odoo às peças que ficam de fora: uma loja WooCommerce, um CRM como o HubSpot, um sistema de reservas, um armazém externo ou um ERP antigo em transição. A ligação usa a API externa do Odoo (JSON-2 a partir da versão 19, XML-RPC e JSON-RPC nas anteriores) para ler e escrever modelos como res.partner, sale.order, product.product, stock.picking e account.move.

No sentido inverso, as regras de automação do Odoo podem enviar webhooks quando um registo muda, por exemplo quando uma encomenda é confirmada ou uma fatura é publicada. Por isso esta integração é mais trabalhosa do que as outras: há campos personalizados, fluxos de aprovação e várias empresas no mesmo Odoo a considerar.

Casos de uso

Para que serve

  • Loja WooCommerce cujas encomendas entram no Odoo como sale.order, reservam stock e geram a fatura na contabilidade.
  • Grossista com Odoo e uma loja B2B à parte, com preços e stock por cliente sincronizados de hora a hora.
  • Negócios ganhos no HubSpot que passam a cotação no Odoo, sem duplicar contactos.
  • Migração gradual do Primavera para o Odoo, com as duas bases sincronizadas durante a transição.
  • Faturas publicadas no Odoo enviadas para um portal de cliente ou para um sistema de pagamentos.
IN

O que a ligação escuta

  • Webhooks enviados pelas regras de automação do Odoo quando um registo é criado ou alterado.
  • Encomenda paga na loja online ou negócio ganho no CRM.
  • Movimentos de stock no armazém externo.
  • Leituras agendadas por data de alteração (write_date) para modelos sem automação.
OUT

O que a ligação faz

  • Cria ou atualiza contactos (res.partner) com NIF, morada e condições comerciais.
  • Cria encomendas de venda, confirma-as e acompanha as entregas.
  • Sincroniza produtos, variantes, preços e quantidades em stock.
  • Cria ou lê faturas (account.move) e pagamentos para outros sistemas.
  • Preenche campos personalizados que a empresa acrescentou ao Odoo.

Como funciona

Do pedido à ligação em funcionamento

  1. 01

    Pedido

    O formulário indica a integração, as ferramentas envolvidas e o que deve acontecer em cada caso.

  2. 02

    Análise e proposta

    A Tejobit confirma o que a API permite e envia uma proposta com o fluxo, o preço e o prazo.

  3. 03

    Configuração e testes

    A ligação é configurada com as contas do negócio e testada com casos reais antes de ficar ativa.

  4. 04

    Manutenção e monitorização

    A Tejobit aloja a ligação, acompanha os erros e adapta-a quando a API muda.

A ligação corre na infraestrutura da Tejobit. A mensalidade cobre o alojamento, a monitorização e as alterações da API.

O que é preciso preparar

  • Utilizador técnico no Odoo com uma chave de API e só as permissões necessárias.
  • No Odoo Online, um plano que dê acesso à API externa (o Odoo indica o plano Custom para a API JSON-2).
  • Versão do Odoo e lista de módulos e campos personalizados instalados.
  • Mapa de processos: que sistema manda em cada dado e o que acontece em caso de conflito.

Por segurança, não envie passwords, chaves API ou tokens pelo formulário. As credenciais são pedidas por um canal seguro quando a configuração começa.

Limites

  • Cada instalação Odoo é diferente; módulos à medida podem exigir trabalho adicional de mapeamento.
  • As APIs XML-RPC e JSON-RPC estão marcadas como antigas a partir da versão 19, por isso integrações em versões mais antigas são revistas nas atualizações.
  • A certificação de faturação em Portugal depende da versão e da configuração do Odoo; a integração não a substitui e deve ser confirmada com o contabilista.

Perguntas frequentes

Antes de começar

Porque é que a integração Odoo custa mais do que as outras?

Porque o Odoo é um ERP com muitos modelos, módulos e campos personalizados. A ligação tem de respeitar fluxos de aprovação, várias empresas e regras de stock, o que dá mais trabalho a montar e a manter.

Funciona com Odoo Online, Odoo.sh e instalação própria?

Sim, nas três. No Odoo Online o acesso à API depende do plano; no Odoo.sh e em servidores próprios depende sobretudo da versão e dos módulos.

O Odoo emite faturas válidas em Portugal?

O Odoo tem localização portuguesa, mas a validade fiscal depende da versão, dos módulos e da configuração. Esse ponto deve ser confirmado com o contabilista antes de usar o Odoo como faturação principal.

Dá para sincronizar nos dois sentidos?

Sim. A Tejobit define com a equipa qual sistema é a fonte de cada campo, para evitar que um lado sobrescreva o outro.

Integrações relacionadas

Ver todas as integrações

Ativar a integração Odoo?

Descreva o que deve passar entre as ferramentas. A resposta confirma a viabilidade, o preço e o prazo.

Fale sobre o projeto geral@tejobit.com