Importar Pagadores por Planilha CSV | Boleto Cloud

A importação por CSV permite cadastrar múltiplos pagadores de uma só vez, utilizando planilhas como Excel ou LibreOffice Calc para organizar os dados antes de enviar ao sistema.

Download do modelo

Baixe o arquivo modelo para facilitar a criação da sua planilha:

Arquivo Modelo CSV

O arquivo já contém o cabeçalho correto e exemplos de preenchimento para pessoa física e jurídica.

Baixar modelo CSV

Estrutura do arquivo

O arquivo CSV é um arquivo de texto simples com duas partes:

Cabeçalho — Primeira linha com os nomes das colunas (obrigatório)
Dados — Uma linha para cada pagador a ser importado

Regras de formatação

Regra	Descrição
Separador de campos	Ponto e vírgula (`;`)
Delimitador de texto	Aspas duplas (`"`)
Codificação	UTF-8 (para suportar acentos)

Exemplo visual

Veja como o arquivo deve ficar quando aberto em uma planilha:

Exemplo de planilha de importação de pagadores

Campos disponíveis

A tabela abaixo descreve todos os campos aceitos na importação. As colunas devem estar na ordem apresentada.

Campos obrigatórios

Coluna	Tipo	Descrição	Exemplo
`CPRF`	texto	CPF ou CNPJ formatado	`111.111.111-11` ou `00.000.000/0001-91`
`NOME`	texto	Nome completo ou razão social	`Alberto Santos Dumont`
`CEP`	número	CEP sem formatação	`36240000`
`UF`	texto	Sigla do estado (2 letras)	`MG`
`LOCALIDADE`	texto	Nome da cidade	`Santos Dumont`
`BAIRRO`	texto	Nome do bairro	`Casa Natal`
`LOGRADOURO`	texto	Rua, avenida, etc.	`BR-499`
`NUMERO`	texto	Número do endereço	`401` ou `S/N`

Campos opcionais

Coluna	Tipo	Descrição	Exemplo
`EMAIL`	texto	Email(s) separados por `;`	`contato@empresa.com`
`COMPLEMENTO`	texto	Complemento do endereço	`Apto 101, Bloco B`
`APRESENTACAO`	texto	Nome de apresentação/fantasia	`Grande Aviador`
`TELEFONE`	texto	Telefone fixo	`(31) 1111-2222`
`CELULAR`	texto	Telefone celular	`(11) 91111-0000`
`OPERADORA`	texto	Operadora do celular	`VIVO`, `CLARO`, `TIM`, `OI`
`ANOTACOES`	texto	Observações livres	Texto com quebras de linha

Operadoras aceitas

Para o campo OPERADORA, use um dos valores:

VIVO | CLARO | TIM | OI | NEXTEL | ALGAR | PORTO_SEGURO | SERCOMTEL | DESCONHECIDA

Como criar o arquivo

Abra uma planilha

Use Excel, LibreOffice Calc, Google Sheets ou outro programa de planilhas.

Crie o cabeçalho

Na primeira linha, insira os nomes das colunas exatamente como mostrado:

CPRF;NOME;EMAIL;CEP;UF;LOCALIDADE;BAIRRO;LOGRADOURO;NUMERO;COMPLEMENTO;APRESENTACAO;TELEFONE;CELULAR;OPERADORA;ANOTACOES

Adicione os pagadores

Preencha uma linha para cada pagador, respeitando a ordem das colunas.
Salve como CSV
- No Excel: Arquivo > Salvar como > CSV (separado por ponto e vírgula)
- No LibreOffice: Arquivo > Salvar como > CSV e configure o separador como ;
- No Google Sheets: Arquivo > Fazer download > CSV (depois ajuste o separador se necessário)
Verifique a codificação

Certifique-se de que o arquivo está em UTF-8 para preservar acentos e caracteres especiais.

Como importar

Acesse o menu “Pagador > Importar”

No menu lateral, clique em Pagador e depois em Importar.
Selecione o arquivo CSV

Clique em Escolher arquivo e selecione o CSV que você preparou.
Confirme a importação

Clique em Importar para processar o arquivo.
Verifique o resultado

O sistema exibirá um relatório com:
- Pagadores importados com sucesso
- Linhas com erro e o motivo da rejeição
Consulte os pagadores

Acesse Pagador > Consultar para ver os pagadores importados.

Validações e erros

O sistema valida cada linha do arquivo antes de importar. Veja os erros mais comuns:

Erros de documento (CPRF)

Erro	Causa	Solução
CPRF ausente	Coluna vazia	Preencha o CPF ou CNPJ
CPRF inválido	Dígito verificador incorreto	Verifique se o número está correto
Formato incorreto	Falta pontuação	Use `000.000.000-00` ou `00.000.000/0000-00`

Erros de endereço

Erro	Causa	Solução
CEP inválido	Menos de 8 dígitos	Preencha com 8 números, sem traço
UF inválida	Sigla diferente de 2 letras	Use a sigla do estado (ex: `SP`, `RJ`, `MG`)
Campo obrigatório vazio	Localidade, bairro ou logradouro vazio	Preencha todos os campos de endereço

Erros de contato

Erro	Causa	Solução
Email inválido	Formato incorreto	Use o formato `usuario@dominio.com`
Telefone inválido	Formato incorreto	Use `(00) 0000-0000` ou `(00) 00000-0000`

Dicas importantes

Ordem das colunas

As colunas devem estar na ordem exata do modelo. Não altere a posição nem remova colunas, mesmo as opcionais.

Campos vazios

Para campos opcionais que não serão preenchidos, deixe a coluna vazia (não escreva “N/A” ou ”-”).

Múltiplos emails

Você pode informar mais de um email separando-os por ponto e vírgula: email1@teste.com;email2@teste.com

Quebras de linha

O campo ANOTACOES aceita quebras de linha. Coloque o conteúdo entre aspas duplas.

Atualizando pagadores existentes

Se um pagador com o mesmo CPRF já existir no sistema:

Os dados serão atualizados com as informações do arquivo
O histórico de boletos do pagador é preservado

Exemplo completo

CPRF;NOME;EMAIL;CEP;UF;LOCALIDADE;BAIRRO;LOGRADOURO;NUMERO;COMPLEMENTO;APRESENTACAO;TELEFONE;CELULAR;OPERADORA;ANOTACOES
111.111.111-11;Alberto Santos Dumont;alberto@aviador.org;36240000;MG;Santos Dumont;Casa Natal;BR-499;1;"Sítio; Subindo a serra";Grande Aviador;(31) 1111-2222;(11) 91111-0000;TIM;Observações gerais
00.000.000/0001-91;Empresa Exemplo S.A.;contato@empresa.com;70073901;DF;Brasília;Setor Bancário Sul;SBS Quadra 01;S/N;Ed. Sede, 7º andar;Empresa;(61) 3102-0000;;;Cliente desde 2020

Próximos passos

Consultar Pagadores Verifique e gerencie os pagadores importados.

Alterar Pagador Ajuste dados de pagadores após a importação.

Importar Boletos por CSV Com os pagadores cadastrados, importe boletos em lote.

Cadastrar Pagador Manualmente Cadastre pagadores individualmente pelo formulário.