Referência dos Módulos

bitconn_ixc_sync — Sincronização IXC Provedor

Versão: 19.0.1.0.0 Dependências: base, account, contacts

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 {{today}} e {{today+N}}
• 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

Versão: 19.0.1.0.0 Dependências: bitconn_ixc_sync, crm, calendar

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

Versão: 19.0.1.0.0 Dependências: bitconn_collection

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

Versão: 19.0.1.0.0 Dependências: base, web

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

curl -X GET \
  "https://seu-odoo.com/webhook/bitconn/search_read?model=res.partner&domain=[['customer_rank','>',0]]" \
  -H "Authorization: Bearer seu-token"