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¶
- Ve a Ajustes en el menú lateral
- Busca la sección Facturación electrónica
- Ingresa los datos de conexión con Factus:
- API key
- Datos del emisor (NIT, razón social)
- Toca Probar conexión para verificar que todo esté correcto
- Agrega tu resolución de facturación
Emitir una factura¶
Desde el POS o una comanda¶
- Realiza la venta normalmente: agrega productos y el cliente
- 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)
- Al cobrar, selecciona Factura electrónica como tipo de documento
- Confirma el pago
- La factura se emite automáticamente
Desde el kiosco¶
Si el cliente activa "Necesito factura" en el kiosco:
- Ingresa sus datos directamente en la pantalla táctil
- El sistema valida los datos en tiempo real (documento, nombre, correo)
- 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¶
- Ve a Facturas en el menú lateral
- Si hay facturas pendientes, verás un aviso con la cantidad
- Toca Reintentar cola para volver a enviar todas las pendientes
- 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¶
- Ve a Facturas en el menú lateral
- 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.