7. Licenciamento 7.2. Como funciona a licença de uso da DLL: 7.1. Condições de Licenciamento
« Anterior; 8. Uso da DLL
Próximo »

7.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 CancelaNF2G:

CancelaNF2G(siglaWS, tipoAmbiente, nomeCertificado, versao, msgDados, msgRetWS, cStat, msgResultado, chaveNFe, nProtocolo, justificativa, nProtocoloCanc, dProtocoloCanc, 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('NFe_Util_2G.util'); 
 
  Screen.cursor := crHourglass;
  procCancNFe := Util.CancelaNF2G(siglaWS,
                                 tipoAmbiente,
                                 nomeCertificado, versao,
                                 msgDados,
                                 msgRetWS,
                                 cStat,
                                 msgResultado,
                                 chaveNFe,
                                 nProtocolo,
                                 justificativa,
                                 nProtocoloCanc,
                                 dProtocoloCanc,
                                 proxy, usuario, senha,
                                 licenca);                 // <==== parâmetro licenca
  Screen.cursor := crDefault;

Exemplo VB

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

'
' instancia a DLL
'
Dim objNFeUtil As NFe_Util_2G.Util
'
Set objNFeUtil = New NFe_Util_2G.Util
'
'
Screen.MousePointer = vbHourglass    ' ampulheta
'
'   invoca Web Service
'
  procCancNFe := objNFeUtil.CancelaNF2G(siglaWS,
                                        tipoAmbiente,
                                        nomeCertificado, versao,
                                        msgDados,
                                        msgRetWS,
                                        cStat,
                                        msgResultado,
                                        chaveNFe,
                                        nProtocolo,
                                        justificativa,
                                        nProtocoloCanc,
                                        dProtocoloCanc,
                                        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:

case sensitive - a chave é case sentive (diferenciação de letras maiúsculas e minúsculas), assim não altere as letras para maiúsculas;
tamanho da chave - o tamanho da chave é de 128 caracteres, fique atento para não informar uma string que tenha tamanho diferente de 128 caracteres;
vinculada ao CNPJ - uma chave serve apenas para um CNPJ, se for utilizar em diversos estabelecimentos será necessário adquirir uma chave para cada estabelecimento;
vinculada ao produto - a chave serve apenas para o produto e para a família da versão licenciada, ex.: NFS-e v1, serve apenas para as versões 1.x da DLL da NFS-e.

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:

se a chave informada [xxxxx] não tem letras em maiúsculas;

se a chave informada tem tamanho [nnn] de 128 caracteres;

se o CNPJ [cccccccccccccc] está correto;

se o CNPJ [cccccccccccccc] tem 12 dígitos;

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: NF-e v1 - para uso na versão 1.x ^{DLL e versão}

8609f6aaa10dba65d01ae55e297(...)2f8a3d4d15a061fbc0abb8b1717c5d9ab94a1c0582f9b60df^{chave da versão 1.x}

Chave da licença da DLL FlexDocs: NF-e 2G - para uso na nova versão da DLL** ^{DLL e versão 2G}

7b4a607e51c8fc7f8757f3aa72a(...)74c06f358efc682046960ced4e771c6187259792994592542^{chave da versão nova}

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

7.2. Como funciona a licença de uso da DLL 7. Licenciamento: « Anterior
7.1. Condições de Licenciamento; Próximo »
8. Uso da DLL

Guia de Uso da NFe_Util 2Gv4.17b