Qué hace: solicita al SAT la cancelación de un CFDI conforme al esquema de cancelación Vigente, indicando el motivo y, cuando corresponde, el comprobante que lo sustituye.
Cuándo se usa: cuando necesitas cancelar un comprobante ya certificado, sea por errores en su emisión o porque la operación no se llevó a cabo.
Cuándo no usarla: para saber si un comprobante quedó cancelado. En esta modalidad el estado se consulta con la transacción CONSULT_DOCUMENT, no con ésta.
& como &, < como < y > como >.AUTHENTICATE. El token rota en cada llamada: la petición siguiente debe usar el último token devuelto, no el original.| Si tu integración… | Tu artículo es... |
|---|---|
Cancela un CFDI enviando un sobre SOAP a factwsfront.asmx con la operación JsonServiceCall |
Este artículo |
| Necesita saber si un CFDI ya quedó cancelado, por esta misma modalidad | CONSULT_DOCUMENT — Servicio EndPoint |
Cancela enviando JSON al recurso /JsonServiceCall de API REST |
CANCEL_XML_3 — CFDI + Timbrado (API REST) - JsonServiceCall |
Cancela por RequestTransaction, con credenciales en cada petición |
CANCEL_DOCUMENT_3 — CFDI + Timbrado (API REST) - Request Transaction |
| Envía sobres SOAP con las operaciones clásicas y recibe XML | CANCEL_DOCUMENT_3 — CFDI + Timbrado (SOAP) |
AUTHENTICATE.01, el Folio Fiscal del comprobante que sustituye al cancelado, ya timbrado.AUTHENTICATE, o toma el último que te devolvió la transacción anterior.01 a 04.01, y guarda su Folio Fiscal.motivo, emisor, folioFiscal, year y month, más folioSustitucion si el motivo es 01. Serialízalo con la librería JSON de tu lenguaje, no a mano.ws:JsonServiceCall y sus tres elementos hijos: ws:jsonData con el JSON, ws:transactionName con el literal CANCEL_XML_3 y ws:token con el token vigente.factwsfront.asmx del ambiente que te corresponda.JsonServiceCallResult y analízalo como JSON. No lo recorras como XML.Result, Payload, ErrorMsg, ErrorCode y Token.Result y comprueba que ErrorCode sea 0.Token de la respuesta, sustituyendo el anterior.Payload y consulta después el estado real con CONSULT_DOCUMENT. No marques el comprobante como cancelado a partir de esta respuesta.Si algo falla, ve a Solución de problemas.
| Arquitectura | Híbrida. Sobre SOAP en la petición y en la respuesta; JSON crudo en la petición y JSON dentro del elemento de resultado en la respuesta |
|---|---|
| Versión de SOAP | SOAP 1.2 · espacio de nombres http://www.w3.org/2003/05/soap-envelope |
| Espacio de nombres del servicio | http://www.fact.com.mx/schema/ws |
| Operación SOAP | JsonServiceCall, dentro de soap:Body |
| Transacción | CANCEL_XML_3, indicada en ws:transactionName |
| Naturaleza | Solicitud ante la autoridad. Inicia un proceso que no concluye en esta llamada |
| Autenticación | Token en el elemento ws:token, obtenido con AUTHENTICATE |
| Consumo | No consume folios del paquete vigente |
| 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 |
Solo puedes cancelar comprobantes del ambiente en el que operas. En pruebas el RFC emisor es JES900109Q90.
| Elemento | Tipo | Obligatorio | Descripción |
|---|---|---|---|
ws:token |
string | Sí | Valor obtenido de la transacción AUTHENTICATE, o el último devuelto por cualquier transacción posterior |
No se envían credenciales por petición. El RFC del emisor del comprobante va dentro de jsonData, en el campo emisor.
El elemento ws:JsonServiceCall lleva tres elementos hijos.
| Elemento | Tipo | Obligatorio | Formato | Descripción |
|---|---|---|---|---|
ws:jsonData |
string | Sí | JSON crudo, escapado para XML | Objeto JSON con los criterios de la cancelación. Ver apartado 5 |
ws:transactionName |
string | Sí | Literal | Transacción. Para ésta: CANCEL_XML_3 |
ws:token |
string | Sí | Texto | Valor obtenido de la transacción AUTHENTICATE |
{
"motivo": "[motivo de cancelación]",
"folioSustitucion": "[uuid del cfdi, sólo cuando el motivo sea 01]",
"emisor": "[RFC del emisor]",
"folioFiscal": "[UUID del CFDI a cancelar]",
"year": "[año de emisión]",
"month": "[mes de emisión]"
}| Campo | Obligatorio | Formato | Descripción |
|---|---|---|---|
motivo |
Sí | Dos dígitos, entre comillas | Clave del motivo de cancelación del comprobante. Valores posibles: 01, 02, 03 y 04 |
folioSustitucion |
Condicional | UUID, o cadena vacía | UUID que sustituye al folio fiscal cancelado. Es requerido cuando la clave del motivo es 01; con otros motivos basta con dejarlo vacío |
emisor |
Sí | RFC | RFC del emisor de la factura cuya cancelación se solicita |
folioFiscal |
Sí | UUID | UUID del CFDI cuya cancelación se solicita (36 caracteres) |
year |
Sí | Año AAAA, entre comillas |
Año en que fue emitido el CFDI |
month |
Sí | Mes MM, entre comillas |
Mes en que fue emitido el CFDI |
| Clave | Descripción | Requiere folio de sustitución |
|---|---|---|
01 |
Comprobante emitido con errores con relación | Sí |
02 |
Comprobante emitido con errores sin relación | No |
03 |
No se llevó a cabo la operación | No |
04 |
Operación nominativa relacionada en una factura global | No |
| Carácter | Escapado como |
|---|---|
& |
& |
< |
< |
> |
> |
POST /mx.com.fact.wsfront/factwsfront.asmx HTTP/1.1
Host: www.mysuitetest.com
Content-Type: application/soap+xml; charset=utf-8
<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:JsonServiceCall>
<ws:jsonData>{
"motivo": "02",
"folioSustitucion": "",
"emisor": "JES900109Q90",
"folioFiscal": "aa3aa9de-d88d-4fc0-9ec9-449838987abd",
"year": "2026",
"month": "10"
}</ws:jsonData>
<ws:transactionName>CANCEL_XML_3</ws:transactionName>
<ws:token>[último token devuelto]</ws:token>
</ws:JsonServiceCall>
</soap:Body>
</soap:Envelope>Con motivo 01, el objeto lleva además el folio de sustitución:
{"motivo":"01","emisor":"[RFC]","folioFiscal":"[UUID]",
"year":"[AAAA]","month":"[MM]","folioSustitucion":"[UUID sustituto]"}Forma del sobre, conforme al patrón común de la modalidad:
<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>
<JsonServiceCallResponse xmlns="http://www.fact.com.mx/schema/ws">
<JsonServiceCallResult>
{"Result":true,"Payload":"{\"ResponseData1\":\"PD94bWwgdmVyc2lvbj0iMS4wIiBlbmNvZGluZz0iVVRGLTgiPz48Q2FuY2VsYUNGRFJlc3VsdCBGZWNoYT0iMjAyNi0xMC0xOVQxMDo1MDoxNi4yNjYyNDQ4IiBSZmNFbWlzb3I9IkpFUzkwMDEwOVE5MCIgeG1sbnM9Imh0dHA6Ly9jYW5jZWxhY2ZkLnNhdC5nb2IubXgiPjxGb2xpb3M+PFVVSUQ+QUEzQUE5REUtRDg4RC00RkMwLTlFQzktNDQ5ODM4OTg3QUJEPC9VVUlEPjxFc3RhdHVzVVVJRD4yMDE8L0VzdGF0dXNVVUlEPjwvRm9saW9zPjxTaWduYXR1cmUgSWQ9IlNlbGxvU0FUIiB4bWxucz0iaHR0cDovL3d3dy53My5vcmcvMjAwMC8wOS94bWxkc2lnIyI+PFNpZ25lZEluZm8+PENhbm9uaWNhbGl6YXRpb25NZXRob2QgQWxnb3JpdGhtPSJodHRwOi8vd3d3LnczLm9yZy9UUi8yMDAxL1JFQy14bWwtYzE0bi0yMDAxMDMxNSIgLz48U2lnbmF0dXJlTWV0aG9kIEFsZ29yaXRobT0iaHR0cDovL3d3dy53My5vcmcvMjAwMS8wNC94bWxkc2lnLW1vcmUjaG1hYy1zaGE1MTIiIC8+PFJlZmVyZW5jZSBVUkk9IiI+PFRyYW5zZm9ybXM+PFRyYW5zZm9ybSBBbGdvcml0aG09Imh0dHA6Ly93d3cudzMub3JnL1RSLzE5OTkvUkVDLXhwYXRoLTE5OTkxMTE2Ij48WFBhdGg+bm90KGFuY2VzdG9yLW9yLXNlbGY6OipbbG9jYWwtbmFtZSgpPSdTaWduYXR1cmUnXSk8L1hQYXRoPjwvVHJhbnNmb3JtPjwvVHJhbnNmb3Jtcz48RGlnZXN0TWV0aG9kIEFsZ29yaXRobT0iaHR0cDovL3d3dy53My5vcmcvMjAwMS8wNC94bWxlbmMjc2hhNTEyIiAvPjxEaWdlc3RWYWx1ZT5VOHhSdnFLT25WTDYzYjJya0lQZmhnaWdWM243YWlXN08zbXphS0hBTlkvUndtZnNRRHI0QStxWnNsL3lvQ1FWNEE4SVByd2pkSjNpTHAzOU9Pa1V2QT09PC9EaWdlc3RWYWx1ZT48L1JlZmVyZW5jZT48L1NpZ25lZEluZm8+PFNpZ25hdHVyZVZhbHVlPjFacmxXamRQQXF2ejdDTjR6VDlLTUZ3WW5wbW10U3JQc0IxNUxOSXArQ2lmelRyNXk4b2FJZFlJMC9CSU5IUTI5a2ZvQTFpY0NBbUxiNy8yTm5LK2NBPT08L1NpZ25hdHVyZVZhbHVlPjxLZXlJbmZvPjxLZXlOYW1lPjMwMDAxMDAwMDAwNTAwMDAyNTU0PC9LZXlOYW1lPjxLZXlWYWx1ZT48UlNBS2V5VmFsdWU+PE1vZHVsdXM+aFVjVU9vR0V0U0RBbHJGOEtlZ1FrR0tZOGFEQWU5dE5Sa2Y0OHVqMStZaXJEUDRjTUVkOFlFZWxRWTFqTHUxR0lOWUtmOU45WHhtT2ZIZEw0RlVyK2N1T2dyQnZpYUdXY0lzSmZaODBJR3B2b3g2a1VTSG9SdCtoMzJ5UWF5VzBIdU5PcDBiM3lpQnA5WTZqVGRZVEZUQVZ6Z3pVamY0TGZWdDhuNUZlalZaMnhFUkl5Uk9uR2diSzhBNHhCc1BwRmF6SFFrSzJQQ2lZZStMWUJtMFV4OVVaWWtZSjlNdTlyTDVjNTFTamdxOEpKZWtvcnAwQnpmS2FkUnJTRUZ5RDJaNkd3QjBSc3dqTFpRc3BvalpHeFVucWxibGR2TzZUakZVVjRNVDdFVjhQN2YyVlRTMHlyNHFTd3gweTA4MHpvSzEwQ2JJb0pYZnNGUk9IeXBGajV3PT08L01vZHVsdXM+PEV4cG9uZW50PkFRQUI8L0V4cG9uZW50PjwvUlNBS2V5VmFsdWU+PC9LZXlWYWx1ZT48L0tleUluZm8+PC9TaWduYXR1cmU+PC9DYW5jZWxhQ0ZEUmVzdWx0Pg==\",\"ResponseData2\":\"SAT: 201 - UUID Admitido al proceso de cancelación.\",\"ResponseData3\":\"\"}","ErrorMsg":"","ErrorCode":0,"Token":"OxbZPD1Gd9hUomWYNBUGWkzja54cEGlnz9LLPKZY+pI0+bfE1ldh8TKjBK02xvy5vOVNXoiPjFyrThurHU1oAVo4F9/VhnZdKFEhDu8tPsM="}
</JsonServiceCallResult>
</JsonServiceCallResponse>
</soap:Body>
</soap:Envelope>Dentro de JsonServiceCallResult viaja un objeto JSON plano de cinco campos, en PascalCase.
| Campo | Tipo | Contenido |
|---|---|---|
Result |
booleano | Indica si la transacción fue exitosa, es decir si la solicitud se presentó ante el SAT. No significa que el CFDI esté cancelado |
Payload |
string | ResponseData1 con solicitud recibida firmada por la autoridad fiscal; ResponseData2 texto con la clave recibida por parte del SAT; ResponseData3 vacío |
Token |
string | Token nuevo para la siguiente llamada. Sustituye al que enviaste |
ErrorCode |
entero | Código de error. 0 significa que no hubo error |
ErrorMsg |
string | Descripción del error. Llega vacío en caso exitoso |
Los campos Result, ErrorMsg y ErrorCode tienen el mismo significado en todas las transacciones de la modalidad, tal como se describe en AUTHENTICATE.
JsonServiceCall los mismos cinco campos van en camelCase. Si compartes la clase de deserialización entre ambas modalidades, los campos llegarán nulos sin producir excepción.La solicitud de cancelación produce un acuse CancelaCFDResult firmado digitalmente por el SAT, con el Folio Fiscal y el estatus que la autoridad asignó. Ese acuse es la evidencia de que la solicitud se presentó en una fecha determinada y conviene conservarlo junto al comprobante.
| Clave | Significado | Qué hacer |
|---|---|---|
201 |
UUID admitido al proceso de cancelación | La solicitud se presentó. Consultar después el estado real |
202 |
UUID previamente admitido al proceso de cancelación | Ya lo habías solicitado. No es un error. Consultar el estado |
Para el resto de las claves del SAT, consulta el Catálogo de códigos de error y notificación.
| Campo | Contenido en error |
|---|---|
Result |
false |
ErrorCode |
Código distinto de 0. Ver apartado 10 |
ErrorMsg |
Descripción del error |
Payload |
null |
Token |
null, conservar el token anterior tras un fallo |
ErrorCode es un código de la modalidad; la clave que devuelve el SAT es otra cosa. Un error de la modalidad significa que la autoridad nunca se enteró de tu solicitud; una clave del SAT significa que la solicitud llegó y obtuvo respuesta. La distinción determina si tiene sentido reintentar.| Código | Significado | Causa | Remedio |
|---|---|---|---|
0 |
Sin error | La solicitud se presentó ante el SAT | Consultar después el estado |
101 |
Token expirado | La vida del token expiró | Autenticarte de nuevo con AUTHENTICATE y reintentar |
102 |
Token inválido | Al desencriptar y analizar la información de autenticación, la operación falla | Revisar que envíes el último token devuelto, completo y sin alterar |
| Aspecto | Valor |
|---|---|
| Comprobantes por llamada | Uno. El criterio es un único folioFiscal |
| Alcance | Comprobantes emitidos del RFC indicado en emisor, en el ambiente en que operas |
| Efectos | Inicia un proceso ante la autoridad. No lo concluye: el desenlace depende del SAT y, en ciertos casos, de la aceptación del receptor |
| Idempotencia | Una segunda solicitud sobre el mismo comprobante no genera una segunda cancelación: la autoridad devuelve la clave que indica que el folio ya había sido admitido |
| Plazos de cancelación | Plazos vigentes conforme a normatividad del SAT |
| Aceptación del receptor | Existen supuestos en los que los comprobantes son cancelables con aceptación, para esto, se deberá esperar por respuesta del receptor |
| Consumo de folios | No consume folios del paquete vigente |
| Timeout | 60 segundos en servidor front |
CONSULT_DOCUMENT en esta modalidad..asmx que atiende EndPoint es el mismo que atiende la modalidad SOAP clásica. Un cambio en ese servicio afecta a ambas modalidades.Problema. El ERP marcó el comprobante como cancelado a partir de esta respuesta y el estado ante la autoridad no coincide.
Entorno. EndPoint · seguimiento de cancelaciones.
Resolución. Que la solicitud se presente no significa que el comprobante esté cancelado. Marca el comprobante como «cancelación solicitada» y consulta el estado real con la transacción CONSULT_DOCUMENT antes de darlo por cancelado.
Causa. Se interpretó Result = true como confirmación. Son dos cosas distintas: que la solicitud se presentara y que la cancelación ocurriera.
Problema. La solicitud falla aunque el UUID y el RFC del emisor son los del comprobante.
Entorno. EndPoint · integraciones migradas desde RequestTransaction.
Resolución. Revisa que estés enviando el mes además del año. Esta modalidad exige month, mientras que CANCEL_DOCUMENT_3 por RequestTransaction se conforma con el año. Verifica además que el mes corresponda al de emisión del comprobante y no al mes en curso.
Causa. Diferencia de criterios entre las vías al mismo servicio.
Problema. La solicitud falla al usar el motivo 01.
Entorno. EndPoint · sustitución de comprobantes.
Resolución. El motivo 01 exige el Folio Fiscal del comprobante que sustituye al cancelado en el campo folioSustitucion. Ese comprobante tiene que estar ya timbrado: no puedes cancelar primero y sustituir después. Si lo que quieres es cancelar sin sustituir, el motivo correcto es 02.
Causa. Se omitió folioSustitucion con motivo 01, o se eligió ese motivo sin haber emitido el sustituto.
Problema. El código que recorre la respuesta buscando elementos XML no localiza Result, Payload ni los demás.
Entorno. EndPoint · integraciones nuevas, o migradas desde la modalidad SOAP.
Resolución. No son elementos XML. El contenido de JsonServiceCallResult es una cadena de texto que contiene un objeto JSON. Extrae esa cadena y analízala con tu librería JSON.
Causa. EndPoint es una modalidad híbrida: sobre SOAP, contenido JSON.
Problema. Una solicitud se reenvió tras perder la respuesta.
Entorno. EndPoint · procesos con reintento automático.
Resolución. No se duplica. La autoridad responde con la clave que indica que el folio ya había sido admitido al proceso de cancelación, lo que confirma que tu solicitud anterior sí llegó. Continúa el flujo consultando el estado del comprobante en lugar de tratarlo como error.
Causa. Una solicitud previa se presentó correctamente aunque tu sistema no recibiera la respuesta.
Un CFDI timbrado existe ante el SAT, y retirarlo no es algo que el emisor pueda decidir por sí solo. El esquema de cancelación Vigente convirtió lo que antes era casi automático en un trámite con motivo declarado y, en varios supuestos, con derecho del receptor a oponerse. Esta transacción presenta la solicitud; el desenlace ocurre después y fuera de tu control.
Para la integración eso significa que el comprobante necesita un tercer estado además de vigente y cancelado: cancelación solicitada. Los ERP que solo contemplan dos estados terminan mostrando como cancelado algo que sigue vigente ante la autoridad.
Antes bastaba cancelar; ahora hay que decir por qué. La diferencia no es burocrática: permite a la autoridad distinguir entre un error de facturación, una operación que no ocurrió y una factura global que se desglosó. De las cuatro claves, solo la 01 exige señalar el comprobante que sustituye al cancelado, y por eso obliga a emitir primero el sustituto. Es un orden que conviene reflejar en el flujo del ERP, porque invertirlo deja la cancelación bloqueada a la espera de un folio que todavía no existe.
Conviene subrayar que elegir el motivo no es una decisión técnica. Es una declaración ante la autoridad sobre lo que ocurrió, y corresponde al área fiscal o contable, no al desarrollador que implementa la llamada.
El acuse de cancelación viene firmado digitalmente por el SAT. Eso lo convierte en evidencia verificable de que la solicitud se presentó en una fecha determinada, con independencia de lo que ocurra después con la cancelación. Vale la pena conservarlo junto al comprobante: es lo que te permite demostrar que cumpliste, incluso si el proceso termina en un estado que no esperabas.
Conviene notar el contraste con la consulta de estado, cuya respuesta no está firmada y que el propio portal advierte que no es un acuse en sentido legal. Uno es evidencia; el otro es información.
Si una respuesta se pierde y reenvías la solicitud, la autoridad responde indicando que el folio ya había sido admitido al proceso. Es el resultado normal de un reintento y la señal de que no se duplicó nada. Una integración que trate esa respuesta como fallo acaba corrigiendo lo que ya funcionaba.
La transacción es la misma operación de negocio en las cuatro modalidades: mismo catálogo de motivos, mismo acuse, mismas claves del SAT. Lo que cambia es todo lo que rodea al dato: el modelo de credenciales, el formato de los criterios, su codificación y la nomenclatura de la respuesta. Documentarlas juntas obligaría al lector a descartar tres cuartas partes del contrato técnico en cada consulta, y es precisamente donde se originan los errores de integración.