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. Te devuelve el acuse de recibido firmado digitalmente por la autoridad SAT con el estatus asignado al folio.
Cuándo se usa: cuando necesitas cancelar un comprobante ya timbrado, sea por errores en su emisión, porque la operación no se llevó a cabo o por otro motivo.
Cuándo no usarla: para saber si un comprobante quedó cancelado, que se consulta con CONSULT_DOCUMENT.
SAT: 201 solo significa que la solicitud de cancelación ha sido recibida por la autoridad para su gestión. La cancelación efectiva es un proceso posterior que puede tardar y que, según el tipo de comprobante, requiere la aceptación del receptor. Para conocer el estado real tienes que consultarlo con CONSULT_DOCUMENT.payload no viene en Base64. Llega como una cadena de texto que contiene un JSON. Si le aplicas la rutina de decodificación que usas en las demás transacciones de JsonServiceCall, obtendrás un error (valor sin sentido).AUTHENTICATE, y el token rota en cada llamada: la petición siguiente debe usar el último token devuelto.| Si tu integración… | Tu artículo es... |
|---|---|
Requiere solicitar la Cancelación de un CFDI por JsonServiceCall, con token de AUTHENTICATE | Este artículo |
Cancela un CFDI por RequestTransaction, con credenciales en cada petición | CANCEL_DOCUMENT_3 — CFDI + Timbrado (API REST) - Request Transaction |
Hace lo mismo enviando un sobre SOAP a FactWSFront | CANCEL_DOCUMENT_3 — CFDI + Timbrado (SOAP) |
| Necesita saber si un CFDI ya quedó cancelado | CONSULT_DOCUMENT — CFDI + Timbrado (API REST) - JsonServiceCall |
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.jsonData.jsonData con esa cadena, token con el token vigente y transactionName con el literal CANCEL_XML_3./JsonServiceCall.result y comprueba que errorCode sea 0.token de la respuesta, sustituyendo el anterior.payload como texto JSON, sin decodificar desde Base64. Obtienes un objeto con ResponseData1, ResponseData2 y ResponseData3.ResponseData2 tal cual: ahí viene la clave que devolvió el SAT, en texto plano. Y decodifica ResponseData1 desde Base64 para obtener el acuse en XML.CONSULT_DOCUMENT. No marques el comprobante como cancelado a partir de esta respuesta.Si algo falla, ve a Solución de problemas.
| Protocolo | HTTP/1.1 sobre HTTPS · arquitectura REST con cuerpo JSON |
|---|---|
| Recurso | /JsonServiceCall |
| Método | POST |
| Content-Type | application/json |
| Campo que selecciona la transacción | transactionName, con el valor CANCEL_XML_3 |
| Naturaleza | Solicitud ante la autoridad. Inicia un proceso que no concluye en esta llamada |
| Autenticación | Token en el cuerpo, obtenido con AUTHENTICATE |
| Consumo | No consume folio del paquete vigente |
| Ambiente | URL |
|---|---|
| Pruebas | https://api.mysuitetest.com/JsonServiceCall |
| Producción | https://api.mysuitecfdi.com/JsonServiceCall |
Solo puedes solicitar la cancelación de comprobantes en el ambiente en el que estás operando.
| Campo | Tipo | Obligatorio | Descripción |
|---|---|---|---|
token | string | Sí | Valor obtenido de AUTHENTICATE, o el último devuelto por cualquier transacción posterior |
token en null. Tras un fallo conserva el token que ya tenías. El RFC del emisor del comprobante va dentro de jsonData, en el campo emisor.
| Campo | Tipo | Obligatorio | Formato | Descripción |
|---|---|---|---|---|
jsonData | string | Sí | Base64 | Los datos en forma de objeto JSON que conforman la materia prima para solicitar la cancelación de un CFDI ante el SAT. Ver apartado 5 |
token | string | Sí | Texto | Token de seguridad vigente |
transactionName | string | Sí | Literal | Transacción. Para esta: CANCEL_XML_3 |
{
"motivo": "02",
"folioSustitucion": "[se usa sólo cuando 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 |
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 |
01, folioSustitucion puede omitirse. La estructura documentada lo incluye con valor vacío. Es una diferencia con CANCEL_DOCUMENT_3, donde la entrada equivalente del Dictionary sí debe enviarse con valor vacío.CANCEL_DOCUMENT_3 por RequestTransaction sólo pide el año. Aquí month es obligatorio.POST /JsonServiceCall HTTP/1.1
Host: api.mysuitetest.com
Content-Type: application/json
{
"jsonData": "ewogICAgIm1vdGl2byI6ICIwMiIsCiAgICAiZm9saW9TdXN0aXR1Y2lvbiI6ICIiLCAgICAKICAgICJlbWlzb3IiOiAiSkVTOTAwMTA5UTkwIiwKICAgICJmb2xpb0Zpc2NhbCI6ICI5NTUxOTFkNS0zOWZlLTRlYmItOWNiYS05ODhhYWNhNjE1ZDEiLAogICAgInllYXIiOiAiMjAyNiIsCiAgICAibW9udGgiOiAiMTAiCn0=",
"token": "OxbZPD1Gd9hUomWYNBUGWkzja54cEGlnz9LLPKZY+pI0+bfE1ldh8TKjBK02xvy5Wk/9aExJIGxIvrXhoAm2e5e52el/azZoa4meQJxx7Bk=",
"transactionName": "CANCEL_XML_3"
}Contenido de jsonData sin codificar, en el caso de un motivo que no requiere sustitución:
{
"motivo": "02",
"emisor": "JES900109Q90",
"folioFiscal": "955191d5-39fe-4ebb-9cba-988aaca615d1",
"year": "2026",
"month": "10"
}{
"result": true,
"payload": "{\"ResponseData1\":\"PD94bWwgdmVyc2lvbj0iMS4wIiBlbmNvZGluZz0iVVRGLTgiPz48Q2FuY2VsYUNGRFJlc3VsdCBGZWNoYT0iMjAyNi0xMC0xM1QxMToyMjo1Ni4wNTg4NDcyIiBSZmNFbWlzb3I9IkpFUzkwMDEwOVE5MCIgeG1sbnM9Imh0dHA6Ly9jYW5jZWxhY2ZkLnNhdC5nb2IubXgiPjxGb2xpb3M+PFVVSUQ+OTU1MTkxRDUtMzlGRS00RUJCLTlDQkEtOTg4QUFDQTYxNUQxPC9VVUlEPjxFc3RhdHVzVVVJRD4yMDE8L0VzdGF0dXNVVUlEPjwvRm9saW9zPjxTaWduYXR1cmUgSWQ9IlNlbGxvU0FUIiB4bWxucz0iaHR0cDovL3d3dy53My5vcmcvMjAwMC8wOS94bWxkc2lnIyI+PFNpZ25lZEluZm8+PENhbm9uaWNhbGl6YXRpb25NZXRob2QgQWxnb3JpdGhtPSJodHRwOi8vd3d3LnczLm9yZy9UUi8yMDAxL1JFQy14bWwtYzE0bi0yMDAxMDMxNSIgLz48U2lnbmF0dXJlTWV0aG9kIEFsZ29yaXRobT0iaHR0cDovL3d3dy53My5vcmcvMjAwMS8wNC94bWxkc2lnLW1vcmUjaG1hYy1zaGE1MTIiIC8+PFJlZmVyZW5jZSBVUkk9IiI+PFRyYW5zZm9ybXM+PFRyYW5zZm9ybSBBbGdvcml0aG09Imh0dHA6Ly93d3cudzMub3JnL1RSLzE5OTkvUkVDLXhwYXRoLTE5OTkxMTE2Ij48WFBhdGg+bm90KGFuY2VzdG9yLW9yLXNlbGY6OipbbG9jYWwtbmFtZSgpPSdTaWduYXR1cmUnXSk8L1hQYXRoPjwvVHJhbnNmb3JtPjwvVHJhbnNmb3Jtcz48RGlnZXN0TWV0aG9kIEFsZ29yaXRobT0iaHR0cDovL3d3dy53My5vcmcvMjAwMS8wNC94bWxlbmMjc2hhNTEyIiAvPjxEaWdlc3RWYWx1ZT5vVUNNcUpGNE9ob3k2a2d5bVJBaTBiMTNmemV0c2FEbXUvdVdsU3FGeExDcHRSVTFRMDJaUDNvQ3RQbmwzbXJQZDZVOE5xeEd2MVp6UGd3V1J1M0RlZz09PC9EaWdlc3RWYWx1ZT48L1JlZmVyZW5jZT48L1NpZ25lZEluZm8+PFNpZ25hdHVyZVZhbHVlPjJQMStiNWVKZ0hDTHV2bGxEbnhWYkoyNStXTEtrZktSWDFwZi9YZTFNSHZuSGZBczlXZXdaQVg4anB5MWRxaGxCRUZhQzJMMzd2MGpzRTZYUGw5ck13PT08L1NpZ25hdHVyZVZhbHVlPjxLZXlJbmZvPjxLZXlOYW1lPjMwMDAxMDAwMDAwNTAwMDAyNTU0PC9LZXlOYW1lPjxLZXlWYWx1ZT48UlNBS2V5VmFsdWU+PE1vZHVsdXM+aFVjVU9vR0V0U0RBbHJGOEtlZ1FrR0tZOGFEQWU5dE5Sa2Y0OHVqMStZaXJEUDRjTUVkOFlFZWxRWTFqTHUxR0lOWUtmOU45WHhtT2ZIZEw0RlVyK2N1T2dyQnZpYUdXY0lzSmZaODBJR3B2b3g2a1VTSG9SdCtoMzJ5UWF5VzBIdU5PcDBiM3lpQnA5WTZqVGRZVEZUQVZ6Z3pVamY0TGZWdDhuNUZlalZaMnhFUkl5Uk9uR2diSzhBNHhCc1BwRmF6SFFrSzJQQ2lZZStMWUJtMFV4OVVaWWtZSjlNdTlyTDVjNTFTamdxOEpKZWtvcnAwQnpmS2FkUnJTRUZ5RDJaNkd3QjBSc3dqTFpRc3BvalpHeFVucWxibGR2TzZUakZVVjRNVDdFVjhQN2YyVlRTMHlyNHFTd3gweTA4MHpvSzEwQ2JJb0pYZnNGUk9IeXBGajV3PT08L01vZHVsdXM+PEV4cG9uZW50PkFRQUI8L0V4cG9uZW50PjwvUlNBS2V5VmFsdWU+PC9LZXlWYWx1ZT48L0tleUluZm8+PC9TaWduYXR1cmU+PC9DYW5jZWxhQ0ZEUmVzdWx0Pg==\",\"ResponseData2\":\"SAT: 201 - UUID Admitido al proceso de cancelación.\",\"ResponseData3\":\"\"}",
"token": "OxbZPD1Gd9hUomWYNBUGWkzja54cEGlnz9LLPKZY+pI0+bfE1ldh8TKjBK02xvy5Wk/9aExJIGxIvrXhoAm2e3lbcL/FDAgS7YJrwVSsZVg=",
"errorMsg": "",
"errorCode": 0
}El cuerpo es un objeto JSON de cinco campos, el mismo sobre que usan todas las transacciones de esta vía.
| Campo | Tipo | Contenido |
|---|---|---|
result | booleano | Indica si la transacción fue exitosa |
payload | string | Cadena de texto que contiene un JSON. No viene en Base64. Ver desglose siguiente |
token | string | Token nuevo para la siguiente llamada |
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 esta vía, tal como se describe en AUTHENTICATE.
payload no está codificado en esta transacción. En las demás transacciones de JsonServiceCall llega en Base64 y hay que decodificarlo. Aquí llega como texto JSON directo: lo que necesitas es analizarlo, no decodificarlo. Si tu integración aplica la rutina de Base64 que usa en las otras, fallará.payload| Elemento | Codificación | Contenido |
|---|---|---|
ResponseData1 | Base64 | XML del resultado de la solicitud de cancelación realizada: el acuse CancelaCFDResult firmado por el SAT |
ResponseData2 | Texto plano | Clave SAT obtenida, con su descripción y el prefijo SAT: |
ResponseData3 | — | Vacío |
payload no está codificado pero ResponseData1 sí, y ResponseData2 no. CancelaCFDResult
<CancelaCFDResult Fecha="[fecha y hora del acuse]"
RfcEmisor="[RFC del emisor]"
xmlns="http://cancelacfd.sat.gob.mx">
<Folios>
<UUID>[Folio Fiscal, en mayúsculas]</UUID>
<EstatusUUID>[clave del SAT]</EstatusUUID>
</Folios>
<Signature Id="SelloSAT" ...>
...
</Signature>
</CancelaCFDResult>| Elemento | Contenido |
|---|---|
@Fecha · @RfcEmisor | Momento del acuse y RFC del emisor |
Folios/UUID | Folio Fiscal sobre el que se solicitó la cancelación. El SAT lo devuelve en mayúsculas, aunque lo hayas enviado en minúsculas |
Folios/EstatusUUID | Clave que el SAT asignó al folio. |
Signature Id="SelloSAT" | Sello digital del SAT. Hace del acuse una evidencia verificable de que la solicitud se presentó |
| Clave | Significado | Qué hacer |
|---|---|---|
201 | UUID admitido al proceso de cancelación | La solicitud se presentó. Consultar después estado real |
202 | UUID previamente admitido al proceso de cancelación | Ya lo habías solicitado. No es un error. |
Para el resto de las claves del SAT, consulta el Catálogo de códigos de error y notificación en apartado 10.
| Campo | Contenido en error |
|---|---|
result | false |
errorCode | Código distinto de 0. Ver apartado 10 |
errorMsg | Descripción del error |
payload | null |
token | null. Conserva el token anterior: en error no se renueva |
errorCode es un código de la vía JsonServiceCall; la clave que viaja en ResponseData2 es del SAT. Un error de la vía 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 | Leer la clave del SAT y consultar después el estado |
101 | Token expirado | Venció el tiempo de vida del token | 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: devuelve la clave 202 |
| Plazos de cancelación | Revisar lineamientos SAT vigentes |
| 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 folio del paquete vigente |
| Timeout | 60 segundos en el servidor front |
CancelaCFDResult viene firmado digitalmente por el SAT y constituye evidencia de que la solicitud se presentó. Consérvalo junto al comprobante.CONSULT_DOCUMENT.Problema. El intento de decodificar payload desde Base64 produce un error o un valor sin sentido, aunque la misma rutina funciona en las demás transacciones de la vía.
Entorno. CFDI + Timbrado · API REST · JsonServiceCall · integraciones que usan varias transacciones.
Resolución. En esta transacción payload no viene codificado: es una cadena de texto que contiene un JSON. Analízala directamente. Después sí tendrás que decodificar ResponseData1, que es el único elemento en Base64; ResponseData2 llega en texto plano.
Causa. Es la única transacción de JsonServiceCall cuyo payload no está codificado. El nombre del campo es el mismo en todas, pero el tratamiento no.
Problema. El ERP marcó el comprobante como cancelado a partir de esta respuesta y el estado ante la autoridad no coincide.
Entorno. CFDI + Timbrado · API REST · JsonServiceCall · seguimiento de cancelaciones.
Resolución. La clave 201 significa que el SAT recibió la solicitud para su gestión, no que el comprobante esté cancelado. Marca el comprobante como «cancelación solicitada» y consulta el estado real con CONSULT_DOCUMENT antes de darlo por cancelado.
Causa. Se interpretó result = true como confirmación. Son dos cosas distintas: que la solicitud se haya presentado y otra que la cancelación ocurra.
Problema. La solicitud falla aunque el UUID y el RFC del emisor son los del comprobante.
Entorno. CFDI + Timbrado · API REST · JsonServiceCall · integraciones migradas desde RequestTransaction.
Resolución. Revisa que estés enviando el mes además del año. Esta vía exige month. 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 dos entradas al mismo servicio.
Problema. La solicitud falla al usar el motivo 01.
Entorno. CFDI + Timbrado · API REST · JsonServiceCall · 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. La clave del SAT es 202 en lugar de 201.
Entorno. CFDI + Timbrado · API REST · JsonServiceCall · reintentos tras perder una respuesta.
Resolución. No salió nada mal: 202 indica que el folio ya había sido admitido antes al proceso de cancelación. 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.
Problema. La comparación entre el Folio Fiscal enviado y el del acuse falla, aunque son el mismo comprobante.
Entorno. CFDI + Timbrado · API REST · JsonServiceCall · conciliación automática de acuses.
Resolución. El SAT devuelve el UUID en mayúsculas dentro del acuse. Compara sin distinguir mayúsculas y minúsculas, o normaliza ambos valores antes de contrastarlos.
Causa. Diferencia de capitalización, no de identificador.
Problema. El intento de decodificar ResponseData2 produce un error o un valor sin sentido.
Entorno. CFDI + Timbrado · API REST · JsonServiceCall · integraciones nuevas.
Resolución. Dentro de payload, solo ResponseData1 viene en Base64. ResponseData2 llega en texto plano, con el prefijo SAT: seguido del número y su descripción. Lee la clave directamente del texto, o del elemento EstatusUUID del acuse si prefieres un valor sin formato.
Causa. Los elementos del payload no comparten codificación.
Problema. La implementación de CANCEL_DOCUMENT_3 no sirve aquí.
Entorno. CFDI + Timbrado · API REST · migraciones entre las dos vías.
Resolución. Cambian la autenticación, el formato de los criterios y el sobre de la respuesta. Allí los criterios viajan como dos estructuras Dictionary en XML codificado, repartidas en Data1 y Data2; aquí van como un solo objeto JSON en jsonData, con el mes añadido. Lo único que se conserva es el contenido de la respuesta, porque los nombres ResponseData1 y ResponseData2 son los mismos: esa parte sí puedes reutilizarla.
Causa. Las dos vías comparten el servicio pero no el contrato.
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 y obtiene acuse; 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 CancelaCFDResult 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.

CONSULT_DOCUMENT no lo está, y por eso el propio portal advierte que en sentido legal no es un acuse. Uno es evidencia; el otro es información.La clave 202 aparece cuando el folio ya había sido admitido al proceso de cancelación. Es el resultado normal de reintentar una solicitud cuya respuesta se perdió, y la señal de que el reintento no duplicó nada. Una integración que lo trate como fallo acaba corrigiendo lo que ya funcionaba.
La misma cancelación puede pedirse por JsonServiceCall o por RequestTransaction. Conviven por razones históricas y no son intercambiables: cambian el modelo de credenciales, el formato de los criterios y la forma de la respuesta. Pero hay una diferencia de fondo que conviene conocer: esta vía pide el mes de emisión además del año, mientras que la otra se conforma con el año. Es justo el tipo de detalle que sorprende a quien migra de una a otra, y que no se deduce leyendo solo una de las dos.
La transacción es la misma operación de negocio en ambas: 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, la nomenclatura de la respuesta y su codificación. Documentarlas juntas 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