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

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

Estado Transacción: Vigente · Compatibilidad: Esquema de cancelación vigente · Última revisión: 07/08/2026 · Próxima revisión: 07/11/2026 · Responsable: Jan Martínez


De un vistazo


Qué hace: consulta al SAT el estado de cancelación de un CFDI y te devuelve cinco datos: si el comprobante se obtuvo correctamente, si es cancelable y bajo qué condiciones, en qué estado está, en qué punto va su cancelación si la hay, y el resultado de la verificación del emisor contra las listas del artículo 69-B.


Cuándo se usa: después de solicitar una cancelación con CANCEL_DOCUMENT_3 (para saber si se consumó); antes de solicitarla, para saber si el comprobante es cancelable y si requerirá la aceptación del receptor; y al recibir una factura de un proveedor, para verificar su estado y su validación EFOS.

Cuándo no usarla: no cancela nada, solo informa. Para solicitar la cancelación usa CANCEL_DOCUMENT_3. Para recuperar el XML o el PDF de un comprobante, usa RETRIEVE_DOCUMENT.


Estado y EstatusCancelacion son dos cosas distintas. Un comprobante puede aparecer como Vigente y al mismo tiempo tener su cancelación En proceso. No se contradicen: el primero dice qué es el comprobante hoy ante el SAT, el segundo dice en qué punto va el trámite. Tu ERP debe leer los dos.
Lo que devuelve esta transacción no es un acuse en sentido legal, porque no viene firmado digitalmente por el SAT. El acuse firmado es el que entrega CANCEL_DOCUMENT_3 al solicitar la cancelación. Esto es información, no evidencia.
Advertencia de homonimia. CONSULTAR_DOCUMENTO existe también en la modalidad CFDI + Timbrado sobre SOAP. Cada transporte se documenta en un artículo independiente. Este artículo cubre exclusivamente API REST.


Cómo saber si este es tu artículo

Si tu integración… Tu artículo es...
Consulta el estado de un CFDI por RequestTransaction, enviando un cuerpo JSON por HTTP POST Este artículo
Consulta lo mismo por JsonServiceCall, con token de AUTHENTICATE CONSULT_DOCUMENT — CFDI + Timbrado (API REST) - JsonServiceCall
Hace lo mismo enviando un sobre SOAP a FactWSFront CONSULTAR_DOCUMENTO — CFDI + Timbrado (SOAP)
Va a solicitar la cancelación de un CFDI enviando un cuerpo JSON por HTTP POST CANCEL_DOCUMENT_3 — CFDI + Timbrado (API REST) - Request Transaction
Necesita el XML o el PDF del comprobante enviando un cuerpo JSON por HTTP POST RETRIEVE_DOCUMENT — CFDI + Timbrado (API REST) - Request Transaction


Requisitos previos

  • Credenciales de integración vigentes que te proporciona MYSuite: Requestor y Entity.
  • El Folio Fiscal (UUID) del comprobante y el RFC de su emisor.
  • Saber si el comprobante es emitido o recibido, porque cambia el valor de docType y si el año es obligatorio.
  • El año de emisión, si consultas un comprobante emitido.


Cómo hacerlo

  1. Determina si el comprobante es emitido o recibido: define el valor de docType —issued o received— y si tienes que enviar el año.
    Resultado: los criterios que necesitas reunir.
  2. Construye la estructura de criterios con docType, emisor, folioFiscal y, para comprobantes emitidos, year.
    Resultado: los cuatro criterios de la consulta.
  3. Codifica esa estructura en Base64, sin saltos de línea intermedios.
    Resultado: la cadena que vas a poner en Data1.
  4. Arma el cuerpo JSON con los nueve campos: las credenciales, Transaction con valor CONSULTAR_DOCUMENTO, la cadena Base64 en Data1, Data2 y Data3 como cadenas vacías.
    Resultado: un JSON válido con los nueve campos presentes.
  5. 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.
  6. Lee responseField.resultField.
    Resultado: resultField = true te permite continuar; resultField = false te lleva a Solución de problemas.
  7. Decodifica responseDataField.responseData1Field desde Base64 para obtener los cinco datos del estado en formato JSON. Es el campo más cómodo de procesar.
    Resultado: CodigoEstatus, EsCancelable, Estado, EstatusCancelacion y ValidacionEFOS.
  8. Evalúa los dos campos que importan juntos: Estado dice qué es el comprobante hoy y EstatusCancelacion dice en qué punto va el trámite. Leer solo uno lleva a conclusiones equivocadas.
    Resultado: el estado real del comprobante.
  9. Revisa EsCancelable si tu intención es cancelar: te dice de antemano si el comprobante requerirá la aceptación del receptor.
    Resultado: expectativa realista del trámite antes de iniciarlo.
  10. Actualiza tu ERP con el resultado, y repite la consulta más adelante si la cancelación sigue en proceso.
    Resultado: estado conciliado contra el SAT, no supuesto.

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 CONSULTAR_DOCUMENTO
Naturaleza Consulta ante la autoridad. No modifica el estado de ningún comprobante
Autenticación Credenciales en el cuerpo de cada petición. No requiere token, a diferencia de la vía JsonServiceCall
Consumo No descuenta folios del paquete vigente


2. Ambientes

Ambiente URL
Pruebas https://api.mysuitetest.com/RequestTransaction
Producción https://api.mysuitecfdi.com/RequestTransaction

Un cliente CFDI + Timbrado (API REST) debe usar JES900109Q90 como Entity en pruebas; en producción, el RFC del emisor.


3. Autenticación

Esta vía 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 MYSuite proporciona al emisor, relacionado con la seguridad de la transacción, autenticación y autorización
Transaction string Sí Literal en mayúsculas Método que quieres invocar. Para esta transacción: CONSULTAR_DOCUMENTO
Country string Sí Valor fijo MX Abreviatura del país
Entity string Sí RFC (12–13 caracteres) RFC de quien realiza la consulta. En pruebas JES900109Q90; en producción, el RFC del emisor
User string Sí GUID Se repite el valor de Requestor
UserName string Sí Country.Entity.Usuario_ERP Identifica al usuario del ERP. Ejemplo: MX.ETN040506RB3.Jan

4. Parámetros de entrada

Nombre Tipo Obligatorio Formato Descripción
Data1 string Sí Base64 Estructura de criterios de la consulta, codificada en Base64. Ver apartado 5
Data2 string No Cadena vacía "" Sin uso en esta transacción. El campo debe estar presente en el JSON con valor vacío
Data3 string No Cadena vacía "" Sin uso en esta transacción. El campo debe estar presente en el JSON con valor vacío
A diferencia de CANCEL_DOCUMENT_3, que envía dos estructuras Dictionary en XML, esta transacción envía una sola estructura y en formato JSON.


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

Data1 — criterios de la consulta

{
"docType": "issued",
"emisor": "[RFC del emisor]",
"folioFiscal": "[UUID del CFDI]",
"year": "[año de emisión]"
}
Clave Obligatorio Formato Descripción
docType Sí issued · received Tipo de documento que quieres consultar: emitido o recibido
emisor Sí RFC RFC del emisor de la factura
folioFiscal Sí UUID Folio Fiscal del comprobante (36 caracteres)
year Condicional Año AAAA Año de la fecha de emisión. Solo es obligatorio para documentos emitidos, es decir cuando docType vale issued


Data2 y Data3

Sin estructura. Ambos se envían como cadena vacía.


6. Ejemplo de request

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

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


7. Ejemplo de response

{
"requestField": {
"requestorField": "00000000-0000-0000-0000-000000000000",
"requestorNameField": null,
"requestorActiveField": true,
"transactionField": 248,
"countryField": "MX",
"entityField": "JES900109Q90",
"userField": "00000000-0000-0000-0000-000000000000",
"userNameField": "MX.JES900109Q90.Jan",
"idField": "46aa2a19-49e4-48dc-abb1-41ade4c3ebde",
"timeStampField": "2026-10-06T13:51:09.0558267-06:00"
},
"responseField": {
"resultField": true,
"timeStampField": "2026-10-06T13:51:09.2129448-06:00",
"lastResultField": "",
"codeField": 1,
"descriptionField": "",
"hintField": "",
"dataField": " 7452 46aa2a19-49e4-48dc-abb1-41ade4c3ebde",
"processorField": "TEST-BACK03",
"identifierField": {
"countryField": "MX",
"entityField": "JES900109Q90",
"fiscalNameField": "JIMENEZ ESTRADA SALAS A A",
"aYearField": "0",
"aNumberField": "",
"batchField": "ABB",
"serialField": "13819",
"documentGUIDField": "7c7b80c5-4b3f-491a-b4df-cb47eebcb872",
"issuedTimeStampField": "2026-09-11T01:16:41",
"enrolledTimeStampField": "2026-09-11T01:16:44",
"paidTimeStampField": "",
"cancelledTimeStampField": "",
"internalIDField": "1",
"batchIDField": "",
"batchTimeStampField": "",
"batchRequestorCountryField": "",
"batchRequestorEntityField": "",
"batchPositionField": "",
"receiverCountryField": "MX",
"receiverEntityField": "XAXX010101000",
"receiverTaxIDField": "",
"receiverNameField": "PUBLICO EN GENERAL",
"claveAgenteField": "",
"numeroDePolizaField": "",
"currencyField": "MXN",
"totalAmountField": "420.00",
"type1Field": "ingreso",
"type2Field": "FACTURA",
"suggestedFileNameField": "JES900109Q90_ABB_13819_XAXX010101000",
"suggestedFileName2Field": "11092026__1_ABB13819_",
"observacionesField": null,
"observacionesHtmlField": null
},
"batchIdentifierField": null
},
"responseDataField": {
"responseData1Field": "eyJDb2RpZ29Fc3RhdHVzIjoiUyAtIENvbXByb2JhbnRlIG9idGVuaWRvIHNhdGlzZmFjdG9yaWFtZW50ZS4iLCJFc0NhbmNlbGFibGUiOiJDYW5jZWxhYmxlIHNpbiBhY2VwdGFjacOzbiIsIkVzdGFkbyI6IlZpZ2VudGUiLCJFc3RhdHVzQ2FuY2VsYWNpb24iOiIiLCJWYWxpZGFjaW9uRUZPUyI6IjIwMCJ9",
"responseData2Field": "PD94bWwgdmVyc2lvbj0iMS4wIiBlbmNvZGluZz0idXRmLTgiPz4NCjxBY3VzZSB4bWxuczp4c2k9Imh0dHA6Ly93d3cudzMub3JnLzIwMDEvWE1MU2NoZW1hLWluc3RhbmNlIiB4bWxuczp4c2Q9Imh0dHA6Ly93d3cudzMub3JnLzIwMDEvWE1MU2NoZW1hIj4NCiAgPEV4dGVuc2lvbkRhdGEgLz4NCiAgPENvZGlnb0VzdGF0dXM+UyAtIENvbXByb2JhbnRlIG9idGVuaWRvIHNhdGlzZmFjdG9yaWFtZW50ZS48L0NvZGlnb0VzdGF0dXM+DQogIDxFc0NhbmNlbGFibGU+Q2FuY2VsYWJsZSBzaW4gYWNlcHRhY2nDs248L0VzQ2FuY2VsYWJsZT4NCiAgPEVzdGFkbz5WaWdlbnRlPC9Fc3RhZG8+DQogIDxFc3RhdHVzQ2FuY2VsYWNpb24gLz4NCiAgPFZhbGlkYWNpb25FRk9TPjIwMDwvVmFsaWRhY2lvbkVGT1M+DQo8L0FjdXNlPg==",
"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. Valores en ceros por seguridad.
requestorNameField Nombre del solicitante. Puede llegar null
requestorActiveField Booleano. Indica si el solicitante está activo
transactionField Entero. No lo uses para identificar 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 de MYSuite. Ver apartado 10
timeStampField Momento en que concluyó el procesamiento
lastResultField · descriptionField · hintField Vacíos en consulta exitosa. Ver apartado 9
dataField · processorField Referencia interna del procesamiento y Servidor que atendió la solicitud
identifierField Objeto poblado con los datos del comprobante consultado. Ver desglose siguiente
batchIdentifierField Llega null

responseField.identifierField — datos del comprobante:

Campo Contenido
documentGUIDField Folio Fiscal del comprobante consultado. Permite confirmar que la respuesta corresponde al CFDI que preguntaste
countryField · entityField · fiscalNameField País, RFC y razón social del emisor
batchField · serialField Serie y folio del comprobante
issuedTimeStampField · enrolledTimeStampField Fechas de emisión y de registro en MYSuite
cancelledTimeStampField Fecha de cancelación registrada en MYSuite. Llega vacía mientras el trámite no se consuma. No la confundas con EstatusCancelacion, que es lo que dice el SAT
internalIDField Número Interno que enviaste al emitir, si lo hubo
receiverCountryField · receiverEntityField · receiverNameField País, RFC y nombre del receptor
currencyField · totalAmountField Moneda e importe total
type1Field · type2Field type1Field = Tipo de comprobante SAT; type2Field = Tipo de comprobante MYSuite
suggestedFileNameField · suggestedFileName2Field Nombres sugeridos para guardar archivos del comprobante
Campos de lote y observaciones Llegan vacíos o null: no aplican a esta transacción
Que esta transacción devuelva el identificador poblado tiene una utilidad práctica: te permite conciliar el estado que reporta el SAT con los datos que MYSuite tiene registrados del comprobante, en una sola llamada.

responseDataField — resultado de la consulta:

Campo Contenido
responseData1Field Resultado en formato JSON, codificado en Base64. Es el campo más cómodo de procesar
responseData2Field El mismo resultado en formato XML, codificado en Base64.
responseData3Field Vacío
responseDataSetField Llega null
Los dos primeros campos traen lo mismo en dos formatos. No hace falta leer ambos: elige uno. Y fíjate en la diferencia con CANCEL_DOCUMENT_3, la transacción que se invoca justo antes en este flujo: allí responseData2Field llega en texto plano, y aquí llega en Base64.


Contenido del resultado en formato JSON: los cinco campos del estado

{
"CodigoEstatus": "S - Comprobante obtenido satisfactoriamente.",
"EsCancelable": "Cancelable sin aceptación",
"Estado": "Vigente",
"EstatusCancelacion": "En proceso",
"ValidacionEFOS": "200"
}


El mismo contenido en XML:

<?xml version="1.0" encoding="utf-8"?>
<Acuse ...>
<ExtensionData />
<CodigoEstatus>...</CodigoEstatus>
<EsCancelable>...</EsCancelable>
<Estado>...</Estado>
<EstatusCancelacion>...</EstatusCancelacion>
<ValidacionEFOS>...</ValidacionEFOS>
</Acuse>
Campo Qué responde Valor observado
CodigoEstatus Si la consulta localizó el comprobante ante el SAT. Es el resultado de la consulta, no del comprobante S - Comprobante obtenido satisfactoriamente.
EsCancelable Si el comprobante admite cancelación y bajo qué condiciones. Determina si el trámite requerirá la aceptación del receptor Valores: Cancelable sin aceptación o Cancelable con aceptación
Estado Qué es el comprobante hoy ante el SAT Estado del CFDI ante el SAT; Valores: Vigente o Cancelado
EstatusCancelacion En qué punto va el trámite de cancelación, si existe alguno. Vacío cuando no se ha solicitado Valores: En proceso, No Cancelable, Cancelado sin aceptación, Cancelado con aceptación, Cancelado plazo vencido y Solicitud rechazada
ValidacionEFOS Resultado de la verificación del emisor contra las listas del artículo 69-B del Código Fiscal de la Federación Valores:

Código= 100

Este código de respuesta se presentará cuando la validación del RFC Emisor del CFDI se encuentre dentro de la lista de Empresa que Factura Operaciones Simuladas (EFOS)

Código=200

Este código de respuesta se presentará cuando la validación del RFC Emisor del CFDI no se encuentre dentro de la lista de Empresa que Factura Operaciones Simuladas (EFOS).



Lee Estado y EstatusCancelacion juntos. Un ERP que decida solo con Estado tratará como plenamente vigente un comprobante cuya cancelación ya está en curso; uno que decida solo con EstatusCancelacion lo dará por cancelado antes de tiempo.


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
Tres señales distintas, no una. resultField dice si la consulta se ejecutó; CodigoEstatus dice si el SAT localizó el comprobante; Estado dice qué es el comprobante. Un error de consulta no significa que el comprobante no exista, y un comprobante no localizado no significa que la consulta haya fallado.


10. Códigos de Error


11. Límites y comportamiento

Aspecto Valor
Comprobantes por llamada Uno. El criterio es un único Folio Fiscal
Alcance Comprobantes emitidos y recibidos, según docType, del ambiente en que consultas
Alcance temporal Un año por consulta en comprobantes emitidos, determinado por year. En recibidos el año no es obligatorio
Efectos Ninguno. No cancela, no modifica y no notifica
Idempotencia Es una consulta: reintentarla no tiene efectos colaterales, no tiene costo
Frecuencia recomendada de consulta En MYSuite realizamos una consulta de manera automática cada 24 horas (una vez que se solicitó cancelar un CFDI)
Latencia de actualización La consulta se resuelve contra el servicio de cancelación del SAT, de eso depende el tiempo de respuesta y el comportamiento si el SAT no está disponible.
Timeout 60 segundos en servidor front


12. Versionado y cumplimiento

  • Esta transacción forma parte del esquema de cancelación vigente y es el complemento obligado de CANCEL_DOCUMENT_3: sin ella no hay forma de saber si una cancelación se consumó.
  • Lo que devuelve no es un acuse en sentido legal, porque no viene firmado digitalmente por el SAT. El documento con valor probatorio es el acuse CancelaCFDResult que entrega la solicitud de cancelación. Conserva aquél, no éste.
  • Los valores de los cinco campos los define el SAT, no MYSuite: la plataforma los traslada.
  • ValidacionEFOS remite al artículo 69-B del Código Fiscal de la Federación, que tiene consecuencias sobre la deducibilidad de los comprobantes del emisor.

Solución de problemas

"Me dice Vigente y En proceso al mismo tiempo"


Problema. La respuesta parece contradictoria y el ERP no sabe qué estado asignar al comprobante.

Entorno. CFDI + Timbrado · API REST · seguimiento de cancelaciones.

Resolución. No es contradictorio. Estado dice qué es el comprobante hoy ante el SAT, y EstatusCancelacion dice en qué punto va el trámite. Mientras la cancelación avanza, el comprobante sigue vigente. Contempla en tu ERP un tercer estado, del tipo «cancelación solicitada», que refleje esa situación intermedia.

Causa. Se esperaba un único campo de estado. La cancelación vigente es un proceso, no un acto instantáneo, y por eso necesita dos campos para describirse.

"Consulté un comprobante recibido y me pide el año"


Problema. La consulta falla sobre un comprobante que te emitió un proveedor.

Entorno. CFDI + Timbrado · API REST · verificación de facturas de proveedores.

Resolución. Revisa que docType lleve el valor received y no issued. El año solo es obligatorio para documentos emitidos; si lo envías con received no debería estorbar, pero el criterio que realmente cambia el alcance de la búsqueda es docType. Verifica también que emisor sea el RFC del proveedor que te facturó y no el tuyo.

Causa. Se replicó el patrón de los comprobantes emitidos, donde el emisor eres tú.

"No sé qué significa la validación EFOS"


Problema. La respuesta trae un valor en ValidacionEFOS y el proceso no sabe qué hacer con él.

Entorno. CFDI + Timbrado · API REST · recepción de facturas de proveedores.

Resolución. Es el resultado de verificar al emisor contra las listas del artículo 69-B del Código Fiscal de la Federación, que señalan a contribuyentes con operaciones presuntamente inexistentes. Tiene consecuencias sobre la deducibilidad de sus comprobantes, así que conviene registrarlo y escalarlo al área fiscal, no descartarlo. 
Causa. El campo viene documentado en el artículo.

"Mi código falla al decodificar la respuesta"


Problema. El intento de leer las cargas produce un error o un valor sin sentido.

Entorno. CFDI + Timbrado · API REST · integraciones que implementan el flujo completo de cancelación.

Resolución. Aquí los dos campos de carga vienen en Base64: responseData1Field con el resultado en JSON y responseData2Field con el mismo resultado en XML. Si vienes de implementar CANCEL_DOCUMENT_3, recuerda que allí el segundo campo llega en texto claro. Elige uno de los dos formatos y procesa solo ese: traen lo mismo.

Causa. La codificación de la misma posición de campo cambia entre dos transacciones consecutivas del mismo flujo.

"Llevo días consultando y sigue en proceso"


Problema. La cancelación no avanza y el proceso no sabe si esperar o escalar.

Entorno. CFDI + Timbrado · API REST · seguimiento de cancelaciones.

Resolución. Revisa el valor de EsCancelable: si el comprobante requiere la aceptación del receptor, el trámite depende de que éste responda o de que venza el plazo para hacerlo, y no hay nada que corregir del lado técnico. Si indica que es cancelable sin aceptación y aun así no avanza, escala a Soporte con el idField de la solicitud de cancelación original.

Causa. El esquema de cancelación vigente da derecho al receptor a oponerse en varios supuestos, y en esos casos la demora es parte del procedimiento.

"Quiero guardar esto como comprobante de la cancelación"


Problema. El proceso archiva la respuesta de esta consulta como evidencia del trámite.

Entorno. CFDI + Timbrado · API REST · resguardo documental.

Resolución. Lo que devuelve esta transacción no viene firmado digitalmente por el SAT, así que en sentido legal no es un acuse. El documento con valor probatorio es el acuse CancelaCFDResult que devuelve CANCEL_DOCUMENT_3 al solicitar la cancelación, y ése sí trae el sello del SAT. Guarda aquél; éste úsalo como información operativa.

Causa. El elemento se llama Acuse en el XML, lo que induce a tratarlo como tal. El propio portal advierte que no lo es.


Para entender más

Por qué esta consulta es obligatoria y no opcional

Solicitar una cancelación y saber si se consumó son dos operaciones distintas porque, en el proceso de cancelación vigente, cancelar dejó de ser un acto instantáneo. La solicitud se presenta, el SAT la gestiona y, en varios supuestos, el receptor puede oponerse. Entre la solicitud y el desenlace hay un intervalo que puede durar días, y durante ese intervalo el comprobante sigue surtiendo efectos. Sin esta consulta, el emisor no tiene forma de saber en qué quedó el trámite.

Por qué hacen falta dos campos para describir el estado

Estado responde «qué es este comprobante ahora» y EstatusCancelacion responde «qué está pasando con él». Un solo campo no puede decir ambas cosas: si colapsara las dos, un comprobante con cancelación en curso tendría que aparecer como vigente —ocultando el trámite— o como cancelado —afirmando algo falso—. La separación es la que permite que un ERP represente correctamente la situación intermedia.

La consecuencia de diseño para quien integra es que el modelo de datos necesita un tercer estado. Los sistemas que solo contemplan vigente y cancelado terminan forzando la realidad para que quepa en dos casillas.

Por qué conviene consultar antes de cancelar, no solo después

El campo EsCancelable dice de antemano si el comprobante admite cancelación y si requerirá la aceptación del receptor. Consultarlo antes de solicitar cambia la expectativa del proceso: si el trámite va a depender de un tercero, conviene saberlo al iniciarlo y no cuatro días después, cuando alguien pregunta por qué sigue en proceso.

Qué hace esta respuesta y qué no hace

El XML que devuelve se llama Acuse, pero no viene firmado por el SAT, y el propio portal lo advierte. La distinción importa cuando hay que demostrar algo: el acuse de la solicitud de cancelación sí está sellado por la autoridad y sirve como evidencia de que el trámite se presentó en una fecha determinada; éste es una fotografía del estado en el momento de preguntar, útil para operar pero no para probar. Conviene archivar el primero y tratar el segundo como información.

Un campo que hace más de lo que parece

ValidacionEFOS no habla del comprobante sino de quien lo emitió: verifica al emisor contra las listas del artículo 69-B del Código Fiscal, que señalan a contribuyentes con operaciones presuntamente inexistentes. Que venga incluido en una consulta de estado de cancelación es casi un efecto colateral afortunado, porque convierte esta transacción en una herramienta de revisión de proveedores además de una de seguimiento. Para un área de cuentas por pagar, ese dato puede ser el más valioso de los cinco.

Por qué el resultado viene en dos formatos

El mismo contenido llega en JSON y en XML, cada uno en su propio campo. No hay una diferencia de información entre ambos: es una cortesía hacia integraciones construidas con herramientas distintas. Quien trabaja con JSON procesa el primero; quien tiene una canalización basada en XML usa el segundo. Lo único que conviene evitar es leer los dos, que duplica el trabajo sin añadir nada.

Dos caminos al mismo servicio

La misma consulta existe por RequestTransaction y por JsonServiceCall. La primera envía credenciales en cada petición; la segunda exige obtener antes un token con AUTHENTICATE. Conviven por razones históricas y no son intercambiables: cambian los nombres de los campos, el manejo de la sesión e incluso los criterios, porque la vía con token pide además el mes de emisión. Elegir una al empezar la integración evita tener que mantener las dos.

Por qué SOAP y REST se documentan por separado

La transacción es la misma operación de negocio en ambos transportes: mismos criterios, mismos cinco campos de respuesta. 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