> ## Documentation Index
> Fetch the complete documentation index at: https://docs.cucu.bo/llms.txt
> Use this file to discover all available pages before exploring further.

# Anulación Administrativa (fuera de plazo)

> Registra una anulación fuera de plazo aprobada por Resolución Administrativa del SIN (RND 102600000025).

Registra la anulación de una factura **fuera del plazo** del servicio web (venció el día 9 del mes
siguiente a la emisión, o la factura ya fue usada en una Declaración Jurada).

Este procedimiento fue habilitado por la **RND 102600000025** (13/07/2026), que modifica el Art. 38 de la
RND 102100000011. La anulación fuera de plazo es un **trámite administrativo** ante la Gerencia Distrital o
GRACO: el contribuyente presenta la solicitud con documentación de respaldo y el SIN, si la aprueba, emite
una **Resolución Administrativa** (notificada por buzón tributario, en un plazo de hasta 6 meses) y ajusta
el estado del documento en su base.

<Warning>
  Este endpoint **no** llama al SIAT: el SIN ya aprobó y ajustó la anulación en su base. Sólo se usa
  **después** de recibir la Resolución Administrativa de Aprobación, para reflejar la anulación
  localmente. Para anular dentro de plazo use [Anular Factura](/api/cancel-invoice).
</Warning>

<Note>
  La factura queda en estado `CANCELLED` con `cancellationType: "ADMINISTRATIVE"` y el número de
  Resolución en `administrativeResolution`. Esta anulación **no es reversible por servicio web**
  ([Revertir Anulación](/api/revert-cancel) la rechaza); cualquier reversión se gestiona ante el SIN.
</Note>

## Path Parameters

| Parametro | Tipo   | Req | Descripcion                 |
| --------- | ------ | --- | --------------------------- |
| `id`      | string | Si  | UUID de la factura a anular |

## Body

| Campo                      | Tipo    | Req | Descripcion                                                                                                             |
| -------------------------- | ------- | --- | ----------------------------------------------------------------------------------------------------------------------- |
| `resolucionAdministrativa` | string  | Si  | Número de la Resolución Administrativa de Aprobación emitida por el SIN                                                 |
| `motivo`                   | integer | No  | Código del catálogo SIAT de motivos de anulación (ver [Catálogos](/api/catalogs), `cancellation-reasons`). Default: `1` |

## Headers

| Parametro   | Tipo   | Req | Descripcion |
| ----------- | ------ | --- | ----------- |
| `X-API-Key` | string | Si  | Tu API Key  |

<RequestExample>
  ```bash cURL theme={"system"}
  curl -X POST "https://sandbox.cucu.bo/api/v1/invoices/a1b2c3d4-e5f6-7890-abcd-ef1234567890/cancel-administrative" \
    -H "X-API-Key: YOUR_API_KEY" \
    -H "Content-Type: application/json" \
    -d '{ "resolucionAdministrativa": "Resolucion Administrativa N° 0001/2026", "motivo": 1 }'
  ```

  ```javascript JavaScript theme={"system"}
  const response = await fetch(
    'https://sandbox.cucu.bo/api/v1/invoices/a1b2c3d4-e5f6-7890-abcd-ef1234567890/cancel-administrative',
    {
      method: 'POST',
      headers: {
        'X-API-Key': 'YOUR_API_KEY',
        'Content-Type': 'application/json'
      },
      body: JSON.stringify({
        resolucionAdministrativa: 'Resolucion Administrativa N° 0001/2026',
        motivo: 1
      })
    }
  );
  const data = await response.json();
  ```

  ```python Python theme={"system"}
  import requests

  response = requests.post(
      'https://sandbox.cucu.bo/api/v1/invoices/a1b2c3d4-e5f6-7890-abcd-ef1234567890/cancel-administrative',
      headers={'X-API-Key': 'YOUR_API_KEY'},
      json={'resolucionAdministrativa': 'Resolucion Administrativa N° 0001/2026', 'motivo': 1}
  )
  print(response.json())
  ```
</RequestExample>

<ResponseExample>
  ```json 200 theme={"system"}
  {
    "success": true,
    "message": "Factura anulada administrativamente (fuera de plazo) exitosamente",
    "data": {
      "id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
      "invoiceNumber": 5,
      "cuf": "2872F7294502332E637FABFBC3654EA82202AD48E0969F14EBEB8AF74",
      "siatState": "CANCELLED",
      "cancellationType": "ADMINISTRATIVE",
      "administrativeResolution": "Resolucion Administrativa N° 0001/2026",
      "siatCodeState": 690
    },
    "timestamp": "2026-07-19T14:00:00"
  }
  ```

  ```json 400 theme={"system"}
  {
    "success": false,
    "error": {
      "code": "VALIDATION_ERROR",
      "details": "resolucionAdministrativa: El número de Resolución Administrativa de Aprobación del SIN es obligatorio"
    },
    "timestamp": "2026-07-19T14:00:00"
  }
  ```

  ```json 409 theme={"system"}
  {
    "success": false,
    "error": {
      "code": "CONFLICT",
      "details": "La factura ya está anulada"
    },
    "timestamp": "2026-07-19T14:00:00"
  }
  ```
</ResponseExample>