Pular para o conteúdo principal

STBONIFICACAOLAUDO – Habilita Compensação de Laudo

Tela de configuração: REC001 – Parâmetros de Recapadora Tabela: PARAMRECAP.STBONIFICACAOLAUDO Tipo: CHAR(1) Valor padrão: N (Não) Restrição: NOT NULL


Comportamento Geral​

Quando habilitado (S), permite que garantias/laudos vinculados a um cliente sejam utilizadas como desconto direto (compensação) em notas fiscais emitidas pelas telas MNF002 e MRC020, mesmo que as contas de bonificação ainda não tenham sido geradas no laudo (MRC004).

O parâmetro controla a visibilidade do botão "Utiliza Desconto" (btnUTILIZADESCONTO) nas telas de emissão de nota fiscal e entrada de carcacas.


Telas Impactadas​

TelaDescriçãoEfeito
MNF002 – Emissão de Nota FiscalMontagem de frete / emissão NFExibe botão "Utiliza Desconto" se cliente possui registros de compensação de laudo
MRC020 – Entrada de Carcaça por NotaEntrada de carcaca via NFExibe botão "Utiliza Desconto" se cliente possui registros de compensação de laudo
MRC048 – Compensação de LaudoTela de compensação de garantiasQuando N, oculta o botão "Utiliza Desconto"

Campos Envolvidos​

TabelaCampoObservação
PARAMRECAPSTBONIFICACAOLAUDOParâmetro principal (esta tela)
COMPENSAÇÃO (tabela de laudos)—Consultada por CD_PESSOA para verificar se o cliente possui registros de compensação

Opções Disponíveis​

N – Não Habilita Compensação (Padrão)​

O que fazDetalhe
Botão "Utiliza Desconto"Oculto em MNF002, MRC020 e MRC048
RestriçãoNenhuma compensação de laudo disponível para uso como desconto

Simulação passo a passo​

  1. Acesse REC001 (Parâmetros de Recapadora).
  2. Localize a aba que contém o checkbox "Habilita Compensação de Laudo".
  3. Certifique-se de que o checkbox está desmarcado (valor N).
  4. Salve o cadastro.
  5. Acesse MNF002 ou MRC020 e informe um cliente que possua laudos com garantia.
  6. Observe que o botão "Utiliza Desconto" permanece oculto.

Resultado esperado: O botão de compensação de laudo fica oculto em todas as telas de nota fiscal. O usuário não consegue aplicar desconto via compensação de laudo.


S – Habilita Compensação de Laudo​

O que fazDetalhe
Botão "Utiliza Desconto"Visível em MNF002 e MRC020 somente se o cliente selecionado possuir registros de compensação de laudo
MRC048Botão "Utiliza Desconto" fica visível (não é oculto pelo parâmetro)
Pré-requisitoO cliente deve ter ao menos 1 registro na tabela de compensação de laudos

Simulação passo a passo​

  1. Acesse REC001 (Parâmetros de Recapadora).
  2. Localize o checkbox "Habilita Compensação de Laudo".
  3. Marque o checkbox (valor S).
  4. Salve o cadastro.
  5. Acesse MNF002 (Emissão de Nota Fiscal).
  6. Informe o código de um cliente que possua registros de compensação de laudo (garantias não utilizadas).
  7. Observe que o botão "Utiliza Desconto" torna-se visível.
  8. Clique no botão para aplicar a compensação como desconto na nota.
  9. Repita o teste com um cliente sem registros de compensação — o botão permanecerá oculto.

Resultado esperado: O botão "Utiliza Desconto" aparece apenas para clientes com laudos compensáveis. O desconto é aplicado diretamente na nota fiscal.

Exceção / Importante: A visibilidade do botão depende de dois critérios simultâneos: (1) o parâmetro STBONIFICACAOLAUDO = S e (2) o cliente possuir ao menos 1 registro na tabela de compensação de laudos. Se o cliente não tiver laudos compensáveis, o botão permanece oculto mesmo com o parâmetro habilitado.


Regras de Negócio​

  1. Dupla validação: Apenas habilitar o parâmetro não é suficiente. O cliente na nota fiscal precisa ter registros válidos na tabela de compensação de laudos.
  2. Escopo de telas: O parâmetro afeta três telas distintas (MNF002, MRC020 e MRC048), todas controlando a mesma funcionalidade de desconto por compensação.
  3. Tooltip do parâmetro: "Com este parâmetro marcado, nos laudos (MRC004), se não tiver sido gerado as contas de bonificação para o cliente, poderá ser utilizado as garantias como um desconto direto nas notas fiscais (MNF002 e MRC020)."

Procedures Impactadas​

Rotinas Delphi com referência direta ao campo​

RotinaArquivoLinhaComportamento
Busca_ParametrosUdmMNF002.pas1098Lê STBONIFICACAOLAUDO do PARAMRECAP e armazena em iSTBONIFICACAOLAUDO
tabNOTACD_PESSOAValidate (MNF002)UdmMNF002.pas4251Se iSTBONIFICACAOLAUDO = 'S' e cliente tem compensações, mostra btnUTILIZADESCONTO
tabNOTACD_PESSOAValidate (MRC020)UdmMRC020NFORDEM.pas3302Se parmRecap.Values['STBONIFICACAOLAUDO'] = 'S' e cliente tem compensações, mostra btnUTILIZADESCONTO
iniciar (MRC048)UMRC048.pas254Se paramRecap.Values['STBONIFICACAOLAUDO'] = 'N', oculta btnUTILIZADESCONTO
chkSTBONIFICACAOLAUDOMouseMoveUframeREC001.pas1266Exibe tooltip descritivo ao passar o mouse sobre o checkbox

Referências SQL diretas ao campo​

Não foram encontradas referências diretas ao campo STBONIFICACAOLAUDO em scripts SQL (Scripts/*.sql). O campo é lido exclusivamente via aplicação Delphi.

Candidatas por uso da tabela PARAMRECAP​

Diversos scripts SQL fazem FROM PARAMRECAP ou INNER JOIN PARAMRECAP, mas nenhum deles referencia o campo STBONIFICACAOLAUDO diretamente. Esses scripts consultam outros campos da mesma tabela e não são impactados funcionalmente por este parâmetro.