Solución Factible®:Integration Center [SF:IC]

Documentación método: cancelar

Recibe el UUID de un comprobante timbrado por Solución Factible® para procesar su cancelación enviando la solicitud al SAT.

El comprobante no se podrá cancelar si el CSD no corresponde al emisor, UUID que no aplica para cancelación, etc.

Pruebas de cancelación de Web Services de timbrado

Nota: se recomienda usar el método del Webservice de cancelación: cancelarAsincrono.

SOAPAction: urn:cancelar

Parámetros:

Nombre	Descripción	Requerido
usuario	xs:string Nombre del usuario registrado en el panel de timbrado.	Sí
password	xs:string Contraseña del usuario.	Sí
uuid	xs:string Cadena de cancelación que especifique el UUID que se quiere cancelar, la clave del motivo de cancelación y el UUID que sustituye al documento a cancelar en caso de aplicar. En el formato: UUID|Motivo|UuidSustitucion	Sí
rfcEmisor	xs:string El RFC del contribuyente.	Sí
derCertCSD	xs:base64Binary El Certificado CSD del contribuyente. 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, deberá codificar los bytes del archivo y enviarlo como String.	Condicional
derKeyCSD	xs:base64Binary Llave privada del CSD. Debe ser la misma con la 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, deberá codificar los bytes del archivo y enviarlo como String.	Condicional
contrasenaCSD	xs:string Contraseña de la llave privada del CSD.	Condicional
properties	KeyValue[] Lista de parámetros Llave-Valor disponibles para futuras versiones.	No

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.

Properties

Parámetros Llave-Valor
Actualmente este método no procesa ningún parámetro Llave-Valor.

Ejemplo de request con SOAP:

Regresa:

Este método retorna un tipo compuesto: CancelacionResponse, los atributos se describen en la siguiente tabla:

Nombre	Descripción	Requerido
status	xs:int El código status de la transacción. Códigos de respuesta de cancelación	Sí
mensaje	xs:string En caso de que haya un error, se devolverá la descripción del mismo. Si el código de respuesta es 200, entonces el mensaje nos dará el ID de la transacción, que generalmente será el mismo UUID que se envió a cancelar.	Sí

Ejemplo de respuesta:

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.