ULC Lab · implementação reproduzível
Laboratório: Implantação do Odoo Community com Integração de Estoque e Vendas em Ambiente Multi-Filial
Você terá um ambiente Odoo Community 16.0 funcional, com módulos de estoque e vendas integrados, simulando duas filiais conectadas. Todo o processo leva cerca de 2 a 3 horas.

- Duração estimada
- 120 min
- Passos
- 13
- Validações
- 4
- Versões da documentação consultada
- Odoo Community 16.0 · PostgreSQL 15 · Python 3.10 · wkhtmltopdf a versão estável atual
Demonstrar a implantação do Odoo Community em ambiente controlado, configurando módulos de estoque e vendas para múltiplas filiais, e integrando com um sistema de PDV aberto (Odoo POS). O laboratório cobre desde a instalação do banco de dados PostgreSQL até a configuração de usuários, produtos, filiais e a simulação de vendas e movimentação de estoque. O objetivo é mostrar, na prática, como automatizar operações típicas do varejo conectado usando apenas software livre.
Topologia
Duas máquinas virtuais Linux (Ubuntu 22.04), cada uma representando uma filial (Filial A: 192.168.56.10, Filial B: 192.168.56.11), ambas acessando um servidor Odoo Community central (192.168.56.20) e o banco PostgreSQL local. Usuários acessam via navegador na rede privada.
+----------------+
| Navegador Web |
+-------+--------+
|
-----------------------------
| | |
+--------------+ +--------------+ +----------------+
| Filial A VM | | Filial B VM | | Odoo Server VM |
| 192.168.56.10| | 192.168.56.11| | 192.168.56.20 |
+--------------+ +--------------+ +----------------+
|
+-------------------+
| PostgreSQL local |
+-------------------+Equipamentos e software
| Item | Requisito, licença ou versão |
|---|---|
| VM Ubuntu 22.04 LTS (Filial A) | 1 vCPU, 2 GB RAM, 10 GB disco, 1 interface de rede |
| VM Ubuntu 22.04 LTS (Filial B) | 1 vCPU, 2 GB RAM, 10 GB disco, 1 interface de rede |
| VM Ubuntu 22.04 LTS (Odoo Server) | 2 vCPU, 4 GB RAM, 20 GB disco, 1 interface de rede |
| Odoo Community | LGPLv3 · 16.0 |
| PostgreSQL | PostgreSQL License · 15 |
| Python | PSF License · 3.10 |
| wkhtmltopdf | LGPLv3 · a versão estável atual |
Roteiro
- Preparação das VMs e atualização do sistema
Garanta que todas as VMs estejam acessíveis via SSH e atualizadas. Isso evita conflitos de dependências.
sudo apt update && sudo apt upgrade -yO que você deve ver: Sistema atualizado sem erros.
- Instalação do PostgreSQL no servidor Odoo
Odoo exige PostgreSQL como backend. Instale e configure o serviço.
sudo apt install postgresql -yO que você deve ver: Serviço PostgreSQL ativo (systemctl status postgresql).
- Criação do usuário do banco de dados para o Odoo
Odoo precisa de um usuário dedicado para segurança e organização.
sudo -u postgres createuser -s odoo16O que você deve ver: Usuário odoo16 criado (verifique com sudo -u postgres psql -c '\du').
- Instalação de dependências Python e ferramentas auxiliares
Odoo depende de várias bibliotecas Python e do wkhtmltopdf para relatórios.
sudo apt install git python3-pip build-essential wget python3-dev python3-venv libxslt-dev libzip-dev libldap2-dev libsasl2-dev python3-setuptools node-less libjpeg-dev libpq-dev gcc g++ wkhtmltopdf -yO que você deve ver: Todos os pacotes instalados sem erros.
- Criação do ambiente virtual Python e instalação do Odoo Community
Isolar dependências do Odoo reduz riscos de conflitos.
python3 -m venv odoo-16-venv source odoo-16-venv/bin/activate git clone https://www.github.com/odoo/odoo --depth 1 --branch 16.0 odoo16 cd odoo16 pip install -r requirements.txtO que você deve ver: Dependências instaladas e código do Odoo disponível.
- Configuração do arquivo odoo.conf
Arquivo central de configuração do Odoo. Ajuste caminhos, usuário e porta.
[options] addons_path = /home/<seu_usuario>/odoo16/addons admin_passwd = admin db_host = False db_port = False db_user = odoo16 db_password = False logfile = /var/log/odoo16/odoo.log xmlrpc_port = 8069O que você deve ver: Arquivo salvo em /etc/odoo16.conf ou diretório de sua escolha.
- Inicialização do Odoo Server
Suba o serviço Odoo apontando para o arquivo de configuração.
./odoo-bin -c /etc/odoo16.confO que você deve ver: Log do Odoo exibindo 'Odoo ready' e escutando na porta 8069.
- Acesso à interface web do Odoo
Acesse pelo navegador para criar o banco de dados inicial.
http://192.168.56.20:8069O que você deve ver: Tela de criação de banco de dados Odoo.
- Criação do banco de dados e configuração inicial
Defina senha, idioma, país e nome da empresa. Isso estrutura o ambiente.
O que você deve ver: Dashboard inicial do Odoo carregado.
- Instalação dos módulos de Estoque, Vendas e Ponto de Venda (POS)
Esses módulos são essenciais para integração de operações de varejo.
No menu Apps, busque e instale: 'Inventory', 'Sales', 'Point of Sale'.O que você deve ver: Módulos disponíveis no dashboard.
- Configuração de múltiplas filiais (empresas)
Ative o modo multi-company para simular operações em duas filiais.
No menu Settings, ative 'Multi Companies'. Crie 'Filial A' e 'Filial B'.O que você deve ver: Filiais listadas no menu Companies.
- Cadastro de produtos e estoques por filial
Cada filial terá seu próprio estoque. Cadastre produtos e atribua quantidades iniciais.
No menu Inventory > Products, crie 2 produtos. Em Inventory Adjustments, ajuste o estoque para cada filial.O que você deve ver: Produtos com estoque inicial em cada filial.
- Simulação de venda em cada filial via POS
Abra o POS de cada filial e realize uma venda para testar integração.
No menu Point of Sale, crie uma sessão para cada filial. Realize uma venda.O que você deve ver: Venda registrada e estoque reduzido na filial correspondente.
Como saber que funcionou
| Teste | Comando | Critério |
|---|---|---|
| Acesso simultâneo ao Odoo de ambas as filiais | Acesse http://192.168.56.20:8069 de ambas as VMs | Login e dashboard disponíveis sem erro |
| Visualização de produtos e estoques distintos por filial | No menu Inventory, alterne entre empresas | Estoque reflete apenas os produtos da filial selecionada |
| Registro de venda no POS e baixa de estoque | Realize venda no POS e confira Inventory > Products | Quantidade do produto reduzida após venda |
| Geração de relatório de vendas por filial | Menu Sales > Reporting > Sales | Relatório exibe vendas separadas por filial |
Troubleshooting
| Sintoma | Causa provável | Correção |
|---|---|---|
| Erro de login no Odoo | Usuário do banco de dados não criado ou senha incorreta | Verifique criação do usuário odoo16 e ajuste no odoo.conf |
| Módulos não aparecem para instalação | Caminho addons_path incorreto | Confirme o caminho no odoo.conf e reinicie o serviço |
| POS não registra vendas | Sessão do POS não aberta ou configurada | Abra nova sessão no menu Point of Sale |
| Estoque não é atualizado após venda | Produto não está configurado como gerenciável em estoque | Edite o produto e ative 'Can be Stocked' |
Segurança e hardening
- Altere a senha padrão do usuário admin após a instalação
- Restrinja o acesso à porta 8069 apenas à rede interna
- Não exponha o PostgreSQL para redes externas
- Revise permissões dos usuários Odoo e do sistema operacional
Checklist final
- Publicado
- 09/09/2026
- Última revisão
- 09/09/2026
- Versão do conteúdo
- 1.0
- Referências
- 0 oficiais
- Revisão técnica
- redação e revisão por IA, URLs conferidas na publicação
- Status
- Atual
