CANCELAR_RETENCION_SINGLE_MYSUITE_3 — SERVICIO CFDI + Timbrado (SOAP)

CANCELAR_RETENCION_SINGLE_MYSUITE_3 — SERVICIO CFDI + Timbrado (SOAP)

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


Warning
Guarda el acuse y el registro de la solicitud. A diferencia de los CFDI ordinarios, que se consultan con CONSULTAR_DOCUMENTO, no hay hoy una transacción documentada que te diga en qué estado quedó una retención. El acuse del SAT que devuelve esta llamada es tu única evidencia del trámite por esta vía.

Info
El motivo de cancelación es obligatorio desde el esquema de 2022, y si eliges el motivo 01 tienes que proporcionar el Folio Fiscal de la retención que sustituye a la cancelada. Ese sustituto debe estar certificado antes de solicitar la cancelación.

Alert
Advertencia de homonimia. Este artículo documenta el consumo por SOAP, contra el servicio FactWSFront.


Cómo saber si este es tu artículo


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


Requisitos previos

  • Credenciales de integración vigentes que te proporciona MYSuite: Requestor y Entity.
  • Tener a la mano el Folio Fiscal (UUID) de la retención que quieres cancelar.
  • El motivo de cancelación decidido, esto conforme al catálogo del SAT.
  • Si el motivo es 01: la retención sustituta ya debe estar certificada, con su Folio Fiscal a la mano.


Cómo hacerlo


  1. Identifica el Folio Fiscal de la retención que quieres cancelar. Es el mismo UUID que extrajiste del Timbre Fiscal Digital al certificarla con FIRMAR_RETENCION.
    Resultado: el criterio que identifica el comprobante.
  2. Determina el motivo de cancelación conforme al catálogo del SAT: 01, 02, 03 o 04.
    Resultado: la clave que vas a declarar ante la autoridad.
  3. Certifica primero la retención sustituta y toma su Folio Fiscal, sólo si elegiste el motivo 01. La retención sustituta tiene que existir antes de la cancelación.
    Resultado: el UUID de sustitución listo para declararse.
  4. Construye el Dictionary CancelInfo con las entradas Motivo y FolioSustitucion, y codifícalo en Base64.
    Resultado: una cadena Base64 en una sola línea.
  5. Arma el sobre SOAP con las credenciales, Transaction con valor CANCELAR_RETENCION_SINGLE_MYSUITE_3, el UUID en Data1 en texto plano, la cadena Base64 en Data2 y Data3 vacío.
    Resultado: petición lista. Fíjate en que solo Data2 va codificado en Base64.
  6. Envía la petición al web service del ambiente que corresponda.
    Resultado: respuesta HTTP 200 con un sobre RequestTransactionResponse.
  7. Lee el elemento Result. Si es false, revisa Code, LastResult, Description, Hint y Data.
    Resultado: Result = true te permite continuar; Result = false te lleva a Solución de problemas.
  8. Lee ResponseData2 en texto plano para conocer el mensaje del SAT, y decodifica ResponseData1 desde Base64 para obtener el acuse.
    Resultado: la respuesta de la autoridad y su evidencia documental.
  9. Conserva el acuse y registra en tu sistema la fecha, el motivo y el resultado de la solicitud.
    Resultado: trazabilidad del trámite, que aquí no puedes reconstruir consultando después.
  10. Actualiza el estado de la retención en tu ERP conforme a lo que indique el mensaje del SAT.
    Resultado: contabilidad alineada con lo que respondió la autoridad.


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

Contrato técnico

1. Endpoint y operación

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

2. Ambientes

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
Restricción del ambiente de pruebas. Un cliente CFDI + Timbrado (SOAP) debe usar JES900109Q90 como RFC emisor (Entity). Solo cancelas retenciones del ambiente en que operas.


3. Autenticación

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
Info
Solo puedes cancelar retenciones que emitiste: el Entity debe ser el emisor del comprobante.


4. Parámetros de entrada

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
Codificación mixta. 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.


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

Data1 — Folio Fiscal

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

Data2 — 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
Catálogo de motivos de cancelación (SAT)
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


Es el mismo catálogo y la misma estructura que usa CANCEL_DOCUMENT_3. 

Data3

Sin estructura. Se envía vacío.


6. Ejemplo de request

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>


7. Ejemplo de response

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


8. Estructura de respuesta — éxito

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
Dos códigos distintos en la misma respuesta. El elemento 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.


9. Estructura de respuesta — error

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
Un error de negocio se reporta con Result = false y HTTP 200. Evalúa siempre Result y no asumas éxito por el código de estado HTTP.


10. Códigos de Error

Códigos del SAT (dentro de 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


11. Límites y comportamiento

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


12. Versionado y cumplimiento

  • Implementa el esquema de cancelación vigente, que incorporó el motivo de cancelación obligatorio y el folio de sustitución.
  • El acuse de 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.
  • La cancelación de CFDI ordinarios sigue una transacción distinta: CANCEL_DOCUMENT_3.

Solución de problemas

"Copié el código de la otra cancelación y no funciona"


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.

"Elegí el motivo 01 y me rechaza la cancelación"


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.

"¿Cómo confirmo que la retención quedó cancelada?"


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.

Causa. No hay una transacción de consulta equivalente a las de los CFDI ordinarios.

"Se cayó la conexión y no sé si la cancelación se envió"


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.

Causa. No hay una transacción de consulta equivalente a las de los CFDI ordinarios.

"No recibí el acuse del SAT"


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.

"Quiero cancelar varias retenciones de una vez"


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.

Causa. El servicio de cancelación del SAT en retención es síncrono, solicitud-respuesta.
Para entender más

Por qué las retenciones tienen su propia cancelación

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.

Una diferencia de contrato que sí tiene patrón

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.

Lo que sí se comparte entre ambas cancelaciones

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.

El hueco de la confirmación

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.

Es el segundo hueco del ciclo de retenciones

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.

Por qué hay dos códigos en la misma respuesta

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.

Por qué SOAP y REST se documentan por separado

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.


Transacciones del servicio CFDI + Timbrado (SOAP)

Emisión

Consulta y Recuperación

Validación y Recepción

CFDI de Retenciones

Esquema de cancelación