3. Licenciamento
3.2. Como funciona a licença de uso da DLL
3.1. Condições de Licenciamento
« Anterior
4. Instalação da DLL
Próximo »

3.2. Como funciona a licença de uso da DLL

A DLL valida o licenciamento da DLL verificando se chave de 128 caracteres informada pertence ao CNPJ informado.

A verificação da licença para o CNPJ é realizada por software pela própria DLL, assim a DLL pode ser utiliza por mais de um CNPJ, desde que sejam informados o CNPJ e a respectiva chave da licença de uso.

A validação da licença só é relizada quando a DLL for utilizada em ambiente de produção.

A chave da licença de uso deve ser passada para a DLL no parâmetro licenca da chamada da DLL que requer licenciamento para uso em ambiente de produção, como é o caso do EnviaLoteRPS:

EnviaLoteRPS(cMunicipio, certificado, ambiente, versao, msgDados, cResultado, msgResultado, CNPJPrestador, nroLote, dataRecebimento, protocolo, proxy, usuario, senha, licenca);

Recomenda-se a disponibilização de um campo com 128 caracteres na configuração da sua aplicação para armazenar a chave da licença de uso para que fique disponível para a sua aplicação utilizar sempre que se fizer necessário.

Como vou receber a chave da licença de uso?

A chave da licença de uso é informada para o e-mail informado no contato do pedido:

Exemplo Delphi

 
licenca := 'b06ccea9f950a4e62c2be9540efc61c39496(...)532c5725a23e3b3cfcc4c18c03e57c368e173a';
 
  // código omitido
 
  // instancia a DLL
 
  Util := CreateOleObject('NFSe_Util.util');
 
  Screen.cursor := crHourglass;
  msgRetWS := Util.EnviaLoteRPS(cMunicipio,
                                certificado,
                                ambiente,
                                versao,
                                msgDados,
                                cResultado,
                                msgResultado,
                                CNPJPrestador,
                                nroLote,
                                dataRecebimento,
                                protocolo,
                                listaMensagemRetorno,
                                proxy, usuario, senha,
                                licenca);                 // <==== parâmetro licenca
  Screen.cursor := crDefault;

Exemplo VB

 
licenca = "b06ccea9f950a4e62c2be9540efc61c39496(...)532c5725a23e3b3cfcc4c18c03e57c368e173a"
 
' código omitido

'
' instancia a DLL
'
Dim objNFSeUtil As NFSe_Util.Util
'
Set objNFSeUtil = New NFSe_Util.Util
'
'
Screen.MousePointer = vbHourglass    ' ampulheta
'
'   invoca Web Service
'
   msgRetWS = objNFSeUtil.EnviaLoteRPS(cMunicipio,
                                       certificado,
                                       ambiente,
                                       versao,
                                       msgDados,
                                       cResultado,
                                       msgResultado,
                                       CNPJPrestador,
                                       numeroLote,
                                       dataRecebimento,
                                       protocolo,
                                       ListaMensagemRetorno,
                                       proxy, usuario, senha,
                                       licenca)                 ' <==== parâmetro licenca   
'
'
Screen.MousePointer = vbDefault ' normal

Erros comuns relacionados com a licença

As principais causas de falha da validação da licença ocasionadas por respeitar os seguintes itens:

A licença informada [xxxxx] tem tamanho [nnn] diferente de 128

Chave Menor

Chave Maior

SOLUÇÃO

Este erro ocorre quando a chave da licença informada tem tamanho diferente de 128, verifique a licença informada [xxxxx] e o seu tamanho [nnn], o [xxxxx] mostra a licenca e [nnn] o tamanho da licença recebida pela DLL. É comum a aplicação não passar a licença de uso ou o usuário copiar menos caracteres que o necessário ou mais caracteres que o necessário.

A chave informada [xxxxx] tamanho[nnn] é inválida para o CNPJ [cccccccccccccc] Tamanho [nn]

Chave Inválida

SOLUÇÃO

Verifique:

  1. se a chave informada [xxxxx] não tem letras em maiúsculas;
  2. se a chave informada tem tamanho [nnn] de 128 caracteres;
  3. se o CNPJ [cccccccccccccc] está correto;
  4. se o CNPJ [cccccccccccccc] tem 12 dígitos;
  5. se a chave da DLL é compatível com a versão da DLL;

As informações da versão da DLL, chave e CNPJ constam do e-mail que informa a chave:

Prezado Sr. Usuário, Informamos a chave da licença de uso da DLL para o seguinte estabelecimento:

99.999.999/0001-23 CNPJ - Sociedade Prestadora de Serviços ME

Chave da licença da DLL FlexDocs: NFS-e v1 DLL e versão

ae697d2018e660ee2a585891ee52a7c(...chave truncada para melhor visualização...)5d623f15b91ee520d8fc15d191ee52 chave

A chave tem 128 caracteres e é case sensitive, ou seja, as letras devem ser informadas como minúsculas, no campo "licenca" das funcionalidades que requerem o prévio licenciamento (Ex. cancelamento, inutilização, etc.).

É altamente recomendável que a sua aplicação ofereça um campo para armazenar a chave nas configurações de seu sistema.

A Nota Fiscal de Serviços foi emitida para 99.999.999/0001-23 - Sociedade Prestadora de Serviços ME e está sendo enviada pelos Correios.

Atenciosamente,

Equipe de Suporte FlexDocs www.flexdocs.com.br

3.2. Como funciona a licença de uso da DLL
3. Licenciamento
« Anterior
3.1. Condições de Licenciamento
Próximo »
4. Instalação da DLL