Verificando a chave de acesso da empresa

Última atualização em: 25 de novembro, 2017

A chave de acesso da empresa será utilizada para criar o código Hash no formato MD5. Esta chave é gerada ao finalizar o cadastro da empresa, desta forma para ter a chave basta acessar o Painel de Controle do InvoiCy, e no grupo ‘Empresa’ a opção ‘Dados da empresa’. Observe os passos indicados abaixo:

1º Acesse a tela Inicial da Plataforma InvoiCy.

2º Selecione a empresa que deseja verificar a chave de acesso, através do combobox de empresas localizado na parte superior direita da tela.

3º No Menu lateral esquerdo, clique na opção ‘Painel de Controle’.

4º Então no grupo ‘Empresa’ clique na opção ‘Dados da empresa’, como demonstra a imagem a seguir.

Na tela dos dados da empresa, a chave de acesso será apresentada conforme imagem abaixo, permitindo a cópia da mesma:

Chave de acesso

 

Gerando o código Hash no formato MD5

Última atualização em: 17 de novembro, 2017

 

Com o intuito de aprimorar a segurança na utilização de Web Service no InvoiCy, foi elaborado um método utilizando uma chave de acesso no formato MD5. Este código deve ser gerado e informado em cada chamada ao Web Service. Abaixo listamos alguns exemplos de como gerar este código. As informações que você deverá utilizar para gerar a chave de acesso em MD5 são:

  • Utilizar a chave de acesso gerada pelo InvoiCy no momento do cadastro de sua empresa (para verificar a chave de acesso da sua empresa consulte o artigo Verificando a chave de acesso da empresa), concatenado com todo o conteúdo contido dentro do grupo de tag <Envio>. Copie a chave, mais todo o conteúdo (inclusive as tags).

Ex: 9099628c5a2e63d56a6c058c34e2b46f<Envio><ModeloDocumento>NFe(….)</Envio>

  • No momento da geração do código, as informações do documento fiscal que constam dentro da tag <Documento> ainda não podem estar convertidas para texto.
  • Caso for enviado mais de um documento, o código deve ser gerado somente com as informações do primeiro documento informado.
  • Este código deve ser informado no campo <EmpCK> do Web Service.

1. Exemplo de geração de CK em C#

Na linguagem C#, há uma classe com funções para gerenciamento da criptografia com o algoritmo MD5, cuja documentação pode ser conferida no link: http://msdn.microsoft.com/en-us/library/ez5bche8.aspx. Na figura abaixo pode ser visto um exemplo de geração de hash MD5 em C#. Abaixo listamos um exemplo:

2. Exemplo de geração de CK em Java

Na linguagem Java, existem várias classes e formas de gerar a criptografia com o algoritmo MD5. Abaixo listamos um exemplo em Java:

3. Calculadora de MD5 no InvoiCy

Para auxiliar no processo de integração com o InvoiCy, disponibilizamos uma Calculadora MD5 para gerar o código Hash, que deve ser utilizado em cada chamada ao Web Service. Com isso, é possível validar o código gerado pelo seu sistema comparando o mesmo com o código esperado pelo InvoiCy.

Para utilizar este recurso, basta acessar o menu Ferramentas de Integração, disponível no Painel de Controle do InvoiCy.

Ao acessar esta ferramenta, o InvoiCy irá apresentar a Chave de Acesso e a Chave de Parceiro, conforme empresa selecionada. Para gerar o Hash MD5 é preciso colar o XML gerado pelo seu sistema no campo Conteúdo do XML. Lembrando que este arquivo deverá estar linearizado. O resultado será apresentado no campo EmpCK Esperada.

Este Hash gerado deve ser comparado com o código gerado pelo seu sistema, caso o resultado apresentado no campo EmpCK Esperada for diferente do que foi gerado pelo seu sistema, revise seu XML, removendo caracteres especiais, espaços e quebras de linha.