LOOKUP_ISSUED_INTERNAL_ID — SERVICIO CFDI + Timbrado (API REST) - Request Transaction

LOOKUP_ISSUED_INTERNAL_ID — SERVICIO CFDI + Timbrado (API REST) - Request Transaction

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


De un vistazo


Qué hace: busca todos los CFDI emitidos y almacenados en MYSuite cuyo Número Interno coincide con el que consultas, y te devuelve cuántos encontró junto con el detalle de cada uno. El Número Interno es el control propio de tu sistema administrativo, el que escribiste en el XML nativo al emitir.


Cuándo se usa: como verificación antiduplicado. El escenario habitual es una llamada a CONVERT_NATIVE_XML que no devuelve respuesta, en la que no sabes si el comprobante se certificó y tampoco conoces el folio fiscal que MYSuite pudo haber asignado. Como el Número Interno sí lo conoces de antemano, preguntas por él antes de decidir si reintentas.


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.


Dos señales distintas que no hay que confundir. resultField te dice si la consulta se ejecutó; responseData1Field te dice cuántos comprobantes hay. Un error de consulta no significa que el comprobante no exista, y tratarlo así lleva a reintentar la emisión y generar un CFDI duplicado.
Advertencia de homonimia. Existe la misma transacción en la modalidad CFDI + Timbrado sobre SOAP. Cada transporte se documenta en un artículo independiente. Este cubre exclusivamente API REST.


Cómo saber si este es tu artículo


Si tu integración… Tu artículo es...
Consulta por Número Interno enviando un cuerpo JSON por HTTP POST Este artículo
Consulta por Número Interno enviando un sobre SOAP a FactWSFront LOOKUP_ISSUED_INTERNAL_ID — CFDI + Timbrado (SOAP)
Va a emitir un CFDI a partir de un XML Nativo enviando un cuerpo JSON por HTTP POST CONVERT_NATIVE_XML — CFDI + Timbrado (API REST) - Request Transaction
Necesita el XML o el PDF de un comprobante ya identificado enviando un cuerpo JSON por HTTP POST RETRIEVE_DOCUMENT — CFDI + Timbrado (API REST) - Request Transaction
Conoce la serie y el folio y busca el comprobante enviando un cuerpo JSON por HTTP POST LOOKUP_ISSUED_YEAR_BATCH_AND_SERIAL — CFDI + Timbrado (API REST) - Request Transaction


Requisitos previos

  • Credenciales de integración vigentes que te proporciona MYSuite: Requestor y Entity.
  • Que tu ERP haya escrito el nodo NumeroInterno en el XML nativo al emitir. Sin ese dato la consulta no encuentra nada y te quedas sin verificación antiduplicado para ese comprobante.
  • Que el Número Interno sea único por comprobante en tu sistema. Si lo reutilizas, el conteo pierde valor como señal de duplicado.
  • Conocer el año de emisión si el comprobante que buscas no es del año en curso.


Cómo hacerlo

  1. Recupera de tu ERP el Número Interno del comprobante cuya emisión quieres verificar.
    Resultado: el valor que vas a enviar como criterio de búsqueda.
  2. Decide si acotas la búsqueda por Sucursal y si necesitas especificar el año. Ambos son opcionales, pero si dejas el año vacío se busca en el año en curso.
    Resultado: los criterios completos.
  3. Arma el cuerpo JSON con los nueve campos: 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 viajan en texto plano, sin codificar en Base64.
    Resultado: un JSON válido con los nueve campos presentes.
  4. Envía la petición POST al recurso /RequestTransaction con Content-Type: application/json.
    Resultado: respuesta HTTP 200 con un cuerpo JSON de tres objetos.
  5. Lee responseField.resultField.
    Resultado: resultField = true indica que la consulta se ejecutó; resultField = false te lleva a Solución de problemas.
  6. Lee responseDataField.responseData1Field tal cual: contiene la cantidad de comprobantes encontrados, como cadena.
    Resultado: el conteo, sin necesidad de decodificar nada.
  7. Decodifica responseDataField.responseData2Field desde Base64 si el conteo es mayor que 0.
    Resultado: el XML DocsFoundBy con el detalle de cada comprobante localizado.
  8. 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 tu ERP.
    • Mayor que 1 — existe más de un comprobante con el mismo Número Interno. No reintentes y verifica.

    Resultado: decisión de reintento tomada sobre evidencia, no sobre suposición.
  9. Actualiza tu 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, sin duplicado emitido.

Si algo falla, ve a Solución de problemas.


Contrato técnico

1. Endpoint y operación

Protocolo HTTP/1.1 sobre HTTPS · arquitectura REST con cuerpo JSON
Método POST
Recurso /RequestTransaction
Content-Type application/json
Accept application/json
Valor Transaction LOOKUP_ISSUED_INTERNAL_ID
Naturaleza Consulta. No modifica el estado de ningún comprobante


2. Ambientes

Ambiente URL
Pruebas https://api.mysuitetest.com/RequestTransaction
Producción https://api.mysuitecfdi.com/RequestTransaction
RFC de pruebas: JES900109Q90

La consulta solo alcanza a los comprobantes emitidos bajo el RFC declarado en Entity y en el ambiente en que consultas: un Número Interno timbrado en pruebas no se encuentra en producción, ni al contrario.


3. Autenticación

Esta modalidad no usa token: las credenciales viajan como campos del cuerpo JSON en cada petición.

Campo Tipo Obligatorio Formato Descripción
Requestor string Sí GUID Dato que proporciona MYSuite, relacionado con la seguridad de la transacción, con los procesos de autenticación y autorización
Transaction string Sí Literal en mayúsculas Método que quieres invocar. Para esta transacción: LOOKUP_ISSUED_INTERNAL_ID
Country string Sí Valor fijo MX Abreviatura del país
Entity string Sí RFC (12–13 caracteres) RFC de quien realiza la solicitud, es decir, la empresa que consulta desde su ERP. En ambiente de test es JES900109Q90
User string Sí GUID Se repite el valor de Requestor
UserName string Sí Country.Entity.Usuario_ERP Identifica al usuario del ERP. Ejemplo: MX.JES900109Q90.Jan


4. Parámetros de entrada

Nombre Tipo Obligatorio Límite Formato Descripción
Data1 string Sí El nodo NumeroInterno del XML Nativo admite hasta 250 caracteres Texto plano, sin codificar Número Interno a buscar, tal como lo escribiste en el nodo NumeroInterno del XML Nativo al emitir
Data2 string No — Clave de Sucursal, texto plano Sucursal. Si la especificas, también se toma como parámetro en la búsqueda del comprobante. Si la omites, 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 va vacío se considera el año actual. Para buscar comprobantes de años anteriores tienes que especificarlo
A diferencia de CONVERT_NATIVE_XML, aquí ningún parámetro de entrada se codifica en Base64. Los tres campos viajan en texto plano dentro del JSON.


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

Los tres parámetros son valores, sin estructura interna.

Campo Contenido Ejemplo de forma
Data1 Número Interno del comprobante, según el control de tu sistema administrativo CA_1_3
Data2 Clave de la Sucursal. En el ejemplo publicado coincide con la Serie del comprobante ABB
Data3 Año de emisión, o cadena vacía para el año en curso 2019 ó ""


6. Ejemplo de request

POST /RequestTransaction HTTP/1.1
Host: api.mysuitetest.com
Content-Type: application/json

{
"Requestor": "0c320b03-d4f1-47bc-9fb4-77995f9bf33e",
"Transaction": "LOOKUP_ISSUED_INTERNAL_ID",
"Country": "MX",
"Entity": "JES900109Q90",
"User": "0c320b03-d4f1-47bc-9fb4-77995f9bf33e",
"UserName": "MX.JES900109Q90.Jan",
"Data1": "10001",
"Data2": "ABB",
"Data3": ""
}

7. Ejemplo de response

{
"requestField": {
"requestorField": "00000000-0000-0000-0000-000000000000",
"requestorNameField": null,
"requestorActiveField": true,
"transactionField": 50,
"countryField": "MX",
"entityField": "JES900109Q90",
"userField": "00000000-0000-0000-0000-000000000000",
"userNameField": "MX.JES900109Q90.Jan",
"idField": "2ea498bc-1804-4d7a-b04c-1a01282f9062",
"timeStampField": "2026-09-22T17:34:41.285846-06:00"
},
"responseField": {
"resultField": true,
"timeStampField": "2026-09-22T17:34:41.3158471-06:00",
"lastResultField": "",
"codeField": 1,
"descriptionField": "",
"hintField": "",
"dataField": " 32037 2ea498bc-1804-4d7a-b04c-1a01282f9062",
"processorField": "TEST-BACK03",
"identifierField": null,
"batchIdentifierField": null
},
"responseDataField": {
"responseData1Field": "0",
"responseData2Field": "",
"responseData3Field": "",
"responseDataSetField": null
}
}


Ejemplo cuando existe más de un cfdi con un número interno:

{
"requestField": {
"requestorField": "00000000-0000-0000-0000-000000000000",
"requestorNameField": null,
"requestorActiveField": true,
"transactionField": 50,
"countryField": "MX",
"entityField": "JES900109Q90",
"userField": "00000000-0000-0000-0000-000000000000",
"userNameField": "MX.JES900109Q90.Jan",
"idField": "09a30a6c-3575-453a-9bee-fc2cde520282",
"timeStampField": "2026-09-22T17:35:29.5733988-06:00"
},
"responseField": {
"resultField": true,
"timeStampField": "2026-09-22T17:35:29.5893425-06:00",
"lastResultField": "",
"codeField": 1,
"descriptionField": "",
"hintField": "",
"dataField": " 32038 09a30a6c-3575-453a-9bee-fc2cde520282",
"processorField": "TEST-BACK03",
"identifierField": null,
"batchIdentifierField": null
},
"responseDataField": {
"responseData1Field": "5",
"responseData2Field": "PERvY3NGb3VuZEJ5IGludGVybmFsSWQ9IjEiIGNvdW50PSI1IiB5ZWFyPSIiPgo8ZG9jIHBvcz0iMSI+CjxjdHJ5Pk1YPC9jdHJ5Pgo8dGF4SWQ+SkVTOTAwMTA5UTkwPC90YXhJZD4KPHV1aWQ+YmVjYmIyNDMtMjFlNi00NGI2LTg5ZjctZDJjOWU1NDZmM2IzPC91dWlkPgo8YnJhbmNoPkFCQjwvYnJhbmNoPgo8YmF0Y2g+QUJCPC9iYXRjaD4KPHNlcmlhbD4xMzgyMDwvc2VyaWFsPgo8aXNzdWVkPjIwMjYtMDktMTFUMDI6MjU6MDc8L2lzc3VlZD4KPGNhbmNlbGxlZD4yMDI2LTA5LTE0VDEyOjI4OjU4PC9jYW5jZWxsZWQ+CjxraW5kPjE8L2tpbmQ+CjxjdXJyZW5jeT5NWE48L2N1cnJlbmN5Pgo8dG90YWw+NDIwLjAwMDAwMDwvdG90YWw+CjwvZG9jPgo8ZG9jIHBvcz0iMiI+CjxjdHJ5Pk1YPC9jdHJ5Pgo8dGF4SWQ+SkVTOTAwMTA5UTkwPC90YXhJZD4KPHV1aWQ+N2M3YjgwYzUtNGIzZi00OTFhLWI0ZGYtY2I0N2VlYmNiODcyPC91dWlkPgo8YnJhbmNoPkFCQjwvYnJhbmNoPgo8YmF0Y2g+QUJCPC9iYXRjaD4KPHNlcmlhbD4xMzgxOTwvc2VyaWFsPgo8aXNzdWVkPjIwMjYtMDktMTFUMDE6MTY6NDE8L2lzc3VlZD4KPGNhbmNlbGxlZC8+CjxraW5kPjE8L2tpbmQ+CjxjdXJyZW5jeT5NWE48L2N1cnJlbmN5Pgo8dG90YWw+NDIwLjAwMDAwMDwvdG90YWw+CjwvZG9jPgo8ZG9jIHBvcz0iMyI+CjxjdHJ5Pk1YPC9jdHJ5Pgo8dGF4SWQ+SkVTOTAwMTA5UTkwPC90YXhJZD4KPHV1aWQ+OTk2ZmQ2ZWMtNjUyYS00ODFjLWE3OTktZjk4YzI4N2ZjZjM0PC91dWlkPgo8YnJhbmNoPkFCQjwvYnJhbmNoPgo8YmF0Y2g+QUJCPC9iYXRjaD4KPHNlcmlhbD4xMzgxODwvc2VyaWFsPgo8aXNzdWVkPjIwMjYtMDktMTBUMTg6MDY6NTI8L2lzc3VlZD4KPGNhbmNlbGxlZC8+CjxraW5kPjE8L2tpbmQ+CjxjdXJyZW5jeT5NWE48L2N1cnJlbmN5Pgo8dG90YWw+MjAzODUuMDAwMDAwPC90b3RhbD4KPC9kb2M+Cjxkb2MgcG9zPSI0Ij4KPGN0cnk+TVg8L2N0cnk+Cjx0YXhJZD5KRVM5MDAxMDlROTA8L3RheElkPgo8dXVpZD4xMTFkMTFiMy03YWJmLTQ4ZGItYjdkNS00NjRmNTE2NGM1NGQ8L3V1aWQ+CjxicmFuY2g+QUJCPC9icmFuY2g+CjxiYXRjaD5BQkI8L2JhdGNoPgo8c2VyaWFsPjEzNTQ0PC9zZXJpYWw+Cjxpc3N1ZWQ+MjAyNi0wMy0yMFQxNzoxODoxOTwvaXNzdWVkPgo8Y2FuY2VsbGVkLz4KPGtpbmQ+MTwva2luZD4KPGN1cnJlbmN5Pk1YTjwvY3VycmVuY3k+Cjx0b3RhbD4zMDIxNS4wMDAwMDA8L3RvdGFsPgo8L2RvYz4KPGRvYyBwb3M9IjUiPgo8Y3RyeT5NWDwvY3RyeT4KPHRheElkPkpFUzkwMDEwOVE5MDwvdGF4SWQ+Cjx1dWlkPmNlZTU2ZGMyLTA2NzQtNGIxZi1hZTg5LTM3ZTlmMzQ1MTVlMDwvdXVpZD4KPGJyYW5jaD5BQkI8L2JyYW5jaD4KPGJhdGNoPkFCQjwvYmF0Y2g+CjxzZXJpYWw+MTM1MzM8L3NlcmlhbD4KPGlzc3VlZD4yMDI2LTAyLTEyVDE4OjAwOjI0PC9pc3N1ZWQ+CjxjYW5jZWxsZWQvPgo8a2luZD4xPC9raW5kPgo8Y3VycmVuY3k+TVhOPC9jdXJyZW5jeT4KPHRvdGFsPjk1LjAwMDAwMDwvdG90YWw+CjwvZG9jPgo8L0RvY3NGb3VuZEJ5Pgo=",
"responseData3Field": "",
"responseDataSetField": null
}
}


8. Estructura de respuesta — éxito

El cuerpo de la respuesta es un objeto JSON con tres objetos de primer nivel. Todos los nombres de campo llevan el sufijo Field.

requestField — eco de la petición:

Campo Contenido
requestorField · userField GUID recibidos en la petición. Por seguridad se envían con "0" ceros.
requestorNameField Nombre del solicitante. Puede llegar null
requestorActiveField Booleano. Indica si el solicitante está activo
transactionField Entero, no cadena: identificador numérico interno de la transacción.
countryField · entityField · userNameField Eco de los valores recibidos
idField GUID de la operación en la plataforma. Dato a incluir al reportar incidencias
timeStampField Momento de recepción de la petición, con desplazamiento de zona horaria

responseField — resultado del procesamiento:

Campo Contenido
resultField Booleano. true cuando la consulta se ejecutó correctamente
codeField Entero. Código de resultado. Ver apartado 10
timeStampField Momento en que concluyó el procesamiento
lastResultField · descriptionField · hintField Vacíos en consulta exitosa. Ver apartado 9
dataField Cadena de referencia interna del procesamiento
processorField Servidor que atendió la solicitud. Dato a incluir al reportar incidencias
identifierField Llega null. Esta transacción no devuelve datos de identificación del comprobante: el detalle viaja en responseData2Field
batchIdentifierField Llega null

responseDataField — resultado de la búsqueda:

Campo Contenido
responseData1Field Cantidad de documentos encontrados. Llega como cadena JSON, no como número, y no viene en Base64
responseData2Field XML DocsFoundBy codificado en Base64, con el detalle de los documentos encontrados.
responseData3Field Vacío
responseDataSetField Llega null
Asimetría de codificación. responseData1Field llega en texto plano y responseData2Field en Base64. Intentar decodificar el primero produce un error o un valor sin sentido. Fíjate además en que el conteo llega entrecomillado en el JSON: es una cadena, y si tu deserializador espera un entero va a fallar.
Cuando no hay coincidencias: responseData1Field devuelve 0 y responseData2Field llega vacío. El conteo se lee siempre ahí, no en resultField. 


Estructura del XML DocsFoundBy (contenido de responseData2Field 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>...</ctry>
<taxId>...</taxId>
<uuid>...</uuid>
<branch>...</branch>
<batch>...</batch>
<serial>...</serial>
<issued>...</issued>
<cancelled/>
<kind>...</kind>
<currency>...</currency>
<total>...</total>
</doc>
</DocsFoundBy>
Elemento Contenido
@internalId Número Interno consultado, como eco del criterio
@count Cantidad de documentos encontrados. Coincide con responseData1Field
@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 · taxId País y RFC del emisor
uuid Folio Fiscal (UUID). Es el dato que te permite cerrar el comprobante en tu ERP
branch · batch · serial Sucursal, serie y 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 · total Moneda y total del comprobante


9. Estructura de respuesta — error

El cuerpo mantiene los tres objetos del apartado 8. Cambia el contenido de responseField y las cargas llegan vacías.

Campo Contenido en error
resultField false: la consulta no se pudo ejecutar
codeField Código del error. Ver apartado 10
lastResultField Identificador simbólico del error. Es el valor más estable para ramificar tu lógica
descriptionField · hintField Mensaje del error y sugerencia de corrección
processorField Servidor que atendió la solicitud
responseData1Field · responseData2Field Vacíos
Distinción crítica para la lógica antiduplicado. resultField = 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 un error debes reintentar la consulta, no la emisión.
Un error de negocio se reporta con resultField = false dentro de un cuerpo JSON válido. Evalúa siempre ese campo y no asumas é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 consultas
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 Los que encuentre
Latencia esperada
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.
  • El Número Interno proviene del nodo NumeroInterno del XML Nativo FactDocMX v8, opcional en el esquema y con longitud de hasta 250 caracteres.

Solución de problemas

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


Problema. La consulta devuelve responseData1Field con valor 0 para un comprobante que sí existe en MYSuite, con el riesgo de que tu ERP reintente la emisión y genere un duplicado.

Entorno. CFDI + Timbrado · API REST · LOOKUP_ISSUED_INTERNAL_ID.

Resolución. Revisa, en este orden: que el XML Nativo original haya llevado el nodo NumeroInterno, ya que es opcional en el esquema y sin él el comprobante no es localizable por esta vía; que el valor de Data1 coincida exactamente con el que escribiste al emitir; que el año de Data3 corresponda al de emisión, recordando que vacío significa año en curso; y que la Sucursal de Data2, si la enviaste, sea la del comprobante. Si dudas de la Sucursal, envíala vacía para no acotar la búsqueda.

Causa. Cualquiera de los cuatro criterios reduce el alcance. El caso más frecuente en integraciones nuevas es el NumeroInterno ausente en el XML Nativo.

"Mi código no encuentra los campos de la respuesta"


Problema. El deserializador devuelve valores nulos o lanza excepción al mapear la respuesta, aunque el cuerpo JSON llega completo.

Entorno. CFDI + Timbrado · API REST · integraciones nuevas, o migradas desde SOAP.

Resolución. Mapea los nombres exactos de la respuesta, que llevan el sufijo Field y no coinciden con los de la petición: resultField y no Result, responseData1Field y no ResponseData1. La ruta completa del conteo es responseDataField.responseData1Field, en dos niveles de anidamiento.

Causa. La petición usa nombres en PascalCase sin sufijo y la respuesta usa camelCase con sufijo Field. Es asimétrica por diseño.

"El conteo me llega como texto y mi código espera un número"


Problema. La deserialización falla en responseData1Field o el valor no se puede comparar numéricamente.

Entorno. CFDI + Timbrado · API REST · lenguajes con tipado estricto.

Resolución. El conteo viaja entrecomillado en el JSON, es decir, como cadena. Declara el campo como texto y conviértelo tú antes de compararlo. No intentes decodificarlo desde Base64: solo responseData2Field viene codificado.

Causa. Los tres campos de responseDataField comparten el tipo cadena, aunque uno de ellos transporte un número.

"transactionField me devuelve 50 y no el nombre que envié"


Problema. El eco de la petición devuelve un entero donde tu ERP espera recuperar la cadena enviada.

Entorno. CFDI + Timbrado · API REST.

Resolución. No uses transactionField para validar qué transacción se ejecutó. Para correlacionar la respuesta con la petición, usa requestField.idField, que es el identificador de la operación en la plataforma, o el propio Número Interno que enviaste.

Causa. El campo devuelve el identificador numérico interno de la transacción, no la cadena recibida. 

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


Problema. El conteo es mayor que 1 y tu ERP no sabe cuál de los comprobantes es el correcto.

Entorno. CFDI + Timbrado · API REST · integraciones con reintentos automáticos, o con Números Internos reutilizados.

Resolución. No reintentes la emisión. Decodifica responseData2Field y revisa cada elemento doc: el issued te permite identificar el orden de emisión y el cancelled indica si alguno ya fue cancelado. Escala el caso para determinar qué comprobante conservar y cancelar el resto conforme al esquema vigente.

Causa. O tu ERP reintentó una emisión sin verificar antes, o el Número Interno no es único en tu sistema. Si es lo segundo, corrige la generación del identificador: de lo contrario la verificación antiduplicado no es confiable.

"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 · API REST · conciliaciones históricas, o consultas hechas en enero sobre comprobantes de diciembre.

Resolución. Especifica 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, ejecuta 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 lo consultas en enero sin especificar el año.

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


Problema. Ante resultField = false, el ERP interpreta que el comprobante no fue emitido y reintenta CONVERT_NATIVE_XML, generando un CFDI duplicado.

Entorno. CFDI + Timbrado · API REST · lógica de recuperación ante TimeOut.

Resolución. Trata resultField = 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 antes de volver a timbrar. El único valor que autoriza reintentar la emisión es un conteo de 0 con resultField = 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 campos distintos.


Para entender más

El problema que esta transacción resuelve

El timbrado 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 tu 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 ahí, tienes dos opciones malas: no reintentar y quedarte 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, tu ERP no conoce el folio ni el UUID: los asigna MYSuite y viajan justamente en la respuesta que no llegó. El Número Interno es el único identificador que conoces antes de la llamada, porque lo generas tú y lo escribes en el XML nativo. Es el único puente disponible hacia un comprobante cuyo folio desconoces.

Por qué el Número Interno es responsabilidad tuya

El nodo NumeroInterno es opcional en el esquema del XML Nativo, y MYSuite no valida su unicidad. Eso tiene una consecuencia práctica que conviene aceptar de entrada: tu capacidad de recuperarte de un TimeOut depende de una decisión de diseño que tomas 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 responseData1Field te permite decidir sin decodificar nada. El detalle en responseData2Field sirve al segundo caso de uso, que es cerrar el comprobante en tu 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é identifierField llega vacío

En las transacciones de emisión y de recuperación, ese objeto trae los datos del comprobante. Aquí no puede: la consulta puede devolver varios documentos, y un objeto pensado para uno solo no sirve. Por eso el detalle viaja en un XML aparte, con capacidad para tantos elementos como haga falta. Verlo en null no es señal de que algo salió mal.

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, puedes ejecutarla tantas veces como necesites sin consecuencias. Esa asimetría es la que hace viable el patrón completo: verificar cuantas veces haga falta, emitir una sola.

Por qué la respuesta usa nombres con sufijo Field

El servicio REST y el servicio SOAP comparten el mismo contrato de datos del lado del servidor. La respuesta JSON es una proyección directa de ese contrato, y los sufijos son un vestigio de la serialización de los campos de respaldo de las propiedades del objeto original. No es un descuido de nomenclatura: es la huella del mismo objeto expuesto por dos transportes. Conviene tratarla como parte estable del contrato y aislarla en una capa de mapeo de tu lado.

Por qué SOAP y REST se documentan por separado

La transacción es la misma operación de negocio en ambos transportes: mismos criterios, mismo XML de detalle, mismo resultado. Lo que cambia es 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.


Transacciones del servicio CFDI + Timbrado (API REST)


Vía RequestTransaction


      Emisión
      Consulta y Recuperación
      Validación y Recepción
      CFDI de Retenciones


Vía JsonServiceCall

      Autenticación (obtención de token)
      Emisión
      Consulta y Recuperación
      Esquema de cancelación