---
title: Evento de Inutilización
description: Si se han salteado algunas numeraciones del timbrado electrónico y ya no se van a utilizar más esas numeraciones entonces se pueden inutilizar esos números salteados, para indicar a la DNIT que esos números de documentos ya son inválidos fiscalmente.…
url: "https://facturasend.com.py/documentacion/evento-de-inutilizacion/"
updated: "2025-06-03"
category: "3-API de FacturaSend"
---

# Evento de Inutilización

Si se han salteado algunas numeraciones del timbrado electrónico y ya no se van a utilizar más esas numeraciones entonces se pueden inutilizar esos números salteados, para indicar a la DNIT que esos números de documentos ya son inválidos fiscalmente.

Este servicio ejecuta la inutilización de uno o mas numeraciones del timbrado electrónico teniendo en cuenta el parámetro desde y hasta incluyendo los valores limites especificados.

No es necesario especificar el timbrado, pues esta información es extraída de Datos fiscales, de la Consola de Facturasend.

### Endpoint (URL)

**POST**https://api.facturasend.com.py/<tenantId>/evento/inutilizacion

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

```
{
  "tipoDocumento": 1,
  "establecimiento": `001`,
  "punto": `001`,
  "desde": 10,
  "hasta": 12,
  "motivo": `Se inutiliza la numeración por error de generación en software`
}
```

| Campo | Requerido | Valor |
| --- | --- | --- |
| **tipoDocumento** | **Si** | Número entero que representa el Tipo de Documento Electrónico del 1 al 7 |
| **establecimiento** | **Si** | String conteniendo el valor del establecimiento que corresponde a la numeración que desea inutilizar |
| **punto** | **Si** | String conteniendo el valor del punto que corresponde a la numeración que desea inutilizar |
| **desde** | **Si** | Número inicial a partir del cual se deben inutilizar la numeración |
| **hasta** | **Si** | Número final hasta el cual se deben inutilizar la numeración |
| serie | No | Valor de la Serie del rango de números que se desean inutilizar |
| **motivo** | **Si** | El motivo por el cual desea inutilizar el rango de numeraciones |

### Parámetros (Query Param)

No posee

### Ejemplo de llamadas

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

```
# Inutiliza un rango de números de documentos
curl 
  -X 
  POST "https://api.facturasend.com.py/<tenantId>/evento/inutilizacion" 
  -H "Authorization: Bearer api_key_<reemplazar_api_key>" 
  -H 'Content-Type: application/json; charset=utf-8' 
  --data-raw '{
        tipoDocumento: 1,
        establecimiento: `001`,
        punto: `001`,
        desde: 10,
        hasta: 12,
        motivo: `Se inutiliza la numeración por error de generacion en software`
    }'
```

```
# El ejemplo se muestra utilizando AXIOS
import axios from 'axios';

const headers = {
  `Authorization` : `Bearer api_key_<reemplazar_api_key>`,
  `Content-Type` : `application/json; charset=utf-8`
};

const data = {
        tipoDocumento: 1,
        establecimiento: `001`,
        punto: `001`,
        desde: 10,
        hasta: 12,
        motivo: `Se inutiliza la numeración por error de generacion en software`
};

axios.post({
  url: `https://api.facturasend.com.py/<tenantId>/evento/inutilizacion`,
  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:gResProc" : {
           "ns2:dCodRes" : "",
           "ns2:dMsgRes" : ""
        }
      }
    }
  }
}
```

| Campo | Tipo | Valor |
| --- | --- | --- |
| success | boolean | **true** si todo ocurrió bien y se inutilizaron las numeraciones del timbrado, **false** si ocurrió algún error |
| result | object | Objeto resultante de la operación del evento, directamente en el formato que devuelve el SIFEN |

### Recomendaciones

- No aplica

### Validaciones

- No aplica