LOOKUP_ISSUED_INTERNAL_ID — SERVICIO CFDI + Timbrado (SOAP)

LOOKUP_ISSUED_INTERNAL_ID — 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 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.


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


Requisitos previos

  • Credenciales de integración vigentes proporcionadas por MYSuite: Requestor y Entity.
  • Que el ERP haya escrito el nodo 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.
  • Que el Número Interno sea único por comprobante en el sistema del cliente. Si se reutiliza, el conteo pierde valor como señal de duplicado.
  • Conocer el año de emisión si el comprobante buscado no es del año en curso.


Cómo hacerlo

  1. Recupera del ERP el Número Interno del comprobante cuya emisión desea verificar.
    Resultado: contar con el valor que se enviará como criterio de búsqueda.
  2. Decide si acotará la búsqueda por Sucursal. Es opcional; si la especifica, también se usará como criterio.
    Resultado: contar con la Sucursal a enviar, o la decisión de omitirla.
  3. Determina el año de emisión. Si el comprobante es del año en curso, este dato se omite.
    Resultado: contar con el año a enviar, o la decisión de dejarlo vacío.
  4. Arma el sobre SOAP con las credenciales, 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.
    Resultado: petición lista.
  5. Envía la petición al web service del ambiente correspondiente.
    Resultado: respuesta HTTP 200 con un sobre RequestTransactionResponse.
  6. Lee el elemento Result.
    Resultado: Result = true indica que la consulta se ejecutó; false deriva a Solución de problemas.
  7. Lee ResponseData1 tal cual, sin decodificar: contiene la cantidad de comprobantes encontrados.
    Resultado: un número entero.
  8. Decodifica ResponseData2 desde Base64 sólo si la cantidad de cfdis encontrados es mayor que 0.
    Resultado: el XML DocsFoundBy con el detalle (metadatos), de cada comprobante localizado.
  9. Interpreta el conteo antes de decidir si reintentas la emisión:
    • 0 — no existe comprobante con ese Número Interno. La emisión anterior no se completó y puedes volver a ejecutar CONVERT_NATIVE_XML.
    • 1 — el comprobante ya se emitió. No reintentes. Toma el uuid del detalle para actualizar el ERP.
    • Mayor que 1 — existe más de un comprobante con el mismo Número Interno. No reintentes y verifica el caso internamente.
    Resultado: decisión de reintento tomada sobre evidencia, no sobre suposición.
  10. Actualiza el ERP con el Folio Fiscal, la serie y el folio obtenidos del detalle, cerrando el ciclo del comprobante que había quedado en estado indeterminado.
    Resultado: comprobante conciliado en el ERP, sin duplicado emitido.

Si algo falla, vaya a 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_INTERNAL_ID
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; un Número Interno 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í 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.
A diferencia de CONVERT_NATIVE_XML, aquí ningún parámetro de entrada se codifica en Base64. Los tres nodos viajan en texto plano.


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

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


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

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

Ejemplo de response: Caso con más de 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_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>

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. ResponseData1 llega en texto plano y ResponseData2 codificado en Base64.
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 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


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 crítica para la lógica antiduplicado. 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.
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 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»


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 certificaron.
  • El Número Interno proviene del nodo 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.
Solución de problemas

"Me devuelve 0 aunque sé que la factura se timbró"


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.

"Me devuelve más de un comprobante con el mismo número interno"


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.

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

"Busco una factura del año pasado y no la 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. 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.

"La consulta me da error y asumo que la factura no existe"


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.

Para entender más

El problema que esta transacción resuelve

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.


Por qué la búsqueda se hace por Número Interno y no por folio

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.


Por qué el Número Interno es responsabilidad del ERP

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.


Por qué el conteo y el detalle viajan separados

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.


Por qué el detalle no incluye los comprobantes

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.


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


Por qué es seguro reintentar esta transacción

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.


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