Guia prático de atividade com charge em sistemas de cobrança
A atividade com charge é o processo de registrar, emitir e controlar cobranças contra clientes ou contas específicas dentro de um sistema financeiro ou de serviços. Não tem muito segredo, mas existem detalhes que só aparecem quando o volume sobe e os erros começam a acumular. No dia a dia, isso significa basicamente três coisas: criar o registro da cobrança, vincular ao contrato ou conta do cliente, e assegurar que os dados trafeguem corretamente para o sistema de liquidação. O problema é que na teoria parece linear e na prática existe uma quantidade enorme de pontos onde algo pode se perder.
Como configurar a atividade com charge no fluxo operacional
O primeiro passo é entender quais campos são obrigatórios no seu sistema. Tipicamente você precisa de: ID do cliente ou contrato, tipo de cobrança (fixa, variável, recorrente), vencimento, valor, e a natureza do serviço ou produto que está sendo cobrado. Se estiver usando um gateway de pagamento, também precisa mapear a forma de aceitação. Um dos erros mais comuns que eu vejo é pular a validação de campos antes do envio. Já perdi a conta das vezes que uma cobrança foi gerada com data de vencimento inválida porque o sistema não checou o formato. A solução mais simples é criar uma camada de validação antes mesmo de tocar no endpoint de criação. Pode ser um script simples ou um fluxo no orquestrador que você usa. Eu recomendo fazer uma lista de verificação fixa: data deve ser posterior a hoje, valor não pode ser negativo, o ID do contrato precisa existir na base de clientes. Isso resolve cerca de 80% dos problemas que surgem nos primeiros dias.
👉 Clique no botão abaixo para saber mais sobre o assunto!
Depois da criação, o registro precisa ser enviado para liquidação. Aqui entram dois caminhos: pagamento automático ou emissão de boleto/duplicata para pagamento manual. Se seu negócio gira em torno de recorrência, o ideal é automatizar a captura. Caso contrário, a emissão de documentos de pagamento com código de barras ou pix copia e cola resolve sem complicação. Um caso específico que tive foi o seguinte: em um projeto de migração de sistema de cobranças, a atividade com charge funcionava perfeitamente em ambiente de homologação, mas em produção as cobranças com vencimento em datas próximas do feriado eram rejeitadas pelo gateway. O problema era que o gateway considerava dias úteis para agendamento, enquanto nosso sistema calculava com base em dias corridos. A correção foi implementar uma função que verificava o calendário bancário e ajustava o vencimento automaticamente para o próximo dia útil. Levei dois dias para resolver isso, mas desde então não tivemos mais rejeições nesse cenário.
A parte de conciliação é onde a maioria dos fluxos falha. Você gera a cobrança, o cliente paga, mas o dinheiro aparece na conta com atraso ou com valor diferente. Recomendo manter um registro separado com status atualizado a cada movimento: criada, enviada, paga, parcialmente paga, cancelada, contestada. Sem esse controle, você gasta horas tentando entender por que uma conta não fechou no final do mês. Outro detalhe que poucos mencionam: a carga tributária. Dependendo do tipo de serviço cobrado, pode incidir ISS, ICMS, PIS/COFINS ou não ter incidência nenhuma. Um erro aqui gera problemas fiscais reais. Verifique com seu contador antes de configurar os tipos de charge no sistema. Em um projeto recente, esqueci de verificar a alíquota de ISS para um serviço digital e no fechamento trimestral a empresa tinha uma dívida que poderia ter sido evitada com uma pergunta de cinco minutos.
Se você está começando do zero, vale a pena estruturar o fluxo assim: validação dos dados, geração do registro, envio para o gateway, acompanhamento de status, conciliação e ajuste de diferenças. Cada etapa pode ser testada separadamente antes de passar para a próxima. O custo de corrigir um erro na etapa cinco é bem maior do que corrigi-lo na etapa dois.
