CANCEL_XML_3 — SERVICIO CFDI + Timbrado (API REST) - JsonServiceCall

CANCEL_XML_3 — SERVICIO CFDI + Timbrado (API REST) - JsonServiceCall

Estado Transacción: Vigente · Compatibilidad: Esquema de cancelación vigente · Última revisión: 09/10/2026 · Próxima revisión: 09/01/2027 · Responsable: Jan Martínez


De un vistazo


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.


Que la respuesta sea exitosa no significa que el CFDI esté cancelado. La clave 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.
Esta es la única transacción de la vía cuyo 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).
Necesitas un token. Esta vía exige autenticarse primero con AUTHENTICATE, y el token rota en cada llamada: la petición siguiente debe usar el último token devuelto.


Cómo saber si este es tu artículo

Si tu integración…Tu artículo es...
Requiere solicitar la Cancelación de un CFDI por JsonServiceCall, con token de AUTHENTICATEEste artículo
Cancela un CFDI por RequestTransaction, con credenciales en cada peticiónCANCEL_DOCUMENT_3 — CFDI + Timbrado (API REST) - Request Transaction
Hace lo mismo enviando un sobre SOAP a FactWSFrontCANCEL_DOCUMENT_3 — CFDI + Timbrado (SOAP)
Necesita saber si un CFDI ya quedó canceladoCONSULT_DOCUMENT — CFDI + Timbrado (API REST) - JsonServiceCall


Requisitos previos

  • Un token vigente, obtenido con AUTHENTICATE.
  • El Folio Fiscal (UUID) del comprobante, el RFC de su emisor, el año y el mes de emisión.
  • El motivo de cancelación conforme al catálogo del SAT, decidido por el área que corresponda y no por el sistema.
  • Si el motivo es 01, el Folio Fiscal del comprobante que sustituye al cancelado, ya timbrado.
  • CSD del emisor vigente en la plataforma: la solicitud de cancelación se firma.


Cómo hacerlo

  1. Obtén un token con AUTHENTICATE, o toma el último que te devolvió la transacción anterior.
    Resultado: el token con el que vas a autenticar esta llamada.
  2. Determina el motivo de cancelación conforme al catálogo del SAT. No es una decisión técnica: define cómo queda documentada la cancelación ante la autoridad.
    Resultado: la clave de motivo, de 01 a 04.
  3. Emite primero el comprobante sustituto si el motivo es 01, y guarda su Folio Fiscal.
    Resultado: el UUID de sustitución disponible antes de cancelar.
  4. Reúne el RFC del emisor, el UUID del comprobante, el año y el mes en que se emitió. El mes es obligatorio en esta vía.
    Resultado: los criterios que identifican el comprobante.
  5. Construye el objeto JSON con motivo, emisor, folioFiscal, year y month, más folioSustitucion si el motivo es 01.
    Resultado: un JSON válido de cinco o seis campos.
  6. Codifica ese objeto en Base64, sin saltos de línea intermedios.
    Resultado: la cadena que vas a poner en jsonData.
  7. Arma el cuerpo de la petición con los tres campos: jsonData con esa cadena, token con el token vigente y transactionName con el literal CANCEL_XML_3.
    Resultado: petición lista.
  8. Envía la petición al recurso /JsonServiceCall.
    Resultado: respuesta con un cuerpo JSON de cinco campos.
  9. Lee result y comprueba que errorCode sea 0.
    Resultado: confirmación de que la solicitud se presentó ante el SAT.
  10. Guarda el nuevo token de la respuesta, sustituyendo el anterior.
    Resultado: sesión viva para la siguiente llamada.
  11. Interpreta payload como texto JSON, sin decodificar desde Base64. Obtienes un objeto con ResponseData1, ResponseData2 y ResponseData3.
    Resultado: el acuse y la clave del SAT.
  12. Lee 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.
    Resultado: el estatus del folio y el acuse firmado por la autoridad.
  13. Conserva ese acuse junto al comprobante y consulta después el estado real con CONSULT_DOCUMENT. No marques el comprobante como cancelado a partir de esta respuesta.
    Resultado: evidencia resguardada y estado verificado contra el SAT.

Si algo falla, ve a Solución de problemas.

Contrato técnico

1. Endpoint y operación

ProtocoloHTTP/1.1 sobre HTTPS · arquitectura REST con cuerpo JSON
Recurso/JsonServiceCall
MétodoPOST
Content-Typeapplication/json
Campo que selecciona la transaccióntransactionName, con el valor CANCEL_XML_3
NaturalezaSolicitud ante la autoridad. Inicia un proceso que no concluye en esta llamada
AutenticaciónToken en el cuerpo, obtenido con AUTHENTICATE
ConsumoNo consume folio del paquete vigente


2. Ambientes

AmbienteURL
Pruebashttps://api.mysuitetest.com/JsonServiceCall
Producciónhttps://api.mysuitecfdi.com/JsonServiceCall

Solo puedes solicitar la cancelación de comprobantes en el ambiente en el que estás operando.


3. Autenticación

CampoTipoObligatorioDescripción
tokenstringSíValor obtenido de AUTHENTICATE, o el último devuelto por cualquier transacción posterior
El token rota, y en error no se renueva. Cada transacción exitosa devuelve un token nuevo que sustituye al anterior, pero una respuesta de error devuelve 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.


4. Parámetros de entrada

CampoTipoObligatorioFormatoDescripción
jsonDatastringSíBase64Los 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
tokenstringSíTextoToken de seguridad vigente
transactionNamestringSíLiteralTransacción. Para esta: CANCEL_XML_3


5. Estructura de lo que se envía en jsonData

{
"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]"
}
CampoObligatorioFormatoDescripción
motivoSíDos dígitos, entre comillasClave del motivo de cancelación del comprobante. Valores posibles: 01, 02, 03 y 04
folioSustitucionCondicionalUUID, o cadena vacíaUUID que sustituye al folio fiscal cancelado. Es requerido cuando la clave del motivo es 01
emisorSíRFCRFC del emisor de la factura cuya cancelación se solicita
folioFiscalSíUUIDUUID del CFDI cuya cancelación se solicita (36 caracteres)
yearSíAño AAAA, entre comillasAño en que fue emitido el CFDI
monthSíMes MM, entre comillasMes en que fue emitido el CFDI
Catálogo de motivos de cancelación
ClaveDescripciónRequiere folio de sustitución
01Comprobante emitido con errores con relaciónSí
02Comprobante emitido con errores sin relaciónNo
03No se llevó a cabo la operaciónNo
04Operación nominativa relacionada en una factura globalNo
Con un motivo distinto de 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.
Esta vía exige el mes; la otra no. CANCEL_DOCUMENT_3 por RequestTransaction sólo pide el año. Aquí month es obligatorio.


6. Ejemplo de request

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"
}


7. Ejemplo de response

{
"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
}


8. Estructura de respuesta — éxito

El cuerpo es un objeto JSON de cinco campos, el mismo sobre que usan todas las transacciones de esta vía.

CampoTipoContenido
resultbooleanoIndica si la transacción fue exitosa
payloadstringCadena de texto que contiene un JSON. No viene en Base64. Ver desglose siguiente
tokenstringToken nuevo para la siguiente llamada
errorCodeenteroCódigo de error. 0 significa que no hubo error
errorMsgstringDescripció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á.

Contenido de payload

ElementoCodificaciónContenido
ResponseData1Base64XML del resultado de la solicitud de cancelación realizada: el acuse CancelaCFDResult firmado por el SAT
ResponseData2Texto planoClave SAT obtenida, con su descripción y el prefijo SAT:
ResponseData3—Vacío
El payload no está codificado pero ResponseData1 sí, y ResponseData2 no. 


Estructura del acuse 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>
ElementoContenido
@Fecha · 
@RfcEmisor
Momento del acuse y RFC del emisor
Folios/UUIDFolio Fiscal sobre el que se solicitó la cancelación. El SAT lo devuelve en mayúsculas, aunque lo hayas enviado en minúsculas
Folios/EstatusUUIDClave 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ó
Compara mayúsculas y minúsculas al conciliar: si tu ERP guarda los UUID en minúsculas y comparas el valor del acuse tal cual, la comparación falla.


Claves del SAT en el contexto de cancelación

ClaveSignificadoQué hacer
201UUID admitido al proceso de cancelaciónLa solicitud se presentó. Consultar después  estado real
202UUID previamente admitido al proceso de cancelaciónYa 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.


9. Estructura de respuesta — error

CampoContenido en error
resultfalse
errorCodeCódigo distinto de 0. Ver apartado 10
errorMsgDescripción del error
payloadnull
tokennull. Conserva el token anterior: en error no se renueva
Dos numeraciones en juego. 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.


10. Códigos de Error


CódigoSignificadoCausaRemedio
0Sin errorLa solicitud se presentó ante el SATLeer la clave del SAT y consultar después el estado
101Token expiradoVenció el tiempo de vida del tokenAutenticarte de nuevo con AUTHENTICATE y reintentar
102Token inválidoAl desencriptar y analizar la información de autenticación, la operación fallaRevisar que envíes el último token devuelto, completo y sin alterar
Los códigos 101 y 102 son seguros de reintentar. Si el token caducó o es inválido, la solicitud no llegó al SAT. Ante cualquier otro error, consulta el estado del comprobante antes de volver a solicitar la cancelación.


11. Límites y comportamiento

AspectoValor
Comprobantes por llamadaUno. El criterio es un único folioFiscal
AlcanceComprobantes emitidos del RFC indicado en emisor, en el ambiente en que operas
EfectosInicia un proceso ante la autoridad. No lo concluye: el desenlace depende del SAT y, en ciertos casos, de la aceptación del receptor
IdempotenciaUna segunda solicitud sobre el mismo comprobante no genera una segunda cancelación: devuelve la clave 202
Plazos de cancelaciónRevisar lineamientos SAT vigentes
Aceptación del receptorExisten supuestos en los que los comprobantes son cancelables con aceptación, para esto, se deberá esperar por respuesta del receptor
Consumo de foliosNo consume folio del paquete vigente
Timeout60 segundos en el servidor front


12. Versionado y cumplimiento

  • Esta transacción implementa el esquema de cancelación vigente, que incorpora el motivo de cancelación obligatorio y el folio de sustitución condicional.
  • El acuse CancelaCFDResult viene firmado digitalmente por el SAT y constituye evidencia de que la solicitud se presentó. Consérvalo junto al comprobante.
  • El motivo de cancelación es una declaración ante la autoridad, no un campo técnico. La decisión corresponde al área fiscal o contable.
  • El estado real de cancelación se verifica con CONSULT_DOCUMENT.

Solución de problemas

"No puedo decodificar el payload"


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.

"Dice que se canceló pero el SAT lo sigue mostrando vigente"


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.

"No encuentra el comprobante y los datos son correctos"


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.

"Me rechaza la cancelación con motivo 01"


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.

"Me devuelve SAT: 202 y creo que algo salió mal"


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.

"El UUID del acuse no coincide con el mío"


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.

"Mi código falla al leer la clave del SAT"


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.

"Migré desde RequestTransaction y nada encaja"


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.


Para entender más

Por qué cancelar es una solicitud y no una orden

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.

Por qué el motivo es obligatorio

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.

Qué hace valioso al acuse

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.

Info
Conviene notar el contraste con la consulta de estado: el acuse de la solicitud sí está firmado, mientras que la respuesta de 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.

Por qué 202 no es un error

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.

Dos caminos al mismo servicio, con criterios distintos

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.

Por qué cada vía se documenta por separado

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.


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