Cobranças Inteligentes no CRM (Odoo 14–18)

Propostas, PIX/Boleto, Cartão, Assinaturas, Parcelado, Antecipação de Recebíveis e NFS-e

SaaS e Self‑Hosting • Suporte anual incluído (correções e atualizações de segurança)

1) Visão geral

O módulo Cobranças Inteligentes – CRM conecta seu funil de vendas ao financeiro, permitindo gerar propostas e cobranças sem sair do Odoo: PIX/Boleto, cartão (à vista ou parcelado), assinaturas recorrentes, links de pagamento rápidos, antecipação de recebíveis e emissão de NFS‑e para qualquer município (via suíte fiscal Conexão Azul). Tudo com rastreio em tempo real e registro automático na Chatter.

Para quem é: times comerciais que querem fechar mais rápido, evitar reprocessos e padronizar a cobrança desde a cotação até o pós‑venda.

2) Principais diferenciais

• 1 clique do CRM: gere o pagamento direto da cotação/oportunidade (sem abrir outras telas).
• Formas de cobrança: PIX, Boleto, Cartão (parcelado ou à vista), Link Rápido, Assinatura.
• Cancelamento/expiração do link e cobrança c/ retorno instantâneo.
• Webhook: baixa automática de pagamentos e atualização de status.
• NFS‑e: emissão e envio automático após pagamento confirmado (opcional).
• Split/repasse: suporte a cenários com parceiros (quando habilitado no provedor).
• Rastreamento UTM: origem da venda visível no pedido (quando configurado).
• Compatível Odoo 14, 15, 16, 17 e 18 (Community/Enterprise).
• Suporte anual: correção de bugs e patches de segurança incluídos.

3) Requisitos

• Odoo 14–18 (Community/Enterprise).
• Conta no ASAAS (ou outro provedor homologado pela Conexão Azul).
• Para NFS‑e: suíte fiscal Blue Brazil (base Trustcode adaptada) com certificados A1.
• Acesso de administrador ao Odoo para instalar apps e configurar provedores de pagamento.

4) Instalação (SaaS ou Self‑Hosting)

1. Apps → Pesquise “Cobranças Inteligentes (CRM) – Conexão Azul” → Instalar.
2. Em ambientes Docker ou Odoo.sh, adicione o repositório dos módulos BlueApps ao seu addons_path e atualize a lista de apps.
3. Atualize módulos dependentes (sale, payment, base, mail, website_sale se aplicável).
4. Ative e teste em base de homologação antes de ir a produção.

Boas práticas Odoo: não modifique core; use payment.provider e ir.cron nativos; proteja chaves no ir.config_parameter; registre eventos na Chatter; trate idempotência ao consumir APIs.

5) Configuração do Provedor (ASAAS)

1. Faturamento → Provedores de pagamento → ASAAS.
2. Informe API Key e selecione Ambiente (Sandbox ou Produção).
3. Defina a Webhook Key (será usada para validar eventos).
4. No painel ASAAS, aponte os webhooks para o endpoint do Odoo (documentado no módulo).
5. Salve e teste criando um Link de Pagamento Rápido.

Referência de print:

• [INSERIR PRINT: Tela de Provedor ASAAS – API Key/Produção/Sandbox/Webhook]
• (Exemplo: imagem semelhante ao print asaas-provider.jpg)

6) Fluxo no CRM – da cotação ao pagamento

6.1 Criando a proposta

1. CRM → Oportunidade → Nova Cotação (S00001).
2. Preencha linhas de pedido, datas e condições.

Referências de print:

• [INSERIR PRINT: Cotação aberta com aba Cobranças]
• (Ex.: s00001-cobrancas.png)

6.2 Link de Pagamento Rápido

• Botão “Link de Pagamento Rápido” → gera URL única (PIX/Boleto/Cartão conforme config).
• A URL aparece em modal e é registrada na Chatter.
• Use o botão “Cancelar Link de Pagamento” para invalidar.

Referências de print:

• [INSERIR PRINT: Modal com URL do link]
• [INSERIR PRINT: Botão Cancelar Link de Pagamento + status “Aguardando Pagamento”]

6.3 Cobrança por Boleto/PIX (avulsa)

1. Aba Cobranças → Criar Cobrança ASAAS.
2. Selecione Forma de Pagamento (Boleto ou PIX), desconto opcional e vencimento.
3. Confirme. O status muda para Aguardando Pagamento e o título é criado no ASAAS.

Referência de print:

• [INSERIR PRINT: Detalhes da cobrança — Boleto/Pix, desconto, parcelas=1]

6.4 Cartão de crédito (à vista ou parcelado)

1. Criar Link de Pagamento → habilite cartão e nº de parcelas.
2. Compartilhe a URL com o cliente.
3. Após aprovação, o Odoo registra a baixa via webhook e atualiza a cotação/pedido.

Referência de print:

• [INSERIR PRINT: Link de pagamento com cartão parcelado (ex.: 1–12x)]

6.5 Assinatura recorrente

1. Botão “Criar Assinatura”: define periodicidade (mensal/anual), valor, método.
2. O ASAAS gerará cobranças futuras automaticamente; o Odoo mantém o contrato e os eventos.
3. Integração opcional com NFS‑e automática a cada ciclo pago.

Referência de print:

• [INSERIR PRINT: Wizard de assinatura com periodicidade e método de pagamento]

6.6 Parcelado no boleto/cartão

• No wizard, selecione Número de Parcelas (>1).
• O sistema cria o plano de parcelas e acompanha vencimentos.
• Em cartão, segue as regras do provedor (juros/antifraude/limites).

Referência de print:

• [INSERIR PRINT: Detalhe com “Número de Parcelas = 6/12”]

6.7 Cancelamento e reenvio

• Cancelar Link/Cobrança: invalida a cobrança no provedor e oculta o link.
• Reenviar por e‑mail/WhatsApp: use os botões padrão Odoo ou o conector Chatwoot.

Referência de print:

• [INSERIR PRINT: Botão vermelho “Cancelar Link de Pagamento”]

7) Baixas automáticas via Webhook

• Eventos de pagamento confirmado, estornado, expirado ou chargeback atualizam o pedido automaticamente.
• Registro detalhado na Chatter com ID da transação, valor e data.

Boas práticas: use Sandbox primeiro; valide assinaturas dos webhooks; configure retries e idempotência.

8) Antecipação de Recebíveis

• Quando habilitado no provedor, você pode antecipar parcelas/assinaturas e registrar o custo financeiro como despesa no Odoo.
• O módulo oferece lançamento contábil automático opcional.

Referência de print:

• [INSERIR PRINT: Tela de solicitação/registro de antecipação]

9) Emissão de NFS‑e (qualquer município)

1. Configure sua empresa na suíte fiscal Blue Brazil (CNPJ, CRT, CFOPs, alíquotas, Certificado A1).
2. Após o pagamento confirmado, use Emitir Nota Fiscal na cotação/pedido ou automatize pós‑baixa.
3. O PDF/XML é anexado ao pedido e pode ser enviado ao cliente.

Referência de print:

• [INSERIR PRINT: Botão Emitir Nota Fiscal e resultado da NFS‑e]

10) Logs, diagnósticos e erros comuns

• 400 invalid_customer (ASAAS): verifique se o cliente está sincronizado (CPF/CNPJ, e‑mail, telefone). Use o botão “Atualizar cliente no ASAAS” na ficha do parceiro.
• Vencimento no passado: o módulo ajusta automaticamente para a data atual (evita rejeição).
• Webhook não recebido: confirme URL e assinatura no painel ASAAS.
• Chave/API inválida: troque a API Key e reinicie o serviço se estiver em Docker.

Referência de print:

• [INSERIR PRINT: Log/Chatter com mensagem de erro tratada]

11) Permissões e segurança

• Grupos: Comercial pode gerar links e cobranças; Financeiro aprova cancelamentos/estornos.
• Chaves guardadas em ir.config_parameter.
• LGPD: dados sensíveis criptografados; minimização de dados enviados ao provedor.
• Auditoria: todas as ações relevantes registradas na Chatter.

12) Checklist de Onboarding

1. Instalar módulo e dependências.
2. Configurar ASAAS (API/Webhook).
3. Ajustar tabelas de impostos e NFS‑e (se aplicável).
4. Testar Link Rápido em Sandbox.
5. Testar Boleto/PIX, Cartão (1x/parcelado) e Assinatura.
6. Validar webhook (pagamento → baixa).
7. Publicar no time: playbook + vídeo curto (2–5 min) do fluxo.

13) FAQ rápido

• Posso usar só link de pagamento? Sim.
• Funciona sem Website Sale? Sim, o fluxo é nativo do CRM/Vendas.
• E se o cliente mudar a forma de pagamento? Gere um novo link pela cotação.
• Chargeback? Evento chega por webhook e registramos na Chatter.

14) Copy para página de vendas (Marketplace/Website)

Feche vendas em minutos, não em dias.

Conecte seu CRM ao financeiro com o Cobranças Inteligentes – Conexão Azul. Gere PIX/Boleto/Cartão, assinaturas e parcelados, com NFS‑e automática e baixas por webhook. Compatível Odoo 14–18. Suporte anual incluído.

Recursos principais:

• Link de pagamento no CRM • PIX/Boleto/Cartão • Parcelado e Assinatura

• Cancelar/reenviar em 1 clique • NFS‑e automática • Webhooks

• Antecipação de recebíveis • Logs na Chatter • LGPD & segurança

Modelos de licenciamento:

• SaaS (hospedado pela Conexão Azul) – manutenção total incluída.
• Self‑Hosting – você hospeda; nós provemos suporte anual e atualizações.

Inclui: correção de erros, atualizações de segurança, guia de onboarding e playbooks.

Add‑ons: Conector Chatwoot/WhatsApp, NF‑e/NFC‑e, Contabilidade brasileira, Website Sale.

Chame o time: suporte@conexaoazul.com • WhatsApp: wa.me/5591999999999

15) Roadmap

• Carteiras adicionais (outros PSPs).
• Estorno parcial via CRM.
• DRE de assinaturas e KPIs no crm.team (MRR, churn, ciclo).
• Upsell automático pós‑pagamento (e‑mail/WhatsApp + cupom).

16) Boas práticas de desenvolvimento (para equipes técnicas)

• Use payment.provider por empresa (multi‑company).
• Evite sudo() desnecessário; respeite permissões dos grupos.
• Tratamento de exceções com mensagens amigáveis e _logger nivel INFO/ERROR.
• Operações externas com idempotência (chave de deduplicação).
• Não bloquear transações longas; prefira jobs assíncronos (queue) quando houver.
• Testes: unitários para wizards; integrados para webhooks e reconciliação.
• I18N: traduções pt‑BR/en es; labels curtos e help tooltips.
• Documente endpoints e códigos de retorno em README técnico.

17) Sessões de captura de tela (para completar o material)

• S‑01 Provedor ASAAS configurado (API Key, Ambiente, Webhook).
• S‑02 Cotação S00001 com aba Cobranças destacada.
• S‑03 Modal Link de Pagamento Rápido exibindo URL.
• S‑04 Botão Cancelar Link de Pagamento e status Aguardando Pagamento.
• S‑05 Wizard Criar Cobrança ASAAS (Boleto/PIX, desconto, parcelas).
• S‑06 Wizard Criar Assinatura (periodicidade, método).
• S‑07 Detalhe Cartão Parcelado (ex.: 6x/12x).
• S‑08 Chatter com baixa por webhook (pagamento confirmado).
• S‑09 Botão Emitir Nota Fiscal e resultado NFS‑e anexado.
• S‑10 Tela de Antecipação de Recebíveis (opcional).

Dica: mantenha o mesmo tema/tamanho e seta visual no elemento principal (como nos prints de referência). Nomeie os arquivos seguindo o padrão S-XX-titulo.png.

18) SLA e suporte

• Incluído: 12 meses de suporte para correção de bugs e atualizações de segurança.
• Canal: e‑mail, portal do cliente e WhatsApp.
• Tempo alvo: primeiro atendimento até 8h úteis; correções priorizadas por impacto.

19) Termos e conformidade

• LGPD: aderência a princípios de minimização de dados e segurança.
• Tributário: emissão de NFS‑e conforme legislação municipal; parametrizações são responsabilidade do contribuinte.
• Cartão/PCI: dados de cartão não são armazenados no Odoo; processamento no provedor.

20) Planos e Preços Personalizados

1) SaaS Conexão Azul

• Essentials — R$ 399/mês • Setup R$ 899
  Para começar rápido no CRM: PIX/Boleto/Cartão, links de pagamento, assinaturas, webhooks, logs na Chatter, suporte e atualizações de segurança.
• Scale — R$ 899/mês • Setup R$ 1.390
  Tudo do Essentials + NFS-e automática pós-pagamento, split/repasse (quando disponível), relatórios e priorização de suporte.

2) Odoo.sh (Add-on)

• Licença & Suporte — R$ 99/mês por instância
• Implantação — R$ 1.890 (git repo BlueApps, staging/produção, webhooks e testes)

Requer assinatura Odoo Enterprise + Odoo.sh do cliente.

3) Self-Hosting (sua infra)

• Suporte Anual do Módulo — R$ 1.390/ano por instância
• Implantação/Onboarding — R$ 1.490 (Docker/Traefik ou VM, webhooks, hardening básico)

Add-ons opcionais

• Suíte Fiscal NFS-e (qualquer município): Setup R$ 1.490 + R$ 99/mês
• Conector Chatwoot/WhatsApp: Setup R$ 1.290 + R$ 149/mês
• Treinamento rápido (1h): R$ 850
• Migração de versão (14→18): a partir de R$ 3.900
  (Impostos não inclusos. Valores por instância; descontos de parceria sob consulta.)

Anexos/Apêndice técnico

• Endpoints de webhook aceitos e payloads.
• Tabelas de mapeamento de status (ASAAS → Odoo).
• Mensagens de erro tratadas e recomendações de correção.

Pronto! Com este tutorial/copys, podemos publicar no site/marketplace e treinar o time. Ao inserir os prints S‑01…S‑10, teremos o onboarding completo em formato visual.