Importar y gestionar facturas de compra en Colombia | SiFactura

Importar y gestionar facturas de compra en Colombia

Esta guía explica cómo configurar una casilla de Gmail para recibir XML de proveedores, cómo buscar esos documentos en Egresos > Compras y cómo registrar su aceptación o rechazo dentro de SiFactura.

AlertAlcance importante. Los botones Aceptar y Rechazar de la pantalla actual cambian el estado dentro de SiFactura y envían un correo al proveedor. No generan ni transmiten a la DIAN un ApplicationResponse, acuse, recibo del bien/servicio, aceptación expresa o reclamo, y por sí solos no registran eventos en RADIAN.

1. Qué hace la importación

SiFactura consulta la bandeja INBOX de una cuenta Gmail por IMAP, identifica correos dirigidos directamente a esa dirección y procesa adjuntos XML compatibles. Los documentos importados aparecen con canal EMAIL en Egresos → Compras.

CondiciónComportamiento actual
ProveedorDebe enviar el mensaje a la casilla configurada en el campo Para. No debe depender de CC o CCO.
AdjuntoDebe incluir el XML de la factura/nota como adjunto del correo. Deben evitarse enlaces de descarga externos.
CasillaLa integración actual admite Gmail mediante IMAP seguro; no hay configuración genérica para Outlook u otros servidores.
FrecuenciaAproximadamente cada 15 minutos en TEST y cada 60 minutos en HAB o PROD.
VolumenLa lectura procesa lotes limitados; una bandeja con mucho histórico puede tardar varios ciclos.

2. Preparación de la cuenta Gmail

  1. Uso de una casilla dedicada: debe crearse o elegirse una dirección exclusiva para facturas de proveedores. Así se reducen adjuntos ajenos al proceso y se facilita auditoría y revocación.
  2. Activación de la verificación en dos pasos: en la seguridad de la cuenta Google, debe activarse la verificación en dos pasos. Google exige esta condición para crear una contraseña de aplicación, salvo restricciones propias de cuentas administradas.
  3. Creación de una contraseña de aplicación: en Cuenta de Google > Seguridad > Contraseñas de aplicaciones, debe generarse una contraseña para "SiFactura compras". Los 16 caracteres deben copiarse cuando Google los muestre.
  4. La contraseña normal no debe entregarse: la integración actual no ofrece "Iniciar sesión con Google"; se necesita una contraseña de aplicación para el acceso IMAP. Nunca debe suministrarse la contraseña principal de Gmail.

Alert
La opción "Contraseñas de aplicaciones" puede no aparecer en cuentas empresariales/educativas, Protección Avanzada o configuraciones que solo permiten llaves de seguridad. En ese caso, el administrador de Google Workspace debe evaluar la política; no deben desactivarse controles de seguridad para forzar el acceso.

3. Registro de la casilla

La versión revisada de SiFactura tiene el servicio de registro, pero no muestra una pantalla de autoservicio para esta configuración. Debe solicitarse a soporte o al administrador autorizado que registre:

  • Dirección Gmail completa.
  • Contraseña de aplicación, no la contraseña normal.
  • Empresa/tenant correcto.
  • Ambiente: TEST, HAB o PROD.
  1. Uso de un canal seguro: debe coordinarse un mecanismo aprobado para entregar el secreto. No debe incluirse en un correo, chat o ticket de texto común.
  2. Inicio en HAB cuando sea posible: debe registrarse la casilla para HAB, enviarse un XML de prueba y comprobarse la importación antes de activar la operación real en PROD.
  3. Confirmación de una lectura: debe esperarse el siguiente ciclo y buscarse el comprobante en Egresos → Compras. Si no aparece, debe entregarse a soporte fecha, remitente y asunto, pero no deben reenviarse credenciales ni XML sensible por un canal inseguro.

4. Indicaciones para los proveedores

Puede compartirse una instrucción simple:

"Envíe cada factura electrónica o nota a [casilla configurada] en el campo Para, con el XML validado por la DIAN adjunto al mensaje. No envíe únicamente el PDF ni un enlace de descarga".

Info
Si el proveedor envía un contenedor comprimido o una estructura distinta, conviene verificar la importación antes de adoptarla como formato habitual. La detección actual está orientada al XML adjunto.

5. Búsqueda y revisión de las compras

  1. Apertura de la consulta: vaya a Egresos > Compras.
  2. Aplicación de filtros: pueden filtrarse por fecha de emisión, creación o vencimiento, período, proveedor, tipo (factura, nota débito o nota crédito), canal EMAIL, ambiente y estado. Presione Buscar.
  3. Apertura del documento: en el menú de acciones seleccione Ver. Deben compararse proveedor, NIT, número, CUFE/CUDE cuando corresponda, fechas, impuestos, total y adjuntos con el XML validado.
  4. Datos administrativos: use Editar para corregir el correo de rechazo del proveedor y asignar el período contable. También pueden agregarse o descargarse adjuntos de respaldo.

6. Aceptación o rechazo dentro de SiFactura

  1. Selección de la acción: en la fila del comprobante, abra el menú y elija Aceptar o Rechazar. Para varios documentos, marque las casillas y use "Aceptar Comprobantes" o "Rechazar Comprobantes".
  2. Revisión del destinatario: confirme el correo del proveedor. Si está vacío o es incorrecto, cierre la acción, use Editar y actualícelo.
  3. Mensaje claro: en el modal, agregue el detalle que acompañará el correo. Para un rechazo, debe indicarse número de factura, motivo verificable y acción solicitada al proveedor.
  4. Confirmación y verificación: SiFactura actualiza el estado interno y envía el correo. Debe actualizarse la búsqueda para confirmar el nuevo estado. Los adjuntos y soportes del análisis deben conservarse.

7. Si se necesitan efectos ante la DIAN o RADIAN

Para operaciones a crédito o cuando se requiera la trazabilidad jurídica de una factura electrónica como título valor, la DIAN distingue eventos como:

  • Acuse de recibo de la factura electrónica de venta.
  • Recibo del bien o prestación del servicio.
  • Aceptación expresa o tácita.
  • Reclamo de la factura electrónica.

Alert
Estos eventos deben transmitirse y validarse por la DIAN mediante una solución que los soporte. El estado interno "Aceptado/Rechazado" de SiFactura no equivale a esos eventos. Hasta que la función esté integrada, deben realizarse desde la solución gratuita DIAN, un proveedor tecnológico o la solución electrónica autorizada que use la empresa, conservando la constancia de validación.

Solución de problemas

ProblemaQué revisar
No aparece el correoQue se envió a la casilla en "Para", llegó a INBOX, contiene XML adjunto, corresponde al ambiente y ya transcurrió un ciclo de lectura.
Gmail rechaza el accesoVerificación en dos pasos, contraseña de aplicación vigente y políticas de Google Workspace. La contraseña se revoca si cambia la contraseña principal.
Se importó, pero faltan datosValidez y estructura del XML recibido. Compárese con el documento autorizado por la DIAN.
No llega el aviso al proveedorCorreo de rechazo guardado en Editar, filtros antispam y dirección correcta.
Necesita cambiar la casillaDebe solicitarse a soporte rotar o desactivar la configuración anterior y revocar la contraseña de aplicación.

Fuentes oficiales consultadas

Info
Google y la DIAN pueden modificar sus mecanismos de acceso y operación. Deben revisarse las páginas oficiales antes de cambiar credenciales o registrar eventos con efectos legales.

    • Related Articles

    • ¿Cómo importar y crear productos masivamente en SiFactura?

      Aprende a crear tu lista completa de productos o servicios en SiFactura mediante la importación masiva con archivo Excel. 1. Descargar el archivo Excel de ejemplo Siga estos pasos para importar su lista de productos de forma sencilla y segura: Ir a ...
    • Restricción sobre Facturas de Compra y Venta en SiFactura

      El módulo de Restricción sobre Facturas permite bloquear los períodos de compras y ventas una vez que se ha presentado la información ante ARCA, evitando modificaciones posteriores que alteren las declaraciones ya enviadas. Esta funcionalidad resulta ...
    • ¿Cómo crear un producto de compra?

      1. Ingresar a la sección de productos Dirígete a Base de datos > Producto > Agregar producto. 2. Completar los datos principales Código del producto: asigna un identificador único. Ejemplo: GASTOBANCARIO. Descripción: escribe la descripción del ...
    • ¿Cómo configurar WooCommerce para integrarlo con SiFactura?

      Requisito previo Tener una cuenta activa en SiFactura. ?¿Cómo crear la cuenta en SiFactura? 1. Generar claves de acceso API REST En el WordPress de tu tienda, ve a WooCommerce > Ajustes > Avanzado > REST API y haz clic en “Añadir clave”. Completa el ...
    • ¿Cómo resolver si no ves las ventas de TiendaNube?

      Esto ocurre generalmente cuando la conexión entre SiFactura y TiendaNube se desincroniza, por ejemplo, después de un tiempo sin uso o cambios de sesión en TiendaNube. Ejemplo de cómo podría verse si está desincronizado 1. Verifica la vinculación ...