# Consultar Estado (/docs/referencia/documentos-electronicos/consultar-estado)



## GET /api/v1/documento-electronico/status/:cdc [#get-apiv1documento-electronicostatuscdc]

Consultá el documento con su CDC de 44 dígitos y una API key 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 exitosa [#respuesta-exitosa]

**Status:** `200 OK`

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

`numeroDocumento` es un número. El valor con formato `001-001-0000001` está en `numeroFormateado`, que devuelve 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.

## Estados posibles [#estados-posibles]

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

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.

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.

## Errores [#errores]

| Status | Tipo                                                                                          | Qué significa                                  |
| ------ | --------------------------------------------------------------------------------------------- | ---------------------------------------------- |
| 401    | —                                                                                             | API key ausente o inválida                     |
| 403    | [`document-archived`](/docs/solucion-problemas/document-archived)                             | Terminó el período de acceso del plan          |
| 404    | [`documento-electronico-not-found`](/docs/solucion-problemas/documento-electronico-not-found) | El documento no está disponible para esa clave |

Para automatizar la espera, consultá [Polling de resultados](/docs/guias/polling-resultados).
