Emitir Boletos em Lote por CSV | Boleto Cloud

A importação de boletos por CSV permite emitir múltiplos boletos de uma só vez, inclusive para diferentes contas bancárias no mesmo arquivo. Ideal para cobranças recorrentes, mensalidades ou faturamento em lote.

Dica

Diferente de outras funcionalidades, a importação de boletos permite enviar boletos de várias contas bancárias em um único arquivo, usando o Token API de cada conta.

---

Download do modelo

Arquivo Modelo CSV

O arquivo já contém o cabeçalho correto e exemplos de preenchimento com diferentes configurações de desconto.

Baixar modelo CSV

---

Pré-requisitos

Antes de importar boletos, você precisa:

1. Beneficiário cadastrado — Criar beneficiário
2. Conta bancária cadastrada — Criar conta bancária
3. Conta bancária homologada — Homologar conta
4. Pagadores cadastrados — Importar pagadores ou cadastrar manualmente
5. Token API da conta bancária — Veja como gerar na seção Token API

---

Estrutura do arquivo

O arquivo CSV deve usar ponto e vírgula (;) como separador. A ordem das colunas deve ser exatamente como descrito abaixo.

Campos obrigatórios

Coluna	Tipo	Descrição	Exemplo
TOKEN_CONTA_BANCARIA	texto	Token API da conta bancária	abc123token456
CPRF_PAGADOR	texto	CPF ou CNPJ formatado do pagador	111.111.111-11 ou 00.000.000/0001-91
VALOR	decimal	Valor do boleto (2 casas decimais)	150.00
VENCIMENTO	data	Data de vencimento (dd/MM/yyyy)	25/03/2025

O que é CPRF?

CPRF significa Cadastro de Pessoa na Receita Federal. Pode ser CPF ou CNPJ.

• CPF: 000.000.000-00
• CNPJ: 00.000.000/0000-00

Campos opcionais

Coluna	Tipo	Descrição	Exemplo
NOSSO_NUMERO	texto	Nosso número do boleto (somente se você já gera conforme regras do banco)	0000000001234
DOCUMENTO	texto	”Seu número” - identificador do seu negócio	FAT-001, NF-1234
MULTA	decimal	Percentual de multa (2 casas decimais)	2.00
JUROS	decimal	Percentual de juros ao mês (4 casas decimais)	0.0333
DIAS_PARA_ENCARGOS	inteiro	Dias após vencimento para iniciar cobrança de encargos	0
INFORMACAO_PAGADOR	texto	Informação exibida no recibo do pagador	"Mensalidade ref. Janeiro"

Sobre o campo DOCUMENTO

Se não informado, o sistema usará o mesmo sequencial do Nosso Número. Use este campo para colocar o número da sua nota fiscal, fatura ou pedido.

Campos de desconto

O sistema suporta até 3 níveis de desconto. Para cada nível, configure os três campos:

Coluna	Descrição
DESCONTO / DESCONTO2 / DESCONTO3	Valor ou percentual do desconto
DIAS_PARA_DESCONTO / DIAS_PARA_DESCONTO2 / DIAS_PARA_DESCONTO3	Dias antes do vencimento para aplicar o desconto
TIPO_VALOR_DESCONTO / TIPO_VALOR_DESCONTO2 / TIPO_VALOR_DESCONTO3	PERCENTUAL ou REAL

Cuidado

Os valores de TIPO_VALOR_DESCONTO devem ser informados exatamente como: PERCENTUAL ou REAL (em caixa alta).

• PERCENTUAL: O desconto será calculado como percentual do valor do boleto
• REAL: O desconto será um valor fixo em R$

Exemplo de desconto progressivo

Desconto	Valor	Dias antes	Tipo	Resultado (boleto de R$ 100,00)
1º	10.00	10	REAL	R$ 10,00 de desconto até 10 dias antes
2º	5.00	5	PERCENTUAL	5% de desconto até 5 dias antes
3º	2.00	1	REAL	R$ 2,00 de desconto até 1 dia antes

---

Ordem das colunas

As colunas devem estar na ordem exata abaixo:

1. TOKEN_CONTA_BANCARIA
2. CPRF_PAGADOR
3. VALOR
4. VENCIMENTO
5. NOSSO_NUMERO
6. DOCUMENTO
7. MULTA
8. JUROS
9. DIAS_PARA_ENCARGOS
10. DESCONTO
11. DIAS_PARA_DESCONTO
12. TIPO_VALOR_DESCONTO
13. DESCONTO2
14. DIAS_PARA_DESCONTO2
15. TIPO_VALOR_DESCONTO2
16. DESCONTO3
17. DIAS_PARA_DESCONTO3
18. TIPO_VALOR_DESCONTO3
19. INFORMACAO_PAGADOR

---

Como importar

1. Acesse o menu “Boleto > Importação > Importar arquivo CSV”

   

2. Selecione o arquivo CSV

   Clique para selecionar o arquivo que você preparou.

3. Confira a prévia dos dados

   O sistema mostrará uma prévia para conferência antes de efetivar a importação. Verifique com atenção os campos Vencimento e Valor.

   

   Cuidado

   Confira os dados com atenção! Caso precise corrigir algo, clique em “Cancelar e começar novamente”.

4. Confirme a importação

   Clique em “Confirmar a importação do arquivo” para efetivar.

5. Visualize o resultado

   O sistema exibirá a lista de boletos importados com sucesso.

   

---

Como gerar o Token API

O Token API identifica a conta bancária no arquivo de importação. Cada conta possui seu próprio token.

1. Acesse o menu “Conta > Consultar”

2. Localize a conta desejada e clique em “Mais > Editar”

3. Na seção INFO, clique no botão “Gerar token”

   

4. Copie o token gerado e use na coluna TOKEN_CONTA_BANCARIA do CSV

Nota

O token é gerado apenas uma vez. Se precisar de um novo token, você pode gerar novamente, mas o token anterior será invalidado.

---

Múltiplas contas bancárias

Uma vantagem da importação por CSV é poder enviar boletos de diferentes contas bancárias no mesmo arquivo. Basta usar o Token API correspondente a cada conta em cada linha.

TOKEN_CONTA_BANCARIA;CPRF_PAGADOR;VALOR;VENCIMENTO;...
token_conta_A;111.111.111-11;100.00;25/03/2025;...
token_conta_B;222.222.222-22;200.00;25/03/2025;...
token_conta_A;333.333.333-33;150.00;30/03/2025;...

---

Exemplo completo

TOKEN_CONTA_BANCARIA;CPRF_PAGADOR;VALOR;VENCIMENTO;NOSSO_NUMERO;DOCUMENTO;MULTA;JUROS;DIAS_PARA_ENCARGOS;DESCONTO;DIAS_PARA_DESCONTO;TIPO_VALOR_DESCONTO;DESCONTO2;DIAS_PARA_DESCONTO2;TIPO_VALOR_DESCONTO2;DESCONTO3;DIAS_PARA_DESCONTO3;TIPO_VALOR_DESCONTO3;INFORMACAO_PAGADOR
abc123token;111.111.111-11;331.00;25/03/2025;;2025010026;2.00;0.0333;0;10.00;5;REAL;;;;;;"Honorario ref. processo 123/2025"
abc123token;111.111.111-11;61.00;25/03/2026;;2025010028;;;;;;;;;;;;"Honorario ref. processo 456/2025"
abc123token;111.111.111-11;243.00;25/03/2027;;2025010145;2.00;0.0333;0;5.00;10;PERCENTUAL;;;;;;"Honorario ref. processo 789/2025"
abc123token;111.111.111-11;700.00;25/03/2028;;2025010036;;;;;;;;;;;;"Honorario ref. processo 012/2025"

---

Validações e erros comuns

Erros de estrutura

Erro	Causa	Solução
Colunas fora de ordem	Colunas não estão na sequência correta	Use o modelo de arquivo como referência
Token inválido	Token da conta não existe ou foi regenerado	Gere um novo token na conta bancária
Separador incorreto	Arquivo usa vírgula em vez de ponto e vírgula	Salve o CSV com separador ;

Erros de dados

Erro	Causa	Solução
Pagador não encontrado	CPRF não cadastrado no sistema	Importe os pagadores ou cadastre manualmente primeiro
Valor inválido	Formato incorreto	Use ponto como decimal: 150.00
Data inválida	Formato incorreto	Use dd/MM/yyyy: 25/03/2025
CPRF inválido	Documento com dígitos incorretos	Verifique CPF ou CNPJ

Erros de desconto

Erro	Causa	Solução
Tipo de desconto inválido	Valor diferente de PERCENTUAL ou REAL	Use exatamente PERCENTUAL ou REAL
Desconto sem tipo	Valor de desconto informado sem o tipo	Preencha o campo TIPO_VALOR_DESCONTO

---

Após a importação

Os boletos importados ficam com status “Aguardando Registro”. Para que possam ser pagos:

1. Acesse “Boleto > Consultar”
2. Selecione os boletos importados
3. Gere o arquivo de Remessa
4. Importe a remessa no internet banking do seu banco

Cuidado

Boletos não registrados podem não ser reconhecidos pela rede bancária no momento do pagamento.

---

Próximos passos

Importar Boletos por XML NFe Gere boletos automaticamente a partir de notas fiscais.

Importar Pagadores Cadastre pagadores em lote antes de importar boletos.