No dia a dia: emitir boleto e Pix pelo Banco do Brasil, extrato e o que trava

EMITIR BOLETO
Campos do pagador no formulário: cliente, tipo de documento (CPF ou CNPJ), o documento, telefone, e-mail, CEP, logradouro, número, bairro, complemento e cidade. Ao escolher o cliente, o sistema traz documento, telefone, e-mail e endereço do cadastro do ERP; preencher o CEP também completa o endereço. O cadastro de cliente é do ERP: o que estiver faltando lá vem em branco aqui.
Dados da cobrança: valor (obrigatório), data de vencimento (obrigatória, dd/mm/aaaa, não aceita data anterior a hoje — "A data não pode ser menor que hoje") e descrição (texto livre, opcional, até 300 caracteres).

GERAR CONTAS A RECEBER
O bloco financeiro do formulário só aparece para quem tem a permissão de lançar recebimento. Enquanto a integração estiver em situação de ação pendente — o próprio formulário mostra o aviso de ação pendente —, a caixa "Gerar contas a receber" fica desabilitada e o bloco financeiro não é exibido: o boleto continua sendo gerado, o lançamento no financeiro não. É a integração ainda não plenamente ativa, não erro de quem emitiu.

PIX
Ao abrir o Pix o sistema valida a integração e a Chave Pix. Sem chave, avisa "É necessário configurar a Chave Pix da integração antes de gerar cobranças Pix" e leva para a edição da integração. Lá a Chave Pix é obrigatória e só aparece depois de escolhida a "Forma para recebimento Pix". A tela de receber Pix é montada exigindo cliente e documento do pagador: não há Pix sem pagador identificado.

ENVIAR E IMPRIMIR
O módulo tem rotas de impressão marcadas como públicas, que abrem sem login: o PDF da transação (por integração e nosso número), o Pix em PDF, o comprovante do Pix e o QR code. São esses links que se manda ao pagador.
Existe a ação de baixa de boleto, que confirma com "Boleto baixado com sucesso". E existe tela de Extrato do Banco do Brasil no módulo.

PAGAMENTOS
O painel inicial do Banco do Brasil é montado sem o atalho de Pagamentos, com a justificativa no próprio código: o BB não tem o domínio de Pagamentos por limitação de autenticação do banco. As telas de listar e adicionar pagamento existem, mas não conte com elas — e a de adicionar é montada com a opção de DARF desligada.
Situações que a listagem de pagamentos reconhece: Em processamento, Aguardando aprovação, Aprovado, Agendado, Realizado, Reprovado, Aprovação expirada, Não compensado, Cancelado e Erro. Qualquer outra aparece no cinza padrão.

O QUE COSTUMA DAR ERRADO
Quando o banco recusa a emissão, o sistema mostra o texto devolvido pelo próprio banco. Leia a mensagem literalmente: é ela que diz o motivo.
Ordem de diagnóstico: 1) integração ativa; 2) "Forma para recebimento boleto" preenchida na configuração da integração (campo obrigatório); 3) cadastro do cliente completo com documento e endereço; 4) mensagem devolvida pelo banco; 5) convênio, carteira e variação da carteira — os três são campos obrigatórios da própria integração (o convênio tem de 4 a 8 números).
Boleto do BB por remessa CNAB é outro caminho: fica na forma de pagamento do ERP (CNAB, carteira, variação, convênio) e esse card nem aparece quando o banco escolhido é um banco de integração.