Método DESCARGACFDI

El método DESCARGACFDI permite recuperar los CFDI timbrados almacenados en Quiero Mi Factura.

Este método es útil para sincronizar comprobantes con sistemas externos, descargar XML emitidos, alimentar procesos administrativos o construir flujos de conciliación y respaldo.

¿Para qué sirve?

  • Descargar CFDI emitidos por rango de fechas.
  • Filtrar por tipo de comprobante.
  • Procesar resultados en páginas cuando existen más de 30 comprobantes.
  • Integrar XML emitidos a ERP, conciliación o procesos internos.

Ventajas del método

  • Consulta por un rango de fechas.
  • Límite de 30 CFDI por petición para evitar saturación.
  • Filtrado por tipo de comprobante.
  • Paginación mediante TOKEN.

Endpoint

QA / Sandbox:
http://159.203.10.206/QA2/web_services/servidorMarket.php?wsdl

Para obtener el endpoint productivo es necesario completar las pruebas y resultados de integración.

Campos de la petición

Campo Descripción
FECHA1 Fecha inicial de búsqueda.
FECHA2 Fecha final de búsqueda.
TOKEN Nodo de paginación. Se usa cuando hay más de 30 resultados.
CODE Valor documentado en el ejemplo técnico: HTMLENCODE.
RFC RFC del emisor o cuenta correspondiente.
tipocomprobante Tipo de comprobante: F, NC o G.

Tipos de comprobante soportados

  • F = Factura
  • NC = Nota de crédito
  • G = Factura Global

Ejemplo de petición

<FECHA1>2021-10-01</FECHA1>
<FECHA2>2021-10-31-</FECHA2>
<TOKEN></TOKEN>
<CODE>HTMLENCODE</CODE>
<RFC>ABC0_ABC140702XYZ</RFC>
<tipocomprobante>F</tipocomprobante>

Paginación con TOKEN

El nodo TOKEN solo se utiliza como mecanismo de paginación.

Si la búsqueda devuelve más de 30 CFDI, la respuesta incluirá un valor en TOKEN. Para obtener la siguiente página, debes reenviar la misma petición, pero ahora con el nodo TOKEN poblado con el valor recibido.

Este ciclo se repite hasta que ya no existan más resultados pendientes.

Estructura básica de la respuesta

La respuesta SOAP incluye, entre otros, los siguientes elementos:

  • Estatus
  • RESTAN
  • TOTAL
  • COMPROBANTES
  • TOKEN

Dentro de COMPROBANTES, cada elemento puede incluir el CFDI en XML y datos
complementarios como SKU.

Ejemplo resumido de respuesta

<Estatus>EXITO</Estatus>
<RESTAN></RESTAN>
<TOTAL>1</TOTAL>
<COMPROBANTES>
  <item>
    <CFDI>...XML del comprobante...</CFDI>
    <SKU>,</SKU>
  </item>
</COMPROBANTES>
<TOKEN></TOKEN>

Flujo recomendado

  1. Define el rango de fechas a consultar.
  2. Selecciona el tipo de comprobante que deseas descargar.
  3. Envía la primera petición con TOKEN vacío.
  4. Procesa los CFDI recibidos en COMPROBANTES.
  5. Si la respuesta devuelve un TOKEN, reenvía la misma petición con ese valor.
  6. Repite el proceso hasta agotar todas las páginas.

Casos de uso típicos

  • Descarga diaria o mensual de XML emitidos.
  • Sincronización de CFDI con un ERP o sistema administrativo.
  • Conciliación de facturación por tipo de comprobante.
  • Respaldo histórico de CFDI timbrados.

Errores comunes

  • No reenviar la misma petición cuando el método devuelve TOKEN.
  • Asumir que una sola consulta devolverá todos los CFDI aunque existan más de 30 resultados.
  • Usar un tipo de comprobante incorrecto.
  • No validar el RFC o el rango de fechas antes de ejecutar la búsqueda.
  • Procesar solo el primer elemento de COMPROBANTES y omitir el resto del arreglo.

Recomendaciones prácticas

  • Comienza siempre con ventanas de fechas pequeñas durante pruebas.
  • Automatiza el manejo de TOKEN desde tu integración.
  • Guarda trazabilidad de cada ejecución para no descargar CFDI duplicados innecesariamente.
  • Valida el tipo de comprobante antes de lanzar procesos masivos.
  • Prueba primero en QA / Sandbox antes de solicitar endpoint productivo.
  • Si tu proceso será masivo, automatiza el manejo de TOKEN desde el inicio

Relación con otros métodos

El método DESCARGACFDI se utiliza después de que las órdenes han sido procesadas y facturadas en QMF.

Explora la documentación

Navega por todas las secciones técnicas de Quiero Mi Factura para completar tu integración:

Scroll al inicio