Ciclo de Vida de un Documento

Qué pasa después de emitir un documento — los estados por los que pasa hasta su aprobación o rechazo por SIFEN.

Cuando emitís un documento electrónico no se aprueba al instante. Pasa por varios estados mientras Sifende lo construye, lo firma, lo asocia a un lote, lo envía a SIFEN y consulta el resultado. Entender estos estados es clave para integrar bien.

Estados del documento

Estado	Descripción
`PENDIENTE`	Sifende recibió el request y armó el DE; aún no fue asociado a un lote
`EN_LOTE`	El DE está dentro de un lote `PREPARADO` o `INTENTANDO` esperando ser transmitido a SIFEN
`ENVIADO`	El lote ya se transmitió a SIFEN; Sifende está consultando el resultado por `siResultLoteDE`
`APROBADO`	SIFEN validó el documento. Es legalmente válido y aparece en e-kuatia
`RECHAZADO`	SIFEN rechazó el documento por error de validación (terminal, no se reintenta)
`ERROR`	Falló el procesamiento interno (firma, transmisión, conectividad). Sifende reintenta solo
`CANCELADO`	Documento previamente `APROBADO` que fue anulado por evento de cancelación posterior (terminal)
`DESCONOCIDO`	Estado de borde: el lote agotó reintentos sin respuesta concluyente de SIFEN (terminal, requiere intervención manual)

Diagrama de transiciones

                  ┌─────────────┐
   POST DE  ────► │  PENDIENTE  │
                  └──────┬──────┘
                         │ Worker asocia el DE a un lote
                         ▼
                  ┌─────────────┐
                  │   EN_LOTE   │
                  └──────┬──────┘
                         │ El lote se firma y se transmite
                         │ a SIFEN (siRecepLoteDE)
                         ▼
                  ┌─────────────┐
                  │   ENVIADO   │
                  └──────┬──────┘
                         │ Scheduler consulta resultado
                         │ del lote (siResultLoteDE, cada 60s)
                         ▼
              ┌──────────┼──────────┐
              ▼          ▼          ▼
       ┌───────────┐ ┌───────────┐ ┌───────────┐
       │ APROBADO  │ │ RECHAZADO │ │   ERROR   │
       └─────┬─────┘ └───────────┘ └─────┬─────┘
             │       (terminal)          │ Reintento automático
             │ Evento de                 │ del lote (vuelve
             │ cancelación               │ a EN_LOTE/ENVIADO);
             │ dentro del plazo          │ si agota reintentos:
             ▼                           ▼
       ┌───────────┐               ┌──────────────┐
       │ CANCELADO │               │ DESCONOCIDO  │
       └───────────┘               └──────────────┘
       (terminal)                  (terminal)

Tiempos típicos

PENDIENTE → EN_LOTE: pocos segundos. El worker agrupa el DE en un lote casi al toque.
EN_LOTE → ENVIADO: pocos segundos más, una vez que el lote se firma y SIFEN responde con el idLote.
ENVIADO → APROBADO/RECHAZADO: 1 a 5 minutos en condiciones normales. En horarios pico puede llegar a 1–24 horas (SIFEN no garantiza tiempos de respuesta).
ERROR: si la falla es transitoria (red, timeout SIFEN), el lote se reintenta con backoff exponencial. Eventualmente termina en APROBADO, RECHAZADO o DESCONOCIDO.

Sifende retorna el CDC al instante cuando recibe el POST, incluso en estado PENDIENTE. No hace falta esperar la aprobación para guardarlo y mostrarlo al usuario.

Cómo consultar el estado

Tres maneras:

Polling activo: consultá GET /api/v1/documento-electronico/status/:cdc cada 30–60 segundos hasta obtener APROBADO, RECHAZADO o ERROR.

Webhook (próximamente): Sifende notifica a tu URL cuando cambia el estado.

Panel web: la lista de documentos muestra el estado actualizado en tiempo real.

Ver Guía: Consultar Estado para la estrategia de polling recomendada.

Qué hacer en cada estado

`PENDIENTE`, `EN_LOTE` o `ENVIADO`

Mostrale al usuario "Procesando…".
Guardá el CDC en tu base de datos.
Esperá la confirmación antes de imprimir o entregar el KuDE al cliente.

`APROBADO`

El documento es legalmente válido.
Podés descargar el KuDE (PDF para el cliente).
Aparece en e-kuatia y el receptor lo puede consultar.

`RECHAZADO`

El documento es inválido y SIFEN no lo aceptó. No se puede recuperar.
Sifende devuelve los códigos de error de SIFEN. Ver Rechazos SIFEN.
Corregí los datos y emití un documento nuevo (con número y CDC nuevos).

`ERROR`

Distinto de RECHAZADO: indica un problema interno (firma, transmisión, conectividad), no una validación fallida de SIFEN.
Sifende reintenta solo los lotes que terminan en ERROR. No hace falta reemitir el documento.
Si después de varios reintentos el lote no avanza, contactá a soporte.

`CANCELADO`

El documento fue anulado por un evento posterior.
Estado terminal. No se puede revertir.
Para emitir uno en su reemplazo, generá un documento nuevo (con número nuevo).

`DESCONOCIDO`

Estado de borde: el lote agotó los reintentos sin respuesta concluyente de SIFEN (por ejemplo, SIFEN devolvió 0364 — consulta extemporánea después de 48h).
Requiere intervención manual: hay que consultar el documento individualmente por CDC y, si aparece en SIFEN, reconciliar el estado.

Un documento en RECHAZADO no puede pasar a APROBADO. Si SIFEN lo rechazó, hay que emitir uno nuevo con los datos corregidos.

Cancelación posterior

Un documento APROBADO puede pasar a CANCELADO si emitís un evento de cancelación dentro del plazo permitido por SIFEN (típicamente 48 horas). Ver Eventos SIFEN.

Estados del lote vs estados del documento

El documento vive dentro de un lote, que también tiene su propio ciclo. Mientras el lote está PREPARADO o INTENTANDO, los DE adentro están en EN_LOTE. Cuando el lote pasa a ENVIADO, los DE pasan a ENVIADO. Cuando el lote se procesa (PROCESADO), cada DE recibe individualmente su veredicto: APROBADO o RECHAZADO. Ver Lotes.

Próximos pasos

Lotes: cómo se agrupan los documentos para SIFEN.
Consultar Estado: estrategia de polling.
Manejar Errores: qué hacer cuando algo falla.

Ciclo de Vida de un Documento

On this page