$ 1979.02
In-App Purchases| Availability |
Odoo Online
Odoo.sh
On Premise
|
| Odoo Apps Dependencies |
•
Point of Sale (point_of_sale)
• Invoicing (account) • Discuss (mail) • Contacts (contacts) • Inventory (stock) |
| Lines of code | 10324 |
| Technical Name |
l10n_co_pos_dian |
| License | See License tab |
| Website | https://www.mi-erp.app |
POS Documento Equivalente Electrónico (DIAN) — Odoo
Facturación electrónica para Punto de Venta con cumplimiento DIAN
Odoo
Punto de Venta
DIAN Colombia
DEE / Factura Electrónica
Descripción
El módulo POS DEE Colombia para Odoo 19 permite generar Documentos Equivalentes Electrónicos (DEE) y Facturas Electrónicas directamente desde el Punto de Venta, cumpliendo con los requisitos de la DIAN para la facturación electrónica en Colombia.
Soporta 4 tipos de documentos con diarios independientes, calcula el CUDE/CUFE (Código Único de Documento Equivalente) en el frontend usando SHA-384, genera códigos QR de validación, envía los documentos XML a la DIAN y funciona tanto en línea como fuera de línea.
✔ Cumple con el Anexo Técnico DIAN 2.1 para Documento Equivalente Electrónico POS y Factura Electrónica de Venta.
✔ Capacidad offline: el cálculo CUDE y la numeración funcionan sin conexión al servidor gracias al caché en localStorage.
Tipos de documentos soportados
20
DEE
Documento Equivalente Electrónico para ventas a Consumidor Final
01
Factura Electrónica
Factura Electrónica de Venta para clientes identificados
94
NDAC DEE
Nota de Ajuste Crédito para devoluciones de Consumidor Final
91
NDAC Factura
Nota de Ajuste Crédito para devoluciones de clientes identificados
Funcionalidades principales
Generación de documentos electrónicos
- DEE automático: genera el Documento Equivalente Electrónico (Tipo 20) para ventas a Consumidor Final.
- Factura Electrónica: genera Factura Electrónica de Venta (Tipo 01) para clientes identificados con NIT.
- Notas de crédito: genera automáticamente NDAC (Tipos 94 y 91) para devoluciones y reembolsos.
- Selección automática: el tipo de documento se determina automáticamente según el cliente seleccionado.
- XML UBL 2.1: documentos XML generados según el perfil DIAN 2.1 Colombia.
Numeración consecutiva sin brechas
- Cumplimiento DIAN: numeración consecutiva obligatoria sin saltos (no-gap sequence).
- Detección de brechas: detecta y llena automáticamente números faltantes en la secuencia.
- 4 diarios independientes: cada tipo de documento tiene su propio diario, prefijo, resolución y rango numérico.
- Validación de rango: alerta cuando el rango de numeración autorizado está por agotarse.
- Sin dependencia de ir.sequence: los números se calculan dinámicamente desde la base de datos.
Cálculo CUDE / CUFE
- SHA-384 en JavaScript: el CUDE se calcula siempre en el frontend para garantizar operación offline.
- Fórmula completa: incluye número de documento, fecha/hora, valores fiscales, NIT emisor/adquiriente, clave técnica y ambiente.
- Valores absolutos: para notas de crédito se usan valores absolutos en la fórmula.
- Zona horaria Colombia: todas las fechas/horas se generan en zona America/Bogota (UTC-5).
Código QR de validación
- QR en recibo: código QR SVG imprimible directamente en el recibo del POS.
- Validación DIAN: enlace directo al catálogo de la DIAN para verificar el documento.
- Ambientes: URLs diferenciadas para ambiente de pruebas (habilitación) y producción.
Envío a la DIAN
- Envío automático o manual: configurable por punto de venta.
- Modo síncrono y asíncrono: soporte para envío directo o diferido.
- Seguimiento de estado: badges de estado (Aceptado, Pendiente, Rechazado, Error, Sin sincronizar).
- Reintento: capacidad de reenviar documentos fallidos.
Soporte offline
- Caché en localStorage: secuencias, brechas y datos de resolución se almacenan localmente.
- CUDE sin servidor: el cálculo SHA-384 se ejecuta nativamente en el navegador.
- Persistencia de datos: la información DIAN del pedido sobrevive recargas de página.
- Limpieza automática: los datos antiguos (+7 días) se eliminan automáticamente.
Recibo POS personalizado
- Encabezado fiscal: nombre comercial, NIT, régimen fiscal, tipos de obligación y código CIIU.
- Sección DIAN: tipo de documento, número, QR, CUDE y datos de resolución.
- Diseño de líneas: filas alternadas (zebra striping), cantidades en negrita, precios alineados.
- Información del cliente: NIT, nombre, dirección, teléfono y correo.
- Pie configurable: texto personalizable desde la configuración del POS.
Arquitectura de 4 diarios
El módulo utiliza una arquitectura de 4 diarios contables independientes, cada uno con su propia resolución DIAN, rango de numeración, prefijo y clave técnica:
| Diario | Tipo de documento | Código | Uso |
|---|---|---|---|
| Diario POS | DEE | 20 | Ventas a Consumidor Final |
| Diario Factura | Factura Electrónica | 01 | Ventas a clientes identificados |
| Diario NC DEE | NDAC DEE | 94 | Devoluciones de Consumidor Final |
| Diario NC Factura | NDAC Factura | 91 | Devoluciones de clientes identificados |
✔ La selección del diario es automática: se determina por el cliente (Consumidor Final vs. cliente con NIT) y por el tipo de operación (venta vs. devolución).
Proceso de facturación electrónica en POS
1
Inicio del POS: al abrir la sesión, se cargan las secuencias de los 4 diarios desde el servidor y se almacenan en localStorage.
2
Selección de cliente: si el cliente es “Consumidor Final” se usa el diario DEE; si es un cliente con NIT se usa el diario de Factura Electrónica.
3
Reserva de número: al validar el pago, se reserva el siguiente número consecutivo (llenando brechas primero si existen).
4
Cálculo CUDE: se calcula el hash SHA-384 con todos los componentes del documento en el navegador (operación offline).
5
Generación de QR: se genera el código QR con la URL de validación DIAN y se muestra en el recibo.
6
Impresión del recibo: el recibo incluye encabezado fiscal completo, sección DIAN con QR, CUDE y datos de resolución.
7
Sincronización: al sincronizar el pedido con el servidor, se generan los XML UBL 2.1 y se envían a la DIAN.
Configuración
La configuración se realiza desde Ajustes → Punto de Venta → Documento Electrónico DIAN (DEE):
- Habilitar DEE en la configuración del punto de venta.
- Asignar el partner “Consumidor Final” que determina la lógica de selección de diario.
- Seleccionar el Modo de Operación DIAN (tipo POS).
- Configurar cada diario con su resolución DIAN:
- Número de resolución
- Fechas de vigencia (inicio y fin)
- Rango de numeración autorizado (mínimo y máximo)
- Clave técnica para el cálculo CUDE
- Configurar medios de pago con los códigos DIAN correspondientes.
- Opcionalmente activar el envío automático a la DIAN.
Detalles técnicos
- Extiende los modelos
pos.order,pos.config,pos.session,res.partner,res.companyyaccount.journal. - Genera XML según el estándar UBL 2.1 Colombia con perfil DIAN 2.1.
- Cálculo CUDE/CUFE mediante Web Crypto API (SHA-384) en JavaScript.
- Endpoints JSON-RPC para comunicación POS-servidor:
/pos/dian/load_sequence_data— Carga inicial de secuencias/pos/dian/get_next_number— Obtener siguiente número/pos/dian/reserve_number_batch— Reserva de lotes/pos/dian/cache_status— Estado del caché
- Componentes OWL para la visualización del recibo DIAN.
- Dependencias:
point_of_sale,l10n_co_edi,l10n_co_dian. - 100% compatible con Odoo 19 Enterprise.
Información fiscal en el recibo
El recibo del POS incluye toda la información requerida por la DIAN:
Encabezado del emisor
- Nombre comercial de la empresa
- NIT con dígito de verificación
- Dirección completa
- Régimen fiscal
- Tipos de obligación (etiquetas)
- Código CIIU principal
- Indicador Gran Contribuyente
Sección DIAN
- Tipo de documento (DEE / Factura)
- Número de documento con prefijo
- Código QR de validación
- Hash CUDE/CUFE completo
- Número de resolución DIAN
- Fechas de vigencia de la resolución
- Rango de numeración autorizado
Contáctanos
Obtendrás asistencia gratuita durante 60 días por cualquier error o problema.
Para consultas o soporte: info@mi-erp.app
Proprietary License v1.0 Este software y los archivos asociados (el "Software") solo se pueden utilizar (ejecutar, modificado, ejecutado después de modificaciones) si ha comprado una licencia válida de los autores, normalmente a través de las aplicaciones de Odoo, o si ha recibido una acuerdo de los autores del Software (consulte el archivo COPYRIGHT). Puede desarrollar módulos de Odoo que utilicen el Software como una biblioteca (normalmente dependiendo de él, importándolo y usando sus recursos), pero sin copiar cualquier código fuente o material del Software. Está prohibido publicar, distribuir, sublicenciar o vender copias del Software. o copias modificadas del Software. El aviso de copyright anterior y este aviso de permiso deben incluirse en todos copias o partes sustanciales del Software. EL SOFTWARE SE PROPORCIONA "TAL CUAL", SIN GARANTÍA DE NINGÚN TIPO, EXPRESA O IMPLÍCITAS, INCLUIDAS PERO NO LIMITADAS A LAS GARANTÍAS DE COMERCIABILIDAD, APTITUD PARA UN PROPÓSITO PARTICULAR Y NO INFRACCIÓN. EN NINGÚN CASO LOS AUTORES O TITULARES DE LOS DERECHOS DE AUTOR SERÁN RESPONSABLES DE NINGÚN RECLAMO, DAÑOS U OTRA RESPONSABILIDAD, YA SEA EN UNA ACCIÓN DE CONTRATO, AGRAVIO O DE OTRA FORMA, SURGIENDO, FUERA DE O EN RELACIÓN CON EL SOFTWARE O EL USO U OTROS NEGOCIACIONES EN EL SOFTWARE.
Please log in to comment on this module