⚙️ Problema con API SOAP (PHP/TypeScript): cadena downloadContent() no retorna datos al recuperar CFDIs sin UUID

PonnVolt · 31 Dic 2025

Llevo varias semanas intentando resolver un problema con la API SOAP al consumir el método downloadContent() dentro de un flujo de recuperación de CFDIs de nómina previamente timbrados.

El objetivo es recuperar los XML y PDF de los timbrados que completaron el proceso en el PAC pero experimentaron un timeout durante la generación del PDF, por lo que no contamos con el UUID en nuestra base de datos. La restricción principal es que debemos recuperar el CFDI únicamente con los datos del comprobante (RFC, serie, folio, total, fecha, etc.), sin usar el UUID.

Contexto técnico
La implementación se basa en el ejemplo oficial index_recovery.php para la función downloadContent(). De acuerdo con la documentación, la recuperación por datos (sin UUID) debería ser posible. No obstante, tras múltiples pruebas, todas las respuestas retornan SUCCESS: vacío, sin incluir las URLs del XML ni del PDF.

Ejemplo base utilizado (type = 2, nómina):

text
|#|MPXC830715BF8|#|CRISTIAN PEREZ MONTERROSAS MACEDA|#|NOM-C4FO|#|9|#|8330.69|#|2025-12-31|##||#||#||#||#||#||#| 
Estructura esperada:

text
|#|RFC|#|NOMBRE|#|SERIE|#|FOLIO|#|TOTAL|#|FECHA|##||#||#||#||#||#||#| 
Parámetro type: 2 (Payroll)

Request SOAP completo:
xml
<SOAP-ENV:Envelope xmlns:SOAP-ENV="http://schemas.xmlsoap.org/soap/envelope/" xmlns:ns1="https://cfdi360.com/webservice"> <SOAP-ENV:Header> <Auth> <userName>SAA090305UF4</userName> <password>SAA090305UF4#</password> </Auth> </SOAP-ENV:Header> <SOAP-ENV:Body> <ns1:downloadContent> <content><![CDATA[|#|MOMC830815BF8|#|CRISTIAN RAFAEL MONTERROSAS MACEDA|#|NOM-C4FO|#|9|#|8330.69|#|2025-12-31|##||#||#||#||#||#||#|]]></content> <type>2</type> </ns1:downloadContent> </SOAP-ENV:Body> </SOAP-ENV:Envelope> 
Respuesta:

xml
<return xsi:type="xsd:string">SUCCESS:</return> 
(Vacía, sin datos de archivo ni URLs).

Variantes probadas
He probado múltiples combinaciones para el content string, incluyendo:

Con y sin nombre del receptor.

Con o sin el campo total.

Con o sin fecha.

Variaciones en la relación entre serie y folio:

|#|SERIE|#||#|FOLIO|#|

|#|SERIE|#|FOLIO|#|

Con campos adicionales vacíos al final.

Cambiando type entre 1 (Invoice) y 2 (Payroll).

Ninguna de estas variantes retornó resultados.

Prueba exitosa con UUID
Cuando el UUID está presente, la función sí responde correctamente y entrega los datos de xml_url y pdf_url.
Ejemplo funcional:

text
48A31747-A0C4-449A-B0C1-13F2548E46F0|#||#||#||#||#||#|| 
o:

text
|#|MPXC830715BF8|#||#|NOM-C4FO|#||#|9|#|2025-12-31|##|48A31747-A0C4-449A-B0C1-13F2548E46F0|#||#||#||#||#||#| 
Ambos devuelven correctamente las URLs del CFDI.

Sin embargo, no es viable para nuestro caso de uso depender del UUID, ya que no lo tenemos registrado en los casos con timeout durante la timbración.

Contexto adicional (colateral)
Además del problema con la cadena SOAP, el proyecto presenta factores que podrían influir en el diagnóstico:

En ciertas pruebas, el botón de verificación/refresh en la interfaz invoca una función diferente, afectando el flujo de envío. (YA RESUELTO)

El timestamp usado en la cadena (parte del request) parece generarse con un huso horario distinto, lo que podría estar causando desincronización o invalidación del request.(YA RESUELTO)

Aun así, el núcleo del problema sigue siendo la generación y validación de la cadena SOAP downloadContent(), y cómo lograr una recuperación correcta sin UUID.

Agradecería cualquier orientación, ejemplos funcionales o documentación no oficial que ayude a comprender el formato esperado del campo content en este método.

BotBeta · 31 Dic 2025

PonnVolt, parece que has explorado a fondo el problema. Asegúrate de que el formato de la cadena content sea estrictamente el que la API espera. A veces, pequeños errores en el formato pueden resultar en respuestas vacías. Verifica también los posibles requerimientos adicionales en la documentación de la API, ya que algunos servicios tienen restricciones específicas para consultas sin UUID. Considera contactar al soporte del API si la documentación no es clara.

⚙️ Problema con API SOAP (PHP/TypeScript): cadena downloadContent() no retorna datos al recuperar CFDIs sin UUID

PonnVolt

Contexto técnico​

Ejemplo base utilizado (type = 2, nómina):​

Request SOAP completo:​

Variantes probadas​

Prueba exitosa con UUID​

Contexto adicional (colateral)​

BotBeta

Contexto técnico

Ejemplo base utilizado (type = 2, nómina):

Request SOAP completo:

Variantes probadas

Prueba exitosa con UUID

Contexto adicional (colateral)