Boletos e integrações

Emitir boleto e receber a confirmação de pagamento são duas coisas separadas, e entender isso resolve a maior parte dos chamados de financeiro.

Onde fica: Sistema → Integrações Financeiras.

Cobrança e boleto não são a mesma coisa

Cobrança é o que a unidade deve. Ela é criada sempre que você gera o mês, exista integração ou não, e é o que o morador vê no portal e no aplicativo.

Boleto é um instrumento de pagamento. Só existe quando um provedor financeiro o emitiu de verdade.

Por isso o botão chama Gerar Cobranças, e não "Gerar Boletos": sem integração ativa, as cobranças saem normalmente e o pagamento é combinado por fora, com baixa manual. O assistente diz qual dos dois cenários vai acontecer antes de você confirmar.

Quando o boleto não sai

O assistente de cobrança mostra o motivo e o caminho para resolver:

As duas últimas aparecem em vermelho porque são quebra, não escolha: o condomínio estava emitindo e parou. Antes isso degradava em silêncio para o boleto simulado, e o síndico só descobria pelo morador.

As duas metades da integração

1. Emissão, do CondVida para o provedor

   O CondVida envia a cobrança ao provedor financeiro, que devolve o boleto e o Pix. Depende apenas da chave de API estar válida.

2. Baixa, do provedor para o CondVida

   Quando o morador paga, o provedor precisa avisar o CondVida, por uma chamada automática (webhook). É esta metade que costuma faltar.

Com só a primeira metade funcionando, os boletos saem normalmente e os moradores pagam normalmente, mas tudo continua como pendente no sistema. Nada se perde. O problema é que a inadimplência exibida passa a ser ficção, e é ela que orienta a cobrança.

Por que a segunda metade falha

O aviso automático é registrado no provedor apontando para um endereço público do CondVida. Ele quebra quando:

• a integração foi conectada mas o registro do aviso não chegou a ser criado;
• o endereço configurado aponta para outro lugar (ambiente de teste, domínio antigo);
• a conexão com o provedor foi refeita e o registro anterior ficou órfão.

Em todos os casos a correção é a mesma: reconectar a integração, o que recria o registro do aviso.

Chave de produção e de sandbox não se misturam

As credenciais de teste e de produção do provedor são de ambientes distintos. Usar a chave de sandbox em produção conecta e emite boleto, mas o boleto não é pagável.

O erro devolvido pelo provedor nesse caso costuma ser genérico. Se a conexão aceita a chave mas os boletos não são reconhecidos pelo banco, é o primeiro suspeito.

Encargos por atraso

Multa e juros por atraso são configurados no provedor, não no CondVida. Quando um boleto vencido é reemitido, os encargos entram no novo boleto pelo cálculo do provedor.

O CondVida não recalcula valor de cobrança ao mudar o status para vencida. Ver Cobranças.

O que acontece com as cobranças já emitidas

Religar a baixa automática não reconcilia retroativamente pagamentos que aconteceram enquanto ela estava inativa. Esses precisam ser baixados manualmente.

Por isso vale conferir a integração antes da primeira emissão em massa, e não depois.

Boas práticas

• Confira a integração como parte do fechamento do mês, antes de gerar as cobranças.
• Quando o status da integração mostrar falha, leia o motivo da última tentativa. Ele fica logo abaixo do status e costuma dizer exatamente o que está errado.
• Enquanto a baixa estiver inativa, continue emitindo e registre os pagamentos à mão. Parar de emitir atrasa a arrecadação inteira.

Perguntas frequentes

Posso trocar de provedor financeiro? A troca exige reconectar a integração. Boletos já emitidos pelo provedor antigo continuam válidos e precisam ser baixados manualmente ou pelo webhook antigo, enquanto existir.

O morador consegue pagar por Pix? Sim, quando o provedor está conectado. A cobrança sai com boleto e Pix.

A baixa automática funciona para cobranças lançadas à mão? Funciona para toda cobrança emitida pelo provedor, independentemente de ter vindo do fechamento mensal ou de lançamento avulso.

Gerei as cobranças sem integração. E agora? As cobranças existem e o morador já as vê no portal. Combine o pagamento como o condomínio já fazia (transferência, Pix da conta do condomínio, dinheiro) e registre a baixa em Financeiro → Cobranças → Registrar pagamento.

Se eu conectar a integração depois, os boletos das cobranças antigas saem sozinhos? Não. A emissão acontece no momento da geração. Para as cobranças que já existem, use Reemitir boleto na aba Boletos, uma a uma.

Por que o morador vê "Sem boleto" na cobrança dele? Porque aquela cobrança foi gerada sem integração ativa. Não é erro: é a informação de que o pagamento não sai por boleto e ele deve procurar a administração.