Qué hace: devuelve cuántos CFDI almacenados en MYSuite coinciden con una Serie y un Folio determinados, y un detalle (metadatos), de cada uno. La Serie y el Folio pueden provenir del XML Nativo de MYSuite que el ERP del emisor envió a certificar, o de la asignación configurada en el Portal Web de MYSuite que haya realizado el cliente.
Cuándo se usa: en sistemas administrativos que llevan el control de sus comprobantes por Serie y Folio en lugar del Folio Fiscal, y necesitan localizar un comprobante o verificar su existencia con esos datos.
Cuándo no usarla: esta transacción no devuelve los comprobantes, solo un conteo y su detalle (metadatos); para obtener el XML o el PDF del CFDI, use RETRIEVE_DOCUMENT. Si lo que conoce es el Número Interno de su sistema, use LOOKUP_ISSUED_INTERNAL_ID.
| Si su integración… | Su artículo es... |
|---|---|
| Conoce la Serie y el Folio, y busca el comprobante por SOAP | Este artículo |
| Conoce el Número Interno de su sistema administrativo | LOOKUP_ISSUED_INTERNAL_ID — CFDI + Timbrado (SOAP) |
| Necesita el XML o el PDF de un comprobante certificado y ya identificado | RETRIEVE_DOCUMENT |
| Va a certificar un CFDI a partir de un XML Nativo de MYSuite | CONVERT_NATIVE_XML — CFDI + Timbrado (SOAP) |
Requestor y Entity.Dictionary con el atributo name igual a StoredXmlSelector y las cuatro entradas Batch, Serial, Branch y Year.Dictionary completa en Base64.Transaction con valor LOOKUP_ISSUED_YEAR_BATCH_AND_SERIAL, la cadena Base64 en Data1, ( Data2 y Data3 vacíos).RequestTransactionResponse.Result.Result = true indica que la consulta se ejecutó; Result = 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 es mayor que 0.DocsFoundBy con el detalle (metadatos), de cada comprobante localizado.uuid del detalle (metadatos).issued, total, etc. o acote la búsqueda por Sucursal.Si algo falla, ve 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_YEAR_BATCH_AND_SERIAL |
| 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: una Serie y Folio 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í | — | Base64 | Estructura Dictionary de criterios, codificada en Base64. Ver apartado 5 |
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. El año de la búsqueda no va aquí, sino dentro del Dictionary |
Data2 y Data3. Aquí los cuatro criterios se agrupan en una sola estructura dentro de Data1 codificada en Base64 (Data2 y Data3) quedan vacíos.Dictionary<Dictionary name="StoredXmlSelector">
<Entry k="Batch" v="[Serie del comprobante]"/>
<Entry k="Serial" v="[Folio del comprobante]"/>
<Entry k="Branch" v="[Sucursal, o vacío]"/>
<Entry k="Year" v="[Año de emisión, o vacío]"/>
</Dictionary>Entrada (k) |
Tipo | Obligatorio | Límite | Formato | Descripción |
|---|---|---|---|---|---|
Batch |
string | Sí | — | Texto | Serie del comprobante, en el valor v |
Serial |
string | Sí | El nodo fx:Folio del XML Nativo admite hasta 40 caracteres |
Texto | Folio del comprobante, en el valor v |
Branch |
string | No | El nodo fx:Sucursal del XML Nativo admite hasta 40 caracteres |
Texto, admite valor vacío | Sucursal declarada en el XML Nativo al emitir. Si no se conoce, la entrada debe enviarse con el valor vacío: <Entry k="Branch" v=""/> |
Year |
string | No | 4 dígitos | Año en formato AAAA, admite valor vacío |
Año de emisión del comprobante. Si no se especifica, se busca en el año actual |
name del Dictionary debe ser siempre StoredXmlSelector.Sin estructura. Ambos se envían vacíos.
<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_YEAR_BATCH_AND_SERIAL</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>PERpY3Rpb25hcnkgbmFtZT0iU3RvcmVkWG1sU2VsZWN0b3IiPgogIDxFbnRyeSBrPSJCYXRjaCIgdj0iQUJCIi8+CiAgPEVudHJ5IGs9IlNlcmlhbCIgdj0iMTAiLz4KICA8RW50cnkgaz0iQnJhbmNoIiB2PSJBQkIiLz4KICA8RW50cnkgaz0iWWVhciIgdj0iMjAyNSIvPgo8L0RpY3Rpb25hcnk+</ws:Data1>
<ws:Data2></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_YEAR_BATCH_AND_SERIAL</Transaction>
<Country>MX</Country>
<Entity>JES900109Q90</Entity>
<User>00000000-0000-0000-0000-000000000000</User>
<UserName>MX.AAA010101AAA.jacinto</UserName>
<Id>187c9938-5fda-4809-a311-ef516ba6f27a</Id>
<TimeStamp>2026-09-08T13:48:47.4683303-06:00</TimeStamp>
</Request>
<Response>
<Result>true</Result>
<TimeStamp>2026-09-08T13:48:47.4842379-06:00</TimeStamp>
<LastResult/>
<Code>1</Code>
<Description/>
<Hint/>
<Data>7503 187c9938-5fda-4809-a311-ef516ba6f27a</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_YEAR_BATCH_AND_SERIAL</Transaction>
<Country>MX</Country>
<Entity>JES900109Q90</Entity>
<User>00000000-0000-0000-0000-000000000000</User>
<UserName>MX.AAA010101AAA.jacinto</UserName>
<Id>4b83a975-80fa-4f5f-a3d6-737c301ecd22</Id>
<TimeStamp>2026-09-08T13:52:19.8993575-06:00</TimeStamp>
</Request>
<Response>
<Result>true</Result>
<TimeStamp>2026-09-08T13:52:19.9158518-06:00</TimeStamp>
<LastResult/>
<Code>1</Code>
<Description/>
<Hint/>
<Data>7524 4b83a975-80fa-4f5f-a3d6-737c301ecd22</Data>
<Processor>TEST-BACK03</Processor>
</Response>
<ResponseData>
<ResponseData1>1</ResponseData1>
<ResponseData2>PERvY3NGb3VuZEJ5IGJhdGNoPSJBQkIiIHNlcmlhbD0iMTM1NDQiIGNvdW50PSIxIiB5ZWFyPSIyMDI2Ij4KPGRvYyBwb3M9IjEiPgo8Y3RyeT5NWDwvY3RyeT4KPHRheElkPkpFUzkwMDEwOVE5MDwvdGF4SWQ+Cjx1dWlkPjExMWQxMWIzLTdhYmYtNDhkYi1iN2Q1LTQ2NGY1MTY0YzU0ZDwvdXVpZD4KPGJyYW5jaD5BQkI8L2JyYW5jaD4KPGJhdGNoPkFCQjwvYmF0Y2g+CjxzZXJpYWw+MTM1NDQ8L3NlcmlhbD4KPGlzc3VlZD4yMDI2LTAzLTIwVDE3OjE4OjE5PC9pc3N1ZWQ+CjxjYW5jZWxsZWQvPgo8a2luZD4xPC9raW5kPgo8Y3VycmVuY3k+TVhOPC9jdXJyZW5jeT4KPHRvdGFsPjMwMjE1LjAwMDAwMDwvdG90YWw+CjwvZG9jPgo8L0RvY3NGb3VuZEJ5Pgo=</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 |
Data1 va en Base64, pero en la respuesta ResponseData1 llega en texto plano y solo ResponseData2 viene en Base64. Intentar decodificar el conteo produce un error o un valor sin sentido.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 batch="[Serie consultada]" serial="[Folio 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 |
|---|---|
@batch · @serial |
Serie y Folio consultados. |
@count |
Cantidad de documentos encontrados. Coincide con ResponseData1 |
@year |
Año consultado |
doc/@pos |
Posición del documento dentro del resultado, comenzando en 1 |
ctry |
País |
taxId |
RFC del emisor |
uuid |
Folio Fiscal (UUID). Es la llave única real del comprobante y el dato que conviene registrar |
branch |
Sucursal. Puede diferir del valor de la Serie |
batch |
Serie |
serial |
Folio |
issued |
Fecha de emisión. Criterio útil para discriminar entre varios resultados |
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. La ausencia de comprobante se expresa como Result = true con conteo 0 en ResponseData1. Un proceso que confunda las dos señales concluirá que un comprobante no existe cuando en realidad la consulta falló.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 la entrada Year. Si se envía vacía, se consulta el año en curso |
| Alcance por emisor | Limitado al RFC declarado en Entity y al ambiente en que se consulta |
| Unicidad del criterio | Ninguna. Serie y Folio no son elementos de unicidad en la base de datos: la consulta puede devolver varios documentos |
| 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 |
fx:Serie y fx:Folio del bloque fx:AsignacionSolicitada del XML Nativo de MYSuite FactDocMX v8, o de la asignación configurada en el Portal Web de MYSuite. Ambos son opcionales en el CFDI conforme al Anexo 20.Problema. La consulta devuelve ResponseData1 = 0 para un comprobante que sí está en MYSuite.
Entorno. CFDI + Timbrado · SOAP · LOOKUP_ISSUED_YEAR_BATCH_AND_SERIAL.
Resolución. Revisa, en este orden: que la entrada Year corresponda al año de emisión, recordando que si va vacía se busca en el año actual; que la entrada Branch, si la enviaste con valor, sea la Sucursal del comprobante, si hay duda, envíala vacía para no acotar la búsqueda; y que Batch y Serial coincidan exactamente con la Serie y el Folio registrados al emitir, sin espacios ni ceros de relleno añadidos por tu sistema.
Causa. Cualquiera de los cuatro criterios reduce el alcance de la búsqueda. La Sucursal enviada con un valor incorrecto es la causa más silenciosa, porque es opcional y muchos integradores la llenan por costumbre.
Problema. El conteo es mayor que 1 y el sistema esperaba un único resultado.
Entorno. CFDI + Timbrado · SOAP · sistemas administrativos que usan Serie y Folio como identificador principal.
Resolución. No es un defecto de la plataforma: la Serie y el Folio no son elementos de unicidad. Decodifica ResponseData2 y discrimina entre los elementos doc usando issued, total, etx. Si necesitas reducir el resultado a uno, acota la búsqueda enviando la Sucursal en Branch. A mediano plazo, registra el uuid en tu sistema y usa el Folio Fiscal como identificador.
Causa. El único elemento de unicidad en la base de datos es el Folio Fiscal. La unicidad de Serie y Folio debe garantizarla el sistema administrativo del emisor, y si no lo hace, pueden coexistir comprobantes con la misma combinación.
Problema. La petición es rechazada o devuelve 0 al reutilizar la implementación de LOOKUP_ISSUED_INTERNAL_ID.
Entorno. CFDI + Timbrado · SOAP · integraciones que implementan varias transacciones de consulta.
Resolución. Las dos consultas reciben los criterios de forma distinta. Aquí los cuatro criterios van agrupados en la estructura Dictionary dentro de Data1 y codificados en Base64, con Data2 y Data3 vacíos. En la otra transacción los criterios van en texto claro y reparte Número Interno, Sucursal y año entre Data1, Data2 y Data3. No es posible compartir la capa de armado de criterios entre ambas.
Causa. Cada transacción define su propio contrato para Data1, Data2 y Data3. La similitud de nombre y de propósito no implica similitud de contrato.
Problema. El intento de decodificar la respuesta falla o produce un valor sin sentido.
Entorno. CFDI + Timbrado · SOAP · integraciones nuevas.
Resolución. Lee ResponseData1 tal cual: es un número en texto plano. Decodifica únicamente ResponseData2. La codificación es asimétrica: la entrada va en Base64, pero de la salida solo el detalle (metadatos).
Causa. Se aplica al conteo la misma lógica de decodificación que corresponde al detalle.
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. Especifica el año de emisión en la entrada Year con formato de cuatro dígitos. La consulta abarca un año por llamada; para revisar varios años, ejecuta una consulta por año.
Causa. Con Year 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.
En el CFDI, la serie y el folio son campos opcionales cuyo contenido queda a criterio del emisor: el SAT no los valida ni exige que sean únicos. El identificador real es el Folio Fiscal, el UUID que asigna el PAC al timbrar. MYSuite refleja esa realidad en su almacenamiento: la llave de unicidad es el UUID, no la combinación de serie y folio. De ahí que esta consulta pueda devolver más de un resultado sin que exista ningún error.
Porque muchos sistemas administrativos son anteriores al CFDI o fueron diseñados alrededor del concepto de folio consecutivo, y su control interno se lleva por serie y folio. Para ellos, buscar por UUID es imposible: no lo tienen registrado. Esta transacción les da una vía de acceso con los datos que sí manejan, a cambio de aceptar que el resultado puede ser ambiguo. La contrapartida está declarada en el propio contrato: la unicidad la debe garantizar el sistema administrativo, no la plataforma.
La operación RequestTransaction ofrece solo tres nodos de datos para todas las transacciones de la plataforma. Cuando una transacción necesita más de tres criterios —aquí son cuatro: serie, folio, sucursal y año— no alcanzan los nodos, y la solución es agrupar los criterios en una estructura y meterla completa en Data1. Codificarla en Base64 evita que el XML de criterios interfiera con el XML del sobre SOAP. Es el mismo patrón que usa CONVERT_NATIVE_XML con el XML Nativo, aplicado aquí a un conjunto de criterios en lugar de a un documento.
Un proceso que solo necesita saber si el comprobante existe puede decidir leyendo ResponseData1, sin decodificar nada. El detalle en ResponseData2 sirve al segundo caso de uso, que es identificar cuál de los resultados corresponde al comprobante buscado y quedarse con su UUID. De ahí la codificación asimétrica de la respuesta: es la separación entre la señal y el detalle.
La respuesta trae metadatos, no documentos. Devolver los XML aquí duplicaría la función de RETRIEVE_DOCUMENT y encarecería una consulta cuyo propósito es localizar. La secuencia natural es localizar 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 declararlo cuando se sale del actual. Para el caso más frecuente —localizar un comprobante reciente— el valor por omisión es el correcto, y por eso la entrada es opcional.
Las dos consultas devuelven la misma estructura DocsFoundBy y comparten el propósito de localizar comprobantes sin descargarlos, pero responden a necesidades distintas. Aquélla busca por el identificador que el ERP generó antes de emitir, y su caso de uso central es la verificación antiduplicado tras una respuesta perdida. Ésta busca por los datos que el comprobante muestra en su cara visible, y su caso de uso central es la conciliación desde un sistema que lleva su control por serie y folio. También difieren en cómo reciben los criterios, lo que impide compartir la implementación.
Es una consulta: no crea, no modifica y no cancela nada. Se puede ejecutar tantas veces como sea necesario sin consecuencias, a diferencia de las transacciones de emisión.
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