Qué hace: devuelve los metadatos de una solicitud asíncrona que encolaste antes. Te dice si la solicitud sigue pendiente, si se procesó con éxito o si falló, y cuando se proceso con éxito te entrega el Folio Fiscal, la Serie, el Folio y el Año del CFDI certificado.
Cuándo se usa: después de encolar con ASYNC_CONVERT_NATIVE_XML, para saber en qué punto va el procesamiento y decidir si ya puedes recuperar los archivos.
Cuándo no usarla: para obtener el XML o el PDF del comprobante, que se piden con ASYNC_RETRIEVE_DOCUMENT. Esta transacción entrega metadatos, no archivos.
Uuid de la respuesta entregada en ResponseData1 y ResponseData2 no es el Folio Fiscal. Es el identificador de la solicitud asíncrona, el mismo que enviaste en Data1. El Folio Fiscal del CFDI viene en DocumentGUID.| Si tu integración… | Tu artículo es... |
|---|---|
| Necesita saber en qué estado va una solicitud asíncrona, por SOAP | Este artículo |
| Va a encolar un comprobante de más de 1 MB | ASYNC_CONVERT_NATIVE_XML |
| Ya sabe que la solicitud terminó bien y necesita los archivos | ASYNC_RETRIEVE_DOCUMENT |
| Emite comprobantes de menos de 1 MB | CONVERT_NATIVE_XML — CFDI + Timbrado (SOAP) |
| Necesita el estado fiscal de un CFDI ya emitido, vigente o cancelado | CONSULTAR_DOCUMENTO |
Requestor y Entity.ASYNC_CONVERT_NATIVE_XML en ResponseData1.Transaction con valor ASYNC_CONVERT_VERIFY, 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 si trabajas con XML, ResponseData2 si trabajas con JSON. Traen lo mismo.Status, que es el que gobierna todo lo demás.DocumentGUID, Year, Batch y Serial si el estado es 2, y regístralos en tu ERP como los datos fiscales del comprobante.ASYNC_RETRIEVE_DOCUMENT.ErrorMsg desde Base64 y revisa el log que llega en ResponseData3, también en Base64.| 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_CONVERT_VERIFY |
| Naturaleza | Consulta. No modifica la solicitud ni el comprobante |
| Ambiente | URL |
|---|---|
| Pruebas | https://async.mysuitetest.com/factwsfront.asmx |
| Producción | https://async.mysuitecfdi.com/factwsfront.asmx |
Consulta en el mismo ambiente en que encolaste: un identificador de solicitud de pruebas no existe en producción.
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 de la solicitud consultada. En ambiente de test utiliza JES900109Q90 |
User |
GUID | Sí | GUID | Identificador del usuario de la integración, coloca 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 |
ASYNC_CONVERT_NATIVE_XML responderá con el código 3196 y te devolverá el identificador existente.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_CONVERT_VERIFY</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_CONVERT_VERIFY</Transaction>
<Country>MX</Country>
<Entity>JES900109Q90</Entity>
<User>00000000-0000-0000-0000-000000000000</User>
<UserName>0c320b03-d4f1-47bc-9fb4-77995f9bf33e</UserName>
<Id>7b7b6a65-5f61-400c-bfed-2bfcf5dea88d</Id>
<TimeStamp>2026-09-18T13:26:29.159772-06:00</TimeStamp>
</Request>
<Response>
<Result>true</Result>
<TimeStamp>2026-09-18T13:26:29.1832811-06:00</TimeStamp>
<LastResult/>
<Code>1</Code>
<Description/>
<Hint/>
<Data>7761 7b7b6a65-5f61-400c-bfed-2bfcf5dea88d</Data>
<Processor>TEST-BACK03</Processor>
</Response>
<ResponseData>
<ResponseData1>PD94bWwgdmVyc2lvbj0iMS4wIiBlbmNvZGluZz0idXRmLTgiPz4NCjxBc3luY1JlcXVlc3QgeG1sbnM6eHNpPSJodHRwOi8vd3d3LnczLm9yZy8yMDAxL1hNTFNjaGVtYS1pbnN0YW5jZSIgeG1sbnM6eHNkPSJodHRwOi8vd3d3LnczLm9yZy8yMDAxL1hNTFNjaGVtYSI+DQogIDxFbnRpdHk+SkVTOTAwMTA5UTkwPC9FbnRpdHk+DQogIDxVdWlkPjVhMTRlMWU2LTBjMmEtNGE3NC04YjA0LWZlN2E1NmFhMTQ3MDwvVXVpZD4NCiAgPEludGVybmFsSUQ+SURfMTAwMTwvSW50ZXJuYWxJRD4NCiAgPEVucm9sbGVkVGltZVN0YW1wPjIwMjYtMDktMThUMTA6NDQ6NTM8L0Vucm9sbGVkVGltZVN0YW1wPg0KICA8U3RhdHVzPjI8L1N0YXR1cz4NCiAgPERvY3VtZW50R1VJRD5kY2FiYjVhOC05M2JkLTRkOWItYTNiYy1kY2YyODVkZDI1NDE8L0RvY3VtZW50R1VJRD4NCiAgPFllYXI+MjAyNjwvWWVhcj4NCiAgPEJhdGNoPklDQkNfQ0hFUVVFUzwvQmF0Y2g+DQogIDxTZXJpYWw+MTAxPC9TZXJpYWw+DQogIDxFcnJvck1zZyAvPg0KPC9Bc3luY1JlcXVlc3Q+</ResponseData1>
<ResponseData2>eyJFbnRpdHkiOiJKRVM5MDAxMDlROTAiLCJVdWlkIjoiNWExNGUxZTYtMGMyYS00YTc0LThiMDQtZmU3YTU2YWExNDcwIiwiSW50ZXJuYWxJRCI6IklEXzEwMDEiLCJFbnJvbGxlZFRpbWVTdGFtcCI6IlwvRGF0ZSgxNzg5NzQ5ODkzMDAwKVwvIiwiU3RhdHVzIjoyLCJEb2N1bWVudEdVSUQiOiJkY2FiYjVhOC05M2JkLTRkOWItYTNiYy1kY2YyODVkZDI1NDEiLCJZZWFyIjoyMDI2LCJCYXRjaCI6IklDQkNfQ0hFUVVFUyIsIlNlcmlhbCI6IjEwMSIsIkVycm9yTXNnIjoiIn0=</ResponseData2>
<ResponseData3/>
</ResponseData>
</RequestTransactionResult>
</RequestTransactionResponse>
</soap:Body>
</soap:Envelope>
La respuesta se organiza en tres bloques dentro de RequestTransactionResult.
| 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 consulta se ejecutó. No dice nada sobre el estado de la solicitud: eso se lee en Status |
Code |
Código de resultado. Ver apartado 10 | |
TimeStamp |
Momento en que concluyó el procesamiento de la consulta | |
LastResult · Description · Hint |
Vacíos en consulta exitosa. Ver apartado 9 | |
Data · Processor |
Referencia interna del procesamiento y Servidor que atendió la solicitud | |
ResponseData |
ResponseData1 |
Metadatos de la solicitud en formato XML, codificados en Base64 |
ResponseData2 |
Los mismos metadatos en formato JSON, codificados en Base64 | |
ResponseData3 |
Solo cuando Status = 3: log en Base64 con el motivo por el que no se pudo emitir la solicitud |
| Campo | Contenido | Cuándo tiene valor |
|---|---|---|
Entity |
RFC especificado en la transacción | Siempre |
Uuid |
Identificador de la solicitud, es decir, lo que enviaste en Data1. No es el Folio Fiscal |
Siempre |
InternalID |
Número interno que especificaste al encolar, en Data2 de ASYNC_CONVERT_NATIVE_XML |
Siempre |
EnrolledTimeStamp |
Fecha y hora en que se registró la solicitud | Siempre |
Status |
Estado de la solicitud. Ver tabla siguiente | Siempre |
DocumentGUID |
Folio Fiscal (UUID) del CFDI generado | Solo con Status = 2 |
Year |
Año de la fecha de emisión del CFDI generado | Solo con Status = 2 |
Batch |
Serie del CFDI generado. Puede llegar vacío si el comprobante no lleva serie | Solo con Status = 2 |
Serial |
Folio del CFDI generado | Solo con Status = 2 |
ErrorMsg |
Texto del error ocurrido. Se devuelve codificado en Base64 | Solo con Status = 3 |
Status
| Valor | Significado | Qué hacer |
|---|---|---|
| 1 | Pendiente de procesar | Esperar y volver a consultar |
| 2 | Procesado con éxito | Tomar los datos fiscales y recuperar los archivos con ASYNC_RETRIEVE_DOCUMENT |
| 3 | Procesado con error | Leer ErrorMsg y el log de ResponseData3, corregir y encolar de nuevo |
ResponseData1
<?xml version="1.0" encoding="utf-8"?>
<AsyncRequest xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:xsd="http://www.w3.org/2001/XMLSchema">
<Entity>[RFC del emisor]</Entity>
<Uuid>[identificador de la solicitud]</Uuid>
<InternalID>[número interno del ERP]</InternalID>
<EnrolledTimeStamp>[fecha ISO 8601]</EnrolledTimeStamp>
<Status>[1, 2 o 3]</Status>
<DocumentGUID>[Folio Fiscal del CFDI]</DocumentGUID>
<Year>[año de emisión]</Year>
<Batch>[serie]</Batch>
<Serial>[folio]</Serial>
</AsyncRequest>ResponseData2
{
"Entity": "[RFC del emisor]",
"Uuid": "[identificador de la solicitud]",
"InternalID": "[número interno del ERP]",
"EnrolledTimeStamp": "/Date(1543513755000)/",
"Status": 2,
"DocumentGUID": "[Folio Fiscal del CFDI]",
"Year": 2018,
"Batch": "",
"Serial": "8688",
"ErrorMsg": null
}2018-11-29T11:49:15) y el JSON el formato heredado de .NET (/Date(1543513755000)/), que la mayoría de los analizadores no convierte solo.null.Status y Year llegan como números y el resto como cadenas; en XML todo es texto.ErrorMsg lleva doble codificación. Viaja en Base64 dentro de una carga que ya viene en Base64. Para leerlo tienes que decodificar dos veces: primero ResponseData1 o ResponseData2, y después el contenido del campo.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 consulta 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 · ResponseData2 |
Vacíos |
Result dice si la consulta se ejecutó. Status dice cómo va la solicitud. Un procesamiento fallido se reporta con Result = true y Status = 3: la consulta funcionó perfectamente y lo que informa es un fracaso en el procesamiento.| Aspecto | Valor |
|---|---|
| Solicitudes por llamada | Una |
| Idempotencia | Es una transacción de consulta: no modifica la solicitud ni el comprobante, por lo que reintentarla no tiene efectos colaterales |
| Tiempo hasta el estado 2 | Variable, en función del tamaño de la información enviada al encolar y del número de solicitudes encoladas. |
| Frecuencia de sondeo recomendada | Cada 20-25 minutos (posteriores a la solicitud de certificación) |
| Caducidad de la solicitud | Año actual y hasta 5 años hacía atrás |
| Reenvío tras un estado 3 | Se puede volver a encolar con el mismo número interno tras una solicitud fallida, o si hace falta uno nuevo. Es una pregunta operativa central: el número interno ya está registrado y podría provocar un código 3196 al reintentar. *** |
| Consumo de folios | No |
| Timeout | 60 segundos en servidor front |
DocumentGUID con Status = 2 es el del CFDI ya timbrado ante el SAT, con todos sus efectos fiscales.CONSULTAR_DOCUMENTO.Problema. La solicitud permanece en estado pendiente después de varias consultas.
Entorno. MYSuite Grandes Asíncrono · SOAP · comprobantes de gran tamaño.
Resolución. El estado 1 significa que la solicitud está encolada y aún no se procesa. El tiempo depende del tamaño de lo que enviaste y del número de solicitudes encoladas, así que un archivo cercano al límite del ambiente tarda bastante más que uno pequeño. Espacia las consultas en lugar de sondear en ciclo cerrado, y si el tiempo se aparta mucho de lo que sueles observar, reporta a Soporte incluyendo el identificador de solicitud y el elemento Id de la respuesta.
Problema. La solicitud terminó con error y el campo de mensaje parece ilegible.
Entorno. MYSuite Grandes Asíncrono · SOAP · solicitudes rechazadas.
Resolución. Con estado 3 tienes dos fuentes de diagnóstico. ErrorMsg, dentro de los metadatos, viene codificado en Base64, así que hay que decodificarlo aparte después de haber decodificado la carga que lo contiene. Y ResponseData3 trae un log completo, también en Base64, con el motivo por el que no se pudo emitir la solicitud. Empieza por el log.
Causa. La doble codificación no es evidente y suele interpretarse como un texto corrupto.
Problema. El campo EnrolledTimeStamp del JSON llega con un formato que el analizador no reconoce como fecha.
Entorno. MYSuite Grandes Asíncrono · SOAP · integraciones que leen ResponseData2.
Resolución. El JSON entrega la fecha en el formato heredado de .NET, /Date(1543513755000)/, donde el número son milisegundos desde el 1 de enero de 1970 en UTC. Extrae el número y conviértelo, o lee ResponseData1, que entrega la misma fecha en ISO 8601 y no necesita tratamiento especial.
Causa. Los dos formatos de salida no son equivalentes campo por campo, aunque contengan la misma información.
Problema. La consulta no encuentra nada al enviar el UUID del comprobante.
Entorno. MYSuite Grandes Asíncrono · SOAP · integraciones nuevas.
Resolución. Data1 espera el identificador de la solicitud asíncrona, no el Folio Fiscal del CFDI ni tu número interno. Guarda el identificador en cuanto lo recibas al encolar. Si lo perdiste, reenvía la solicitud original: el código 3196 te devolverá el identificador existente sin generar un comprobante nuevo.
Causa. El ciclo asíncrono maneja tres identificadores distintos —tu número interno, el identificador de solicitud y el Folio Fiscal— y solo el segundo sirve aquí. Que el campo de respuesta se llame Uuid cuando contiene el identificador de solicitud contribuye a la confusión.
Problema. DocumentGUID, Year, Batch y Serial llegan sin contenido.
Entorno. MYSuite Grandes Asíncrono · SOAP · sondeo del estado.
Resolución. Esos cuatro campos solo tienen valor cuando Status es 2. Lee siempre Status primero y ramifica a partir de ahí, en lugar de comprobar si los campos traen contenido. Ten en cuenta además que Batch puede llegar vacío incluso con estado 2, porque la serie es opcional en el CFDI.
Causa. La estructura de respuesta es la misma en los tres estados y lo que cambia es qué campos se pueblan.
Problema. El proceso da por buena una solicitud que en realidad falló.
Entorno. MYSuite Grandes Asíncrono · SOAP · integraciones que reutilizan la lógica del servicio síncrono.
Resolución. Aquí hay dos niveles. Result indica si la consulta se ejecutó; Status indica cómo va la solicitud. Una solicitud fallida llega como Result = true con Status = 3, porque la consulta funcionó y lo que informa es el fracaso del procesamiento. Tu lógica de negocio debe decidir por Status.
Causa. En el servicio síncrono Result sí es el resultado de la emisión. En el asíncrono la emisión ocurre después de la llamada, así que ningún Result puede informar sobre ella.
En el servicio síncrono la respuesta a «¿se emitió?» llega en la misma llamada. Aquí no puede: el procesamiento ocurre después de que la conexión se cerró. Esta transacción es la que devuelve esa respuesta, y con ella el ciclo queda completo: ASYNC_CONVERT_NATIVE_XML encola, ASYNC_CONVERT_VERIFY informa y ASYNC_RETRIEVE_DOCUMENT entrega. Ninguna de las tres sirve sola.
Conviene tenerlos claros porque se parecen y se usan en momentos distintos. El número interno lo generas tú y sirve para que MYSuite detecte reenvíos. El identificador de solicitud lo genera MYSuite al encolar y es la llave de todo el seguimiento. El Folio Fiscal aparece al final, cuando el CFDI existe, y es el identificador fiscal ante el SAT. Guarda los tres en campos distintos de tu ERP: cada uno responde una pregunta que los otros no pueden.
En la respuesta, el campo Uuid contiene el identificador de la solicitud y el Folio Fiscal viaja en DocumentGUID. Es lo contrario de lo que sugiere la costumbre: en el resto de la plataforma «UUID» significa Folio Fiscal y DocumentGUID también. Aquí ambos nombres apuntan a cosas distintas, y es un buen sitio donde un mapeo automático puede equivocarse sin dar error.
El servicio entrega los metadatos en XML y en JSON para que cada cliente use el que le acomode, sin obligar a nadie a incorporar un analizador que no tenga. Conviene elegir uno al principio y no mezclarlos, porque una integración escrita contra el XML no funciona tal cual contra el JSON.
El estado 1 pide paciencia: la solicitud está en cola y el tiempo depende del tamaño. El estado 2 cierra bien el ciclo y entrega los datos fiscales. El estado 3 significa que el comprobante no llegó a emitirse, y ahí tienes dos fuentes de diagnóstico: el mensaje corto en ErrorMsg y el log completo en ResponseData3. Lo relevante del estado 3 es que no hay comprobante, así que no queda nada que cancelar ni que recuperar: hay que corregir el origen y volver a encolar.
Consultar en ciclo cerrado desperdicia recursos de ambos lados y no acelera nada. Lo razonable es espaciar las consultas y ajustar el intervalo al tamaño del archivo enviado, guardando en tu ERP el estado de cada solicitud para no volver a preguntar por las ya resueltas. Conviene además prever un límite de tiempo a partir del cual el proceso deja de sondear y escala a una persona, en lugar de quedarse preguntando indefinidamente.
Status describe el procesamiento dentro de MYSuite, no la situación del comprobante ante el SAT. Un CFDI con estado 2 puede estar cancelado más adelante, y eso no se refleja aquí. Para el estado fiscal está CONSULTAR_DOCUMENTO. Son dos preguntas distintas sobre el mismo comprobante.