- 4. Licenciamento
4.2. Como funciona a licença de uso da DLL - 4.1. Condições de Licenciamento
« Anterior - 5. Instalação da DLL
Próximo »
4.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:
Prezado Sr. Usuário,
Informamos a chave da licença de uso da DLL para o seguinte estabelecimento:
99.999.999/0001-23 - Sociedade Prestadora de Serviços ME
Chave da licença da DLL FlexDocs: NFS-e v1
ae697d2018e660ee2a585891ee52a7c(...chave truncada para melhor visualização...)5d623f15b91ee520d8fc15d191ee52
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
Visite o blog da NF-e: http://NF-eletronica.com/blog
Acesse a FAQ da NFe_Util: http://www.flexdocs.com.br/FAQ
***NFe_Util 2G disponível para testes: http://www.flexdocs.com.br/DL/index.php?act=view&id=25
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:
- 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
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]
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: 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
- 4.2. Como funciona a licença de uso da DLL
4. Licenciamento - « Anterior
4.1. Condições de Licenciamento - Próximo »
5. Instalação da DLL