Qué hace: devuelve los metadatos del CFDI generado por una solicitud asíncrona y los enlaces de descarga a los archivos ZIP en la nube que contienen el XML y el PDF del comprobante.
Cuándo se usa: cuando ASYNC_CONVERT_VERIFY ya te indicó que la solicitud se procesó con éxito, y necesitas los archivos del comprobante.
Cuándo no usarla: para recuperar un CFDI emitido por el servicio normal (síncrono), que se pide con RETRIEVE_DOCUMENT. Tampoco antes de que la solicitud termine: para eso está ASYNC_CONVERT_VERIFY.
RETRIEVE_DOCUMENT, y usa los mismos nodos de respuesta. Lo que decodifiques de ResponseData1 y ResponseData3 es una dirección de descarga, no el contenido del XML ni del PDF.| Si tu integración… | Tu artículo es... |
|---|---|
| Necesita los archivos de un CFDI emitido por el servicio asíncrono, por SOAP | Este artículo |
| Necesita saber si una solicitud asíncrona ya terminó | ASYNC_CONVERT_VERIFY |
| Va a encolar un comprobante de más de 1 MB | ASYNC_CONVERT_NATIVE_XML |
| Necesita el XML o el PDF de un CFDI emitido por el servicio normal | RETRIEVE_DOCUMENT — CFDI + Timbrado (SOAP) |
| Necesita el XML o el PDF de un CFDI de Retenciones | GET_DOCUMENT_RETENCIONES |
Requestor y Entity.ASYNC_CONVERT_NATIVE_XML.Status igual a 2 en ASYNC_CONVERT_VERIFY.ASYNC_CONVERT_VERIFY que la solicitud tiene Status igual a 2. Sin eso, no hay comprobante que recuperar.Transaction con valor ASYNC_RETRIEVE_DOCUMENT, el identificador en Data1, Data2 y Data3 vacíos.RequestTransactionResponse.Result.Result = true te permite continuar; Result = false te lleva a Solución de problemas.ResponseData1 y ResponseData3. Lo que obtienes son dos direcciones de descarga, no los archivos.Identifier con el registro de tu ERP: Folio Fiscal, serie, folio, receptor, moneda e importe.Si algo falla, ve a Solución de problemas.
| Protocolo | SOAP 1.1 / 1.2 sobre HTTPS |
|---|---|
| Servicio | FactWSFront, en el servidor dedicado de MYSuite Grandes Asíncrono |
| Operación | RequestTransaction |
| Namespace | http://www.fact.com.mx/schema/ws |
| SOAPAction | http://www.fact.com.mx/schema/ws/RequestTransaction |
Valor <Transaction> |
ASYNC_RETRIEVE_DOCUMENT |
| Naturaleza | Consulta. No modifica la solicitud ni el comprobante, pero sí genera enlaces nuevos en cada llamada |
| Ambiente | URL |
|---|---|
| Pruebas | https://async.mysuitetest.com/factwsfront.asmx |
| Producción | https://async.mysuitecfdi.com/factwsfront.asmx |
Esta modalidad no usa token: las credenciales viajan en cada petición.
| Campo | Tipo | Obligatorio | Formato | Descripción |
|---|---|---|---|---|
Requestor |
GUID | Sí | GUID | Dato que proporciona MYSuite, ligado a la seguridad de la transacción, la autenticación y autorización |
Country |
string | Sí | Valor fijo MX |
Código de país de la operación |
Entity |
string | Sí | RFC (12–13 caracteres) | RFC del emisor del comprobante. Delimita el alcance de la recuperación. En ambiente de test es JES900109Q90 |
User |
GUID | Sí | GUID | Identificador del usuario de la integración, colocar el valor del Requestor proporcionado por MYSuite |
UserName |
string | Sí | País.RFC.usuario |
Nombre de usuario. Ejemplo: MX.JES900109Q90.Jan |
| Nombre | Tipo | Obligatorio | Límite | Formato | Descripción |
|---|---|---|---|---|---|
Data1 |
string | Sí | 36 | GUID, texto plano | Identificador de la solicitud, tal como lo devolvió ASYNC_CONVERT_NATIVE_XML en su ResponseData1. |
Data2 |
string | No | — | Vacío | Sin uso en esta transacción. El nodo debe existir y enviarse vacío |
Data3 |
string | No | — | Vacío | Sin uso en esta transacción. El nodo debe existir y enviarse vacío. |
Dictionary. El identificador de solicitud ya determina de qué comprobante se trata.Un valor en Data1, sin estructura y sin codificar. Data2 y Data3 se envían vacíos.
<?xml version="1.0" encoding="utf-8"?>
<soap:Envelope xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:xsd="http://www.w3.org/2001/XMLSchema" xmlns:soap="http://schemas.xmlsoap.org/soap/envelope/">
<soap:Body>
<RequestTransaction xmlns="http://www.fact.com.mx/schema/ws">
<Requestor>0c320b03-d4f1-47bc-9fb4-77995f9bf33e</Requestor>
<Transaction>ASYNC_RETRIEVE_DOCUMENT</Transaction>
<Country>MX</Country>
<Entity>JES900109Q90</Entity>
<User>0c320b03-d4f1-47bc-9fb4-77995f9bf33e</User>
<UserName>MX.JES900109Q90.Jan</UserName>
<Data1>5a14e1e6-0c2a-4a74-8b04-fe7a56aa1470</Data1>
<Data2></Data2>
<Data3></Data3>
</RequestTransaction>
</soap:Body>
</soap:Envelope><soap:Envelope xmlns:soap="http://schemas.xmlsoap.org/soap/envelope/" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:xsd="http://www.w3.org/2001/XMLSchema">
<soap:Body>
<RequestTransactionResponse xmlns="http://www.fact.com.mx/schema/ws">
<RequestTransactionResult>
<Request>
<Requestor>00000000-0000-0000-0000-000000000000</Requestor>
<RequestorActive>true</RequestorActive>
<Transaction>ASYNC_RETRIEVE_DOCUMENT</Transaction>
<Country>MX</Country>
<Entity>JES900109Q90</Entity>
<User>00000000-0000-0000-0000-000000000000</User>
<UserName>0c320b03-d4f1-47bc-9fb4-77995f9bf33e</UserName>
<Id>d1e473c2-76b1-43af-badf-62d3f6960220</Id>
<TimeStamp>2026-09-22T11:39:31.7138994-06:00</TimeStamp>
</Request>
<Response>
<Result>true</Result>
<TimeStamp>2026-09-22T11:39:32.1366182-06:00</TimeStamp>
<LastResult/>
<Code>1</Code>
<Description/>
<Hint/>
<Data>6157 d1e473c2-76b1-43af-badf-62d3f6960220</Data>
<Processor>TEST-BACK03</Processor>
<Identifier>
<Country>MX</Country>
<Entity>JES900109Q90</Entity>
<FiscalName>JIMENEZ ESTRADA SALAS A A</FiscalName>
<AYear>0</AYear>
<ANumber/>
<Batch/>
<Serial/>
<DocumentGUID>dcabb5a8-93bd-4d9b-a3bc-dcf285dd2541</DocumentGUID>
<IssuedTimeStamp>2026-09-18T10:45:20</IssuedTimeStamp>
<EnrolledTimeStamp>2026-09-18T10:45:32</EnrolledTimeStamp>
<PaidTimeStamp/>
<CancelledTimeStamp/>
<InternalID/>
<BatchID/>
<BatchTimeStamp/>
<BatchRequestorCountry/>
<BatchRequestorEntity/>
<BatchPosition/>
<ReceiverCountry>MX</ReceiverCountry>
<ReceiverEntity>JES900109Q90</ReceiverEntity>
<ReceiverTaxID/>
<ReceiverName>JIMENEZ ESTRADA SALAS A A</ReceiverName>
<ClaveAgente/>
<NumeroDePoliza/>
<Currency>MXN</Currency>
<TotalAmount>0.00</TotalAmount>
<Type1>ingreso</Type1>
<Type2>FACTURA</Type2>
<SuggestedFileName>JES900109Q90___JES900109Q90</SuggestedFileName>
<SuggestedFileName2>18092026____</SuggestedFileName2>
</Identifier>
</Response>
<ResponseData>
<ResponseData1>aHR0cHM6Ly9zbWFydGRhdGFzdG9yYWdldGVzdC5ibG9iLmNvcmUud2luZG93cy5uZXQveG1sL0VtaXRpZG9zLzIwMjYvMDkvSkVTOTAwMTA5UTkwL2RjYWJiNWE4LTkzYmQtNGQ5Yi1hM2JjLWRjZjI4NWRkMjU0MS54bWw/c3Y9MjAxOC0wMy0yOCZzcj1iJnNpZz1HWWdzZ3E1bmhuNiUyRjF5SGMwR1owUWNHJTJCbFRPRTdhTlVwNmhFdmdJQnJwRSUzRCZzdD0yMDI2LTA5LTIyVDE3JTNBMzQlM0EzMlomc2U9MjAyNi0wOS0yOVQxNyUzQTM5JTNBMzJaJnNwPXJ3</ResponseData1>
<ResponseData2/>
<ResponseData3>aHR0cHM6Ly9zbWFydGRhdGFzdG9yYWdldGVzdC5ibG9iLmNvcmUud2luZG93cy5uZXQvcGRmL0VtaXRpZG9zLzIwMjYvMDkvSkVTOTAwMTA5UTkwL2RjYWJiNWE4LTkzYmQtNGQ5Yi1hM2JjLWRjZjI4NWRkMjU0MS5wZGY/c3Y9MjAxOC0wMy0yOCZzcj1iJnNpZz1HVldUcDh1RSUyRk5LbUhoY1V6SlBPOUI4JTJCakZ3cG52b3JDJTJCUjhmNmcwQ2kwJTNEJnN0PTIwMjYtMDktMjJUMTclM0EzNCUzQTMyWiZzZT0yMDI2LTA5LTI5VDE3JTNBMzklM0EzMlomc3A9cnc=</ResponseData3>
</ResponseData>
</RequestTransactionResult>
</RequestTransactionResponse>
</soap:Body>
</soap:Envelope>
La respuesta tiene la misma forma que la de RETRIEVE_DOCUMENT, con tres diferencias que se detallan después.
| Bloque | Elemento | Contenido |
|---|---|---|
Request |
Eco de los parámetros de identidad | Devuelve Transaction, Country, Entity y UserName |
RequestorActive |
Indica si el solicitante está activo | |
Id · TimeStamp |
Identificador de la operación y momento de recepción | |
Response |
Result |
true cuando la recuperación fue exitosa |
Code |
Código de resultado. Ver apartado 10 | |
TimeStamp |
Momento en que concluyó el procesamiento | |
LastResult · Description · Hint |
Vacíos en recuperación exitosa. Ver apartado 9 | |
Data · Processor |
Referencia interna del procesamiento y Servidor que atendió la solicitud | |
ResponseData |
ResponseData1 |
Enlace al archivo ZIP que contiene el XML del comprobante, codificado en Base64 |
ResponseData2 |
Vacío | |
ResponseData3 |
Enlace al archivo ZIP que contiene el PDF del comprobante, codificado en Base64 |
RETRIEVE_DOCUMENT| Aspecto | RETRIEVE_DOCUMENT |
ASYNC_RETRIEVE_DOCUMENT |
|---|---|---|
| Formatos | Se piden en la entrada Formats del Dictionary |
Siempre devuelve XML y PDF. El único parámetro es el identificador de la solicitud |
ResponseData1 |
Contenido del XML, en Base64 | Enlace al ZIP que contiene el XML, en Base64 |
ResponseData3 |
Contenido del PDF, en Base64 | Enlace al ZIP que contiene el PDF, en Base64 |
RETRIEVE_DOCUMENT va a decodificar correctamente el Base64 y guardar el resultado como si fuera un XML o un PDF. No habrá error: habrá un archivo que contiene una dirección web. Hay que añadir dos pasos que en el servicio normal no existen: descargar y descomprimir.Identifier
Es el mismo conjunto de elementos que devuelve RETRIEVE_DOCUMENT, con los datos del comprobante generado:
| Elemento | Contenido |
|---|---|
DocumentGUID |
Folio Fiscal (UUID) del CFDI generado |
Country · Entity · FiscalName |
País, RFC y razón social del emisor |
Batch · Serial |
Serie y folio del comprobante |
IssuedTimeStamp · EnrolledTimeStamp |
Fecha de emisión y de registro en MYSuite |
InternalID |
Número interno registrado para el comprobante |
ReceiverCountry · ReceiverEntity · ReceiverName |
Datos del receptor |
Currency · TotalAmount |
Moneda e importe total |
Type1 · Type2 |
Type1 Tipo de Comprobante SAT; Type2 Tipo de Comprobante MYSuite |
SuggestedFileName · SuggestedFileName2 |
Nombres sugeridos para guardar los archivos |
PaidTimeStamp · CancelledTimeStamp y nodos de lote |
Llegan vacíos en la recuperación individual |
El sobre es el mismo del apartado 8. Cambia el contenido de Response y las cargas llegan vacías.
| Elemento | Contenido en error |
|---|---|
Result |
false: la recuperación no se pudo ejecutar |
Code |
Código del error. Ver apartado 10 |
LastResult |
Identificador simbólico del error. Es el valor más estable para ramificar tu lógica |
Description · Hint |
Mensaje del error y sugerencia de corrección |
Data |
Bloque de diagnóstico. Dato a incluir al reportar la incidencia a Soporte |
Processor |
Servidor que atendió la solicitud. Dato a incluir al reportar la incidencia a Soporte |
ResponseData1 · ResponseData3 |
Vacíos |
Result = false y HTTP 200. Evalúa siempre Result y no asumas éxito por el código de estado HTTP.ASYNC_CONVERT_VERIFY te dio Status igual a 2, el CFDI está emitido y certificado ante el SAT aunque esta recuperación falle. Reintenta la recuperación; no vuelvas a encolar la solicitud.| Aspecto | Valor |
|---|---|
| Comprobantes por llamada | Uno |
| Formatos devueltos | Siempre XML y PDF. No es configurable |
| Forma de entrega | Enlaces a archivos ZIP en la nube, no el contenido de los archivos |
| Vigencia de los enlaces | 5 días |
| Persistencia de los enlaces | Ninguna. La plataforma no los guarda: cada llamada genera unos nuevos, con 5 días de vigencia a partir de ese momento |
| Enlaces anteriores | Los enlaces de una llamada previa no siguen funcionando después de generar unos nuevos |
| Idempotencia | No modifica la solicitud ni el comprobante, pero no es una consulta inocua: cada llamada genera enlaces nuevos |
| Autenticación de los enlaces | La descarga no requiere credenciales |
| Tamaño de los archivos | El tamaño esperado del ZIP estará en función del tamaño del XML nativo enviado |
| Contenido de cada ZIP | Cada ZIP contiene un solo archivo |
| Retención del comprobante | Año actual y 5 años hacía atrás. |
| Timeout | 60 segundos en servidor front |
CANCEL_DOCUMENT_3 y su estado fiscal se consulta con CONSULTAR_DOCUMENTO, como cualquier otro CFDI.Problema. El contenido de ResponseData1, una vez decodificado, no se parece a un comprobante.
Entorno. MYSuite Grandes Asíncrono · SOAP · integraciones que reutilizan el código de RETRIEVE_DOCUMENT.
Resolución. Lo que decodificaste es una dirección web, no un archivo. Úsala para descargar por HTTP el ZIP correspondiente y descomprímelo para obtener el XML. Lo mismo aplica a ResponseData3 con el PDF.
Causa. Los nodos son los mismos que en el servicio normal, pero su contenido cambió: allí viaja el archivo, aquí el enlace al archivo. Es una diferencia que no produce error, solo un resultado inservible.
Problema. Una dirección de descarga que antes servía devuelve error o no encuentra el archivo.
Entorno. MYSuite Grandes Asíncrono · SOAP · procesos que guardan enlaces en lugar de archivos.
Resolución. Los enlaces tienen cinco días de vigencia. Vuelve a llamar a esta transacción con el identificador de solicitud y obtendrás unos nuevos, también con cinco días. Cambia el diseño para guardar los archivos descargados y no los enlaces: guardar un enlace es guardar algo que caduca.
Causa. La plataforma no conserva los enlaces entregados y los genera en cada llamada.
Problema. El archivo obtenido del enlace no es reconocido como XML ni como PDF.
Entorno. MYSuite Grandes Asíncrono · SOAP · primera implementación del flujo.
Resolución. Los enlaces apuntan a archivos ZIP. Descomprime antes de intentar abrir el contenido, y prevé ese paso en tu integración: no existe en el servicio normal, donde el archivo llega directo en la respuesta.
Causa. La compresión reduce el peso de archivos que pueden ser considerables, pero añade un paso que es la descompresión.
Problema. El proceso descarga un PDF que no va a usar.
Entorno. MYSuite Grandes Asíncrono · SOAP · integraciones que solo archivan el comprobante fiscal.
Resolución. La transacción siempre genera los dos enlaces y no acepta un parámetro de formatos. Nada te obliga a descargar los dos: decodifica solo ResponseData1 y descarga únicamente ese ZIP. El enlace del PDF puedes ignorarlo.
Causa. El diseño entrega enlaces y no contenido, así que generarlos no cuesta transferencia. La decisión de qué descargar queda de tu lado.
Problema. La recuperación falla para una solicitud que sí fue aceptada al encolarse.
Entorno. MYSuite Grandes Asíncrono · SOAP · procesos que llaman sin verificar el estado.
Resolución. Consulta primero con ASYNC_CONVERT_VERIFY. Si el estado es 1 el comprobante aún no existe y hay que esperar; si es 3 la emisión falló y no hay nada que recuperar, sino un error que corregir antes de volver a encolar. Solo con estado 2 tiene sentido llamar aquí.
Causa. Que la solicitud haya sido aceptada al encolarse no significa que el comprobante exista: son dos momentos distintos del ciclo asíncrono.
Problema. La llamada al servicio funciona, pero la descarga desde el enlace es bloqueada.
Entorno. MYSuite Grandes Asíncrono · SOAP · clientes con salida a internet restringida por firewall.
Resolución. Los archivos no residen en el mismo dominio que el servicio web: están en un almacenamiento en la nube. Autoriza en tu firewall la salida hacia ese dominio, además de la que ya tienes hacia el endpoint asíncrono.
Un XML nativo puede llegar a 70 MB en producción, y el CFDI resultante es de un orden parecido. Devolver eso dentro de un sobre SOAP significaría transmitir decenas de megabytes codificados en Base64 —lo que añade cerca de un tercio al tamaño— en una sola respuesta, con todo lo que eso implica de memoria, tiempo y fragilidad. Los enlaces trasladan la descarga a un canal hecho para eso: HTTP directo contra un almacenamiento en la nube, reanudable y sin la sobrecarga del sobre.
Reutilizar la forma de la respuesta ahorra trabajo a quien ya integró el servicio normal: los metadatos están en el mismo sitio y con los mismos nombres. Pero la reutilización se detuvo a medias, porque dos nodos conservan el nombre y cambian de significado. Es la clase de diferencia más costosa de detectar: no rompe la compilación ni lanza excepciones, y el ERP termina archivando ficheros que contienen una URL. Vale la pena escribir la capa de lectura de esta transacción aparte, aunque la tentación de copiar la del servicio normal sea fuerte.
Un enlace permanente a un archivo fiscal es un riesgo: cualquiera que lo obtenga accede al comprobante. La vigencia limitada acota esa exposición. La contrapartida es que traslada al cliente una responsabilidad que en el servicio normal no existe: guardar el enlace no sirve de nada, hay que guardar el archivo. Un proceso que almacene direcciones en la base de datos del ERP funcionará bien durante cinco días y empezará a fallar después, sin que nada haya cambiado en el código.
Significa que perder un enlace no es grave: se vuelve a pedir. Pero también significa que esta transacción no es del todo inocua, a diferencia de las demás consultas de la plataforma. No modifica el comprobante, pero sí produce un efecto —enlaces nuevos— cada vez que se invoca. Por eso conviene llamarla cuando se vaya a descargar, y no ponerla dentro de un proceso que la ejecute por rutina.
En RETRIEVE_DOCUMENT pedir solo el XML ahorra transferencia real, porque el PDF viaja dentro de la respuesta. Aquí no: lo que viaja son dos cadenas cortas, y generar la segunda no cuesta nada. Que la transacción no ofrezca el parámetro es coherente con eso, y la decisión de qué descargar queda donde ahora importa, que es en tu cliente.
Con esta transacción el ciclo asíncrono queda completo y vale la pena verlo entero: ASYNC_CONVERT_NATIVE_XML encola y devuelve un identificador, ASYNC_CONVERT_VERIFY informa del avance y entrega los datos fiscales, y ASYNC_RETRIEVE_DOCUMENT entrega los archivos. Tres llamadas para lo que en el servicio normal es una, a cambio de poder emitir comprobantes que el servicio normal rechaza. Ninguna de las tres sirve sola, y una integración que implemente solo las dos primeras se queda con un comprobante que no puede archivar.
Conviene tenerlo presente para no reaccionar de más. Si ASYNC_CONVERT_VERIFY confirmó el estado 2, el CFDI está timbrado ante el SAT con todos sus efectos. Un fallo al recuperar los archivos es un problema de acceso, no de emisión: se reintenta la recuperación, nunca el encolamiento. Volver a encolar produciría un segundo comprobante —o un código 3196 si conservaste el número interno— y ninguna de las dos cosas es lo que hace falta.