NR_LICENCA — Número da Licença de Software
Tela de configuração: ADM010 — Parâmetros do Sistema Tabela:
PARMSISTEMA.NR_LICENCATipo:DOM_INTEGER(inteiro) Valor padrão: Sem padrão definido (preenchido no registro/licenciamento)
Finalidade
Armazena o identificador da licença de software (LICENCASOFTWARE.ID) vinculada ao contrato do cliente. Esse número é usado para:
- Validar o registro do ERP junto ao servidor Junsoft (geração de contra-chave e chave de ativação).
- Montar o objeto de licença (
TLicencaERP) que controla quais módulos o cliente contratou. - Alimentar relatórios de estatística de licença (coleta de dados da base do cliente).
- Constar no layout de contratos impressos via
RETORNA_PRODUTOCONTRATO.
Telas impactadas
| Tela / Form | Função | Impacto |
|---|---|---|
UformRegistro (Registro do Sistema) | gerarContraChave / carregarRegistro | Lê NR_LICENCA para gerar a contra-chave de validação e instanciar TLicencaERP. |
UmainForm (Tela Principal) | buttonConexaoRemotaClick | Lê NR_LICENCA para autenticar a conexão remota com o Web Service Junsoft. |
UdmSessaoBoleto (API Boletos) | montarChaveLicenca | Lê NR_LICENCA para montar a licença e verificar limite de requisições de boletos (nrMaxAPIBoletos). |
UfrmPrincipal (Integração) | FormCreate | Lê NR_LICENCA ao iniciar o módulo de integração para instanciar TLicencaERP e habilitar/desabilitar módulos contratados. |
uGerabase (TFA067 — Gera Base) | btnBaseERPClick | Grava NR_LICENCA no script de geração de base, copiando o ID da licença selecionada no contrato. |
jEstatisticaLicenca | btnOkClick | Lê NR_LICENCA no relatório de estatística de licença. |
Campos envolvidos
| Campo | Tabela | Relação |
|---|---|---|
NR_LICENCA | PARMSISTEMA | Parâmetro principal |
NR_CONTRATO | PARMSISTEMA | Contrato associado à licença (configurado em ADM010) |
CD_KEY | PARMSISTEMA | Chave de ativação gerada a partir da licença |
ID | LICENCASOFTWARE | Tabela referenciada pelo valor de NR_LICENCA |
IDCONTRATOSOFTWARE | LICENCASOFTWARE | Vínculo licença → contrato |
Como o parâmetro é preenchido
| O que faz | Detalhe |
|---|---|
| Preenchimento automático | O valor é gravado automaticamente durante o processo de registro/licenciamento do ERP ou pela rotina de geração de base (TFA067). |
| Não editável manualmente | Não há campo visível para edição direta na tela ADM010. O valor vem da tabela LICENCASOFTWARE.ID. |
| Relação | NR_LICENCA = LICENCASOFTWARE.ID, filtrado por NR_CONTRATO e CD_EMPRESA. |
Simulação passo a passo — Registro do Sistema
- Acesse a tela de Registro do Sistema (menu do ERP).
- O sistema lê
NR_LICENCAeNR_CONTRATOdePARMSISTEMA. - Com esses dados, gera uma contra-chave contendo CNPJ, número da licença e versão.
- A contra-chave é enviada ao servidor Junsoft para validação.
- O servidor retorna a chave de ativação, gravada em
PARMSISTEMA.CD_KEY.
Resultado esperado: O ERP é registrado/ativado e os módulos contratados são liberados conforme a licença.
Simulação passo a passo — Geração de Base (TFA067)
- Abra a tela TFA067 — Gera Base.
- Selecione o contrato e a licença correspondente na interface.
- Clique em Gerar Base.
- O sistema executa:
UPDATE PARMSISTEMA SET CD_KEY = NULL, NR_CONTRATO = <contrato>, NR_LICENCA = <licença>. - O script de geração de base é montado com os dados do contrato e licença selecionados.
Resultado esperado: A nova base de dados é criada com o número do contrato e da licença corretos em PARMSISTEMA, pronta para registro.
Exceção / Importante:
- Se
NR_LICENCAestiver vazio/nulo na conexão remota, o sistema exibe erro: "Falha ao Buscar dados da Empresa! Contate o Suporte".- O valor de
NR_LICENCAtambém é utilizado porjValidate.pasna validação de pessoas (via webservice Junsoft), onde é retornado como campoNr_Licencano objetoPessoa.
Procedures impactadas
Rotinas Delphi com referência direta
| Rotina | Arquivo | Descrição |
|---|---|---|
gerarContraChave | source/Junsoft/UformRegistro.pas | Gera contra-chave usando NR_LICENCA, CNPJ e versão do ERP |
carregarRegistro | source/Junsoft/UformRegistro.pas | Carrega dados da licença para validação de registro |
buttonConexaoRemotaClick | source/Junsoft/UmainForm.pas | Autentica conexão remota com NR_LICENCA |
montarChaveLicenca | source/JunsoftAPIBoletos/UdmSessaoBoleto.pas | Monta licença para API de boletos |
FormCreate | source/JunsoftIntegracao/UfrmPrincipal.pas | Inicializa licença no módulo de integração |
btnBaseERPClick | source/TFA067/uGerabase.pas | Grava NR_LICENCA na geração de base |
ValidaPessoa / getPessoa | source/jCommon/jValidate.pas | Usa Nr_Licenca na validação de pessoa via webservice |
EstatisticaLicenca | source/jEstatisticaLicenca/jEstatisticaLicenca.pas | Relatório de estatística de licença |
Scripts SQL com referência direta ao campo
| Procedure | Arquivo | Uso |
|---|---|---|
RETORNA_DADOSLICENCA | Scripts/RETORNA_DADOSLICENCA.sql | Retorna dados da licença (contrato + licença) para coleta de estatísticas |
RETORNA_PRODUTOCONTRATO | Scripts/RETORNA_PRODUTOCONTRATO.sql | Usa NR_LICENCA (via V_NR_LICENCA) para filtrar os módulos do contrato no layout de impressão |
Candidatas por uso da tabela (sem referência direta ao campo)
As procedures abaixo utilizam PARMSISTEMA mas não referenciam NR_LICENCA diretamente:
ARRUMA_MASCARACONTA, ATUALIZA_CONTACONTABIL, CALCULA_TEMPOPERMANENCIA, CONTABILIZA_CUPOMFISCAL, ENDERECOPESSOA_BI0, GERA_CONTACLIFOR, GERA_DARF, GERA_PLANOFILIAL, GERA_SPEDBLOCOL, GERA_SPEDCONTABIL, GERA_SPEDCONTABIL_0000, GERA_SPEDECF, GERA_SPEDECFBLOCOJ, GERA_SPEDECFBLOCOK155, GERA_SPEDECFBLOCOK355, GERA_SPEDECFBLOCOL210, GERA_SPEDECFBLOCOY, GRAVA_REGISTROSPED0500, IMPORTA_ARQUIVOMAGNETICO, INCLUI_IMPOSTONOTACTB.
Sem impacto funcional direto identificado para NR_LICENCA nessas rotinas.