Referência dos Módulos

bitconn_ixc_sync — Sincronização IXC Provedor

Sincroniza clientes e faturas do IXC Provedor para o Odoo 19 via API REST.

Funcionalidades

• Clientes: busca /webservice/v1/cliente → cria/atualiza res.partner
• Faturas: busca /webservice/v1/fn_areceber → cria/atualiza account.move
• 70+ campos ixc_* em account.move: valor, vencimento, PIX, boleto, gateway, renegociação
• 30+ campos ixc_* em res.partner: ID IXC, WhatsApp, satisfação, perfil
• Sincronização em background com progresso em tempo real (cursor separado)
• Agendamentos com placeholders {% raw %}{{today}}{% endraw %} e {% raw %}{{today+N}}{% endraw %}
• Paginação configurável: records_per_page, sync_page

Models principais

Model	Descrição
ixc.config	Configuração da conexão com IXC (URL, token, paginação)
ixc.sync.log	Log de sincronização com detalhes (registros, erros, duração)
ixc.sync.schedule	Agendamento de sincronizações automáticas

Campos principais em account.move

ixc_id, ixc_vencimento, ixc_valor, ixc_pix, ixc_boleto, ixc_gateway, ixc_renegociacao, ixc_protesto, ixc_forma_recebimento, ixc_filial

bitconn_collection — Gestão de Cobrança

Automação completa do ciclo de cobrança com régua inteligente, CRM e conformidade LGPD.

Funcionalidades

• 8 perfis de cliente: VIP, Empresarial, Alto Valor, Novo, Bom Pagador, Duvidoso, Mau Pagador, Recuperação
• 41 etapas em 7 réguas (D-7 até D+60)
• 6 templates HTML de e-mail com PIX, boleto e link IXC
• Pipeline CRM Kanban: Preventiva → Contato → Negociação → Promessa → Acordo → Recuperado
• Botão CRM na fatura: abre lead de cobrança com um clique
• Agenda de tarefas com calendário (ligação, visita, negociação)
• Negativação SPC/Serasa com protocolo, LGPD/CDC art. 43
• Histórico completo de ações por fatura

Models principais

Model	Descrição
collection.config	Configuração de réguas, perfis e templates
collection.action	Ação executada em uma fatura (e-mail, SMS, carta, etc.)
collection.negotiation	Negociação de dívida (acordo, parcelamento, desconto)

---

bitconn_ixc_bi — BI Financeiro

Dashboard de Business Intelligence com indicadores financeiros completos.

Funcionalidades

• Dashboard executivo com 20+ KPIs
• 9 faixas de aging: a_vencer_7, a_vencer_15, a_vencer_30, atraso_7, atraso_15, atraso_30, atraso_60, atraso_90, atraso_180+
• 7 status financeiros: pago, em_dia, a_vencer, inadimplente, protestado, renegociado, cancelado
• Score financeiro 0–100 e grau A–E por cliente
• Churn Risk (baixo/médio/alto/crítico) baseado em 4 fatores
• LTV, MRR, Ticket Médio por cliente
• SQL Views: bi_aging_report, bi_revenue_report para pivot/graph
• Listas operacionais: Clientes em Cobrança, Faturas em Cobrança
• Cron diário de recomputação de aging

Indicadores disponíveis

Categoria	KPIs
Receita	MRR, Receita Mensal, Ticket Médio, LTV
Inadimplência	Taxa de Inadimplência, Aging Médio, % Recuperação
Clientes	Total Ativos, Churn Rate, Score Médio
Cobrança	Taxa de Recuperação, Eficiência por Régua, Tempo Médio de Recuperação

---

bitconn_webhook — API de Integração

API JSON genérica para integrar o Odoo com sistemas externos (n8n, Zapier, Make, etc.).

Funcionalidades

• Endpoints REST: criar, ler, atualizar, deletar registros via JSON
• Extração aninhada: busca dados em registros relacionados automaticamente
• Payloads customizáveis: defina quais campos cada endpoint expõe
• Autenticação flexível: API key header, Basic Auth, token
• Log completo: IP, usuário, timestamp, payload, duração
• Rate limiting: proteção contra abusos

Operações suportadas

Operação	Método HTTP	Descrição
search_read	GET	Buscar registros com domain filter
create	POST	Criar novo registro
write	PUT	Atualizar registro existente
unlink	DELETE	Remover registro
default_payload	GET	Obter schema e valores padrão

Exemplo de chamada

bash