Guia de Instalação

Pré-requisitos

• Odoo 19 (Community ou Enterprise) instalado e funcionando
• Acesso à API REST do IXC Provedor (token de autenticação)
• Python 3.10 ou superior

Instalação dos Módulos

1. Copie os módulos para o addons path

cp -r bitconn_ixc_sync bitconn_collection bitconn_ixc_bi bitconn_webhook /seu/addons/path/

2. Instale na ordem correta

./odoo-bin -c odoo.conf -i bitconn_ixc_sync,bitconn_collection,bitconn_ixc_bi,bitconn_webhook

Ou instale um por vez:

./odoo-bin -c odoo.conf -i bitconn_ixc_sync
./odoo-bin -c odoo.conf -i bitconn_collection
./odoo-bin -c odoo.conf -i bitconn_ixc_bi
./odoo-bin -c odoo.conf -i bitconn_webhook

3. Atualize a lista de apps

No Odoo, vá em Apps → Atualizar Lista de Apps. Os módulos aparecerão com o prefixo bitconn_.

Configuração Inicial

IXC Sync

1. Acesse o menu IXC Sync → Configurações
2. Clique em Criar e preencha:
   • Nome: Produção
   • URL Base: https://seudominio.ixcprovedor.com.br/webservice/v1
   • Token: Token de autenticação Basic Auth fornecido pelo IXC
   • Usuário: ID do usuário IXC (ex: 393)
3. Clique em Sincronizar Parceiros e aguarde a conclusão
4. Clique em Sincronizar Faturas e aguarde

A primeira sincronização pode levar vários minutos dependendo do volume de dados. As sincronizações seguintes são incrementais.

Collection (Cobrança)

1. Vá em Cobrança → Configuração → Réguas
2. Revise as 8 réguas pré-configuradas (VIP, Empresarial, Bom Pagador, etc.)
3. Ajuste os dias de cada etapa conforme a política da sua empresa
4. Configure os templates de e-mail em Cobrança → Configuração → Templates
5. Configure perfis de cliente em Cobrança → Configuração → Perfis

IXC BI

1. Acesse BI Financeiro → Dashboard
2. Clique em Calcular para gerar os indicadores iniciais
3. O cron diário manterá os dados atualizados automaticamente

Webhook

1. Vá em Webhook → Configuração → Endpoints
2. Crie um endpoint para cada integração desejada
3. Configure os campos disponíveis e o método de autenticação
4. Use a URL gerada nos seus fluxos do n8n, Zapier ou outro sistema

Atualização de módulos

Para atualizar um módulo após alterações no código:

./odoo-bin -c odoo.conf -u bitconn_ixc_sync
./odoo-bin -c odoo.conf -u bitconn_collection
./odoo-bin -c odoo.conf -u bitconn_ixc_bi

Troubleshooting

Erro de conexão com IXC: Verifique se o IP do servidor Odoo está na whitelist do IXC.

Módulo não aparece: Atualize a lista de apps (Apps → Atualizar Lista) e remova filtros.

Erro na sincronização: Verifique os logs do Odoo. O IXC Sync registra progresso detalhado no log.