Compras y stock

Venta en depósito

dolixdepotvente · versión 1.0.4

Para cada depositante, usted ve lo que se ha vendido y su comisión, y la liquidación prepara las facturas en borrador.

Precio
49 € sin IVA
Dolibarr
19.0 mínimo
Versión
1.0.4
Licencia
GPL v3+
Idiomas
Francés, inglés, alemán, español

49 € sin IVA.

El pedido, el pago, la factura y la descarga corren a cargo del DoliStore.

Comprar en el DoliStore — 49 € sin IVA

Pruébelo sin instalar nada: la demo en línea (usuario demo, contraseña demo; datos ficticios, que se restablecen cada noche; la demo está en francés).

Productos → Dépôt-vente (venta en depósito), pestaña «Ventes à régler» (ventas por liquidar) a 12/10/2026: para tres depositantes, las líneas, la cantidad vendida, las ventas sin IVA y con IVA, la comisión y el importe debido al depositante, con un botón «Établir le relevé» (crear la liquidación) por depositante.
ProductosDépôt-vente (venta en depósito), pestaña «Ventes à régler» (ventas por liquidar) a 12/10/2026: para tres depositantes, las líneas, la cantidad vendida, las ventas sin IVA y con IVA, la comisión y el importe debido al depositante, con un botón «Établir le relevé» (crear la liquidación) por depositante. Captura de la interfaz en francés.
01

Lo que hace el módulo

  • Un campo «Depositante (venta en depósito)» en cada producto: el tercero al que pertenece. Si está vacío, el producto es un producto normal y el módulo lo ignora.
  • Porcentaje de comisión: el del producto si está indicado; si no, el del depositante; si no, el porcentaje por defecto del módulo. La comisión se calcula sobre las ventas sin IVA o con IVA, a elegir.
  • Las ventas se leen en las facturas a cliente validadas, tickets de caja TakePOS incluidos. Los abonos y las líneas negativas se descuentan; las facturas en borrador, las facturas reemplazadas y los anticipos se ignoran.
  • ProductosVenta en depósito, pestaña «Ventas por liquidar»: por depositante, el número de líneas, la cantidad vendida, las ventas sin IVA y con IVA, la comisión y el importe debido al depositante, hasta la fecha elegida, con un total.
  • «Crear la liquidación» recoge todas las ventas del depositante todavía no liquidadas hasta esa fecha, incluida una factura más antigua validada con retraso. La liquidación recibe una referencia DVyymm-NNNN.
  • Modo «dos facturas», por defecto: la factura de proveedor del depositante, una línea por producto, y la factura de su comisión dirigida al depositante. Modo «una factura»: la factura de proveedor por las ventas menos la comisión. Todo se crea en borrador.
  • Cada línea de factura vendida se liquida una sola vez: una clave única en la base de datos lo garantiza, incluso si se crean dos liquidaciones al mismo tiempo.
  • Ficha de la liquidación: depositante, periodo, modo, enlaces a las facturas con su estado, detalle de cada venta (fecha, factura, producto, cantidad, importes, porcentaje, comisión) e importe debido al depositante. Vista de impresión.
  • Una liquidación puede eliminarse mientras sus facturas estén en borrador: se eliminan con ella y sus ventas vuelven a quedar por liquidar. Si una factura está validada, la eliminación se rechaza.
  • Pestaña «Depósito» en la ficha del depositante: sus productos con precio de venta, stock y porcentaje, sus ventas por liquidar a fecha de hoy y sus liquidaciones.
  • Si el país de su empresa no está configurado, la página lo indica: sin él, Dolibarr no propone ningún IVA en las facturas de la liquidación.
02

Para quién es

En una tienda de productores o de artesanos, los productos en depósito pertenecen a sus depositantes. Dolibarr los vende sin dificultad, pero no le dice lo que se ha vendido de cada uno: la liquidación, la comisión y las facturas se hacen con una hoja de cálculo.

Tienda de productores, tienda de artesanos, comercio de proximidad: los productos en depósito pertenecen a sus depositantes. A final de mes, hay que saber lo que se ha vendido de cada uno, calcular su comisión y emitir las facturas.

Dolibarr vende estos productos sin dificultad, por factura o en la caja TakePOS, pero no hace esta liquidación. Se hace con una hoja de cálculo, o mediante un script.

Para quién es: Tiendas de productores, tiendas de artesanos, comercios de proximidad y tiendas asociativas que venden productos en depósito y reembolsan las ventas a sus depositantes.

03

Lo que el módulo no hace

Este apartado figura en las 21 fichas de módulos, sin excepción.

  • No hay stock separado para los productos del depositante: el stock sigue siendo el de Dolibarr, y las entradas y devoluciones de mercancía pasan por los movimientos de stock habituales.
  • No hay pago automático al depositante: las facturas de la liquidación se pagan como cualquier factura.
  • No hay régimen especial de bienes de ocasión (régimen del margen).
  • El módulo no valida ninguna factura. Su IVA es el que propone Dolibarr; el régimen de IVA de su actividad de venta en depósito debe consultarse con su asesor contable.
  • La factura de comisión lleva una sola línea, al tipo de IVA que Dolibarr propone por defecto para su empresa.
  • Un solo depositante por producto.
  • Los PDF y la importación de datos no se han probado. Las pruebas se hicieron con MariaDB y PHP 8.2; PostgreSQL no se ha probado.
  • En Dolibarr 21, la exportación CSV de productos y terceros muestra la clave DolDvFieldCommission como cabecera de columna en lugar de la etiqueta: el núcleo de la versión 21 no traduce estas cabeceras. Está corregido en el núcleo a partir de la versión 22.
  • La pestaña «Liquidaciones» muestra las 500 liquidaciones más recientes.
04

Cómo funciona

El depositante y la comisión

El depositante es un tercero proveedor. El módulo añade:

  • en cada producto, un campo «Depositante (venta en depósito)»: el tercero al que pertenece. Si está vacío, el producto es un producto normal y el módulo lo ignora;
  • en el producto y en el tercero, un campo «Comisión de venta en depósito (%)».

El porcentaje aplicado es el del producto si está indicado; si no, el del depositante; si no, el porcentaje por defecto del módulo. La comisión se calcula sobre las ventas sin IVA o con IVA, a elegir.

Las ventas por liquidar

Las ventas se leen en sus facturas a cliente validadas, tickets de caja TakePOS incluidos.

  • Los abonos y las líneas negativas se descuentan, en cantidad, en importe y en comisión.
  • Las facturas en borrador, las facturas reemplazadas y los anticipos se ignoran.

ProductosVenta en depósito, pestaña «Ventas por liquidar»: para cada depositante, el número de líneas, la cantidad vendida, las ventas sin IVA y con IVA, la comisión y el importe debido al depositante (sin IVA), hasta la fecha elegida, con un total.

La liquidación

El botón «Crear la liquidación» recoge todas las ventas del depositante todavía no liquidadas hasta esa fecha, incluida una factura más antigua validada con retraso. La liquidación recibe una referencia DVyymm-NNNN y crea, en borrador:

  • en modo «dos facturas» (por defecto): la factura de proveedor del depositante, una línea por producto, y la factura de su comisión dirigida al depositante;
  • en modo «una factura»: la factura de proveedor del depositante por sus ventas menos la comisión.

Nada se valida automáticamente: usted revisa las facturas y después las valida.

La ficha de la liquidación detalla cada venta —fecha, factura, producto, cantidad, importes, porcentaje, comisión— e indica el importe debido al depositante. Se puede imprimir. Mientras sus facturas estén en borrador, la liquidación puede eliminarse: sus facturas se eliminan con ella y sus ventas vuelven a quedar por liquidar.

En la ficha del depositante, la pestaña «Depósito» muestra sus productos (precio de venta, stock, porcentaje), sus ventas por liquidar a fecha de hoy y sus liquidaciones.

Una venta solo se liquida una vez

Cada línea de factura vendida se registra con la liquidación que la liquida. Una clave única en la base de datos impide registrarla una segunda vez, incluso si se crean dos liquidaciones al mismo tiempo. Una factura antigua validada después de una liquidación no se pierde: la siguiente liquidación la recoge.

El IVA

Las facturas se crean con el IVA que propone Dolibarr: tipo del producto, depositante sujeto o no al IVA. Un depositante no sujeto al IVA recibe una factura de proveedor sin IVA. La factura de comisión lleva una sola línea, al tipo que Dolibarr propone por defecto para su empresa.

El régimen de IVA de la venta en depósito (mandato, comisión, bienes de ocasión) depende de su actividad y de su contrato: consúltelo con su asesor contable antes de validar las facturas.

El país de su empresa debe estar configurado: sin él, Dolibarr no propone ningún IVA, y la página del módulo lo indica.

ProductosDépôt-vente (venta en depósito), pestaña «Ventes à régler» (ventas por liquidar), a 12/10/2026, en una tienda de productores ficticia: tres depositantes, con para cada uno las líneas, la cantidad vendida, las ventas sin IVA y con IVA, la comisión y el importe debido, y un botón «Établir le relevé» (crear la liquidación). Bajo la tabla, el recordatorio del modo «dos facturas».

La ficha de la liquidación DV2610-0001 de Ferme du Bois Joli, en Dolibarr 24.0.1: periodo del 17/09 al 12/10/2026, modo «dos facturas», factura de proveedor y factura de comisión en borrador. El detalle tiene cinco líneas, entre ellas un abono (cantidad −1) descontado con su comisión. Debido al depositante: 171,38 € sin IVA.

Ficha de la liquidación DV2610-0001 del depositante Ferme du Bois Joli, en Dolibarr 24.0.1: las dos facturas en borrador, el detalle de cada venta —incluido un abono (cantidad −1)— y el importe debido al depositante, 171,38 € sin IVA.
Ficha de la liquidación DV2610-0001 del depositante Ferme du Bois Joli, en Dolibarr 24.0.1: las dos facturas en borrador, el detalle de cada venta —incluido un abono (cantidad −1)— y el importe debido al depositante, 171,38 € sin IVA. Captura de la interfaz en francés.
05

Ajustes

La página de configuración del módulo está reservada a los administradores. Recuerda la puesta en marcha en cuatro pasos y el tratamiento del IVA.

Ajuste Por defecto Efecto
Porcentaje de comisión por defecto 0 % Se usa cuando ni el producto ni el depositante tienen porcentaje propio. Limitado entre 0 y 100.
Comisión calculada sobre las ventas sin IVA O las ventas con IVA.
Documentos creados por la liquidación dos facturas O una factura de proveedor neta de la comisión.
06

Seguridad y salvaguardas

  • Dos permisos propios, no concedidos por defecto: «Ver las ventas en depósito» abre el menú, la pestaña y las liquidaciones; «Crear y eliminar las liquidaciones de venta en depósito» muestra los botones.
  • Además, los permisos de Dolibarr: crear una liquidación exige también el permiso de crear facturas de proveedor y, en modo «dos facturas», el de crear facturas a cliente. Una petición enviada sin estos permisos es rechazada por el servidor.
  • La pestaña del depositante solo se abre en un tercero al que el usuario tiene acceso.
  • Comerciales limitados a sus depositantes: sin el permiso de Dolibarr para ver todos los terceros, un usuario solo ve, crea y elimina las liquidaciones de los depositantes de los que es el comercial asignado, como en las listas de Dolibarr; una petición falsificada es rechazada.
  • Eliminar una liquidación elimina sus facturas en borrador: también hacen falta los permisos que Dolibarr exige para eliminar esas facturas; si no, la liquidación se conserva y un mensaje lo indica.
  • Transacciones: una liquidación se crea en una sola transacción; si un paso falla, no se registra nada.
  • Eliminación controlada: se pide confirmación, y la eliminación se rechaza si una factura de la liquidación ya está validada.
  • Los formularios llevan el token anti-CSRF de Dolibarr; la página de configuración lo exige.
07

Lo que se entrega

Lo que el módulo escribe en su instalación
Tablas creadas en la base de datosDos tablas: llx_dolixdv_releve, una fila por liquidación (referencia, depositante, periodo, modo, totales, comisión, facturas creadas, autor, fecha), y llx_dolixdv_line, una fila por venta liquidada, con una clave única sobre la línea de factura para que una venta nunca se liquide dos veces. Tres campos adicionales: «Depositante (venta en depósito)» y «Comisión de venta en depósito (%)» en los productos, «Comisión de venta en depósito (%)» en los terceros. Tres ajustes guardados como constantes de Dolibarr: DOLIXDV_DEFAULT_COMMISSION, DOLIXDV_COMMISSION_BASE y DOLIXDV_MODE.
PermisosDos permisos: «Ver las ventas en depósito» abre el menú, la pestaña y las liquidaciones; «Crear y eliminar las liquidaciones de venta en depósito» muestra los botones. Para crear una liquidación, el usuario necesita también el permiso de Dolibarr de crear facturas de proveedor y, en modo «dos facturas», de crear facturas a cliente. La pestaña del depositante solo se abre en un tercero al que el usuario tiene acceso. Un comercial sin el permiso de ver todos los terceros solo ve y liquida los depositantes de los que es el comercial asignado. Eliminar una liquidación exige también los permisos de Dolibarr para eliminar sus facturas en borrador. La página de configuración está reservada a los administradores.
Desinstalación
  • Desactive el módulo en ConfiguraciónMódulos. El menú y la pestaña desaparecen.
  • Las facturas creadas por las liquidaciones son facturas normales de Dolibarr: se conservan, sea cual sea su estado.
  • Las tablas llx_dolixdv_releve y llx_dolixdv_line, los tres campos adicionales con sus valores y los ajustes del módulo no se eliminan.

La carpeta dolixdepotvente, en PHP legible, bajo licencia GPL v3 o posterior: el descriptor del módulo, la página de ventas por liquidar y de liquidaciones, la ficha de la liquidación, la pestaña del depositante, la página de configuración, la clase de cálculo, los archivos SQL de las dos tablas y los iconos.

  • Idiomas: francés (fr_FR), inglés (en_US), alemán (de_DE) y español (es_ES).
  • Un README.md (en francés) que describe el funcionamiento, el IVA, los ajustes y los límites.
  • Un ChangeLog.md.
  • Se añaden dos tablas: llx_dolixdv_releve, una fila por liquidación (referencia, depositante, periodo, modo, totales, comisión, facturas creadas, autor, fecha), y llx_dolixdv_line, una fila por venta liquidada, con una clave única sobre la línea de factura.
  • Tres campos adicionales: «Depositante (venta en depósito)» y «Comisión de venta en depósito (%)» en los productos, «Comisión de venta en depósito (%)» en los terceros.
  • Lo que escribe una liquidación: una fila en llx_dolixdv_releve, una fila por venta liquidada en llx_dolixdv_line, y las facturas en borrador, creadas por las clases del núcleo. Las facturas a cliente vendidas no se modifican.
  • Tres ajustes, guardados como constantes de Dolibarr: DOLIXDV_DEFAULT_COMMISSION, DOLIXDV_COMMISSION_BASE y DOLIXDV_MODE.
  • No se modifica ningún archivo de Dolibarr. Ninguna conexión saliente.
  • Al desactivarlo, el menú y la pestaña desaparecen. Las facturas creadas se conservan: son facturas normales de Dolibarr. Las dos tablas, los campos con sus valores y los ajustes no se eliminan.
08

Compatibilidad

El descriptor del módulo solo declara una versión mínima. En el código no figura ningún límite superior: las versiones siguientes son aquellas en las que el módulo se ha ejecutado de verdad.

Compatibilidad del módulo Venta en depósito
Versiones de DolibarrDolibarr 19.0 mínimo. Instalado y probado en 19.0.4, 20.0.4, 21.0.4, 22.0.5, 23.0.4, 24.0.1 y 24.0.2.
PHP mínimo7.4
Módulos de Dolibarr que activarTerceros, Productos, Facturas y abonos, Proveedores
LicenciaGPL v3 o posterior, código fuente completo
IdiomasFrancés, inglés, alemán, español
MenúMenú Productos«Venta en depósito» (ventas por liquidar y liquidaciones). Pestaña «Depósito» en la ficha de tercero del depositante.
09

Instalación

  1. Obtenga el módulo en el DoliStore y descargue el archivo zip.
  2. En Dolibarr: InicioConfiguraciónMódulospestaña «Instalar módulo externo», y suba el zip. Si no, descomprima la carpeta dolixdepotvente en htdocs/custom/.
  3. Active «Venta en depósito» en la lista de módulos. Necesita los módulos Terceros, Productos, Facturas y abonos y Proveedores. Las dos tablas y los tres campos adicionales se crean en ese momento.
  4. Conceda los permisos «Ver las ventas en depósito» y «Crear y eliminar las liquidaciones de venta en depósito». Para crear una liquidación, los usuarios necesitan también los permisos de Dolibarr para crear facturas de proveedor y, en modo «dos facturas», facturas a cliente.
  5. En la página de configuración del módulo: porcentaje de comisión por defecto, comisión calculada sobre las ventas sin IVA o con IVA, documentos creados por la liquidación.
  6. Cree cada depositante como tercero proveedor e indique su porcentaje de comisión en su ficha; después elija el depositante en cada producto en depósito.

El detalle — permisos de la carpeta custom, alojamiento compartido, actualizaciones, desinstalación — está en la página Instalación y actualizaciones.

10

Preguntas frecuentes

¿En qué versiones de Dolibarr funciona este módulo?

El descriptor exige Dolibarr 19.0 como mínimo y PHP 7.4 como mínimo. La versión 1.0.4 se ha instalado desde su zip y su prueba de integración (32 comprobaciones) pasa en 19.0.4, 20.0.4, 21.0.4, 22.0.5, 23.0.4, 24.0.1 y 24.0.2, con MariaDB; la versión 1.0.1 también se había probado como actualización desde la 1.0.0. Si tiene alguna duda, escriba antes de comprar.

¿El módulo valida las facturas por mí?

No. La liquidación crea sus facturas en borrador: usted las revisa, las modifica si hace falta y después las valida usted mismo. Mientras estén en borrador, puede eliminar la liquidación; sus ventas vuelven entonces a quedar por liquidar.

¿Cómo se gestiona el IVA?

Las facturas se crean con el IVA que propone Dolibarr: tipo del producto, depositante sujeto o no al IVA. Un depositante no sujeto al IVA recibe una factura de proveedor sin IVA. El régimen de IVA de la venta en depósito (mandato, comisión, bienes de ocasión) depende de su actividad y de su contrato: consúltelo con su asesor contable antes de validar las facturas. El país de su empresa debe estar configurado; si no, la página lo indica.

¿Puede liquidarse una venta dos veces?

No. Cada línea de factura vendida se registra con la liquidación que la liquida, y una clave única en la base de datos impide registrarla una segunda vez. Una factura antigua validada después de una liquidación no se pierde: la siguiente liquidación la recoge.

¿Cómo se gestionan las devoluciones?

Un abono sobre un producto en depósito se descuenta de las ventas del depositante, en cantidad, en importe y en comisión. Una línea negativa en una factura se trata de la misma manera.

Tengo la 1.0.0: ¿qué cambia la actualización?

La 1.0.1 corrige un problema de visualización en Dolibarr 19 (véase el historial de versiones). Basta con sustituir los archivos del módulo, sin volver a activarlo: el depositante de cada producto y los porcentajes de comisión ya introducidos se conservan. Se ha comprobado en 19.0.4, 20.0.4, 21.0.4, 22.0.5, 23.0.4 y 24.0.2.

¿Y si lo desinstalo?

El menú y la pestaña desaparecen. Las facturas creadas por las liquidaciones se conservan: son facturas normales de Dolibarr. Las tablas de liquidaciones, los campos adicionales con sus valores y los ajustes también se conservan.

¿Quién se encarga del soporte y cómo funcionan las actualizaciones?

El soporte lo presta la persona que escribió el módulo, en support@dolix.fr. El pedido, el pago, la factura y la descarga corren a cargo del DoliStore, donde se publican las nuevas versiones.

11

Historial de versiones

Tomado del archivo ChangeLog.md del módulo: una sola fuente.

1.0.43 de noviembre de 2026

Interfaz traducida al español (es_ES). Probado en 19.0.4 a 24.0.2 con Dolibarr en español.

1.0.326 de octubre de 2026

Permisos de Dolibarr respetados: eliminar una liquidación elimina sus facturas en borrador; ahora hacen falta, además del permiso del módulo, los permisos que Dolibarr exige para eliminar esas facturas (según la versión de Dolibarr, el permiso de crear basta para un borrador, como en la ficha de la factura). Si no, la liquidación no se elimina y un mensaje lo indica. Probado en 19.0.4 a 24.0.2.

1.0.225 de octubre de 2026

Permisos de Dolibarr respetados: «Sales to settle», la lista y la ficha de las liquidaciones ya solo afectan a los depositantes que el usuario puede ver en Dolibarr (comercial sin el permiso de ver todos los terceros: los terceros de los que es el comercial asignado; usuario externo: su empresa); ya no se puede crear, abrir ni eliminar una liquidación para otro depositante, ni siquiera con una petición falsificada. La pestaña del depositante ya aplicaba este control. Probado en 19.0.4 a 24.0.2.

1.0.125 de octubre de 2026

Corrección para Dolibarr 19: una vez activado el módulo, las fichas y listas de productos y de terceros se detenían a mitad de la visualización, porque la etiqueta «Consignment commission (%)» contiene un «%» que Dolibarr interpreta como código de formato. Ahora está protegido en los tres idiomas. Los campos ya creados por la 1.0.0 se corrigen con la simple actualización de los archivos, sin modificar los datos. Probado en 19.0.4, 20.0.4, 21.0.4, 22.0.5, 23.0.4 y 24.0.2.

1.0.012 de octubre de 2026

Primera versión: campo «Consignor» y porcentaje de comisión en los productos, porcentaje de comisión en los terceros. Ventas por liquidar por depositante tomadas de las facturas a cliente validadas y de la caja, abonos descontados, facturas reemplazadas y anticipos ignorados. Liquidación de todas las ventas no liquidadas hasta una fecha, cada venta liquidada una sola vez, facturas en borrador (factura de proveedor del depositante y factura de comisión, o factura de proveedor neta). Ficha de la liquidación, impresión, eliminación mientras las facturas estén en borrador, pestaña en la ficha del depositante. Interfaz en francés, inglés y alemán.

12

Soporte de este módulo

Escriba a support@dolix.fr. Responde la persona que escribió el módulo.

Respuesta en un plazo de dos días laborables. No es un servicio de guardia.

Qué incluir en su mensaje

  • La versión exacta de Dolibarr.
  • El módulo afectado y su versión — aquí dolixdepotvente 1.0.4.
  • Lo que ha hecho, y lo que esperaba.
  • El mensaje de error copiado tal cual, o una captura de pantalla.
  • Cómo está instalado Dolibarr, si lo sabe.

Este módulo está a la venta en el DoliStore.

El pedido, el pago, la factura y la descarga corren a cargo del DoliStore.

Comprar en el DoliStore — 49 € sin IVA
También

Los demás módulos