Consulta DIAN

Buzón Tributario: traer facturas desde tu correo de recepción

El Buzón Tributario conecta el correo donde recibes las facturas de tus proveedores. Frayi abre los ZIP adjuntos, toma el XML y el PDF original y llena la tabla sin duplicar. Solo lee: no borra, no mueve ni marca tus correos. Se conecta una vez con un asistente de cuatro pasos.

Actualizado el

Tus proveedores ya te envían cada factura al correo. Esta vía las toma de ahí: sin portal, sin captchas y sin descomprimir archivos a mano.

Qué correos funcionan

CorreoCómo se conectaQué necesitas
Outlook.com y Microsoft 365Microsoft 365 / Outlook (recomendado, solo lectura)Tu cuenta. Se abre tu navegador y aceptas el permiso «Leer tu correo». En muchas empresas, un administrador debe aprobar Frayi una vez
Gmail, Yahoo, iCloud y ZohoContraseña de aplicaciónVerificación en dos pasos activa y una contraseña de aplicación
Titan y el correo de tu hosting (cPanel o Plesk)La contraseña del buzónEsa contraseña
Google WorkspaceContraseña de aplicación, si tu administrador lo permiteSi las bloqueó, Conectar con Google, con los datos que te dé tu área de TI
Un servidor de correo propioIMAP manualEl servidor y el puerto

Una contraseña de aplicación es una clave especial, de unos 16 caracteres, que generas en la configuración de tu correo para que un programa entre sin usar tu contraseña habitual. Tu contraseña normal no sirve aquí.

Cómo lo activas: conecta tu correo, una sola vez

  1. Abre el Buzón

    Ve a Consulta DIAN › Consultar documentos y elige Buzón Tributario. Pulsa Conectar cuenta de correo, o Agregar cuenta si ya tienes otra.

  2. Correo

    Escribe el correo donde recibes las facturas y pulsa Continuar. Frayi reconoce tu proveedor por el dominio, sin enviar tu correo a terceros.

  3. Proveedor

    Confirma el proveedor detectado o elige el tuyo en la lista.

  4. Método

    Elige cómo conectar. Frayi marca el recomendado.

  5. Conecta

    Con Microsoft: se abre tu navegador, eliges la cuenta y aceptas «Leer tu correo». Con contraseña: la escribes y pulsas Conectar y probar. Frayi prueba la conexión y solo guarda la cuenta si funciona.

  6. Elige carpetas y sincronización

    Marca las Carpetas a leer. Si no eliges, lee la Bandeja de entrada. Deja encendida, si quieres, la Sincronización automática cada 15 minutos.

La sincronización automática trae solo los correos que lleguen desde ese momento. Las facturas anteriores las traes cuando quieras con Leer buzón.

Cómo enciendes o apagas la lectura automática

Pulsa la insignia Automático cada 15 min (los minutos cambian según tu ajuste) o Manual, o abre el menú ⋯ › Ajustes de la cuenta. Se abre un panel lateral. Los cambios se guardan solos:

  • Traer los documentos nuevos en segundo plano: enciende o apaga la sincronización.
  • Minutos: cada cuánto lee. Con cuentas de Microsoft conectadas en solo lectura, el mínimo es 5 minutos.
  • Tiempo real: trae cada factura apenas llega. No está disponible en las cuentas de Microsoft en solo lectura.
  • Carpetas guardadas: cámbialas y pulsa Guardar carpetas. Una carpeta nueva trae sus últimos 30 días.

Cuando llega una factura nueva, recibes una notificación.

Cómo desconectas tu correo

Abre el menú ⋯ de la cuenta y pulsa Eliminar cuenta. Frayi pide confirmar y borra de este computador los datos de acceso cifrados. Los documentos ya guardados se conservan. Si la conectaste con Microsoft o Google, retira también el permiso desde tu cuenta en ese proveedor.

Cómo lees el buzón

  • Cuenta: elige el correo. A su lado ves su estado y si está en automático, por ejemplo Automático cada 15 min, o en Manual.
  • Rango: Desde la última vez trae solo lo nuevo. Si la cuenta o una carpeta nunca se ha leído, trae sus últimos 30 días, y una línea te lo dice. También tienes 7 días, 30 días, Este mes y Personalizado, con Desde y Hasta.
  • Más opciones: el Tipo de consulta, las carpetas solo para esta lectura, los filtros por remitente, asunto o cuerpo, y el análisis. Lo que cambies se ve como etiquetas que quitas con la «x».
  • Leer buzón: Frayi abre los ZIP adjuntos, toma el XML, que es el documento con valor legal, y el PDF original del proveedor, y llena la tabla. Lo que ya tenías no se duplica.
Tipo de consultaQué hace
Simple (solo tabla)Solo llena la tabla. Viene por defecto
Completa (tabla + descarga)Llena la tabla y descarga los archivos
Anexos (descarga a carpeta)Solo descarga los archivos

Con Guardar como plantilla dejas la lectura como consulta rápida. Guarda el rango, las carpetas y el tipo de consulta, pero no la cuenta ni las fechas de Personalizado.

Correos que no traían factura

En los resultados verás Sin factura, con el número de correos. Abre un panel lateral con esos correos y su motivo, y Reprocesar para intentar de nuevo con cada uno. Lo que aparezca se guarda como en cualquier consulta.

Para etiquetar correos según su remitente o su asunto, crea reglas en Contabilidad › Reglas › Reglas compuestas. Se aplican en la lectura manual y al reprocesar.

Privacidad

Frayi no guarda tus correos: solo conserva el XML y el PDF de las facturas. No marca correos como leídos, no los mueve, no los borra y no envía nada desde tu cuenta. Lo que tu proveedor le permite a Frayi depende de cómo conectaste la cuenta. Ajustes de la cuenta te lo dice en Acceso:

AccesoCuándo saleQué significa
Solo lecturaCuentas de Microsoft conectadas con el permiso «Leer tu correo»El permiso mismo no deja modificar nada
LecturaCuentas con contraseñaFrayi abre cada carpeta en modo de solo lectura. La contraseña en sí daría acceso completo, por eso se guarda cifrada
Permiso amplioCuentas de Google con el cliente de tu organización, y las de Microsoft conectadas antes de esta versiónEl permiso cubre todo el buzón, aunque Frayi solo lee. En Microsoft, ⋯ › Pasar a solo lectura lo cambia sin releer tu historial

Tus datos de acceso quedan cifrados en tu computador. La Bitácora de accesos registra cada lectura con fecha, cuenta, carpetas y conteos, y los fallos con su motivo. Nunca el contenido de tus correos.

Qué no hace

  • No funciona con Frayi cerrado: no es un servicio en segundo plano.
  • No sigue enlaces de descarga. Si un proveedor envía un enlace en lugar del ZIP, descarga el archivo tú mismo y procésalo en Análisis.
  • La lectura automática no descarga archivos a una carpeta. Para eso, usa Leer buzón en Completa.
  • No consulta a la DIAN: lee lo que llegó a tu correo.

Aunque la app esté en Habilitación, la factura real de un proveedor se guarda. Solo las de pruebas de la DIAN se quedan fuera.

Si algo sale mal

Qué pasaQué hacer
Gmail rechaza mi contraseñaCasi siempre es porque usaste tu contraseña normal. Activa la verificación en dos pasos y genera una contraseña de aplicación.
«Tu organización debe aprobar Frayi»Pulsa Copiar enlace o Copiar mensaje para TI y envíalo a tu área de TI. Se aprueba una sola vez. Cuando lo aprueben, pulsa Ya lo aprobaron, reintentar.
«No se concedió el permiso»Pasa si cancelas en el navegador o cierras su aviso de aprobación. Pulsa Reintentar.
La cuenta dice Requiere reconexiónCambió la contraseña, venció o se retiró el acceso. Pulsa Reconectar en la línea bajo la cuenta. Actualiza la misma cuenta, con sus carpetas y su avance.
La cuenta dice ReintentandoFalló la red o tu proveedor limitó las conexiones. Frayi lo reintenta solo.
El modo automático no trajo nadaRevisa que Frayi haya estado abierto y que la cuenta no esté en Requiere reconexión. Si quieres ponerte al día, pulsa Leer buzón.
«La lectura llegó al tope de correos y quedó incompleta»Pulsa Ajustar el rango, acótalo y vuelve a leer.
Leer buzón está desactivadoElige la cuenta. Con Personalizado, escribe la fecha en Desde.
Una línea dice que hay cuentas sin empresaEsas cuentas no se sincronizan solas. Pulsa Asignar a y el nombre de tu empresa.
«El buzón es de … (NIT …), no de …»Pulsa Cambiar a … o Registrarla. Ver empresas.

En el menú ⋯ de cada cuenta también tienes Probar conexión y Guía de conexión, con el paso a paso de cada proveedor.

¿Sigue sin resolverse? Mira Solución de problemas o escríbenos desde Soporte y recursos.

Preguntas frecuentes

¿Se duplican las facturas si leo el buzón varias veces?

No. Frayi reconoce cada documento por su código único y no duplica lo que ya tenías.

¿Puedo conectar varios correos?

Sí. Agrega cada cuenta y elige cuál leer en cada consulta. Con dos o más, Ajustes de la cuenta muestra Todas las cuentas.

¿Puedo traer facturas de hace meses?

Sí. Usa Personalizado, con Desde y Hasta, y pulsa Leer buzón.

¿Necesito certificado digital?

No. Solo conectar tu correo.

Resultados de la consultaFiltra, descarga y revisa lo que llegó.Causación sugeridaDel documento al asiento que tú apruebas.