CANCEL_DOCUMENT_3 — SERVICIO CFDI + Timbrado (SOAP)

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


Warning
Result = true no significa que el CFDI quedó cancelado. Significa que la solicitud de cancelación se presentó ante el SAT. Según el tipo de comprobante, la cancelación puede requerir la aceptación del receptor y quedar en estado en proceso. Confirma siempre el estado final de cancelación con la transacción CONSULTAR_DOCUMENTO antes de darlo por cancelado en tu contabilidad.

Info
El motivo de cancelación es obligatorio, y si eliges el motivo 01 tienes que proporcionar el Folio Fiscal del comprobante que sustituye al cancelado. Ese sustituto debe estar timbrado 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...
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)


Requisitos previos

  • Credenciales de integración vigentes que te proporciona MYSuite: Requestor y Entity.
  • El Folio Fiscal (UUID) del comprobante a cancelar, el RFC del emisor y el año de emisión.
  • El motivo de cancelación decidido, conforme al catálogo del SAT.
  • Si el motivo es 01: el comprobante sustituto debe estar ya certificado, con su Folio Fiscal a la mano.


Cómo hacerlo


  1. Reúne los datos del comprobante a cancelar: Folio Fiscal, RFC del emisor y Año de emisión.
    Resultado: los criterios que identifican el documento.
  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. Emite primero el comprobante sustituto y toma su Folio Fiscal, solo si elegiste el motivo 01. El CFDI sustituto tiene que existir antes de la cancelación.
    Resultado: el UUID de sustitución listo para declararse.
  4. Construye el Dictionary StoredXmlSelector con las entradas Store, IssuerCountryCode, IssuerTaxId, DocumentGUID y Year.
    Resultado: el XML que identifica el comprobante a cancelar.
  5. Construye el Dictionary CancelInfo con las entradas Motivo y FolioSustitucion.
    Resultado: el XML con la información de la cancelación.
  6. Codifica cada estructura en Base64 por separado: la primera va en Data1 y la segunda en Data2.
    Resultado: dos cadenas Base64 independientes.
  7. Arma el sobre SOAP con las credenciales, Transaction con valor CANCEL_DOCUMENT_3, las dos cadenas en Data1 y Data2, Data3 vacío.
    Resultado: petición lista.
  8. Envía la petición al web service del ambiente que corresponda.
    Resultado: respuesta HTTP 200 con un sobre RequestTransactionResponse.
  9. Lee el elemento Result. Si es false, revisa Code, Description, Hint y Data, que traen el detalle del rechazo.
    Resultado: Result= true te permite continuar; Result = false te lleva a Solución de problemas.
  10. Lee ResponseData2 en texto plano para conocer el mensaje del SAT, y decodifica ResponseData1 desde Base64 para obtener el acuse. Conserva el acuse.
    Resultado: evidencia documental de la solicitud de cancelación.
  11. Confirma el estado final del comprobante con CONSULTAR_DOCUMENTO antes de registrarlo como cancelado en tu contabilidad.
    Resultado: certeza de si el CFDI quedó cancelado o si sigue en proceso.


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> CANCEL_DOCUMENT_3
Naturaleza Solicitud de cancelación de un CFDI ante la autoridad.


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


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


4. Parámetros de entrada

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
Es la única transacción SOAP que envía dos estructuras distintas codificadas en Base64, una en cada nodo (Data1 y Data2). Se codifican por separado, no juntas.


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

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


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


Data3

Sin estructura. Se envía vacío.


6. Ejemplo de request

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


7. Ejemplo de response

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


8. Estructura de respuesta — éxito

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

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


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

Llegan como texto con el prefijo SAT: seguido del código y su descripción.


11. Límites y comportamiento


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


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.
  • La cancelación de comprobantes de retenciones sigue una transacción distinta: CANCELAR_RETENCION_SINGLE_MYSUITE_3.
Solución de problemas

"Cancelé la factura y sigue apareciendo como vigente"


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.

"Me dice que el documento ya está en proceso de cancelación"


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.

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


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.

"No sé qué motivo de cancelación poner"


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.

"Mandé los dos Dictionary y me marca error de estructura"


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.

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


Para entender más

Qué cambió con el esquema de 2022

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.

Por qué cancelar no es instantáneo

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.

Por qué el motivo 01 invierte el orden natural

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.

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

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.

Por qué conviene ramificar por LastResult y no por Description

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

Por qué Data1 reutiliza la estructura de RETRIEVE_DOCUMENT

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

Qué es el acuse y qué no es

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.

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.


Más Transacciones Servicio CFDI + Timbrado (SOAP)

Emisión

Consulta y Recuperación

Validación y Recepción

CFDI de Retenciones

Esquema de cancelación