---
title: Consultar un Documento por CDC
description: "Este servicio consulta los datos del DE de FacturaSend por medio del CDC, recuperando informaciones importantes para el control de flujo. Este servicio es similar al servicio \"[Consulta DE por ID](https://facturasend.com.py/documentacion/consultar-un-documento-por-id/)\", con la diferencia del parámetro de entrada. ### Obtener…"
url: "https://facturasend.com.py/documentacion/consultar-un-documento-por-cdc/"
updated: "2025-07-10"
category: "3-API de FacturaSend"
---

# Consultar un Documento por CDC

Este servicio consulta los datos del DE de FacturaSend por medio del CDC, recuperando informaciones importantes para el control de flujo.

Este servicio es similar al servicio "[Consulta DE por ID](https://facturasend.com.py/documentacion/consultar-un-documento-por-id/)", con la diferencia del parámetro de entrada.

### Obtener el CDC

El **CDC** se devuelve al crear un documento electrónico, el cual debe ser almacenado por el integrador en su sistema, relacionándolo con el movimiento correspondiente. El **CDC** también puede ser obtenido desde la consulta de un determinado documento electrónico por medio de la consola.

Para obtener el **CDC** de cualquier documento desde la consola de FacturaSend debe ingresar al documento electrónico, seleccionando con un clic:

![](https://i0.wp.com/facturasend.tips.com.py/wp-content/uploads/2025/04/image-1.png?ssl=1)

Luego en la pestaña de VER, debe desplazarse hasta el final de la página. El CDC aparecerá antes de los botones de acción, cómo se visualiza a continuación:

![](https://i0.wp.com/facturasend.tips.com.py/wp-content/uploads/2025/04/image-3.png?ssl=1)

### Endpoint (URL)

**GET**https://api.facturasend.com.py/<tenantId>/de/cdc/<id>

### Header (Encabezado)

Requiere el envío del los siguientes atributos en el encabezado

| Campo | Valor |
| --- | --- |
| Authorization | Bearer api_key_**reemplazar_api_key** |

### Parámetros (BODY)

No posee

### Parámetros (Query Param)

No posee

### Ejemplo de llamadas

- [shell](#tab-shell)
- [javascript](#tab-javascript)

```
curl 
  -X 
  GET "https://api.facturasend.com.py/<tenantId>/de/cdc/01800695631001002100732012024072311932227581"
  -H "Authorization: Bearer api_key_<reemplazar_api_key>"
```

```
# El ejemplo se muestra utilizando AXIOS
import axios from 'axios';

const headers = {
  `Authorization` : `Bearer api_key_<reemplazar_api_key>`
};

axios.get(`https://api.facturasend.com.py/<tenantId>/de/cdc/01800695631001002100732012024072311932227581`,
  {headers}
)
.then( respuesta => {
  console.log(respuesta);
});
```

### Respuesta de la Petición

La respuesta de la petición será la siguiente:

```
{
  "success": true,
  "result": {
    "id": 2731,
    "fecha": "2025-03-11T18:49:26.840Z",
    "rde": {
      //Contenido del XML en formato JSON
    },
    "situacion": 4,
    "is_conectado": 1,
    "is_borrado": 0,
    "lote_id": 4254,
    "lote_estado": 3,
    "info_codigo": "1001",
    "info_descripcion": "CDC duplicado"
  }
}
```

### Recomendaciones

- No aplica

### Codificaciones de la Salida

**Situaciones de un DE - (result.situacion)**

Los siguientes números son codificaciones para la **situación** de cualquier documento Electrónico. Se recomienda que utilice ésta misma codificación en su sistema.

**-1** = Borrador
**0** = Generado DE
**1** = Enviado en un Lote
**2** = Aprobado
**3** = Aprobado con observación
**4** = Rechazado
**98** = Inexistente
**99** = Cancelado.

**Ambiente de Conexión a SIFEN (result.is_conectado)**

**0** = No conectado a SIFEN
**1** = Conectado a Ambiente de Pruebas
**2** = Conectado a Producción SIFEN

**Borrado Lógico del Registro (result.is_borrado)**

Los documentos enviados a FacturaSend, nunca se eliminan, ni si son rechazados. Para evitar duplicaciones en la consola y evitar confusiones de documentos, aquellos documentos que no serán más utilizados, se marcan internamente con una opción de borrado, pero siempre permanecen en la base para que puedan ser recuperados. De esta forma se mantiene el histórico.

**0** = Documento vigente (válido)
**1** = Documento borrado lógicamente

**Estado del Lote (result.lote_estado)**

La *situación de los documentos* difiere del *estado de los lotes*, ya que cada uno de ellos mantiene su propia información independiente.

**0** = Lote Generado (en **FacturaSend**, no así en **SIFEN**)
**1** = Lote no encolado (no enviado a **SIFEN**), puede ser por algún error.
**2** = Lote encolado (enviado a **SIFEN**), y esperando su procesamiento
**3** = Lote con proceso concluido (los documentos pudieron aprobarse o rechazarse en **SIFEN**)
**4** = Lote en borrador (cuando se envía con la opción borrador)
**5** = Lote en borrador rechazado (los lotes rechazados no borran de **FacturaSend**)

### Validaciones

- No aplica