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.
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.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.| 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 |
Requestor y Entity.01, el Folio Fiscal del comprobante que sustituye al cancelado, ya timbrado.01, 02, 03 y 04.01, y guarda su Folio Fiscal.Dictionary con el atributo name igual a StoredXmlSelector, con las entradas Store, IssuerCountryCode, IssuerTaxId, DocumentGUID y Year, y codifícalo en Base64.Data1.Dictionary, con el atributo name igual a CancelInfo, con las entradas Motivo y FolioSustitucion, y codifícalo también en Base64.Data2.Transaction con valor CANCEL_DOCUMENT_3, las dos cadenas Base64 en Data1 y Data2, Data3 como cadena vacía.POST al recurso /RequestTransaction con Content-Type: application/json.responseField.resultField.responseField = true te permite continuar; responseField = false te lleva a Solución de problemas.responseDataField.responseData2Field tal cual, en texto plano: ahí viene la clave que devolvió el SAT.responseDataField.responseData1Field desde Base64 para obtener el acuse en XML, con el estatus del folio.CONSULTAR_DOCUMENTO. No marques el comprobante como cancelado en tu ERP a partir de la respuesta 201.Si algo falla, ve a Solución de problemas.
| 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 |
| Ambiente | URL |
|---|---|
| Pruebas | https://api.mysuitetest.com/RequestTransaction |
| Producción | https://api.mysuitecfdi.com/RequestTransaction |
JES900109Q90 como Entity en pruebas; en producción, el RFC del emisor. Solo puedes solicitar cancelar comprobantes del ambiente en que operas.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 |
| 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 |
Dictionary, ambas van en Base64, pero tienen nombres distintos y propósitos distintos: una dice cuál comprobante, la otra dice por qué.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 |
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 |
| 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 |
Sin estructura. Se envía como cadena vacía.
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": ""
}{
"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
}
}
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 |
responseData1Field llega en Base64 y responseData2Field en texto plano. Intentar decodificar el segundo produce un error o un valor sin sentido.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ó |
| 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.
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 |
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.| 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 |
CancelaCFDResult viene firmado digitalmente por el SAT y constituye evidencia de que la solicitud se presentó. Consérvalo junto al comprobante.CANCELAR_RETENCION_SINGLE_MYSUITE_3, no con esta transacción.CONSULTAR_DOCUMENTO.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.
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.
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.
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.
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.
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.
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.
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.
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.
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.
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.
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.
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.
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.
Vía RequestTransaction