Factura Electronica | WebServices de Cancelación

Inicio | Timbrado | 2.2. WebServices | 2.2.1. WS Cancelación | 2.2.1.3. Cancelacion.cancelarAsincrono

Documentación método: cancelarAsincrono

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.

SOAPAction: urn:cancelarAsincrono

Parametros:

Nombre	Descripción	Requerido
usuario	`xs:string` Nombre del usuario registrado en el panel de timbrado.	Si
password	`xs:string` Contraseña del usuario	Sí
uuid	`xs:string` El UUID que se quiere cancelar.	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
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.	No
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.	No
contrasenaCSD	`xs:string` Contraseña de la llave privada del CSD.	No
properties	`KeyValue[]` Lista de parámetros Llave-Valor disponibles para futuras versiones	No

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-StatusCancelacion: ERROR

                        X-UUIDCancelacion: 71452784-AFC7-4BE5-8623-3BA1436D573B

                        X-SFService: Cancelar

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: