Envía la solicitud de cancelación de un comprobante por UUID, CSD o PFX y, a continuación, consulta su estatus ante el SAT; ambos resultados llegan en una sola respuesta.
✓
Antes de empezar
1
Obtén un Bearer Token con tu usuario y contraseña de SW. Se recomienda usar un token infinito.
2
Antes de cancelar, te recomendamos consultar los CFDI relacionados para que el proceso se lleve a cabo correctamente.
3
Si vas a cancelar por UUID, primero carga los CSD del emisor a tu cuenta. Si vas a usar PFX y no tienes uno, aquí vemos cómo crear un PFX. En pruebas puedes usar los certificados de prueba del SAT.
4
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".
5
Ten a la mano el
rfcReceptor y el total exactos del comprobante — este servicio los usa para consultar el estatus ante el SAT, además de cancelar.
🚨 Importante: si
rfcReceptor y/o total no corresponden exactamente al CFDI que estás cancelando, la cancelación se procesa de todas formas, pero la validación de estatus regresará el error No encontrado (consulta los valores posibles del estatus SAT más abajo).
💡 Nota Importante: este servicio no está recomendado para cancelaciones masivas ni para un alto volumen de cancelaciones. Para ese tipo de operación, usa Cancelación CFDI (sin estatus, mucho más ligero por petición), o Cancelación V2 CFDI si además quieres la descripción del código de folio.
Valores válidos del campo motivo
Requerido en los 3 métodos. 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 respuesta — lo que cambia es la información que envías.
Respuesta
💡 Nota importante:
data.statusSat es el que de verdad confirma lo que ocurrió ante el SAT. Un status: "success" solo indica que la solicitud se procesó — revisa siempre ese campo (y data.uuid, con el código del folio) antes de dar por cancelado un comprobante.
📋 Valores posibles de la consulta de estatus
Los campos statusSat, statusCodeSat, isCancelable y statusCancelation de data pueden regresar los siguientes valores.
Campo
Valores posibles
statusSat
VigenteCanceladostatusCodeSat
N 601 La expresión impresa proporcionada no es válida. Este código de respuesta se presentará cuando la petición de validación no se haya respetado en el formato definido.N 602 Comprobante no encontrado. Este código de respuesta se presentará cuando el UUID del comprobante no se encuentre en la Base de Datos del SAT.S Comprobante obtenido satisfactoriamente.isCancelable
Cancelable con aceptaciónCancelable sin aceptaciónNo cancelablestatusCancelation
nullEn procesoPlazo vencidoSolicitud rechazadaCancelado sin aceptaciónCancelado con aceptación📋 Códigos de respuesta de folios de cancelación
El campo data.uuid de una respuesta 200 regresa uno de estos códigos por cada folio enviado. Se muestran los 8 más comunes; hay 13 más abajo.
Código
Mensaje
Descripción
201
Solicitud de cancelación exitosa.
Se considera una solicitud de cancelación exitosa, sin embargo esto no asegura su cancelación.
202
Folio Fiscal Previamente Cancelado.
Se considera solicitud de cancelación previamente enviada. Estatus Cancelado ante el SAT.
203
Folio Fiscal No Correspondiente al Emisor.
El folio fiscal no corresponde al emisor de la solicitud de cancelación.
204
Folio Fiscal No Aplicable a Cancelación.
El folio fiscal no es válido para la cancelación.
205
Folio Fiscal No Existente.
El SAT da una prórroga de 48 hrs para que el comprobante aparezca Vigente tras el timbrado. Espera al menos 48 hrs.
206
UUID no corresponde a un CFDI del Sector Primario.
El UUID no corresponde a un CFDI del Sector Primario.
207
No se especificó el motivo o el motivo no es válido.
El UUID sustitución no existe, está cancelado, o tiene fecha de emisión anterior al original.
208
Folio Sustitución inválido.
El folio de sustitución es inválido.
209
Folio Sustitución no requerido.
El folio de sustitución no es necesario para este motivo.
210
Fecha de cancelación mayor a la de declaración.
La fecha de solicitud de cancelación es mayor a la fecha de declaración.
211
Límite de cancelación de factura global.
La fecha de solicitud supera el límite permitido para una factura global.
212
Relación no válida o inexistente.
La relación especificada no es válida o no existe.
300
Usuario No Válido.
El usuario que realizó la solicitud no es válido.
301
XML Mal Formado.
El request tiene información inválida, ej. un RFC de receptor no válido.
302
Sello Mal Formado.
La firma digital del acuse de cancelación es inválida o mal formada.
304
Certificado Revocado o Caduco.
El certificado es inválido por tipo, vigencia u otra razón.
305
Certificado Inválido.
El certificado es inválido por tipo, vigencia u otra razón.
309
Certificado Inválido.
El certificado es inválido por tipo, vigencia u otra razón.
310
CSD Inválido.
El Certificado de Sello Digital (CSD) es inválido.
311
Motivo inválido.
Clave de motivo de cancelación no válida.
312
UUID no relacionado.
UUID no relacionado de acuerdo a la clave de motivo de cancelación.
Este método no envía body: toda la información va en el path.
Este método no recibe parámetros eb path: toda la información va en el body.
Este método no recibe parámetros 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.