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.
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.CANCEL_DOCUMENT_3 al solicitar la cancelación. Esto es información, no evidencia.| 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 |
Requestor y Entity.docType y si el año es obligatorio.docType —issued o received— y si tienes que enviar el año.docType, emisor, folioFiscal y, para comprobantes emitidos, year.Data1.Transaction con valor CONSULTAR_DOCUMENTO, la cadena Base64 en Data1, Data2 y Data3 como cadenas vacías.POST al recurso /RequestTransaction con Content-Type: application/json.responseField.resultField.resultField = true te permite continuar; resultField = false te lleva a Solución de problemas.responseDataField.responseData1Field desde Base64 para obtener los cinco datos del estado en formato JSON. Es el campo más cómodo de procesar.CodigoEstatus, EsCancelable, Estado, EstatusCancelacion y ValidacionEFOS.Estado dice qué es el comprobante hoy y EstatusCancelacion dice en qué punto va el trámite. Leer solo uno lleva a conclusiones equivocadas.EsCancelable si tu intención es cancelar: te dice de antemano si el comprobante requerirá la aceptación del receptor.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 |
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 |
| 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.
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 |
| 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 |
CANCEL_DOCUMENT_3, que envía dos estructuras Dictionary en XML, esta transacción envía una sola estructura y en formato JSON.{
"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 |
Sin estructura. Ambos se envían como cadena vacía.
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": ""
}{
"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
}
}
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 |
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 |
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.{
"CodigoEstatus": "S - Comprobante obtenido satisfactoriamente.",
"EsCancelable": "Cancelable sin aceptación",
"Estado": "Vigente",
"EstatusCancelacion": "En proceso",
"ValidacionEFOS": "200"
}<?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:
|
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.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 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.| 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 |
CANCEL_DOCUMENT_3: sin ella no hay forma de saber si una cancelación se consumó.CancelaCFDResult que entrega la solicitud de cancelación. Conserva aquél, no éste.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.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.
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ú.
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.
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.
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.
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.
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.
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.
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.
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.
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.
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.
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.
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.
Vía RequestTransaction