Como configurar a carteira de boletos no VendaSimples

Q: Por que não consigo editar a carteira?

A carteira está em Processo de Homologação ou Ativa. Nessas situações ela abre só em Visualizar. Se precisar mudar algum dado, fale com o suporte.

Q: Onde fica a conta criada pela carteira?

Em Financeiro > Contas, com a etiqueta Gerado por Carteira Boleto. Ela não pode ser editada por lá: para mudar o nome, altere a Descrição da carteira. Veja contas bancárias e caixa.

Q: Já configurei a carteira. Como emito o boleto?

O boleto é emitido na conta a receber, na aba Boletos, escolhendo a carteira em Carteira Boleto. Veja como emitir boleto e, para mandar os boletos ao banco, remessa e retorno.

Passo a passo para configurar a carteira de boletos no VendaSimples: dados do banco, juros e multa, protesto e homologação com o gerente.

Atualizado em 6 de novembro de 2026 10 min de leitura

Para emitir boletos pelo VendaSimples, primeiro cadastre a carteira do seu banco. A carteira guarda os dados da sua conta de cobrança, os dados da sua empresa e as regras de juros, multa e protesto dos seus boletos. Depois de cadastrar, você envia boletos de teste para o gerente do banco conferir: é a homologação.

Antes de começar

Você precisa da extensão de boletos (veja como contratar extensões) e da permissão Acesso total de Boleto (veja permissões de usuário). Sem elas, o menu Boletos não aparece. Também é preciso ter uma Carteira de Cobrança contratada no seu banco. Os números pedidos na tela (código do beneficiário, agência, conta, CNAB) vêm do gerente da sua agência.

Abra a lista de carteiras
No menu, clique em Boletos e depois em Configurações. Abre direto a lista Carteiras de Boletos.
Escolha o banco e a carteira
Clique em Novo e escolha na lista a carteira que você contratou, como Sicoob Carteira 1-01 ou Itau Carteira 109. Confira bem: depois de salvar, o banco e a carteira não podem ser trocados.
Dê um nome para a carteira
Em Descrição, digite um nome fácil de reconhecer, como o nome do banco. O nome não pode repetir o de outra carteira. Leia o aviso Atenção, importante ! no topo dos dados da conta.
Preencha os dados da conta
Em Dados da Conta, preencha os números que o gerente passou: Código Beneficiário, CNAB, Agência, Dígito (Agência), Conta e Dígito (Conta). Os campos mudam conforme o banco: veja Campos de cada banco.
Preencha os dados da sua empresa
Em Dados do Beneficiário (o beneficiário é quem recebe o pagamento, a sua empresa), preencha Nome Beneficiário e CPF/CNPJ do jeito que estão no banco. Digite o CEP e clique na lupa para preencher o endereço. Complete o Nº e o Complemento.
Defina juros e multa
Em Mensagens de instruções para impressão no boleto, preencha Juros Mês e Multa, em porcentagem. Os dois são obrigatórios: se você não cobra, digite 0.
Complete protesto e instruções, se quiser
Marque Especificar Dias Protestos ? para informar Dias para Protesto e Especificar Dias Devolução ? para informar Dias para Devolução. Em Instrução 1 a Instrução 4, escreva frases para sair impressas no boleto. Os detalhes estão em Juros, multa, protesto e instruções.
Salve a carteira
Clique em Cadastrar. Aparece a mensagem Configuração de Carteira cadastrada com sucesso! e você volta para a lista. A coluna Situação da Homologação mostra Não enviado.

Ao cadastrar a carteira, o sistema cria uma conta com o mesmo nome no Financeiro, marcada Gerado por Carteira Boleto. É nela que entra o valor dos boletos pagos. Veja contas bancárias e caixa.

Se você é administrador, chega na mesma lista por Início > Todas as Configurações > Boletos > Carteira de Boletos.

Campos de cada banco

A lista do botão Novo tem as carteiras abaixo. Os campos de Dados da Conta e o tamanho de cada número mudam conforme a carteira escolhida.

Carteira	Código Beneficiário	Agência	Conta	Campo extra
Sicredi Carteira 1-A	5 números	4 números, sem dígito	5 números e dígito	Posto Cooperativa, com 2 números
Sicoob Carteira 1-01	6 números e Dígito (Beneficiário)	4 números e dígito	Até 8 números e dígito	Nenhum
Santander Carteira 101	7 números	4 números e dígito	8 números e dígito	Código de Transmissão, com 15 números
Safra Carteira 1	Não tem	4 números e dígito	6 números e dígito	Nenhum
Itau Carteira 109 e Itau Carteira 112	Não tem	4 números, sem dígito	5 números e dígito	Nenhum
Caixa Carteira SIG14	7 números	4 números; o dígito é opcional	Não tem	Nenhum
Brasil Carteira 17 Variacao 019 e Brasil Carteira 17 Variacao 027	7 números	4 números e dígito	8 números e dígito (na 019, o dígito aceita a letra x)	Nenhum
Bradesco Carteira 09	20 números	4 números e dígito	7 números e dígito	Nenhum
BancoInter Carteira 110	Não tem	4 números, sem dígito	9 números e dígito	Código de Operação, com 7 números

CNAB: o formato do arquivo de remessa e retorno que o sistema troca com o banco. Escolha CNAB 240 ou CNAB 400, como o gerente informar. No Inter, só existe CNAB 400.
Se o número for menor que o tamanho pedido, o sistema completa com zeros à esquerda quando você sai do campo. Isso vale para Código Beneficiário, Agência, Conta, Código de Transmissão e Código de Operação.
No Sicoob, o último número do código do beneficiário vai separado. Exemplo: para o código 1234567, digite 123456 em Código Beneficiário e 7 em Dígito (Beneficiário).
No Sicredi, digite os 2 números do Posto Cooperativa, mesmo que o primeiro seja zero (exemplo: 05).
O Código de Transmissão (Santander) e o Código de Operação (Inter) são fornecidos pelo banco na contratação da carteira de cobrança. Em caso de dúvida, peça ao gerente.

Juros, multa, protesto e instruções

O que você preenche em Mensagens de instruções para impressão no boleto vale para todos os boletos emitidos com esta carteira.

Juros Mês: os juros cobrados por mês de atraso, em porcentagem. Aceita até 4 casas depois da vírgula.
Multa: a multa por atraso, em porcentagem.
Dias para Protesto: só aparece com Especificar Dias Protestos ? marcado. Informe em quantos dias o banco deve protestar o boleto não pago (mandar para o cartório). O campo começa com 0: troque pelo número de dias.
Dias para Devolução: só aparece com Especificar Dias Devolução ? marcado. Informe em quantos dias o banco deve encerrar a cobrança do boleto não pago (dar baixa). Também começa com 0. Se você também especificar os dias para protesto, vale só o protesto: os dias para devolução não vão para o banco.
Instrução 1 a Instrução 4: linhas de texto livre que saem impressas no boleto, como um aviso para o cliente. Podem ficar em branco.

Dica

Combine com o gerente os dias de protesto e de devolução antes de preencher. Depois de clicar em Cadastrar ou Salvar, abra a carteira de novo e confira se os dois campos ficaram como você queria.

Enviar para homologação

A homologação é o teste da carteira com o banco. O sistema gera boletos de teste e o arquivo de remessa e manda tudo por e-mail para o gerente da sua agência conferir.

Abra a homologação
Na lista Carteiras de Boletos, clique em Homologação na linha da carteira. No celular, o botão fica no menu de três pontos da linha.
Escolha o parceiro de teste
Em Nome do Parceiro, digite pelo menos 3 letras e clique no nome, ou clique na lupa para pesquisar. Esse parceiro vai como pagador (quem paga o boleto) nos boletos de teste. Em Selecione o endereço, marque o endereço que vai no boleto.
Informe valor e quantidade
Preencha o Valor de cada boleto e a Quantidade de boletos, de 1 a 10. Não deixe a quantidade em branco.
Confira os arquivos, se quiser
Clique em Gerar Boleto(s) e Remessa, no topo da tela. O sistema baixa o PDF com os boletos de teste e o arquivo de remessa. O botão só funciona com o parceiro e o valor preenchidos.
Preencha o e-mail
Em Email do gerente, digite o e-mail do gerente da sua agência. Para mandar uma cópia a outra pessoa, use CC. Preencha também Assunto e Mensagem.
Envie
Clique em Enviar para homologação. Aparece a mensagem Dados e arquivos de homologação enviados com sucesso! e você volta para a lista. A carteira passa para Processo de Homologação.

Situação da homologação

Situação	O que significa
Não enviado	A carteira está cadastrada, mas ainda não foi enviada para homologação. Você pode editar e enviar.
Processo de Homologação	Os testes foram enviados ao gerente. A carteira abre só em Visualizar e o botão Homologação some.
Ativa	A carteira foi liberada. Ela também abre só em Visualizar.
Rejeitado	Os testes foram recusados. Clique em Editar, corrija os dados e envie de novo pela Homologação.

Só a equipe de suporte do VendaSimples muda a situação para Ativa ou Rejeitado. Se o banco já respondeu e a situação não mudou, fale com o suporte.

Editar uma carteira

Abra a carteira
Na lista Carteiras de Boletos, clique em Editar ou no nome da carteira.
Altere os dados
Mude o que precisar. Na edição aparece o campo Nosso número atual: o número que o próximo boleto desta carteira vai receber (o "nosso número" identifica o boleto no banco). Ele sobe sozinho a cada boleto emitido. Só altere esse número se o banco ou o suporte pedir.
Salve
Clique em Salvar. Aparece a mensagem de que a carteira foi editada com sucesso.

O banco e a carteira escolhidos no Novo não mudam. Para trocar de banco, cadastre uma carteira nova.
Se você mudar a Descrição, a conta criada pela carteira muda de nome junto.
Com a situação em Processo de Homologação ou Ativa, o botão aparece como Visualizar e os campos ficam travados.

Excluir uma carteira

Na lista, clique em Excluir na linha da carteira. Aparece a pergunta Realmente deseja excluir a Carteira de Boletos "(nome)" ?. Confirme. Se a carteira já tem boletos emitidos, o sistema não deixa excluir: veja Erros comuns.

Erros comuns

Mensagem	O que fazer
Descrição não pode ser repetida	Já existe uma carteira com esse nome, mesmo que ela já tenha sido excluída. Use outra Descrição.
Descrição é obrigatória, CNAB é obrigatório, Agência é obrigatória, Conta é obrigatória e parecidas	Preencha o campo indicado com os dados que o gerente passou.
Campo Juros Mês é obrigatório ou Campo Multa é obrigatório	Preencha a porcentagem. Se você não cobra juros ou multa, digite 0.
CPF inválido ou CNPJ inválido	Confira o CPF/CNPJ do beneficiário, número por número.
Campo Municipio é obrigatório, Campo logradouro é obrigatório ou Campo bairro é obrigatório	Complete o endereço do beneficiário. O jeito mais fácil é digitar o CEP e clicar na lupa.
Campo número é obrigatório	Preencha o Nº do endereço do beneficiário. A busca pelo CEP não preenche esse campo.
Parceiro é obrigatório ou Valor deve ser maior que zero	Na homologação, escolha o parceiro de teste e digite um valor maior que zero.
E-mail gerente é obrigatório ou E-mail inválido	Digite o e-mail completo do gerente, no formato nome@banco.com.br. O mesmo vale para o CC.
Assunto é obrigatório ou Mensagem é obrigatório	Preencha o assunto e a mensagem do e-mail antes de enviar.
QuantidadeBoleto não pode ser vazio	Preencha a Quantidade de boletos, de 1 a 10.
IdEndereco não pode ser vazio	O parceiro de teste não tem endereço (aparece Nenhum Endereço encontrado). Cadastre um endereço nele ou escolha outro parceiro. Veja cadastro de parceiro.
Carteira não pode ser removida pois existem boletos em aberto/vencidos, cancele os mesmos antes de tentar excluir novamente.	A carteira já tem boletos emitidos. Antes de cancelar boletos só para excluir a carteira, fale com o suporte.

Perguntas frequentes

Meu banco não aparece na lista do botão Novo. O que faço?

A lista mostra só as carteiras que o VendaSimples emite: Sicredi, Sicoob, Santander, Safra, Itaú, Caixa, Banco do Brasil, Bradesco e Inter, nas carteiras da tabela Campos de cada banco. Se a sua carteira é outra, pergunte ao gerente se o banco tem uma dessas ou fale com o suporte.

Por que não consigo editar a carteira?

A carteira está em Processo de Homologação ou Ativa. Nessas situações ela abre só em Visualizar. Se precisar mudar algum dado, fale com o suporte.

Onde fica a conta criada pela carteira?

Em Financeiro > Contas, com a etiqueta Gerado por Carteira Boleto. Ela não pode ser editada por lá: para mudar o nome, altere a Descrição da carteira. Veja contas bancárias e caixa.

Já configurei a carteira. Como emito o boleto?

O boleto é emitido na conta a receber, na aba Boletos, escolhendo a carteira em Carteira Boleto. Veja como emitir boleto e, para mandar os boletos ao banco, remessa e retorno.