Saltar a contenido

Factura electrónica DIAN

Qu3ntas emite facturas electrónicas válidas ante la DIAN usando Factus como proveedor tecnológico. La factura se genera desde el POS, la comanda de restaurante o el kiosco, y se envía automáticamente a la DIAN y al correo del cliente.


Requisitos previos

Antes de poder facturar necesitas:

Requisito Descripción
Resolución de facturación Autorización vigente de la DIAN con prefijo y rango de numeración
Cuenta en Factus Credenciales del proveedor tecnológico (API key)
Datos de tu empresa NIT, razón social, dirección, régimen tributario
Certificado habilitación Tu empresa debe estar habilitada como facturador electrónico ante la DIAN

Habilitación DIAN

Si tu empresa aún no está habilitada como facturador electrónico, consulta con tu contador o ingresa a muisca.dian.gov.co para iniciar el proceso.


Configurar la facturación

  1. Ve a Ajustes en el menú lateral
  2. Busca la sección Facturación electrónica
  3. Ingresa los datos de conexión con Factus:
    • API key
    • Datos del emisor (NIT, razón social)
  4. Toca Probar conexión para verificar que todo esté correcto
  5. Agrega tu resolución de facturación

Emitir una factura

Desde el POS o una comanda

  1. Realiza la venta normalmente: agrega productos y el cliente
  2. Antes de cobrar, asegúrate de tener un cliente asociado con:
    • Tipo de documento: CC, NIT, CE, PAS, TI o PEP
    • Número de documento: sin puntos ni espacios (el sistema los limpia automáticamente)
    • Nombre o razón social
    • Correo electrónico (la DIAN lo exige para enviar la representación gráfica)
  3. Al cobrar, selecciona Factura electrónica como tipo de documento
  4. Confirma el pago
  5. La factura se emite automáticamente

Desde el kiosco

Si el cliente activa "Necesito factura" en el kiosco:

  1. Ingresa sus datos directamente en la pantalla táctil
  2. El sistema valida los datos en tiempo real (documento, nombre, correo)
  3. Al confirmar el pedido, la factura se emite con esos datos

Consumidor final

Si el cliente no necesita factura (el caso más común en comida rápida), la venta se registra internamente con el documento genérico "222222222222" (Consumidor Final). Esto cumple con la normativa sin necesidad de pedirle datos al cliente.


El motor fiscal

Qu3ntas calcula los valores de cada factura con un motor fiscal puro para Colombia:

Cálculo por línea

Para cada producto en la factura:

Campo Cálculo
Bruto Cantidad × Precio unitario
Descuento Bruto × Porcentaje de descuento
Subtotal Bruto − Descuento
IVA Subtotal × Tarifa de IVA
Total línea Subtotal + IVA

Tarifas de IVA soportadas

Tarifa Uso típico
0% Productos excluidos o exentos
5% Algunos alimentos procesados
8% Impoconsumo (INC) para restaurantes
19% Tarifa general

Retenciones

El sistema soporta tres tipos de retención:

  • Retefuente — retención en la fuente
  • ReteIVA — retención sobre el IVA
  • ReteICA — retención de industria y comercio

Las retenciones se calculan sobre la base gravable y se restan del total.

Redondeo

Todos los valores se redondean a 2 decimales con Math.round estándar, por compatibilidad con el cálculo de Factus.


Propina en la factura

La propina voluntaria no lleva IVA por normativa colombiana. En la factura aparece separada:

  • El total fiscal (subtotal + impuestos) es lo que va a la DIAN
  • La propina se suma solo para el cobro al cliente
  • El campo total_con_propina = total fiscal + propina

Medios de pago

La factura registra el medio de pago utilizado:

Medio Descripción
Efectivo Pago en billetes o monedas
Tarjeta Débito o crédito (datafono)
Transferencia Bancaria
Nequi Billetera digital Nequi
Daviplata Billetera digital Daviplata
Mixto Combinación de varios medios
Crédito (fiado) Venta a crédito del cliente

Estados de la factura en la DIAN

Después de emitir, la factura pasa por estos estados:

Estado Significado Acción
Pendiente Se intentó enviar pero no hubo respuesta (problema de red o del servicio) Se reintenta automáticamente o manual
Aceptada La DIAN la validó correctamente. Tiene CUFE Ninguna — todo bien
Rechazada La DIAN encontró un error Revisar el detalle del error y corregir

Cola de reintento

Si Factus o la red fallan durante la emisión, la factura no se pierde: queda guardada localmente en estado pendiente con los ítems y el inventario ya registrados.

Reintentar manualmente

  1. Ve a Facturas en el menú lateral
  2. Si hay facturas pendientes, verás un aviso con la cantidad
  3. Toca Reintentar cola para volver a enviar todas las pendientes
  4. El sistema reconstruye el payload de Factus y reintenta cada una

El reintento muestra cuántas se enviaron exitosamente y cuántas siguen pendientes.

Reintento automático

La próxima vez que hagas una venta, el sistema también intenta procesar las facturas pendientes de la cola.


Ver facturas emitidas

  1. Ve a Facturas en el menú lateral
  2. Verás el listado con:
    • Número de factura (prefijo + consecutivo)
    • Fecha y hora
    • Cliente (nombre e iniciales)
    • Total
    • Medio de pago (con ícono)
    • Procedencia (mesa, llevar, domicilio, mostrador)
    • Estado (pagada, pendiente, anulada)

Filtros

Filtra por estado:

  • Todas: muestra todo el historial
  • Pagadas: ventas cobradas exitosamente
  • Pendientes: ventas con pago pendiente (fiado)
  • Anuladas: facturas que se anularon con nota crédito

Detalle de una factura

Toca cualquier factura para ver:

  • Datos del cliente
  • Lista de productos con cantidades, precios e impuestos
  • Desglose de subtotal, descuentos, IVA y total
  • Medio de pago
  • Estado DIAN y CUFE (si fue aceptada)
  • Botones para imprimir o crear nota crédito

Anular una factura

Una factura electrónica aceptada por la DIAN no se puede borrar. Para revertirla debes emitir una nota crédito.

Para facturas que aún no se enviaron a la DIAN (estado pendiente), puedes anularlas directamente desde el detalle de la factura.


Preguntas frecuentes

¿Puedo facturar sin internet?
Sí. La factura se registra localmente y queda en la cola de pendientes. Cuando vuelvas a tener internet, se envía a la DIAN automáticamente.
¿Qué pasa si la DIAN rechaza una factura?
Revisa el mensaje de error en el detalle de la factura. Los errores más comunes son datos del cliente incompletos, NIT con dígito de verificación incorrecto o resolución vencida. Corrige y reintenta.
¿Cada venta del POS genera una factura electrónica?
Solo si eliges "Factura electrónica" al cobrar. Las ventas como "consumidor final" se registran internamente pero no se envían a la DIAN como factura individual (depende de tu régimen tributario y obligaciones).
¿El UVT se actualiza automáticamente?
El valor del UVT para 2026 ($47.065 COP aprox.) está configurado en el sistema. Se actualiza con cada versión de Qu3ntas cuando la DIAN publica el nuevo valor.