Es la vía más robusta cuando sabes exactamente qué documentos necesitas. Usa el servicio web oficial de la DIAN y firma cada solicitud con tu certificado.
Qué necesitas
- Un certificado digital (.p12 o .pfx) vigente, cargado en Frayi Doc-e. Ver Certificados y bóveda.
- Los CUFE o CUDE de los documentos. Cada código tiene 96 caracteres.
- La empresa activa y el ambiente correctos en la barra superior.
Paso a paso
- Abre la vía
Ve a Consulta DIAN → Consultar documentos y elige API Oficial.
- Elige el certificado
En Certificado digital selecciona el tuyo. El que coincide con el NIT de la empresa activa aparece con una marca ✓. Si no tienes ninguno, usa + Agregar.
- Pega los códigos
En CUFEs a extraer pega un código por línea.
- Elige el tipo de consulta
Simple solo llena la tabla, Completa también descarga el XML y el PDF, y Anexos solo descarga los archivos.
- Extrae
Pulsa Extraer N documento(s). El número indica cuántos códigos detectó la app.
- Revisa los resultados
Al terminar ves la tabla. Si descargaste archivos, un aviso muestra la carpeta donde quedaron.
De dónde sacar los CUFE
- Genera el listado oficial directamente desde la DIAN en la opción de reportes, luego estos CUFE los traes a Frayi Doc-e para obtener todos los beneficios de la consulta detallada, análisis y contabilidad.
- De la columna CUFE de una consulta anterior o del Historial de consultas. Si no la ves, actívala en Columnas.
- Del archivo de Excel que descargas desde los resultados.
- Del código QR o del pie de la representación gráfica (PDF) de cada factura.
- De tu proveedor o tu cliente, si te los comparte.
Lotes grandes
La API Oficial procesa miles de códigos en una sola corrida. Mientras avanza ves una barra de progreso con el botón Detener y guardar lo obtenido: conserva lo que ya se extrajo y deja pendiente el resto.
Si la corrida se interrumpe, verás el aviso «Consulta interrumpida». Ejecútala de nuevo con la misma lista: los documentos ya guardados no se duplican y solo se traen los que faltaban.
Límites que debes conocer
- No lista por fechas. Trae exactamente los códigos que pegas. Para todo un mes usa Portal · Token o Portal · Certificado.
- Códigos completos. Si un código está incompleto o trae espacios o saltos de línea de más, la app te avisa que no recibió CUFE válidos.
- Eventos RADIAN. Desde los resultados de esta vía, los eventos se emiten por el portal de la DIAN (Solución Gratuita) con el certificado de la empresa activa, y solo en Producción. Ver Emitir eventos RADIAN.
Preguntas frecuentes
¿La API Oficial necesita Chrome o Edge?
No. Se conecta directo con el servicio de la DIAN. No abre ningún navegador ni se encuentra con captchas.
¿Puedo traer todo un mes con la API Oficial?
No. Esta vía trabaja por código. Para un periodo completo usa una de las vías de portal. Después puedes completar con la API Oficial los documentos puntuales que falten.
¿Qué hago si aparece un error de certificado?
Revisa que el certificado esté vigente, que la contraseña sea la correcta y que corresponda al NIT de la empresa activa. Si lo renovaste hace poco, vuelve a cargarlo en Configuración → Certificados.
¿Mi certificado se sube a internet?
No. El certificado queda cifrado en tu equipo y solo se usa para firmar las solicitudes que se envían a la DIAN.