ST_BLOQUEARAGRUP - Parâmetro de Bloqueio de Agrupamento de Contas

Tela de configuração: FNC001 — Parâmetros Financeiros
Aba: Financeiro 2
Grupo: Dados do Parâmetro
Tabela: PARMFINANC.ST_BLOQUEARAGRUP
Componente: cmbST_BLOQUEARAGRUP (TwwDBComboBox)
Tipo de dados: CHAR(1) — DEFAULT 'N' NOT NULL
Valor padrão: N (Não)

---

Tela de origem

Item	Detalhe
Código	FNC001
Nome	Parâmetros Financeiros
Aba	Financeiro 2
Label exibido na tela	Bloquear agrup. Contas com dt. posterior a dt. doc.
Componente	cmbST_BLOQUEARAGRUP: TwwDBComboBox
Campo	ST_BLOQUEARAGRUP

Opções disponíveis

O que faz	Detalhe
N — Não	Comportamento padrão. Permite que contas com data de vencimento posterior à data do documento sejam agrupadas em um único boleto/título, desde que ST_AGRUPACONTA = 'S'. Campo editável.
S — Sim	Bloqueia o agrupamento quando a data de vencimento da conta for posterior à data do documento. O sistema impede que contas nessas condições sejam consolidadas em um boleto único. Campo editável.

N — Não (padrão)

Simulação passo a passo

1. Acesse FNC001 — Parâmetros Financeiros.
2. Abra a aba Financeiro 2.
3. No grupo Dados do Parâmetro, localize o campo "Bloquear agrup. Contas com dt. posterior a dt. doc.".
4. Selecione a opção N — Não no combobox.
5. Salve o registro.
6. Acesse a tela de emissão de boletos/contas a receber (ex.: MFC012).
7. Selecione múltiplos títulos para gerar um boleto agrupado, onde pelo menos um título tem vencimento posterior à data do documento.
8. Confirme a geração do agrupamento.

Resultado esperado: O sistema permite agrupar todos os títulos selecionados em um único boleto, independentemente da diferença entre data de vencimento e data do documento.

Importante: Esta opção só tem efeito quando ST_AGRUPACONTA está configurado como 'S' (Sim). Caso ST_AGRUPACONTA = 'N', o agrupamento de contas já está desabilitado de forma geral, tornando este parâmetro inoperante. ST_AGRUPACONTA (configurado em FNC001 — Parâmetros Financeiros, aba Financeiro 2).

S — Sim

Simulação passo a passo

1. Acesse FNC001 — Parâmetros Financeiros.
2. Abra a aba Financeiro 2.
3. No grupo Dados do Parâmetro, localize o campo "Bloquear agrup. Contas com dt. posterior a dt. doc.".
4. Selecione a opção S — Sim no combobox.
5. Salve o registro.
6. Acesse a tela de emissão de boletos/contas a receber (ex.: MFC012).
7. Selecione múltiplos títulos para gerar um boleto agrupado, onde pelo menos um título tem vencimento posterior à data do documento.
8. Tente confirmar a geração do agrupamento.

Resultado esperado: O sistema impede o agrupamento dos títulos cuja data de vencimento seja posterior à data do documento. O usuário deve selecionar apenas títulos que atendam à regra de data para prosseguir com o agrupamento.

Importante: O bloqueio só é aplicado se ST_AGRUPACONTA = 'S'. Se o agrupamento geral estiver desabilitado ('N'), este parâmetro não entra em ação. Para liberar exceções, verifique se a rotina da tela de origem (ex.: MFC012) implementa override — sem evidencia de permissão de autorizador especifica para este campo.

Telas impactadas

Tela	Descrição	Impacto
FNC001	Parâmetros Financeiros	Tela de configuração do parâmetro (edição/salvamento).
MFC012	Movimentação de Caixa (abertura/inicialização)	O parâmetro é lido durante a rotina iniciar da tela — SELECT ... ST_BLOQUEARAGRUP ... FROM PARMFINANC.
Telas de geração de boletos/contas	Rotinas que utilizam agrupamento	Efeito funcional no agrupamento de contas quando ST_AGRUPACONTA = 'S'.

Campos envolvidos

Campo	Tabela	Tipo	Default	Editável
ST_BLOQUEARAGRUP	PARMFINANC	CHAR(1)	N	Sim

Regras de negócio

1. Dependência de ST_AGRUPACONTA — Este parâmetro só tem efeito prático quando ST_AGRUPACONTA = 'S'. Se ST_AGRUPACONTA = 'N', nenhum agrupamento ocorre, independentemente do valor de ST_BLOQUEARAGRUP.
2. Data de vencimento vs. data do documento — Quando ST_BLOQUEARAGRUP = 'S', o sistema valida que a data de vencimento de cada conta a ser agrupada não seja posterior à data do documento. Contas que violem essa regra são excluídas do agrupamento ou impedem a operação.
3. Valor padrão — Ao criar um novo registro em PARMFINANC, o campo recebe automaticamente 'N'.

Tabela comparativa resumida

Opção	Valor	Agrupa com vencimento > data doc.?	Exige ST_AGRUPACONTA='S'?
Não	N	Sim (permite)	Sim
Sim	S	Não (bloqueia)	Sim

---

Documento gerado com base em evidências do inventário FNC001 / PARMFINANC.