# Consultar Estado de un Documento (/docs/guias/consultar-estado)



El estado de un documento se consulta con `GET /api/v1/documento-electronico/status/{cdc}` y dice si SIFEN lo aprobó, lo rechazó o todavía lo está procesando.

Guardá el CDC que recibiste al emitir y consultalo con la misma clave o con otra del mismo contribuyente y ambiente:

```bash
curl "https://api.sifende.com.py/api/v1/documento-electronico/status/$CDC" \
  -H "Authorization: Bearer $SIFENDE_API_KEY"
```

## Respuesta [#respuesta]

```json
{
  "cdc": "01800123451001001000000122026042710000000006",
  "estado": "APROBADO",
  "ambiente": "DEV",
  "iTiDe": 1,
  "numeroDocumento": 1,
  "fechaCreacion": "2026-04-27T10:30:00",
  "protocoloAutorizacion": "01202604150000123456",
  "mensajeRechazo": null
}
```

| Campo                   | Tipo             | Descripción                                                                                  |
| ----------------------- | ---------------- | -------------------------------------------------------------------------------------------- |
| `cdc`                   | `string`         | Identificador de 44 dígitos del documento                                                    |
| `estado`                | `string`         | Estado de procesamiento                                                                      |
| `ambiente`              | `string`         | Ambiente en que se emitió el documento: `DEV`, `PROD` o `SANDBOX`. No cambia                 |
| `iTiDe`                 | `integer`        | Tipo de documento: 1 para FE, 5 para NCE, 6 para NDE y 7 para NRE                            |
| `numeroDocumento`       | `integer`        | Número correlativo del documento                                                             |
| `fechaCreacion`         | `datetime`       | Fecha y hora de creación, sin zona horaria                                                   |
| `protocoloAutorizacion` | `string \| null` | Protocolo de SIFEN en DEV/PROD; en SANDBOX, `SBX-` seguido del CDC                           |
| `mensajeRechazo`        | `string \| null` | Rechazos u observaciones, en formato `[código] mensaje`; varias entradas se separan por `\|` |

El número con formato `001-001-0000001` se obtiene de `numeroFormateado` en la respuesta de emisión.

En [SANDBOX](/docs/conceptos/ambientes#sandbox-de-sifende), la consulta puede pasar de `PENDIENTE` a `APROBADO` sin envío a SIFEN. El protocolo es `SBX-` seguido del CDC y no tiene validez fiscal. Los estados de envío y respuestas de SIFEN de esta tabla corresponden a DEV y PROD.

## Qué hacer con cada estado [#qué-hacer-con-cada-estado]

| Estado                 | Qué significa                                            | Qué hacer                                                          |
| ---------------------- | -------------------------------------------------------- | ------------------------------------------------------------------ |
| `PENDIENTE`            | Sifende recibió el documento y está preparando su envío  | Seguí consultando                                                  |
| `EN_LOTE`              | En proceso de envío o a la espera del resultado de SIFEN | Seguí consultando                                                  |
| `APROBADO`             | SIFEN aceptó el documento                                | Detené las consultas; guardá el protocolo                          |
| `APROBADO_OBSERVACION` | SIFEN aceptó el documento con observaciones              | Detené las consultas y revisá `mensajeRechazo`; no lo reemitas     |
| `RECHAZADO`            | SIFEN rechazó el documento                               | Detené las consultas y corregí el motivo antes de emitir uno nuevo |
| `CANCELADO`            | Se confirmó la cancelación de un documento aprobado      | Detené las consultas                                               |
| `ERROR`                | El envío falló de forma definitiva                       | Detené las consultas y revisá el panel; no lo reemitas             |

Si después de varias horas sigue en `EN_LOTE`, puede pertenecer a un lote **Fallido**. Revisá **Historial de Lotes** en el detalle del documento y, si el lote está **Fallido**, seguí la [guía de reintento](/docs/panel/lotes). Conservá el mismo CDC.

En `ERROR`, el documento no se reintenta solo. Pedí el reintento a [soporte](/docs/solucion-problemas/soporte) o seguí la [guía para reintentar el lote](/docs/panel/lotes). Al reintentarlo vuelve a `EN_LOTE` y podés retomar las consultas con el mismo CDC.

## Automatizar la consulta [#automatizar-la-consulta]

Consultá cada **5 segundos** durante un máximo de **5 minutos**. Si sigue en proceso, guardá el CDC y retomá después. No reemitas por haber agotado el tiempo de espera.

La guía de [Polling de resultados](/docs/guias/polling-resultados) incluye un ejemplo completo en TypeScript. También podés recibir [webhooks](/docs/referencia/webhooks).

## Rechazos y observaciones [#rechazos-y-observaciones]

`mensajeRechazo` contiene el código y el mensaje de SIFEN. En un documento `RECHAZADO`, corregí la causa y [emití uno nuevo](/docs/guias/reintentar-rechazados). Si está `APROBADO_OBSERVACION`, guardá la observación: el documento ya quedó aceptado y no hay que reemitirlo.
