2.2.1.3. Timbrado.cancelar Doc
Nota: se recomienda usar el método del WebServide de cancelación: cancelarAsincrono
Cancela uno o varios CFDI.
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.
- Parametros:
-
Nombre Descripción Requerido usuario Nombre de usuario registrado para el uso del Web Service Si password Contraseña del usuario Sí uuids Arreglo de Strings con los folios fiscales (UUIDs) de los CFDI a certificar. 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í
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
Códigos de respuesta
Cancelación:
- 200 - El proceso de cancelación se ha completado correctamente.
- 500 - Han ocurrido errores que no han permitido completar el proceso de cancelación.
- 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 - No se han proporcionado UUIDs a cancelar.
- 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.
- 1803 - El dato no es un UUID válido.
Códigos de status de cancelación de CFDI:
- 200 - El proceso de cancelación se ha completado correctamente.
- 500 - Han ocurrido errores que no han permitido completar el proceso de cancelación.
Códigos de respuesta del SAT para la cancelación de CFDI:
- 201 - El folio se ha cancelado con éxito.
- 202 - El CFDI ya había sido cancelado previamente.
- 203 - UUID no corresponde al emisor.
- 204 - El CFDI no aplica para cancelación.
- 205 - El UUID no existe o no ha sido procesado por el SAT.
- 402 - El Contribuyente no se encuentra el la LCO o la validez de obligaciones se reporta como negativa.
Nota: Sólo se puede tener certeza de que un CFDI fue cancelado cuando el statusUUID es 201 (Se ha cancelado el CFDI) o 202 (El CFDI ya había sido cancelado previamente).