Documentación KSIDol > Módulos KSIDol > Tienda (KSIRetail)

Guía del módulo: Tienda (KSIRetail)

Una guía no técnica: para qué sirve el módulo, cómo usarlo cada día y cómo se integra con Dolibarr.

Pestañas añadidas a las fichas nativas13

Permisos específicos17

Idiomas disponibles5 (650 claves cada uno)

Compatibilidad con DolibarrDe la v18 a la v24

1. Descripción del módulo

KSIRetail convierte Dolibarr en una caja de tienda completa, sin salir nunca de sus objetos nativos: productos, stocks, facturas, abonos y pedidos a proveedor siguen siendo los que ya conoce. En el mostrador, la venta con escáner, las sesiones de caja trazadas y los cierres seguros responden a las exigencias de la normativa francesa contra el fraude del IVA. Entre bastidores, los inventarios, las transferencias, las recepciones y el reaprovisionamiento se articulan con los almacenes y los pedidos a proveedor nativos. La fidelización, las tarjetas regalo, las promociones y los conectores de venta en línea completan el conjunto, para una tienda gestionada de principio a fin desde Dolibarr.

Caja en modo escaneo primero, pensada para ir rápido en el mostrador
Sesiones de caja trazadas y cierres sellados, alineados con las exigencias de la normativa NF525
Varios códigos de barras por artículo e impresión de etiquetas desde el navegador
Inventarios, transferencias y recepciones gestionados tienda por tienda, sobre el stock nativo de Dolibarr
Reaprovisionamiento calculado automáticamente, devoluciones y abonos vinculados a las facturas nativas
Programa de fidelización, tarjetas regalo y promociones dirigidas
Conectores para la venta en línea, sin copiar sus datos fuera de Dolibarr
Disponible en 5 idiomas, compatible con las versiones de Dolibarr de la v18 a la v24

2. Un módulo que se apoya en Dolibarr, sin duplicar nada

KSIRetail no crea ningún circuito paralelo a Dolibarr: se conecta a los objetos que ya utiliza.

Los productos, los stocks, las facturas, los pagos, los abonos y los pedidos a proveedor siguen siendo los objetos nativos de Dolibarr: nada se duplica en una base aparte.
El módulo añade 13 pestañas a las fichas existentes (terceros, facturas, productos, proveedores, pedidos a proveedor, recepciones, almacenes, usuarios...) en lugar de crear pantallas aisladas.
17 permisos distintos permiten dar a cada persona exactamente lo que necesita, sin tener que abrirlo o cerrarlo todo en bloque.
Los módulos de caja (TakePOS) y de recepción (Receptions) no son obligatorios: se activan por separado según sus necesidades.

3. Tiendas, cajas y vendedores

Tres conceptos estructuran el uso diario: la tienda, la caja y el vendedor que la utiliza, con una caja pensada para ir rápido en el mostrador.

Cada tienda está vinculada a un almacén de Dolibarr: el stock del punto de venta es el stock nativo de ese almacén, no una copia aparte. Este vínculo es necesario para poder abrir una caja.
Cada caja está asociada a un número de terminal TakePOS.
Un vendedor puede estar asignado a una o varias tiendas, con un rol y una tienda por defecto. La caja solo se abre si el vendedor conectado está asignado a la tienda correspondiente.
En el mostrador, el cursor se sitúa directamente en el campo del lector de códigos y los artículos quedan ocultos tras un botón Catálogo, para no frenar la venta con escáner; la densidad de pantalla, el teclado numérico y el modo por defecto (escáner o teclado) se adaptan a cada tienda o puesto.

4. Sesiones de caja y cierres conformes a la normativa antifraude del IVA (NF525)

Cada jornada de caja se abre y se cierra en un marco trazado, pensado para resistir una inspección.

Al abrir, el vendedor declara un fondo de caja. Cada movimiento de efectivo durante el día (entrada o salida) debe justificarse y queda con fecha y hora.
Estos eventos se encadenan mediante una huella criptográfica: cada movimiento lleva el rastro del anterior, lo que hace detectable cualquier reescritura silenciosa del historial.
Al cierre, el módulo compara para cada medio de pago (efectivo, tarjeta, cheque) el importe esperado, el importe declarado y la diferencia entre ambos.
El cierre genera un archivo sellado y numerado, exportable en formato JSON. Si el módulo nativo de Dolibarr de registro inalterable (blockedlog) está activo, un cierre ya registrado no puede eliminarse: solo puede reabrirse.
Este funcionamiento responde a las exigencias de seguridad, inalterabilidad y conservación de los datos de cobro de la normativa francesa antifraude del IVA. No constituye por sí solo una certificación: supone una instalación de Dolibarr correctamente configurada y, en su caso, debidamente certificada, un trámite propio de su instalación, distinto del módulo.

5. Códigos de barras y etiquetas

Cada artículo puede llevar varios códigos, para adaptarse a lo que ya tiene en el lineal o en sus proveedores.

Código interno, EAN-8, EAN-13, UPC-A, ISBN-13, Código 128, código QR, código de proveedor: varios códigos pueden coexistir en un mismo artículo.
El dígito de control se verifica en los códigos numéricos normalizados (EAN, UPC, ISBN); los demás formatos (interno, Código 128, QR, proveedor) no están sujetos a esta verificación.
Una hoja de etiquetas se imprime directamente desde el navegador, de 1 a 100 ejemplares de un mismo código a la vez.

6. Importación del catálogo mediante archivo CSV

Para arrancar o actualizar un catálogo existente, una importación por archivo evita reintroducir cada artículo a mano.

El archivo debe respetar 11 columnas documentadas y un encabezado exactamente conforme: una columna desconocida provoca el rechazo de todo el archivo, para evitar importaciones parciales silenciosas.
Se muestra una previsualización antes de aplicar nada de forma definitiva.
La importación crea o actualiza los productos, los precios y los códigos nativos de Dolibarr. No toca el stock, ni las categorías, ni las fotos: estos elementos se siguen gestionando por separado.

7. Inventarios por tienda, con doble conteo a ciegas

El inventario se apoya en el objeto inventario nativo de Dolibarr, pero se gestiona tienda por tienda, con la opción de un doble conteo a ciegas para los casos más sensibles.

El recuento se hace con el escáner, por suma o en valor absoluto, según lo que mejor convenga a su organización. Los lotes y números de serie están admitidos.
Nada se mueve en el stock hasta el registro final del inventario: se puede contar y recontar sin riesgo.
En el doble conteo a ciegas, dos personas cuentan la misma zona sin ver la cifra introducida por la otra. Las diferencias entre ambos recuentos deben conciliarse manualmente antes de trasladarse al inventario nativo de Dolibarr: ninguna cifra se valida automáticamente.

8. Transferencias entre tiendas y recepciones de proveedor escaneadas

Mover stock de una tienda a otra pasa por una etapa de tránsito, y la recepción de un pedido a proveedor puede hacerse con el escáner.

La transferencia pasa por un almacén de tránsito dedicado. La tienda destinataria controla la mercancía a su llegada y justifica la diferencia observada, si la hay.
El excedente aún no recibido permanece visible en el stock de tránsito hasta su propio movimiento: no hay una etapa de arbitraje automático, el seguimiento queda en manos de los equipos.
La recepción puede hacerse en varias veces, por ejemplo si la mercancía llega en varios envíos o si participan varias personas.
El stock solo se mueve al validar la recepción nativa de Dolibarr, que conserva el rastro de la tienda y el almacén afectados.

9. Reaprovisionamiento por tienda

Una campaña de reaprovisionamiento calcula, tienda por tienda, lo que conviene volver a pedir.

El cálculo tiene en cuenta el stock actual, el stock en tránsito, los pedidos ya realizados por el módulo (no el conjunto de pedidos a proveedor existentes), la venta media diaria observada en caja, así como el plazo de entrega y el tamaño de los lotes tomados de las tarifas de proveedor nativas.
Cada línea propuesta se puede modificar o descartar, siempre indicando un motivo.
Los pedidos a proveedor nativos se crean agrupados por proveedor, y se dejan en borrador para su validación.

10. Devoluciones de clientes y abonos

Una devolución siempre parte de una factura ya validada, nunca de una introducción libre.

Esta función supone un Dolibarr en el que el stock se descuenta al facturar (parámetro nativo STOCK_CALCULATE_ON_BILL), de la misma forma que la venta en caja supone TakePOS: una condición anunciada, no oculta.
El módulo comprueba el saldo que todavía se puede devolver antes de aceptar la devolución.
Se crea y valida un abono nativo de Dolibarr, vinculado a la devolución, sin modificar nunca la factura de origen.
El artículo vuelve al lineal o pasa a cuarentena, según un motivo que se escribe cada vez.

11. Programa de fidelización y tarjetas regalo

El programa de fidelización se apoya en las cuentas de sus clientes ya presentes en Dolibarr, y se completa con tarjetas regalo para las ventas puntuales.

Las cuentas de fidelización se adosan a los terceros nativos, no a una base de clientes separada.
El abono de puntos es una acción manual, realizada desde la ficha del cliente, según una escala que usted mismo configura: no es automático en cada factura pagada.
Los puntos se convierten en un descuento fijo nativo de Dolibarr, nunca en un medio de pago paralelo. Tienen una fecha de caducidad, que se trata mediante una acción específica, no por una tarea programada automática.
Cada tarjeta regalo tiene un saldo y un historial de movimientos consultable. El código de la tarjeta solo se muestra una vez, en el momento de su creación; después se conserva en forma de huella, nunca en texto claro.

12. Promociones y descuentos dirigidos

Las promociones se configuran con precisión, para dirigirse exactamente a lo que quiere destacar.

Porcentaje de descuento, fechas de validez, cantidad mínima, prioridad entre reglas, segmentación por tienda, por producto, por categoría de producto o por categoría de cliente.
Cuando varias reglas son aplicables, solo se retiene la más ventajosa.
Un descuento manual más favorable introducido en caja siempre se conserva: nunca lo sobrescribe una promoción automática. Cada aplicación de una promoción queda registrada.

13. Venta en línea y conectores omnicanal

KSIRetail puede comunicarse con una tienda en línea u otro canal de venta, sin que sus datos salgan de su instalación de Dolibarr.

Se ofrecen tres servicios: recibir un pedido, devolver su estado y publicar el stock disponible de una tienda.
Los pedidos procedentes de la web llegan como pedidos nativos de Dolibarr en borrador, con recogida en tienda o entrega según el caso. Si una tienda envía dos veces el mismo pedido, solo se procesa una vez.
En caso de conflicto, el pedido se pone en cuarentena y se registra en un diario de sincronización, para su tratamiento manual.
El stock publicado corresponde al stock nativo, reducido por un margen de seguridad y las cantidades ya reservadas. Cada conector tiene su propia cuenta interna, para conservar la trazabilidad de quién hizo qué. Esta función supone que el módulo nativo de API REST de Dolibarr esté activo.

14. Panel de control

Novedad de la versión 0.5.4, un panel de control ofrece de un vistazo una visión de conjunto de la actividad.

Ventas del día, cajas actualmente abiertas, facturación del mes, impagados, lista de tiendas y de cuentas de fidelización.
Un gráfico de actividad de 6 meses cruza la facturación y las ventas cobradas.
Las promociones en curso y el resumen del día (presupuestos pendientes, facturas sin pagar) completan la vista.

15. Compatibilidad e idiomas

KSIRetail está diseñado para integrarse de forma duradera en su instalación, sea cual sea su versión o su idioma de trabajo.

Compatible con las versiones de Dolibarr de la v18 a la v24.
Disponible en 5 idiomas, con alrededor de 650 claves de traducción por idioma: ningún texto queda fijado en el código.
Aparte de los tres servicios de intercambio con una tienda en línea, el módulo no realiza ninguna llamada de red saliente por sí mismo: sus datos permanecen en su instalación de Dolibarr.

16. Vínculos con Dolibarr

El módulo no funciona de forma aislada: se integra con los bloques nativos de Dolibarr.

Terceros : Las cuentas de fidelización y las tarjetas regalo se adosan a las fichas de terceros nativas, sin una base de clientes separada.
Productos y servicios : Los artículos vendidos en tienda siguen siendo los productos y servicios nativos de Dolibarr, con sus códigos de barras y sus precios.
Stocks y almacenes : Cada tienda está vinculada a un almacén nativo: el stock del punto de venta es el stock de Dolibarr, no una copia.
Facturas : Las ventas cobradas se registran como facturas nativas; las devoluciones siempre parten de una factura ya validada.
Abonos : Una devolución aceptada crea y valida un abono nativo de Dolibarr, vinculado a la devolución, sin modificar la factura de origen.
Pedidos a proveedor : El reaprovisionamiento crea pedidos a proveedor nativos, agrupados por proveedor y dejados en borrador.
Recepciones : La recepción escaneada valida una recepción nativa de Dolibarr, que conserva el rastro de la tienda y el almacén.
API REST : Los intercambios con una tienda en línea pasan por el módulo nativo de API REST de Dolibarr.