# Eventos SIFEN (/docs/conceptos/eventos-sifen)



Un **evento SIFEN** registra un hecho sobre un documento ya emitido o sobre la numeración, sin emitir un documento nuevo. Desde Sifende podés enviar tres: cancelación de un documento aprobado (en una FE, hasta 48 horas después), inutilización de numeración y nominación de una factura innominada.

Los eventos del emisor están en la sección 11.1 del [Manual Técnico V150](https://www.dnit.gov.py/web/e-kuatia/documentacion-tecnica), sus plazos en la sección 6.2.1 y la nominación en la Nota Técnica 14.

## Qué es un evento [#qué-es-un-evento]

A diferencia de un documento electrónico (que declara una operación comercial), un evento comunica un acontecimiento sobre un documento o numeración. Cada evento recibe su propio resultado de SIFEN.

Podés enviar estos eventos:

| Evento        | Qué hace                                         | Documento afectado         |
| ------------- | ------------------------------------------------ | -------------------------- |
| Cancelación   | Anula un DE ya aprobado                          | Un DE específico (por CDC) |
| Inutilización | Marca un rango de numeración como no utilizable  | Un rango (sin CDC)         |
| Nominación    | Identifica al receptor de una factura innominada | Una factura aprobada       |

El evento de actualización de datos del transporte no se admite.

## Cancelación de documento [#cancelación-de-documento]

Anula un documento que ya fue aprobado por SIFEN. Una vez cancelado, el documento queda registrado en SIFEN pero sin valor fiscal: como si nunca se hubiera emitido para fines tributarios.

### Cuándo usarlo [#cuándo-usarlo]

* Emitiste una FE con datos incorrectos y ya está aprobada.
* El cliente devolvió la mercadería antes de tomar posesión y querés anular en lugar de emitir una NCE.
* Detectaste un duplicado emitido por error.

### Restricciones [#restricciones]

* El documento tiene que estar `APROBADO` o `APROBADO_OBSERVACION`. No podés cancelar uno en `RECHAZADO` o `PENDIENTE`.
* Plazo: 48 horas desde la aprobación para FE y 168 horas para NCE, NDE y NRE. Para ajustar una factura fuera de plazo, evaluá emitir una NCE.
* El timbrado tiene que estar vigente al momento de enviar la cancelación.
* Es irreversible: un documento cancelado no se puede "descancelar".

### Cómo emitirla [#cómo-emitirla]

```bash
curl -X POST https://api.sifende.com.py/api/v1/documento-electronico/:cdc/cancelar \
  -H "Authorization: Bearer sk_live_..." \
  -H "Content-Type: application/json" \
  -d '{ "motivo": "Documento emitido con datos incorrectos del receptor" }'
```

El motivo es un texto libre de 5 a 500 caracteres que se registra ante SIFEN.

Ver [Cancelar Documento](/docs/referencia/documentos-electronicos/cancelar) para detalles.

## Inutilización de numeración [#inutilización-de-numeración]

Marca un rango de números no utilizados dentro de un timbrado como inutilizables. Sirve para documentar saltos de numeración que de otra forma quedarían como huecos en la secuencia ante SIFEN.

### Cuándo usarlo [#cuándo-usarlo-1]

* Tu sistema reservó un número pero falló antes de emitir el documento.
* Un cambio de software dejó números sin asignar.
* Detectaste un hueco en la secuencia y necesitás cerrarlo formalmente.

### Restricciones [#restricciones-1]

* Solo aplica a números nunca emitidos. No podés inutilizar un número que ya tiene un CDC en SIFEN.
* El rango tiene que pertenecer a un mismo establecimiento + punto de expedición + tipo de documento.
* El timbrado tiene que estar vigente al enviar la inutilización.
* Es irreversible: los números inutilizados no se pueden reutilizar.

### Cómo emitirla [#cómo-emitirla-1]

```bash
curl -X POST https://api.sifende.com.py/api/v1/documento-electronico/inutilizar \
  -H "Authorization: Bearer sk_live_..." \
  -H "Content-Type: application/json" \
  -d '{
    "numeroTimbrado": 12557896,
    "establecimiento": "001",
    "puntoExpedicion": "001",
    "numeroInicio": "0000025",
    "numeroFin": "0000030",
    "tipoDocumento": 1,
    "motivo": "Números no utilizados por error de sistema"
  }'
```

Ver [Inutilizar Numeración](/docs/referencia/documentos-electronicos/inutilizar) para detalles.

## Nominación [#nominación]

Identifica al receptor de una factura que se emitió como innominada. La nominación tiene su propio resultado; el CDC, el XML y el KuDE originales de la factura se conservan.

### Cuándo usarla [#cuándo-usarla]

Cuando necesitás registrar un receptor identificado para una factura emitida con receptor innominado.

### Restricciones [#restricciones-2]

* Sólo aplica a facturas electrónicas en estado `APROBADO` o `APROBADO_OBSERVACION`.
* El receptor original debe ser `NO_CONTRIBUYENTE`, con `tipoDocumento: "INNOMINADO"` y `numeroDocumento: "0"`.
* No está disponible en `SANDBOX`: la API responde **422**.

### Cómo emitirla [#cómo-emitirla-2]

Enviá `POST /api/v1/documento-electronico/{cdc}/nominar` con los datos del receptor. Seguí la [guía de nominación](/docs/guias/nominar-factura) y consultá los campos y las respuestas en la [referencia del endpoint](/docs/referencia/documentos-electronicos/nominar).

## Diferencias entre eventos y NCE/NDE [#diferencias-entre-eventos-y-ncende]

Hay una superposición conceptual entre cancelar un DE y emitir una nota de crédito. La diferencia:

| Aspecto           | Cancelación (evento)                            | Nota de Crédito (NCE)                    |
| ----------------- | ----------------------------------------------- | ---------------------------------------- |
| Tipo de operación | Evento SIFEN                                    | Documento electrónico                    |
| Plazo             | 48 h desde aprobación (FE); 168 h (NCE/NDE/NRE) | Sin límite estricto                      |
| Efecto contable   | Documento "no existe" fiscalmente               | Documento existe + reverso parcial/total |
| Receptor          | Cualquier tipo (incluso innominado)             | Receptor identificado (no innominado)    |
| Cuándo elegirla   | Errores tempranos, duplicados                   | Devoluciones, descuentos posteriores     |

Como regla práctica:

* Si todavía estás en plazo y el cliente no recibió el comprobante, cancelá.
* Si el cliente ya pagó o recibió el comprobante, emitís una NCE.

## Listado de eventos emitidos [#listado-de-eventos-emitidos]

Podés consultar el historial de eventos enviados a SIFEN:

```bash
curl https://api.sifende.com.py/api/v1/documento-electronico/eventos \
  -H "Authorization: Bearer sk_live_..."
```

Ver [Listar Eventos](/docs/referencia/eventos/listar) para los parámetros de búsqueda.

## Próximos pasos [#próximos-pasos]

* [Cancelar Documento](/docs/guias/cancelar-documento): guía paso a paso.
* [Inutilizar Numeración](/docs/guias/inutilizar-numeracion): guía paso a paso.
* [Nominar una factura innominada](/docs/guias/nominar-factura): guía paso a paso.
* [Nota de Crédito](/docs/guias/nota-credito): alternativa a la cancelación.
