Este servicio ejecuta la cancelación de un documento electrónico aprobado específico teniendo como parámetro el valor de su CDC.
Sólo podrá cancelar los documentos que hayan sido emitidos y aprobados dentro del plazo máximo de 48 horas (2 días).
Si el Documento Electrónico es cancelado de forma satisfactoria se enviará un email al cliente, avisando del evento junto con el documento electrónico cancelado.
Obtener el CDC #
Es importante que se haya almacenado el CDC de cualquier documento electrónico generado en su sistema, para poder usarlo, por ejemplo en éste evento de cancelación.
Endpoint (URL) #
POST https://api.facturasend.com.py/<tenantId>/evento/cancelacion
Header (Encabezado) #
Requiere el envío del los siguientes atributos en el encabezado
Campo | Valor |
---|---|
Authorization | Bearer api_key_reemplazar_api_key |
Content-Type | application/json; charset=utf-8 |
Parámetros (BODY) #
{ "cdc": "01800695631001001038720612021112917595714694", "motivo": "Se digito erróneamente la dirección del cliente" }
Campo | Requerido | Valor |
---|---|---|
cdc | Si | El CDC del Documento Electrónico que desea cancelar |
motivo | Si | El motivo por el cual desea cancelar el documento |
Parámetros (Query Param) #
No posee
Ejemplo de llamadas #
# Cancela un Documento electronico emitido curl \ -X \ POST "https://api.facturasend.com.py/<tenantId>/evento/cancelacion" \ -H "Authorization: Bearer api_key_<reemplazar_api_key>" \ -H 'Content-Type: application/json; charset=utf-8' \ --data-raw '{ "cdc": "01800695631001001038720612021112917595714694", "motivo": "Se digito erroneamente la dirección del cliente" }'
# El ejemplo se muestra utilizando AXIOS import axios from 'axios'; const headers = { `Authorization` : `Bearer api_key_<reemplazar_api_key>` }; const data = { "cdc": "01800695631001001038720612021112917595714694", "motivo": "Se digito erróneamente la dirección del cliente" }; axios.post({ url: `https://api.facturasend.com.py/<tenantId>/evento/cancelacion`, method: 'POST', {headers} } ).then( respuesta => { console.log(respuesta); });
Respuesta de la Petición #
La respuesta de la petición será la siguiente:
{ "success" : true, "result" : { "ns2:rRetEnviEventoDe" : { "ns2:gResProcEVe" : "2022-02-08T14:39:00", "ns2:gResProcEVe" : { "ns2:dEstRes" : "Aprobado", "ns2:dProtAut": "974149", "ns2:gResProc" : { "ns2:dCodRes" : "0600", "ns2:dMsgRes" : "Evento registrado correctamente" } } } }, "cdc" : "01800695631001001038720612021112917595714694" }
Campo | Tipo | Valor |
---|---|---|
success | boolean | true si no hubo error en el servicio, false si ocurrió algún error. Para asegurar que el documento se haya procesado debe verificar que el campo “ns2:dEstRes” sea igual a “Aprobado” |
result | object | Objeto resultante de la operación del evento, directamente en el formato que devuelve el SIFEN |
Recomendaciones #
- No aplica
Validaciones #
- No aplica