ST_PERMITEIMPORTARPLANILHA - Importar Seriais via Planilha

Tela de configuração: MFA001 - Parâmetros de Faturamento Localização: Parâmetros → Ambos → Opção 1 Tabela: PARMFATUR.ST_PERMITEIMPORTARPLANILHA Valor padrão: N (Desmarcado)

Telas impactadas

Tela	Descrição
MNF001	Movimentação de Nota Fiscal

Campos envolvidos

Campo	Tabela	Descrição
TP_UNIDADE	ITEMNOTA	Tipo de unidade do item (Q = quantidade, outros = unitário)
PS_ITEMNOTA	ITEMNOTA	Peso/Seriado do item na nota
QT_ITEMNOTA	ITEMNOTA	Quantidade do item na nota

Opções disponíveis

N - Seriais informados manualmente (padrão)

O que faz	Detalhe
Oculta botão "Importar Seriais"	O botão btnImportarSeriais fica invisível na tela MNF001
Exige informar seriais ao salvar	Ao clicar em Salvar, abre a tela de seriais automaticamente para cada item
Comportamento por tipo de unidade	Itens com TP_UNIDADE = 'Q' chamam serial pela quantidade ao salvar; demais chamam pelo peso na validação do campo

Simulação passo a passo

1. Abra a tela MNF001 - Nota Fiscal.
2. Informe os dados do cabeçalho e adicione os itens da nota.
3. Note que o botão Importar Seriais não aparece na barra de ferramentas.
4. Clique em Salvar para gravar a nota.
5. Para cada item com TP_UNIDADE = 'Q', o sistema abrirá automaticamente a tela de informar seriais, solicitando o número correspondente à quantidade.
6. Preencha os seriais solicitados e confirme.
7. Para itens com outro tipo de unidade, o sistema solicitará seriais ao validar o peso/seriado do item.
8. Após todos os seriais preenchidos, a nota será salva normalmente.

Resultado esperado: O botão de importação de planilha permanece oculto e o operador deve informar os seriais manualmente, item a item, durante o processo de salvamento da nota.

Exceção / Importante: Se o item não controla seriais, a tela de seriais não será exibida mesmo com este parâmetro em N.

S - Permite importar seriais via planilha

O que faz	Detalhe
Exibe botão "Importar Seriais"	O botão btnImportarSeriais fica visível na tela MNF001
Seriais importados antes de salvar	O operador pode importar todos os seriais de uma vez via planilha antes de clicar em Salvar
Suprime chamada automática ao salvar	Não abre a tela de seriais automaticamente no botão Salvar

Simulação passo a passo

1. Abra a tela MNF001 - Nota Fiscal.
2. Informe os dados do cabeçalho e adicione os itens da nota.
3. Clique no botão Importar Seriais (agora visível na barra de ferramentas).
4. Selecione a planilha contendo os seriais de todos os itens e confirme a importação.
5. Clique em Salvar para gravar a nota — o sistema não solicitará seriais individualmente pois já foram importados.

Resultado esperado: Todos os seriais são importados de uma vez via planilha antes do salvamento, sem necessidade de informá-los item a item manualmente.

Exceção / Importante: A validação de seriais (validaSerial) ainda é executada ao salvar. Se a planilha estiver incompleta ou divergir das quantidades dos itens, o sistema bloqueará o salvamento.

Regra Geral de Comportamento

O parâmetro controla o momento e a forma de informar seriais na tela MNF001:

• Com N (padrão): seriais são informados manualmente, item a item, durante o salvamento da nota fiscal.
• Com S: seriais podem ser importados em lote via planilha antes do salvamento, agilizando o processo para notas com muitos itens.

O código no validador QT_ITEMNOTAValidate (linha 4942) foi comentado com a anotação: "retirado e deixado no botão salvar para que seja possível inserir os seriais de todos os itens de uma vez", reforçando que a lógica foi centralizada no botão Salvar.

Tabela Comparativa Resumida

Valor	Botão Importar Seriais	Serial ao Salvar	Serial na Validação PS	Serial na Validação QT
N (padrão)	Oculto	Sim (TP_UNIDADE = Q)	Sim (TP_UNIDADE ≠ Q)	Comentado (movido para Salvar)
S	Visível	Não	Não	Comentado (movido para Salvar)

Procedures impactadas

Rotinas Delphi com referência direta ao campo

Rotina	Arquivo	Descrição
iniciar	UMNF001.pas	Oculta/exibe o botão btnImportarSeriais conforme o parâmetro
TfrmMNF001.btnSalvarClick	UMNF001.pas	Ao salvar, chama tela de seriais para itens com TP_UNIDADE = 'Q' quando parâmetro é N
Busca_Parametros	UdmMNF001.pas	Carrega o valor do parâmetro na variável iST_PERMITEIMPORTARPLANILHA
TdmMNF001.tabITEMNOTAPS_ITEMNOTAValidate	UdmMNF001.pas	Na validação do campo PS, chama tela de seriais para itens com TP_UNIDADE ≠ Q quando parâmetro é N
TdmMNF001.tabITEMNOTAQT_ITEMNOTAValidate	UdmMNF001.pas	Lógica comentada — serialização movida para o botão Salvar

Referências SQL diretas ao campo

Nenhuma procedure SQL em Scripts/ referencia diretamente a coluna ST_PERMITEIMPORTARPLANILHA. O uso é exclusivamente via aplicação Delphi (MNF001).

Candidatas por uso da tabela

As procedures listadas na seção de evidências utilizam a tabela PARMFATUR, mas não referenciam este campo diretamente.