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.
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.| 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 |
Requestor y Entity.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.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.POST al recurso /RequestTransaction con Content-Type: application/json.responseField.resultField.resultField = true indica que la consulta se ejecutó; resultField = false te lleva a Solución de problemas.responseDataField.responseData1Field tal cual: contiene la cantidad de comprobantes encontrados, como cadena.responseDataField.responseData2Field desde Base64 si el conteo es mayor que 0.DocsFoundBy con el detalle de cada comprobante localizado.CONVERT_NATIVE_XML.uuid del detalle para actualizar tu ERP.Si algo falla, ve a Solución de problemas.
| 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 |
| Ambiente | URL |
|---|---|
| Pruebas | https://api.mysuitetest.com/RequestTransaction |
| Producción | https://api.mysuitecfdi.com/RequestTransaction |
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.
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 |
| 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 |
CONVERT_NATIVE_XML, aquí ningún parámetro de entrada se codifica en Base64. Los tres campos viajan en texto plano dentro del JSON.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 ó "" |
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": ""
}{
"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
}
}
{
"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
}
}
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 |
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.responseData1Field devuelve 0 y responseData2Field llega vacío. El conteo se lee siempre ahí, no en resultField. 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 |
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 |
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.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. | 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 |
NumeroInterno del XML Nativo FactDocMX v8, opcional en el esquema y con longitud de hasta 250 caracteres.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.
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.
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.
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.
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.
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.
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.
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.
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.
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.
identifierField llega vacíoEn 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.
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.
FieldEl 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.
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.
Vía RequestTransaction