Eventos SIFEN

Un evento SIFEN es una notificación oficial que tu sistema envía a SIFEN sobre un documento ya emitido, para informar un cambio de estado posterior. Los eventos son la única forma legal de "modificar" la realidad fiscal después de la aprobación: anular un documento ya aprobado o saltar un rango de numeración no usado.

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. Los eventos viajan por un web service distinto (siRecepEvento) y reciben su propio veredicto de SIFEN.

Sifende soporta dos tipos de eventos:

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

• 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

• El documento tiene que estar APROBADO. No podés cancelar uno en RECHAZADO o PENDIENTE.
• Plazo: 48 horas desde la fecha de emisión (según SIFEN). Pasado ese plazo hay que emitir una NCE en su lugar.
• 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

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 para detalles.

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

• 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

• 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

curl -X POST https://api.sifende.com.py/api/v1/documento-electronico/inutilizar \
  -H "Authorization: Bearer sk_live_..." \
  -H "Content-Type: application/json" \
  -d '{
    "tipoDocumento": "FACTURA_ELECTRONICA",
    "numeroEstablecimiento": 1,
    "puntoExpedicion": 1,
    "numeroInicio": 25,
    "numeroFin": 30,
    "motivo": "Pérdida de numeración por falla del sistema"
  }'

Ver Inutilizar Numeración para detalles.

Diferencias entre eventos y NCE/NDE

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

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

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

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

Ver Listar Eventos para los parámetros de búsqueda.

Próximos pasos

• Cancelar Documento: guía paso a paso.
• Inutilizar Numeración: guía paso a paso.
• Nota de Crédito: alternativa a la cancelación.