Eventos SIFEN

Un evento SIFEN comunica una cancelación, una inutilización de numeración o la identificación del receptor de una factura innominada. Cada operación tiene sus propios requisitos.

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:

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

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

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 '{
    "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 para detalles.

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

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

Restricciones

• 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

Enviá POST /api/v1/documento-electronico/{cdc}/nominar con los datos del receptor. Seguí la guía de nominación y consultá los campos y las respuestas en la referencia del endpoint.

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.
• Nominar una factura innominada: guía paso a paso.
• Nota de Crédito: alternativa a la cancelación.