Saltar a contenido

Integración con el Servicio Web de Consulta de CFE

¡Hola! En este artículo le guiaremos en la integración de su ERP con el servicio de consulta de CFE de InvoiCy.

El servicio web de Consulta de CFE (.../aws_consultafactura.aspx) permite realizar la consulta de uno o varios CFEs en una misma solicitud, validando su estado tanto en la DGI como en InvoiCy.

Ejemplo: https://appuypruebas.migrate.info/InvoiCy/aws_consultafactura.aspx?wsdl

Layout

Layout de Consulta de CFE. Download

Estructura de Envio

La estructura del XML de entrada de este servicio web está detallada en el layout de envío de consulta de CFE. A continuación, se muestra un ejemplo del SOAP donde dicho XML debe ser enviado. Esta estructura también puede consultarse accediendo al WSDL en aws_consultafactura.aspx?WSDL.

1
2
3
4
5
6
7
8
<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" xmlns:gx="Gx">
   <soapenv:Header/>
   <soapenv:Body>
      <gx:WS_ConsultaFactura.Execute>
         <gx:Xmlconsulta><!--(1)--></gx:Xmlconsulta>
      </gx:WS_ConsultaFactura.Execute>
   </soapenv:Body>
</soapenv:Envelope>
  1. Aquí estará tu XML de consulta 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.

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" xmlns:gx="Gx">
   <soapenv:Header/>
   <soapenv:Body>
      <gx:WS_ConsultaFactura.Execute>
         <gx:Xmlconsulta>&lt;ConsultaCFE&gt;
   &lt;Encabezado&gt;
      &lt;EmpCodigo&gt;Codigo de la empresa&lt;/EmpCodigo&gt;
      &lt;EmpPK&gt;Clave del socio&lt;/EmpPK&gt;
      &lt;EmpCK&gt;Clave de comunicacion&lt;/EmpCK&gt;
   &lt;/Encabezado&gt;
   &lt;Filtros&gt;
      &lt;TipoCFE&gt;Tipo CFE&lt;/TipoCFE&gt;
      &lt;FechaIni&gt;Fecha Inicial del Filtro&lt;/FechaIni&gt;
      &lt;FechaFin&gt;Fecha Final del Filtro&lt;/FechaFin&gt;
      &lt;Status&gt;Status del Comprobante&lt;/Status&gt;
      &lt;CFESerie&gt;Serie del Filtro&lt;/CFESerie&gt;
      &lt;CFEsFaixa&gt;
         &lt;CFENroIni&gt;Numero inicial del filtro&lt;/CFENroIni&gt;
         &lt;CFENroFin&gt;Numero Final del filtro&lt;/CFENroFin&gt;
      &lt;/CFEsFaixa&gt;
      &lt;CFEsEspecificos&gt;
         &lt;CFEsEspecificosItem&gt;
            &lt;CFENro&gt;Numero del CFE del Filtro&lt;/CFENro&gt;
            &lt;CFENumReferencia&gt;Numero identificador del CFE definido por el ERP&lt;/CFENumReferencia&gt;
         &lt;/CFEsEspecificosItem&gt;
      &lt;/CFEsEspecificos&gt;
   &lt;/Filtros&gt;
&lt;/ConsultaCFE&gt;</gx:Xmlconsulta>
      </gx:WS_ConsultaFactura.Execute>
   </soapenv:Body>
</soapenv:Envelope>

Al enviar una solicitud de consulta, el servicio devolverá el estado y detalles de los CFEs consultados.

Respuesta

A continuación, se muestra la estructura del XML de respuesta generado por el servicio web de consulta.

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
<Xmlretorno>
   <![CDATA[
   <Xml version="1.0" encoding="utf-8"?>
   <ConsultaCFERetorno>
      <Encabezado>
         <EmpCodigo>Codigo de la empresa</EmpCodigo>
         <NroLinRetorno>Numero de CFEs retornados</NroLinRetorno>
         <MsgCod>Codigo del mensaje de retorno de la consulta</MsgCod>
         <MsgDsc>Mensaje de retorno de la consulta</MsgDsc>
      </Encabezado>
      <ListaCFE>
         <CFE>
            <CFETipo>Tipo del CFE</CFETipo>
            <CFENro>Numero del Comprobante</CFENro>
            <CFESerie>Serie del Comprobante</CFESerie>
            <CFEStatus>Estado del Comprobante</CFEStatus>
            <CFEEstadoAcuse>Estado de la comunicación entre empresas</CFEEstadoAcuse>
            <CFEMsgCod>Codigo del mensaje de retorno del CFE</CFEMsgCod>
            <CFEMsgDsc>Mensaje de retorno del CFE</CFEMsgDsc>
            <CFECodigoSeguridad>Código de Seguridad del CFE</CFECodigoSeguridad>
            <Erros>
               <ErrosItem>
                  <CFEErrCod>Codigo del Erro</CFEErrCod>
                  <CFEErrDesc>Mensaje del Erro</CFEErrDesc>
               </ErrosItem>
            </Erros>
            <ErrosDGI>
               <ErrosDGIItem>
                  <CFERetCod>Codigo del Erro</CFERetCod>
                  <CFERetDesc>Mensaje del Erro</CFERetDesc>
               </ErrosDGIItem>
            </ErrosDGI>
         </CFE>
      </ListaCFE>
   </ConsultaCFERetorno>]]>
</Xmlretorno>