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

Documentación método: cancelarAsincrono

Pruebas de cancelación de Web Services de timbrado

Recibe el UUID de un comprobante timbrado por Solución Factible® para procesar su cancelación y de forma asíncrona envía la solicitud al SAT hasta que ésta sea exitosa o bien se reciba un error fatal de parte del SAT que indique que por más reintentos que se realicen, el comprobante no se podrá cancelar (CSD que no corresponde al emisor, UUID que no aplica para cancelación, etc.).

Opcionalmente, se le puede enviar el CSD con el que se firmará la solicitud de cancelación. Si el contribuyente tiene certificados CSD asignados a su panel de timbrado y el usuario que cancelará tiene permiso para acceder a estos, entonces puede omitir los parámetros del CSD y se tomará el último CSD vigente registrado.

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.

SOAPAction: urn:cancelarAsincrono

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í
emailNotifica	xs:string La dirección de correo electrónico a donde se enviará la notificación una vez concluido el proceso. Más información	No
csdCer	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
csdKey	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
csdPassword	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.

Email de notificación

En caso de que se requiera automatizar el proceso, el mensaje de correo incluye unos headers que pueden ser de utilidad.

- Headers en un e-mail de notificación de cancelación exitosa.
X-SFService: Cancelar
X-UUIDCancelacion: 71452784-AFC7-4BE5-8623-3BA1436D573B
X-StatusCancelacion: OK


- Headers en un e-mail de notificación de cancelación fallida.
X-SFService: Cancelar
X-UUIDCancelacion: 71452784-AFC7-4BE5-8623-3BA1436D573B
X-StatusCancelacion: ERROR


Ejemplo de request con SOAP 1.2:

Descargar este ejemplo

Regresa:

Este método retorna un tipo compuesto: CancelacionAsincronoResponse, 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:

Descargar este ejemplo

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	La solicitud de cancelación se registró exitosamente.
306	Las llaves utilizadas para sellar no corresponden a un CSD.
308	El certificado CSD no fue emitido por la Autoridad de SAT.
305	La fecha de cancelación no está dentro del la vigencia del CSD del emisor.
303	El certificado CSD no corresponde al RFC del contribuyente.
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	Los datos recibidos no son válidos.
633	Uso indebido de cuenta de producción en pruebas o cuenta de prueba en producción.
701	Ya existe una transacción asíncrona para el UUID especificado.