Entrega BI Financeiro v2.1 — Brasilink

Data: 2026-05-11 Versão módulo: 19.0.1.2.0 → upgrade realizado em produção Ambiente: https://crm.brasilink.net.br/odoo Banco: odoo19

1. O que já está em produção (pode validar agora)

1.1 Menu Cobrança — "Iniciar Cobrança (1º Débito 30+d)"

Novo menu dentro de Cobrança > Iniciar Cobrança (1º Débito 30+d)

| View | O que mostra | Screenshot | |------|-------------|------------| | Kanban | Cards de clientes agrupados por faixa de débito (30-45, 45-60, 60-90, 90+). Cores por risco, botões de WhatsApp e ligação direto no card. | 16-cobranca-kanban.png | | Lista | Colunas: nome, telefone, 1º vencimento, dias desde 1º venc., saldo em aberto, score, churn risk, régua de cobrança. | 17-cobranca-list.png | | Gráfico — Risco de Churn | Barras: saldo em aberto por risco de churn (crítico/alto/médio/baixo). | 18-cobranca-graph-churn.png | | Gráfico — Faixa de Débito | Barras: saldo em aberto por faixa de 1º débito. | 19-cobranca-graph-debito.png | | Gráfico — Grau Financeiro | Pizza: distribuição por grau financeiro (A/B/C/D/E). | 20-cobranca-graph-grade.png | | Pivot | Análise cruzada: risco de churn × grau financeiro × régua, com saldo, faturas e atraso médio. | 21-cobranca-pivot.png |

Filtros disponíveis:

• Contrato Ativo IXC
• 1º Débito 30+ / 45+ / 60+ dias
• Com Saldo em Aberto
• Sem Pagamento Recente
• Churn Crítico / Alto
• Agrupar por: Grau Financeiro, Risco de Churn, Régua de Cobrança, Faixa 1º Débito

Como usar:

1. Abrir Cobrança > Iniciar Cobrança (1º Débito 30+d)
2. Por padrão já filtra: contrato ativo + saldo aberto + 1º débito 30+ dias
3. Alternar para Kanban para visualizar por faixa e clicar WhatsApp/ligar
4. Usar Pivot para montar análises cruzadas e exportar para Excel

1.2 BI Financeiro — Dashboards e Análises (já existentes, validados)

| Menu | Views | Screenshot | |------|-------|------------| | Aging Inadimplência | Pivot + Graph | 01-aging-pivot.png, 02-aging-graph.png | | Receita Mensal | Graph + Pivot | 03-receita-mensal-graph.png, 04-receita-mensal-pivot.png | | Evolução da Receita | Graph | 05-evolucao-receita-graph.png | | Por Faixa de Atraso | Graph | 06-faixa-atraso-graph.png | | Por Filial | Pivot | 07-inad-filial-pivot.png | | Por Forma de Recebimento | Pivot | 08-forma-recebimento-pivot.png | | Análise Financeira (Clientes) | List/Pivot/Form | 09-analise-clientes.png | | Top Devedores | List/Form | 10-top-devedores.png | | Risco de Churn | List/Pivot/Form | 11-risco-churn.png | | A Vencer (7 dias) | List/Pivot | 12-a-vencer.png | | Críticos (+90 dias) | List/Pivot | 13-criticos.png | | Renegociados | List/Pivot | 14-renegociados.png | | Painel KPI Executivo | Form (auto-cálculo) | 15-kpi-executivo.png |

2. Novos campos disponíveis nos parceiros e faturas

| Campo | Onde aparece | Para quê serve | |-------|-------------|----------------| | bi_first_invoice_date | Parceiro (aba Financeiro) | Data da 1ª fatura do cliente no IXC | | bi_days_since_first_invoice | Parceiro, Kanban Cobrança | Há quantos dias desde o 1º vencimento | | bi_debito_range | Parceiro, Kanban Cobrança | Faixa de débito: 30-45, 45-60, 60-90, 90+ dias | | ixc_has_active_contract | Parceiro (filtro) | Indica se cliente tem contrato ativo no IXC |

Preenchimento: campos populados automaticamente via cron (sync com IXC). Clientes sem dados ainda podem estar em processo de sincronização.

3. Benefícios para o time de cobrança

1. Visão unificada: Kanban mostra todos os clientes com 1º débito 30+ em um só lugar — não precisa mais buscar em relatórios separados.
2. Ação direta no card: botão WhatsApp e ligação no card do Kanban reduzem etapas entre identificar e cobrar.
3. Foco no que importa: filtros padrão já removem clientes sem contrato e sem saldo — a lista é operacional desde o primeiro clique.
4. Análise cruzada: Pivot permite cruzar régua de cobrança × grau financeiro × risco de churn para priorizar campanhas.
5. Cores por risco: cards vermelhos/laranjas destacam quem precisa de atenção imediata.

4. Como validar em produção (checklist rápido)

• [ ] Acessar https://crm.brasilink.net.br/odoo e fazer login
• [ ] Navegar até Cobrança > Iniciar Cobrança (1º Débito 30+d)
• [ ] Verificar se a tela carrega sem erro (esperar 3-5s)
• [ ] Confirmar que há clientes listados (se não houver, pode ser que o cron de sync ainda não rodou para todos)
• [ ] Alternar para Kanban e verificar agrupamento por faixa de débito
• [ ] Testar filtros: "Contrato Ativo IXC", "1º Débito 60+ dias"
• [ ] Verificar Pivot (BI Financeiro > Análises > abrir qualquer pivot)
• [ ] Abrir um cliente e confirmar que os campos bi_first_invoice_date e bi_days_since_first_invoice aparecem na aba Financeiro

5. Ainda em andamento / próximos passos

| Item | Status | Previsão | |------|--------|----------| | Template de email para clientes em débito | Em desenvolvimento | Homolog | | Documentação completa de usuário (PDF) | Em revisão | Homolog | | Sync automático de contratos IXC (cron) | Deployado, rodando | Produção | | Treinamento presencial/recorded | Não iniciado | A combinar |

6. Referências técnicas (para o time tech Brasilink)

• Repo: brasilink_mod — módulo bitconn_ixc_bi
• Branch de trabalho: main (deploys via CI)
• Commits recentes: ver histórico em bitconn_ixc_bi/
• Views novas: res_partner_bi_views.xml (kanban, graph ×3, pivot, list, search)
• Menu: menu_views.xml (linha 149: menu_cobranca_primeiro_debito)
• Models: campos adicionados em res_partner.py e account_move.py
• Cron: sync de contratos ativos IXC — entrypoint.sh
• Screenshots: diretório docs/screenshots/ (21 imagens, 2.8 MB)

7. Suporte e contato

• Suporte técnico: devops@conexaoazul.com
• Issue / bug: reportar via Chatwoot ou email com screenshot + URL
• Rollback: backup disponível no servidor (/tmp/backup-modules-prod-*.tar.gz)

Entrega gerada em 2026-05-11. Screenshots anexadas em docs/screenshots/.