Conciliação Asaas: vínculo de clientes e cobranças do gateway
Como usar a Conciliação Asaas no North Clinic CRM — vinculo de clientes do Asaas a leads do CRM, conciliação por CPF/CNPJ, cobranças órfãs e desvinculação.
A Conciliação Asaas permite vincular clientes e cobranças do gateway aos cadastros e contas a receber do North Clinic CRM. Também permite recuperar o extrato financeiro desde o início da conta, acompanhar a cobertura e revisar os saldos de cada período.
Esta tela não concilia contas a pagar nem extratos OFX. Para pagamentos de fornecedores, consulte Contas a pagar. Para importar um extrato e vincular movimentações, consulte Movimentações financeiras.
Como acessar
No menu do CRM, acesse Financeiro → Dia a dia → Conciliação → Asaas (rota /app/conciliacao-asaas).
Permissão necessária: Acesso à tela exige a permissão
financeiro.conciliar.
As abas do painel de conciliação (ConciliacaoAsaasPage)
Além das abas de vínculos e cobranças, a aba Extrato permite acompanhar a captura e revisar períodos do Asaas:
1. Visão geral
Mostra o total de clientes no Asaas, quantos estão vinculados e quantos permanecem pendentes.
2. Sem vínculo
Lista os clientes cadastrados no Asaas que ainda não possuem um lead correspondente vinculado no CRM:
- Motivos de Não-Vínculo: O sistema indica a razão da pendência com badges informativas (Sugerido por CPF, CPF ambíguo, CPF sem lead, Sem CPF).
- Sugestão Inteligente por CPF: Quando existe um lead no CRM com o mesmo CPF/CNPJ, o sistema sugere o vínculo com um clique.
- Ação Vincular: Permite associar o cliente do Asaas a um lead do CRM pesquisando manualmente pelo nome.
3. Vinculados
Lista todos os vínculos ativos entre os IDs de clientes do Asaas e os leads do CRM, disponibilizando o botão Desvincular para corrigir eventuais associações incorretas.
4. Cobranças órfãs
Apresenta cobranças do Asaas sem vínculo com parcelas do CRM e as ações disponíveis para conciliação.
Recuperar o extrato Asaas desde o início
Na aba Extrato, confira o intervalo Extrato capturado de … até …. Uma integração de cobranças atualizada não comprova que o extrato financeiro esteja capturado. Meses anteriores ao intervalo ficam com captura pendente.
Com a integração Asaas ativa e a credencial configurada, o North importa o histórico automaticamente desde a primeira transação financeira disponível. Não é necessário configurar nem confirmar uma data para iniciar. A abertura é calculada a partir do saldo e do valor dessa primeira transação. A captura avança em lotes e continua nas próximas sincronizações até alcançar os dias atuais.
Uma data que você já escolheu é preservada. Use Controlar a partir de somente para mudar ou reaplicar esse recorte: selecione Desde o início da conta (padrão) ou Escolher outra data, gere a prévia e confira a data, a abertura e os movimentos que entram ou saem do controle antes de confirmar.
Acompanhe o intervalo capturado e eventuais erros. Uma conta ainda sem transações ou com erro de credencial/API aguardará nova tentativa, sem criar data ou saldo fictícios. Depois da captura, confira os saldos e concilie cada mês antes de fechar. Para essa conta, use a API integrada; não importe OFX do Asaas.
Pelo MCP de cliente/BPO, as ferramentas são:
financeiro_asaas_extrato_status: cobertura e pendências da captura.financeiro_asaas_extrato_analisar: prévia opcional para alterar/reaplicar o recorte;desde_inicio=truebusca a primeira transação.financeiro_asaas_extrato_executar: confirma a mesma prévia compreview_hash,confirmar=truee uma chaveidempotency_keyreutilizada em tentativas da mesma operação.
É necessário vínculo ativo com a clínica, permissão financeiro.conciliar e
concessão das ferramentas MCP ao usuário. Consultas e prévias ficam no pacote
Financeiro — consulta; a confirmação fica em Financeiro — operação.
Se as ferramentas não aparecerem, peça ao administrador que revise as concessões.
Sincronização e vínculos exatos
O botão de sincronização atualiza os dados usados na conciliação. Na aba Sem vínculo, quando há correspondências exatas por CPF, a ação Vincular todos os exatos permite confirmar esses vínculos em lote.
Gerar cobrança Asaas ao lançar um pagamento
Gerar cobrança no Asaas (boleto/pix) solicita a criação da cobrança vinculada à parcela do North. Não é apenas uma anotação de pagamento nem uma confirmação de que o cliente já pagou.
A clínica precisa ter a integração Asaas configurada, uma conta de destino e uma opção de recebimento Asaas ativa na forma escolhida. O cliente também precisa dos dados cadastrais exigidos para a cobrança; preencha as pendências que a tela indicar antes de continuar.
Gera boleto ou link automaticamente? Ao confirmar o lançamento com a integração selecionada, o North solicita a cobrança ao Asaas. O tipo depende da configuração: boleto, Pix ou cobrança para pagamento online. Não é sempre um boleto: confira o tipo configurado na opção de recebimento. A geração pode falhar; confirme o resultado e a disponibilidade do boleto, QR code ou link antes de informar ao cliente que a cobrança está pronta.
Ao lançar pagamento de saldo de uma venda existente
Na tela de pagamentos da venda, escolha a forma integrada. A opção Gerar cobrança no Asaas (boleto/pix) aparece quando a forma tem integração Asaas e vem marcada. Mantê-la marcada solicita uma cobrança para cada parcela do lançamento. Desmarcá-la não solicita a emissão ao Asaas.
Ao fazer uma venda nova no PDV
O PDV usa o seletor do caminho de recebimento: escolha a opção Gateway vinculada ao Asaas. Se houver apenas um caminho disponível, ele pode ser selecionado automaticamente; confira qual está ativo antes de finalizar. A cobrança é solicitada na conclusão da venda, sem a caixa de seleção da tela de pagamento de saldo.
Assim, a ausência dessa caixa na venda nova não significa, por si só, que falta a integração. Se a opção Asaas não estiver disponível, confira em Financeiro → Cadastros → Formas de Pagamento a opção ativa, a conta de destino e a integração da clínica.
Como conferir se deu certo
Abra os pagamentos da venda ou Contas a receber e confira a cobrança vinculada e seu status. Cobrança gerada não significa pagamento recebido: a confirmação depende do pagamento e do retorno da integração. Gerar a cobrança também não comprova que o boleto ou link foi entregue ao cliente.
Se aparecer Boleto não gerado, confira o erro, os dados do cliente e o vencimento antes de usar Gerar cobrança. O Asaas não emite cobrança com vencimento no passado. Se a cobrança já existe no Asaas e está sem vínculo, use a conciliação para conferir o vínculo antes de solicitar outra emissão.
Recebida em dinheiro não é saldo Asaas
Quando alguém usa Recebida em dinheiro no painel do Asaas, a cobrança é
baixada fora do processamento financeiro do gateway. Tecnicamente, o Asaas
envia o evento PAYMENT_RECEIVED e informa
billingType=RECEIVED_IN_CASH; não há um evento chamado
PAYMENT_RECEIVED_IN_CASH. O evento
PAYMENT_RECEIVED_IN_CASH_UNDONE existe somente para comunicar que essa baixa
manual foi desfeita.
O North trata o retorno como uma baixa da parcela, mas lança o valor na conta manual configurada para Dinheiro ou, na ausência dela, em uma conta ativa do tipo Caixa. Nenhuma entrada é criada na conta ou no extrato Asaas. Se não houver um destino seguro configurado, a integração mantém o erro visível para correção em vez de criar saldo fictício.
Na consulta técnica de recebíveis, o MCP apresenta:
status_asaas: RECEIVED_IN_CASH, como estado efetivo e pesquisável;status_asaas_original: RECEIVED, que é o status recebido no webhook;billing_type_asaas: RECEIVED_IN_CASH;recebido_em_dinheiro: true.
Guias relacionados
Precisa de ajuda?
Nossa equipe de suporte está pronta para te ajudar com qualquer dúvida.
Falar com suporte