MFC012 — Agrupamento de Contas (enriquecimento)

Menu: Financeiro > Movimentações > Agrupamento de Contas

Objetivo

A tela Agrupamento de Contas permite ao usuário do financeiro selecionar múltiplas contas a pagar ou a receber em aberto de uma mesma pessoa (ou de pessoas diferentes, se o parâmetro permitir) e consolidá-las em um único documento novo, do tipo AG. As contas originais são marcadas como 'Agrupado' e vinculadas ao novo documento via CONTASJUNCAO, simplificando a conciliação e o controle de pagamentos/recebimentos.

Fluxo principal

1. Abrir o módulo Agrupamento de Contas; a aba Filtros é exibida e a aba Documentos fica oculta até haver uma busca. (pagFiltros) — source/MFC012/UMFC012.pas:316-350 (TfrmMFC012.btnNovoClick)
2. Informar Tipo de Conta e Forma de Pagamento (obrigatórios) e, opcionalmente, Pessoa(s), datas de emissão/vencimento, Banco/Agência e Tipo de Pessoa para restringir a busca. (pagFiltros) — source/MFC012/UMFC012.pas:428-433 (TfrmMFC012.btnProcurarClick)
3. Clicar em Procurar/Filtrar (F3) para listar as contas em aberto que atendem aos filtros. (pagFiltros → pagDoctos) — source/MFC012/UMFC012.pas:575-593 (TfrmMFC012.btnProcurarClick)
4. Marcar as contas desejadas na coluna Status (clique ou barra de espaço) ou usar o botão de marcar/desmarcar todas. (pagDoctos) — source/MFC012/UMFC012.pas:702-733 (TfrmMFC012.gridCONTASCellClick)
5. Preencher Data de Lançamento e Data de Vencimento do novo documento agrupado (e Pessoa Nova Conta, se o parâmetro permitir agrupar pessoas diferentes). (pagDoctos) — source/MFC012/UdmMFC012.pas:433-447 (TdmMFC012.tabFILTRODT_VENCIMENTOValidate)
6. Sistema exibe 'Junção de Contas Efetuada com Sucesso' e retorna à busca (se filtro persistente marcado) ou a uma nova tela em branco. (pagDoctos) — source/MFC012/UMFC012.pas:1253-1264 (TfrmMFC012.btnSalvarClick)

Campos obrigatórios

Campo	Condição	Mensagem	Fonte
Tipo de Conta	Para buscar contas (aba Filtros) e novamente para salvar o agrupamento	E-1889 / E-1892	source/MFC012/UMFC012.pas:428-429 (TfrmMFC012.btnProcurarClick)
Forma de Pagamento	Para buscar contas e para salvar o agrupamento	E-1890 / E-1903	source/MFC012/UMFC012.pas:432-433 (TfrmMFC012.btnProcurarClick)
Data de Lançamento	Ao salvar o agrupamento	E-1893	source/MFC012/UMFC012.pas:1020-1021 (TfrmMFC012.btnSalvarClick)
Data de Vencimento	Calculada na gravação da conta nova; se não houver condição de pagamento associada à Pessoa e o campo estiver vazio, a gravação falha	E-1891	source/MFC012/UMFC012.pas:872-889 (GravaContasOrigem)
Ao menos uma conta marcada (coluna Status)	Para o botão Salvar gerar algum agrupamento	W-1880	source/MFC012/UMFC012.pas:1249-1267 (TfrmMFC012.btnSalvarClick)

Mensagens: causa e ação

E-1889

Causa: Usuário clicou em Procurar sem selecionar um Tipo de Conta no filtro.

Ação: Selecione um Tipo de Conta (F9 para pesquisar) antes de buscar.

Fonte: source/MFC012/UMFC012.pas:428-429 (TfrmMFC012.btnProcurarClick)

E-1890

Causa: Usuário clicou em Procurar sem informar a Forma de Pagamento.

Ação: Informe a Forma de Pagamento antes de buscar.

Fonte: source/MFC012/UMFC012.pas:432-433 (TfrmMFC012.btnProcurarClick)

E-1892

Causa: Usuário tentou salvar sem Tipo de Conta preenchido no filtro.

Ação: Volte à aba Filtros e informe o Tipo de Conta.

Fonte: source/MFC012/UMFC012.pas:1017-1018 (TfrmMFC012.btnSalvarClick)

E-1893

Causa: Usuário tentou salvar sem informar a Data de Lançamento do novo documento.

Ação: Preencha a Data de Lançamento antes de salvar.

Fonte: source/MFC012/UMFC012.pas:1020-1021 (TfrmMFC012.btnSalvarClick)

E-1903

Causa: Usuário tentou salvar sem Forma de Pagamento preenchida.

Ação: Informe a Forma de Pagamento antes de salvar.

Fonte: source/MFC012/UMFC012.pas:1143-1144 (TfrmMFC012.btnSalvarClick)

E-1891

Causa: O sistema não conseguiu calcular a Data de Vencimento (nem por condição de pagamento da pessoa, nem pelo campo informado).

Ação: Informe manualmente a Data de Vencimento ou cadastre a Condição de Pagamento do cliente/fornecedor.

Fonte: source/MFC012/UMFC012.pas:872-889 (GravaContasOrigem)

E-1882

Causa: A conta marcada pertence a um boleto já impresso.

Ação: Cancele o boleto no módulo de boletos antes de agrupar essa conta.

Fonte: source/MFC012/UdmMFC012.pas:178-179 (TdmMFC012.tabCONTASSTATUSValidate)

E-1883

Causa: A conta marcada pertence a um boleto com remessa já gerada.

Ação: Cancele/reverta a remessa do boleto antes de agrupar essa conta.

Fonte: source/MFC012/UdmMFC012.pas:180-181 (TdmMFC012.tabCONTASSTATUSValidate)

E-1884

Causa: O parâmetro financeiro 'Bloqueia Agrupamento' (FNC001) está ativo e a conta marcada tem data de emissão anterior à Data de Lançamento do agrupamento.

Ação: Ajuste a Data de Lançamento do agrupamento ou desmarque a conta com emissão mais antiga; se necessário, revise o parâmetro em FNC001.

Fonte: source/MFC012/UdmMFC012.pas:183-188 (TdmMFC012.tabCONTASSTATUSValidate)

E-1886

Causa: O Tipo de Conta selecionado no filtro não é do tipo Contas a Pagar (CP) nem Contas a Receber (CR).

Ação: Selecione um Tipo de Conta cadastrado como CP ou CR em TFC005.

Fonte: source/MFC012/UdmMFC012.pas:229-234 (TdmMFC012.tabFILTROCD_TIPOCONTAValidate)

E-1895

Causa: As contas marcadas estão vinculadas a Romaneios diferentes.

Ação: Agrupe separadamente as contas de cada Romaneio.

Fonte: source/MFC012/UMFC012.pas:1047-1050 (TfrmMFC012.btnSalvarClick)

E-1896

Causa: O parâmetro 'Bloqueia Alteração Financeira' está ativo e a conta marcada está com status Incobrável.

Ação: Reverta a situação de incobrável da conta (módulo financeiro correspondente) antes de agrupar.

Fonte: source/MFC012/UMFC012.pas:1061-1076 (TfrmMFC012.btnSalvarClick)

E-1897

Causa: A conta marcada já foi totalmente liquidada (status L) desde a busca.

Ação: Atualize a consulta (Procurar) e desmarque contas já liquidadas.

Fonte: source/MFC012/UMFC012.pas:1089-1090 (TfrmMFC012.btnSalvarClick)

E-1899

Causa: A conta marcada está com situação Cancelada.

Ação: Desmarque a conta cancelada; ela não pode ser agrupada.

Fonte: source/MFC012/UMFC012.pas:1095-1096 (TfrmMFC012.btnSalvarClick)

E-1901

Causa: O status da conta no banco mudou desde a última busca (outro usuário/processo alterou a conta).

Ação: Clique em Procurar novamente para atualizar a lista antes de salvar.

Fonte: source/MFC012/UMFC012.pas:1101-1102 (TfrmMFC012.btnSalvarClick)

W-1878

Causa: O Tipo de Conta escolhido não está liberado para o usuário (VIEW_TIPOCONTASUSUARIO) ou está inativo.

Ação: Solicite liberação do Tipo de Conta para o usuário ou escolha outro Tipo de Conta liberado.

Fonte: source/MFC012/UdmMFC012.pas:389-411 (TdmMFC012.validaTipoContaUsuario)

W-1879

Causa: Nenhuma das contas marcadas passou pela gravação (contador de agrupamentos permaneceu zero).

Ação: Verifique se as contas marcadas atendem às regras de status e tente novamente.

Fonte: source/MFC012/UMFC012.pas:1253-1264 (TfrmMFC012.btnSalvarClick)

W-1880

Causa: Nenhuma conta foi marcada na coluna Status antes de clicar em Salvar.

Ação: Marque ao menos uma conta na lista antes de salvar.

Fonte: source/MFC012/UMFC012.pas:1249-1267 (TfrmMFC012.btnSalvarClick)

W-1887

Causa: A Data de Vencimento informada é anterior à Data de Lançamento.

Ação: Informe uma Data de Vencimento igual ou posterior à Data de Lançamento.

Fonte: source/MFC012/UdmMFC012.pas:433-439 (TdmMFC012.tabFILTRODT_VENCIMENTOValidate)

W-1888

Causa: A Data de Lançamento informada é posterior à Data de Vencimento já preenchida.

Ação: Ajuste a Data de Lançamento para ser igual ou anterior à Data de Vencimento.

Fonte: source/MFC012/UdmMFC012.pas:441-447 (TdmMFC012.tabFILTRODT_LANCAMENTOValidate)

W-1894

Causa: As contas marcadas pertencem a uma Obra vinculada a uma Empresa de origem diferente da Empresa de destino do agrupamento.

Ação: Agrupe apenas contas de obras associadas à mesma empresa de destino, ou ajuste a empresa do filtro.

Fonte: source/MFC012/UMFC012.pas:1044-1045 (TfrmMFC012.btnSalvarClick)

W-1898

Causa: A conta marcada já está com status Agrupado (foi usada em outro agrupamento desde a busca).

Ação: Atualize a consulta (Procurar) e desmarque a conta já agrupada.

Fonte: source/MFC012/UMFC012.pas:1092-1093 (TfrmMFC012.btnSalvarClick)

W-1900

Causa: Parte do valor da conta marcada já foi liquidada (status P - Pago Parcial) desde a busca.

Ação: Atualize a consulta antes de agrupar essa conta.

Fonte: source/MFC012/UMFC012.pas:1098-1099 (TfrmMFC012.btnSalvarClick)

W-1902

Causa: A conta está vinculada a uma NFS-e não transmitida e o parâmetro da empresa não permite gerar boleto de NFS-e pendente.

Ação: Transmita a NFS-e correspondente (CNF011/MFA013) antes de gerar o boleto do agrupamento.

Fonte: source/MFC012/UMFC012.pas:1104-1126 (TfrmMFC012.btnSalvarClick)

I-1881

Causa: O agrupamento foi concluído com sucesso e a transação foi confirmada.

Ação: Nenhuma ação necessária; confira o novo documento AG gerado no contas a pagar/receber.

Fonte: source/MFC012/UMFC012.pas:1253-1258 (TfrmMFC012.btnSalvarClick)

Regras de negócio

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

Perguntas frequentes

P: Por que aparece 'O Tipo de Conta deve ser informado' ao clicar em Procurar? R: O campo Tipo de Conta (aba Filtros) é obrigatório para pesquisar as contas. Selecione um Tipo de Conta antes de clicar em Procurar/Filtrar. Fonte: source/MFC012/UMFC012.pas:428-429 (TfrmMFC012.btnProcurarClick)

P: Por que não consigo agrupar um boleto que já foi impresso ou enviado em remessa? R: Boletos com situação 'Impresso' ou 'Gerado Remessa' não podem ser reparcelados/agrupados; é preciso cancelar o boleto antes de marcar a conta para agrupamento. Fonte: source/MFC012/UdmMFC012.pas:177-181 (TdmMFC012.tabCONTASSTATUSValidate)

P: Deu a mensagem 'Conta foi Liquidada' ao tentar salvar o agrupamento. R: A conta selecionada já está totalmente quitada (status L) no momento do salvamento; ela não pode compor um novo agrupamento. Atualize a consulta e desmarque a conta liquidada. Fonte: source/MFC012/UMFC012.pas:1089-1090 (TfrmMFC012.btnSalvarClick)

P: Deu 'Conta Está Agrupada' ao salvar. R: A conta já foi usada em outro agrupamento (status A) desde que a busca foi feita. Clique em Procurar novamente para atualizar a lista. Fonte: source/MFC012/UMFC012.pas:1092-1093 (TfrmMFC012.btnSalvarClick)

P: O que significa 'Status da Conta Divergente. Atualize a Consulta'? R: O status da conta no banco mudou (por outro usuário ou processo) depois que a tela buscou os dados. Refaça a busca (Procurar) antes de salvar novamente. Fonte: source/MFC012/UMFC012.pas:1101-1102 (TfrmMFC012.btnSalvarClick)

P: Por que apareceu 'Nenhuma Junção de Contas foi Efetuada' mesmo clicando em Salvar? R: Nenhuma das contas marcadas passou pelas validações e nenhum agrupamento foi gravado (contador de agrupamentos ficou zerado); confira se realmente marcou contas na coluna Status antes de salvar. Fonte: source/MFC012/UMFC012.pas:1253-1264 (TfrmMFC012.btnSalvarClick)

P: Por que só aparece o campo 'Pessoa Nova Conta' em algumas empresas? R: Esse campo só fica visível se o parâmetro financeiro 'Agrupa Conta' (PARMFINANC.ST_AGRUPACONTA) estiver ativado para a empresa; ele permite reunir contas de pessoas diferentes em uma única conta destino. Fonte: source/MFC012/UMFC012.pas:252-263 (iniciar)

P: Por que o campo Empresa fica bloqueado para edição? R: Se o parâmetro financeiro 'Agrupamento entre Empresas' (PARMFINANC.ST_AGRUPAMENTOEMPRESAS) estiver desativado, o campo Empresa do filtro fica somente leitura, restringindo a busca à empresa logada. Fonte: source/MFC012/UMFC012.pas:267-270 (iniciar)

P: Deu a mensagem sobre NFS-e não transmitida ao marcar uma conta com forma de pagamento Boleto. R: A conta está vinculada a uma NFS-e ainda não transmitida à prefeitura e o parâmetro da empresa não permite gerar boleto de NFS-e pendente; transmita a NFS-e (módulos CNF011/MFA013) antes de agrupar/gerar o boleto. Fonte: source/MFC012/UMFC012.pas:1104-1126 (TfrmMFC012.btnSalvarClick)

P: Por que não consigo marcar contas de romaneios diferentes juntas? R: O sistema impede agrupar, no mesmo lançamento, contas vinculadas a romaneios diferentes; agrupe separadamente por romaneio. Fonte: source/MFC012/UMFC012.pas:1047-1050 (TfrmMFC012.btnSalvarClick)

P: O que o botão com o ícone de marca (checkbox) no topo do grid faz? R: Marca ou desmarca todas as contas da lista de uma vez, alternando conforme o estado atual do botão. Fonte: source/MFC012/UMFC012.pas:736-784 (TfrmMFC012.btnMarcaClick)

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

• A mensagem E-0307 ('A Pessoa não está Cadastrada como Técnico') é disparada quando o campo 'Pessoa Nova Conta' recebe um código inexistente — o texto do catálogo parece pertencer a outro contexto (cadastro de Técnico, TFA020). É reuso proposital de código de mensagem genérico ou defeito de mapeamento? — source/MFC012/UdmMFC012.pas:412-431, TdmMFC012.tabFILTROCD_NOVAPESSOAValidate
• Qual é o efeito exato do parâmetro FNC001 'Bloqueia Agrupamento' além de impedir marcar contas com data de emissão anterior à data de lançamento do agrupamento? O nome sugere bloqueio mais amplo. — source/MFC012/UdmMFC012.pas:183-188, tabCONTASSTATUSValidate; parâmetro ST_BLOQUEARAGRUP de PARMFINANC
• O que a procedure GERA_JUNCAOCONTAS valida internamente além do que já é checado no Delphi antes de chamá-la (script não lido nesta sessão)? — source/MFC012/UMFC012.pas:991-1002, GravaContasOrigem