Cedentes BO04¶
Cadastro das contas bancárias que emitem boletos. Cada cedente representa uma conta corrente da empresa, com agência, conta, convênio, carteira e formato CNAB. Aqui também ficam as credenciais da API do banco e o controle da sequência de nosso número.
Pré-requisitos¶
- Ter permissão Financeiro: cedentes (geralmente Master/nível 0)
- Conhecer os dados da conta bancária: agência, conta, dígitos, convênio, carteira
- Para boletos via API: ter as credenciais do banco (Client ID, Client Secret, certificado)
Dados sensíveis
Os campos Client Secret, certificado e chave privada são armazenados de forma protegida. Não compartilhe e tenha cuidado ao copiar/colar.
Passo a passo¶
1. Acessar a tela¶
No menu lateral, clique em Financeiro → Boletos → Cedentes.
2. Filtrar a lista¶
| Filtro | Função |
|---|---|
| Empresa | Mostra cedentes de uma empresa específica. |
| Banco | Filtra por instituição (Itaú, Bradesco, Santander, Sicredi, Caixa, BB, Sicoob, etc.). |
A tabela traz: Empresa, Banco, Agência, Conta, Carteira e Tipo CNAB.
3. Cadastrar novo cedente¶
Clique em Novo Cedente no topo. O formulário tem:
Identificação:
| Campo | Obrigatório | Descrição |
|---|---|---|
| Empresa | Sim | A empresa do ERP dona desta conta. |
| Banco | Sim | Instituição bancária (lista pré-cadastrada). |
Conta bancária:
| Campo | Descrição |
|---|---|
| Agência | Número da agência (ex.: 0001). |
| Dígito Agência | Quando aplicável. |
| Conta | Número da conta corrente. |
| Dígito Conta | Dígito verificador. |
Convênio / Carteira (valores fornecidos pelo gerente do banco):
| Campo | Descrição |
|---|---|
| Código Cedente | Identificador do cedente no banco. |
| Convênio | Número do convênio de cobrança. |
| Código Transmissão | Em bancos que exigem (ex.: Santander). |
| Modalidade | Identifica o tipo de cobrança. |
| Carteira | Carteira de cobrança (ex.: 09, 17, 109). |
| Tipo Documento | Espécie padrão para emissão. |
Formato de arquivo:
| Campo | Descrição |
|---|---|
| Tipo CNAB | 240 ou 400 — define o layout do arquivo de remessa/retorno. |
| Índice ACBr | Identificador do banco no componente ACBrBoleto. |
| CNPJ do Cedente | CNPJ da titular da conta (deve bater com o cadastro da empresa). |
Clique em Cadastrar Cedente para salvar.
Confirme os dados com o gerente
Convênio, carteira e modalidade variam por banco e por cliente. Use os exatos valores informados pelo banco — divergências causam rejeição do arquivo de remessa.
4. Editar cedente¶
Na linha do cedente, clique em ··· e depois em Editar. Os mesmos campos do cadastro ficam disponíveis.
5. Configurar API do banco¶
Bancos que oferecem emissão de boletos via API (Itaú, Bradesco, Santander, Sicredi, etc.) exigem credenciais. No menu ···, clique em API:
| Campo | Descrição |
|---|---|
| Ambiente | Homologação (testes) ou Produção. |
| Client ID | Identificador da aplicação no portal do banco. |
| Client Secret | Senha da aplicação — campo mascarado, com botão para mostrar/ocultar. |
| Developer Application Key | Chave adicional exigida por alguns bancos (ex.: Itaú). |
| Certificado PEM | Cole o conteúdo do certificado público. |
| Chave Privada PEM | Cole o conteúdo da chave privada. |
Clique em Testar Conexão para validar antes de salvar.
Homologação primeiro
Sempre comece em Homologação. Só mude para Produção depois de validar o fluxo completo (emissão, remessa, retorno).
6. Ajustar sequência do nosso número¶
No menu ···, clique em Sequência. Mostra o nosso número atual e o número de remessa atual. Use para:
- Corrigir desvio em relação ao controle do banco.
- Reiniciar a sequência após troca de carteira.
| Campo | Função |
|---|---|
| Novo Nosso Número | Próximo valor que será atribuído ao emitir. |
| Nova Remessa | Próximo número de arquivo de remessa. |
| Motivo da Alteração | Obrigatório — fica registrado no histórico. |
Alterar sequência é operação sensível
Mexer no nosso número pode causar duplicidade ou rejeição. Faça apenas com orientação do gerente do banco e registre o motivo com detalhes.
Erros comuns¶
Arquivo de remessa rejeitado pelo banco
Quase sempre é divergência no convênio, carteira ou CNPJ do cedente. Confirme os três com o gerente.
API retorna 401/403 ao testar conexão
Client ID, Client Secret ou certificado incorretos. Refaça o pareamento no portal do banco e cole as credenciais novamente.
Tipo CNAB errado
Se a remessa não é aceita ou o retorno não é interpretado, confira se o Tipo CNAB (240 ou 400) bate com o que o banco usa para aquela conta.