ST_ALTERANOTA — Permissão de Alteração de Nota Fiscal (CNF011)

Tela de configuração: ADM012 — Parâmetros do Usuário Componente: checkbox chkST_ALTERANOTA Label na tela: "Alterar Nota Fiscal (CNF011)" Tabela: PARMUSUARIO.ST_ALTERANOTA Valor padrão: N (desmarcado — usuário não pode alterar)

Atenção — campo homônimo: existe um parâmetro ST_ALTERANOTA na tabela PARMFATUR (configurado em MFA001), com comportamento completamente diferente: ele bloqueia a edição dos itens da NF quando a nota foi gerada a partir de pedido. Este documento trata exclusivamente do campo em PARMUSUARIO, que é uma permissão por usuário para a tela CNF011.

Telas impactadas

Tela	Rotina	Efeito
CNF011 (Consulta NFS-e)	TfrmCNF011.AtualizarDadosdaNotaFiscal1Click	Se N, bloqueia o menu "Atualizar Dados da Nota Fiscal"; se S, permite abrir o formulário de atualização

Campos envolvidos

Campo	Tabela	Descrição
ST_ALTERANOTA	PARMUSUARIO	Permissão por usuário para alterar dados de NF na tela CNF011

Opções disponíveis

S — Marcado (Permite Alteração)

O que faz	Detalhe
Libera o menu "Atualizar Dados da Nota Fiscal" na CNF011	Usuário pode abrir o formulário de atualização para NFs válidas ou canceladas

Simulação passo a passo

1. Acesse ADM012 → selecione o usuário desejado.
2. Marque o checkbox "Alterar Nota Fiscal (CNF011)".
3. Salve (<F9>).
4. Abra a tela CNF011 (Consulta NFS-e).
5. Procure uma NF com status "Válida" ou "Cancelada".
6. Clique no menu "Atualizar Dados da Nota Fiscal".
7. O formulário de atualização será aberto normalmente — edite os dados desejados e confirme.

Resultado esperado: O usuário consegue abrir e utilizar a funcionalidade "Atualizar Dados da Nota Fiscal" na CNF011.

---

N — Desmarcado (Bloqueado) (padrão)

O que faz	Detalhe
Bloqueia o menu "Atualizar Dados da Nota Fiscal" na CNF011	Ao clicar, exibe mensagem de erro e impede a ação

Simulação passo a passo

1. Acesse ADM012 → selecione o usuário desejado.
2. Deixe desmarcado o checkbox "Alterar Nota Fiscal (CNF011)" (padrão).
3. Salve (<F9>).
4. Abra a tela CNF011 (Consulta NFS-e).
5. Procure uma NF qualquer.
6. Clique no menu "Atualizar Dados da Nota Fiscal".

Resultado esperado: O sistema exibe a mensagem "O Usuário Não Tem Acesso a Alteração de Nota. Verifique! [ADM012]" e não abre o formulário de atualização.

Exceção / Importante: Mesmo com ST_ALTERANOTA = 'S', a alteração só é permitida para NFs com status "Válida" (V) ou "Cancelada" (C). NFs em outros status receberão a mensagem "Somente é Possível Alteração de Nota 'Válida' e 'Cancelada'. Verifique!".

Regra Geral

Condição	Resultado
PARMUSUARIO.ST_ALTERANOTA = 'S' e NF válida/cancelada	Permite abrir "Atualizar Dados da Nota Fiscal"
PARMUSUARIO.ST_ALTERANOTA = 'S' e NF em outro status	Bloqueia com mensagem de status inválido
PARMUSUARIO.ST_ALTERANOTA = 'N' (qualquer status)	Bloqueia com mensagem de permissão

Tabela Comparativa Resumida

Valor	Label	Comportamento na CNF011
S	Marcado	Permite "Atualizar Dados da Nota Fiscal" (para NF válida/cancelada)
N	Desmarcado	Bloqueia "Atualizar Dados da Nota Fiscal" (mensagem de erro)

Interação com outros parâmetros

• PARMFATUR.ST_ALTERANOTA (configurado em MFA001 — Parâmetros de Faturamento): parâmetro homônimo mas com escopo diferente. Controla o bloqueio de edição dos itens da NF (grade ReadOnly) quando a nota foi gerada a partir de pedido, nas telas MNF002, MNF008, MPD011 e MRC020. Não tem relação funcional direta com o PARMUSUARIO.ST_ALTERANOTA.

• ADM013 (Duplicar Usuário): ao duplicar um usuário em ADM013, o campo ST_ALTERANOTA de PARMUSUARIO é copiado para o novo usuário, preservando a permissão.

Procedures impactadas

Rotinas Delphi com referência direta ao campo PARMUSUARIO.ST_ALTERANOTA

Rotina	Arquivo	Linha	Efeito
TdmADM012.tabPARMUSUARIOAfterInsert	UdmADM012.pas	256	Define padrão 'N' ao criar novo registro
TfrmADM013.btnDuplicaUsuarioClick	UADM013.pas	476	Copia campo ao duplicar usuário
iniciar	UCNF011.pas	415–419	Lê ST_ALTERANOTA de PARMUSUARIO ao abrir CNF011
TfrmCNF011.AtualizarDadosdaNotaFiscal1Click	UCNF011.pas	7437–7438	Bloqueia/permite "Atualizar Dados da Nota Fiscal"

Referências SQL diretas ao campo

Nenhuma stored procedure ou view em Scripts/ referencia diretamente o campo PARMUSUARIO.ST_ALTERANOTA.

Candidatas por uso da tabela

As procedures abaixo utilizam a tabela PARMUSUARIO, mas não citam o campo ST_ALTERANOTA literalmente. Portanto, não possuem impacto funcional direto neste parâmetro:

• CANCELA_NOTAFISCAL
• CONTROLE_CAIXA
• GERA_ETIQUETABALANCA
• PERMISSAO_CAIXA
• RETORNA_IMPRESSORAUSUARIO
• TRGPARMFATUR_BU
• VALIDA_BLOQDESCMAXSUBGRUPO
• VALIDA_CODIGOBARRA
• VALIDA_LIBERACAOUSUARIO
• VALIDA_MODELOBLOQUEIODIASATRASO
• VALIDA_MODELOBLOQUEIOPCDESCMAX
• VALIDA_MODELOBLOQUEIOVLLIMITE
• VERIFICA_BLOQUEIO
• VIEW_DOCUMENTOSBLOQUEADOS