---
title: Evento de Cancelación
description: "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…"
url: "https://facturasend.com.py/documentacion/evento-de-cancelacion/"
updated: "2025-04-15"
category: "3-API de FacturaSend"
---

# Evento de Cancelación

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

- [shell](#tab-shell)
- [javascript](#tab-javascript)

```
# 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
