# Consulta DIAN: las cuatro vías para traer tus documentos

> Frayi Doc-e trae tus documentos electrónicos de la DIAN por cuatro vías: API Oficial, Portal · Token, Portal · Certificado y Buzón Tributario. Si la DIAN complica una, usas otra. Todas se eligen en Consulta DIAN → Consultar documentos.

Página: https://frayi.co/documentacion/consulta-dian-cuatro-vias/ · Categoría: Consulta DIAN · Actualizado el 18 de octubre de 2026 · Documentación de Frayi Doc-e (GRANFOGROUP S.A.S.).

La DIAN cambia con frecuencia sus controles contra la automatización. Por eso Frayi Doc-e no depende de un solo camino: tienes cuatro vías y todas llegan a la misma tabla de resultados.

## Dónde se elige la vía

Abre **Consulta DIAN → Consultar documentos**. Verás una tarjeta por cada vía. La **API Oficial** lleva la marca **Recomendado** y la última vía que usaste aparece como **Última usada**.

![Imagen Frayi Doc-e opciones de consulta de documentos electrónicos API oficial, Buzón tributario, Portal token y portal con certificado](https://frayi.co/media/docs/0f4011532f63762a.jpg)

*Imagen real menú opciones de consulta*

## Compara las cuatro vías

| Vía | Qué trae | Qué necesitas | Úsala cuando |
| --- | --- | --- | --- |
| **API Oficial** | Documentos puntuales por su CUFE o CUDE | Tu certificado digital (.p12 o .pfx) | Ya tienes los códigos o manejas mucho volumen |
| **Portal · Token** | Todo un periodo por rango de fechas | El token de tu sesión DIAN y Chrome o Edge instalado | Quieres un mes completo sin certificado |
| **Portal · Certificado** | Todo un periodo por rango de fechas | Tu certificado digital | Quieres periodos completos sin un token que vence |
| **Buzón Tributario** | Las facturas que llegan a tu correo de recepción | Tu correo y una contraseña de aplicación | Tus proveedores te envían las facturas por correo |

Detalle de cada una: [API Oficial](https://frayi.co/documentacion/web-service-oficial/), [Portal · Token](https://frayi.co/documentacion/portal-token/), [Portal · Certificado](https://frayi.co/documentacion/portal-certificado/) y [Buzón Tributario](https://frayi.co/documentacion/buzon-tributario/).

> **Consejo:** **¿Cuál elegir?** Si tienes los CUFE, usa la API Oficial: no abre navegador ni pasa por captchas. Para un mes completo, usa Portal · Token o Portal · Certificado. Para las compras que tus proveedores te envían al correo, conecta el Buzón Tributario.

## Lo que comparten todas las vías

Antes de consultar, mira la barra superior y confirma la **empresa activa** y el **ambiente** (Producción o Habilitación). La empresa define qué certificado se usa. El ambiente debe coincidir con el de tu token o tu certificado. Más detalles en [Configuración y almacenamiento](https://frayi.co/documentacion/configuracion-y-almacenamiento/).

Luego eliges el **tipo de consulta**:

| Tipo | Qué hace | Ideal para |
| --- | --- | --- |
| **Simple** | Solo llena la tabla de resultados | Revisar rápido |
| **Completa** | Llena la tabla y descarga el XML y el PDF de cada documento | Trabajar y archivar |
| **Anexos** | Descarga los archivos a una carpeta, sin llenar la tabla | Solo guardar los archivos |

Con **Completa** o **Anexos** eliges también cómo se organizan los archivos:

- **Separados (PDF/ y XML/)**: una carpeta con todos los XML y otra con todos los PDF. Conviene si después usarás [Análisis local](https://frayi.co/documentacion/analisis-local/).
- **Por documento**: una carpeta por factura. Conviene para archivar o enviar los documentos a un cliente.

Los archivos van a la carpeta que definas en **Configuración → Almacenamiento**. Si no defines ninguna, van a tu carpeta Descargas. Cada consulta crea su propia subcarpeta con la fecha y la hora, así que dos consultas del mismo día no se sobrescriben.

Con el tipo **Simple** puedes activar **Incluir análisis automático**: los resultados pasan directo al módulo Análisis local, con sus indicadores y gráficas.

## Guarda tus consultas rápidas

Si repites la misma consulta cada mes, guárdala como plantilla.

1. **Configura la consulta**: Elige la vía, el tipo de documento, el tipo de consulta y el rango de fechas.
2. **Guárdala**: Pulsa **Guardar como plantilla** y escribe un nombre.
3. **Asóciala si quieres**: Marca **Asociar a la empresa activa** para que la app cambie a esa empresa cuando la apliques.
4. **Aplícala después**: En **Consultar documentos**, elige la consulta rápida. La app deja la configuración lista para revisar; no la ejecuta sola.

El rango de fechas se guarda como un periodo que se recalcula cada vez, por ejemplo «Mes pasado». Las plantillas nunca guardan tu token ni tus contraseñas.

## Por qué las vías de portal usan un navegador

Desde 2026 el portal de la DIAN comprueba que quien consulta sea una persona: hay un reto al iniciar sesión y una validación invisible por cada documento que se descarga. Frayi Doc-e no usa servicios para «romper» captchas. En Portal · Token y Portal · Certificado la consulta corre en una ventana de navegador en tu propio equipo, donde la validación se resuelve igual que cuando entras tú.

- La ventana trabaja pequeña, en una esquina. Si prefieres no verla, activa **Ocultar el navegador de consulta**.
- Si la DIAN pide un paso manual, la app trae la ventana al frente y te avisa. Lo completas una vez y la consulta sigue.
- Las demoras las pone la DIAN: valida cada documento y eso suma unos segundos por factura.

## Preguntas frecuentes

### ¿Puedo usar varias vías para la misma empresa?

Sí. La app reconoce cada documento por su código único y no lo duplica, aunque lo traigas por vías distintas. También separa bien los emitidos de los recibidos, incluso cuando dos de tus empresas se facturan entre sí.

### ¿Frayi Doc-e es un servicio de la DIAN?

No. Frayi Doc-e es una herramienta independiente, no afiliada a la DIAN. Usa los servicios que la DIAN ofrece al contribuyente, con tus propias credenciales.

### ¿Necesito internet para trabajar?

Para consultar la DIAN, sí. Lo que ya descargaste queda guardado en tu equipo y puedes revisarlo sin conexión.

### ¿Qué pasa si la DIAN cambia su portal?

Puede afectar por un tiempo las vías de portal. Mientras tanto, la API Oficial y el Buzón Tributario siguen disponibles, y las correcciones llegan por [actualización automática](https://frayi.co/documentacion/actualizaciones-automaticas/).

---

Más guías: https://frayi.co/documentacion/ (índice en Markdown: https://frayi.co/documentacion.md).
