LOOKUP_ISSUED_YEAR_BATCH_AND_SERIAL — SERVICIO CFDI + Timbrado (SOAP)

LOOKUP_ISSUED_YEAR_BATCH_AND_SERIAL — SERVICIO CFDI + Timbrado (SOAP)

Estado Transacción: Vigente · Compatibilidad: XML Nativo (FactDocMX) v8 · Última revisión: 21/08/2026 · Próxima revisión:  21/11/2026 · Responsable: Jan Martínez


De un vistazo


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.


La Serie y el Folio no identifican de forma única a un comprobante. El elemento de unicidad es el Folio Fiscal (UUID). Puede existir más de un comprobante del mismo emisor con la misma Serie y Folio, por lo que esta consulta puede devolver varios resultados legítimamente. Si su sistema depende de que la combinación sea única, esa unicidad debe garantizarla el propio sistema ERP, MYSuite no la impone.

Alert
Advertencia de homonimia. Este artículo documenta el consumo por SOAP, contra el servicio FactWSFront.


Cómo saber si este es su artículo


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)


Requisitos previos

  • Credenciales de integración vigentes proporcionadas por MYSuite: Requestor y Entity.
  • Conocer la Serie y el Folio del comprobante, tal como quedaron registrados al emitir.
  • Conocer el año de emisión si el comprobante no es del año en curso.
  • Que el sistema ERP garantice la unicidad de la combinación Serie + Folio, si va a tratar el resultado como un único comprobante.


Cómo hacerlo

  1. Recupera del sistema ERP la Serie y el Folio del comprobante que deseas localizar.
    Resultado: los dos criterios obligatorios de la búsqueda.
  2. Determina la Sucursal y el Año de Emisión. Ambos son opcionales: la Sucursal puede dejarse en blanco y, si no se especifica el año, se busca en el actual.
    Resultado: los criterios opcionales definidos, o la decisión de omitirlos.
  3. Construye la estructura Dictionary con el atributo name igual a StoredXmlSelector y las cuatro entradas Batch, Serial, Branch y Year.
    Resultado: un XML de criterios bien formado.
  4. Codifica la estructura Dictionary completa en Base64.
    Resultado: una cadena Base64 en una sola línea.
  5. Arma el sobre SOAP con las credenciales, Transaction con valor LOOKUP_ISSUED_YEAR_BATCH_AND_SERIAL, la cadena Base64 en Data1, ( Data2 y Data3 vacíos).
    Resultado: petición lista.
  6. Envía la petición al web service del ambiente correspondiente.
    Resultado: respuesta HTTP 200 con un sobre RequestTransactionResponse.
  7. Lee el elemento Result.
    Resultado: Result = true indica que la consulta se ejecutó; Result = false deriva a Solución de problemas.
  8. Lee ResponseData1 tal cual, sin decodificar: contiene la cantidad de comprobantes encontrados.
    Resultado: un número entero.
  9. Decodifica ResponseData2 desde Base64 sólo si la cantidad es mayor que 0.
    Resultado: el XML DocsFoundBy con el detalle (metadatos), de cada comprobante localizado.
  10. Interpreta el conteo:
    • 0 — no existe comprobante con esa Serie y Folio en el año y la Sucursal consultados.
    • 1 — comprobante localizado. Tome el uuid del detalle (metadatos).
    • Mayor que 1 — existen varios comprobantes con esa Serie y Folio. No es un error de la plataforma: la combinación no es llave única. Discrimine por issued, total, etc. o acote la búsqueda por Sucursal.
    Resultado: el comprobante identificado, o la constancia de que no existe con esos criterios.
  11. Registra en tu sistema el Folio Fiscal obtenido, de modo que las consultas siguientes sobre ese comprobante puedan hacerse por su llave única.
    Resultado: comprobante trazable por UUID y no solo por Serie y Folio.

Si algo falla, ve Solución de problemas.


Contrato Técnico

1. Endpoint y operación

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

2. Ambientes

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
Restricción del ambiente de pruebas. Un cliente CFDI + Timbrado (SOAP) debe usar 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.


3. Autenticació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, 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


4. Parámetros de entrada

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
Diferencia con LOOKUP_ISSUED_INTERNAL_ID. Allí los tres parámetros viajan en texto plano, la Sucursal y el Año ocupan 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.


5. Estructura de lo que se envía en Data1, Data2 y Data3

Data1 — estructura 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
El atributo name del Dictionary debe ser siempre StoredXmlSelector.

Data2 y Data3

Sin estructura. Ambos se envían vacíos.


6. Ejemplo de request

<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>

7. Ejemplo de response

<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>


Ejemplo de response: Caso con 1 CFDI encontrado:

<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>

8. Estructura de respuesta — éxito

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
Asimetría de codificación. La entrada 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.
Cuando no hay coincidencias: ResponseData1 devuelve 0 y ResponseData2 llega vacío. El conteo se lee siempre en ResponseData1, no en Result. 
Cuando el conteo es 0 el valor de Result = true ; una consulta ejecutada sin haber encontrado coincidencias no es un error.


Estructura del XML 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


9. Estructura de respuesta — error

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
Distinción necesaria. 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ó.
Un error de negocio se reporta con Result = false y HTTP 200. El ERP debe evaluar siempre Result y no asumir éxito por el código de estado HTTP.


10. Códigos de Error


11. Límites y comportamiento

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


12. Versionado y cumplimiento

  • La transacción no depende de la versión del CFDI: consulta comprobantes ya emitidos, cualquiera que sea la versión con la que se timbraron.
  • La Serie y el Folio provienen de los nodos 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.
Solución de problemas

"Me devuelve 0 aunque la factura existe"


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.

"Me devuelve varios comprobantes con la misma serie y folio"


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.

"Copié el código de la otra consulta y no funciona"


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.

"No puedo decodificar la respuesta, me marca error de Base64"


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.

"Busco un comprobante del año pasado y no lo encuentra"


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.

Para entender más

Por qué la Serie y el Folio no identifican un comprobante

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.

Por qué entonces existe esta transacción

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.

Por qué los criterios viajan como Dictionary y en Base64

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.

Por qué el conteo y el detalle viajan separados

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.

Por qué el detalle no incluye los comprobantes

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.

Por qué la consulta se acota por año

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.

En qué se diferencia de LOOKUP_ISSUED_INTERNAL_ID

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.

Por qué es seguro reintentar esta transacció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.

Por qué SOAP y REST se documentan por separado

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.


Más Transacciones Servicio CFDI + Timbrado (SOAP)

Emisión

Consulta y Recuperación

Validación y Recepción

CFDI de Retenciones

Esquema de cancelación