NR_CONTRATO — Número do Contrato de Licença
Tela de configuração: ADM010 — Parâmetros do Sistema Tabela:
PARMSISTEMA.NR_CONTRATOTipo:DOM_INTEGERValor padrão: Sem padrão (nullable)
Resumo
Armazena o número do contrato de licença/assistência do cliente com a Junsoft. Esse valor é lido durante o registro da licença, na montagem da sessão de boletos via API e na inicialização da integração, sendo utilizado para validar e identificar a assinatura ativa do ERP.
| O que faz | Detalhe |
|---|---|
| Identifica o contrato | Número inteiro vinculado à licença do cliente |
| Leitura automática | Lido em carregarRegistro, montarChaveLicenca e FormCreate da integração |
| Repassado entre módulos | Vários módulos recebem NR_CONTRATO como parâmetro de abertura para filtrar vinculações contratuais |
Telas impactadas
| Tela / Módulo | Uso |
|---|---|
| ADM010 (Parâmetros do Sistema) | Onde o valor é configurado |
| UformRegistro (Registro do Sistema) | Lê ps.NR_CONTRATO junto com ps.NR_LICENCA para montar dados da licença |
| UdmSessaoBoleto (API Boletos) | Lê ps.NR_CONTRATO na montagem da chave de licença para boletos |
| UfrmPrincipal (Integração) | Lê ps.NR_CONTRATO na inicialização para validar módulos contratados |
| CFC001 (Contas a Pagar/Receber) | Filtra CONTAS.NR_CONTRATO quando recebido como parâmetro |
| MFC002 (Contas a Pagar/Receber - Viagem) | Cria registros em CONTRATOINDDOCTO vinculando contrato ao contas |
| MFC004 (Contas a Pagar/Receber) | Filtra CONTAS.NR_CONTRATO quando recebido como parâmetro |
| MCA010 (Movimento de Captação de Leite) | Preenche filtro de contrato ao abrir a partir de MCA012 |
| MNF002 (Nota Fiscal) | Gera observação "Ref. Contrato Número X" na nota fiscal |
| LAB001 (Laboratório) | Lookup de contrato em filtro de movimentos |
| LCT001–LCT011 (Contratos - Relatórios/Layouts) | Parametriza consulta de contrato em cada layout de contrato de leite |
| LBL000 (Boletos) | Formata título com número do contrato |
Campos envolvidos
| Campo | Tabela | Contexto |
|---|---|---|
NR_CONTRATO | PARMSISTEMA | Parâmetro de sistema (contrato de licença) |
NR_CONTRATO | CONTAS | Vincula lançamento financeiro a um contrato |
NR_CONTRATO | CONTRATOINDDOCTO | Vincula documento a contrato de indústria |
NR_CONTRATO | CONTRATO | Chave primária de contratos gerais |
NR_CONTRATO | CONTRATOLEITE | Chave primária de contratos de leite |
NR_CONTRATO | CONTRATOINDUSTRIA | Chave primária de contratos de indústria |
NR_CONTRATO | CONTRATOLOCACAO | Chave primária de contratos de locação |
NR_CONTRATO | CONTRATOILUMINACAO | Chave primária de contratos de iluminação |
NR_CONTRATO | BOLETO | Número do contrato no boleto |
Comportamento
Registro e Licença
Na inicialização do sistema, as rotinas de registro leem PARMSISTEMA.NR_CONTRATO em conjunto com PARMSISTEMA.NR_LICENCA para compor os dados de validação da licença do ERP.
| O que faz | Detalhe |
|---|---|
| Leitura na inicialização | Consulta SELECT ps.NR_LICENCA, ..., ps.NR_CONTRATO FROM PARMSISTEMA ps |
| Armazenamento em sessão | Valor atribuído a mainDataModule.nrContrato |
| Uso na API de Boletos | Lido na montagem da chave de licença para o módulo de boletos |
| Uso na Integração | Lido na inicialização para verificar módulos contratados |
Exceção / Importante: O valor é lido automaticamente pelo sistema e não requer intervenção manual durante o uso. A configuração é feita apenas na tela ADM010.
Repasse como Parâmetro entre Módulos
Quando um módulo é aberto a partir de outro (por exemplo, ao abrir CFC001 a partir de uma tela de contratos), o NR_CONTRATO é passado como parâmetro de abertura para filtrar automaticamente as informações daquele contrato específico.
Simulação passo a passo
- Acesse a tela de origem (ex.: tela de Contrato de Indústria).
- Selecione o contrato desejado e abra a rotina de Contas (CFC001) a partir dele.
- O sistema preenche automaticamente o filtro de
CONTAS.NR_CONTRATOcom o número do contrato de origem. - Clique em Procurar para visualizar apenas os lançamentos vinculados ao contrato.
Resultado esperado: Apenas os registros financeiros (CONTAS) vinculados ao contrato selecionado são exibidos, filtrados por NR_CONTRATO.
Exceção / Importante: Quando
NR_CONTRATOestá vazio no parâmetro de abertura, o módulo abre sem filtro de contrato, exibindo todos os registros.
Procedures impactadas
Rotinas Delphi com referência direta ao campo
| Rotina | Arquivo | Descrição |
|---|---|---|
carregarRegistro | source/Junsoft/UformRegistro.pas | Lê ps.NR_CONTRATO para dados da licença |
TdmSessaoBoleto.montarChaveLicenca | source/JunsoftAPIBoletos/UdmSessaoBoleto.pas | Lê ps.NR_CONTRATO para sessão de boletos |
TfrmPrincipal.FormCreate | source/JunsoftIntegracao/UfrmPrincipal.pas | Lê ps.NR_CONTRATO para validação de módulos |
iniciar | source/CFC001/UCFC001.pas | Filtra CONTAS por NR_CONTRATO |
TfrmCFC001.btnCancContasClick | source/CFC001/UCFC001.pas | Verifica se CONTAS possui contrato vinculado |
TfrmCNF001.btnAlteraContratoClick | source/CNF001/UCNF001.pas | Copia contrato do serial para NF |
TfrmMCA010 (iniciar) | source/MCA010/UMCA010.pas | Preenche filtro de contrato na captação |
MFC002 (gravação) | source/MFC002/UMFC002.pas | Cria CONTRATOINDDOCTO vinculando contrato |
MFC004 (iniciar) | source/MFC004/UMFC004.pas | Filtra CONTAS por NR_CONTRATO |
TfrmMNF002 | source/MNF002/UMNF002.pas | Gera observação de contrato na NF |
TfrmLAB001 | source/LAB001/ULAB001.pas | Lookup de contrato no filtro de laboratório |
Formata_Titulo | source/LBL000/ULBL000.pas | Formata título de boleto com contrato |
LCT001–LCT011 | source/LCT*/ULCT*.pas | Parametriza consulta em layouts de contrato |
Scripts SQL com referência direta ao campo
| Procedure | Arquivo | Contexto |
|---|---|---|
RETORNA_DADOSLICENCA | Scripts/RETORNA_DADOSLICENCA.sql | Retorna dados da licença (NR_CONTRATO como campo) |
FECHA_CONTRATOLEITE / _V2 | Scripts/FECHA_CONTRATOLEITE.sql | Fecha contrato de leite por NR_CONTRATO |
CONTRATOLEITE_AUTOMATICO | Scripts/CONTRATOLEITE_AUTOMATICO.sql | Gera contrato automático |
ATUALIZA_SALDOCONTRATOLEITE | Scripts/ATUALIZA_SALDOCONTRATOLEITE.sql | Atualiza saldo do contrato de leite |
SALDO_CONTRATOLEITE | Scripts/SALDO_SALDOCONTRATOLEITE.sql | Consulta saldo do contrato |
GRAVA_CONTAS | Scripts/GRAVA_CONTAS.sql | Grava contas com vínculo a contrato |
CANCELA_FECHAMENTOCONTRATO | Scripts/CANCELA_FECHAMENTOCONTRATO.sql | Cancela fechamento de contrato |
RETORNA_COMPLEMENTOCONTRATO | Scripts/RETORNA_COMPLEMENTOCONTRATO.sql | Retorna complemento do contrato |
RETORNA_PRODUTOCONTRATO | Scripts/RETORNA_PRODUTOCONTRATO.sql | Retorna produtos do contrato |
RETORNA_PRODUCAOINDUSTRIA | Scripts/RETORNA_PRODUCAOINDUSTRIA.sql | Retorna produção por contrato |
RETORNA_MOVIMENTACAOLEITE | Scripts/RETORNA_MOVIMENTACAOLEITE.sql | Retorna movimentação de leite por contrato |
CALCULA_FRETECAPTACAO | Scripts/CALCULA_FRETECAPTACAO.sql | Calcula frete por contrato |
CALCULA_INCENTIVOANALISE / _PRODUCAO | Scripts/CALCULA_INCENTIVO*.sql | Calcula incentivo por contrato |
RETORNA_TOTAISCONTRATORECAP | Scripts/RETORNA_TOTAISCONTRATORECAP.sql | Retorna totais de contrato de recapagem |
TGR_SALDOCONTRATO | Scripts/TGR_SALDOCONTRATO.sql | Trigger de saldo com NR_CONTRATO |
AJUSTA_SALDOMOVTOLEITE / _V2 | Scripts/AJUSTA_SALDOMOVTOLEITE*.sql | Ajusta saldo de movto de leite |
Nota: Diversas procedures utilizam a tabela
PARMSISTEMAsem referenciar diretamente a colunaNR_CONTRATO(ex.:GERA_SPEDBLOCOL,GERA_PLANOFILIAL,GERA_DARF). Essas candidatas por uso da tabela não possuem impacto funcional direto neste parâmetro.
Regra geral
- O valor de
NR_CONTRATOemPARMSISTEMAé configurado uma única vez na instalação/registro do ERP e não é alterado rotineiramente pelo usuário. - O sistema o lê automaticamente nas rotinas de licença, integração e API de boletos.
- Quando repassado como parâmetro de abertura entre módulos, filtra ou vincula registros ao contrato de origem.
- Se o campo estiver vazio (NULL), o sistema opera sem filtro de contrato nos módulos secundários.