# API Oficial (antes Web Service Oficial): extraer documentos por CUFE > La API Oficial trae documentos de la DIAN por su CUFE o CUDE y firma cada solicitud con tu certificado digital, sin navegador ni captchas. Pegas los códigos, uno por línea, y pulsas Extraer. En versiones anteriores se llamaba Web Service Oficial. Página: https://frayi.co/documentacion/web-service-oficial/ · Categoría: Consulta DIAN · Actualizado el 18 de octubre de 2026 · Documentación de Frayi Doc-e (GRANFOGROUP S.A.S.). 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. > **Nota:** En versiones anteriores esta vía se llamaba **Web Service Oficial**. Es la misma vía; solo cambió su nombre en pantalla. ## Qué necesitas - Un **certificado digital** (.p12 o .pfx) vigente, cargado en Frayi Doc-e. Ver [Certificados y bóveda](https://frayi.co/documentacion/certificados-y-boveda/). - 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 1. **Abre la vía**: Ve a **Consulta DIAN → Consultar documentos** y elige **API Oficial**. 2. **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**. 3. **Pega los códigos**: En **CUFEs a extraer** pega un código por línea. 4. **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. 5. **Extrae**: Pulsa **Extraer N documento(s)**. El número indica cuántos códigos detectó la app. 6. **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](https://frayi.co/documentacion/portal-token/) o [Portal · Certificado](https://frayi.co/documentacion/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](https://frayi.co/documentacion/radian-emision-individual-y-lote/). ## 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. --- Más guías: https://frayi.co/documentacion/ (índice en Markdown: https://frayi.co/documentacion.md).