Contas Bancarias
A tela de Contas Bancarias cadastra contas financeiras e define se a integracao bancaria usara EDI/CNAB ou API bancaria.
Para que serve
Antes de comecar
- Cadastre a empresa vinculada.
- Tenha banco, agencia, conta, titular e documento do titular.
- Para EDI, tenha convenio/carteira/codigo cedente conforme o contrato bancario.
- Para API, tenha Client ID, Client Secret e demais credenciais fornecidas pelo banco.
- Nao compartilhe nem registre segredos fora do sistema.
Como cadastrar
- Clique em Adicionar.
- Selecione a empresa.
- Informe codigo, descricao, banco, modalidade e ambiente.
- Preencha titular, documento, agencia e conta.
- Para EDI, selecione o layout CNAB e preencha os campos de cobranca exigidos pelo banco.
- Para API, preencha somente as credenciais e identificadores exigidos para o banco selecionado.
- Marque Conta ativa.
- Clique em Salvar.
Campos principais
| Campo | Uso |
|---|---|
| Codigo Conta (CODCTB) | Codigo interno gerado pelo sistema |
| Empresa | Empresa dona da conta |
| Codigo | Codigo operacional da conta |
| Descricao | Nome de identificacao |
| Banco | Banco da conta |
| Modalidade | EDI/CNAB ou API bancaria |
| Layout CNAB | CNAB 240 ou CNAB 400 para remessa/retorno |
| Ambiente | Homologacao ou Producao |
| Titular | Nome do titular |
| Documento Titular | CPF ou CNPJ do titular |
| Agencia / Conta | Dados bancarios |
| Chave PIX | Chave para operacoes PIX |
| Client ID | Identificador da API bancaria |
| Client Secret | Segredo de API, tratado como campo protegido |
| Developer Application Key | Chave exigida por alguns bancos |
| Certificado | Alias e senha para integracoes que exigem certificado |
Regras importantes
- Empresa, codigo, descricao, banco, modalidade, ambiente, titular, documento, agencia e conta sao obrigatorios.
- EDI nao exige OAuth/API. O layout CNAB selecionado fica salvo na conta.
- API exige Client ID e Client Secret; Banco do Brasil tambem exige Developer Application Key.
- Documento do titular e salvo somente com numeros.
- Webhooks bancarios sao tratados por rotas do sistema e nao precisam ser configurados manualmente na tela.
- Campos sensiveis podem aparecer apenas como configurados, sem revelar valor.
- Para alterar um segredo, preencha o campo novamente; para manter, deixe em branco quando a tela orientar assim.
Dicas de operacao
- Use Homologacao para validar integracao bancaria antes de Producao.
- Guarde credenciais em local seguro e evite expor em mensagens, prints ou chamados.
Problemas comuns
| Situacao | Como resolver |
|---|---|
| EDI pede campo de cobranca | Preencha convenio, carteira, codigo cedente ou transmissao conforme o banco selecionado |
| API aparece nao configurada | Preencha Client Secret e demais credenciais exigidas |
| Agencia nao aparece na lista | Cadastre agencia ou informe manualmente quando a tela permitir |
| Integracao falha em producao | Revise ambiente, credenciais, certificado e dados bancarios |
Telas do sistema
Capturas reais desta tela, com dados sensíveis mascarados.
