Margen por día
margeparjour · v1.0.1
Usted ve lo que aporta una jornada de trabajo antes de aceptar el presupuesto.
Compras y stock
Envases retornables
dolixconsignes · versión 1.0.2
Usted ve cuántos barriles, cajas o palés retornables tiene cada cliente, cuánto valen esas fianzas y cuáles no han vuelto a tiempo.
59 € sin IVA.
El pedido, el pago, la factura y la descarga corren a cargo del DoliStore.
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).
01
Lo que hace el módulo
- Dos campos en la ficha del producto: «Envase retornable», una casilla, y «Plazo de devolución (días)». Un plazo vacío toma el plazo por defecto del módulo.
- El registro se llena a partir de las facturas a clientes: al validar, cada línea facturada de un envase retornable cuenta los envases en el cliente. Una línea negativa, en cantidad o en precio, en una factura posterior, o una línea de abono, los cuenta como devueltos.
- El registro sigue la factura: los movimientos se retiran si vuelve a borrador o se elimina, y se vuelven a crear cuando se valida de nuevo. Una factura sustituida por una factura rectificativa deja de contar. Las facturas de depósito (anticipos) se ignoran.
- Una pestaña «Envases retornables» en la ficha del tercero: para cada envase, la cantidad en el cliente, el valor de las fianzas, la entrega no devuelta más antigua, el plazo y la cantidad con retraso; y después el historial de movimientos, con un enlace a cada factura.
- Una vista de conjunto en el menú Productos: todos los clientes que tienen envases, un filtro por envase, la casilla «Solo envases atrasados» y una línea de total.
- Primero en salir, primero en volver: las devoluciones saldan primero las entregas más antiguas. Un envase está con retraso cuando lleva en el cliente más tiempo que su plazo de devolución.
- Introducción manual en la pestaña: «Saldo inicial» para los envases que ya estaban en el cliente antes del módulo, «Corrección» para una diferencia de inventario. Un producto no marcado como «Envase retornable» se rechaza.
- El botón «Considerar los atrasados como vendidos», tras confirmación, saca los envases con retraso del saldo del cliente y los anota en el informe «Considerados como vendidos»: fecha, cliente, envase, cantidad, valor, nota, en el periodo elegido. No se crea ninguna factura.
- «Reconstruir el registro a partir de las facturas», en la página de configuración, vuelve a leer las facturas y abonos validados que contienen envases retornables, por ejemplo después de marcar un producto. Los saldos iniciales, las correcciones y los envases considerados vendidos se conservan.
- Un saldo negativo, más envases devueltos que facturados, se señala en la pestaña con una alerta: compruebe el saldo inicial o las facturas.
02
Para quién es
Una cervecera, un distribuidor de bebidas o un proveedor que entrega en palés cobra una fianza y la devuelve cuando vuelven los envases. Dolibarr factura y reembolsa, pero no dice cuántos envases tiene todavía cada cliente, ni desde cuándo.
Una cervecera, un distribuidor de bebidas o un proveedor que entrega en palés cobra una fianza con sus productos, y la devuelve cuando los envases vuelven.
Dolibarr factura y reembolsa sin ninguna dificultad, pero no dice cuántos envases tiene todavía cada cliente, ni desde cuándo.
Para quién es: Cerveceras, distribuidores de bebidas, proveedores que entregan en palés, y cualquier empresa que cobre una fianza por barriles, cajas, botellas o palés y la devuelva a su retorno.
03
Lo que el módulo no hace
Este apartado figura en las 21 fichas de módulos, sin excepción.
- Ningún seguimiento del stock físico de envases vacíos: el stock de Dolibarr sigue siendo el de sus movimientos de stock.
- Ningún seguimiento de los envases retornables recibidos de sus proveedores: solo se leen las facturas y abonos a clientes.
- Ningún asiento contable automático para los envases considerados vendidos: el informe está pensado para el asesor contable, y no se crea ninguna factura.
- El módulo no fija ningún tipo de IVA ni elige el tratamiento fiscal de la fianza: se aplica el tipo del producto envase.
- Solo se cuentan las líneas con un producto marcado como «Envase retornable». Una línea libre, sin producto, no.
- Ninguna introducción de devolución aparte: una devolución pasa por una línea negativa en una factura o por un abono. La introducción manual está reservada al saldo inicial y a las correcciones.
- Un plazo de devolución por envase, sin plazo propio de un cliente.
- La pestaña del tercero muestra los 200 movimientos más recientes.
04
Cómo funciona
El módulo lleva un registro de los envases retornables por cliente, a partir de sus facturas y abonos a clientes. No hay doble introducción: usted factura y reembolsa la fianza como de costumbre.
En los productos
Se añaden dos campos a la ficha del producto:
- «Envase retornable», una casilla, para los barriles, cajas, botellas, palés… cuya fianza se factura y se reembolsa a la devolución;
- «Plazo de devolución (días)», el plazo habitual en su sector. Si está vacío, se aplica el plazo por defecto del módulo.
El registro sigue sus facturas
- Factura validada: los envases retornables facturados se cuentan en el cliente.
- Línea negativa (en cantidad o en precio) en la factura siguiente, o abono: se cuentan como devueltos.
- Factura devuelta a borrador o eliminada: sus movimientos se retiran, y se vuelven a crear cuando se valida de nuevo.
- Factura sustituida por una factura rectificativa: deja de contar, solo cuenta la factura rectificativa.
- Las facturas de depósito (anticipos) se ignoran.
Primero en salir, primero en volver
Las devoluciones saldan primero las entregas más antiguas. Un envase está con retraso cuando lleva en el cliente más tiempo que su plazo de devolución. Con un plazo de 0, no se señala ningún retraso.
En la ficha del cliente
La pestaña «Envases retornables» de la ficha del tercero muestra, para cada envase: la cantidad en el cliente, el valor de las fianzas, la entrega no devuelta más antigua, el plazo y la cantidad con retraso. Debajo, el historial de movimientos, con un enlace a cada factura. Un saldo negativo (más envases devueltos que facturados) se señala con una alerta.
La vista de conjunto
En el menú Productos«Envases retornables»: todos los clientes que tienen envases, un filtro por envase, la casilla «Solo envases atrasados» y una línea de total.
Introducción manual
En la pestaña del cliente:
- «Saldo inicial»: los envases que ya estaban en el cliente antes de instalar el módulo. La fecha introducida cuenta para el retraso.
- «Corrección»: una diferencia de inventario, positiva o negativa.
Un producto no marcado como «Envase retornable» se rechaza. Las ventas y devoluciones del día a día pasan por las facturas y los abonos.
Envases no devueltos
El botón «Considerar los atrasados como vendidos», tras confirmación, saca los envases con retraso del saldo del cliente y los anota en el informe «Considerados como vendidos»: fecha, cliente, envase, cantidad, valor, nota, en el periodo elegido. Este informe está pensado para el asesor contable.
No se crea ninguna factura: el cliente ya ha pagado la fianza. Es un asiento contable que hay que registrar.
El IVA
El módulo no fija ningún tipo: usa el que usted elija en el producto envase.
Según la doctrina fiscal francesa (BOFiP BOI-TVA-SECT-90-30 §§ 30-40, CGI art. 267 III), la fianza puede excluirse de la base imponible del IVA si no se factura el IVA y el envase se devuelve en el plazo habitual del sector; pasado ese plazo, el envase no devuelto se considera vendido al precio de la fianza. Compruébelo con su asesor contable.
La vista de conjunto, en Dolibarr 24.0.1: seis líneas de cliente y envase. Le Comptoir des Halles tiene 5 barriles FUT-INOX-30L (150,00 de fianzas), 1 de ellos con retraso; Cave du Vieux Port, 18 cajas, 8 de ellas con retraso. Total: 37 envases, 406,00, de los cuales 12 con retraso por 106,00.
La pestaña «Emballages consignés» de Le Comptoir des Halles: 5 barriles (plazo de 90 días) y 1 palé (plazo de 60 días), cada uno con 1 envase con retraso y el botón «Considérer les retards comme vendus» (Consider overdue as sold). Debajo, la introducción manual, y después los movimientos: 6 barriles y 1 palé facturados el 05/05/2026 en FA2605-0022, 4 barriles facturados y 5 reembolsados el 02/09/2026 en FA2609-0023.
05
Ajustes
La página de configuración del módulo está reservada a los administradores.
| Ajuste | Por defecto | Efecto |
|---|---|---|
| Plazo de devolución por defecto | 0: ningún retraso señalado | Se usa para los envases sin plazo propio. |
La misma página recuerda los tres pasos de puesta en marcha, contiene el botón «Reconstruir el registro a partir de las facturas» y el recordatorio sobre el IVA. La reconstrucción vuelve a leer todas las facturas y abonos validados que contienen envases retornables y vuelve a crear sus movimientos. Los saldos iniciales, las correcciones y los envases considerados vendidos se conservan.
06
Seguridad y salvaguardas
- Dos permisos propios, no concedidos por defecto: «Ver los envases retornables» abre el menú, la vista de conjunto, el informe y la pestaña; «Registrar movimientos y liquidar los envases no devueltos» muestra la introducción manual y el botón de regularización.
- Escritura rechazada sin el segundo permiso, incluso con una petición manipulada: no se crea ningún movimiento.
- La pestaña aplica el control de acceso de Dolibarr sobre el tercero mostrado.
- Comerciales limitados a sus clientes: sin el permiso de Dolibarr para ver todos los terceros, un usuario solo ve en la vista de conjunto y en el informe los clientes de los que es el comercial asignado, como en los listados de Dolibarr.
- Confirmación antes de considerar vendidos unos envases.
- Configuración reservada a los administradores, con token anti-CSRF al guardar.
- Reconstrucción en una sola transacción: si falla por el camino, no se cambia nada.
07
Lo que se entrega
| Tablas creadas en la base de datos | Una tabla: llx_dolixconsignes_mvt. Guarda una fila por movimiento de envase: cliente, producto envase, cantidad con signo (+ en el cliente, − devuelto o considerado vendido), valor de la fianza, tipo (factura, abono, saldo inicial, corrección, considerado vendido), fecha, factura y línea de origen, nota, usuario, entidad. Se añaden dos campos a los productos (dolixcons_consigne y dolixcons_delai), y el plazo de devolución por defecto se guarda como constante de Dolibarr: DOLIXCONS_DEFAULT_DELAY. |
|---|---|
| Permisos | Dos permisos, no concedidos por defecto: «Ver los envases retornables» abre el menú, la vista de conjunto, el informe «Considerados como vendidos» y la pestaña del tercero; «Registrar movimientos y liquidar los envases no devueltos» muestra la introducción manual y el botón «Considerar los atrasados como vendidos». La pestaña aplica además el control de acceso de Dolibarr sobre el tercero. La vista de conjunto y el informe solo muestran los clientes que el usuario puede ver en Dolibarr: un comercial sin el permiso para ver todos los terceros solo ve sus propios clientes. La página de configuración está reservada a los administradores. |
| Desinstalación |
|
La carpeta dolixconsignes, en PHP legible, con licencia GPL v3 o posterior: el descriptor del
módulo, el disparador sobre las facturas, la clase del registro, la pestaña del tercero, la vista
de conjunto, la página de configuración, el esquema de la tabla, los iconos.
- Idiomas: francés (
fr_FR), inglés (en_US), alemán (de_DE) y español (es_ES). - Un
README.mdque describe el funcionamiento, el IVA y los límites. - Un
ChangeLog.md.
- Se añade una tabla:
llx_dolixconsignes_mvt. Una fila por movimiento: cliente, producto envase, cantidad con signo (+ en el cliente, − devuelto o considerado vendido), valor de la fianza, tipo, fecha, factura y línea de origen, nota, usuario, entidad. - Se añaden dos campos a los productos:
dolixcons_consigneydolixcons_delai. - Un ajuste se guarda como constante de Dolibarr:
DOLIXCONS_DEFAULT_DELAY. - Lo que se escribe: un movimiento al validar una factura o un abono que contiene envases retornables, en cada introducción manual y en cada regularización. Los movimientos de una factura se borran cuando vuelve a borrador, se elimina o se sustituye.
- No se escribe nada en sus facturas, ni en el stock. Ninguna conexión saliente.
- Al desactivarlo, el menú y la pestaña desaparecen; la tabla del registro y los dos campos de los productos se conservan.
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.
| Versiones de Dolibarr | Dolibarr 19.0 como mínimo. Instalado y ejecutado 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ínimo | 7.4 |
| Módulos de Dolibarr que activar | Terceros, Productos, Facturas y abonos |
| Licencia | GPL v3 o posterior, código fuente completo |
| Idiomas | Francés, inglés, alemán, español |
| Menú | Menú Productos«Envases retornables»: vista de conjunto «Envases en los clientes» e informe «Considerados como vendidos». Pestaña «Envases retornables» en la ficha del tercero. |
09
Instalación
- Obtenga el módulo en el DoliStore y descargue el archivo zip.
- En Dolibarr: InicioConfiguraciónMódulospestaña «Instalar módulo externo», y suba el zip. Si no, descomprima la carpeta dolixconsignes en htdocs/custom/.
- Active «Envases retornables» en la lista de módulos. Necesita los módulos Terceros, Productos y Facturas y abonos. La tabla del registro y los dos campos de los productos se crean en ese momento.
- Conceda a los usuarios afectados el permiso «Ver los envases retornables» y, para la introducción y la regularización, «Registrar movimientos y liquidar los envases no devueltos».
- Marque «Envase retornable» en los productos barril, caja, botella o palé e indique su plazo de devolución. Después introduzca los saldos iniciales en la ficha de los clientes, o reconstruya el registro a partir de las facturas existentes en la página de configuración.
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 como mínimo Dolibarr 19.0 y PHP 7.4. La versión 1.0.2 se ha instalado desde su zip y su prueba de integración (34 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; la interfaz se ha usado en un navegador en la versión 24. Si usa otra versión y tiene alguna duda, escriba antes de comprar.
¿Modifica el módulo mis facturas?
No. Lee las facturas y abonos a clientes en el momento de su validación y anota los envases en su propia tabla. No crea ninguna factura, no modifica ninguna línea y no hace ningún movimiento de stock.
¿Cómo registro una devolución de envases?
Como de costumbre en Dolibarr: con una línea negativa, en cantidad o en precio, con el producto envase, en la siguiente factura del cliente, o con un abono. Al validar, los envases se cuentan como devueltos. La introducción manual del módulo sirve para el saldo inicial y las correcciones de inventario, no para las devoluciones del día a día.
Mis clientes ya tienen envases. ¿Cómo los incorporo?
Si las fianzas se facturaron en Dolibarr con un producto envase, marque «Envase retornable» en ese producto y lance «Reconstruir el registro a partir de las facturas» en la página de configuración. Si no, introduzca un «Saldo inicial» en la pestaña de cada cliente, con la fecha de entrega si la conoce: es la que cuenta para el retraso.
¿Qué pasa con un envase que nunca vuelve?
Pasado su plazo, aparece «Atrasado» en la pestaña del cliente y en la vista de conjunto. El botón «Considerar los atrasados como vendidos», tras confirmación, lo saca del saldo del cliente y lo anota en el informe «Considerados como vendidos», pensado para su asesor contable. No se crea ninguna factura: el cliente ya ha pagado la fianza. El asiento contable queda por registrar.
¿Cómo se trata el IVA?
El módulo no fija ningún tipo: usa el que usted elija en el producto envase. Según la doctrina fiscal francesa (BOFiP BOI-TVA-SECT-90-30 §§ 30-40, CGI art. 267 III), la fianza puede excluirse de la base imponible del IVA si no se factura el IVA y el envase se devuelve en el plazo habitual del sector; pasado ese plazo, el envase no devuelto se considera vendido al precio de la fianza. Compruébelo con su asesor contable.
¿Y si lo desinstalo?
El menú y la pestaña desaparecen. El registro de movimientos y los dos campos de los productos se quedan en su base de datos. El módulo no ha modificado sus facturas: no hay nada que restaurar.
¿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.23 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.125 de octubre de 2026
Permisos de Dolibarr respetados: la vista de conjunto y el informe «Considered as sold» ya solo muestran los clientes que el usuario puede ver en Dolibarr (comercial sin el permiso para ver todos los terceros: sus propios clientes; usuario externo: su empresa). La pestaña del cliente ya aplicaba este control. Probado en 19.0.4 a 24.0.2.
1.0.012 de octubre de 2026
Primera versión: campos «Returnable packaging» y «Return delay» en los productos. Registro por cliente alimentado por las facturas y abonos validados (entregas, devoluciones mediante una línea negativa o un abono); sigue las facturas devueltas a borrador, eliminadas o sustituidas; anticipos ignorados. Pestaña en la ficha del cliente y vista de conjunto: saldos, valor de las fianzas, antigüedad (primero en salir, primero en volver), envases con retraso. Introducción manual (saldo inicial, corrección), reconstrucción del registro a partir de las facturas. Regularización de los envases no devueltos («considerados vendidos») e informe para el asesor contable. 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í dolixconsignes 1.0.2.
- 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.
También
Los demás módulos
Cambio de dominio de correo electrónico
dolixdomaine · v1.0.6
Un cliente cambia de nombre: sus direcciones pasan al nuevo dominio en una sola operación.
Modificación masiva
dolixmasse · v1.0.6
Usted cambia un campo en una serie de fichas sin escribir una consulta SQL.
Mover tareas entre proyectos
dolixtaches · v1.0.4
Una tarea se creó en el proyecto equivocado: usted la mueve, con sus subtareas, su tiempo dedicado y sus documentos.
Detección de duplicados
dolixdoublons · v1.1.8
Usted encuentra las fichas introducidas dos veces y las fusiona: terceros, contactos y miembros.
Actualizar los precios de presupuestos y plantillas de factura
dolixprix · v1.1.3
Sus presupuestos en borrador y sus plantillas de factura recuperan los precios del catálogo, uno a uno o todos a la vez.
Gastos de importación
dolixapproche · v1.0.4
Usted reparte el transporte, la aduana y los demás gastos de una llegada de mercancía sobre el coste de los productos y su precio medio ponderado.
Pendiente de facturar
dolixresteafacturer · v1.0.2
Usted ve lo que queda por facturar en cada pedido de cliente, línea a línea, en cantidad y en importe sin IVA.
Listo para la actualización
dolixmaj · v1.0.3
Antes de actualizar Dolibarr, usted sabe qué bloqueará, qué se romperá y qué hacer antes. El módulo no modifica nada.
Menciones de IVA Europa
dolixtva · v1.0.1
La mención de IVA obligatoria se imprime sola en sus facturas: franquicia, entrega intracomunitaria, inversión del sujeto pasivo, exportación.
Justificantes en los informes de gastos
dolixjustif · v1.0.1
El PDF del informe de gastos contiene también sus justificantes, fotos y PDF, página por página: un único documento que entregar.
Monedero TakePOS
dolixportemonnaie · v1.1.1
Sus clientes o miembros abonan una cantidad por adelantado, y TakePOS la consume en cada paso por caja, hasta agotarla.
Etiquetas Mondial Relay (Sendcloud)
dolixmondialrelay · v1.0.2
Usted elige el Point Relais® o el Locker del destinatario en el envío, y el módulo crea la etiqueta Mondial Relay con su cuenta Sendcloud.
Alertas de fecha límite de venta y de caducidad de los lotes
dolixdlc · v1.0.1
Usted ve a tiempo los lotes en stock cuya fecha límite de venta o fecha de caducidad está próxima o ya ha pasado, y puede impedir la validación de una expedición que contenga un lote con la fecha límite de venta pasada.
Aspecto TakePOS
dolixhabillage · v1.0.1
Dé a TakePOS el aspecto de una caja moderna: categorías en pestañas, gran cuadrícula de productos, cesta a la derecha, botón de cobro, estilos por oficio o los colores de su logo.
Etiquetas en columna en las listas
dolixtags · v1.0.1
Las etiquetas de sus presupuestos, pedidos, facturas, terceros, contactos, productos y proyectos se muestran en color en una columna de la lista, sin abrir cada ficha.
Renovación de afiliaciones en bloque
dolixcotisations · v1.0.3
Una cuota propia para cada miembro, y todas las afiliaciones renovadas a la vez, con factura, pago y correo.
Venta en depósito
dolixdepotvente · v1.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.
Albarán de entrega agrupado
dolixblgroupe · v1.0.2
Un solo albarán de entrega en PDF para varias expediciones del mismo cliente, firmado una sola vez.
Último precio cliente
dolixdernierprix · v1.0.0
Usted elige un producto en un presupuesto, un pedido o una factura: se muestran el último precio y el descuento concedidos a ese cliente, y se aplican con un clic.