Conexão Azul Digital - Gestão de Cobrança

Accounting · v19.0.1.0.0 · OPL-1

Conexão Azul Digital - Gestão de Cobrança Inteligente

Dependências

account, mail, bitconn_ixc_sync

Documentação

Gestão de Cobrança Inteligente com Régua de Cobrança, CRM, Agenda e Negativação

Módulo Odoo 19 para automação completa do ciclo de cobrança de provedores de internet. Classifica clientes em réguas de cobrança, executa ações automáticas (e-mail, WhatsApp, atividades), gerencia negociações via pipeline CRM, agenda tarefas operacionais e controla negativações com conformidade LGPD/CDC.

Dependências: account, mail Módulo complementar: bitconn_ixc_bi (score financeiro, views operacionais de clientes/faturas)

---

Novidades desta versão

Área	O que foi adicionado
Automação	Régua de cobrança com timeline de ações (D-7 a D+60)
Comunicação	6 templates HTML de e-mail com PIX, boleto e gateway
CRM	Pipeline Kanban de negociações de cobrança
Agenda	Calendário de tarefas operacionais (ligação, visita, negociação)
Negativação	Controle de SPC/Serasa/Protesto com conformidade LGPD/CDC
Histórico	Log completo de ações executadas por fatura
Fatura	Botão de criação/abertura de Lead CRM direto na fatura

---

Funcionalidades

1. Réguas de Cobrança (Perfis de Cliente)

Classificação automática de clientes em perfis configuráveis com avaliação por prioridade.

Réguas Padrão

Seq	Régua	Modo	Critérios Principais
1	Recuperação	AND	Cliente marcado como recuperação
5	VIP	OR	VIP manual / ticket ≥ R$ 200 / 24+ meses
10	Empresarial	AND	É PJ + ticket ≥ R$ 100
15	Alto Valor	OR	Fatura > R$ 500 / 2+ faturas abertas
20	Novo Cliente	AND	≤ 90 dias cadastro + ≤ 2 faturas
30	Bom Pagador	AND	80%+ em dia + ≤ 1 atraso + nunca suspenso
40	Duvidoso	AND	40–80% em dia + 2–4 atrasos + 1–2 suspensões
50	Mau Pagador	OR	< 40% em dia / 5+ atrasos / 3+ suspensões

Critérios de Entrada (18 tipos)

Tipo	Descrição	Operadores
registration_days	Dias desde o cadastro	>=, <=, between
invoice_count	Qtd. de faturas no período	>=, <=, >, <
paid_on_time_ratio	% pagas em dia	>=, <=
paid_early_ratio	% pagas antecipadamente	>=, <=
overdue_count	Qtd. faturas vencidas	>=, <=, between
overdue_days	Máx. dias em atraso	>=, <=
overdue_amount	Valor total em atraso	>=, <=
overdue_ratio	% faturas em atraso	>=, <=
open_invoice_count	Qtd. faturas em aberto	>=, <=
open_amount	Maior fatura aberta (R$)	>=, <=
total_open_amount	Total em aberto (R$)	>=, <=
average_ticket	Ticket médio mensal (R$)	>=, <=
partner_months	Meses como cliente	>=, <=, between
total_invoiced	Total faturado no período (R$)	>=, <=
suspension_count	Qtd. suspensões	>=, <=
is_company	É Pessoa Jurídica	== True/False
is_vip	Marcado como VIP	== True/False
is_recovery	Cliente de recuperação	== True/False

---

2. Régua de Cobrança — Timeline de Ações Automáticas

Cada régua possui uma sequência configurável de ações disparadas com base em dias relativos ao vencimento da fatura.

Pré-configurado: 41 etapas em 7 réguas

Régua	Etapas	Destaque
Novo Cliente	8	D-2, D0, D+2, D+4, D+20, D+30, D+45 (neg.), D+60
Bom Pagador	4	D0, D+7, D+15, D+30
Duvidoso	8	D-7, D-2, D0, D+2, D+20, D+30, D+45 (neg.), D+60
Mau Pagador	8	D-7, D-2, D0, D+1, D+7, D+15, D+30 (neg.), D+45
VIP	5	D-5, D0, D+3, D+10, D+20 (tom cordial)
Empresarial	6	D-5, D0, D+3, D+10, D+30, D+45
Alto Valor	6	D-3, D0, D+2, D+7, D+20, D+30 (neg.)

Tipos de Ação por Etapa

Tipo	Descrição
send_email	Envia e-mail via template Odoo
send_whatsapp	Envia mensagem WhatsApp (registra em atividade)
create_activity	Cria atividade no Odoo para o responsável
send_to_negative	Cria registro de negativação (SPC/Serasa)
send_to_protest	Cria registro de protesto

Placeholders nas Mensagens

{cliente}         → Nome do parceiro
{valor}           → Valor em aberto (R$)
{vencimento}      → Data de vencimento
{dias_atraso}     → Dias em atraso
{gateway_link}    → Link de pagamento online (IXC)
{linha_digitavel} → Linha digitável do boleto (IXC)
{pix_txid}        → TxID PIX (IXC)

Auto-append: se o link de pagamento não estiver na mensagem e existir na fatura, é adicionado automaticamente ao final.

Screenshot — Configuração de Etapa da Régua

---

3. Templates de E-mail (6 modelos HTML)

Templates profissionais com layout responsivo, gerados via Jinja2.

Template	Quando usar	Cor
mail_template_pre_vencimento	Aviso antes do vencimento	Azul
mail_template_vencimento_hoje	Fatura vence hoje	Laranja
mail_template_atraso_leve	Fatura vencida — aviso de multa/juros	Vermelho
mail_template_aviso_negativacao	Pré-negativação (CDC Art. 43, prazo 5 dias)	Vermelho escuro
mail_template_renegociacao	Proposta de parcelamento	Verde
mail_template_vip_cobranca	Cobrança cortês para clientes VIP	Azul

Todos os templates expõem automaticamente via Jinja2:

• {{ object.ixc_valor_aberto }} — valor em aberto via IXC
• {{ object.ixc_linha_digitavel }} — linha digitável do boleto
• {{ object.ixc_gateway_link }} — link de pagamento online
• {{ object.ixc_pix_txid }} — TxID para pagamento PIX

Screenshot — Preview de Template de E-mail

---

4. CRM de Cobrança — Pipeline Kanban

Pipeline visual para gerenciar negociações de inadimplência.

Etapas do Pipeline (pré-configuradas)

Seq	Etapa	Cor	Descrição
10	Preventiva	Cinza	Comunicações antes do vencimento
20	Atraso Leve	Amarelo	1–30 dias em atraso
30	Atraso Grave	Laranja	31–90 dias em atraso
40	Promessa	Azul	Acordo de pagamento firmado
50	Jurídico	Vermelho	Negativação / protesto / jurídico
60	Recuperado	Verde	Dívida quitada / acordo cumprido (is_won=True)

Campos do Lead

Campo	Descrição
partner_id	Cliente vinculado
move_ids	Faturas vinculadas (M2M)
valor_aberto	Valor total em aberto (computado das faturas)
dias_atraso	Maior atraso entre as faturas vinculadas
faixa_atraso	Classificação da gravidade
promessa_valor	Valor prometido no acordo
promessa_data	Data do compromisso de pagamento
acordo_quebrado	Flag de acordo descumprido
priority	Prioridade (0–3 estrelas)
probability	Probabilidade de recuperação (%)
ai_suggestion	Campo livre para observação / IA
contact_count	Contador de contatos realizados

Screenshot — Pipeline Kanban CRM Cobrança

Screenshot — Formulário do Lead de Cobrança

Botão na Fatura (account.move)

Dois botões aparecem condicionalmente no button_box da fatura:

• “Abrir no CRM Cobrança” (ícone 🚩) — visível quando não há lead vinculado; cria automaticamente com prioridade baseada na faixa de atraso
• “CRM Cobrança [etapa]” — visível quando já há lead vinculado; exibe a etapa atual e abre o lead

Screenshot — Botão CRM na Fatura

---

5. Agenda de Cobrança

Calendário operacional para tarefas da equipe de cobrança.

Tipos de Tarefa

ligacao · mensagem · email · visita · negociacao

Fluxo de Status

pendente → em_andamento → concluida
                       ↘ cancelada / reagendada

Campos de Resultado

Campo	Descrição
resultado	Texto livre com o resultado
valor_negociado	Valor acordado na negociação (R$)
promessa_pagamento	Checkbox: cliente prometeu pagar
data_promessa	Data da promessa

Screenshot — Calendário de Agenda

Screenshot — Lista de Tarefas com Indicador de Atraso

---

6. Negativação / Protesto

Controle de envio para SPC, Serasa e cartório, com conformidade LGPD e CDC.

Órgãos Suportados

SPC · Serasa · SPC + Serasa · Cartório (Protesto)

Fluxo de Status

pendente → processando → concluida → baixada
                      ↘ cancelada

Campos LGPD / CDC

Campo	Descrição
protocolo	Número sequencial automático (NEG-YYYY-NNNNN)
cliente_notificado	Checkbox: notificação enviada antes da negativação
data_notificacao	Data da notificação (CDC Art. 43 exige ≥ 5 dias úteis)

⚠️ Um alerta visual é exibido no formulário quando cliente_notificado = False, lembrando da obrigação legal.

Screenshot — Formulário de Negativação com Alerta LGPD

---

7. Histórico de Ações

Log automático de todas as ações executadas pela régua de cobrança.

Campo	Descrição
step_id	Etapa da régua que disparou a ação
move_id	Fatura alvo
partner_id	Cliente
action_type	Tipo de ação executada
status	success / error
message	Conteúdo da mensagem enviada
executed_at	Data/hora de execução

---

8. No Parceiro (res.partner)

Aba “Cobrança”

• Classificação: régua atual, data da última classificação
• Flags: VIP, Cliente Recuperação
• Contadores: Suspensões
• Estatísticas (12 meses): total faturas, pagas, vencidas, % em dia, % antecipado, % atraso, dias max. atraso, ticket médio
• Botão: “Classificar Agora” — força reclassificação manual
• Stat button: exibe a régua atual e abre lista filtrada

Campo bi_faixa_atraso_max

Campo armazenado que mostra a pior faixa de atraso entre todas as faturas abertas do cliente. Usado para decoração em listas (vermelho/amarelo/azul). Computado usando apenas campos padrão do Odoo (invoice_date_due, payment_state, amount_residual) — sem dependência do módulo BI.

Valor	Significado
em_dia	Nenhuma fatura em atraso
a_vencer_7	Vence nos próximos 7 dias
a_vencer_15	Vence em 8–15 dias
a_vencer_30	Vence em 16–30 dias
atraso_1_30	1–30 dias de atraso
atraso_31_60	31–60 dias de atraso
atraso_61_90	61–90 dias de atraso
atraso_91_180	91–180 dias de atraso
atraso_180	Mais de 180 dias de atraso

Screenshot — Aba Cobrança no Parceiro

---

Menus e Navegação

Cobrança
├── Clientes em Cobrança    ← requer bitconn_ixc_bi
├── Faturas em Cobrança     ← requer bitconn_ixc_bi
├── CRM Cobrança
├── Agenda
├── Negativação
├── Histórico de Ações
└── Configuração
    ├── Réguas (Perfis)
    ├── Critérios de Entrada
    ├── Etapas da Régua
    └── Etapas do Pipeline

---

Automação (ir.cron)

Job	Frequência	Método
Executar Régua de Cobrança	Diário (08:00)	_cron_execute_collection_steps()

O cron percorre todas as faturas ativas e, para cada uma, verifica quais etapas da régua do cliente devem ser disparadas com base na data de vencimento.

---

Estrutura do Módulo

bitconn_collection/
├── data/
│   ├── mail_templates_data.xml          # 6 templates HTML de e-mail
│   ├── collection_category_data.xml     # 8 réguas + regras padrão
│   ├── collection_action_steps_data.xml # 41 etapas pré-configuradas
│   ├── collection_crm_stage_data.xml    # 6 etapas do pipeline CRM
│   ├── collection_negativacao_sequence.xml
│   └── collection_cron.xml
├── models/
│   ├── collection_category.py           # bitconn.collection.category
│   ├── collection_rule.py               # bitconn.collection.rule
│   ├── collection_action.py             # bitconn.collection.action.step + log
│   ├── collection_crm.py                # bitconn.collection.crm.stage + lead
│   ├── collection_negativacao.py        # bitconn.collection.negativacao
│   ├── collection_agenda.py             # bitconn.collection.agenda.task
│   ├── account_move_collection.py       # account.move (botão CRM)
│   └── res_partner.py                   # res.partner (stats + bi_faixa_atraso_max)
└── views/
    ├── collection_action_views.xml
    ├── collection_crm_views.xml
    ├── collection_negativacao_views.xml
    ├── collection_agenda_views.xml
    ├── collection_invoice_views.xml
    ├── res_partner_views.xml
    └── menu_views.xml

---

Instalação

# Apenas cobrança (sem BI)
./odoo-bin -c odoo.conf -i bitconn_collection

# Stack completo recomendado
./odoo-bin -c odoo.conf -i bitconn_ixc_sync,bitconn_collection,bitconn_ixc_bi

Autores

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