Qué hace: encola una solicitud de generación/certificación de CFDI a partir de un XML nativo de gran tamaño. No te devuelve el comprobante, te devuelve el identificador de la solicitud que fue aceptada (con el que después consultas el avance y recuperas los archivos).
Cuándo se usa: cuando el XML nativo de MYSuite supera 1 MB de tamaño y el servicio síncrono lo rechaza. Es el caso de comprobantes con muchos conceptos o con addendas extensas.
Cuándo no usarla: cuando el archivo pesa menos de 1 MB. Ese caso va por CONVERT_NATIVE_XML en el servicio normal, y si lo envías aquí la transacción responde false.


| Si tu integración… | Tu artículo es... |
|---|---|
| Emite CFDI cuyo XML nativo supera 1 MB, por SOAP | Este artículo |
| Emite CFDI cuyo XML nativo pesa menos de 1 MB | CONVERT_NATIVE_XML — CFDI + Timbrado (SOAP) |
| Ya encoló una solicitud y necesita saber en qué va | ASYNC_CONVERT_VERIFY |
| Ya sabe que la solicitud terminó y necesita los archivos | ASYNC_RETRIEVE_DOCUMENT |
| Necesita recuperar un CFDI ordinario ya emitido | RETRIEVE_DOCUMENT — CFDI + Timbrado (SOAP) |
Requestor y Entity.Version con valor vigente.fx_2010_g.xsd, respetando el orden de los nodos.Transaction con valor ASYNC_CONVERT_NATIVE_XML, la cadena Base64 en Data1, tu identificador en Data2 en texto plano y Data3 vacío.RequestTransactionResponse.Result. Si es true, guarda el identificador de solicitud que viene en ResponseData1: lo vas a necesitar para todo lo demás.Result es false con código 3196: significa que ese número interno ya estaba registrado, y ResponseData1 te devuelve el identificador de la solicitud original. No reenvíes: continúa el flujo con ese identificador.ASYNC_CONVERT_VERIFY hasta que el estado deje de ser pendiente.ASYNC_RETRIEVE_DOCUMENT sólo cuando el estado sea 2, y descárgalos antes de que venzan los enlaces.| 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_NATIVE_XML |
| Naturaleza | Encolamiento. Registra la solicitud y devuelve su identificador; la emisión/certificación ocurre después |
| Patrón de interacción | solicitud → encolamiento → procesamiento → consulta → recuperación |
| Consumo | 1 folio del paquete vigente |
| Ambiente | URL | Tamaño admitido en Data1 |
|---|---|---|
| Pruebas | https://async.mysuitetest.com/factwsfront.asmx |
Mayor a 1 MB y hasta 2 MB |
| Producción | https://async.mysuitecfdi.com/factwsfront.asmx |
Mayor a 1 MB y hasta 70 MB |
En ambos ambientes se permite la distribución por correo de los comprobantes generados mediante solicitudes asíncronas.
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. Determina con qué CSD se sella, Usar JES900109Q90 en ambiente de test |
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í | Mínimo 1 MB. Máximo 2 MB en pruebas y 70 MB en producción. | Base64 | XML Nativo de MYSuite a partir del cual se generará/certificará el CFDI final, codificado en Base64 |
Data2 |
string | Sí | 50 caracteres | Texto plano | Número interno: identificador que distingue de manera única esta solicitud dentro de tu ERP. |
Data3 |
string | No | — | Vacío | Sin uso en esta transacción. El nodo debe existir y enviarse vacío |
Data1 por debajo de 1 MB devuelve Result = false, porque ese tipo de archivos debe ir por el servicio normal. Los dos servicios son mutuamente excluyentes por tamaño.
Un valor en texto plano, sin estructura y sin codificar. Lo generas tú y su única exigencia es la unicidad dentro de tu ERP.
NumeroInterno del XML nativo es opcional. Esa obligatoriedad es la que permite a la plataforma detectar reenvíos y evitar comprobantes duplicados.Sin estructura. Se envía vacío.
<?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_NATIVE_XML</Transaction>
<Country>MX</Country>
<Entity>JES900109Q90</Entity>
<User>0c320b03-d4f1-47bc-9fb4-77995f9bf33e</User>
<UserName>MX.JES900109Q90.Jan</UserName>
<Data1>Base64 del xml nativo de MYSuite a procesar de manera asíncrona</Data1>
<Data2>ID_1001</Data2>
<Data3></Data3>
</RequestTransaction>
</soap:Body>
</soap:Envelope><soap:Envelope xmlns:soap="http://www.w3.org/2003/05/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_NATIVE_XML</Transaction>
<Country>MX</Country>
<Entity>JES900109Q90</Entity>
<User>00000000-0000-0000-0000-000000000000</User>
<UserName>0c320b03-d4f1-47bc-9fb4-77995f9bf33e</UserName>
<Id>be558d0e-90ff-4805-a30c-cb1768a099ca</Id>
<TimeStamp>2026-09-18T11:08:56.8354389-06:00</TimeStamp>
</Request>
<Response>
<Result>true</Result>
<TimeStamp>2026-09-18T11:08:58.1043514-06:00</TimeStamp>
<LastResult/>
<Code>1</Code>
<Description/>
<Hint/>
<Data>10196 be558d0e-90ff-4805-a30c-cb1768a099ca</Data>
<Processor>TEST-BACK03</Processor>
</Response>
<ResponseData>
<ResponseData1>5a14e1e6-0c2a-4a74-8b04-fe7a56aa1470</ResponseData1>
<ResponseData2></ResponseData2>
<ResponseData3/>
</ResponseData>
</RequestTransactionResult>
</RequestTransactionResponse>
</soap:Body><soap:Envelope xmlns:soap="http://www.w3.org/2003/05/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_NATIVE_XML</Transaction>
<Country>MX</Country>
<Entity>JES900109Q90</Entity>
<User>00000000-0000-0000-0000-000000000000</User>
<UserName>0c320b03-d4f1-47bc-9fb4-77995f9bf33e</UserName>
<Id>001a97cf-17f6-44e4-ae60-67956b91eebb</Id>
<TimeStamp>2026-09-18T11:45:14.0117683-06:00</TimeStamp>
</Request>
<Response>
<Result>false</Result>
<TimeStamp>2026-09-18T11:45:14.1151241-06:00</TimeStamp>
<LastResult>TRANSACCION_ASINCRONA_YA_EXISTE</LastResult>
<Code>3196</Code>
<Description/>
<Hint/>
<Data>El número interno proporcionado ya se encuentra registrado. Consulte ResponseData1 para obtener el Id de la solicitud existente. Descripción: Sugerencia: Evento: 2026-09-18 11:45:14 TEST-BACK03 ASYNC_CONVERT_NATIVE_XML 3196 TRANSACCION_ASINCRONA_YA_EXISTE JES900109Q90 ASP 6211 001a97cf-17f6-44e4-ae60-67956b91eebb</Data>
<Processor>TEST-BACK03</Processor>
</Response>
<ResponseData>
<ResponseData1>5a14e1e6-0c2a-4a74-8b04-fe7a56aa1470</ResponseData1>
<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 solicitud fue aceptada y encolada. No significa que el CFDI esté generado |
Code |
Código de resultado. Ver apartado 10 | |
TimeStamp |
Momento en que concluyó el procesamiento de la solicitud | |
LastResult · Description · Hint |
Vacíos en solicitud aceptada. Ver apartado 9 | |
Data · Processor |
Referencia interna del procesamiento y Servidor que atendió la solicitud | |
ResponseData |
ResponseData1 |
Identificador de la solicitud aceptada, como cadena en formato GUID. Es el dato que necesitas para cualquier operación posterior sobre esta solicitud. Ejemplo de forma: fd339e5c-3685-4773-a3ea-be28c8b92dfe |
ResponseData2 |
llega vacío | |
ResponseData3 |
llega vacío |
ASYNC_CONVERT_VERIFY. Guarda ambos: son dos identificadores con propósitos distintos.El sobre es el mismo del apartado 8. Cambia el contenido de Response.
| Elemento | Contenido en error |
|---|---|
Result |
false: la solicitud no se encoló |
Code |
Código del error. Ver apartado 10 |
Description · Hint |
Mensaje del error y sugerencia de corrección |
Data |
Detalle del error. En el caso del código 3196 indica que el número interno proporcionado ya se encuentra registrado y remite a ResponseData1 |
Processor |
Servidor que atendió la solicitud |
ResponseData1 |
Excepción importante: en el error 3196 sí trae contenido, el identificador de la solicitud ya existente. |
Result = false y HTTP 200. Evalúa siempre Result y no asumas éxito por el código de estado HTTP.| Aspecto | Valor |
|---|---|
| Comprobantes por llamada | Uno |
Tamaño mínimo de Data1 |
Mayor a 1 MB. Por debajo, la transacción responde false |
Tamaño máximo de Data1 |
2 MB en pruebas - 70 MB en producción |
| Longitud del número interno | 50 caracteres |
| Tiempo de procesamiento | Variable: depende del número de solicitudes encoladas y del tamaño de la información enviada. |
| Protección antiduplicado | Incorporada mediante el número interno obligatorio y el código 3196 |
| Idempotencia | De hecho protegida: un reenvío con el mismo número interno no genera un segundo comprobante |
| Distribución por correo | Permitida para los comprobantes generados por solicitudes asíncronas |
| Vigencia de los enlaces de descarga | 5 días, y se generan de nuevo en cada llamada a ASYNC_RETRIEVE_DOCUMENT. No se guardan en la plataforma |
| Timeout de la llamada | 60 segundos en servidor front |
| Caducidad de la solicitud | El tiempo que permanece consultable una solicitud se encuentra entre el año actual y hasta 5 años hacía atrás. |
Problema. La transacción rechaza un XML nativo correcto y bien formado.
Entorno. MYSuite Grandes Asíncrono · SOAP · integraciones que envían comprobantes de tamaño variable.
Resolución. Mide el tamaño de lo que va en Data1. Si es menor a 1 MB, este servicio lo rechaza a propósito: ese comprobante debe ir por CONVERT_NATIVE_XML en el servicio normal. Implementa en tu ERP la bifurcación por tamaño antes de elegir a qué servicio llamar.
Causa. El límite tiene piso además de techo. Los dos servicios son mutuamente excluyentes: lo que acepta uno lo rechaza el otro.
Problema. Tras reenviar una solicitud que no había recibido respuesta, la transacción responde false con código 3196.
Entorno. MYSuite Grandes Asíncrono · SOAP · redes con latencia o cortes intermitentes.
Resolución. No es un problema: es la protección funcionando. Ese número interno ya estaba registrado, así que la solicitud original existe. Lee ResponseData1, que te devuelve el identificador de esa solicitud, y continúa con ASYNC_CONVERT_VERIFY para saber en qué estado quedó. No generes un número interno nuevo para reintentar: eso sí produciría un comprobante duplicado.
Causa. El número interno obligatorio permite a MYSuite reconocer el reenvío y devolverte la solicitud original en lugar de crear otra.
Problema. La petición falla al dirigirse al servicio normal de facturación.
Entorno. MYSuite Grandes Asíncrono · SOAP · integraciones que ya operaban el servicio síncrono.
Resolución. Este servicio corre en un servidor dedicado con web services propios: async.mysuitetest.com para pruebas y async.mysuitecfdi.com para producción. Configura ambas direcciones en tu ERP y selecciona la que corresponda al tamaño del comprobante.
Causa. La emisión de comprobantes grandes se atiende en infraestructura separada, precisamente para que no afecte el rendimiento del servicio normal.
Problema. La solicitud es rechazada al enviar valores de formato en Data2.
Entorno. MYSuite Grandes Asíncrono · SOAP · integraciones que reutilizan el código de CONVERT_NATIVE_XML.
Resolución. Aquí Data2 es tu identificador único de solicitud, obligatorio y de hasta 50 caracteres. No lleva formatos: en el flujo asíncrono la recuperación siempre devuelve XML y PDF, y eso se resuelve después con ASYNC_RETRIEVE_DOCUMENT.
Causa. Cada transacción define qué pone en cada nodo de datos. La similitud de nombre entre CONVERT_NATIVE_XML y ASYNC_CONVERT_NATIVE_XML induce a suponer un contrato común que no existe.
Problema. La respuesta no trae el comprobante ni el Folio Fiscal.
Entorno. MYSuite Grandes Asíncrono · SOAP · primera implementación del flujo asíncrono.
Resolución. Este servicio no emite en la misma llamada: encola. El GUID que recibes identifica tu solicitud dentro de la cola. Con él consultas el avance en ASYNC_CONVERT_VERIFY y, cuando el estado sea 2, obtienes el Folio Fiscal y recuperas los archivos con ASYNC_RETRIEVE_DOCUMENT.
Causa. Los comprobantes grandes tardan en procesarse, y mantener abierta la conexión durante ese tiempo no es viable. Por eso la respuesta inmediata es un acuse de encolamiento.
Problema. Un comprobante que en producción pesará decenas de megabytes es rechazado en el ambiente de pruebas.
Entorno. MYSuite Grandes Asíncrono · SOAP · ambiente de pruebas.
Resolución. El ambiente de pruebas admite hasta 2 MB; producción hasta 70 MB. Valida en pruebas la mecánica completa del flujo —encolar, consultar, recuperar, manejar el 3196— con un archivo de entre 1 y 2 MB, y reserva la validación de volumen para las primeras emisiones productivas.
Causa. El ambiente de pruebas está dimensionado para validar la integración, no para reproducir la carga real.
Un CFDI con miles de conceptos tarda en construirse, sellarse y timbrarse. Si esas emisiones compartieran servidor con las ordinarias, un solo comprobante grande podría degradar el servicio de todos los demás clientes. MYSuite lo resolvió apartando la carga pesada en infraestructura dedicada, y de ahí que este servicio tenga web services propios en lugar de ser una transacción más del servicio normal.
Que un archivo pequeño sea rechazado aquí puede parecer arbitrario, pero mantiene la separación limpia: cada servicio atiende exactamente el tipo de carga para el que fue dimensionado. Para quien integra, la consecuencia es que la decisión de ruta no es opcional: hay que medir el tamaño antes de cada emisión y elegir servicio. Un ERP que solo implemente uno de los dos va a fallar el día que aparezca un comprobante del otro lado de la línea.
El tiempo de procesamiento depende del tamaño del archivo, y puede ser largo. Mantener abierta una conexión HTTP durante ese tiempo es frágil: cualquier corte deja al cliente sin saber qué pasó, que es exactamente el problema que el flujo síncrono arrastra. El patrón asíncrono lo evita cerrando la conexión de inmediato con un acuse, y trasladando la espera a consultas posteriores que el cliente hace cuando quiere.
El GUID que devuelve esta transacción identifica tu solicitud dentro de la cola de MYSuite. El Folio Fiscal identifica el comprobante ante el SAT, y solo existe cuando la solicitud termina de procesarse con éxito. Son dos cosas distintas y conviene guardarlas en campos distintos del ERP: la primera te sirve para seguir el trámite, la segunda para todo lo fiscal que venga después.
Es la diferencia de diseño más interesante entre este servicio y el síncrono. En CONVERT_NATIVE_XML el número interno es un nodo opcional del XML nativo, y si pierdes la respuesta tienes que construir la verificación tú mismo llamando a LOOKUP_ISSUED_INTERNAL_ID antes de decidir si reintentas. Aquí el número interno es obligatorio y la plataforma lo usa como llave: si reenvías, no obtienes un segundo comprobante sino el identificador de la solicitud que ya habías hecho, con el código 3196.
Vale la pena leer ese código como lo que es. No es un error que haya que corregir: es la respuesta correcta a un reenvío, y el flujo debe continuar con el identificador devuelto. Tratarlo como fallo y generar un número interno nuevo para reintentar convierte una protección en la causa del problema que pretendía evitar.
La recuperación no entrega los archivos sino enlaces a archivos ZIP en la nube, con cinco días de vigencia, y esos enlaces no se guardan: cada llamada genera unos nuevos. El diseño tiene sentido para archivos que pueden pesar decenas de megabytes, pero traslada una responsabilidad al cliente. Descargar y resguardar dentro del plazo no es una buena práctica opcional: es parte del flujo.
Dos megabytes contra setenta es una diferencia grande. Puedes validar toda la mecánica en pruebas —el encolamiento, los estados, el manejo del 3196, la recuperación— pero no los tiempos de procesamiento ni el comportamiento de tu ERP al manejar archivos de decenas de megabytes. Conviene planear las primeras emisiones productivas como parte de la puesta en marcha, con acompañamiento, y no darlas por probadas solo porque el ambiente de pruebas pasó.