2023
Consultar a validade 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 Consultar a Validade do Certificado Digital via Web Service.
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 consulta da validade do certificado funcione através desse Web Service, o parceiro deve ter ativa a extensão Invoicy Certificado Digital.
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 consulta do vencimento da validade do certificado digital:
Através desse Web Service você poderá consultar a validade do certificado digital de cada cliente. Para fazer o download da estrutura do xml, clique aqui.
Você deve enviar toda a estrutura da consulta dentro da tag ‘Documentos’ linearizado e convertido para texto, como demonstra a imagem a seguir:
Clique aqui para fazer download do XML exibido na imagem.
No caso de sucesso na consulta da validade do certificado, a mensagem retornada irá apresentar o apelido do certificado, o tipo, a data de vencimento e o status de renovação.