STBONIFICACAOLAUDO – Habilita Compensação de Laudo
Tela de configuração: REC001 – Parâmetros de Recapadora Tabela:
PARAMRECAP.STBONIFICACAOLAUDOTipo: 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
| Tela | Descrição | Efeito |
|---|---|---|
| MNF002 – Emissão de Nota Fiscal | Montagem de frete / emissão NF | Exibe botão "Utiliza Desconto" se cliente possui registros de compensação de laudo |
| MRC020 – Entrada de Carcaça por Nota | Entrada de carcaca via NF | Exibe botão "Utiliza Desconto" se cliente possui registros de compensação de laudo |
| MRC048 – Compensação de Laudo | Tela de compensação de garantias | Quando N, oculta o botão "Utiliza Desconto" |
Campos Envolvidos
| Tabela | Campo | Observação |
|---|---|---|
PARAMRECAP | STBONIFICACAOLAUDO | Parâ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 faz | Detalhe |
|---|---|
| Botão "Utiliza Desconto" | Oculto em MNF002, MRC020 e MRC048 |
| Restrição | Nenhuma compensação de laudo disponível para uso como desconto |
Simulação passo a passo
- Acesse REC001 (Parâmetros de Recapadora).
- Localize a aba que contém o checkbox "Habilita Compensação de Laudo".
- Certifique-se de que o checkbox está desmarcado (valor
N). - Salve o cadastro.
- Acesse MNF002 ou MRC020 e informe um cliente que possua laudos com garantia.
- 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 faz | Detalhe |
|---|---|
| Botão "Utiliza Desconto" | Visível em MNF002 e MRC020 somente se o cliente selecionado possuir registros de compensação de laudo |
| MRC048 | Botão "Utiliza Desconto" fica visível (não é oculto pelo parâmetro) |
| Pré-requisito | O cliente deve ter ao menos 1 registro na tabela de compensação de laudos |
Simulação passo a passo
- Acesse REC001 (Parâmetros de Recapadora).
- Localize o checkbox "Habilita Compensação de Laudo".
- Marque o checkbox (valor
S). - Salve o cadastro.
- Acesse MNF002 (Emissão de Nota Fiscal).
- Informe o código de um cliente que possua registros de compensação de laudo (garantias não utilizadas).
- Observe que o botão "Utiliza Desconto" torna-se visível.
- Clique no botão para aplicar a compensação como desconto na nota.
- 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=Se (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
- 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.
- 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.
- 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
| Rotina | Arquivo | Linha | Comportamento |
|---|---|---|---|
Busca_Parametros | UdmMNF002.pas | 1098 | Lê STBONIFICACAOLAUDO do PARAMRECAP e armazena em iSTBONIFICACAOLAUDO |
tabNOTACD_PESSOAValidate (MNF002) | UdmMNF002.pas | 4251 | Se iSTBONIFICACAOLAUDO = 'S' e cliente tem compensações, mostra btnUTILIZADESCONTO |
tabNOTACD_PESSOAValidate (MRC020) | UdmMRC020NFORDEM.pas | 3302 | Se parmRecap.Values['STBONIFICACAOLAUDO'] = 'S' e cliente tem compensações, mostra btnUTILIZADESCONTO |
iniciar (MRC048) | UMRC048.pas | 254 | Se paramRecap.Values['STBONIFICACAOLAUDO'] = 'N', oculta btnUTILIZADESCONTO |
chkSTBONIFICACAOLAUDOMouseMove | UframeREC001.pas | 1266 | Exibe 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.