Cobrança por boleto e Pix

De uma conta a receber, o Financeiro Inteligente gera uma cobrança pelo Gateway Bancário — um boleto ou um Pix — para o cliente pagar. É o espelho do envio de pagamentos, na direção do dinheiro que entra.

A ação é "Gerar cobrança", na tela de detalhe do título.

Pré-requisitos

Exigência	Boleto	Pix
Gateway Bancário conectado	✅	✅
Cliente vinculado ao título	✅	✅
CPF/CNPJ do cliente	✅	✅
Data de vencimento no título	✅	✅
Endereço completo do cliente (CEP, rua, bairro, cidade e estado)	✅	—
Convênio de boleto cadastrado na conta do gateway	✅	—
Conta Pix de cobrança cadastrada na conta do gateway	—	✅

observação

Os dois trilhos não são a mesma cobrança com um botão diferente. Mudam o que o cliente recebe e o que precisa estar cadastrado antes — por isso a escolha é feita em dois cartões, cada um dizendo o seu pré-requisito.

Se algo faltar, o sistema diz exatamente o quê em vez de dar um erro genérico: "O cliente precisa de CPF ou CNPJ", "O boleto exige o endereço completo do cliente", "Nenhuma conta Pix de cobrança está cadastrada", e assim por diante.

Fluxo

aviso

Cobrança recém-gerada ainda não pode ser entregue ao cliente. O registro na instituição financeira é assíncrono: enquanto o estado for Registrando, o boleto ainda não existe no banco e o Pix ainda não tem QR code. Espere chegar a Registrada.

Estados da cobrança

Aparecem no cartão da cobrança e na coluna Status no banco da listagem de contas a receber.

Estado	O que significa
Registrando	criada; a instituição ainda não confirmou o registro
Registrada	registrada — pode ser entregue ao cliente
Vencida	passou do vencimento sem pagamento
Paga	o cliente pagou
Registro recusado · Falha no registro · Falha ao gerar	a instituição não aceitou; a cobrança não vale
Cancelada	desfeita

O botão "Atualizar" busca o estado atual sob demanda, sem esperar o acompanhamento automático.

Baixa automática

Quando a cobrança chega a Paga, o título é baixado sozinho: vira Recebido, com a data de hoje, e o lançamento de entrada é criado.

aviso

Sem "Receber em" definida, não há baixa automática. É ela que diz em qual conta o dinheiro entrou — sem essa informação o sistema não adivinha, e a baixa fica para você fazer na mão. A cobrança continua marcada como Paga.

Enquanto a cobrança está de pé, o título não muda

Com uma cobrança Registrando, Registrada, Vencida ou Paga, alguém lá fora pode pagá-la — ou já pagou. Por isso o título fica travado no que descreve a cobrança: valor, vencimento, cliente e afins não podem ser alterados, e o título não pode ser excluído.

informação

Editar aqui não reemitiria nada. O boleto que o cliente tem em mãos continuaria o mesmo — o sistema é que passaria a mentir sobre o que foi cobrado. Para corrigir, cancele a cobrança primeiro.

Cobranças recusadas ou canceladas não travam nada: elas não existem para ninguém.

Cancelar a cobrança

"Cancelar cobrança" desfaz a cobrança no gateway. Os dois trilhos se comportam de forma diferente, e a diferença importa para o seu cliente:

• Boleto — deixa de valer assim que o gateway confirmar, e o cliente não consegue mais pagá-lo.
• Pix — o cancelamento é confirmado pela instituição financeira. Até a confirmação chegar, o cliente ainda consegue pagar.

Por isso a resposta distingue "Cobrança cancelada" de "Cancelamento solicitado — aguardando a confirmação da instituição". No segundo caso, acompanhe até o estado virar Cancelada.

Uma cobrança paga, já cancelada ou que falhou não tem o que cancelar.

Relacionado

• Contas a receber — ciclo de vida — os estados do título em si
• Integração Gateway Bancário — conectar, sincronizar e acompanhar
• Pessoas — onde ficam o documento e o endereço que a cobrança exige