Achats et stock

Emballages consignés

dolixconsignes · version 1.0.1

Vous voyez combien de fûts, caisses ou palettes consignés chaque client détient, ce que valent ces consignes, et ceux qui ne sont pas revenus dans le délai.

Prix
59 € HT
Dolibarr
19.0 minimum
Version
1.0.1
Licence
GPL v3+
Langues
Français, anglais, allemand

59 € hors taxes.

La commande, le paiement, la facture et le téléchargement sont assurés par le DoliStore.

Acheter sur le DoliStore — 59 € HT
La vue d'ensemble, menu Produits → Emballages consignés : pour chaque client et chaque emballage, la quantité chez le client, la valeur des consignes, la plus ancienne sortie non rendue et les emballages en retard.
La vue d'ensemble, menu ProduitsEmballages consignés : pour chaque client et chaque emballage, la quantité chez le client, la valeur des consignes, la plus ancienne sortie non rendue et les emballages en retard.
01

Ce que fait le module

  • Deux champs sur la fiche produit : « Emballage consigné », une case à cocher, et « Délai de retour (jours) ». Un délai vide prend le délai par défaut du module.
  • Le registre se remplit à partir des factures clients : à la validation, chaque ligne d'un emballage consigné facturé compte les emballages chez le client. Une ligne négative, en quantité ou en prix, sur une facture suivante, ou une ligne d'avoir, les compte comme rendus.
  • Le registre suit la facture : les mouvements sont retirés si elle repasse en brouillon ou est supprimée, et recréés à la revalidation. Une facture remplacée par une facture de remplacement n'est plus comptée. Les factures d'acompte sont ignorées.
  • Un onglet « Emballages consignés » sur la fiche tiers : pour chaque emballage, la quantité chez le client, la valeur des consignes, la plus ancienne sortie non rendue, le délai et la quantité en retard ; puis l'historique des mouvements, avec le lien vers chaque facture.
  • Une vue d'ensemble dans le menu Produits : tous les clients qui détiennent des emballages, un filtre par emballage, la case « Seulement les emballages en retard » et une ligne de total.
  • Premier sorti, premier rendu : les retours soldent d'abord les sorties les plus anciennes. Un emballage est en retard quand il est chez le client depuis plus longtemps que son délai de retour.
  • Saisie manuelle sur l'onglet : « Solde initial » pour les emballages déjà chez le client avant le module, « Correction » pour un écart d'inventaire. Un produit qui n'est pas marqué « Emballage consigné » est refusé.
  • Le bouton « Considérer les retards comme vendus », après confirmation, sort les emballages en retard du solde du client et les inscrit dans l'état « Considérés comme vendus » : date, client, emballage, quantité, valeur, note, sur la période choisie. Aucune facture n'est créée.
  • « Reconstruire le registre à partir des factures », dans la page de configuration, relit les factures et avoirs validés qui contiennent un emballage consigné, par exemple après avoir coché un produit. Les soldes initiaux, corrections et emballages considérés comme vendus sont conservés.
  • Un solde négatif, plus d'emballages rendus que facturés, est signalé dans l'onglet par une alerte : il faut vérifier le solde initial ou les factures.
02

À qui ça sert

Une brasserie, un distributeur de boissons ou un fournisseur qui livre sur palettes facture une consigne et la rembourse au retour des emballages. Dolibarr facture et rembourse, mais ne dit pas combien d'emballages chaque client a encore, ni depuis quand.

Une brasserie, un distributeur de boissons ou un fournisseur qui livre sur palettes facture une consigne avec ses produits, et la rembourse au retour des emballages.

Dolibarr facture et rembourse sans difficulté, mais ne dit pas combien d’emballages chaque client a encore, ni depuis quand.

À qui ça sert : Les brasseries, distributeurs de boissons, fournisseurs qui livrent sur palettes, et toute entreprise qui facture une consigne sur des fûts, caisses, bouteilles ou palettes et la rembourse au retour.

03

Ce que le module ne fait pas

Ce bloc figure sur les 21 fiches, sans exception.

  • Pas de suivi du stock physique d'emballages vides : le stock Dolibarr reste celui de vos mouvements de stock.
  • Pas de suivi des emballages consignés reçus de vos fournisseurs : seules les factures et avoirs clients sont lus.
  • Pas d'écriture comptable automatique pour les emballages considérés comme vendus : l'état est destiné à l'expert-comptable, et aucune facture n'est créée.
  • Le module ne fixe aucun taux de TVA et ne choisit pas le traitement fiscal de la consigne : c'est le taux du produit emballage qui s'applique.
  • Seules les lignes portant un produit marqué « Emballage consigné » sont comptées. Une ligne libre, sans produit, ne l'est pas.
  • Pas de saisie de retour à part : un retour passe par une ligne négative sur une facture ou par un avoir. La saisie manuelle est réservée au solde initial et aux corrections.
  • Un délai de retour par emballage, sans délai propre à un client.
  • L'onglet du tiers affiche les 200 mouvements les plus récents.
04

Comment ça marche

Le module tient un registre des emballages consignés par client, à partir de vos factures et avoirs clients. Il n’y a pas de double saisie : vous facturez et remboursez la consigne comme d’habitude.

Sur les produits

Deux champs sont ajoutés à la fiche produit :

  • « Emballage consigné », une case à cocher, pour les fûts, caisses, bouteilles, palettes… dont la consigne est facturée puis remboursée au retour ;
  • « Délai de retour (jours) », le délai d’usage dans votre profession. Vide, c’est le délai par défaut du module qui s’applique.

Le registre suit vos factures

  • Facture validée : les emballages consignés facturés sont comptés chez le client.
  • Ligne négative — en quantité ou en prix — sur la facture suivante, ou avoir : ils sont comptés comme rendus.
  • Facture remise en brouillon ou supprimée : ses mouvements sont retirés, puis recréés à la revalidation.
  • Facture remplacée par une facture de remplacement : elle n’est plus comptée, seule la facture de remplacement l’est.
  • Les factures d’acompte sont ignorées.

Premier sorti, premier rendu

Les retours soldent d’abord les sorties les plus anciennes. Un emballage est en retard quand il est chez le client depuis plus longtemps que son délai de retour. Avec un délai à 0, aucun retard n’est signalé.

Sur la fiche du client

L’onglet « Emballages consignés » de la fiche tiers montre, pour chaque emballage : la quantité chez le client, la valeur des consignes, la plus ancienne sortie non rendue, le délai et la quantité en retard. Dessous, l’historique des mouvements, avec le lien vers chaque facture. Un solde négatif — plus d’emballages rendus que facturés — est signalé par une alerte.

La vue d’ensemble

Dans le menu ProduitsEmballages consignés : tous les clients qui détiennent des emballages, un filtre par emballage, la case « Seulement les emballages en retard » et une ligne de total.

Saisie manuelle

Sur l’onglet du client :

  • Solde initial : les emballages déjà chez le client avant l’installation du module. La date saisie compte pour le retard.
  • Correction : un écart d’inventaire, positif ou négatif.

Un produit qui n’est pas marqué « Emballage consigné » est refusé. Les ventes et retours courants passent par les factures et les avoirs.

Emballages non rendus

Le bouton « Considérer les retards comme vendus », après confirmation, sort les emballages en retard du solde du client et les inscrit dans l’état « Considérés comme vendus » : date, client, emballage, quantité, valeur, note, sur la période choisie. Cet état est destiné à l’expert-comptable.

Aucune facture n’est créée : le client a déjà payé la consigne. C’est une écriture comptable à passer.

La TVA

Le module ne fixe aucun taux : c’est celui que vous choisissez sur le produit emballage.

Selon le BOFiP (BOI-TVA-SECT-90-30 §§ 30-40, CGI art. 267 III), la consigne peut être exclue de la base imposable si la TVA n’est pas facturée et si l’emballage est rendu dans le délai d’usage de la profession ; passé ce délai, l’emballage non rendu est considéré comme vendu au prix de la consignation. À valider avec votre expert-comptable.

La vue d’ensemble, sous Dolibarr 24.0.1 : six lignes client et emballage. Le Comptoir des Halles détient 5 fûts FUT-INOX-30L (150,00 de consignes), dont 1 en retard ; la Cave du Vieux Port, 18 caisses dont 8 en retard. Total : 37 emballages, 406,00, dont 12 en retard pour 106,00.

L’onglet « Emballages consignés » du Comptoir des Halles : 5 fûts (délai 90 j) et 1 palette (délai 60 j), chacun avec 1 emballage en retard et le bouton « Considérer les retards comme vendus ». Dessous, la saisie manuelle, puis les mouvements : 6 fûts et 1 palette facturés le 05/05/2026 sur FA2605-0022, 4 fûts facturés et 5 remboursés le 02/09/2026 sur FA2609-0023.

L'onglet « Emballages consignés » d'un client : solde par emballage avec son délai et ses retards, bouton « Considérer les retards comme vendus », saisie manuelle, et l'historique des mouvements avec la facture d'origine.
L'onglet « Emballages consignés » d'un client : solde par emballage avec son délai et ses retards, bouton « Considérer les retards comme vendus », saisie manuelle, et l'historique des mouvements avec la facture d'origine.
05

Réglages

La page de configuration du module est réservée aux administrateurs.

Réglage Défaut Effet
Délai de retour par défaut 0 : pas de retard signalé Utilisé pour les emballages sans délai propre.

La même page rappelle la mise en place en trois étapes, porte le bouton « Reconstruire le registre à partir des factures » et le rappel sur la TVA. La reconstruction relit toutes les factures et avoirs validés qui contiennent un emballage consigné et recrée leurs mouvements. Les soldes initiaux, corrections et emballages considérés comme vendus sont conservés.

06

Sécurité et garde-fous

  • Deux droits dédiés, non accordés par défaut : « Voir les emballages consignés » ouvre le menu, la vue d’ensemble, l’état et l’onglet ; « Saisir des mouvements et régulariser les emballages non rendus » affiche la saisie manuelle et le bouton de régularisation.
  • Écriture refusée sans le second droit, même par un envoi forcé : aucun mouvement n’est créé.
  • L’onglet applique le contrôle d’accès de Dolibarr sur le tiers affiché.
  • Commerciaux limités à leurs clients : sans le droit Dolibarr de voir tous les tiers, un utilisateur ne voit dans la vue d’ensemble et dans l’état que les clients dont il est commercial attitré, comme dans les listes de Dolibarr.
  • Confirmation avant de considérer des emballages comme vendus.
  • Configuration réservée aux administrateurs, avec jeton anti-CSRF à l’enregistrement.
  • Reconstruction en une seule transaction : si elle échoue en cours de route, rien n’est changé.
07

Ce qui est livré

Ce que le module écrit dans votre installation
Tables créées en baseUne table : llx_dolixconsignes_mvt. Elle garde une ligne par mouvement d'emballage : client, produit emballage, quantité signée (+ chez le client, − rendu ou considéré comme vendu), valeur de la consigne, type (facture, avoir, solde initial, correction, considéré comme vendu), date, facture et ligne d'origine, note, utilisateur, entité. Deux champs sont ajoutés aux produits (dolixcons_consigne et dolixcons_delai), et le délai de retour par défaut est enregistré comme constante Dolibarr : DOLIXCONS_DEFAULT_DELAY.
PermissionsDeux droits, non accordés par défaut : « Voir les emballages consignés » ouvre le menu, la vue d'ensemble, l'état « Considérés comme vendus » et l'onglet du tiers ; « Saisir des mouvements et régulariser les emballages non rendus » affiche la saisie manuelle et le bouton « Considérer les retards comme vendus ». L'onglet applique en plus le contrôle d'accès de Dolibarr sur le tiers. La vue d'ensemble et l'état ne montrent que les clients que l'utilisateur peut voir dans Dolibarr : un commercial sans le droit de voir tous les tiers ne voit que ses clients. La page de configuration est réservée aux administrateurs.
Désinstallation
  • Désactiver le module dans ConfigurationModules/Applications. Le menu et l'onglet disparaissent.
  • Le registre (table llx_dolixconsignes_mvt) et les champs « Emballage consigné » et « Délai de retour » des produits sont conservés.
  • Le module n'a créé ni modifié aucune facture : il n'y a rien à annuler dans votre facturation.

Le dossier dolixconsignes, en PHP lisible, sous licence GPL v3 ou ultérieure : le descripteur du module, le déclencheur sur les factures, la classe du registre, l’onglet du tiers, la vue d’ensemble, la page de configuration, le schéma de la table, les icônes.

  • Langues : français (fr_FR), anglais (en_US) et allemand (de_DE).
  • Un README.md qui décrit le fonctionnement, la TVA et les limites.
  • Un ChangeLog.md.
  • Une table est ajoutée : llx_dolixconsignes_mvt. Une ligne par mouvement : client, produit emballage, quantité signée (+ chez le client, − rendu ou considéré comme vendu), valeur de la consigne, type, date, facture et ligne d’origine, note, utilisateur, entité.
  • Deux champs sont ajoutés aux produits : dolixcons_consigne et dolixcons_delai.
  • Un réglage est enregistré comme constante Dolibarr : DOLIXCONS_DEFAULT_DELAY.
  • Ce qui est écrit : un mouvement à la validation d’une facture ou d’un avoir contenant un emballage consigné, à chaque saisie manuelle et à chaque régularisation. Les mouvements d’une facture sont effacés quand elle repasse en brouillon, est supprimée ou remplacée.
  • Rien n’est écrit dans vos factures, ni dans le stock. Aucune connexion sortante.
  • À la désactivation, le menu et l’onglet disparaissent ; la table du registre et les deux champs des produits sont conservés.
08

Compatibilité

Le descripteur du module ne déclare qu’une version minimale. Aucune borne haute n’est inscrite dans le code : les versions ci-dessous sont celles sur lesquelles le module a réellement été exécuté.

Compatibilité du module Emballages consignés
Versions de DolibarrDolibarr 19.0 minimum. Installé et exécuté sur 19.0.4, 20.0.4, 21.0.4, 22.0.5, 23.0.4, 24.0.1 et 24.0.2.
PHP minimum7.4
Modules Dolibarr à activerTiers, Produits, Factures et avoirs
LicenceGPL v3 ou ultérieure, code source complet
LanguesFrançais, anglais, allemand
MenuMenu Produits« Emballages consignés » : vue d'ensemble « Emballages chez les clients » et état « Considérés comme vendus ». Onglet « Emballages consignés » sur la fiche tiers.
09

Installation

  1. Récupérer le module sur le DoliStore et télécharger le fichier zip.
  2. Dans Dolibarr : AccueilConfigurationModules/Applicationsonglet « Déployer/Installer un module externe », puis envoyer le zip. Sinon, décompresser le dossier dolixconsignes dans htdocs/custom/.
  3. Activer « Emballages consignés » dans la liste des modules. Il demande les modules Tiers, Produits et Factures. La table du registre et les deux champs des produits sont créés à ce moment-là.
  4. Attribuer aux utilisateurs concernés les droits « Voir les emballages consignés » et, pour la saisie et la régularisation, « Saisir des mouvements et régulariser les emballages non rendus ».
  5. Cocher « Emballage consigné » sur les produits fût, caisse, bouteille ou palette et indiquer leur délai de retour. Puis saisir les soldes initiaux sur la fiche des clients, ou reconstruire le registre à partir des factures existantes dans la page de configuration.

Le détail — droits du dossier custom, hébergement mutualisé, mise à jour, désinstallation — est sur la page Installation et mise à jour.

10

Questions fréquentes

Sur quelles versions de Dolibarr ce module fonctionne-t-il ?

Le descripteur exige Dolibarr 19.0 au minimum et PHP 7.4 au minimum. La version 1.0.1 a été installée depuis son zip et son test d'intégration (34 contrôles) passe sur 19.0.4, 20.0.4, 21.0.4, 22.0.5, 23.0.4, 24.0.1 et 24.0.2 ; l'interface a été utilisée dans un navigateur sur la 24. Si vous êtes sur une autre version et que vous avez un doute, écrivez avant d'acheter.

Le module modifie-t-il mes factures ?

Non. Il lit les factures et avoirs clients au moment de leur validation et note les emballages dans sa propre table. Il ne crée aucune facture, ne modifie aucune ligne et ne fait aucun mouvement de stock.

Comment enregistrer un retour d'emballages ?

Comme d'habitude dans Dolibarr : par une ligne négative, en quantité ou en prix, avec le produit emballage, sur la facture suivante du client, ou par un avoir. À la validation, les emballages sont comptés comme rendus. La saisie manuelle du module sert au solde initial et aux corrections d'inventaire, pas aux retours courants.

Mes clients ont déjà des emballages chez eux. Comment les reprendre ?

Si les consignes ont été facturées dans Dolibarr avec un produit emballage, cochez « Emballage consigné » sur ce produit puis lancez « Reconstruire le registre à partir des factures » dans la page de configuration. Sinon, saisissez un « Solde initial » sur l'onglet de chaque client, avec la date de sortie si vous la connaissez : c'est elle qui compte pour le retard.

Que se passe-t-il pour un emballage jamais rendu ?

Passé son délai, il apparaît « En retard » dans l'onglet du client et dans la vue d'ensemble. Le bouton « Considérer les retards comme vendus », après confirmation, le sort du solde du client et l'inscrit dans l'état « Considérés comme vendus », destiné à votre expert-comptable. Aucune facture n'est créée : le client a déjà payé la consigne. L'écriture comptable reste à passer.

Comment la TVA est-elle traitée ?

Le module ne fixe aucun taux : c'est celui que vous choisissez sur le produit emballage. Selon le BOFiP (BOI-TVA-SECT-90-30 §§ 30-40, CGI art. 267 III), la consigne peut être exclue de la base imposable si la TVA n'est pas facturée et si l'emballage est rendu dans le délai d'usage de la profession ; passé ce délai, l'emballage non rendu est considéré comme vendu au prix de la consignation. À valider avec votre expert-comptable.

Et si je désinstalle ?

Le menu et l'onglet disparaissent. Le registre des mouvements et les deux champs des produits restent dans votre base. Vos factures n'ont pas été modifiées par le module : il n'y a rien à remettre en état.

Qui répond au support, et comment se passent les mises à jour ?

Le support est assuré par la personne qui a écrit le module, à support@dolix.fr. La commande, le paiement, la facture et le téléchargement sont assurés par le DoliStore, où les nouvelles versions sont publiées.

11

Journal des versions

Repris du fichier ChangeLog.md du module : une seule source.

1.0.125 octobre 2026

Droits Dolibarr respectés : la vue d'ensemble et l'état « Considérés comme vendus » ne montrent plus que les clients que l'utilisateur peut voir dans Dolibarr (commercial sans le droit de voir tous les tiers : ses clients ; utilisateur externe : sa société). L'onglet du client appliquait déjà ce contrôle. Testé sur 19.0.4 à 24.0.2.

1.0.012 octobre 2026

Première version : champs « Emballage consigné » et « Délai de retour » sur les produits. Registre par client alimenté par les factures et avoirs validés (sorties, retours par ligne négative ou avoir) ; suit le retour en brouillon, la suppression et le remplacement des factures ; acomptes ignorés. Onglet sur la fiche client et vue d'ensemble : soldes, valeur des consignes, ancienneté (premier sorti, premier rendu), emballages en retard. Saisie manuelle (solde initial, correction), reconstruction du registre depuis les factures. Régularisation des emballages non rendus (« considérés comme vendus ») et état pour l'expert-comptable. Interface en français, anglais et allemand.

12

Support de ce module

Écrivez à support@dolix.fr. C’est la personne qui a écrit le module qui répond.

Réponse sous deux jours ouvrés. Ce n’est pas un service d’astreinte.

À joindre à votre message

  • La version exacte de Dolibarr.
  • Le module concerné et sa version — ici dolixconsignes 1.0.1.
  • Ce que vous avez fait, et ce que vous attendiez.
  • Le message d’erreur recopié tel quel, ou une capture d’écran.
  • Comment Dolibarr est installé, si vous le savez.

Ce module est en vente sur le DoliStore.

La commande, le paiement, la facture et le téléchargement sont assurés par le DoliStore.

Acheter sur le DoliStore — 59 € HT
Aussi

Les autres modules