Blue Consultas Asaas

Accounting · v19.0.1.0.1 · OPL-1

Camada de integracao Asaas para planos Blue Consultas, webhooks, clientes e saldo.

Dependências

blue_credit_query, blue_credit_query_marketplace, blue_payment_asaas, sale, account, payment

Documentação

Camada de integracao Asaas para o projeto Data Azul / Blue Consultas.

Papel do modulo

Este modulo nao substitui o motor de consultas nem a loja.

Ele faz a cola entre:

• blue_credit_query: saldo, historico, portal /consultas;
• blue_credit_query_marketplace: planos e posicionamento comercial;
• blue_payment_asaas: cliente Asaas, cobranca, webhook e conciliacao.

Fluxo alvo

1. O cliente compra um plano no /shop.
2. Odoo cria o sale.order.
3. O provedor Asaas do blue_payment_asaas cria a cobranca.
4. O webhook confirma o pagamento.
5. O modulo ativa o portal e libera a franquia do plano uma unica vez.
6. O saldo e o historico ficam no blue_credit_query.

Planos suportados

• BLUE-CONSULTAS-STARTER
• BLUE-CONSULTAS-PRO
• BLUE-CONSULTAS-BUSINESS
• BLUE-CONSULTAS-ENTERPRISE-IA

Regras de seguranca

• A API Key do Asaas nao e armazenada no codigo.
• O webhook exige o token configurado no Asaas e valido no header asaas-access-token.
• O onboarding de conta/subconta fica protegido por flag e modo sandbox.
• A liberacao de credito e idempotente por pedido, pagamento e evento.
• O webhook aceita repeticao sem duplicar saldo.

Integracao de conta white-label

O modulo prepara a estrutura para:

• localizar ou criar customer no Asaas;
• preparar conta/subconta em sandbox;
• registrar wallet/account/customer no Odoo;
• abrir o portal externo quando configurado.

Por padrao, a criacao de conta continua desativada ate o backend marcar a flag de onboarding.

Configuracao minima

1. Instalar blue_payment_asaas.
2. Configurar um provider Asaas no Odoo.
3. Instalar este modulo.
4. Conferir os planos no menu tecnico.
5. Apontar o webhook do Asaas para:
   • /consultas/asaas/webhook
   • ou /blue-consultas/asaas/webhook
6. Preencher blue_credit_query_asaas.webhook_secret com o token do webhook no Asaas.

Pendencias

• recorrencia mensal real;
• renovacao automatica de franquia;
• checkout final com regras comerciais;
• integracao WhatsApp;
• Enterprise Agent IA.