Bancos¶
Cadastros > Complementares > Bancos
O que é¶
O cadastro de Bancos armazena as instituições financeiras utilizadas pela empresa para cobrança bancária, pagamentos e transferências. Cada banco pode ter múltiplas configurações de remessa/retorno de boletos, dados do cedente (beneficiário) e do sacador/avalista, além de integração com APIs de pagamento como a Zoop. Este cadastro é pré-requisito para o funcionamento de Contas Correntes, geração de boletos e processamento de ocorrências de cobrança.
Como acessar¶
No menu principal, clique em Cadastros → Complementares → Bancos.
Onde impacta o sistema¶
- Contas Correntes (banco vinculado à conta)
- Cobrança Bancária — geração de remessa e leitura de retorno CNAB
- Ocorrências de Cobrança (banco vinculado à ocorrência)
- Contas a Pagar e a Receber (banco do boleto)
- Tipos de Pagamento — Conta Corrente por tipo
- Integração Zoop (campo SellerId)
Como cadastrar um banco¶
- Clique em Novo (ou
Alt+N). - Na aba Banco, preencha Nro. do Banco, Agência, Nome do Banco e demais dados de identificação.
- Se o banco emitir boletos, vá até a aba Cobrança e preencha os dados de remessa, do cedente e do sacador/avalista.
- Na aba Arquivos, informe os caminhos de pasta para os arquivos de remessa, retorno e PDF de boletos.
- Se o banco for Zoop, informe o Código da Loja (SellerId).
- Clique em Gravar (ou
Alt+G).
Para bancos Unicred (091), Ailos (136) e Cooperativa (085), o layout CNAB é fixado em 240 automaticamente ao ativar a cobrança e o campo fica desabilitado.
Campos desta tela¶
Aba: Banco¶
| Campo | O que é | Observações |
|---|---|---|
| Código | Identificador interno sequencial | Somente leitura; gerado automaticamente. BANCOS.BC_CODIGO |
| Nro. do Banco | Número oficial do banco na compensação (ex.: 001, 341, 748) | Os 3 primeiros dígitos controlam regras automáticas de layout CNAB e visibilidade de campos. BANCOS.BC_NRO |
| Agência | Número da agência bancária | Para Sicredi via API: deve ter 6 dígitos (agência + posto avançado). BANCOS.BC_AGENCIA |
| Nome do Banco | Nome descritivo para identificação interna | Obrigatório. BANCOS.BC_NOME |
| Nome da Agência | Nome ou localidade da agência | BANCOS.BC_NOMEAGENCIA |
| Código do Cedente | Código de cedente/beneficiário fornecido pelo banco | Obrigatório para boletos Sicredi via API. BANCOS.BC_CCEDENTE |
| Código Convênio | Código de convênio bancário | Obrigatório para Banco do Brasil via API. BANCOS.BC_CCONVENIO |
| Código de Compensação | Código na câmara de compensação | BANCOS.BC_CODCOMPE |
| Cheque | Número de controle de cheque | BANCOS.BC_NROCHEQUE |
| Logotipo | Caminho da imagem do logotipo para impressão no boleto | Selecione via botão. BANCOS.BC_PATHLOGO |
| Inativo | Marca o banco como inativo | Bancos inativos não aparecem em pesquisas com filtro "Ativos". BANCOS.BC_INATIVO |
| Código de Operação | Código de operação bancária | BANCOS.BC_COPERACAO |
| Código da Loja (SellerId) | Identificador da loja na plataforma Zoop | Visível apenas para o banco Zoop. Obrigatório ao gravar: mensagem "O campo Código da Loja (SellerId) deve ser preenchido. Verifique!". BANCOS.BC_SELLERID |
| Dias para recebimento após o venc. | Prazo (em dias) para recebimento da cobrança bancária após o vencimento | Visível apenas para Banco do Brasil (001) no layout CNAB 400. BANCOS.BC_DIASRECEBVENC |
Aba: Cobrança — Configurações de Remessa¶
| Campo | O que é | Observações |
|---|---|---|
| Cobrança Ativa | Ativa a geração de boletos para este banco | Controla visibilidade do grupo Layout CNAB. BANCOS.BC_COBRATIVA |
| Layout CNAB | Define o padrão do arquivo de remessa (400 ou 240) | Padrão: 400. Para banco 133 (Cresol): fixado em 240 ao gravar. Para 091/136/085: fixado em 240 e desabilitado. BANCOS.BC_LAYOUT_CNAB |
| Com Registro | Indica cobrança com registro bancário | BANCOS.BC_REGISTRO |
| Banco emite boleto | O próprio banco gera o PDF do boleto | Visível para: Sicredi (748), Bradesco (237), Daycoval (041), BB (001), Sicoob (756), Caixa 240 (104). BANCOS.BC_BANCOEMITE |
| Cód. de Ocorrência | Código de ocorrência padrão para o arquivo de remessa | BANCOS.BC_AR_OCORR |
| Espécie/Tipo de Docto. | Espécie do documento no arquivo de remessa | BANCOS.BC_AR_ESPDOC |
| Instrução de Protesto 1 | Código da instrução de protesto principal | BANCOS.BC_AR_INSTP |
| Dias (Instrução 1) | Quantidade de dias para a instrução de protesto 1 | BANCOS.BC_AR_INSTPDD |
| Instrução de Protesto 2 | Segunda instrução de protesto | BANCOS.BC_AR_INSTP2 |
| Próx. Nosso Nro | Próximo "nosso número" a ser utilizado nos boletos | BANCOS.BC_PROXNNRO |
| Nosso Nro Limite | Limite máximo para o nosso número | BANCOS.BC_NNROLIMITE |
| Multa por Atraso (%) | Percentual de multa aplicado sobre boletos em atraso | BANCOS.BC_PERC_MULTA |
| Juro Diário por Atraso (%) | Taxa de juro diário aplicada sobre boletos em atraso | BANCOS.BC_JURO_DIARIO |
| Calcular Juros/Multas a partir de (Dias) | Carência em dias antes de aplicar juros e multa | BANCOS.BC_DIASJUROS |
| Negativação Automática | Habilita negativação automática dos inadimplentes | BANCOS.BC_NEGATIV_AUTO |
| Dias p/ negativação | Quantidade de dias após o vencimento para negativar | BANCOS.BC_DIAS_NEGATIV |
| NSA Cobrança | Número sequencial de arquivo para cobrança (Transferência de Fundos) | BANCOS.BC_NSA |
| NSA Pagamentos | Número sequencial de arquivo para pagamentos | BANCOS.BC_NSAP |
| Dias de Cobrança | Ciclo em dias da cobrança bancária | BANCOS.BC_DIASCOBR |
Aba: Cobrança — Cedente (Beneficiário)¶
| Campo | O que é | Observações |
|---|---|---|
| Nome do Beneficiário | Razão social do cedente conforme cadastro no banco | BANCOS.BC_RAZAO_COBR |
| CNPJ do Beneficiário | CNPJ ou CPF do cedente | Validado ao sair: 14 dígitos = CNPJ, 11 dígitos = CPF. Mensagens: "CNPJ Inválido. Verifique" ou "CPF Inválido. Verifique". BANCOS.BC_CNPJ_COBR |
| Imprimir no Boleto | Inclui os dados do cedente na impressão do boleto | BANCOS.BC_BOLETO_COBR |
| Gerar no Arquivo | Inclui os dados do cedente no arquivo de remessa | BANCOS.BC_ARQ_COBR |
| CEP | CEP do endereço do cedente | Consulta automática via Webservice ao preencher (se habilitado). BANCOS.BC_CEPCED |
| UF | Estado do cedente | BANCOS.BC_UFCED |
| Cidade | Cidade do cedente | BANCOS.BC_CIDADECED |
| Bairro | Bairro do cedente | BANCOS.BC_BAIRROCED |
| Endereço | Logradouro do cedente | BANCOS.BC_ENDERECOCED |
| Número | Número do endereço do cedente | BANCOS.BC_NROCED |
| Compl. | Complemento do endereço do cedente | BANCOS.BC_COMPLCED |
Aba: Cobrança — Sacador/Avalista¶
| Campo | O que é | Observações |
|---|---|---|
| Sacador/Avalista | Nome do sacador ou avalista | BANCOS.BC_NOMEAVAL |
| CPF/CNPJ | CPF ou CNPJ do avalista | Mesma validação do cedente. BANCOS.BC_CNPJAVAL |
| % (Desconto) | Percentual de desconto do avalista | Não pode ultrapassar 100%. Mensagem: "Desconto não permitido. Verifique!". BANCOS.BC_PDESCAVAL |
| CEP | CEP do endereço do avalista | Consulta automática via Webservice ao preencher. BANCOS.BC_CEPAVAL |
| UF | Estado do avalista | BANCOS.BC_UFAVAL |
| Cidade | Cidade do avalista | BANCOS.BC_CIDADEAVAL |
| Bairro | Bairro do avalista | BANCOS.BC_BAIRROAVAL |
| Endereço | Logradouro do avalista | BANCOS.BC_ENDERECOAVAL |
| Número | Número do endereço do avalista | BANCOS.BC_NROAVAL |
| Compl. | Complemento do avalista | BANCOS.BC_COMPLAVAL |
Aba: Cobrança — Intermediador¶
| Campo | O que é | Observações |
|---|---|---|
| Cliente | Cliente vinculado como intermediador de pagamento | Pesquisa via F3. Somente clientes ativos. BANCOS.BC_CLIENTE |
Aba: Arquivos¶
| Campo | O que é | Observações |
|---|---|---|
| Arquivo de Remessa | Pasta onde os arquivos de remessa serão salvos | Botão abre seletor de pasta. Barra final (\) é adicionada automaticamente ao sair do campo. BANCOS.BC_ARQREMESSA |
| Arquivo de Retorno | Pasta de onde os arquivos de retorno serão lidos | BANCOS.BC_ARQRETORNO |
| Arquivo do Boleto (PDF) | Pasta onde os PDFs dos boletos serão salvos | BANCOS.BC_ARQPDF |
Aba: API¶
| Campo | O que é | Observações |
|---|---|---|
| Código da Loja (SellerId) | Identificador único da loja na plataforma Zoop | Pode ser obtido automaticamente pelo botão ao lado (consulta via API Zoop usando o CNPJ/CPF da filial). BANCOS.BC_SELLERID |
Regras e comportamentos do sistema¶
- Ao clicar em Novo, os campos
BC_BOLETO_COBR,BC_ARQ_COBReBC_INATIVOsão definidos comoN,BC_COBRATIVAcomoSeBC_LAYOUT_CNABcomo400por padrão. - O grupo Layout CNAB só aparece quando Cobrança Ativa está marcada e o banco for 104, 756, 091, 136, 001, 085 ou 041.
- Para bancos Unicred (091), Ailos (136) e Cooperativa (085): o layout é forçado para CNAB 240 e o campo de seleção fica desabilitado.
- Para o banco 133 (Cresol): o layout é forçado para 240 automaticamente ao gravar.
- Os campos Dias para recebimento após o venc. ficam visíveis apenas para Banco do Brasil (001) no layout CNAB 400.
- Ao selecionar a UF do Cedente ou do Avalista, a lista de cidades é carregada dinamicamente.
- Ao preencher o CEP e sair do campo, o sistema consulta o Webservice de endereços (se o módulo estiver habilitado). Em caso de falha: "Não foi possível estabelecer uma conexão com o Webservice!".
- Para o banco Zoop: ao tentar gravar sem informar o SellerId, o sistema exibe: "O campo Código da Loja (SellerId) deve ser preenchido. Verifique!" e move o foco para o campo.
Dúvidas frequentes¶
Por que o campo "Layout CNAB" não aparece mesmo com a cobrança ativa? Esse grupo só é exibido para os bancos 104, 756, 091, 136, 001, 085 e 041. Para demais bancos, fica oculto.
O botão para buscar o SellerId da Zoop retorna erro. O que fazer? Verifique se a integração com a Zoop está configurada nos parâmetros especiais e se o CNPJ/CPF da filial está preenchido.
Como filtrar bancos inativos na consulta? Na tela de consulta use os botões Ativos, Inativos ou Todos antes de pesquisar.
Por que o campo "Banco emite boleto" não aparece? Esse campo é exibido somente para bancos que suportam emissão pelo banco: Sicredi (748), Bradesco (237), Daycoval (041), BB (001), Sicoob (756) e Caixa 240 (104).
Preciso que a API de boleto (Sicredi/BB) funcione. O que configurar aqui? Para Sicredi: preencha o Agência com 6 dígitos (agência + posto avançado) e o Código do Cedente. Para BB: preencha os 4 dígitos da agência e o Código Convênio. As credenciais de API ficam na aba API Boleto dentro de Contas Correntes.