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

bash

2. Instale na ordem correta

bash

Ou instale um por vez:

bash

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)
• Clique em Sincronizar Parceiros e aguarde a conclusão
• 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)

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

IXC BI

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

Webhook

• Vá em Webhook → Configuração → Endpoints
• Crie um endpoint para cada integração desejada
• Configure os campos disponíveis e o método de autenticação
• 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:

bash

Troubleshooting

Verifique se o IP do servidor Odoo está na whitelist do IXC.

Atualize a lista de apps (Apps → Atualizar Lista) e remova filtros.

Verifique os logs do Odoo. O IXC Sync registra progresso detalhado no log.