
Prêt et retour – Suivi du stock du matériel prêté
Documentation du module · version 23.0.0 · éditeur NSINFO
Sommaire
1. Présentation
Prêt et retour suit où se trouve le stock lorsque vous prêtez du matériel à un client. Chaque prêt sort le matériel de votre entrepôt vers un entrepôt dédié « Prêt » ; chaque retour le remet en stock. Vous savez à tout moment ce qui est chez quel client.
- Un prêt : client, entrepôt de départ, période du prêt (calendrier de plage), lignes produit / quantité.
- Un retour : prêt d’origine, entrepôt de retour, date de retour, lignes reprises du prêt.
- Les produits suivis par numéro de série ou de lot sont gérés numéro par numéro.
- Si le retour est incomplet, le module propose de facturer le matériel non rendu au client.
- Numérotation et document PDF de chaque prêt et de chaque retour.
Le module ne modifie pas le Core de Dolibarr.
2. Prérequis et installation
2.1 Prérequis
| Élément | Version |
|---|---|
| Dolibarr | 20.0 à 24.0 |
| PHP | 7.4 à 8.3 |
| Framework NSINFO (module « NSINFO ») | 23.8.6 ou supérieure, installé et activé (gratuit) — framework NSINFO |
| Modules Dolibarr | Tiers, Produits, Stocks ; Factures clients pour facturer le matériel non rendu ; Numéros de série / lots si vos produits en ont |
| Langues | Français, anglais |
Sans le framework NSINFO, l’activation du module est refusée avec un message d’erreur.
2.2 Installation
- Activez d’abord le module NSINFO (framework NSINFO).
- Menu « Déployer / installer un module externe » de Dolibarr : glisser l’archive du module puis cliquer sur « Envoyer le fichier » (voir la page d’installation d’un module).
- Dans Configuration > Modules, activer Prêt et retour (famille NSINFO) — voir la page d’activation et de paramètres.
- Ouvrir la roue crantée du module et choisir l’entrepôt de prêt (section 3.1).
2.3 Mise à jour / réactivation
Après une mise à jour, désactivez puis réactivez le module pour que Dolibarr prenne en compte ses nouveaux éléments (menus, tables). Les réglages et les données sont conservés.
3. Configuration
Page de réglages : Configuration > Modules, roue crantée du module. Chaque modification est enregistrée automatiquement : une coche verte s’affiche un instant à côté du champ.
3.1 Entrepôts
| Réglage | Effet |
|---|---|
| Entrepôt de départ par défaut des prêts | Proposé à la création d’un prêt ; modifiable sur chaque prêt. |
| Entrepôt de retour par défaut | Proposé à la création d’un retour ; il peut être différent de l’entrepôt de départ. S’il est vide, l’entrepôt de départ du prêt est proposé. |
| Entrepôt de prêt | Représente le matériel qui est chez les clients. Il doit être différent des entrepôts de départ. |
Chaque entrepôt se choisit dans la liste ou se crée avec le bouton « + » (la fiche de l’entrepôt s’ouvre, puis vous revenez aux réglages avec l’entrepôt choisi). Sur un nouveau retour, un lien « Utiliser l’entrepôt de départ du prêt » permet de reprendre l’entrepôt d’où le matériel est parti, quand l’entrepôt de retour proposé est un autre.
3.2 Numérotation
Onglet Numérotation : un sous-onglet Prêts et un sous-onglet Retours proposent le modèle standard (préfixe et numéro) et le modèle à masque personnalisable. Le modèle standard est activé dès l’activation du module.
3.3 Modèles de documents
Onglet Modèles de documents : même organisation, avec un aperçu PDF. Le modèle standard est activé et choisi par défaut.
4. Droits d’accès
Pour les prêts et pour les retours : Lire, Créer / modifier et Supprimer. Le menu « Prêt et retour » n’est visible que pour les utilisateurs qui peuvent lire les prêts.
5. Utilisation
5.1 Créer un prêt
- Prêt et retour > Prêts > Nouveau : choisissez le client, l’entrepôt de départ et la période du prêt. Un clic sur « Choisir la période » ouvre un calendrier : un clic sur le premier jour, un clic sur le dernier.
- Sur la fiche, ajoutez les lignes : produit et quantité. Les lignes se suppriment tant que le prêt est un brouillon.
- Cliquez sur Valider : le stock sort de l’entrepôt de départ et entre dans l’entrepôt de prêt. Le prêt passe au statut « Prêté ».
Sur un prêt validé, la période peut encore être changée dans le calendrier (retour prévu), elle est enregistrée aussitôt.
5.2 Numéros de série et lots
- Un produit suivi par numéro de série ou de lot demande ce numéro sur chaque ligne.
- Un numéro de série est unique et compte pour 1 ; il doit être en stock dans l’entrepôt de départ.
- Au retour, seuls les numéros encore chez le client sont acceptés.
5.3 Enregistrer un retour
- Prêt et retour > Retours > Nouveau : choisissez le prêt (seuls les prêts « Prêtés » sont proposés) ; le client et l’entrepôt de retour sont repris du prêt.
- Le bouton « Reprendre les quantités restantes du prêt » remplit les lignes ; ajustez-les si le client rend moins.
- Cliquez sur Valider : le stock sort de l’entrepôt de prêt et revient dans l’entrepôt de retour. Les quantités retournées sont reportées sur le prêt, qui passe à « Retourné » quand tout est revenu.
5.4 Matériel non rendu
Si le retour est incomplet, le module propose de facturer le matériel manquant : après la validation du retour, une confirmation s’affiche sur le prêt. Le bouton « Facturer les manquants » reste disponible sur le prêt.
- Une facture client brouillon est créée avec les produits manquants, au prix de la fiche produit (le numéro de série est indiqué sur la ligne).
- Le stock correspondant sort de l’entrepôt de prêt : le matériel est considéré comme vendu.
- Le prêt passe au statut « Soldé ».
5.5 Tableau de bord et agenda
La page d’accueil du module (clic sur « Prêt et retour » dans le menu du haut) montre l’état des prêts et des retours :
- le nombre de prêts par statut (Brouillon, Prêté, Retourné, Soldé) et de retours par statut ;
- le matériel chez les clients, les prêts en retard (retour prévu dépassé) en premier et signalés ;
- les derniers retours ;
- l’agenda des 14 prochains jours : débuts de prêt et retours prévus ;
- des raccourcis : nouveau prêt, nouveau retour et agenda.
L’agenda des prêts est aussi une entrée du menu de gauche : un calendrier du mois où chaque prêt s’étend du jour de prêt au retour prévu (bleu : prêté, violet : en retard, cyan : retourné ou soldé, gris : brouillon). Un clic sur un prêt ouvre sa fiche. Sur téléphone, le calendrier devient une liste des jours occupés.
6. Statuts et stock
| Statut du prêt | Sens | Stock |
|---|---|---|
| Brouillon | Prêt en préparation | Aucun mouvement |
| Prêté | Matériel chez le client | Entrepôt de départ vers entrepôt de prêt |
| Retourné | Tout le matériel est revenu | Entrepôt de prêt vers entrepôt de retour (retours) |
| Soldé | Le matériel non rendu est facturé | Sortie de l’entrepôt de prêt |
Un prêt ou un retour validé ne revient pas en brouillon : le stock a déjà été déplacé.
7. Impression PDF
Chaque prêt et chaque retour peut être imprimé en PDF depuis sa fiche (bouton « Générer »), avec le modèle choisi dans les réglages.
8. Limites connues et FAQ
- La validation est refusée : vérifiez que l’entrepôt de prêt est choisi dans les réglages et qu’il est différent de l’entrepôt de départ.
- Un numéro de série est refusé : il n’est pas en stock dans l’entrepôt de départ (prêt) ou n’est plus chez le client (retour).
- Un service ne bouge pas le stock.
- Retour de plus que prêté : refusé, la quantité retournée ne peut pas dépasser ce qui reste chez le client.