Qué hace: consulta el estado de cancelación de un CFDI emitido o recibido que exista en la base de datos de MYSuite. Te dice si el comprobante está vigente o cancelado, si puede cancelarse y si esa cancelación requiere la aceptación del receptor.
Cuándo se usa: para confirmar el resultado de una cancelación solicitada con CANCEL_DOCUMENT_3; para saber si un comprobante puede cancelarse antes de intentarlo; y para verificar el estado de las facturas que recibes antes de registrarlas o pagarlas.
Cuándo no usarla: para obtener el XML o el PDF del comprobante, estos se piden con RETRIEVE_DOCUMENT. Tampoco solicita cancelar el CFDI.

docType y qué RFC va en el campo emisor.
| Si tu integración… | Tu artículo es... |
|---|---|
| Necesita saber si un CFDI está vigente, en proceso de cancelación o cancelado, por SOAP | Este artículo |
| Va a solicitar la cancelación de un CFDI | CANCEL_DOCUMENT_3 — CFDI + Timbrado (SOAP) |
| Va a cancelar un CFDI de Retenciones | CANCELAR_RETENCION_SINGLE_MYSUITE_3 |
| Necesita el XML o el PDF del comprobante | RETRIEVE_DOCUMENT — CFDI + Timbrado (SOAP) |
| Necesita validar si un CFDI está bien conformado | VALIDATE_DOCUMENT |
|
Necesita validar / recibir un CFDI de proveedor
|
Requestor y Entity.RECEIVE.docType, issued o received.emisor. Es siempre el del emisor de la factura: el tuyo si la emitiste, el de tu proveedor si la recibiste.year si el documento es emitido. En recibidos es opcional.Transaction con valor CONSULTAR_DOCUMENTO, la cadena en Data1, Data2 y Data3 vacíos.RequestTransactionResponse.Result.Result = true te permite continuar; Result = false te lleva a Solución de problemas.ResponseData1 desde Base64 y analízalo como JSON.Estado dice si está vigente o cancelado, EstatusCancelacion dice en qué punto va una cancelación en trámite, y EsCancelable dice si el comprobante admite cancelación y bajo qué condición.ResponseData2 si lo necesitas como respaldo interno, y registra el estado en tu ERP.| Protocolo | SOAP 1.1 / 1.2 sobre HTTPS. El ejemplo publicado usa SOAP 1.2 |
|---|---|
| Servicio | FactWSFront |
| Operación | RequestTransaction |
| Namespace | http://www.fact.com.mx/schema/ws |
| SOAPAction | http://www.fact.com.mx/schema/ws/RequestTransaction |
Valor <Transaction> |
CONSULTAR_DOCUMENTO. |
| Modalidad | ASP (CFDI + Timbrado SOAP) |
| Transacción para | Emisor o Receptor |
| Naturaleza | Consulta. No modifica el estado de ningún comprobante |
| Ambiente | URL |
|---|---|
| Pruebas | https://www.mysuitetest.com/mx.com.fact.wsfront/FactWSFront.asmx |
| Producción | https://www.mysuitecfdi.com/mx.com.fact.wsfront/FactWSFront.asmx |
JES900109Q90 como RFC solicitante (Entity). Solo consultas comprobantes del ambiente en que operas.Esta modalidad no usa token: las credenciales viajan en cada petición.
| Campo | Tipo | Obligatorio | Formato | Descripción |
|---|---|---|---|---|
Requestor |
GUID | Sí | GUID | Dato que proporciona MYSuite, ligado a la seguridad de la transacción, la autenticación y la autorización |
Country |
string | Sí | Valor fijo MX |
Código de país de la operación |
Entity |
string | Sí | RFC (12–13 caracteres) | RFC de quien consulta, es decir el tuyo. No confundir con el campo emisor del JSON, que en comprobantes recibidos es el RFC de tu proveedor |
User |
GUID | Sí | GUID | Identificador del usuario, colocar el valor del Requestor proporcionado por MYSuite |
UserName |
string | Sí | País.RFC.usuario |
Nombre de usuario. Ejemplo asociado al MX.JES900109Q90.jan |
| Nombre | Tipo | Obligatorio | Límite | Formato | Descripción |
|---|---|---|---|---|---|
Data1 |
string | Sí | — | Base64 de una cadena JSON | Criterios para consultar el estado del CFDI. Ver apartado 5 |
Data2 |
string | No | — | Vacío | Sin uso en esta transacción. El nodo debe existir y enviarse vacío |
Data3 |
string | No | — | Vacío | Sin uso en esta transacción. El nodo debe existir y enviarse vacío |
Dictionary XML. Si vienes de implementar CANCEL_DOCUMENT_3 o RETRIEVE_DOCUMENT, la estructura de criterios es distinta aunque el sobre y la codificación en Base64 sean los mismos.{
"docType": "issued",
"emisor": "JES900109Q90",
"folioFiscal": "9ba6a41f-1e78-4f34-882d-d89cc2d8e38b",
"year": "2022"
}| Criterio | Tipo | Obligatorio | Límite | Formato | Descripción |
|---|---|---|---|---|---|
docType |
string | Sí | — | issued ó received |
Tipo de documento que quieres consultar: emitido o recibido |
emisor |
string | Sí | 12–13 | RFC | RFC del emisor de la factura que quieres consultar. En comprobantes recibidos es el RFC del proveedor que te facturó |
folioFiscal |
string | Sí | 36 | UUID | Folio Fiscal de la factura que quieres consultar |
year |
string | Sólo para issued |
4 dígitos | AAAA |
Año de la fecha de emisión de la factura. Obligatorio en documentos emitidos |
Sin estructura. Ambos se envían vacíos.
<soap:Envelope xmlns:soap="http://www.w3.org/2003/05/soap-envelope" xmlns:ws="http://www.fact.com.mx/schema/ws">
<soap:Header/>
<soap:Body>
<ws:RequestTransaction>
<ws:Requestor>0c320b03-d4f1-47bc-9fb4-77995f9bf33e</ws:Requestor>
<ws:Transaction>CONSULTAR_DOCUMENTO</ws:Transaction>
<ws:Country>MX</ws:Country>
<ws:Entity>JES900109Q90</ws:Entity>
<ws:User>0c320b03-d4f1-47bc-9fb4-77995f9bf33e</ws:User>
<ws:UserName>MX.JES900109Q90.jan</ws:UserName>
<ws:Data1>eyAnZG9jVHlwZSc6ICdpc3N1ZWQnLCAnZW1pc29yJzogJ0pFUzkwMDEwOVE5MCcsICdmb2xpb0Zpc2NhbCc6ICc3YzdiODBjNS00YjNmLTQ5MWEtYjRkZi1jYjQ3ZWViY2I4NzInLCAneWVhcic6ICcyMDI2JyB9</ws:Data1>
<ws:Data2></ws:Data2>
<ws:Data3></ws:Data3>
</ws:RequestTransaction>
</soap:Body>
</soap:Envelope><soap:Envelope xmlns:soap="http://www.w3.org/2003/05/soap-envelope" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:xsd="http://www.w3.org/2001/XMLSchema">
<soap:Body>
<RequestTransactionResponse xmlns="http://www.fact.com.mx/schema/ws">
<RequestTransactionResult>
<Request>
<Requestor>00000000-0000-0000-0000-000000000000</Requestor>
<RequestorActive>true</RequestorActive>
<Transaction>CONSULTAR_DOCUMENTO</Transaction>
<Country>MX</Country>
<Entity>JES900109Q90</Entity>
<User>00000000-0000-0000-0000-000000000000</User>
<UserName>Jan_Test</UserName>
<Id>2117f1e1-b074-4ff0-b8c3-c1a40075b539</Id>
<TimeStamp>2026-09-15T09:54:02.2921382-06:00</TimeStamp>
</Request>
<Response>
<Result>true</Result>
<TimeStamp>2026-09-15T09:54:02.7071048-06:00</TimeStamp>
<LastResult/>
<Code>1</Code>
<Description/>
<Hint/>
<Data>5042 2117f1e1-b074-4ff0-b8c3-c1a40075b539</Data>
<Processor>TEST-BACK03</Processor>
<Identifier>
<Country>MX</Country>
<Entity>JES900109Q90</Entity>
<FiscalName>JIMENEZ ESTRADA SALAS A A</FiscalName>
<AYear>0</AYear>
<ANumber/>
<Batch>ABB</Batch>
<Serial>13819</Serial>
<DocumentGUID>7c7b80c5-4b3f-491a-b4df-cb47eebcb872</DocumentGUID>
<IssuedTimeStamp>2026-09-11T01:16:41</IssuedTimeStamp>
<EnrolledTimeStamp>2026-09-11T01:16:44</EnrolledTimeStamp>
<PaidTimeStamp/>
<CancelledTimeStamp/>
<InternalID>1</InternalID>
<BatchID/>
<BatchTimeStamp/>
<BatchRequestorCountry/>
<BatchRequestorEntity/>
<BatchPosition/>
<ReceiverCountry>MX</ReceiverCountry>
<ReceiverEntity>XAXX010101000</ReceiverEntity>
<ReceiverTaxID/>
<ReceiverName>PUBLICO EN GENERAL</ReceiverName>
<ClaveAgente/>
<NumeroDePoliza/>
<Currency>MXN</Currency>
<TotalAmount>420.00</TotalAmount>
<Type1>ingreso</Type1>
<Type2>FACTURA</Type2>
<SuggestedFileName>JES900109Q90_ABB_13819_XAXX010101000</SuggestedFileName>
<SuggestedFileName2>11092026__1_ABB13819_</SuggestedFileName2>
</Identifier>
</Response>
<ResponseData>
<ResponseData1>eyJDb2RpZ29Fc3RhdHVzIjoiUyAtIENvbXByb2JhbnRlIG9idGVuaWRvIHNhdGlzZmFjdG9yaWFtZW50ZS4iLCJFc0NhbmNlbGFibGUiOiJDYW5jZWxhYmxlIHNpbiBhY2VwdGFjacOzbiIsIkVzdGFkbyI6IlZpZ2VudGUiLCJFc3RhdHVzQ2FuY2VsYWNpb24iOiIiLCJWYWxpZGFjaW9uRUZPUyI6IjIwMCJ9</ResponseData1>
<ResponseData2>PD94bWwgdmVyc2lvbj0iMS4wIiBlbmNvZGluZz0idXRmLTgiPz4NCjxBY3VzZSB4bWxuczp4c2k9Imh0dHA6Ly93d3cudzMub3JnLzIwMDEvWE1MU2NoZW1hLWluc3RhbmNlIiB4bWxuczp4c2Q9Imh0dHA6Ly93d3cudzMub3JnLzIwMDEvWE1MU2NoZW1hIj4NCiAgPEV4dGVuc2lvbkRhdGEgLz4NCiAgPENvZGlnb0VzdGF0dXM+UyAtIENvbXByb2JhbnRlIG9idGVuaWRvIHNhdGlzZmFjdG9yaWFtZW50ZS48L0NvZGlnb0VzdGF0dXM+DQogIDxFc0NhbmNlbGFibGU+Q2FuY2VsYWJsZSBzaW4gYWNlcHRhY2nDs248L0VzQ2FuY2VsYWJsZT4NCiAgPEVzdGFkbz5WaWdlbnRlPC9Fc3RhZG8+DQogIDxFc3RhdHVzQ2FuY2VsYWNpb24gLz4NCiAgPFZhbGlkYWNpb25FRk9TPjIwMDwvVmFsaWRhY2lvbkVGT1M+DQo8L0FjdXNlPg==</ResponseData2>
<ResponseData3/>
</ResponseData>
</RequestTransactionResult>
</RequestTransactionResponse>
</soap:Body>
</soap:Envelope>
La respuesta se organiza en tres bloques dentro de RequestTransactionResult.
| Bloque | Elemento | Contenido |
|---|---|---|
Request |
Eco de los parámetros de identidad | Devuelve Transaction, Country, Entity y UserName |
RequestorActive |
Indica si el solicitante está activo | |
Id · TimeStamp |
Identificador de la operación y momento de recepción | |
Response |
Result |
true cuando la consulta se ejecutó. No es el estado del comprobante |
Code |
Código de resultado. Ver apartado 10 | |
TimeStamp |
Momento en que concluyó el procesamiento | |
LastResult · Description · Hint |
Vacíos en consulta exitosa. Ver apartado 9 | |
Data · Processor |
Referencia interna del procesamiento y Servidor que atendió la solicitud | |
Identifier |
Datos del comprobante tomados de la base de datos de MYSuite. Ver desglose siguiente | |
ResponseData |
ResponseData1 |
JSON en Base64 con el estado del comprobante. Es la respuesta principal |
ResponseData2 |
XML en Base64 con el acuse de la consulta | |
ResponseData3 |
Vacío |
ResponseData1 una vez decodificado{
"CodigoEstatus": "S - Comprobante obtenido satisfactoriamente.",
"EsCancelable": "Cancelable sin aceptación",
"Estado": "Vigente",
"EstatusCancelacion": "",
"ValidacionEFOS": "200"
}| Campo | Qué responde | Valores |
|---|---|---|
CodigoEstatus |
Si la consulta en sí obtuvo el comprobante | Código y descripción |
Estado |
Si el comprobante está Vigente o Cancelado | Estado del CFDI ante el SAT; Valores: Vigente o Cancelado |
EsCancelable |
Si el comprobante admite cancelación y bajo qué condición | Valores: Cancelable sin aceptación o Cancelable con aceptación |
EstatusCancelacion |
En qué punto va una cancelación en trámite. Llega vacío cuando no hay ninguna | Valores: En proceso, No Cancelable, Cancelado sin aceptación, Cancelado con aceptación, Cancelado plazo vencido y Solicitud rechazada |
ValidacionEFOS |
Resultado de la validación del emisor frente a las listas del artículo 69-B | 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). |
ResponseData2 una vez decodificadoUn XML de acuse con los mismos campos que el JSON, dentro de un elemento Acuse: ExtensionData, CodigoEstatus, EsCancelable, Estado, EstatusCancelacion y, cuando aplica, ValidacionEFOS.
Identifier
A diferencia del JSON de estado de cancelación, que refleja la situación fiscal del CFDI, el Identifier trae los datos que MYSuite tiene registrados del comprobante: emisor, receptor, serie, folio, fechas, moneda, importe y clasificación. Es el mismo conjunto de elementos que devuelve RETRIEVE_DOCUMENT.
| Elemento | Contenido |
|---|---|
DocumentGUID |
Folio Fiscal consultado |
Country · Entity · FiscalName |
País, RFC y razón social del emisor |
Batch · Serial |
Serie y folio del comprobante |
IssuedTimeStamp · EnrolledTimeStamp |
Fecha de emisión y de registro en MYSuite |
PaidTimeStamp · CancelledTimeStamp |
Fechas de pago y de cancelación registradas en MYSuite. Para el estado fiscal usa el JSON, no estos campos |
ReceiverCountry · ReceiverEntity · ReceiverName |
Datos del receptor |
Currency · TotalAmount |
Moneda e importe total |
Type1 · Type2 |
Type1 Tipo de Comprobante SAT; Type2 Tipo de Comprobante MYSuite |
El sobre es el mismo del apartado 8. Cambia el contenido de Response y las cargas llegan vacías.
| Elemento | Contenido en error |
|---|---|
Result |
false: la consulta no se pudo ejecutar |
Code |
Código del error. Ver apartado 10 |
LastResult |
Identificador simbólico del error. Es el valor más estable para ramificar tu lógica |
Description · Hint |
Mensaje del error y sugerencia de corrección |
Data |
Bloque de diagnóstico. Dato a incluir al reportar la incidencia a Soporte |
Processor |
Servidor que atendió la solicitud. Dato a incluir al reportar la incidencia a Soporte |
ResponseData1 · ResponseData2 |
Vacíos |
Result = false significa que la consulta no se ejecutó, no que el comprobante no exista ni que esté cancelado. El estado fiscal solo se lee en ResponseData1, y solo cuando Result es true.| Aspecto | Valor |
|---|---|
| Comprobantes por llamada | Uno. El criterio es un único Folio Fiscal |
| Alcance | Comprobantes emitidos y recibidos que existan en las bases de datos de MYSuite |
| Alcance temporal | Determinado por year en documentos emitidos |
| Idempotencia | Es una transacción de consulta: no modifica el estado de ningún comprobante, por lo que reintentarla no tiene efectos colaterales |
| Valor legal del acuse | Ninguno. No viene firmado digitalmente |
| Consumo de folios | Ninguno |
| Latencia | 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. |
| Frecuencia recomendada | En MYSuite realizamos una consulta de manera automática cada 24 horas (una vez que se solicitó cancelar un CFDI) |
| Timeout | 60 segundos en servidor front |
ValidacionEFOS se relaciona con las listas del artículo 69-B del Código Fiscal de la Federación.Problema. Después de CANCEL_DOCUMENT_3 no se sabe si la cancelación se consumó o sigue en trámite.
Entorno. CFDI + Timbrado · SOAP · procesos de cancelación.
Resolución. Consulta aquí y lee Estado junto con EstatusCancelacion. El primero te dice si el comprobante sigue vigente o ya está cancelado; el segundo, si hay un trámite en curso y en qué punto va. Registra la cancelación en tu contabilidad solo cuando Estado lo confirme, no cuando CANCEL_DOCUMENT_3 haya devuelto Result = true.
Causa. Solicitar la cancelación y que la cancelación surta efecto son dos momentos distintos. Cuando se requiere la aceptación del receptor, entre uno y otro puede pasar tiempo.
Problema. La consulta de un comprobante recibido no devuelve resultado.
Entorno. CFDI + Timbrado · SOAP · docType con valor received.
Resolución. Revisa dos cosas. Primero, que el campo emisor lleve el RFC de tu proveedor y no el tuyo: tu RFC va en Entity, fuera del JSON. Segundo, que el comprobante exista en las bases de datos de MYSuite, lo que ocurre si lo diste de alta con RECEIVE; si nunca lo recibiste por esa vía, no hay nada que consultar.
Causa. En comprobantes emitidos, Entity y emisor coinciden y la distinción pasa desapercibida. En recibidos dejan de coincidir, igual que ocurre con IssuerTaxId en RETRIEVE_DOCUMENT.
Problema. La consulta de un comprobante propio no devuelve resultado.
Entorno. CFDI + Timbrado · SOAP · docType con valor issued.
Resolución. Verifica que el JSON incluya year con el año de emisión: es obligatorio para documentos emitidos y su ausencia deja el comprobante fuera de alcance. Comprueba también que el Folio Fiscal esté completo, con sus 36 caracteres y sus guiones, y que consultes el mismo ambiente en que se emitió.
Causa. El criterio year solo es opcional en recibidos, así que un JSON que funciona para un caso no sirve tal cual para el otro.
Problema. La petición falla al construir el contenido de Data1.
Entorno. CFDI + Timbrado · SOAP · integraciones nuevas, o migradas desde otras transacciones.
Resolución. El contenido de Data1 es JSON, no un Dictionary XML como en CANCEL_DOCUMENT_3 y RETRIEVE_DOCUMENT. Genera el JSON con tu serializador habitual, que producirá comillas dobles, y codifícalo completo en Base64 en una sola línea.
Causa. Es la única transacción documentada de esta modalidad que recibe JSON, así que la capa de armado de criterios no se puede compartir con el resto.
Problema. El JSON devuelve varios campos con valores en texto y no queda claro cuál manda.
Entorno. CFDI + Timbrado · SOAP · automatización de decisiones sobre comprobantes.
Resolución. Cada campo responde una pregunta distinta y no son intercambiables. Estado responde qué es el comprobante hoy. EstatusCancelacion responde si hay un trámite en curso. EsCancelable responde qué podrías hacer con él. Para saber si puedes darlo por cancelado usa Estado; para saber si tiene sentido intentar cancelarlo usa EsCancelable.
Problema. Se pretende usar el XML de ResponseData2 como comprobante formal del estado de una factura.
Entorno. CFDI + Timbrado · SOAP · procesos de auditoría o aclaración.
Resolución. El acuse no viene firmado digitalmente, así que no tiene valor probatorio. Consérvalo como evidencia operativa interna de qué consultaste y cuándo, y obtén el respaldo formal por los medios del SAT.
Causa. La propia documentación de la transacción lo advierte: no es un acuse en sentido legal.
Desde el esquema de 2022, cancelar dejó de ser un acto instantáneo. CANCEL_DOCUMENT_3 presenta la solicitud, pero cuando se requiere la aceptación del receptor el desenlace queda en manos de un tercero. Sin una forma de preguntar, el ERP se queda sin saber en qué terminó. Las dos transacciones forman un par: una abre el trámite, la otra lo cierra. Diseñar la cancelación sin incluir la consulta produce contabilidades que registran como cancelado algo que ante el SAT sigue vigente.
Conviene no colapsarlos. Estado describe el presente del comprobante: vigente o cancelado. EstatusCancelacion describe un proceso: si hay un trámite abierto y en qué punto va. EsCancelable describe una posibilidad: si el comprobante admite cancelación y si esa cancelación necesitará que alguien la acepte. Un comprobante vigente con un trámite en curso es una situación normal y transitoria, y solo se entiende leyendo los tres campos juntos.
EsCancelable conviene consultarlo antes de cancelarSaber de antemano si una cancelación requerirá aceptación del receptor cambia lo que tu proceso debe esperar: en un caso el desenlace es inmediato y en el otro puede tardar. Consultar antes te permite decidir si conviene avisar al cliente, cuánto tiempo mantener el comprobante en un estado intermedio en tu ERP, y con qué frecuencia volver a preguntar.
La consulta opera sobre los comprobantes que la plataforma tiene registrados. Para los que emites eso es automático. Para los que recibes no: un CFDI de proveedor solo está ahí si lo diste de alta con RECEIVE. Es una consecuencia poco evidente de esa transacción, y explica por qué un área de cuentas por pagar que quiera verificar el estado de sus facturas necesita primero haberlas recibido en la plataforma.
Un acuse adquiere valor probatorio por la firma digital de quien lo emite, y este llega sin firmar. Eso no lo hace inútil: documenta qué consultaste, cuándo y qué te respondieron, que es exactamente lo que necesitas para una conciliación interna o para justificar una decisión operativa. Lo que no puedes es presentarlo como prueba frente a la autoridad.
El resto de la modalidad SOAP usa estructuras Dictionary en XML; esta transacción usa JSON. Es razonable suponer que se debe a que fue desarrollada después, cuando la plataforma ya exponía una modalidad REST y el formato JSON era el natural del lado del servidor. Para quien integra el efecto es concreto: el sobre y la codificación en Base64 son los mismos, pero la capa que arma los criterios no se puede reutilizar. Es una muestra más de que en esta plataforma los tres nodos de datos no tienen un formato fijo: cada transacción define el suyo.
ValidacionEFOSEs el resultado de contrastar al emisor contra las listas que publica el SAT conforme al artículo 69-B del Código Fiscal de la Federación, que señalan a contribuyentes con operaciones presuntamente inexistentes. Para un área de cuentas por pagar es información valiosa: recibir una factura de un emisor listado tiene consecuencias sobre la deducibilidad. Que el campo aparezca en un ejemplo y no en otro sugiere que se incorporó después, y es un buen recordatorio de que conviene leer este JSON por nombre de campo y tolerar que traiga más elementos de los que esperabas.
La transacción sería la misma operación de negocio en ambos transportes, pero cambia todo lo que rodea al dato: los encabezados, la forma del cuerpo, la nomenclatura de la respuesta y la manera de leerla. Documentar ambos en un solo artículo obligaría al lector a descartar la mitad del contrato técnico en cada consulta, y es precisamente donde se originan los errores de integración.
Emisión
Consulta y Recuperación
Validación y Recepción
CFDI de Retenciones
Esquema de cancelación