Boletos: onde se configura, integração e remessa/retorno

ONDE SE CONFIGURA: na FORMA DE PAGAMENTO, em Financeiro › Opções auxiliares › Formas de pagamento. É lá que se liga a chave do quadro GERAR BOLETO, escolhe-se a Instituição financeira e abrem-se os campos de configuração do boleto. A conta bancária é apenas vinculada à forma de pagamento — ela não guarda os dados do boleto. Quem procura no cadastro da conta bancária não acha.

Existem dois jeitos de trabalhar, e eles não se misturam:
- INTEGRAÇÃO DIRETA (API do banco, caso do Inter): registra na hora e a baixa volta sozinha, sem arquivo.
- REMESSA E RETORNO (CNAB, arquivo): gera-se a REMESSA e envia no internet banking; depois baixa o RETORNO do banco e sobe no sistema, e aí as contas são baixadas.

BOLETO COM QR CODE PIX
No boleto por remessa e retorno (arquivo), o QR Code Pix ainda não está disponível, em nenhum banco. Isso vale mesmo que o seu banco já tenha liberado o boleto com Pix no contrato, e não existe opção para ativar no sistema. O boleto sai com QR Code Pix nos bancos com integração direta: Banco Inter, Banco do Brasil por integração, C6 (com a chave Pix cadastrada na integração), Cora e Conta Integrada.

Os campos que o banco precisa informar (peça ao gerente, o sistema não adivinha):
- CNAB: 400 ou 240, o layout do arquivo. O 240 habilita "Versão do layout".
- CARTEIRA: identifica a modalidade de cobrança no banco. É a carteira que decide se o boleto é REGISTRADO ou não — carteira errada gera boleto que o banco não reconhece.
- AGÊNCIA/DV e CONTA/DV do beneficiário; código do cedente/convênio, conforme o banco.
- ÚLTIMO BOLETO: o número do último boleto emitido; o sistema segue a sequência daí.
- JUROS DE MULTA (%): valor único sobre a parcela em atraso. JUROS DE MORA (%): ao dia. DIAS JUROS: quantos dias após o vencimento começa a contar.
- ACEITE: o padrão é "não aceite".
- ESPÉCIE DOC: normalmente "Duplicata Mercantil".
- PROTESTAR e DIAS PROTESTO: protesto automático após o vencimento.

Problemas comuns:
- "boleto não registrou": carteira/convênio errados, credencial ou certificado da integração vencidos, ou dados do sacado incompletos (CPF/CNPJ e endereço completo o banco exige).
- "cliente pagou e continua em aberto": no modelo de arquivo só baixa ao processar o RETORNO; na integração direta o banco pode confirmar só no dia seguinte.
- "processei o retorno e nada baixou": arquivo de outra forma de pagamento/conta, ou boletos já baixados na mão.
- "valor do boleto diferente da conta": juros e multa configurados entram após o vencimento.

Alterar valor ou vencimento de conta com boleto já registrado exige gerar o boleto de novo — o que está no banco não muda sozinho.