dez
05
2023

Solicitar a senha do certificado digital via Web Service

5 de dezembro de 2023

Índice

-

Olá! Neste artigo vamos explicar sobre o funcionamento do Web Service disponibilizado para realizar a geração/solicitação da senha do certificado digital, o objetivo é o parceiro poder oferecer através do ERP a opção de setar a senha do certificado. O seu ERP deve realizar a integração com o Web Service aextensaocertificadosoap.aspx  disponibilizado pelo InvoiCy. 

Porém, é importante destacar que para que a solicitação da senha do certificado funcione através desse Web Service, o certificado precisa estar com o status pendente de senha na tela de monitoramento, bem como a extensão Invoicy Certificado Digital deve estar ativa. 

Para saber mais sobre essa extensão e como ativá-la leia o artigo Extensão Invoicy Certificado Digital.

Para realizar a integração com o Web Service siga os passos abaixo:

1. Visualize a estrutura WSDL do Web Service

Para visualizar a estrutura WSDL do Web Service, basta copiar e colar o link do Web Service em seu navegador de internet.

Para empresas que utilizam o ambiente de homologação, utilizar o link https://homolog.invoicy.com.br/aextensaocertificadosoap.aspx?WSDL.

Já para empresas que utilizam o ambiente de produção, devem utilizar o link https://app.invoicy.com.br/aextensaocertificadosoap.aspx?WSDL.

Assim é possível visualizar a estrutura do WSDL, conforme demonstra a imagem abaixo:

2. Realize o consumo do Web Service

Você deverá realizar o consumo do Web Service para efetuar a integração. Ao consumir o Web Service, você deverá informar os seguintes parâmetros:

  • EmpPK: Chave de Parceiro disponibilizada pela Migrate para cada cliente.

Exemplo: PYcEsFuKroDBojfiFEl+Ms==

A chave de parceiro é gerada por nosso Sistema de Gestão no momento que a sua empresa é cadastrada como nosso parceiro. A mesma será enviada por e-mail e utilizada para controlar as empresas de clientes finais que utilizarão licenças adquiridas pela sua empresa.

  • EmpCK: Código HASH gerado em formato MD5 de acordo com os dados enviados.

Exemplo: 213f3b55d679e790258fd811cc86d309

Utilizado para validar a comunicação e proporcionar segurança à comunicação. Consulte o artigo “Como gerar o código Hash MD5?” para mais informações.

  • Texto: Uso interno do InvoiCy. Não é necessário o preenchimento.
  • Documento: Conteúdo do XML em formato de texto.
  • Parâmetros: Não é necessário o preenchimento.

3. Realize a solicitação da senha do certificado

Através desse Web Service você irá solicitar a senha do certificado digital, lembrando que essa senha deve ser a mesma já pré determinada  no ambiente da gestão online após a videoconferência.

Para fazer o download da estrutura do xml, clique aqui.

Essa estrutura deve ser enviada dentro da tag ‘Documentos’ de forma linearizada e convertida para texto, como demonstra a imagem a seguir:

Clique aqui para fazer download do XML exibido na imagem.

No caso de sucesso na solicitação da senha, a mensagem retornada será “Senha enviada para validação no processo de geração de certificado” e a geração do certificado ocorrerá de forma automática, deixando o status na tela de monitoramento como “pendente de geração”, após isso, basta realizar o download do certificado, conforme orientações do seguinte manual: Download do certificado digital via Web Service.

Já se for informado na tag CNPJCPF um documento que não esteja com o status pendente de senha na tela de monitoramento o retorno pelo Web Service será: Não identificado registro para o Username/CNPJ/CPF com status pendente de senha.

E se a senha informada na tag Senha for diferente da já estipulada anteriormente pelo parceiro o erro retornado será: Senha informada incorreta, tente novamente.