Integración con el Servicio Web de Consulta de Certificados Digitales
¡Hola! En este artículo le guiaremos en la integración de su ERP con el servicio de consulta de certificados digitales de InvoiCy.
El servicio web de Consulta de Certificados Digitales (../aws_consultaempresas.aspx), permite buscar las informaciones de empresas y sucursales que tienen sus certificados digitales próximos a vencer. Además, la consulta también buscará el código RUC, Estado y nombre de la empresa que está con el certificado por vencer.
Ejemplo: https://appuypruebas.migrate.info/InvoiCy/aws_consultaempresas.aspx?wsdl
Layout
Layout de Consulta de Certificados Digitales. Download
Estructura de Envio
La estructura del XML de entrada de este servicio web está detallada en el layout de envío correspondiente al proceso de consulta de certificados digitales. A continuación, se muestra un ejemplo del sobre SOAP en el que debe enviarse dicho XML, esta estructura también puede consultarse accediendo al WSDL en: aws_consultaempresas.aspx?WSDL.
| <soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" xmlns:gx="Gx">
<soapenv:Header/>
<soapenv:Body>
<gx:WS_ConsultaEmpresas.Execute>
<gx:Xmlconsulta><!--(1)--></gx:Xmlconsulta>
</gx:WS_ConsultaEmpresas.Execute>
</soapenv:Body>
</soapenv:Envelope>
|
- Aquí estará tu XML de consulta de certificados digitales convertido, reemplazando < y > por < y > respectivamente.
Dentro de la etiqueta , debe enviarse el XML de la solicitud convertido a texto, como se muestra en el siguiente ejemplo.
| <soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" xmlns:gx="Gx">
<soapenv:Header/>
<soapenv:Body>
<gx:WS_ConsultaEmpresas.Execute>
<gx:Xmlconsulta><![CDATA[<ConsultaCertificado>
<Encabezado>
<EmpPK>Clave del socio</EmpPK>
<EmpCK>Codigo de la empresa</EmpCK>
<EmpCodigo>Clave de comunicacion</EmpCodigo>
</Encabezado>
<Filtros>
<CerStatus>Estado del certificado</CerStatus>
<CerIntervalo>Dias restantes del certificado</CerIntervalo>
<EmpRucCollection>
<EmpRuc>RUC de la empresa</EmpRuc>
</EmpRucCollection>
</Filtros>
</ConsultaCertificado>]]></gx:Xmlconsulta>
</gx:WS_ConsultaEmpresas.Execute>
</soapenv:Body>
</soapenv:Envelope>
|
Al realizar una solicitud de consulta de certificado digital el servicio web traerá los datos que corresponden al filtro informado.
Respuesta
A continuación, se muestra un ejemplo de respuesta del servicio web.
| <Xmlretorno><![CDATA[<?xml version="1.0" encoding="utf-8"?>
<RetornoConsultaCertificado>
<Encabezado>
<MsgDsc>Proceso realizado con éxito!</MsgDsc>
<MsgCod>100</MsgCod>
</Encabezado>
<RetornoConsulta>
<RetornoConsultaItem>
<EmpRuc>999999999999</EmpRuc>
<Certificado>
<CertificadoItem>
<Apodo>Migrate</Apodo>
<CerStatus>A</CerStatus>
<DiasRestantes>248</DiasRestantes>
<CerFchVencimento>2023-07-13T21:18:30</CerFchVencimento>
</CertificadoItem>
</Certificado>
</RetornoConsultaItem>
</RetornoConsulta>
</RetornoConsultaCertificado>]]></Xmlretorno>
|
