Saltar a contenido

Integración con el Servicio Web de Descarga de CFE Emitidos

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

El servicio web de Descarga de CFE Emitidos (.../aws_descargaemitidos.aspx), es posible descargar el XML y la representación impresa de los comprobantes emitidos así como, puede también consultar un gran cantidad de comprobantes.

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

Layout

Layout de Descarga de CFE Emitido. 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 descarga de CFE emitido. 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_descargaemitidos.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_DescargaEmitidos.Execute>
         <gx:Xmldescarga><!--(1)--></gx:Xmldescarga>
      </gx:WS_DescargaEmitidos.Execute>
   </soapenv:Body>
</soapenv:Envelope>
  1. Aquí estará tu XML de envío correspondiente al proceso de descarga de CFE emitido 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
32
<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" xmlns:gx="Gx">
   <soapenv:Header/>
   <soapenv:Body>
      <gx:WS_DescargaEmitidos.Execute>
         <gx:Xmldescarga>&lt;DescargaEmitidos&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;Pagina&gt;Informa la pagina deseada. Si no informado retorna pagina 1.&lt;/Pagina&gt;
   &lt;/Encabezado&gt;
   &lt;Filtros&gt;
      &lt;FechaHoraInclusionIni&gt;Fecha/Hora inicial&lt;/FechaHoraInclusionIni&gt;
      &lt;FechaHoraInclusionFin&gt;Fecha/Hora final&lt;/FechaHoraInclusionFin&gt;
      &lt;TipoCFE&gt;Tipo del CFE&lt;/TipoCFE&gt;
      &lt;CFESerie&gt;Serie del CFE&lt;/CFESerie&gt;
      &lt;CFEStatus&gt;Estado del CFE&lt;/CFEStatus&gt;
      &lt;CFEOrigen&gt;Origen de emisión del CFE (Digitación, WS, Conector, Mobile, etc)&lt;/CFEOrigen&gt;
      &lt;TipoRetornoXML&gt;Elige el XML del comprobante. 1 - XML de Envio de CFE, 2 - XML Entre Empresas&lt;/TipoRetornoXML&gt;
      &lt;CFERepImpresa&gt;Indicador se retorna representación impresa y en que formato (link, base64, etc)&lt;/CFERepImpresa&gt;
      &lt;CFEImpFormato&gt;Formato de la representación impresa.&lt;/CFEImpFormato&gt;
      &lt;CFEsEspecificos&gt;
         &lt;CFEsEspecificosItem&gt;
            &lt;CFENumero&gt;Numero del CFE&lt;/CFENumero&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;/DescargaEmitidos&gt;</gx:Xmldescarga>
      </gx:WS_DescargaEmitidos.Execute>
   </soapenv:Body>
</soapenv:Envelope>

Al realizar una solicitud de descarga de CFE, el servicio web traerá los datos de los comprobantes que corresponden al filtro informado.

Respuesta

A continuación, se muestra un ejemplo de la respuesta del servicio web.

 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
<Xmlretorno>
  <![CDATA[
  <xml version="1.0" encoding="utf-8"?>
  <DescargaEmitidosRetorno>
    <Encabezado>
      <EmpCodigo>Codigo de la empresa</EmpCodigo>
      <NroLinRetorno>Numero de CFE retornados</NroLinRetorno>
      <NroLinTotalRetorno>Numero de CFE total que corresponden al filtro</NroLinTotalRetorno>
      <Pagina>Informa la pagina de CFE retornada.</Pagina>
      <MsgCod>Codigo del Mensage de retorno</MsgCod>
      <MsgDsc>Mensaje de retorno</MsgDsc>
    </Encabezado>
    <ListaCFE>
      <CFE>
        <TipoCFE>Tipo CFE</TipoCFE>
        <CFESerie>Serie del Comprobante</CFESerie>
        <CFENumero>Numero del Comprobante</CFENumero>
        <CFENumReferencia>Numero identificador del CFE definido por el ERP</CFENumReferencia>
        <CFEStatus>Estado del CFE</CFEStatus>
        <CFEMsgCod>Codigo del mensage de retorno del CFE</CFEMsgCod>
        <CFEMsgDsc>Mensaje de retorno del CFE</CFEMsgDsc>
        <FechaHoraInclusion>Fecha que el comprobante fue registrado en la base de datos</FechaHoraInclusion>
        <FechaHoraFirma>Fecha y hora que el XML fue firmado</FechaHoraFirma>
        <CFEOrigen>Origen de emisión del CFE (Digitación, WS, Conector, etc)</CFEOrigen>
        <CFECobranzaPropia>Indica si es Recibo Electrónico o no (Indicador de Cobranza Propia)</CFECobranzaPropia>
        <CFEPagoCuentaTerceros>Indicador de Pago por Cuenta de Terceros</CFEPagoCuentaTerceros>
        <CFEXML>XML del CFE en base64</CFEXML>
        <CFERepImpresa>Representación Impresa en base64 o link</CFERepImpresa>
      </CFE>
    </ListaCFE>
  </DescargaEmitidosRetorno>]]>
</Xmlretorno>