Cancelación Retenciones

Servicio que permite la cancelación de comprobantes de Retenciones e Información de Pagos, con sus complementos, enviando un XML firmado o los certificados del emisor (CSD o PFX).

✓ Antes de empezar
1 Obtén un Bearer Token con tu usuario y contraseña de SW. Se recomienda usar un token infinito.
2 Si vas a cancelar por PFX y no tienes uno, usa nuestro Generador de Certificado PFX.
3 Revisa la tabla de motivos de cancelación abajo: el campo motivo es obligatorio en los 3 métodos, y folioSustitucion solo aplica con motivo = "01".
💡 Nota Importante: en ambiente de pruebas solo se pueden utilizar CSD de pruebas; en caso contrario, el servicio regresará un error. Encuéntralos aquí: certificados de prueba.

Valores válidos del campo motivo

Requerido en los métodos CSD y PFX. folioSustitucion solo se envía cuando motivo = "01"; para cualquier otro valor, se omite por completo.

Clave
Descripción
¿Requiere folioSustitucion?
01
Comprobante emitido con errores con relación
✅ Sí, obligatorio
02
Comprobante emitido con errores sin relación
❌ No enviarse
03
No se llevó a cabo la operación
❌ No enviarse
04
Operación nominativa relacionada en factura global
❌ No enviarse

URL´s

Marca tu ambiente activo. Los botones de copiar y los ejemplos de código de abajo se arman con la base que elijas aquí.

🔗 Endpoint

Los 3 métodos regresan la misma forma de respuesta — lo que cambia es cómo envías los datos de la cancelación.

POST
💡 Nota Importante: si desconoces la estructura del XML de cancelación, mira el siguiente video: ¿Cómo crear XML de Cancelación para CFDI y Retenciones? También puede ser útil la Herramienta para Firmar XML.

Ejemplo Request


        
💡 Nota: Estos ejemplos están basados en los SDK de SW, pero puedes armar la petición directamente contra la API REST en el lenguaje que prefieras.

Respuesta


        
💡 Nota: status: "success" confirma que la solicitud de cancelación se recibió correctamente — no que el comprobante ya quedó cancelado ante el SAT. Valida siempre el código de data.uuid (ver tabla de códigos abajo) para conocer lo que respondió la autoridad.

📋 Códigos de respuesta de folios de cancelación de retenciones

El campo data.uuid de una respuesta 200 regresa uno de estos códigos por cada folio enviado.

Código
Mensaje
1201
Solicitud de cancelación recibida.
1202
UUID Previamente cancelado.
1203
No encontrado corresponde al emisor.
1205
UUID No existe.
1300
Autenticación no válida.
1301
XML mal formado.
1302
Estructura de folio no válida.
1303
Estructura de RFC no válida.
1304
Estructura de fecha no válida.
1305
Certificado no corresponde al emisor.
1306
Certificado no vigente.
1307
Uso de e.firma no permitido.
1308
Certificado revocado o caduco.
1309
Firma mal formada o inválida.
Este método no recibe parámetros en path: toda la información va en el archivo XML.
Este método no recibe parámetros en path: toda la información va en el body.
Este método no recibe parámetros de en path: toda la información va en el body.

En SW® somos mejores para TI, es por ello que tu opinión es muy importante, por favor ayúdanos calificando este articulo y dejando tus comentarios.

How useful was this post?

Click on a star to rate it!

We are sorry that this post was not useful for you!

Let us improve this post!

Tell us how we can improve this post?

Updated on octubre 22, 2026

Related Articles