Qué hace: solicita al SAT la cancelación de un CFDI que emitiste, esto conforme al esquema vigente. Le indicas qué comprobante quieres solicitar su cancelación 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 solicitar cancelar un CFDI emitido por error, por una operación que no se llevó a cabo, o porque lo sustituiste por otro.
Cuándo no usarla: para cancelar un CFDI de Retenciones, que se cancela con CANCELAR_RETENCION_SINGLE_MYSUITE_3. Tampoco sirve para consultar en qué estado de cancelación se encuentra o quedó un comprobante: para eso está la transacción CONSULTAR_DOCUMENTO.


| Si tu integración… | Tu artículo es... |
|---|---|
| Quiere solicitar la Cancelación de un CFDI de ingreso, egreso, traslado, nómina o pago que emitiste, por SOAP | Este artículo |
| Quiere Cancelar un CFDI de Retenciones | CANCELAR_RETENCION_SINGLE_MYSUITE_3 |
| Necesita saber si un comprobante está vigente, en proceso de cancelación o cancelado | CONSULTAR_DOCUMENTO |
| Va a emitir el comprobante que sustituirá al cancelado | CONVERT_NATIVE_XML — CFDI + Timbrado (SOAP) |
| Necesita el XML o el PDF del comprobante que va a cancelar | RETRIEVE_DOCUMENT — CFDI + Timbrado (SOAP) |
Requestor y Entity.01: el comprobante sustituto debe estar ya certificado, con su Folio Fiscal a la mano.01, 02, 03 o 04.01. El CFDI sustituto tiene que existir antes de la cancelación.Dictionary StoredXmlSelector con las entradas Store, IssuerCountryCode, IssuerTaxId, DocumentGUID y Year.Dictionary CancelInfo con las entradas Motivo y FolioSustitucion.Data1 y la segunda en Data2.Transaction con valor CANCEL_DOCUMENT_3, las dos cadenas en Data1 y Data2, Data3 vacío.RequestTransactionResponse.Result. Si es false, revisa Code, Description, Hint y Data, que traen el detalle del rechazo.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. Conserva el acuse.CONSULTAR_DOCUMENTO antes de registrarlo como cancelado en tu contabilidad.| 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> |
CANCEL_DOCUMENT_3 |
| Naturaleza | Solicitud de cancelación de un CFDI ante la autoridad. |
| 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 solicitas cancelar comprobantes del ambiente en que operas. El SAT cuenta con un servicio de cancelación de test, este servicio es el que consumimos en ambiente de test de MYSuite.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, 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. Delimita el alcance de la consulta. En pruebas debe ser JES900109Q90 |
User |
GUID | Sí | GUID | Identificador del usuario de la integración, colocar valor del Requestor proporcionado por MYSuite |
UserName |
string | Sí | País.RFC.usuario |
Nombre de usuario. Ejemplo MX.JES900109Q90.jan |
| Nombre | Tipo | Obligatorio | Límite | Formato | Descripción |
|---|---|---|---|---|---|
Data1 |
string | Sí | — | Base64 | Dictionary StoredXmlSelector: identifica el documento a cancelar. Ver apartado 5 |
Data2 |
string | Sí | — | Base64 | Dictionary CancelInfo: información de la cancelación. Ver apartado 5 |
Data3 |
string | No | — | Vacío | Sin uso en esta transacción. El nodo debe existir y enviarse vacío |
Dictionary StoredXmlSelector<Dictionary name="StoredXmlSelector">
<Entry k="Store" v="ISSUED"/>
<Entry k="IssuerCountryCode" v="MX"/>
<Entry k="IssuerTaxId" v="[RFC del emisor]"/>
<Entry k="DocumentGUID" v="[UUID del comprobante a cancelar]"/>
<Entry k="Year" v="[año de emisión]"/>
</Dictionary>Entrada (k) |
Tipo | Obligatorio | Límite | Formato | Descripción |
|---|---|---|---|---|---|
Store |
string | Sí | — | ISSUED |
Almacén del comprobante. Cancelas lo que emitiste. |
IssuerCountryCode |
string | Sí | 2 | Valor MX |
Código de país del emisor |
IssuerTaxId |
string | Sí | 12–13 | RFC | RFC del emisor del comprobante |
DocumentGUID |
string | Sí | 36 | UUID | Folio Fiscal del comprobante que quieres solicitar su cancelación |
Year |
string | Sí | 4 dígitos | AAAA |
Año de emisión del comprobante a cancelar |
Dictionary CancelInfo
<Dictionary name="CancelInfo">
<Entry k="Motivo" v="[clave 01, 02, 03 o 04]"/>
<Entry k="FolioSustitucion" v="[UUID sustituto, o vacío]"/>
</Dictionary>Entrada (k) |
Tipo | Obligatorio | 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, admite valor vacío | UUID que sustituye al folio fiscal cancelado. Solo 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 |
Sin estructura. Se envía vacío.
<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>CANCEL_DOCUMENT_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>PERpY3Rpb25hcnkgbmFtZT0iU3RvcmVkWG1sU2VsZWN0b3IiPjxFbnRyeSBrPSJTdG9yZSIgdj0iSVNTVUVEIi8+PEVudHJ5IGs9Iklzc3VlckNvdW50cnlDb2RlIiB2PSJNWCIvPjxFbnRyeSBrPSJJc3N1ZXJUYXhJZCIgdj0iSkVTOTAwMTA5UTkwIi8+PEVudHJ5IGs9IkRvY3VtZW50R1VJRCIgdj0iYmVjYmIyNDMtMjFlNi00NGI2LTg5ZjctZDJjOWU1NDZmM2IzIi8+PEVudHJ5IGs9IlllYXIiIHY9IjIwMjYiLz48L0RpY3Rpb25hcnk+</ws:Data1>
<ws:Data2>PERpY3Rpb25hcnkgbmFtZT0iQ2FuY2VsSW5mbyI+PEVudHJ5IGs9Ik1vdGl2byIgdj0iMDIiLz48RW50cnkgaz0iRm9saW9TdXN0aXR1Y2lvbiIgdj0iIi8+PC9EaWN0aW9uYXJ5Pg==</ws:Data2>
<ws:Data3></ws:Data3>
</ws:RequestTransaction>
</soapenv:Body>
</soapenv:Envelope><soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" xmlns:ws="http://www.fact.com.mx/schema/ws">
<soapenv:Header/>
<soapenv:Body>
<RequestTransactionResponse xmlns="http://www.fact.com.mx/schema/ws">
<RequestTransactionResult>
<Request>
<Requestor>00000000-0000-0000-0000-000000000000</Requestor>
<RequestorActive>true</RequestorActive>
<Transaction>CANCEL_DOCUMENT_3</Transaction>
<Country>MX</Country>
<Entity>JES900109Q90</Entity>
<User>00000000-0000-0000-0000-000000000000</User>
<UserName>jan_test</UserName>
<Id>529c64ff-7fd5-4bdd-94fb-8715ce059d2f</Id>
<TimeStamp>2026-09-14T12:16:30.9614674-06:00</TimeStamp>
</Request>
<Response>
<Result>true</Result>
<TimeStamp>2026-09-14T12:16:31.9580273-06:00</TimeStamp>
<LastResult/>
<Code>1</Code>
<Description/>
<Hint/>
<Data>6525 529c64ff-7fd5-4bdd-94fb-8715ce059d2f</Data>
<Processor>TEST-BACK03</Processor>
<Identifier>
<Country>MX</Country>
<Entity>JES900109Q90</Entity>
<FiscalName>JIMENEZ ESTRADA SALAS A A</FiscalName>
<AYear>0</AYear>
<ANumber/>
<Batch>ABB</Batch>
<Serial>13820</Serial>
<DocumentGUID>becbb243-21e6-44b6-89f7-d2c9e546f3b3</DocumentGUID>
<IssuedTimeStamp>2026-09-11T02:25:07</IssuedTimeStamp>
<EnrolledTimeStamp>2026-09-11T02:25:08</EnrolledTimeStamp>
<PaidTimeStamp/>
<CancelledTimeStamp/>
<InternalID>1</InternalID>
<BatchID/>
<BatchTimeStamp/>
<BatchRequestorCountry/>
<BatchRequestorEntity/>
<BatchPosition/>
<ReceiverCountry>MX</ReceiverCountry>
<ReceiverEntity>XAXX010101000</ReceiverEntity>
<ReceiverTaxID/>
<ReceiverName>PUBLICO EN GENERAL</ReceiverName>
<ClaveAgente/>
<NumeroDePoliza/>
<Currency>MXN</Currency>
<TotalAmount>420.00</TotalAmount>
<Type1>ingreso</Type1>
<Type2>FACTURA</Type2>
<SuggestedFileName>JES900109Q90_ABB_13820_XAXX010101000</SuggestedFileName>
<SuggestedFileName2>11092026__1_ABB13820_</SuggestedFileName2>
</Identifier>
</Response>
<ResponseData>
<ResponseData1>PD94bWwgdmVyc2lvbj0iMS4wIiBlbmNvZGluZz0iVVRGLTgiPz48Q2FuY2VsYUNGRFJlc3VsdCBGZWNoYT0iMjAyNi0wOS0xNFQxMjoxNjozMS43NDgxMDkiIFJmY0VtaXNvcj0iSkVTOTAwMTA5UTkwIiB4bWxucz0iaHR0cDovL2NhbmNlbGFjZmQuc2F0LmdvYi5teCI+PEZvbGlvcz48VVVJRD5CRUNCQjI0My0yMUU2LTQ0QjYtODlGNy1EMkM5RTU0NkYzQjM8L1VVSUQ+PEVzdGF0dXNVVUlEPjIwMTwvRXN0YXR1c1VVSUQ+PC9Gb2xpb3M+PFNpZ25hdHVyZSBJZD0iU2VsbG9TQVQiIHhtbG5zPSJodHRwOi8vd3d3LnczLm9yZy8yMDAwLzA5L3htbGRzaWcjIj48U2lnbmVkSW5mbz48Q2Fub25pY2FsaXphdGlvbk1ldGhvZCBBbGdvcml0aG09Imh0dHA6Ly93d3cudzMub3JnL1RSLzIwMDEvUkVDLXhtbC1jMTRuLTIwMDEwMzE1IiAvPjxTaWduYXR1cmVNZXRob2QgQWxnb3JpdGhtPSJodHRwOi8vd3d3LnczLm9yZy8yMDAxLzA0L3htbGRzaWctbW9yZSNobWFjLXNoYTUxMiIgLz48UmVmZXJlbmNlIFVSST0iIj48VHJhbnNmb3Jtcz48VHJhbnNmb3JtIEFsZ29yaXRobT0iaHR0cDovL3d3dy53My5vcmcvVFIvMTk5OS9SRUMteHBhdGgtMTk5OTExMTYiPjxYUGF0aD5ub3QoYW5jZXN0b3Itb3Itc2VsZjo6Kltsb2NhbC1uYW1lKCk9J1NpZ25hdHVyZSddKTwvWFBhdGg+PC9UcmFuc2Zvcm0+PC9UcmFuc2Zvcm1zPjxEaWdlc3RNZXRob2QgQWxnb3JpdGhtPSJodHRwOi8vd3d3LnczLm9yZy8yMDAxLzA0L3htbGVuYyNzaGE1MTIiIC8+PERpZ2VzdFZhbHVlPllqNkNRakE0U3BRZlJLUktvbVAyNHlmelUweXMyQTNYWHIyemdRK0lrT3VZd0hvdUNVWEoyMDkzTDNqcUJZb2VmMUtqa0hPa2FaQjJ4WGRraktEL2hBPT08L0RpZ2VzdFZhbHVlPjwvUmVmZXJlbmNlPjwvU2lnbmVkSW5mbz48U2lnbmF0dXJlVmFsdWU+VUFpOW9kUkNMT1hKVE9Sbk90ajBQL3RRaGd5MVhlcWVEZFlSTlpvdytIQ0RvSjRvWXZoVDFRZUs5RWFvUTZidWVFcmNKSjRPMll2UU5lQUVtZWwvakE9PTwvU2lnbmF0dXJlVmFsdWU+PEtleUluZm8+PEtleU5hbWU+MzAwMDEwMDAwMDA1MDAwMDI1NTQ8L0tleU5hbWU+PEtleVZhbHVlPjxSU0FLZXlWYWx1ZT48TW9kdWx1cz5oVWNVT29HRXRTREFsckY4S2VnUWtHS1k4YURBZTl0TlJrZjQ4dWoxK1lpckRQNGNNRWQ4WUVlbFFZMWpMdTFHSU5ZS2Y5TjlYeG1PZkhkTDRGVXIrY3VPZ3JCdmlhR1djSXNKZlo4MElHcHZveDZrVVNIb1J0K2gzMnlRYXlXMEh1Tk9wMGIzeWlCcDlZNmpUZFlURlRBVnpnelVqZjRMZlZ0OG41RmVqVloyeEVSSXlST25HZ2JLOEE0eEJzUHBGYXpIUWtLMlBDaVllK0xZQm0wVXg5VVpZa1lKOU11OXJMNWM1MVNqZ3E4Skpla29ycDBCemZLYWRSclNFRnlEMlo2R3dCMFJzd2pMWlFzcG9qWkd4VW5xbGJsZHZPNlRqRlVWNE1UN0VWOFA3ZjJWVFMweXI0cVN3eDB5MDgwem9LMTBDYklvSlhmc0ZST0h5cEZqNXc9PTwvTW9kdWx1cz48RXhwb25lbnQ+QVFBQjwvRXhwb25lbnQ+PC9SU0FLZXlWYWx1ZT48L0tleVZhbHVlPjwvS2V5SW5mbz48L1NpZ25hdHVyZT48L0NhbmNlbGFDRkRSZXN1bHQ+</ResponseData1>
<ResponseData2>SAT: 201 - UUID Admitido al proceso de cancelación.</ResponseData2>
<ResponseData3/>
</ResponseData>
</RequestTransactionResult>
</RequestTransactionResponse>
</soapenv:Body>
</soapenv:Envelope>
La respuesta se organiza en tres bloques dentro de RequestTransactionResult.
| 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 y este la atendió. No confirma que el comprobante haya quedado cancelado |
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 | |
|
Identifier
|
Datos de identificación del comprobante recuperado. Ver desglose siguiente
|
|
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. Por ejemplo, un mensaje que indica que el UUID fue previamente admitido al proceso de cancelación. No viene en Base64. Valores: SAT: 201 - UUID Admitido al proceso de cancelación; SAT: 202 - Folio Fiscal Previamente Cancelado; SAT: 203 - Folio Fiscal No Correspondiente al Emisor; SAT: 204 - Folio Fiscal No Aplicable a Cancelación; SAT: 205 - Folio Fiscal No Existente; SAT: 206 - UUID no corresponde a un CFDI del Sector; SAT: 207 - No se especificó el motivo de cancelación o el motivo no es valido; SAT: 208 - Folio Sustitución invalido; SAT: 209 - Folio Sustitución no requerido; SAT: 210 - La fecha de solicitud de cancelación es mayor a la fecha de declaración; SAT: 211 - La fecha de solicitud de cancelación límite para factura global; SAT: 212 - Relación no valida o inexistente. | |
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.Identifier. A diferencia de las transacciones de búsqueda, esta transacción sí devuelve el nodo completo:| Elemento | Descripción |
|---|---|
| Country | Valor MX |
| Entity | RFC Emisor |
| FiscalName | Razón Social del Emisor |
| Batch | Serie asignado al comprobante |
| Serial | Folio asignado al comprobante |
| DocumentGUID | Folio Fiscal (UUID) del CFDI timbrado |
| IssuedTimeStamp | Fecha y hora de emisión del comprobante |
|
EnrolledTimeStamp
|
Fecha y hora de registro en MYSuite
|
| InternalID | NumeroInterno enviado en el XML Nativo |
| ReceiverCountry | Código de país (a dos caracteres), del Receptor |
| ReceiverEntity | RFC del Receptor |
| ReceiverTaxID | Identificador del Receptor (cuando es extranjero) |
ReceiverName |
Nombre del Receptor |
| Currency | Moneda del comprobante |
| TotalAmount | Monto Total del comprobante |
| Type1 | Tipo de comprobante SAT |
|
Type2
|
Tipo de comprobante MYSuite
|
| SuggestedFileName - SuggestedFileName2 | Nombres sugeridos para el resguardo de los archivos |
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, por ejemplo DOCUMENT_ON_CANCEL_PROCESS. |
Description |
Mensaje del error en lenguaje natural |
Hint |
Sugerencia de corrección |
Data |
Bloque de diagnóstico con la descripción. Es el dato a incluir al reportar la incidencia a Soporte |
Processor |
Servidor que atendió la solicitud. Es un dato a incluir al reportar 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)Llegan como texto con el prefijo SAT: seguido del código y su descripción.
| Aspecto | Valor |
|---|---|
| Comprobantes por llamada | Uno |
| Efectos | Presenta una solicitud de cancelación ante la autoridad fiscal. El desenlace puede no ser inmediato |
| Estados posibles del comprobante | Vigente · En proceso de cancelación · Cancelado. Se consultan con CONSULTAR_DOCUMENTO |
| Reintentos | Bloqueados por la plataforma mientras el documento esté en proceso: un segundo intento devuelve el código 3192 |
| Idempotencia | Protegida por el código 3192, que impide duplicar la solicitud. |
| Plazo para cancelar | Lo que determine la autoridad fiscal |
| Aceptación del receptor | Cancelable con Aceptación |
| Consumo de folios | No |
| Timeout | 60 segundos en servidor front |
ResponseData1 lo emite el SAT, no MYSuite. Conservarlo es responsabilidad del emisor.CANCELAR_RETENCION_SINGLE_MYSUITE_3.Problema. La transacción devolvió Result = true pero el comprobante no figura como cancelado.
Entorno. CFDI + Timbrado · SOAP · CANCEL_DOCUMENT_3.
Resolución. Consulta el estado real con CONSULTAR_DOCUMENTO. Según el tipo de comprobante, la cancelación puede requerir la aceptación del receptor y quedar en proceso hasta que él responda o venza el plazo. Registra el comprobante como cancelado en tu contabilidad solo cuando la consulta lo confirme.
Causa. Result = true confirma que la solicitud se presentó ante el SAT, no que la cancelación se haya consumado. Son dos momentos distintos del proceso.
Problema. La transacción responde Result = false con el código 3192.
Entorno. CFDI + Timbrado · SOAP · procesos con reintento automático, o cancelaciones solicitadas desde dos lugares.
Resolución. No reintentes. Ya existe una solicitud en curso para ese comprobante, y el elemento Data de la respuesta te indica la fecha en que ese proceso inició. Consulta el estado con CONSULTAR_DOCUMENTO y espera a que el proceso se resuelva.
Causa. La plataforma bloquea las solicitudes duplicadas mientras hay una cancelación en trámite. Es una protección, no una falla: evita que se acumulen solicitudes sobre el mismo comprobante.
Problema. La solicitud con motivo 01 no se acepta.
Entorno. CFDI + Timbrado · SOAP · cancelaciones por sustitución.
Resolución. El motivo 01 exige la entrada FolioSustitucion con el UUID del comprobante que sustituye al que se quiere cancelar, y ese comprobante debe estar timbrado antes de solicitar la cancelación. El orden es: primero emites el sustituto, después cancelas el original. Si aún no has emitido el sustituto, no puedes usar este motivo.
Causa. El flujo intuitivo es cancelar primero y volver a facturar después, pero el esquema vigente lo invierte para los casos con relación: el sustituto tiene que existir para poder declararlo.
Problema. Duda sobre cuál de las cuatro claves corresponde a la situación real.
Entorno. CFDI + Timbrado · SOAP · primera implementación del esquema vigente.
Resolución. Si vas a reemplazar la factura por otra, usa 01 y declara el sustituto. Si tiene errores y no vas a sustituirla, usa 02. Si la operación nunca ocurrió, usa 03. Si es una operación nominativa que ya quedó incluida en una factura global, usa 04. La elección es una declaración ante la autoridad, así que debe reflejar lo que efectivamente pasó, no lo que resulte más cómodo.
Causa. El motivo no existía antes de 2022 y no tiene equivalente en el esquema anterior, así que no hay un valor por omisión razonable que heredar.
Problema. La petición es rechazada al construir las estructuras de Data1 y Data2.
Entorno. CFDI + Timbrado · SOAP · integraciones nuevas.
Resolución. Son dos Dictionary con nombres distintos y entradas distintas, codificados en Base64 por separado: StoredXmlSelector en Data1 y CancelInfo en Data2. No los metas juntos en un mismo nodo ni reutilices el nombre de uno para el otro. Comprueba también que el Base64 de cada uno vaya en una sola línea.
Causa. Es la única transacción SOAP en la que se envían dos estructuras codificadas, y la simetría entre ambas induce a tratarlas como una sola.
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 que devolver: el motivo del rechazo está en Code, LastResult, Description, Hint y Data. El acuse solo existe cuando la solicitud se presentó.
Causa. El acuse es un documento que emite la autoridad, no la plataforma. Si la plataforma detuvo la solicitud antes de enviarla, no hay nada que la autoridad haya acusado.
Hasta 2021 cancelar era una operación sin justificación: bastaba con pedirlo. Desde el 1 de enero de 2022 la cancelación es una declaración: tienes que decir por qué cancelas y, si sustituyes el comprobante por otro, señalar cuál. Eso es lo que introduce el Dictionary CancelInfo, y es la razón de que exista una tercera versión de la transacción en lugar de un parámetro añadido a la anterior: el contrato cambió lo bastante como para justificar una transacción nueva.
Un comprobante puede estar en tres estados: vigente, en proceso de cancelación, o cancelado. Esta transacción mueve el comprobante del primero al segundo; quién lo mueve al tercero depende del caso. Cuando la cancelación requiere aceptación del receptor, el desenlace está en manos de un tercero y puede tardar. De ahí que CANCEL_DOCUMENT_3 y CONSULTAR_DOCUMENTO formen un par: una inicia, la otra confirma. Diseñar el ERP suponiendo que cancelar es un acto único y sincrónico produce contabilidades que no coinciden con la realidad fiscal.
Lo intuitivo sería cancelar la factura equivocada y luego emitir la correcta. Con el motivo 01 el orden es el inverso: el sustituto debe existir y estar timbrado antes, porque su UUID forma parte de la declaración de cancelación. Tiene lógica desde la perspectiva de la autoridad, que quiere la cadena de sustitución completa en el momento de recibir la solicitud, pero obliga a rediseñar el flujo del ERP si venía del esquema anterior.
Intervienen dos sistemas. MYSuite decide si tu solicitud es procesable —si el comprobante existe, si no hay otra cancelación en curso, si los datos son consistentes— 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 una respuesta. Mezclar ambos catálogos en la lógica del ERP lleva a interpretar mal en qué punto del proceso se detuvo la cancelación.
LastResult y no por DescriptionEl ejemplo publicado devuelve LastResult con el valor DOCUMENT_ON_CANCEL_PROCESS: un identificador simbólico, en inglés, sin espacios ni acentos, junto a una Description en lenguaje natural. Lo primero es apto para comparar en código y es razonable esperar que se mantenga estable; lo segundo está pensado para leerse y puede reescribirse sin previo aviso. Si tu ERP toma decisiones automáticas sobre el resultado, conviene que las tome sobre Code y LastResult, y que reserve Description y Hint para mostrárselos a la persona.
Data1 reutiliza la estructura de RETRIEVE_DOCUMENTIdentificar un comprobante almacenado es un problema que se repite en varias transacciones, y la plataforma lo resolvió con una estructura común: el Dictionary StoredXmlSelector. Recuperar y cancelar necesitan lo mismo —saber de qué documento hablamos— y lo que cambia es lo que se hace después. Es una de las pocas simetrías reales entre transacciones de SOAP, así que vale la pena aprovecharla e implementar esa estructura una sola vez.
El acuse de ResponseData1 lo emite el SAT y es la evidencia de que presentaste la solicitud. Conservarlo es parte de tu respaldo documental. Pero acusar la solicitud no es lo mismo que confirmar la cancelación: el acuse documenta un trámite iniciado, y el estado final sigue siendo algo que tienes que consultar.
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