Qué hace: devuelve cuántos CFDI emitidos (y almacenados en MYSuite), tienen el Número Interno (fx:NumeroInterno) que se consulta, y el detalle (metadatos), de cada uno. El Número Interno es el control propio de unicidad del sistema administrativo del cliente, el ERP lo genera y lo escribe en el XML nativo de MYSuite al emitir.
Cuándo se usa: como verificación antiduplicado. El escenario habitual es una llamada a CONVERT_NATIVE_XML que no devolvió respuesta —TimeOut o corte de conexión—, el ERP no supo si el comprobante se certificó y tampoco conoce el folio fiscal que MYSuite pudo haber asignado. Como el Número Interno sí lo conoce de antemano, se pregunta por él antes de decidir reintentar.
Cuándo no usarla: esta transacción no devuelve los comprobantes, solo un conteo y su detalle resumido. Para obtener el XML o el PDF, usa RETRIEVE_DOCUMENT. Para buscar por serie y folio, usa LOOKUP_ISSUED_YEAR_BATCH_AND_SERIAL.

| Si su integración… | Su artículo es... |
|---|---|
| Necesita saber si un comprobante ya se emitió, conociendo solo su Número Interno, por SOAP | Este artículo |
| Necesita el XML o el PDF de un comprobante certificado ya identificado | RETRIEVE_DOCUMENT |
| Conoce la serie y el folio, y busca el comprobante | LOOKUP_ISSUED_YEAR_BATCH_AND_SERIAL |
| Va a emitir un CFDI a partir de un XML Nativo | CONVERT_NATIVE_XML — CFDI + Timbrado (SOAP) |
Requestor y Entity.fx:NumeroInterno en el XML Nativo de MYSuite al emitir. Sin ese dato la consulta no puede encontrar nada, y la verificación antiduplicado deja de estar disponible para ese comprobante.Transaction con valor LOOKUP_ISSUED_INTERNAL_ID, el Número Interno en Data1, la Sucursal en Data2 y el año en Data3. Los tres datos viajan en texto plano, sin codificar en Base64.RequestTransactionResponse.Result.Result = true indica que la consulta se ejecutó; false deriva a Solución de problemas.ResponseData1 tal cual, sin decodificar: contiene la cantidad de comprobantes encontrados.ResponseData2 desde Base64 sólo si la cantidad de cfdis encontrados es mayor que 0.DocsFoundBy con el detalle (metadatos), de cada comprobante localizado.CONVERT_NATIVE_XML.uuid del detalle para actualizar el ERP.Si algo falla, vaya a Solución de problemas.
| Protocolo | SOAP 1.1 / 1.2 sobre HTTPS |
|---|---|
| Servicio | FactWSFront |
| Operación | RequestTransaction |
| Namespace | http://www.fact.com.mx/schema/ws |
| SOAPAction | http://www.fact.com.mx/schema/ws/RequestTransaction |
Valor <Transaction> |
LOOKUP_ISSUED_INTERNAL_ID |
| Naturaleza | Consulta. No modifica el estado de ningún comprobante |
| Ambiente | URL |
|---|---|
| Pruebas | https://www.mysuitetest.com/mx.com.fact.wsfront/FactWSFront.asmx |
| Producción | https://www.mysuitecfdi.com/mx.com.fact.wsfront/FactWSFront.asmx |
JES900109Q90 como RFC emisor (Entity). La consulta solo alcanza a los comprobantes emitidos bajo ese emisor y en ese ambiente; un Número Interno certificado en pruebas no se encuentra en producción, ni al contrario.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, está ligado a la seguridad de la transacción, a la autenticación y autorización para aceptar solicitudes. |
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 cuyos comprobantes se consultan. Delimita el alcance de la búsqueda. En pruebas debe ser 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í | Nodo fx:NumeroInterno del XML Nativo de MYSuite admite hasta 250 caracteres. |
Texto plano, sin codificar | Número Interno a buscar, tal como se escribió en el nodo fx:NumeroInterno del XML Nativo de MYSuite al emitir. |
Data2 |
string | No | Nodo fx:Sucursal del XML Nativo de MYSuite admite hasta 128 caracteres. |
Clave de Sucursal, texto plano | Sucursal. Si se especifica, se toma también como criterio de búsqueda. Si se omite, la búsqueda no se acota por Sucursal |
Data3 |
string | No | 4 dígitos | Año en formato AAAA |
Año de emisión. Si se envía vacío se asume el año en curso. Para buscar comprobantes de años anteriores debe especificarse. |
CONVERT_NATIVE_XML, aquí ningún parámetro de entrada se codifica en Base64. Los tres nodos viajan en texto plano.Los tres parámetros son valores escalares, sin estructura interna.
| Nodo | Contenido | Ejemplo de forma |
|---|---|---|
Data1 |
Número Interno del comprobante, según el control del sistema administrativo del cliente | 123456789 |
Data2 |
Clave de la Sucursal. | ABB |
Data3 |
Año de emisión, o vacío para el año en curso | 2019 |
<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" xmlns:ws="http://www.fact.com.mx/schema/ws">
<soapenv:Header/>
<soapenv:Body>
<ws:RequestTransaction>
<ws:Requestor>0c320b03-d4f1-47bc-9fb4-77995f9bf33e</ws:Requestor>
<ws:Transaction>LOOKUP_ISSUED_INTERNAL_ID</ws:Transaction>
<ws:Country>MX</ws:Country>
<ws:Entity>JES900109Q90</ws:Entity>
<ws:User>0c320b03-d4f1-47bc-9fb4-77995f9bf33e</ws:User>
<ws:UserName>MX.JES900109Q90.jan</ws:UserName>
<ws:Data1>123</ws:Data1>
<ws:Data2>ABB</ws:Data2>
<ws:Data3></ws:Data3>
</ws:RequestTransaction>
</soapenv:Body>
</soapenv: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>LOOKUP_ISSUED_INTERNAL_ID</Transaction>
<Country>MX</Country>
<Entity>JES900109Q90</Entity>
<User>00000000-0000-0000-0000-000000000000</User>
<UserName>MX.JES900109Q90.jacinto</UserName>
<Id>50c8c943-becd-4d9f-b527-64895838fdb0</Id>
<TimeStamp>2026-09-08T10:13:17.2584537-06:00</TimeStamp>
</Request>
<Response>
<Result>true</Result>
<TimeStamp>2026-09-08T10:13:17.2742159-06:00</TimeStamp>
<LastResult/>
<Code>1</Code>
<Description/>
<Hint/>
<Data>4779 50c8c943-becd-4d9f-b527-64895838fdb0</Data>
<Processor>TEST-BACK03</Processor>
</Response>
<ResponseData>
<ResponseData1>0</ResponseData1>
<ResponseData2/>
<ResponseData3/>
</ResponseData>
</RequestTransactionResult>
</RequestTransactionResponse>
</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>LOOKUP_ISSUED_INTERNAL_ID</Transaction>
<Country>MX</Country>
<Entity>JES900109Q90</Entity>
<User>00000000-0000-0000-0000-000000000000</User>
<UserName>MX.JES900109Q90.jacinto</UserName>
<Id>ec2afaea-1528-4876-adca-e84659d26051</Id>
<TimeStamp>2026-09-08T10:14:49.7773091-06:00</TimeStamp>
</Request>
<Response>
<Result>true</Result>
<TimeStamp>2026-09-08T10:14:49.8054223-06:00</TimeStamp>
<LastResult/>
<Code>1</Code>
<Description/>
<Hint/>
<Data>4780 ec2afaea-1528-4876-adca-e84659d26051</Data>
<Processor>TEST-BACK03</Processor>
</Response>
<ResponseData>
<ResponseData1>2</ResponseData1>
<ResponseData2>PERvY3NGb3VuZEJ5IGludGVybmFsSWQ9IjEiIGNvdW50PSIyIiB5ZWFyPSIiPgo8ZG9jIHBvcz0iMSI+CjxjdHJ5Pk1YPC9jdHJ5Pgo8dGF4SWQ+SkVTOTAwMTA5UTkwPC90YXhJZD4KPHV1aWQ+MTExZDExYjMtN2FiZi00OGRiLWI3ZDUtNDY0ZjUxNjRjNTRkPC91dWlkPgo8YnJhbmNoPkFCQjwvYnJhbmNoPgo8YmF0Y2g+QUJCPC9iYXRjaD4KPHNlcmlhbD4xMzU0NDwvc2VyaWFsPgo8aXNzdWVkPjIwMjYtMDMtMjBUMTc6MTg6MTk8L2lzc3VlZD4KPGNhbmNlbGxlZC8+CjxraW5kPjE8L2tpbmQ+CjxjdXJyZW5jeT5NWE48L2N1cnJlbmN5Pgo8dG90YWw+MzAyMTUuMDAwMDAwPC90b3RhbD4KPC9kb2M+Cjxkb2MgcG9zPSIyIj4KPGN0cnk+TVg8L2N0cnk+Cjx0YXhJZD5KRVM5MDAxMDlROTA8L3RheElkPgo8dXVpZD5jZWU1NmRjMi0wNjc0LTRiMWYtYWU4OS0zN2U5ZjM0NTE1ZTA8L3V1aWQ+CjxicmFuY2g+QUJCPC9icmFuY2g+CjxiYXRjaD5BQkI8L2JhdGNoPgo8c2VyaWFsPjEzNTMzPC9zZXJpYWw+Cjxpc3N1ZWQ+MjAyNi0wMi0xMlQxODowMDoyNDwvaXNzdWVkPgo8Y2FuY2VsbGVkLz4KPGtpbmQ+MTwva2luZD4KPGN1cnJlbmN5Pk1YTjwvY3VycmVuY3k+Cjx0b3RhbD45NS4wMDAwMDA8L3RvdGFsPgo8L2RvYz4KPC9Eb2NzRm91bmRCeT4K</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ó correctamente |
Code |
Código de resultado. Ver apartado 10 | |
TimeStamp |
Momento en que concluyó el procesamiento | |
LastResult · Description · Hint |
Vacíos en consulta exitosa. Ver apartado 9 | |
Data |
Cadena de referencia interna del procesamiento | |
Processor |
Servidor que atendió la solicitud. Dato a incluir al reportar incidencias | |
ResponseData |
ResponseData1 |
Cantidad de documentos encontrados, como número en texto plano. No viene en Base64 |
ResponseData2 |
XML DocsFoundBy codificado en Base64, con el detalle (metadatos), de los documentos encontrados. |
|
ResponseData3 |
Vacío |
ResponseData1 llega en texto plano y ResponseData2 codificado en Base64.ResponseData1 devuelve 0 y ResponseData2 llega vacío. El conteo se lee siempre en ResponseData1, no en Result. Result = true ; una consulta ejecutada sin haber encontrado coincidencias no es un error.DocsFoundBy (contenido de ResponseData2 una vez decodificado)<DocsFoundBy internalId="[Número Interno consultado]" count="[cantidad de documentos]" year="[año consultado, vacío si se asumió el año en curso]">
<doc pos="[posición en el resultado]">
<ctry>MX</ctry>
<taxId>JES900109Q90</taxId>
<uuid>111d11b3-7abf-48db-b7d5-464f5164c54d</uuid>
<branch>ABB</branch>
<batch>ABB</batch>
<serial>13544</serial>
<issued>2026-03-20T17:18:19</issued>
<cancelled/>
<kind>1</kind>
<currency>MXN</currency>
<total>30215.000000</total>
</doc>
<doc pos="2">
<ctry>MX</ctry>
<taxId>JES900109Q90</taxId>
<uuid>cee56dc2-0674-4b1f-ae89-37e9f34515e0</uuid>
<branch>ABB</branch>
<batch>ABB</batch>
<serial>13533</serial>
<issued>2026-02-12T18:00:24</issued>
<cancelled/>
<kind>1</kind>
<currency>MXN</currency>
<total>95.000000</total>
</doc>
</DocsFoundBy>
| Elemento | Contenido |
|---|---|
@internalId |
Número Interno consultado. |
@count |
Cantidad de documentos encontrados. Coincide con ResponseData1 |
@year |
Año consultado. Llega vacío si Data3 se envió vacío |
doc/@pos |
Posición del documento dentro del resultado, comenzando en 1 |
ctry |
País |
taxId |
RFC del emisor |
uuid |
Folio Fiscal (UUID). Es el dato que permite cerrar el comprobante en el ERP |
branch |
Sucursal |
batch |
Serie |
serial |
Folio |
issued |
Fecha de emisión |
cancelled |
Fecha de cancelación si el comprobante fue cancelado; vacío en caso contrario |
kind |
Tipo de documento: Ingreso, Egreso o Traslado. FACTURA = 1,
NOTA_DE_CREDITO = 2,
NOTA_DE_CARGO = 4,
CARTA_PORTE = 8,
RECIBO_DE_HONORARIOS = 16,
RECIBO_DE_ARRENDAMIENTO = 32,
RECIBO_DE_DONATIVOS = 64,
RECIBO_DE_PAGO_DE_PRIMAS = 128,
COMPROBANTE_DE_PAGO_A_PLAZOS = 256,
BOLETA_DE_EMPENO = 512,
RECIBO_DE_NOMINA = 1024,
RECIBO = 2048,
PAGO = 4096,
TRASLADO = 8192 |
currency |
Moneda |
total |
Total del comprobante |
El sobre es el mismo del apartado 8. Cambia el contenido de Response y los nodos de datos llegan vacíos.
| Elemento | Contenido en error |
|---|---|
Result |
false |
Code |
Código del error. Ver apartado 10 |
Description |
Mensaje del error |
Hint |
Sugerencia de corrección, cuando la plataforma la proporciona |
Data |
Notificación de nuestro servicio |
LastResult |
Resultado de la operación previa asociada, cuando aplica |
Processor |
Servidor que atendió la solicitud. Dato a incluir al reportar incidencias |
ResponseData1 · ResponseData2 |
Vacíos |
Result = false significa que la consulta no se pudo ejecutar (no significa que el comprobante no exista). Un ERP que trate el error de consulta como "no encontrado" reintentará la emisión y generará un CFDI duplicado. Ante Result = false debe reintentarse la consulta, no la emisión.Result = false y HTTP 200. El ERP debe evaluar siempre Result y no asumir éxito por el código de estado HTTP.| Aspecto | Valor |
|---|---|
| Alcance temporal | Un año por consulta, determinado por Data3. Con Data3 vacío se consulta el año en curso |
| Alcance por emisor | Limitado al RFC declarado en Entity y al ambiente en que se consulta |
| Idempotencia | Es una transacción de consulta: no modifica el estado de ningún comprobante, por lo que reintentarla no tiene efectos colaterales |
| Máximo de documentos en el detalle | No existe límite. |
| Timeout | 60 segundos en servidor front |
| Latencia esperada | «pendiente: Infraestructura — relevante porque la consulta se ejecuta dentro de la ventana de recuperación de un TimeOut» |
fx:NumeroInterno del XML Nativo de MYSuite FactDocMX v8, opcional en el esquema y con longitud de hasta 250 caracteres. Que sea opcional al emitir es lo que puede dejar comprobantes fuera del alcance de esta consulta.Problema. La consulta devuelve ResponseData1 = 0 para un comprobante que sí existe en MYSuite, con el riesgo de que el ERP reintente la emisión y genere un duplicado.
Entorno. CFDI + Timbrado · SOAP · LOOKUP_ISSUED_INTERNAL_ID.
Resolución. Revise, en este orden: que el XML Nativo original haya llevado el nodo fx:NumeroInterno, ya que es opcional en el esquema y sin este el comprobante no es localizable por esta vía; que el valor enviado en Data1 coincida exactamente con el que se escribió al emitir; que el año en Data3 corresponda al de emisión, recordando que si va vacío se asume el año en curso; y que la Sucursal enviada en Data2, si la envió, sea la del comprobante. Si duda de la Sucursal, omita Data2 para no acotar la búsqueda.
Causa. Cualquiera de los cuatro criterios reduce el alcance de la búsqueda. El caso más frecuente en integraciones nuevas es el fx:NumeroInterno ausente en el XML Nativo de MYSuite.
Problema. El conteo es mayor que 1 y el ERP no sabe cuál de los comprobantes es el correcto.
Entorno. CFDI + Timbrado · SOAP · integraciones con reintentos automáticos, o con Números Internos reutilizados.
Resolución. No reintente la emisión. Decodifique ResponseData2 y revise cada elemento doc: el issued permite identificar el orden de emisión y el cancelled indica si alguno ya fue cancelado. Escale el caso internamente para determinar qué comprobante conservar y cancelar el resto conforme al esquema vigente.
Causa. O el ERP reintentó una emisión sin verificar antes, o el Número Interno no es único en el sistema del cliente. Si es lo segundo, corrija la generación del identificador: de lo contrario la verificación antiduplicado no es confiable.
Problema. El intento de decodificar la respuesta falla o produce un valor sin sentido.
Entorno. CFDI + Timbrado · SOAP · integraciones que reutilizan el código de CONVERT_NATIVE_XML.
Resolución. Lea ResponseData1 tal cual: es un número en texto plano. Decodifique únicamente ResponseData2. Tampoco codifique en Base64 los parámetros de entrada de esta transacción: los tres viajan en texto plano.
Causa. Reutilización de la capa de codificación escrita para las transacciones de emisión, donde todas las cargas van en Base64. En esta transacción la codificación es asimétrica.
Problema. La consulta devuelve 0 para comprobantes emitidos en años anteriores.
Entorno. CFDI + Timbrado · SOAP · conciliaciones históricas, o consultas realizadas en enero sobre comprobantes de diciembre.
Resolución. Especifique el año de emisión en Data3 con formato de cuatro dígitos. La consulta abarca un año por llamada; para revisar varios años, ejecute una consulta por año.
Causa. Con Data3 vacío la plataforma asume el año en curso. El caso de fin de año es especialmente engañoso: un comprobante emitido el 31 de diciembre no se encuentra si se consulta en enero sin especificar el año.
Problema. Ante Result = false, el ERP interpreta que el comprobante no fue emitido y reintenta CONVERT_NATIVE_XML, generando un CFDI duplicado.
Entorno. CFDI + Timbrado · SOAP · lógica de recuperación ante TimeOut.
Resolución. Trate Result = false como consulta no concluyente, no como ausencia de comprobante. Reintenta la consulta; si persiste, detén el proceso de emisión de ese comprobante y escala a MYSuite antes de volver a timbrar. El único valor que autoriza reintentar la emisión es un conteo de 0 en ResponseData1 con Result = true.
Causa. Confusión entre el resultado de la consulta y el resultado de la búsqueda. Son dos señales distintas que viajan en elementos distintos.
El timbrado/certificación es una operación con efectos fiscales irreversibles: una vez que MYSuite incorpora el Timbre Fiscal Digital, el comprobante existe ante el SAT y solo puede retirarse mediante una cancelación formal. Entre el momento en que el ERP envía la petición y el momento en que recibe la respuesta existe una ventana en la que el estado real es desconocido. Si la conexión se corta en esa ventana, el ERP tiene dos opciones malas: no reintentar y quedarse sin comprobante, o reintentar y arriesgar un duplicado que después habrá que cancelar. Esta transacción convierte esa decisión ciega en una verificación.
Cuando la respuesta se pierde, el ERP no conoce el folio ni el UUID: en algunos casos los asigna MYSuite y viajan justamente en la respuesta que no llegó. El Número Interno es el único identificador que el ERP conoce antes de la llamada, porque lo genera él mismo y lo escribe en el XML Nativo de MYSuite. Es el único puente disponible hacia un comprobante cuyo folio se desconoce.
El nodo fx:NumeroInterno es opcional en el esquema del XML Nativo, y MYSuite no valida su unicidad. Esto tiene una consecuencia práctica que conviene aceptar de entrada: la capacidad de recuperarse de un TimeOut depende de una decisión de diseño que se toma al implementar la emisión, no al implementar la recuperación. Un ERP que no envía Número Interno, o que lo reutiliza, se queda sin red de seguridad, y el problema solo se manifiesta el día del primer corte de conexión.
El caso de uso principal necesita responder una sola pregunta: ¿existe o no? Para eso basta un número, y ponerlo en texto plano en ResponseData1 permite decidir sin decodificar nada. El detalle en ResponseData2 sirve al segundo caso de uso, que es cerrar el comprobante en el ERP con su UUID, serie y folio. De ahí la codificación asimétrica: no es una inconsistencia, es la separación entre la señal y el detalle.
La respuesta trae metadatos, no documentos. Devolver los XML aquí haría la consulta costosa justo en el momento en que se necesita rápida, y duplicaría la función de RETRIEVE_DOCUMENT. La secuencia natural es verificar con esta transacción y, si hace falta el archivo, pedirlo después con el UUID obtenido.
El almacenamiento de comprobantes está organizado por ejercicio fiscal, lo que hace la búsqueda eficiente dentro de un año y obliga a declarar el año cuando se sale del actual. Para el caso de uso principal —verificar una emisión que acaba de ocurrir— el valor por omisión es siempre el correcto, y por eso el parámetro es opcional.
Es una consulta: no crea, no modifica y no cancela nada. A diferencia de CONVERT_NATIVE_XML, se puede ejecutar tantas veces como sea necesario sin consecuencias. Esta asimetría es la que hace viable el patrón completo: verificar cuantas veces se requiera, emitir una sola.
La transacción sería la misma operación de negocio en ambos transportes, pero cambia todo lo que rodea al dato: los encabezados, la forma del cuerpo, la nomenclatura de la respuesta y la manera de leerla. Documentar ambos en un solo artículo obligaría al lector a descartar la mitad del contrato técnico en cada consulta, y es precisamente donde se originan los errores de integración.
Emisión
Validación y Recepción
CFDI de Retenciones
Esquema de cancelación