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.
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, Portal · Token, Portal · Certificado y 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.
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.
- 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.
- Configura la consulta
Elige la vía, el tipo de documento, el tipo de consulta y el rango de fechas.
- Guárdala
Pulsa Guardar como plantilla y escribe un nombre.
- Asóciala si quieres
Marca Asociar a la empresa activa para que la app cambie a esa empresa cuando la apliques.
- 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.