Conexão Azul Digital - BI Financeiro IXC

Accounting/BI · v19.0.1.2.0 · OPL-1

Conexão Azul Digital IXC BI - Business Intelligence Financeiro

Dependências

bitconn_ixc_sync, bitconn_collection, account, mail

Documentação

Business Intelligence financeiro para provedores de internet no Odoo 19

Módulo complementar ao bitconn_ixc_sync e bitconn_collection que adiciona campos de aging calculados em faturas, score financeiro e risco de churn em clientes, relatórios pivot/graph para análise gerencial e dashboard com KPIs em tempo real.

Dependências: bitconn_ixc_sync, bitconn_collection, account, mail

Visão Geral

bitconn_ixc_sync          →   Sincroniza faturas e clientes do IXC Provedor
       ↓
bitconn_collection        →   Classifica clientes, executa régua de cobrança
       ↓
bitconn_ixc_bi            →   Calcula aging, scores, KPIs e relatórios analíticos

Funcionalidades

1. Campos de Aging em Faturas (`account.move`)

Campos computados e armazenados que enriquecem cada fatura com informações de análise financeira.

`bi_dias_atraso` — Dias em Atraso

Calcula os dias de atraso em relação à data de vencimento IXC (ixc_data_vencimento). Valor negativo indica dias até o vencimento.

`bi_faixa_atraso` — Faixa de Atraso (9 buckets)

Valor	Intervalo
`em_dia`	Pago ou sem vencimento
`a_vencer_7`	Vence em até 7 dias
`a_vencer_15`	Vence em 8–15 dias
`a_vencer_30`	Vence em 16–30 dias
`atraso_1_30`	1–30 dias em atraso
`atraso_31_60`	31–60 dias em atraso
`atraso_61_90`	61–90 dias em atraso
`atraso_91_180`	91–180 dias em atraso
`atraso_180`	Mais de 180 dias em atraso

`bi_status_financeiro` — Status Financeiro (7 estados)

Valor	Descrição
`pago`	Fatura recebida/quitada
`em_dia`	Em aberto, dentro do prazo
`a_vencer`	Vence nos próximos 30 dias
`inadimplente`	Vencida e não paga
`protestado`	Em protesto (`ixc_titulo_protestado = True`)
`renegociado`	Renegociada (`ixc_titulo_renegociado = True`)
`cancelado`	Fatura cancelada/revertida

`bi_eficiencia_cobranca` — Eficiência de Cobrança (%)

(ixc_valor_recebido / ixc_valor) * 100 — mostra quanto do valor original foi efetivamente recebido.

`bi_is_renegociado` + `bi_valor_perdido`

Identifica faturas renegociadas e calcula o desconto concedido (ixc_valor - ixc_valor).

`bi_prazo_recebimento` — Prazo Médio de Recebimento

Dias entre a emissão (ixc_data_emissao) e o pagamento (ixc_pagamento_data).

Screenshot — Fatura com Campos de Aging

Screenshot — Lista de Faturas com Decoração por Status

2. Score Financeiro e BI no Parceiro (`res.partner`)

Campos computados e armazenados que dão ao gestor uma visão 360° do cliente.

`bi_financial_score` — Score Financeiro (0–100)

Algoritmo baseado em 5 fatores:

Fator	Impacto
Taxa de pagamento em dia	+30 pontos máx.
Histórico extenso (10+ faturas)	+10 pontos
Qtd. de faturas vencidas	-5 por fatura, máx. -25
Dias máximos de atraso	-1 por 10 dias, máx. -15
Suspensões	-10 por suspensão, máx. -20

`bi_financial_grade` — Grau Financeiro

Grau	Score	Significado
A	≥ 80	Excelente pagador
B	65–79	Bom pagador
C	45–64	Regular
D	25–44	Ruim
E	< 25	Crítico

`bi_ltv_total` — LTV (Lifetime Value)

Soma total de ixc_valor_recebido de todas as faturas pagas do cliente.

`bi_mrr` — MRR Estimado

Receita média mensal dos últimos 3 meses (base para projeções de receita).

`bi_ticket_medio` — Ticket Médio

Valor médio por fatura do cliente.

`bi_churn_risk` + `bi_churn_score` — Risco de Churn

Algoritmo combinando 4 fatores:

Fator	Impacto
Score financeiro baixo	+10 a +40 pontos
Atraso médio alto	+10 a +30 pontos
Dias sem pagamento	+10 a +20 pontos
3+ faturas abertas	+10 pontos

Nível	Churn Score
`baixo`	< 30
`medio`	30–49
`alto`	50–69
`critico`	≥ 70

Comportamento de Pagamento

Campo	Descrição
`bi_avg_payment_delay`	Atraso médio em dias (faturas em atraso)
`bi_total_open_balance`	Saldo total em aberto (R$)
`bi_open_invoice_count`	Quantidade de faturas em aberto
`bi_last_payment_date`	Data do último pagamento registrado
`bi_days_since_last_payment`	Dias desde o último pagamento
`bi_renegociation_count`	Quantidade de faturas renegociadas
`bi_is_negativado`	True se possui negativação ativa (SPC/Serasa)
`bi_tenure_months`	Tempo de relacionamento em meses

Botão “Recalcular Scores”

Ação manual action_recompute_bi_scores() para forçar recomputação de todos os scores de um parceiro selecionado.

Screenshot — Aba BI no Parceiro

Screenshot — Lista de Clientes com Score Progressbar

3. Views Operacionais de Clientes e Faturas

Clientes em Cobrança (`Cobrança > Clientes em Cobrança`)

Lista operacional de clientes com saldo em aberto, ordenada por valor total em aberto (descrescente).

Colunas:

Nome, CPF/CNPJ
Valor Aberto (R$) com soma total
Atraso Médio (dias)
Qtd. Faturas em aberto
Último Pagamento, Dias s/ Pagamento
Score Financeiro (progressbar)
Grau Financeiro (A–E)
Risco de Churn
Régua de Cobrança
Qtd. Renegociações
WhatsApp, Telefone (opcionais)

Filtros disponíveis:

Todos com saldo aberto
Vencidos (atraso > 0)
Negativados (bi_is_negativado = True)
Renegociados
Score Ruim (< 40)
Churn Crítico / Alto
+60 dias sem pagamento

Agrupamento: por Régua, Grau Financeiro, Risco de Churn

Decoração visual:

Vermelho: atraso > 90 dias OU churn crítico
Amarelo: atraso 31–90 dias OU churn alto
Azul: a vencer em 7 dias OU churn baixo

Screenshot — Clientes em Cobrança (lista operacional)

Faturas em Cobrança (`Cobrança > Faturas em Cobrança`)

Lista de faturas IXC com status inadimplente ou a vencer, com todos os campos de BI e botão de criação de lead CRM inline.

Colunas principais:

Cliente, Vencimento
Dias Atraso, Faixa, Status Financeiro
Valor, Recebido, Em Aberto (com totais)
Eficiência (progressbar)
Forma, Filial, Status Cobrança (opcionais)
CRM Lead vinculado + botão inline criar/abrir

Filtros: inadimplentes, a vencer, protestados, renegociados, crítico +90, grave 31–60, sem lead CRM, PIX, boleto

Agrupamento: faixa de atraso, status financeiro, cliente, filial, forma, mês vencimento

Screenshot — Faturas em Cobrança com Botão CRM inline

4. Dashboard KPI (`BI Financeiro > Dashboard`)

TransientModel com 20+ indicadores computados no momento em que o botão “Calcular” é acionado. Permite selecionar o período de análise.

Períodos disponíveis

Mês atual · Mês anterior · Trimestre · Ano · Todo o histórico

KPIs de Receita

KPI	Descrição
Receita Bruta	Soma de `ixc_valor` no período
Receita Recebida	Soma de `ixc_valor_recebido`
A Receber (em aberto)	Soma de `ixc_valor_aberto`
Vencido não Recebido	Valor em aberto de faturas inadimplentes
Receita Recuperada	Valor recebido de faturas renegociadas

KPIs de Inadimplência

KPI	Descrição
Clientes Inadimplentes	Qtd. de parceiros com fatura em atraso
Taxa de Inadimplência	`inadimplentes / total clientes * 100`
Taxa de Recuperação	`receita_recebida / receita_bruta * 100`
A vencer (7 dias)	Qtd. faturas com vencimento em ≤ 7 dias
Atraso 1–30, 31–60, 61–90, +90	Qtd. e valor por faixa
Protestados	Qtd. faturas em protesto
Renegociados	Qtd. faturas renegociadas

KPIs de Clientes

KPI	Descrição
Total Clientes	Qtd. de parceiros com fatura no período
Clientes Adimplentes	Sem faturas em atraso
Churn Crítico	Clientes com `bi_churn_risk = 'critico'`
Ticket Médio	Média de `ixc_valor` por fatura
MRR Total	Soma de `bi_mrr` de todos os parceiros

KPIs Operacionais (Cobrança)

KPI	Descrição
Ações de Hoje	Etapas da régua a executar hoje
Negativações Pendentes	Registros de negativação em andamento
Acordos Quebrados	Leads com `acordo_quebrado = True`
Tarefas Atrasadas	Tarefas da agenda vencidas não concluídas

Screenshot — Dashboard KPI (painel completo)

Screenshot — Dashboard KPI (seção Inadimplência)

5. Relatórios de Aging — SQL Views

Views SQL otimizadas para pivot e gráficos gerenciais.

`bi.aging.report` — Aging de Inadimplência

Disponível em: BI Financeiro > Análises > Inadimplência por Faixa

Análises pré-configuradas:

Inadimplência por Faixa de Atraso (gráfico de barras/pizza)
Inadimplência por Filial IXC (pivot)
Inadimplência por Forma de Recebimento (pivot)

Filtros de busca:

Inadimplentes, A Vencer, Protestados, Renegociados
Faixa específica (31–60, 61–90, +90)
Filial, Forma, Régua de cobrança, Mês

Screenshot — Relatório de Aging por Faixa (gráfico)

Screenshot — Pivot de Inadimplência por Filial

`bi.revenue.report` — Relatório de Receita Mensal

Disponível em: BI Financeiro > Análises > Evolução da Receita

Métricas por mês/filial/forma:

Valor Total, Recebido, Em Aberto, Perdido
Qtd. Faturas (total, pagas, vencidas)
Taxa de Inadimplência (%)
Taxa de Recuperação (%)

Análises pré-configuradas:

Evolução da Receita (série temporal)
Receita por Filial IXC

Screenshot — Evolução de Receita (gráfico de linha)

6. Alertas Gerenciais

Ações pré-configuradas para monitoramento rápido:

Menu	Filtro
A Vencer (7 dias)	`bi_status_financeiro = 'a_vencer'`
Títulos Críticos (+90 dias)	`bi_faixa_atraso in (91–180, +180)`
Títulos Renegociados	`bi_is_renegociado = True`

7. Automação (ir.cron)

Job	Frequência	Método
Recalcular Aging BI (Faturas)	Diário (02:00)	`_cron_compute_bi_aging()`

Recomputa bi_dias_atraso, bi_faixa_atraso e bi_status_financeiro de todas as faturas IXC postadas, garantindo dados frescos para o dashboard e relatórios.

Menus e Navegação

Cobrança
├── Clientes em Cobrança       ← res.partner com saldo aberto
└── Faturas em Cobrança        ← account.move IXC inadimplentes/a vencer

BI Financeiro
├── Dashboard                  ← KPI em tempo real
├── Análises
│   ├── Inadimplência por Faixa
│   ├── Inadimplência por Filial
│   ├── Inadimplência por Forma de Recebimento
│   └── Evolução da Receita
│   └── Receita por Filial
├── Clientes
│   ├── Análise Financeira de Clientes
│   ├── Top Devedores
│   └── Risco de Churn
└── Alertas
    ├── A Vencer (7 dias)
    ├── Títulos Críticos (+90 dias)
    └── Títulos Renegociados

Estrutura do Módulo

bitconn_ixc_bi/
├── data/
│   └── bi_cron.xml                       # Cron de recomputação diária
├── models/
│   ├── account_move_bi.py                # account.move: campos de aging e BI
│   ├── res_partner_bi.py                 # res.partner: score, churn, LTV, MRR
│   ├── bi_report.py                      # bi.aging.report + bi.revenue.report (SQL views)
│   └── bi_kpi_dashboard.py               # bi.kpi.dashboard (TransientModel)
├── views/
│   ├── account_move_bi_views.xml         # Herança da fatura com campos BI
│   ├── res_partner_bi_views.xml          # Herança do parceiro com aba BI
│   ├── collection_clientes_views.xml     # Clientes e Faturas em Cobrança
│   ├── bi_dashboard_views.xml            # Actions dos relatórios (aging, revenue, alertas)
│   ├── bi_kpi_dashboard_views.xml        # Dashboard de KPIs
│   └── menu_views.xml
└── security/
    └── ir.model.access.csv

Modelos e Permissões

Modelo	Manager	Usuário
`bi.aging.report`	R	R
`bi.revenue.report`	R	R
`bi.kpi.dashboard`	CRUD	RWC

Instalação

# Stack completo recomendado (na ordem correta)
./odoo-bin -c odoo.conf -i bitconn_ixc_sync,bitconn_collection,bitconn_ixc_bi

Após a instalação:

Configure a conexão IXC em IXC Sync > Configurações
Execute a sincronização inicial (Sincronizar Parceiros e Sincronizar Faturas)
Acesse Cobrança > Configuração > Réguas para revisar as 8 réguas pré-configuradas
Acesse BI Financeiro > Dashboard e clique em Calcular para ver os KPIs

Autores

Diego F. Rodrigues — [email protected] Diego Santos — [email protected] Site: conexaoazul.com Licença: Proprietária (OPL-1)