Como funciona na prática
A maioria das pessoas que entra na área de contabilidade ou começa um pequeno negócio demora uns dois dias pra descobrir que a interface do Nubank Empresas ou Nubank PJ não é exatamente intuitiva pra quem tá vindo do mercado tradicional. O fluxo de criar boleto nubank existe, mas ele esconde algumas funcionalidades importantes debaixo de camadas de menu que não ajudam.
Passo a passo direto
Você entra no app, clica em Cobrar, que geralmente fica na aba lateral ou no menu inferior dependendo da versão que você tem. Aí tem a opção de gerar um boleto. É isso. Mas o que o app não mostra é que o campo "data de vencimento" permite colocar datas no passado sem reclamar nada, e isso causa problema. Boleto com data de vencimento retroativa pode ser registrado como vencido e o pagador não consegue pagar normalmente. A regra prática é: vencimento mínimo de amanhã, no máximo 90 dias no futuro pra manter a validade boa no sistema bancário. O valor deve ser digitado sem o símbolo de real, só números. O sistema já formatando automaticamente. Eu já perdi um dia inteiro porque coloquei vírgula ao invés de ponto decimal num boleto e o valor saiu errado. O sistema aceita sem avisar. A solução foi abrir o comprovante em PDF, verificar o campo "valor do documento", e se tiver errado, cancelar a cobrança antes de compensar. O cancelamento só funciona até o boleto ser registrado, ou seja, antes dele aparecer no sistema do Banco Central com o código de barras gerado.
Artesianato da API vs aplicativo
Se você tem mais de cinco boletos por mês, usar o app vira algo custoso em termos de tempo. Cada boleto leva em média três minutos, então dez boletos consomem trinta minutos só de navegação e risco de erro de digitação. A API de cobranças do Nubank resolve isso e permite criação em lote. Você envia um JSON com os dados do pagador, valor, data de vencimento e receipt URL, e o sistema devolve o código de barras e o link do boleto em coisa de dois segundos por solicitação. O problema da API é que ela exige token de acesso que expira em 24 horas. Você precisa usar refresh token, senão vai ter que reprovar autorização toda vez que o sistema rodar. Um detalhe que muita gente esquece: o endpoint de cobranças recorrentes tem um limite de taxa de 100 requisições por minuto por conta. Se você processar um arquivo de lote com 500 boletos, vai bugar a fila em cerca de 20 segundos. A solução é usar batch assíncrono com paginação e polling de status, ou então dividir em grupos de 80 itens com intervalo de 10 segundos entre lotes.
👉 Clique no botão abaixo para saber mais sobre o assunto!
Pegadinhas que ninguém conta
O Nubank gera boleto com nossa linha digitável no padrão FEBRABAN de 47 dígitos, mas tem uma particularidade: o campo "nosso número" tem um dígito verificador próprio que varia conforme o tipo de cobrança. Cobrança simples, cobrança registrada, cobrança com cadastro. Se você usar o endpoint errado, o boleto nasce com Nosso Número incorreto, o que faz o banco do pagador rejeitar na hora da compensação. Você gasta 48 horas esperando o cliente reclamar. Outra coisa: o Nubank não permite alterar campos depois que o boleto é gerado. Se você precisar mudar o vencimento, o pagador ou o valor, não tem "editar". Tem que cancelar e gerar outro. Isso significa que o controle de versionamento é essencial. Anota o ID da cobrança em algum lugar antes de confirmar, senão quando o cliente perguntar "o boleto que eu recebi ontem tá errado", você vai ter que caçar o ID em meio milhão de notificações.
Custos e prazos reais
O Nubank cobra taxa de administração sobre cobrança com registro. A tabulação varia entre 0,5% e 2%, dependendo do plano da contaPJ. Sem registro, a taxa é menor, mas o boleto demora mais pra compensar. Compensação com registro leva de 1 a 2 dias úteis. Sem registro, pode levar 3 a 5 dias úteis, às vezes mais se cair em um final de semana. Se o seu cliente paga boletos todo dia 15, e você usa cobrança sem registro, ele pode estar pagando dia 18, 19, 20. O impacto financeiro é real, principalmente se você precisa repassar esse dinheiro para fornecedores com prazos apertados. Uma conta pequena com faturamento de 30 mil mensais em boletos sem registro pode perder em média 400 reais por ano só de atraso na compensação. Não é exagero, é média que eu vi em dados de vários clientes meus.
Alternativas quando o Nubank não dá conta
Existem soluções de pagamento que oferecem boleto com compensação mais rápida, como Gerencianet, Efi (pagbank) e Banco Inter. Cada uma tem suas peculiaridades. A Gerencianet cobra taxa fixa mais percentual e oferece compensação em até 1 dia útil para cobrança registrada. O Inter tem custo zero para cobrança sem registro, mas a compensação é a mesma do Nubank. Se sua operação depende de dinheiro em conta rápido, vale a pena testar pelo menos uma segunda opção antes de fechar tudo com um só banco. Também dá pra usar o Nubank como conta principal e gerar boletos via plataformas de gestão financeira como Kontask, Bling ou Tiny. Essas plataformas se integram com a API do Nubank e permitem criar boletos a partir de notas fiscais emitidas, reduzindo o tempo de geração de boleto por nota para algo em torno de 30 segundos contra os três minutos manuais do app. O custo extra da plataforma é compensado em volume, mas se você emite menos de 20 boletos por mês, o investimento pode não valer a pena.
Checklist antes de enviar
Antes de qualquer boleto sair do sistema, verifique estes cinco pontos. CPF ou CNPJ do pagador devem corresponder ao documento informado na nota fiscal, se existir. O valor deve bater centavo por centavo. A data de vencimento deve ser posterior ao dia atual. O endereço de email do pagador está correto, porque o boleto sai por lá. E o campo "instruções" não deve conter caracteres especiais quebrem a leitura do barcode. Se tudo estiver certo, gere, baixe o PDF, envie e anote o ID. Se algum campo estiver errado, cancele imediatamente. Não adianta esperar o cliente reclamá, porque o prejuízo só aumenta com o tempo.
