Lote de Pagamento (DDA)
Como o CRTI ERP importa o retorno bancário do DDA, concilia boletos a pagar automaticamente e gera as Contas a Pagar correspondentes.
- O que é o DDA bancário
- Onde fica a tela
- Pré-requisitos
- Bancos suportados
- Como o sistema decide com qual título casar
- Fluxo passo a passo
- Status de cada item do lote
- Campos das telas
- Vinculação manual: o que a janela mostra
- O que acontece ao clicar em Gerar
- Efeito no título de Contas a Pagar
- Mensagens da tela e o que fazer
- Diferença para o Borderô de Pagamento Eletrônico
- Limitações conhecidas
- Observações importantes
Não confundir com “DDA de Custos”. Existe outra funcionalidade no ERP chamada “DDA” (Resultado Indireto), usada em Custos e Resultado Econômico, sem nenhuma relação com pagamento de boletos. Veja DDA de Custos (Resultado Indireto). Esta página trata do DDA bancário, o “Débito Direto Autorizado” da FEBRABAN.
O que é o DDA bancário
O DDA (Débito Direto Autorizado) é um serviço da FEBRABAN pelo qual os bancos registram, contra o CNPJ da empresa, os boletos emitidos por fornecedores. A empresa deixa de depender do boleto físico e passa a consultar e pagar os títulos diretamente pelo cadastro do banco.
No CRTI ERP, a tela Lote de Pagamento (DDA) cuida da ponta de entrada desse processo: ela importa o arquivo de retorno que o banco envia listando os boletos registrados, tenta casar cada um com um título de Contas a Pagar já existente e, quando não encontra, permite gerar o título do zero. Ela não gera arquivo de remessa para o banco pagar; essa parte fica com a tela Borderô de Pagamento Eletrônico (ver Diferença para o Borderô de Pagamento Eletrônico).
Onde fica a tela
Gestão de Finanças > Financeiro > Pagamento Eletrônico > Lote de Pagamento (DDA).
O submenu Pagamento Eletrônico reúne três telas com propósitos diferentes:
| Tela | Direção | Para que serve |
|---|---|---|
| Borderô de Pagamento Eletrônico | ERP → banco | Monta e envia o arquivo de remessa com os pagamentos a realizar |
| Lote de Pagamento (DDA) | banco → ERP | Importa o retorno com os boletos registrados no DDA e concilia com Contas a Pagar |
| Pagamento Eletrônico (Retorno) | banco → ERP | Trata o retorno geral de pagamentos eletrônicos (confirmação de borderôs enviados) |
Pré-requisitos
Antes de usar a tela, confira estes pontos. A maioria dos atendimentos sobre esta rotina cai em um deles:
| O que | Onde se configura | Por que é necessário |
|---|---|---|
| Permissão da tela | Configurações do Sistema > Permissões > Usuários | Sem a permissão da tela Lote de Pagamento (DDA), ela não aparece no menu |
| Conta Corrente com banco suportado | Financeiro > Cadastros > Conta Corrente | O banco vinculado à Conta Corrente é o que define o layout de leitura do arquivo (ver Bancos suportados) |
| Parâmetro Entradas (Tipo de Documento) | Parâmetros do sistema, TIPO_DOCUMENTO_PADRAO_ENTRADAS |
Usado no título gerado pelo botão Gerar |
| Parâmetro Entradas (Histórico) | Parâmetros do sistema, HISTORICO_PADRAO_ENTRADAS |
Usado no título gerado pelo botão Gerar |
| Parâmetro Juros a Pagar (conta de fluxo de caixa) | Parâmetros do sistema, CONTA_FLUXO_CAIXA_JUROS_PAGAR |
Obrigatório para o botão Gerar. Se estiver vazio, ou apontar para uma conta que não seja analítica, o Gerar falha |
| Parâmetro Conta Crédito para Importação | Parâmetros do sistema, CONTA_CREDITO_PARA_IMPORTACOES |
Só é exigido quando o módulo contábil está ativo |
| Fornecedor cadastrado | Cadastros > Fornecedores | O botão Gerar procura o fornecedor pelo CPF/CNPJ que veio no arquivo do banco. Sem cadastro, o Gerar falha |
Atenção ao parâmetro Juros a Pagar. Apesar do nome, é ele que o sistema usa como conta de fluxo de caixa do título gerado pelo DDA. É a causa mais comum de erro no botão Gerar em uma base recém-configurada.
Bancos suportados
A leitura do arquivo de retorno depende de um layout específico por banco. Hoje três bancos têm o layout implementado:
| Código FEBRABAN | Banco | Suportado |
|---|---|---|
| 001 | Banco do Brasil | Sim |
| 237 | Bradesco | Sim |
| 341 | Itaú Unibanco | Sim |
| outros | (qualquer outro banco cadastrado na Conta Corrente) | Não |
Atenção ao código do Bradesco: o layout implementado é o do 237 (Banco Bradesco S.A.). As outras entradas “Bradesco” do cadastro de bancos — 036 (BBI), 204 (Cartões) e 394 (Financiamentos) — não são suportadas.
Quando o banco da Conta Corrente não é um dos suportados, o comportamento varia e nenhum dos dois casos é óbvio para o usuário:
- Banco conhecido pelo sistema, mas sem layout de DDA (Santander, Inter, Caixa e afins): a importação responde “Arquivo importado com sucesso” e não traz nenhum item, como se o arquivo estivesse vazio. Pior: o lote é travado de qualquer forma, então não dá para reimportar nele. É preciso criar um lote novo com uma Conta Corrente de um dos bancos suportados.
- Banco não reconhecido pelo sistema: a importação responde “Erro ao processar arquivo”. Nesse caso o lote não é travado e pode ser reaproveitado.
Se um lote importado ficar sem nenhuma linha, confira primeiro o banco da Conta Corrente. O arquivo pode estar perfeito; o layout simplesmente não é lido.
Como o sistema decide com qual título casar
Para cada boleto lido do arquivo, a conciliação tenta três caminhos, nesta ordem, e para no primeiro que retornar resultado:
- Pela linha digitável. Procura um título de Contas a Pagar que já tenha exatamente aquela linha digitável gravada. Esse caminho ignora valor, datas e fornecedor.
- Pelo CPF/CNPJ exato do favorecido, combinado com valor exato do boleto e data de vencimento exata.
- Pela raiz do CNPJ (os 8 primeiros dígitos), também com valor exato e vencimento exato. Só acontece quando o documento do arquivo é um CNPJ.
Pontos que costumam gerar dúvida:
- A data de emissão não participa da conciliação automática. Só o vencimento.
- O vencimento tem que ser igual, não aproximado. Um dia de diferença entre o título e o boleto já impede o casamento automático.
- O valor tem que ser igual. Título lançado com juros, multa ou desconto embutido não casa.
- O passo 3 pode cair em outra filial do mesmo fornecedor, porque compara só a raiz do CNPJ. Vale conferir o fornecedor do título antes de aceitar a vinculação.
- O resultado só vira “Vinculado” quando encontra exatamente um título. Se a busca devolver dois ou mais candidatos, o item fica como “Não Gerado” de propósito, para o usuário escolher na mão.
Fluxo passo a passo
-
Criar o lote. Clique em Novo, informe a Conta Corrente (ela determina o banco e o layout usado na leitura) e a Data do Movimento, e salve. Enquanto o lote não é importado, ele pode ser editado e salvo novamente.


-
Importar Retorno. Com o lote salvo, clique em Importar Retorno e selecione o arquivo de retorno (layout CNAB240) recebido do banco.


- Conciliação automática. Para cada boleto do arquivo, o sistema procura um título de Contas a Pagar correspondente, pelos critérios descritos em Como o sistema decide com qual título casar.
- Encontrou exatamente um título compatível: o item entra vinculado a esse título.
- Não encontrou nenhum, ou encontrou mais de um candidato: o item fica pendente, para tratamento manual.

- Tratar as pendências. Para cada item pendente, o usuário pode:
- Selecionar manualmente um título de Contas a Pagar já existente para vincular ao item; ou
- Clicar em Gerar, que cria um título de Contas a Pagar novo para todos os itens ainda pendentes do lote, de uma vez.


- Lote travado. Assim que o retorno é importado, o lote registra a data e o usuário da liberação e trava: os botões Importar Retorno e Salvar somem da tela. Não é possível reimportar outro arquivo no mesmo lote nem editar os dados do cabeçalho depois disso. Repare que, nos prints acima, a grade de itens já aparece com a toolbar reduzida a apenas Novo e Gerar: é exatamente esse o efeito do travamento.
Status de cada item do lote
| Situação | O que significa | Ação disponível |
|---|---|---|
| Não Gerado | Não foi possível conciliar automaticamente com nenhum título | Selecionar manualmente um título existente, ou usar o botão Gerar para criar um novo |
| Vinculado | O item está associado a um título de Contas a Pagar (automática ou manualmente) | Pode ser desvinculado, voltando para Não Gerado |
| Gerado | Um título de Contas a Pagar novo foi criado a partir deste item, pelo botão Gerar | Nenhuma; o título já existe e está associado ao item |
Campos das telas
Consulta: Número do lote e Período de Movimento (data inicial e final).
Cadastro do lote: Número (gerado pelo sistema), Data do Movimento, Conta Corrente, Usuário e Data de Inclusão. Abaixo, a grade de itens do retorno, com as colunas Situação, CPF/CNPJ, Razão Social/Empresa, Documento, Vencimento, Emissão, Valor e Linha Digitável. O ícone na primeira coluna muda de acordo com a situação do item: um ícone para selecionar manualmente (quando Não Gerado) e outro para desvincular (quando Vinculado).
Lista de lotes: Código, Conta Corrente, Data do Movimento, Data de Inclusão, Valor Vinculado, Valor Não Vinculado e Valor Total. A tela também permite exportar a lista para Excel, usando os filtros da aba de consulta (não o lote aberto na aba de cadastro).
Os três valores da lista são somas dos itens do lote, e servem para ver de longe quanto já foi tratado:
| Coluna | O que soma |
|---|---|
| Valor Não Vinculado | Itens ainda pendentes (situação Não Gerado) |
| Valor Vinculado | Itens já resolvidos (situação Vinculado ou Gerado) |
| Valor Total | Todos os itens do lote |
Um lote com Valor Não Vinculado maior que zero é um lote que ainda tem trabalho pendente.

Um item pendente também pode ser removido do lote diretamente (ícone de exclusão na grade de itens), sem precisar vinculá-lo ou gerá-lo:


Vinculação manual: o que a janela mostra
Ao clicar no ícone de seleção manual de um item pendente, abre a janela de busca de títulos. O que ela lista não é a lista completa de Contas a Pagar: ela já vem filtrada pelos dados do boleto.
Filtros fixos, que o usuário não altera:
- CPF/CNPJ do favorecido que veio no arquivo do banco.
- Valor exato do boleto.
Filtros editáveis na barra da janela:
- Documento (número do documento, até 9 dígitos).
- Vencimento de/até, que já abre preenchido com o primeiro e o último dia do mês do vencimento do boleto.
- Emissão de/até, que abre em branco.
Se o título não aparece na janela, quase sempre é o valor. Como o valor do boleto é filtro fixo, um título lançado com valor diferente (juros, multa, desconto, ou lançado em parcelas) nunca vai ser listado. Nesse caso o caminho é usar o botão Gerar, ou ajustar o título em Contas a Pagar antes.
Vale notar que a janela não filtra pela situação do título: um título já baixado pode aparecer na lista e ser vinculado. Confira a situação antes de selecionar.
O que acontece ao clicar em Gerar
O botão Gerar atua somente sobre os itens com situação “Não Gerado”. Itens já “Vinculado” ou “Gerado” são ignorados. Para cada item pendente, o sistema:
- Localiza o Fornecedor pelo CPF/CNPJ informado no retorno do banco (CNPJ quando o documento tem mais de 11 dígitos, CPF quando tem até 11).
- Cria um título de Contas a Pagar com os dados abaixo.
- Lança o correspondente no fluxo de caixa, na conta do parâmetro Juros a Pagar.
- Marca o item como Gerado e o associa ao novo título.
O título criado sai assim:
| Campo do título | Vem de |
|---|---|
| Fornecedor | CPF/CNPJ do arquivo do banco |
| Número do documento | Número do documento do arquivo |
| Sequência do documento | Próxima sequência livre para aquele fornecedor e número |
| Tipo de Documento e Histórico | Parâmetros Entradas |
| Emissão e Vencimento | Datas do arquivo |
| Valor | Valor do boleto |
| Filial de movimento e de cobrança | Filial da Conta Corrente do lote |
| Conta corrente de origem do pagamento | Conta Corrente do lote |
| Forma de pagamento | Boleto |
| Situação | Aberto |
| Moeda | Nacional |
| Linha digitável | Linha digitável do boleto |
| Complemento | “Gerado via Lote de Pagamento (DDA) nº X.” |
| Contas contábeis (crédito/débito) | Só quando o módulo contábil está ativo |
O Gerar é tudo ou nada. Se qualquer item do lote tiver um fornecedor que não está cadastrado, a operação é interrompida e nenhum título é criado, nem os dos itens que estavam corretos. Cadastre todos os fornecedores pendentes e clique em Gerar novamente.
Efeito no título de Contas a Pagar
Vincular ou desvincular não mexe só no lote: o sistema grava a linha digitável do boleto no título de Contas a Pagar.
| Ação | Efeito no título |
|---|---|
| Conciliação automática encontrou o título | Grava a linha digitável do boleto no título |
| Vinculação manual | Grava a linha digitável do boleto no título |
| Desvinculação | Limpa a linha digitável do título, deixando o campo vazio |
| Gerar | O título é novo e já nasce com a linha digitável |
Cuidado ao desvincular. A desvinculação apaga a linha digitável do título, inclusive se ela tinha sido preenchida antes por outro caminho (digitada na mão, por exemplo). Se o objetivo é apenas trocar o item de título, refaça a vinculação em seguida.
Mensagens da tela e o que fazer
| Mensagem | Quando aparece | O que fazer |
|---|---|---|
| Lote salvo com sucesso. | Ao salvar o cabeçalho do lote | Seguir para Importar Retorno |
| Arquivo importado com sucesso. | Fim da importação | Conferir se vieram itens. Se vier vazio, checar o banco da Conta Corrente |
| Arquivo inválido. | Nenhum arquivo selecionado, ou arquivo vazio | Selecionar o arquivo de retorno novamente |
| Erro ao processar arquivo. | Falha genérica na importação | Mensagem propositalmente genérica: a causa real fica registrada no log do servidor. Causas conhecidas: lote inexistente, banco da Conta Corrente não reconhecido, ou arquivo fora do layout CNAB240 do banco. Abrir chamado com a data/hora e o número do lote |
| Não existem itens para processar. | Clicou em Gerar e o lote não tem nenhum item “Não Gerado” | Nada a fazer: todos os itens já estão Vinculado ou Gerado |
| Fornecedor documento - nome não encontrado. | Clicou em Gerar e o fornecedor do boleto não está cadastrado | Cadastrar o fornecedor com aquele CPF/CNPJ e clicar em Gerar novamente. Lembre que o Gerar é tudo ou nada |
| Títulos liberados com sucesso. | Fim do Gerar | Conferir os títulos criados em Contas a Pagar |
| Vinculado com sucesso. | Fim da vinculação manual | Item passa para a situação Vinculado |
| Removido com sucesso. | Fim da exclusão de um item | O item sai do lote definitivamente |
Sobre o “Erro ao processar arquivo”. Essa tela não repassa ao usuário o motivo exato da falha de importação. Para o suporte, isso significa que o log do servidor é obrigatório para diagnosticar: peça sempre o número do lote e o horário aproximado da tentativa.
Diferença para o Borderô de Pagamento Eletrônico
O Lote de Pagamento (DDA) e o Borderô de Pagamento Eletrônico resolvem metades opostas do mesmo processo de pagamento eletrônico:
- O Borderô parte de títulos já lançados no ERP e gera o arquivo de remessa que vai para o banco pagar.
- O Lote de Pagamento (DDA) parte do que o banco já registrou como boleto contra o CNPJ da empresa (arquivo de retorno) e concilia ou cria os títulos correspondentes no ERP.
Um não substitui o outro: é possível que um título chegue pelo DDA (o fornecedor emitiu o boleto e o banco o registrou) e, mesmo assim, seja pago depois por um Borderô comum.
Limitações conhecidas
Comportamentos atuais da rotina que costumam virar dúvida. Não são erros de uso:
- Não há reimportação no mesmo lote. Uma vez importado, o lote trava. Arquivo errado, ou importado em lote com a Conta Corrente errada, significa criar um lote novo.
- A conciliação não olha a situação do título. Um título já baixado pode ser conciliado ou aparecer na vinculação manual.
- A conciliação não olha a filial. O título casado pode ser de outra filial, desde que valor, vencimento e documento batam.
- A exclusão de um item é definitiva. Não existe desfazer: o item sai do lote e só volta em uma nova importação, o que exige um lote novo.
- A tela não mostra o motivo de uma falha de importação. Ver a seção de mensagens acima.
Observações importantes
- A importação processa o arquivo inteiro em uma única operação; não existe reprocessamento parcial ou reenvio automático em caso de falha, é sempre um novo lote com um novo arquivo.
- A conciliação automática pode gerar mais de um candidato quando há títulos muito parecidos; nesses casos o item fica pendente para conferência manual, propositalmente, em vez de escolher um dos candidatos sozinho.
- Depois que o lote é travado (após a importação), a única forma de alterar a vinculação de um item é vinculando ou desvinculando manualmente cada item; não é possível reabrir o cabeçalho do lote para edição.
- Um item pode ir e voltar entre Não Gerado e Vinculado quantas vezes for preciso. O que não volta é o Gerado: o título já foi criado em Contas a Pagar e passa a ser tratado por lá.