← Central de Documentação

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.

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:

  1. 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.
  2. Pelo CPF/CNPJ exato do favorecido, combinado com valor exato do boleto e data de vencimento exata.
  3. 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

  1. 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.

    Formulário de novo lote, ainda vazio

    Lote salvo, com a toolbar completa: Salvar, Novo, Importar Retorno e Gerar

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

    Janela de importação do arquivo de retorno

    Confirmação de arquivo importado com sucesso

  3. 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.

    Grade de itens do lote, todos com situação Não Gerado

  4. 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.

    Janela de seleção manual de título para vincular ao item

    Confirmação ao clicar em Gerar: Deseja gerar as Contas a Pagar?

  5. 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.

Lista de lotes, com valores vinculado, não vinculado e total por lote

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:

Confirmação ao excluir um item do lote

Item removido com sucesso da grade

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:

  1. 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).
  2. Cria um título de Contas a Pagar com os dados abaixo.
  3. Lança o correspondente no fluxo de caixa, na conta do parâmetro Juros a Pagar.
  4. 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á.