Qué hace: solicita al SAT la cancelación de un CFDI de Retenciones e Información de Pagos que certificaste, esto conforme al esquema vigente. Le indicas qué retención quieres cancelar y por qué motivo, y te devuelve el acuse del SAT junto con el mensaje del código de respuesta que la autoridad emitió.
Cuándo se usa: cuando necesitas cancelar una constancia de retenciones emitida por error, por una operación que no se llevó a cabo, o porque la sustituiste por otra.
Cuándo no usarla: para cancelar CFDI de ingreso, egreso, traslado, nómina o pago, que se cancelan con CANCEL_DOCUMENT_3.



| Si tu integración… | Tu artículo es... |
|---|---|
| Cancela un CFDI de Retenciones e Información de Pagos, por SOAP | Este artículo |
| Solicita cancelar un CFDI de ingreso, egreso, traslado, nómina o pago | CANCEL_DOCUMENT_3 — CFDI + Timbrado (SOAP) |
| Va a certificar la retención que sustituirá a la cancelada | FIRMAR_RETENCION — CFDI + Timbrado (SOAP) |
| Necesita el XML o el PDF de una retención | GET_DOCUMENT_RETENCIONES |
| Necesita el estado de cancelación de un CFDI ordinario (ingreso, egreso, traslado, etc.) | CONSULTAR_DOCUMENTO |
Requestor y Entity.01: la retención sustituta ya debe estar certificada, con su Folio Fiscal a la mano.FIRMAR_RETENCION.01, 02, 03 o 04.01. La retención sustituta tiene que existir antes de la cancelación.Dictionary CancelInfo con las entradas Motivo y FolioSustitucion, y codifícalo en Base64.Transaction con valor CANCELAR_RETENCION_SINGLE_MYSUITE_3, el UUID en Data1 en texto plano, la cadena Base64 en Data2 y Data3 vacío.Data2 va codificado en Base64.RequestTransactionResponse.Result. Si es false, revisa Code, LastResult, Description, Hint y Data.Result = true te permite continuar; Result = false te lleva a Solución de problemas.ResponseData2 en texto plano para conocer el mensaje del SAT, y decodifica ResponseData1 desde Base64 para obtener el acuse.| Protocolo | SOAP 1.1 / 1.2 sobre HTTPS |
|---|---|
| Servicio | FactWSFront |
| Operación | RequestTransaction |
| Namespace | http://www.fact.com.mx/schema/ws |
| SOAPAction | http://www.fact.com.mx/schema/ws/RequestTransaction |
Valor <Transaction> |
CANCELAR_RETENCION_SINGLE_MYSUITE_3 |
| Naturaleza | Solicitud de cancelación de un CFDI de Retención ante la autoridad. Presenta la cancelación al SAT y devuelve su acuse |
| Ambiente | URL |
|---|---|
| Pruebas | https://www.mysuitetest.com/mx.com.fact.wsfront/FactWSFront.asmx |
| Producción | https://www.mysuitecfdi.com/mx.com.fact.wsfront/FactWSFront.asmx |
JES900109Q90 como RFC emisor (Entity). Solo cancelas retenciones del ambiente en que operas.Esta modalidad no usa token: las credenciales viajan en cada petición.
| Campo | Tipo | Obligatorio | Formato | Descripción |
|---|---|---|---|---|
Requestor |
GUID | Sí | GUID | Dato que proporciona MYSuite, ligado a la seguridad de la transacción, la autenticación y autorización |
Country |
string | Sí | Valor fijo MX |
Código de país de la operación |
Entity |
string | Sí | RFC (12–13 caracteres) | RFC del emisor de la retención que se cancela. En pruebas debe ser JES900109Q90 |
User |
GUID | Sí | GUID | Identificador del usuario, colocar el valor del Requestor proporcionado por MYSuite |
UserName |
string | Sí | País.RFC.usuario |
Nombre de usuario. Ejemplo MX.JES900109Q90.jan |
Entity debe ser el emisor del comprobante.| Nombre | Tipo | Obligatorio | Límite | Formato | Descripción |
|---|---|---|---|---|---|
Data1 |
string | Sí | 36 | UUID, texto plano | Folio Fiscal de la retención que quieres cancelar. No se codifica en Base64 |
Data2 |
string | Sí | — | Base64 | Dictionary CancelInfo con la información de la cancelación. Ver apartado 5 |
Data3 |
string | No | — | Vacío | Sin uso en esta transacción. Debe enviarse vacío |
Data1 viaja en texto plano y Data2 en Base64. Es la diferencia principal con CANCEL_DOCUMENT_3, donde ambos nodos llevan estructuras codificadas. Si reutilizas la implementación de aquella transacción, la cancelación de retenciones va a fallar.El UUID de la retención, tal como aparece en el Timbre Fiscal Digital del comprobante certificado. Ejemplo de forma: 7cd4d001-16b1-4836-9b81-360225c80182
Dictionary CancelInfo<Dictionary name="CancelInfo">
<Entry k="Motivo" v="[clave 01, 02, 03 o 04]"/>
<Entry k="FolioSustitucion" v="[UUID sustituto en caso de Motivo "01", otros Motivos debe venir vacío]"/>
</Dictionary>Entrada (k) |
Tipo | Oblig. | Límite | Formato | Descripción |
|---|---|---|---|---|---|
Motivo |
string | Sí | 2 | 01 · 02 · 03 · 04 |
Clave del motivo de cancelación del comprobante, conforme al catálogo del SAT. Ver tabla siguiente |
FolioSustitucion |
string | Condicional | 36 | UUID o valor vacío | UUID que sustituye al folio fiscal a cancelar. Es requerido cuando el motivo es 01; en los demás casos se envía vacío |
| Clave | Descripción | Requiere FolioSustitucion |
|---|---|---|
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 |
CANCEL_DOCUMENT_3. Sin estructura. Se envía vacío.
La fuente no publica ejemplos para esta transacción. El siguiente se deriva del contrato documentado en los apartados anteriores.
<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" xmlns:ws="http://www.fact.com.mx/schema/ws">
<soapenv:Header/>
<soapenv:Body>
<ws:RequestTransaction>
<ws:Requestor>0c320b03-d4f1-47bc-9fb4-77995f9bf33e</ws:Requestor>
<ws:Transaction>CANCELAR_RETENCION_SINGLE_MYSUITE_3</ws:Transaction>
<ws:Country>MX</ws:Country>
<ws:Entity>JES900109Q90</ws:Entity>
<ws:User>0c320b03-d4f1-47bc-9fb4-77995f9bf33e</ws:User>
<ws:UserName>MX.JES900109Q90.jan</ws:UserName>
<ws:Data1>f904f3b7-13c7-43d8-b425-51d8f72eeb9b</ws:Data1>
<ws:Data2>PERpY3Rpb25hcnkgbmFtZT0iQ2FuY2VsSW5mbyI+PEVudHJ5IGs9Ik1vdGl2byIgdj0iMDIiLz48RW50cnkgaz0iRm9saW9TdXN0aXR1Y2lvbiIgdj0iIi8+PC9EaWN0aW9uYXJ5Pg==</ws:Data2>
<ws:Data3></ws:Data3>
</ws:RequestTransaction>
</soapenv:Body>
</soapenv:Envelope><soap:Envelope xmlns:soap="http://www.w3.org/2003/05/soap-envelope" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:xsd="http://www.w3.org/2001/XMLSchema">
<soap:Body>
<RequestTransactionResponse xmlns="http://www.fact.com.mx/schema/ws">
<RequestTransactionResult>
<Request>
<Requestor>00000000-0000-0000-0000-000000000000</Requestor>
<RequestorActive>true</RequestorActive>
<Transaction>CANCELAR_RETENCION_SINGLE_MYSUITE_3</Transaction>
<Country>MX</Country>
<Entity>JES900109Q90</Entity>
<User>00000000-0000-0000-0000-000000000000</User>
<UserName>Jan_Pruebas</UserName>
<Id>be558d0e-90ff-4805-a30c-cb1768a099ca</Id>
<TimeStamp>2026-09-17T11:08:56.8354389-06:00</TimeStamp>
</Request>
<Response>
<Result>true</Result>
<TimeStamp>2026-09-17T11:08:58.1043514-06:00</TimeStamp>
<LastResult/>
<Code>1</Code>
<Description/>
<Hint/>
<Data>10196 be558d0e-90ff-4805-a30c-cb1768a099ca</Data>
<Processor>TEST-BACK03</Processor>
</Response>
<ResponseData>
<ResponseData1>PD94bWwgdmVyc2lvbj0iMS4wIj8+PEFjdXNlIHhtbG5zOnhzZD0iaHR0cDovL3d3dy53My5vcmcvMjAwMS9YTUxTY2hlbWEiIHhtbG5zOnhzaT0iaHR0cDovL3d3dy53My5vcmcvMjAwMS9YTUxTY2hlbWEtaW5zdGFuY2UiIEZlY2hhPSIyMDI2LTA5LTE3VDExOjA4OjU3LjkzMTk5NDUiIFJmY0VtaXNvcj0iSkVTOTAwMTA5UTkwIiBXb3JrUHJvY2Vzc0lkPSIwY2RjOWU1NC1lYjg5LTQyZDQtOGM2Ny1lYTFlODJjYTE5NjkiIHhtbG5zPSJodHRwOi8vd3d3LnNhdC5nb2IubXgvZXNxdWVtYXMvcmV0ZW5jaW9ucGFnby8xIj48Rm9saW9zPjxVVUlEPkY5MDRGM0I3LTEzQzctNDNEOC1CNDI1LTUxRDhGNzJFRUI5QjwvVVVJRD48RXN0YXR1c1VVSUQ+MTIwMTwvRXN0YXR1c1VVSUQ+PE1vdGl2bz4wMjwvTW90aXZvPjxFeHRlbXBvcmFuZW8+ZmFsc2U8L0V4dGVtcG9yYW5lbz48L0ZvbGlvcz48U2lnbmF0dXJlIElkPSJTZWxsb1NBVCIgeG1sbnM9Imh0dHA6Ly93d3cudzMub3JnLzIwMDAvMDkveG1sZHNpZyMiPjxTaWduZWRJbmZvPjxDYW5vbmljYWxpemF0aW9uTWV0aG9kIEFsZ29yaXRobT0iaHR0cDovL3d3dy53My5vcmcvVFIvMjAwMS9SRUMteG1sLWMxNG4tMjAwMTAzMTUiIC8+PFNpZ25hdHVyZU1ldGhvZCBBbGdvcml0aG09Imh0dHA6Ly93d3cudzMub3JnLzIwMDEvMDQveG1sZHNpZy1tb3JlI2htYWMtc2hhNTEyIiAvPjxSZWZlcmVuY2UgVVJJPSIiPjxUcmFuc2Zvcm1zPjxUcmFuc2Zvcm0gQWxnb3JpdGhtPSJodHRwOi8vd3d3LnczLm9yZy9UUi8xOTk5L1JFQy14cGF0aC0xOTk5MTExNiI+PFhQYXRoPm5vdChhbmNlc3Rvci1vci1zZWxmOjoqW2xvY2FsLW5hbWUoKT0nU2lnbmF0dXJlJ10pPC9YUGF0aD48L1RyYW5zZm9ybT48L1RyYW5zZm9ybXM+PERpZ2VzdE1ldGhvZCBBbGdvcml0aG09Imh0dHA6Ly93d3cudzMub3JnLzIwMDEvMDQveG1sZW5jI3NoYTUxMiIgLz48RGlnZXN0VmFsdWU+RkM3VkNod3c4MFNDYTFKQUFjUHZyZDN6bzV5M0k5N1ZWL29RQW1KemRzenhhOWh2VnBjYmVoZncvNFhiNXpRT1FvWEFUTjhrc1dVbm15QUwybExQdHc9PTwvRGlnZXN0VmFsdWU+PC9SZWZlcmVuY2U+PC9TaWduZWRJbmZvPjxTaWduYXR1cmVWYWx1ZT56am9FNFZuZVJmUU5IMWhqT3pWYWF4QXhzZjUzdXg4WXZHSmZwWnZOcDBaNm5OUGhoV3NFOW5kdG5PRjdzZTFmTEVvaTErSkFBRWpKanZnZU9hSnV0Zz09PC9TaWduYXR1cmVWYWx1ZT48S2V5SW5mbz48S2V5TmFtZT4zMDAwMTAwMDAwMDUwMDAwMjU1NDwvS2V5TmFtZT48S2V5VmFsdWU+PFJTQUtleVZhbHVlPjxNb2R1bHVzPmhVY1VPb0dFdFNEQWxyRjhLZWdRa0dLWThhREFlOXROUmtmNDh1ajErWWlyRFA0Y01FZDhZRWVsUVkxakx1MUdJTllLZjlOOVh4bU9mSGRMNEZVcitjdU9nckJ2aWFHV2NJc0pmWjgwSUdwdm94NmtVU0hvUnQraDMyeVFheVcwSHVOT3AwYjN5aUJwOVk2alRkWVRGVEFWemd6VWpmNExmVnQ4bjVGZWpWWjJ4RVJJeVJPbkdnYks4QTR4QnNQcEZhekhRa0syUENpWWUrTFlCbTBVeDlVWllrWUo5TXU5ckw1YzUxU2pncThKSmVrb3JwMEJ6ZkthZFJyU0VGeUQyWjZHd0IwUnN3akxaUXNwb2paR3hVbnFsYmxkdk82VGpGVVY0TVQ3RVY4UDdmMlZUUzB5cjRxU3d4MHkwODB6b0sxMENiSW9KWGZzRlJPSHlwRmo1dz09PC9Nb2R1bHVzPjxFeHBvbmVudD5BUUFCPC9FeHBvbmVudD48L1JTQUtleVZhbHVlPjwvS2V5VmFsdWU+PC9LZXlJbmZvPjwvU2lnbmF0dXJlPjwvQWN1c2U+</ResponseData1>
<ResponseData2>1201 UUID cancelado.</ResponseData2>
<ResponseData3/>
</ResponseData>
</RequestTransactionResult>
</RequestTransactionResponse>
</soap:Body>
</soap:Envelope>
La respuesta se organiza en tres bloques dentro de RequestTransactionResult, con la misma forma que el resto de la modalidad.
| Bloque | Elemento | Contenido |
|---|---|---|
Request |
Eco de los parámetros de identidad | Devuelve Transaction, Country, Entity y UserName |
RequestorActive |
Indica si el solicitante está activo | |
Id · TimeStamp |
Identificador de la operación y momento de recepción | |
Response |
Result |
true cuando la solicitud de cancelación se presentó ante el SAT. No confirma que la retención haya quedado cancelada |
Code |
Código de resultado de MYSuite. Ver apartado 10 | |
TimeStamp |
Momento en que concluyó el procesamiento | |
LastResult · Description · Hint |
Vacíos en solicitud aceptada. Ver apartado 9 | |
Data · Processor |
Referencia interna del procesamiento y Servidor que atendió la solicitud | |
ResponseData |
ResponseData1 |
Acuse devuelto por el SAT en la solicitud de cancelación, codificado en Base64 |
ResponseData2 |
Mensaje del SAT en texto plano: traducción del código de respuesta obtenido en la cancelación. No viene en Base64 | |
ResponseData3 |
Vacío |
Code es de MYSuite e indica si la plataforma pudo procesar tu solicitud. El código que viaja dentro de ResponseData2 es del SAT e indica cómo respondió la autoridad. Son catálogos independientes y no deben mezclarse en la lógica de tu ERP.El sobre es el mismo del apartado 8. Cambia el contenido de Response y las cargas llegan vacías.
| Elemento | Contenido en error |
|---|---|
Result |
false: la solicitud no se presentó |
Code |
Código numérico del error de MYSuite. Ver apartado 10 |
LastResult |
Identificador simbólico del error. Es el valor más estable para ramificar tu lógica, por encima del texto de Description |
Description · Hint |
Mensaje del error y sugerencia de corrección |
Data |
Bloque de diagnóstico. Dato a incluir al reportar la incidencia a Soporte |
Processor |
Servidor que atendió la solicitud. Dato a incluir al reportar la incidencia a Soporte |
ResponseData1 · ResponseData2 |
Vacíos |
Result = false y HTTP 200. Evalúa siempre Result y no asumas éxito por el código de estado HTTP.ResponseData2)| Código | Significado | Causa | Remedio |
|---|---|---|---|
| 1201 | Éxito | La solicitud de cancelación se presentó ante el SAT y respondió "1201 UUID cancelado." |
Conservar el acuse y el mensaje de ResponseData2 |
| 1202 | Éxito | La solicitud de cancelación se presentó ante el SAT y respondió "1202 UUID previamente cancelado." |
Conservar el acuse y el mensaje de ResponseData2 |
| Aspecto | Valor |
|---|---|
| Comprobantes por llamada | Uno |
| Efectos | Presenta una solicitud ante la autoridad fiscal sobre un comprobante con efectos fiscales |
| Confirmación del desenlace | No existe hoy una transacción documentada que consulte el estado de una retención. CONSULTAR_DOCUMENTO solo contempla los tipos issued y received de CFDI ordinarios |
| Aceptación del receptor | La cancelación de retenciones es síncrona y definitiva. |
| Reintentos | Si ya se había cancelado, se obtiene 1202 UUID previamente cancelado |
| Idempotencia | No genera |
| Plazo para cancelar | No definido |
| Consumo de folios | No se descuenta folio por uso de la transacción |
| Timeout | 60 segundos en servidor front |
ResponseData1 lo emite el SAT, no MYSuite. Conservarlo es responsabilidad del emisor, y aquí con más razón que en los CFDI ordinarios, porque no hay forma documentada de reconstruir el trámite consultando después.CANCEL_DOCUMENT_3.Problema. La petición es rechazada al reutilizar la implementación de CANCEL_DOCUMENT_3.
Entorno. CFDI + Timbrado · SOAP · integraciones que cancelan los dos tipos de comprobante.
Resolución. Las dos transacciones reciben el documento de forma distinta. Aquí Data1 lleva el UUID en texto plano; en CANCEL_DOCUMENT_3 lleva un Dictionary StoredXmlSelector codificado en Base64. Lo único que sí puedes compartir entre ambas es el armado del Dictionary CancelInfo de Data2, que es idéntico.
Causa. Cada transacción define qué pone en cada nodo de datos. La similitud de propósito no implica similitud de contrato.
Problema. La solicitud con motivo 01 no se acepta.
Entorno. CFDI + Timbrado · SOAP · cancelaciones de retenciones por sustitución.
Resolución. El motivo 01 exige la entrada FolioSustitucion con el UUID de la retención que sustituye a la cancelada, y esa retención debe estar certificada antes de solicitar la cancelación. El orden es: primero certificas la sustituta con FIRMAR_RETENCION, después cancelas la original.
Causa. El flujo intuitivo es cancelar primero y volver a emitir después, pero el esquema de 2022 lo invierte para los casos con relación: el sustituto tiene que existir para poder declararlo.
Problema. Tras la solicitud no hay forma evidente de verificar el estado del comprobante.
Entorno. CFDI + Timbrado · SOAP · procesos de cancelación de retenciones.
Resolución. Por servicio web no existe hoy una transacción documentada que consulte el estado de una retención: CONSULTAR_DOCUMENTO solo contempla CFDI ordinarios. Tu evidencia es el acuse de ResponseData1 y el mensaje de ResponseData2, así que consérvalos junto con la fecha y el motivo. Para verificar el estado ante la autoridad, usa los medios que el SAT dispone.
Problema. El ERP no recibe respuesta y no puede determinar si la solicitud llegó al SAT.
Entorno. CFDI + Timbrado · SOAP · redes con latencia o cortes intermitentes.
Resolución. Registra en tu sistema la solicitud antes de enviarla, con su UUID, motivo y marca de tiempo, para que el intento quede documentado aunque la respuesta se pierda. Ante un corte, detén el proceso de esa retención y consulta el estado por los medios del SAT antes de volver a solicitarla.
Problema. ResponseData1 llega vacío.
Entorno. CFDI + Timbrado · SOAP · cancelaciones rechazadas.
Resolución. Revisa primero Result. Si es false, la solicitud nunca llegó al SAT y por lo tanto no hay acuse: el motivo del rechazo está en Code, LastResult, Description, Hint y Data. El acuse solo existe cuando la solicitud se presentó.
Causa. El acuse lo emite la autoridad, no la plataforma. Si MYSuite detuvo la solicitud antes de enviarla, no hay nada que la autoridad haya acusado.
Problema. Un proceso necesita cancelar un conjunto de retenciones y llamar una por una resulta costoso.
Entorno. CFDI + Timbrado · SOAP · correcciones masivas.
Resolución. Esta transacción cancela una retención por llamada. Implementa el ciclo en tu ERP, registrando el resultado de cada una por separado, ya que no puedes reconstruir después cuáles se cancelaron y cuáles no.
El CFDI de Retenciones es un documento distinto del CFDI de factura, con su propio esquema y su propio ciclo en la plataforma. Ese ciclo es completo y paralelo: FIRMAR_RETENCION certifica, GET_DOCUMENT_RETENCIONES recupera y esta transacción cancela, igual que CONVERT_NATIVE_XML, RETRIEVE_DOCUMENT y CANCEL_DOCUMENT_3 forman el ciclo de los comprobantes ordinarios. Las transacciones de un ciclo no sirven para los documentos del otro.
Las tres transacciones de retenciones comparten una forma de recibir el comprobante: el UUID en texto plano en Data1, sin Dictionary ni Base64. Las de CFDI ordinarios usan el Dictionary StoredXmlSelector, que necesita almacén, país, RFC, UUID y año. La diferencia tiene sentido: para un CFDI ordinario la plataforma necesita saber en qué almacén y en qué ejercicio buscar; para una retención le basta el folio fiscal. Reconocer ese patrón ayuda a implementar el ciclo de retenciones como un bloque coherente en lugar de como tres excepciones sueltas.
El Dictionary CancelInfo es idéntico en las dos transacciones, con las mismas entradas y el mismo catálogo de motivos. Es lo esperable: el motivo de cancelación es una exigencia de la autoridad sobre el acto de cancelar, no sobre el tipo de comprobante. Conviene implementarlo una sola vez y reutilizarlo en ambas.
Para los CFDI ordinarios, cancelar y confirmar forman un par: CANCEL_DOCUMENT_3 abre el trámite y CONSULTAR_DOCUMENTO lo cierra. En retenciones falta la segunda mitad: los criterios de la consulta contemplan documentos emitidos y recibidos, no retenciones. La consecuencia práctica es que aquí el acuse importa más que en ningún otro caso, porque es tu único registro del trámite por esta vía. Conviene guardarlo junto con la fecha y el motivo, y no dar por sentado que podrás reconstruir la información después.
Ya existía uno parecido en la emisión: FIRMAR_RETENCION no tiene un equivalente de LOOKUP_ISSUED_INTERNAL_ID con el que verificar si una certificación se completó tras perder la respuesta. Que el mismo patrón se repita en la cancelación sugiere que el ciclo de retenciones se construyó para el camino feliz y que las transacciones de verificación llegaron solo del lado de los CFDI ordinarios.
Intervienen dos sistemas. MYSuite decide si tu solicitud es procesable y eso viaja en Code. El SAT decide qué hace con la solicitud, y eso viaja traducido en ResponseData2. Un error de MYSuite significa que la autoridad nunca se enteró; un código del SAT significa que la solicitud llegó y obtuvo respuesta. Mezclar ambos catálogos lleva a interpretar mal en qué punto se detuvo la cancelación.
La transacción sería la misma operación de negocio en ambos transportes, pero cambia 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.
Emisión
Consulta y Recuperación
Validación y Recepción
CFDI de Retenciones
Esquema de cancelación