2.2.1.3. Timbrado.cancelar Doc
English versionCancela uno o varios CFDI.
Pruebas de cancelación de Web Services de timbrado
Si usted prefiere evitar mandar los certificados (archivos .cer y .key) puede invocar método: enviarSolicitudCancelacion que recibe la solicitud de cancelación ya generada y firmada.
A partir del 1 de enero de 2022, todas las solicitudes de cancelación deberán contener el motivo de cancelación del CFDI. En el caso de que el motivo de cancelación sea "01 - Comprobante emitido con errores con relación" se deberá especificar el UUID del comprobante que sustituye al comprobante a cancelar.
Con la finalidad de no cambiar el contrato de datos SOAP y evitar problemas de compatibilidad con los servicios implementados por nuestros clientes, en los servicios de cancelación de Solución Factible será posible incluir una cadena de cancelación en lugar del UUID, en la cual se incluya el UUID a cancelar, motivo de cancelación y el UUD relacionado que sustituye al comprobante a cancelar.
Para más detalles consulte el catálogo de Motivos de cancelación permitidos.
- Parámetros:
-
Nombre Descripción Requerido usuario Nombre de usuario registrado para el uso del Webservice. Si password Contraseña del usuario. Sí uuids Cadena de cancelación que especifique el UUID del CFDI a cancelar, la clave del motivo de cancelación y el UUID que sustituye al documento a cancelar. En el formato: UUID|Motivo|UuidSustitucion
Sí derCertCSD CSD a utilizar para la codificación de la solicitud de cancelación, debe ser el mismo con el que se generó el sello digital del CFDI. Se espera que los contenidos de este parámetro estén codificados en base64, usualmente las librerías que consumen webservices hacen este paso por si solas, si no es el caso, favor de codificarlo antes de enviarlo. Sí derKeyCSD Llave privada del CSD, debe ser la misma con la se generó el sello digital del CFDI. Se espera que los contenidos de este parametro estén codificados en base64, usualmente las librerias que consumen webservices hacen este paso por si solas, si no es el caso, favor de codificarlo antes de enviarlo. Sí contrasenaCSD Contraseña de la llave privada del CSD con el que se generó el sello digital del CFDI. Sí Motivos de cancelación:
-
Clave Descripción 01 Comprobante emitido con errores con relación. 02 Comprobante emitido con errores sin relación. 03 No se llevó a cabo la operación. 04 Operación nominativa relacionada en una factura global. Cuando se seleccione la clave 01, se deberá habilitar un campo adicional para registrar el folio fiscal que sustituye al comprobante.
Ejemplo de request:
Descargar este ejemplo
Regresa:
- Este método retorna un tipo compuesto: CFDICancelacion, los atributos se describen en la siguiente tabla
-
Nombre Descripción Requerido status El código status de la operación. Códigos de respuesta de cancelación. Sí mensaje El mensaje de respuesta, una cadena de caracteres detallando el status de la operación. Sí resultados Un array de CFDIResultadoCancelacion. Atributos se detallan en la tabla CFDIResultadoCancelacion. No
- Atributos de CFDIResultadoCancelacion
-
Nombre Descripción Requerido status Status del resultado de la cancelación del CFDI, para detalles de los códigos de status de cancelación consulte “Códigos de status de cancelación de CFDI”. Sí mensaje Mensaje detallado de la operación realizada o descripción del error. Sí uuid Folio fiscal del CFDI que se canceló. Sí statusUUID Status de respuesta del SAT para el comprobante que se envió a cancelación, para detalles de los códigos de status de cancelación consulte “Códigos de respuesta del SAT para la cancelación de CFDI”. Condicional
Ejemplo de response:
Descargar este ejemplo
Nota: Si usted requiere en la respuesta del WebServices el acuse de cancelación en Soap XML consulte el WS: Cancelar
Códigos de respuesta de cancelación:
Código de respuesta de la validación de la solicitud de cancelación previo al envio de la solicitud al servicio del SAT
-
Código Mensaje 200 El proceso de cancelación se ha completado correctamente. 211 La solicitud de cancelación del CFDI con folio fiscal XXXXXXXXXX se encuentra en proceso. 500 Han ocurrido errores internos que han impedido que se registre la solicitud de cancelación, reintentar. 501 Ha ocurrido un error interno de comunicación con la base de datos, reintentar. 601 Error de autenticación,el nombre de usuario o contraseña son incorrectos. 602 La cuenta de usuario se encuentra bloqueada. 603 La contraseña de la cuenta ha expirado. 604 Se ha superado el número máximo permitido de intentos fallidos de autenticación. 605 El usuario se encuentra inactivo 611 Los datos recibidos están incompletos o no se encuentran donde se esperarían. 620 Permiso denegado. 621 Formato o estructura de argumento no válida para el tipo de dato. 630 La implementación no tiene folios disponibles. 631 La cuenta del usuario no tiene timbres disponibles. 633 Uso indebido de cuenta de producción en pruebas o cuenta de prueba en producción. 640 Aplicación inactiva. 1701 La llave privada y la llave pública del CSD no corresponden. 1702 La llave privada de la contraseña es incorrecta. 1703 La llave privada no cumple con la estructura esperada. 1704 La llave Privada no es una llave RSA. 1710 La estructura del certificado no cumple con la estructura X509 esperada. 1711 El certificado no esá vigente todavía. 1712 El certificado ha expirado. 1713 La llave pública contenida en el certificado no es una llave RSA.
Códigos de estatus de solicitud cancelación del SAT:
Corresponden con el CodEstatus en la respuesta del servicio de cancelación del SAT
-
Código Mensaje CodEstatus de Cancelación de CFDI 300 Usuario No Válido. 301 XML Mal Formado. 302 Sello Mal Formado. 304 Certificado Revocado o Caduco. 305 Certificado Inválido. 310 CSD Inválido. CodEstatus de cancelación de CFDI de Retenciones 1300 Autenticación no válida. 1301 XML mal formado. 1302 Estructura de folios 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 FIEL no permitido. 1308 Certificado revocado o caduco. 1309 Firma mal formada o inválida. 1313 Solicitud fuera de la declaración anual. 1314 Relación no valida.
Códigos de estatus UUID del SAT:
Correspondiente con el estatus de cada UUID del que se ha solicitado la cancelación, devuelto por el servicio de cancelación del SAT
-
Código Mensaje 201 Solicitud de cancelación recibida. 202 Folio Fiscal Previamente Cancelado 203 Folio Fiscal No Correspondiente al Emisor. 204 Folio Fiscal No Aplicable a Cancelación. 205 Folio Fiscal No Existente. 206 UUID no corresponde a un CFDI del Sector Primario. 207 Folio sustitución Inválido. 208 La Fecha de Solicitud de Cancelación es mayor a la fecha de declaración. 209 La Fecha de Solicitud de Cancelación límite para factura global. 310 CSD Inválido. 311 Clave de motivo de cancelación no válida. 312 UUID no relacionado de acuerdo a la clave de motivo de cancelación. Estatus UUID de cancelación de CFDI de Retenciones 1201 Solicitud de cancelación recibida. 1202 UUID Previamente cancelado 1203 UUID no corresponde con el emisor 1205 UUID No existe
Nota: Sólo se puede tener certeza de que un CFDI fue cancelado cuando el statusUUID es 202 (El CFDI ya había sido cancelado previamente).