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.

Tipos de documentos soportados

---

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:

Proceso de facturación electrónica en POS

---

Configuración

---

La configuración se realiza desde Ajustes → Punto de Venta → Documento Electrónico DIAN (DEE):

1. Habilitar DEE en la configuración del punto de venta.
2. Asignar el partner “Consumidor Final” que determina la lógica de selección de diario.
3. Seleccionar el Modo de Operación DIAN (tipo POS).
4. 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
5. Configurar medios de pago con los códigos DIAN correspondientes.
6. 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.company y account.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:

Nuestros servicios

---

Contáctanos

---

Obtendrás asistencia gratuita durante 60 días por cualquier error o problema.

Para consultas o soporte: [email protected]