CANCEL_DOCUMENT_3 — SERVICIO CFDI + Timbrado (API REST) - Request Transaction

CANCEL_DOCUMENT_3 — SERVICIO CFDI + Timbrado (API REST) - Request Transaction

Estado Transacción: Vigente · Compatibilidad: Esquema de cancelación vigente · Última revisión: 07/08/2026 · Próxima revisión: 07/11/2026 · 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 entregado por la autoridad con el estatus asignado al folio fiscal.


Cuándo se usa: cuando necesitas solicitar la cancelación un comprobante ya timbrado, sea por errores en su emisión o porque la operación no se llevó a cabo.


Cuándo no usarla: para cancelar retenciones, que usan CANCELAR_RETENCION_SINGLE_MYSUITE_3. Tampoco sirve para saber si un comprobante quedó cancelado: eso se consulta con CONSULTAR_DOCUMENTO.


Que la respuesta sea exitosa no significa que el CFDI esté cancelado. El estatus SAT: 201 sólo indica que la autoridad recibió la solicitud para su gestión. La cancelación efectiva es un proceso posterior que puede tardar y que, según el tipo de comprobante, requiere (o no), la aceptación del receptor. Para conocer el estado real tienes que consultarlo con la transacción CONSULTAR_DOCUMENTO.
Dos puntos de entrada para la misma operación. MYSuite ofrece la cancelación por dos vías distintas: RequestTransaction con la transacción CANCEL_DOCUMENT_3, que es la que cubre este artículo, y JsonServiceCall con la transacción CANCEL_XML_3, que requiere obtener antes un token y recibe los criterios en otro formato. No son intercambiables.
Advertencia de homonimia. Existe la misma transacción en la modalidad CFDI + Timbrado sobre SOAP. Cada transporte se documenta en un artículo independiente. Este cubre exclusivamente API REST.


Cómo saber si este es tu artículo


Si tu integración… Tu artículo es...
Solicita Cancelar un CFDI por RequestTransaction, enviando un cuerpo JSON por HTTP POST Este artículo
Solicitar Cancelar un CFDI por JsonServiceCall, con token de AUTHENTICATE CANCEL_XML_3 — CFDI + Timbrado (API REST) - JsonServiceCall
Hace lo mismo enviando un sobre SOAP a FactWSFront CANCEL_DOCUMENT_3 — CFDI + Timbrado (SOAP)
Necesita saber si un CFDI ya quedó cancelado, enviando un cuerpo JSON por HTTP POST CONSULTAR_DOCUMENTO — CFDI + Timbrado (API REST) - Request Transaction
Va a cancelar un comprobante de retenciones, enviando un cuerpo JSON por HTTP POST CANCELAR_RETENCION_SINGLE_MYSUITE_3 — CFDI + Timbrado (API REST) - Request Transaction


Requisitos previos

  • Credenciales de integración vigentes que te proporciona MYSuite: Requestor y Entity.
  • El Folio Fiscal (UUID) del comprobante a cancelar y su año 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. 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, 01, 02, 03 y 04.
  2. 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.
  3. Construye el Dictionary con el atributo name igual a StoredXmlSelector, con las entradas Store, IssuerCountryCode, IssuerTaxId, DocumentGUID y Year, y codifícalo en Base64.
    Resultado: la cadena que vas a poner en Data1.
  4. Construye el segundo Dictionary, con el atributo name igual a CancelInfo, con las entradas Motivo y FolioSustitucion, y codifícalo también en Base64.
    Resultado: la cadena que vas a poner en Data2.
  5. Arma el cuerpo JSON con los nueve campos: las credenciales, Transaction con valor CANCEL_DOCUMENT_3, las dos cadenas Base64 en Data1 y Data2, Data3 como cadena vacía.
    Resultado: un JSON válido con los nueve campos presentes.
  6. Envía la petición POST al recurso /RequestTransaction con Content-Type: application/json.
    Resultado: respuesta HTTP 200 con un cuerpo JSON de tres objetos.
  7. Lee responseField.resultField.
    Resultado: responseField = true te permite continuar; responseField = false te lleva a Solución de problemas.
  8. Lee responseDataField.responseData2Field tal cual, en texto plano: ahí viene la clave que devolvió el SAT.
    Resultado: el estatus de la solicitud ante la autoridad.
  9. Decodifica responseDataField.responseData1Field desde Base64 para obtener el acuse en XML, con el estatus del folio.
    Resultado: el acuse, que es la evidencia de la solicitud.
  10. Conserva ese acuse junto al comprobante. Es la constancia de que la solicitud se presentó.
    Resultado: evidencia resguardada.
  11. Consulta después el estado real con CONSULTAR_DOCUMENTO. No marques el comprobante como cancelado en tu ERP a partir de la respuesta 201.
    Resultado: el estado de cancelación verificado contra el SAT.

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


Contrato técnico

1. Endpoint y operación

Protocolo HTTP/1.1 sobre HTTPS · arquitectura REST con cuerpo JSON
Método POST
Recurso /RequestTransaction
Content-Type application/json
Accept application/json
Valor de Transaction CANCEL_DOCUMENT_3
Naturaleza Solicitud ante la autoridad. Inicia un proceso que no concluye en esta llamada
Autenticación Credenciales en el cuerpo de cada petición. No requiere token, a diferencia de la vía JsonServiceCall
Consumo No consume folios del paquete vigente


2. Ambientes

Ambiente URL
Pruebas https://api.mysuitetest.com/RequestTransaction
Producción https://api.mysuitecfdi.com/RequestTransaction
Restricción del ambiente de pruebas. Un cliente CFDI + Timbrado (API REST) debe usar JES900109Q90 como Entity en pruebas; en producción, el RFC del emisor. Solo puedes solicitar cancelar comprobantes del ambiente en que operas.


3. Autenticación

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: CANCEL_DOCUMENT_3
Country string Sí Valor fijo MX Abreviatura del país
Entity string Sí RFC (12–13 caracteres) RFC de quien realiza la solicitud. 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.JES900109Q90.Jan


4. Parámetros de entrada

Nombre Tipo Obligatorio Formato Descripción
Data1 string Sí Base64 Dictionary con name="StoredXmlSelector": identifica el CFDI a cancelar. Ver apartado 5
Data2 string Sí Base64 Dictionary con name="CancelInfo": motivo de la cancelación. Ver apartado 5
Data3 string No Cadena vacía "" Sin uso en esta transacción. El campo debe estar presente en el JSON con valor vacío
Es la única transacción de la modalidad que envía dos estructuras codificadas. Ambas son Dictionary, ambas van en Base64, pero tienen nombres distintos y propósitos distintos: una dice cuál comprobante, la otra dice por qué.


5. Estructura de lo que se envía en Data1, Data2 y Data3

Data1 — Dictionary name="StoredXmlSelector"

<Dictionary name="StoredXmlSelector">
<Entry k="Store" v="ISSUED"/>
<Entry k="IssuerCountryCode" v="MX"/>
<Entry k="IssuerTaxId" v="[RFC del emisor del CFDI]"/>
<Entry k="DocumentGUID" v="[UUID del CFDI a cancelar]"/>
<Entry k="Year" v="[año de emisión]"/>
</Dictionary>
Entrada (k) Obligatorio Formato Descripción
Store Sí Valor ISSUED Almacén del comprobante. Solo se cancelan comprobantes emitidos
IssuerCountryCode Sí Valor MX Código de país del emisor
IssuerTaxId Sí RFC RFC del emisor del CFDI
DocumentGUID Sí UUID  Folio Fiscal del CFDI a cancelar (36 caracteres)
Year Sí Año AAAA Año en que se emitió el CFDI


Data2 — Dictionary name="CancelInfo"

<Dictionary name="CancelInfo">
<Entry k="Motivo" v="[clave 01 a 04]"/>
<Entry k="FolioSustitucion" v="[UUID sustituto, o vacío]"/>
</Dictionary>
Entrada (k) Obligatorio Formato Descripción
Motivo Sí Dos dígitos Clave del motivo de cancelación. Valores posibles: 01, 02, 03 y 04
FolioSustitucion Condicional UUID o cadena vacía Folio Fiscal que sustituye al cancelado. Requerido cuando el motivo es 01; con cualquier otro motivo se envía el valor vacío
Catálogo de motivos de cancelación
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

Data3

Sin estructura. Se envía como cadena vacía.


6. Ejemplo de request

POST /RequestTransaction HTTP/1.1
Host: api.mysuitetest.com
Content-Type: application/json

{
"Requestor": "0c320b03-d4f1-47bc-9fb4-77995f9bf33e",
"Transaction": "CANCEL_DOCUMENT_3",
"Country": "MX",
"Entity": "JES900109Q90",
"User": "0c320b03-d4f1-47bc-9fb4-77995f9bf33e",
"UserName": "MX.JES900109Q90.Jan",
"Data1": "PERpY3Rpb25hcnkgbmFtZT0iU3RvcmVkWG1sU2VsZWN0b3IiPjxFbnRyeSBrPSJTdG9yZSIgdj0iSVNTVUVEIi8+PEVudHJ5IGs9Iklzc3VlckNvdW50cnlDb2RlIiB2PSJNWCIvPjxFbnRyeSBrPSJJc3N1ZXJUYXhJZCIgdj0iSkVTOTAwMTA5UTkwIi8+PEVudHJ5IGs9IkRvY3VtZW50R1VJRCIgdj0iYmVjYmIyNDMtMjFlNi00NGI2LTg5ZjctZDJjOWU1NDZmM2IzIi8+PEVudHJ5IGs9IlllYXIiIHY9IjIwMjYiLz48L0RpY3Rpb25hcnk+",
"Data2": "PERpY3Rpb25hcnkgbmFtZT0iQ2FuY2VsSW5mbyI+PEVudHJ5IGs9Ik1vdGl2byIgdj0iMDIiLz48RW50cnkgaz0iRm9saW9TdXN0aXR1Y2lvbiIgdj0iIi8+PC9EaWN0aW9uYXJ5Pg==",
"Data3": ""
}


7. Ejemplo de response

{
"requestField": {
"requestorField": "00000000-0000-0000-0000-000000000000",
"requestorNameField": null,
"requestorActiveField": true,
"transactionField": 291,
"countryField": "MX",
"entityField": "JES900109Q90",
"userField": "00000000-0000-0000-0000-000000000000",
"userNameField": "
MX.JES900109Q90.Jan",
"idField": "3998dead-9f9e-4248-b6d4-d6625ac7292e",
"timeStampField": "2026-05-07T13:09:33.1279984-06:00"
},
"responseField": {
"resultField": true,
"timeStampField": "2026-05-07T13:09:34.1639881-06:00",
"lastResultField": "",
"codeField": 1,
"descriptionField": "",
"hintField": "",
"dataField": " 5990 3998dead-9f9e-4248-b6d4-d6625ac7292e",
"processorField": "TEST-BACK03",
"identifierField": {
"countryField": "MX",
"entityField": "JES900109Q90",
"fiscalNameField": "JIMENEZ ESTRADA SALAS A A",
"aYearField": "0",
"aNumberField": "",
"batchField": "SPT",
"serialField": "2491",
"documentGUIDField": "90585d23-ce85-40be-8a37-e19c5d5cf2c8",
"issuedTimeStampField": "2026-05-07T12:06:15",
"enrolledTimeStampField": "2026-05-07T12:06:18",
"paidTimeStampField": "",
"cancelledTimeStampField": "",
"internalIDField": "",
"batchIDField": "",
"batchTimeStampField": "",
"batchRequestorCountryField": "",
"batchRequestorEntityField": "",
"batchPositionField": "",
"receiverCountryField": "MX",
"receiverEntityField": "JES900109Q90",
"receiverTaxIDField": "",
"receiverNameField": "JIMENEZ ESTRADA SALAS A A",
"claveAgenteField": "",
"numeroDePolizaField": "",
"currencyField": "MXN",
"totalAmountField": "1,160.00",
"type1Field": "ingreso",
"type2Field": "FACTURA",
"suggestedFileNameField": "JES900109Q90_SPT_2491_JES900109Q90",
"suggestedFileName2Field": "07052026___SPT2491_",
"observacionesField": null,
"observacionesHtmlField": null
},
"batchIdentifierField": null
},
"responseDataField": {
"responseData1Field": "PD94bWwgdmVyc2lvbj0iMS4wIiBlbmNvZGluZz0iVVRGLTgiPz48Q2FuY2VsYUNGRFJlc3VsdCBGZWNoYT0iMjAyNi0wNS0wN1QxMzowOTozMy45ODQ2NTkzIiBSZmNFbWlzb3I9IkpFUzkwMDEwOVE5MCIgeG1sbnM9Imh0dHA6Ly9jYW5jZWxhY2ZkLnNhdC5nb2IubXgiPjxGb2xpb3M+PFVVSUQ+OTA1ODVEMjMtQ0U4NS00MEJFLThBMzctRTE5QzVENUNGMkM4PC9VVUlEPjxFc3RhdHVzVVVJRD4yMDE8L0VzdGF0dXNVVUlEPjwvRm9saW9zPjxTaWduYXR1cmUgSWQ9IlNlbGxvU0FUIiB4bWxucz0iaHR0cDovL3d3dy53My5vcmcvMjAwMC8wOS94bWxkc2lnIyI+PFNpZ25lZEluZm8+PENhbm9uaWNhbGl6YXRpb25NZXRob2QgQWxnb3JpdGhtPSJodHRwOi8vd3d3LnczLm9yZy9UUi8yMDAxL1JFQy14bWwtYzE0bi0yMDAxMDMxNSIgLz48U2lnbmF0dXJlTWV0aG9kIEFsZ29yaXRobT0iaHR0cDovL3d3dy53My5vcmcvMjAwMS8wNC94bWxkc2lnLW1vcmUjaG1hYy1zaGE1MTIiIC8+PFJlZmVyZW5jZSBVUkk9IiI+PFRyYW5zZm9ybXM+PFRyYW5zZm9ybSBBbGdvcml0aG09Imh0dHA6Ly93d3cudzMub3JnL1RSLzE5OTkvUkVDLXhwYXRoLTE5OTkxMTE2Ij48WFBhdGg+bm90KGFuY2VzdG9yLW9yLXNlbGY6OipbbG9jYWwtbmFtZSgpPSdTaWduYXR1cmUnXSk8L1hQYXRoPjwvVHJhbnNmb3JtPjwvVHJhbnNmb3Jtcz48RGlnZXN0TWV0aG9kIEFsZ29yaXRobT0iaHR0cDovL3d3dy53My5vcmcvMjAwMS8wNC94bWxlbmMjc2hhNTEyIiAvPjxEaWdlc3RWYWx1ZT5vSnJtbTgxM0xBbXlmU1hjS2x4enFEc1NKbW1YNEJGYzhBWlVXSjhlamRuQU00RDE1RlhIN1IycUhsbWtxTXZMaklPVGNPS2xtcTg0eUd4UFdINmg5QT09PC9EaWdlc3RWYWx1ZT48L1JlZmVyZW5jZT48L1NpZ25lZEluZm8+PFNpZ25hdHVyZVZhbHVlPnoxanN5aVpzdFBRS2dOZDNoY0RvWnBlSE0yR3F6d3l0MHppSVJ6UXlzMWNHTC9FTzJiSm5SYjc5MFBOZmM0TUlnS2h5QnVLNW00dUx0S1pMT000MjlBPT08L1NpZ25hdHVyZVZhbHVlPjxLZXlJbmZvPjxLZXlOYW1lPjMwMDAxMDAwMDAwNTAwMDAyNTU0PC9LZXlOYW1lPjxLZXlWYWx1ZT48UlNBS2V5VmFsdWU+PE1vZHVsdXM+aFVjVU9vR0V0U0RBbHJGOEtlZ1FrR0tZOGFEQWU5dE5Sa2Y0OHVqMStZaXJEUDRjTUVkOFlFZWxRWTFqTHUxR0lOWUtmOU45WHhtT2ZIZEw0RlVyK2N1T2dyQnZpYUdXY0lzSmZaODBJR3B2b3g2a1VTSG9SdCtoMzJ5UWF5VzBIdU5PcDBiM3lpQnA5WTZqVGRZVEZUQVZ6Z3pVamY0TGZWdDhuNUZlalZaMnhFUkl5Uk9uR2diSzhBNHhCc1BwRmF6SFFrSzJQQ2lZZStMWUJtMFV4OVVaWWtZSjlNdTlyTDVjNTFTamdxOEpKZWtvcnAwQnpmS2FkUnJTRUZ5RDJaNkd3QjBSc3dqTFpRc3BvalpHeFVucWxibGR2TzZUakZVVjRNVDdFVjhQN2YyVlRTMHlyNHFTd3gweTA4MHpvSzEwQ2JJb0pYZnNGUk9IeXBGajV3PT08L01vZHVsdXM+PEV4cG9uZW50PkFRQUI8L0V4cG9uZW50PjwvUlNBS2V5VmFsdWU+PC9LZXlWYWx1ZT48L0tleUluZm8+PC9TaWduYXR1cmU+PC9DYW5jZWxhQ0ZEUmVzdWx0Pg==",
"responseData2Field": "SAT: 201 - UUID Admitido al proceso de cancelación.",
"responseData3Field": "",
"responseDataSetField": null
}
}

8. Estructura de respuesta — éxito

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. Valor 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 solicitud se presentó ante el SAT. No significa que el CFDI esté cancelado
codeField Entero. Código de resultado de MYSuite. Ver apartado 10
timeStampField Momento en que concluyó el procesamiento
lastResultField · 
descriptionField · 
hintField
Vacíos en solicitud exitosa. Ver apartado 9
dataField · processorField Referencia interna del procesamiento y Servidor que atendió la solicitud
identifierField Objeto poblado con los datos del comprobante sobre el que se solicitó la cancelación. Ver desglose siguiente
batchIdentifierField Llega null

responseField.identifierField — datos del comprobante:

Campo Contenido
documentGUIDField Folio Fiscal del comprobante. Permite confirmar que la solicitud se aplicó al CFDI correcto
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 Llega vacío aunque la solicitud haya sido admitida, porque la cancelación aún no se ha consumado. No lo tomes como confirmación
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 comprobante SAT; type2Field = Tipo 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 solicitud ante el SAT:

Campo Contenido
responseData1Field Acuse CancelaCFDResult devuelto por el SAT en Base64
responseData2Field Clave del SAT en texto plano, con el prefijo SAT: y su descripción. No viene codificada
responseData3Field Vacío
responseDataSetField Llega null
Asimetría de codificación. responseData1Field llega en Base64 y responseData2Field en texto plano. Intentar decodificar el segundo produce un error o un valor sin sentido.

Estructura del acuse CancelaCFDResult (contenido de responseData1Field decodificado)

<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. Es el mismo número que aparece en responseData2Field
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

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.


9. Estructura de respuesta — error

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 solicitud no se presentó
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.
dataField Puede traer contexto adicional del diagnóstico
responseData1Field · responseData2Field Vacíos
Dos numeraciones en juego. codeField trae un código de MYSuite; responseData2Field trae una clave del SAT. Un error de MYSuite 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


11. Límites y comportamiento


Aspecto Valor
Comprobantes por llamada Uno. El criterio es un único DocumentGUID
Alcance Solo comprobantes emitidos, del RFC y 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 o el código 3192
Plazos de cancelación Consultar al SAT
Aceptación del receptor CFDI con estado Cancelable con Aceptación
Latencia hasta la cancelación efectiva Consultar el estado de cancelación posterior a su certificación, esto para no construir ciclos de consulta innecesarios
Timeout 60 segundos en 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.
  • 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: elegirlo mal documenta mal la operación. La decisión corresponde al área fiscal o contable.
  • Las retenciones se cancelan con CANCELAR_RETENCION_SINGLE_MYSUITE_3, no con esta transacción.
  • El estado real de cancelación se verifica con CONSULTAR_DOCUMENTO.

Solución de problemas

"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 · CANCEL_DOCUMENT_3.

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 CONSULTAR_DOCUMENTO antes de darlo por cancelado. Fíjate además en que cancelledTimeStampField llega vacío en esta respuesta, justamente porque la cancelación no se ha consumado.

Causa. Se interpretó resultField = true como confirmación. Son dos cosas distintas: que la solicitud se presentara y que la cancelación ocurriera.

"Me rechaza la cancelación con motivo 01"


Problema. La solicitud falla al usar el motivo 01.

Entorno. CFDI + Timbrado · API REST · sustitución de comprobantes.

Resolución. El motivo 01 exige el Folio Fiscal del comprobante que sustituye al cancelado en la entrada 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 envió FolioSustitucion vacío con motivo 01, o se eligió ese motivo sin haber emitido el sustituto.

"Recibo 3192 y no sé si insistir"


Problema. La respuesta trae el código 3192 DOCUMENT_ON_CANCEL_PROCESS.

Entorno. CFDI + Timbrado · API REST · procesos con reintento automático.

Resolución. No insistas. Ya existe una solicitud de cancelación en curso para ese comprobante, y el campo dataField puede traer contexto del diagnóstico. Consulta el estado del comprobante y espera a que el proceso se resuelva. Es una protección contra solicitudes duplicadas, no una falla.

Causa. La plataforma bloquea las solicitudes repetidas mientras hay una cancelación en trámite.

"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 · 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.

"No encuentro el comprobante al solicitar la cancelación"


Problema. La solicitud falla porque el comprobante no se localiza.

Entorno. CFDI + Timbrado · API REST · cancelación de comprobantes de años anteriores.

Resolución. Revisa la entrada Year del primer Dictionary: debe corresponder al año de emisión del comprobante, no al año en curso. Verifica también que IssuerTaxId sea el RFC del emisor y que el DocumentGUID esté completo, con sus 36 caracteres y sus guiones.

Causa. El año es un criterio de búsqueda y acota el alcance. Cancelar en enero un comprobante de diciembre es el caso que más se repite.

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


Problema. El intento de decodificar responseData2Field produce un error o un valor sin sentido.

Entorno. CFDI + Timbrado · API REST · integraciones nuevas.

Resolución. Ese campo llega en texto plano, con el prefijo SAT: seguido del número y su descripción. Solo responseData1Field viene en Base64. Lee la clave directamente del texto, o del elemento EstatusUUID del acuse si prefieres un valor sin formato.

Causa. Los dos campos de carga de esta transacción no comparten codificación.

"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 · 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.

"Copié la implementación de otra transacción y no funciona"


Problema. La petición es rechazada al reutilizar el código de otra transacción de la modalidad.

Entorno. CFDI + Timbrado · API REST · integraciones que implementan varias transacciones.

Resolución. Esta es la única transacción de la modalidad que envía dos estructuras codificadas en Base64, una en Data1 y otra en Data2, con nombres de Dictionary distintos. Y si vienes de la vía JsonServiceCall, ten presente que allí los criterios viajan como JSON con nombres de campo distintos y requieren token: no se puede compartir la capa de armado entre ambas vías.

Causa. El contrato de los tres campos de datos cambia en cada transacción, y aquí además cambia entre los dos puntos de entrada al mismo servicio.



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.

Por qué llegan dos estructuras en lugar de una

Una dice cuál comprobante y la otra dice por qué. Separarlas permitió añadir el motivo, sin tocar la estructura de selección que ya usaban otras transacciones. Es la misma StoredXmlSelector que aparece en la recuperación y en las búsquedas, reutilizada tal cual, con el motivo viajando aparte en su propio diccionario. Visto así, la aparente complicación es en realidad una decisión de compatibilidad.

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.

Conviene notar el contraste con la consulta de estado: el acuse de la solicitud sí está firmado, mientras que la respuesta de CONSULTAR_DOCUMENTO 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. El código 3192 de MYSuite cumple una función parecida un paso antes: detiene la solicitud sin llegar a presentarla de nuevo. Ambos son protecciones, y una integración que los trate como fallos acaba corrigiendo lo que ya funcionaba.

Dos caminos al mismo servicio

La misma cancelación puede pedirse por RequestTransaction o por JsonServiceCall. La primera envía credenciales en cada petición; la segunda exige obtener antes un token con AUTHENTICATE y recibe los criterios como JSON en lugar de como Dictionary. Conviven por razones históricas y no son intercambiables: cambian los nombres de los campos, el formato de los criterios y el manejo de la sesión. Elegir una u otra al empezar la integración evita tener que mantener las dos.

Por qué SOAP y REST se documentan por separado

La transacción es la misma operación de negocio en ambos transportes: mismos diccionarios, mismo catálogo de motivos, mismo acuse. 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.


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