MFC032 — Gerenciamento de Títulos a Pagar (enriquecimento)

Menu: Financeiro > Movimentações > Gerenciamento de Títulos a Pagar

Objetivo

O MFC032 gerencia o ciclo de títulos a pagar por remessa bancária: o usuário seleciona duplicatas em aberto, gera o arquivo CNAB de remessa para o banco, processa o arquivo de retorno bancário para liquidar automaticamente os títulos pagos, e importa arquivos DDA para conciliar boletos recebidos com o Contas a Pagar. A tela cobre pagamento por código de barras/linha digitável e por Pix, conforme o parâmetro de remessa configurado para a forma de pagamento.

Fluxo principal

1. Informar Empresa, Forma de Pagamento e opcionalmente período de emissão/vencimento, documentos e pessoas nos filtros. (Arquivos de Remessa > Filtros) — source/MFC032/UMFC032.pas:504-528 (TfrmMFC032.btnConsultarClick)
2. Clicar em Consultar (F3): sistema busca contas a pagar em aberto (exclui provisões PP/PR) e parâmetros de remessa da forma de pagamento. (Arquivos de Remessa > Contas a Pagar) — source/MFC032/UMFC032.pas:534-577 (TfrmMFC032.btnConsultarClick)
3. Marcar os títulos a pagar (coluna Status), ajustar desconto/acréscimo se necessário e escolher a Instrução. (Arquivos de Remessa > Contas a Pagar) — source/MFC032/UMFC032.pas:654-712 (TfrmMFC032.gridCONTASKeyDown)
4. Clicar em Gerar Arquivos (F6): grava os títulos marcados em CONFBOLETO, gera o número de sequência e o arquivo de remessa CNAB no diretório configurado. (Arquivos de Remessa > Contas a Pagar) — source/MFC032/UMFC032.pas:714-796 (TfrmMFC032.btnGeraArquivosClick)
5. Na aba Retorno, informar Conta Saldo e o Diretório dos Arquivos de Retorno e clicar Processar (F3). (Retorno) — source/MFC032/UMFC032.pas:807-850 (TfrmMFC032.btnProcessarClick)
6. Sistema lê cada arquivo do diretório e tenta casar cada título do retorno com um lançamento do Contas a Pagar pelo Seu Número (ou pelo código de barras/linha digitável como alternativa). (Retorno) — source/MFC032/UdmMFC032.pas:929-1040 (Atualiza_Retorno)
7. Na aba DDA, informar o Diretório dos Arquivos e clicar Processar; sistema tenta localizar a empresa pelo CNPJ e casar cada título por linha digitável/valor. (DDA) — source/MFC032/UMFC032.pas:910-944 (TfrmMFC032.btnProcessarDDAClick)
8. Associar manualmente (F9) os documentos não casados automaticamente; opcionalmente marcar 'Atualizar Contas' com uma forma de pagamento. (DDA) — source/MFC032/UMFC032.pas:968-1034 (TfrmMFC032.edtNR_DOCUMENTODDAKeyDown)
9. Clicar Confirmar DDA (F6): grava a linha digitável (e forma de pagamento, se marcado) no Contas e move os arquivos processados. (DDA) — source/MFC032/UMFC032.pas:1036-1114 (TfrmMFC032.btnConfirmarDDAClick)

Campos obrigatórios

Campo	Condição	Mensagem	Fonte
Forma de Pagamento (filtro de consulta)	Ao clicar em Consultar na aba Filtros	W-0326	source/MFC032/UMFC032.pas:510-514 (TfrmMFC032.btnConsultarClick)
Conta Saldo (aba Retorno)	Ao clicar em Processar ou Confirmar na aba Retorno	W-1841	source/MFC032/UMFC032.pas:812-816 (TfrmMFC032.btnProcessarClick)
Diretório dos Arquivos de Retorno (aba Retorno)	Ao Processar retorno; deve existir e conter subpasta \Recebidos ao Confirmar	W-1842 / W-1843 / E-1845	source/MFC032/UMFC032.pas:818-828 (TfrmMFC032.btnProcessarClick)
Diretório dos Arquivos DDA (aba DDA)	Ao Processar arquivo DDA	W-1842 / W-1843	source/MFC032/UMFC032.pas:915-925 (TfrmMFC032.btnProcessarDDAClick)
Forma de Pagamento para Atualizar Contas (aba DDA)	Somente quando o checkbox 'Atualizar Contas' está marcado	W-1848	source/MFC032/UMFC032.pas:1052-1057 (TfrmMFC032.btnConfirmarDDAClick)
Empresa (filtro), Forma de Pagamento (filtro/retorno/DDA), Pessoa (grid), Conta Saldo — existência cadastral	Ao sair do campo (validate) ou ao gravar	E-0261 / E-0273 / E-1822 / E-1823 / E-1832	source/MFC032/UdmMFC032.pas:246-317 (TdmMFC032.tabFILTROCD_EMPRESAValidate)

Mensagens: causa e ação

E-0261

Causa: A Empresa informada no filtro não existe no cadastro de empresas.

Ação: Corrigir o código da empresa ou cadastrá-la em Cadastros > Empresa.

Fonte: source/MFC032/UdmMFC032.pas:251-262 (TdmMFC032.tabFILTROCD_EMPRESAValidate)

E-0273

Causa: O código de Forma de Pagamento digitado não existe no cadastro.

Ação: Selecionar uma forma de pagamento válida (F9 para pesquisar) ou cadastrá-la em TFC001.

Fonte: source/MFC032/UdmMFC032.pas:276-289 (TdmMFC032.tabFILTROCD_FORMAPAGTOValidate)

E-1822

Causa: A forma de pagamento existe, mas não está associada a nenhum registro em Parâmetros de Remessa de Pagamento (FNC008).

Ação: Cadastrar/ajustar o parâmetro de remessa (FNC008) vinculando banco/conta a essa forma de pagamento e empresa.

Fonte: source/MFC032/UdmMFC032.pas:276-289 (TdmMFC032.tabFILTROCD_FORMAPAGTOValidate)

E-1823

Causa: O código de Pessoa informado no filtro não existe no cadastro de pessoas.

Ação: Selecionar uma pessoa válida (F9) ou cadastrá-la em Pessoa (TFA001).

Fonte: source/MFC032/UdmMFC032.pas:302-313 (TdmMFC032.tabPESSOACD_PESSOAValidate)

E-1824

Causa: O valor de pagamento calculado (Saldo - Desconto + Acréscimo) ficou negativo.

Ação: Revisar os valores de desconto e acréscimo informados para o título.

Fonte: source/MFC032/UdmMFC032.pas:345-350 (TdmMFC032.tabCONTASVL_PAGOValidate)

E-1825

Causa: O parâmetro de remessa da forma de pagamento não tem uma Sequência de Remessa (NM_SEQREMESSA) configurada.

Ação: Cadastrar a sequência de numeração de remessa no parâmetro (FNC008/FNC003).

Fonte: source/MFC032/UdmMFC032.pas:415-420 (Lista_Contas)

E-1826

Causa: O parâmetro de remessa não tem uma Sequência de Boleto/Débito Automático configurada.

Ação: Cadastrar a sequência de numeração de boleto no parâmetro de remessa (FNC003).

Fonte: source/MFC032/UdmMFC032.pas:543-546 (Formata_Titulo)

E-1828

Causa: A forma de pagamento é exclusiva de Pix, mas o fornecedor não tem conta/chave Pix cadastrada corretamente.

Ação: Cadastrar a conta corrente Pix do fornecedor (banco, tipo e chave) em Pessoa/Conta Corrente.

Fonte: source/MFC032/UdmMFC032.pas:654-668 (Formata_Titulo)

E-1830

Causa: O arquivo de retorno não trouxe o código do banco cedente reconhecido pelo leitor.

Ação: Verificar se o arquivo é realmente um retorno bancário válido e não está corrompido/truncado.

Fonte: source/MFC032/UdmMFC032.pas:839-843 (Atualiza_Retorno)

E-1832

Causa: A Conta Saldo informada não está cadastrada como conta de saldo do tipo Banco (PARMSALDO, TP_SALDO='B').

Ação: Cadastrar a conta como conta de saldo tipo Banco em Parâmetros de Saldo (FNC002).

Fonte: source/MFC032/UdmMFC032.pas:1154-1163 (TdmMFC032.tabFILTROCD_CONTASALDOValidate)

E-1836

Causa: O título selecionado não tem código de barras/linha digitável cadastrado, exigido para forma de pagamento não exclusiva de Pix.

Ação: Informar a linha digitável do boleto no Contas a Pagar (MFC009) antes de marcar o título para remessa.

Fonte: source/MFC032/UdmMFC032.pas:1391-1396 (TdmMFC032.tabCONTASSTATUSValidate)

E-1845

Causa: O diretório informado para os arquivos de retorno não tem a subpasta \Recebidos, usada para mover os arquivos já confirmados.

Ação: Criar manualmente a subpasta \Recebidos dentro do diretório de retorno configurado.

Fonte: source/MFC032/UMFC032.pas:877-879 (TfrmMFC032.btnConfirmarClick)

E-1849

Causa: Uma ou mais linhas digitáveis do arquivo DDA já estão gravadas em outro título do Contas a Pagar.

Ação: Revisar os documentos listados na mensagem (arquivo x sistema) antes de confirmar, evitando duplicidade.

Fonte: source/MFC032/UMFC032.pas:1067-1099 (TfrmMFC032.btnConfirmarDDAClick)

W-0069

Causa: Nenhuma conta a pagar em aberto atende aos filtros informados (empresa, forma de pagamento, período, status de remessa).

Ação: Ajustar os filtros (datas, forma de pagamento, empresa) e consultar novamente.

Fonte: source/MFC032/UMFC032.pas:554-557 (TfrmMFC032.btnConsultarClick)

W-0326

Causa: O campo Forma de Pagamento do filtro está vazio ao clicar em Consultar.

Ação: Selecionar a forma de pagamento (F9) antes de consultar.

Fonte: source/MFC032/UMFC032.pas:510-514 (TfrmMFC032.btnConsultarClick)

W-0443

Causa: O arquivo de retorno carregado não contém nenhum título legível pelo leitor de retorno.

Ação: Confirmar com o banco se o arquivo é o retorno correto e não está vazio/corrompido.

Fonte: source/MFC032/UdmMFC032.pas:833-836 (Atualiza_Retorno)

W-1266

Causa: A conta contábil informada como Conta Saldo não está cadastrada no plano de contas da empresa.

Ação: Cadastrar a conta no plano de contas ou informar outra conta existente.

Fonte: source/MFC032/UdmMFC032.pas:1145-1151 (TdmMFC032.tabFILTROCD_CONTASALDOValidate)

W-1827

Causa: O número de sequência de débito automático/boleto gerado já está em uso em outra parcela do sistema.

Ação: Conferir o documento/lançamento indicado na mensagem; normalmente indica reprocessamento indevido da mesma remessa.

Fonte: source/MFC032/UdmMFC032.pas:558-571 (Formata_Titulo)

W-1829

Causa: O nome do arquivo de retorno/DDA não foi informado ao chamar a rotina de leitura.

Ação: Selecionar corretamente o diretório com arquivos válidos antes de processar.

Fonte: source/MFC032/UdmMFC032.pas:820-821 (Atualiza_Retorno)

W-1833

Causa: A conta contábil informada como Conta Saldo está cadastrada, porém inativa (ST_ATIVO='N').

Ação: Reativar a conta em Parâmetros de Saldo (FNC002) ou escolher outra conta ativa.

Fonte: source/MFC032/UdmMFC032.pas:1162-1165 (TdmMFC032.tabFILTROCD_CONTASALDOValidate)

W-1834

Causa: A conta de saldo informada não está associada à forma de pagamento nos Parâmetros de Remessa de Pagamento (FNC008).

Ação: Cadastrar essa conta como conta de saldo do parâmetro de remessa para a forma de pagamento.

Fonte: source/MFC032/UdmMFC032.pas:1167-1176 (TdmMFC032.tabFILTROCD_CONTASALDOValidate)

W-1837

Causa: O CNPJ do cedente lido no arquivo DDA não corresponde a nenhuma empresa cadastrada no sistema.

Ação: Confirmar se a empresa está cadastrada com o CNPJ correto ou se o arquivo pertence a outra base.

Fonte: source/MFC032/UdmMFC032.pas:1435-1443 (Atualiza_RetornoDDA)

W-1838

Causa: A Data de Emissão Inicial informada é maior que a Data de Emissão Final.

Ação: Corrigir o intervalo de datas de emissão do filtro.

Fonte: source/MFC032/UMFC032.pas:516-521 (TfrmMFC032.btnConsultarClick)

W-1839

Causa: A Data de Vencimento Inicial informada é maior que a Data de Vencimento Final.

Ação: Corrigir o intervalo de datas de vencimento do filtro.

Fonte: source/MFC032/UMFC032.pas:523-528 (TfrmMFC032.btnConsultarClick)

W-1840

Causa: Nenhum título foi marcado (coluna Status) na grade Contas a Pagar antes de gerar os arquivos.

Ação: Marcar ao menos um título (clique ou espaço na coluna Status) antes de clicar em Gerar Arquivos.

Fonte: source/MFC032/UMFC032.pas:752-783 (TfrmMFC032.btnGeraArquivosClick)

W-1841

Causa: O campo Conta Saldo (aba Retorno) está vazio ao processar ou confirmar o retorno.

Ação: Informar a Conta Saldo antes de processar/confirmar.

Fonte: source/MFC032/UMFC032.pas:812-816 (TfrmMFC032.btnProcessarClick)

W-1842

Causa: O campo Diretório (retorno ou DDA) está vazio.

Ação: Selecionar o diretório onde estão os arquivos de retorno/DDA (botão de pasta).

Fonte: source/MFC032/UMFC032.pas:815-822 (TfrmMFC032.btnProcessarClick)

W-1843

Causa: O diretório informado (retorno ou DDA) não existe no sistema de arquivos.

Ação: Corrigir o caminho do diretório ou criá-lo antes de processar.

Fonte: source/MFC032/UMFC032.pas:824-828 (TfrmMFC032.btnProcessarClick)

W-1844

Causa: Nenhum título de retorno foi carregado (grid Retorno vazio) ao tentar Confirmar.

Ação: Processar (F3) um diretório com arquivos de retorno antes de confirmar.

Fonte: source/MFC032/UMFC032.pas:872-875 (TfrmMFC032.btnConfirmarClick)

W-1846

Causa: O título do Contas a Pagar selecionado para vincular manualmente já está associado a outra linha do arquivo DDA carregado.

Ação: Escolher outro documento do Contas a Pagar ou revisar as linhas já vinculadas no arquivo.

Fonte: source/MFC032/UMFC032.pas:990-1006 (TfrmMFC032.edtNR_DOCUMENTODDAKeyDown)

W-1847

Causa: A grade de retorno DDA está vazia ao tentar Confirmar DDA.

Ação: Processar (F3) o diretório de arquivos DDA antes de confirmar.

Fonte: source/MFC032/UMFC032.pas:1049-1050 (TfrmMFC032.btnConfirmarDDAClick)

W-1848

Causa: O checkbox 'Atualizar Contas' está marcado, mas a Forma de Pagamento para atualização não foi informada.

Ação: Informar a forma de pagamento no campo correspondente antes de confirmar, ou desmarcar o checkbox.

Fonte: source/MFC032/UMFC032.pas:1052-1057 (TfrmMFC032.btnConfirmarDDAClick)

W-1850

Causa: A forma de pagamento é exclusiva de Pix, mas o beneficiário não tem chave Pix cadastrada.

Ação: Cadastrar a chave Pix do fornecedor na conta corrente da pessoa.

Fonte: source/MFC032/UdmMFC032.pas:1397-1401 (TdmMFC032.tabCONTASSTATUSValidate)

Regras de negócio

• MFC032.R001 (ver regras/MFC032/MFC032.R001.md)
• MFC032.R002 (ver regras/MFC032/MFC032.R002.md)
• MFC032.R003 (ver regras/MFC032/MFC032.R003.md)
• MFC032.R004 (ver regras/MFC032/MFC032.R004.md)
• MFC032.R005 (ver regras/MFC032/MFC032.R005.md)
• MFC032.R006 (ver regras/MFC032/MFC032.R006.md)
• MFC032.R007 (ver regras/MFC032/MFC032.R007.md)
• MFC032.R008 (ver regras/MFC032/MFC032.R008.md)
• MFC032.R009 (ver regras/MFC032/MFC032.R009.md)
• MFC032.R010 (ver regras/MFC032/MFC032.R010.md)
• MFC032.R011 (ver regras/MFC032/MFC032.R011.md)
• MFC032.R012 (ver regras/MFC032/MFC032.R012.md)
• MFC032.R013 (ver regras/MFC032/MFC032.R013.md)
• MFC032.R014 (ver regras/MFC032/MFC032.R014.md)
• MFC032.R015 (ver regras/MFC032/MFC032.R015.md)
• MFC032.R016 (ver regras/MFC032/MFC032.R016.md)
• MFC032.R017 (ver regras/MFC032/MFC032.R017.md)
• MFC032.R018 (ver regras/MFC032/MFC032.R018.md)
• MFC032.R019 (ver regras/MFC032/MFC032.R019.md)

Perguntas frequentes

P: Por que não consigo consultar títulos, aparece 'É Obrigatório informar a Forma de Pagamento'? R: O filtro de consulta exige a Forma de Pagamento antes de buscar os títulos; preencha o campo Forma Pagto (F9 para pesquisar) e consulte novamente. Fonte: source/MFC032/UMFC032.pas:510-514 (TfrmMFC032.btnConsultarClick)

P: A consulta não trouxe nenhum título a pagar, o que fazer? R: Não há contas em aberto (ST_CONTAS P/T, tipo Empresa) que atendam ao filtro informado; revise empresa, forma de pagamento, período e status de remessa (o padrão é 'não enviado'). Fonte: source/MFC032/UMFC032.pas:534-557 (TfrmMFC032.btnConsultarClick)

P: Deu a mensagem 'A Forma de Pagamento não está Associada a nenhum Parâmetro de Remessa de Pagamento (FNC008)'. Como resolver? R: A forma de pagamento existe, mas não tem cadastro em Parâmetros de Remessa de Pagamento (FNC008) vinculando-a a banco/conta; cadastre o parâmetro para essa forma de pagamento e empresa. Fonte: source/MFC032/UdmMFC032.pas:276-289 (TdmMFC032.tabFILTROCD_FORMAPAGTOValidate)

P: Por que um título mostra erro de 'não possui código de barras' ao marcar para remessa? R: Quando a forma de pagamento não é exclusiva de PIX, o sistema exige a linha digitável/código de barras do boleto no título; cadastre a linha digitável antes de marcar o título. Fonte: source/MFC032/UdmMFC032.pas:1389-1403 (TdmMFC032.tabCONTASSTATUSValidate)

P: Por que o sistema pede a chave PIX? R: Quando a forma de pagamento do parâmetro de remessa é exclusiva de Pix, o título exige chave Pix cadastrada na conta corrente do beneficiário. Fonte: source/MFC032/UdmMFC032.pas:1391-1401 (TdmMFC032.tabCONTASSTATUSValidate), source/MFC032/UdmMFC032.pas:654-668 (Formata_Titulo)

P: Deu 'O Número de Remessa de Pagto já foi Gerado por outra Duplicata'. O que significa? R: O número de débito automático/boleto sequencial gerado já está em uso em outra parcela/lançamento no sistema; a mensagem mostra qual documento já usa esse número para conferência. Fonte: source/MFC032/UdmMFC032.pas:558-571 (Formata_Titulo)

P: Por que ao Confirmar o retorno aparece 'O Diretório dos Arquivos Processados não existe'? R: O Confirmar exige a subpasta '\Recebidos' dentro do diretório de retorno informado, usada para mover os arquivos já processados; crie essa subpasta manualmente. Fonte: source/MFC032/UMFC032.pas:877-879 (TfrmMFC032.btnConfirmarClick)

P: Deu 'Não foi selecionado nenhum registro para Gerar Remessa'. Por quê? R: Nenhum título da grade Contas a Pagar foi marcado (coluna Status) antes de clicar em Gerar Arquivos; marque ao menos um título (clique ou espaço na coluna Status) e tente novamente. Fonte: source/MFC032/UMFC032.pas:752-783 (TfrmMFC032.btnGeraArquivosClick)

P: No processamento de DDA, deu 'Empresa com CNPJ ... Não encontrada na base de dados'. O que fazer? R: O CNPJ do beneficiário/cedente do arquivo DDA não corresponde a nenhuma empresa cadastrada no sistema; verifique se a empresa está corretamente cadastrada com esse CNPJ. Fonte: source/MFC032/UdmMFC032.pas:1435-1443 (Atualiza_RetornoDDA)

P: Deu 'O Contas selecionado já está associado ao documento' ao vincular manualmente um título DDA. O que significa? R: O título do Contas a Pagar que você tentou associar (via F9) já foi vinculado a outra linha do arquivo DDA carregado; escolha outro documento do Contas ou revise as linhas já marcadas. Fonte: source/MFC032/UMFC032.pas:990-1006 (TfrmMFC032.edtNR_DOCUMENTODDAKeyDown)

P: Ao confirmar o DDA aparece uma lista de documentos já associados ('Arquivo - Sistema'). O que fazer? R: Alguma linha digitável do arquivo DDA já está gravada em outro título do Contas a Pagar; a mensagem lista os pares arquivo/sistema em conflito para você conferir antes de confirmar. Fonte: source/MFC032/UMFC032.pas:1067-1099 (TfrmMFC032.btnConfirmarDDAClick)

Dúvidas em aberto (o código não responde)

• Quais são as regras internas de montagem do CNAB 240/400 (posições, segmentos)? — A geração do arquivo é delegada a dmMFC032.Remessa.GerarRemessapagto (classe TJunCobranca), cujo código não foi lido nesta sessão (fica em outra unit, jCobranca).
• O que exatamente validam ValidaPessoa, ValidaFormaPagto e ValidaTipoConta (mensagens específicas)? — São chamados em UdmMFC032.pas (linhas 1548-1594) mas a implementação está em source/jCommon/jValidate.pas, não lida nesta sessão.
• Quais os significados dos demais códigos de 'Motivo Rejeição Comando' do retorno bancário além de '00'? — Em Atualiza_Retorno (UdmMFC032.pas linhas 1031-1040) só o código '00' é tratado explicitamente como pago; não há tratamento visível para outros códigos, o que pode ser proposital (status fica em branco) ou lacuna.
• O padrão de nome de arquivo de remessa é obrigatório/fiscalizado pelo banco ou é convenção interna? — Lista_Contas (UdmMFC032.pas linhas 461-503) monta nomes distintos por código de banco; não há fonte que explique a exigência de cada banco.