Pular para o conteúdo
Voltar para a Central de Ajuda
Financeiro

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=true busca a primeira transação.
  • financeiro_asaas_extrato_executar: confirma a mesma prévia com preview_hash, confirmar=true e uma chave idempotency_key reutilizada 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