# Gestion des garanties de produits

Le module gestion de garantie vous permet d'ajouter un attribut supplémentaire "garantie" sur vos produits, pour vous aider à gérer la période (en mois) de garantie vendeur de vos produits.  
Vous gérez également les informations de garantie constructeur.

Ces attributs supplémentaires sont ensuite affichables dans vos documents, devis, commandes, et factures et sur vos PDF.

# 1- Le module gestions des garanties de produits

Présentation générale, installation, activation

# 1.1- Présentation

#### **1.1.1- Fonctionnalités** 

<span style="color: rgb(0, 0, 0);">Le module Gestion des garanties ajoute un attribut supplémentaire de ligne (extrafield) sur vos produits, pour indiquer leur période de garantie.  
</span>

<span style="color: rgb(0, 0, 0);">Cet attribut est supplémentaire peut être affichable dans les devis, commandes et factures, et dans leur PDF associés.</span>

#### <span style="color: rgb(0, 0, 0);">**1.1.2- Cible** </span>

<span style="color: rgb(0, 0, 0);">Le module s'adresse à tous les utilisateurs de Dolibarr désirant ajouter une garantie à leurs produits.  
</span>

#### <span style="color: rgb(0, 0, 0);">**1.1.3- Licence** </span>

<span style="color: rgb(0, 0, 0);">Tous nos modules sont distribués sur </span><span style="color: rgb(0, 0, 0);">sur</span> <span style="color: rgb(24, 139, 175);">[notre boutique en ligne](https://www.altairis.fr/boutique/)</span><span style="color: rgb(0, 0, 0);"> et sur le </span>[<span style="color: rgb(24, 139, 175);">Dolistore</span><span style="color: rgb(0, 0, 0);"> </span>](https://www.dolistore.com/fr/recherche?search_query=altairis)<span style="color: rgb(0, 0, 0);"> sous licence GPL v3. </span>

#### <span style="color: rgb(0, 0, 0);">**1.1.4- Ressources** </span>

##### <span style="color: rgb(0, 0, 0);">1.1.4.1- La présente documentation</span>

<span style="color: rgb(0, 0, 0);">Le guide utilisateur est là pour vous accompagner dans l’utilisation de nos modules. Notre module Gestion des garanties de produits est simple et facile à utiliser. </span>

##### <span style="color: rgb(0, 0, 0);">1.1.4.2- Notre site de démonstration</span>

<span style="color: rgb(0, 0, 0);">Le module est installé sur </span>[<span style="color: rgb(24, 139, 175);">notre environnement de démonstration</span>](https://demo.altairis.fr/)<span style="color: rgb(24, 139, 175);">.</span> <span style="color: rgb(0, 0, 0);">Connectez-vous avec l’identifiant demo et le mot de passe demo. </span>

##### <span style="color: rgb(0, 0, 0);">1.1.4.3- Forum sur dolibarr.org</span>

<span style="color: rgb(0, 0, 0);">Nous créons pour chacun de nos modules une discussion sur le forum dolibarr. Ces discussions peuvent contenir de nombreuses informations. Aussi, si vous avez des commentaires et suggestions, pour une réponse plus rapide, il est préférable de continuer sur cette même conversation. </span>

<span style="color: rgb(0, 0, 0);">Voir la [discussion sur le forum français pour le module Garanties](https://www.dolibarr.fr/forum/t/garantie-produit-simple-et-efficace/46683 "discussion sur le forum français pour le module Garanties").</span>

<p class="callout info"><span style="color: rgb(24, 139, 175);">**Note :** </span><span style="color: rgb(0, 0, 0);">Le forum est un lieu d'échange autour de l'utilisation et des fonctionnalités de nos modules. En cas de difficultés d'utilisation ou pour toute remontée de bogue, privilégiez notre page de support. Par ailleurs, nous vous remercions de ne pas multiplier les canaux d'échange pour un même sujet.</span></p>

# 1.2- Avant de commencer

#### <span style="color: rgb(0, 0, 0);">**1.2.1- Avertissement**</span>

<span style="color: rgb(0, 0, 0);">Nous assurons le bon fonctionnement de nos modules sur les environnements natifs de Dolibarr. Nous ne pouvons pas en garantir le bon fonctionnement suite à des modifications effectuées sur les fichiers du noyau de Dolibarr ou en cas d'utilisation d'autres modules additionnels. </span>

#### <span style="color: rgb(0, 0, 0);">**1.2.2- Pré-requis**</span>

<span style="color: rgb(0, 0, 0);">Le module Gestion des garanties de produits est compatible avec Dolibarr à partir de version la version **14**.<span style="background-color: rgb(185, 106, 217);">  
</span></span>

#### <span style="color: rgb(0, 0, 0);">**1.2.3- Maintenance** </span>

<span style="color: rgb(0, 0, 0);">L'achat du module vous donne droit à un an de maintenance corrective. Cette maintenance corrective n'inclut pas d'aide à l'utilisation ou de support utilisateur, mais seulement la correction des bogues, sous réserve de la bonne utilisation du module et dans le cadre de la compatibilité avec la version utilisée de Dolibarr.</span>

#### <span style="color: rgb(0, 0, 0);">**1.2.4- Mises à jour** </span>

<span style="color: rgb(0, 0, 0);">Les dernières versions de nos modules sont mises à disposition sur le</span> [Dolistore](https://www.dolistore.com/fr/recherche?search_query=altairis) et sur la [boutique en ligne d'Altairis](https://www.altairis.fr/boutique/).

<span style="color: rgb(0, 0, 0);">L'accès aux mises à jour de nos modules est gratuit pendant 1 an</span> <span style="color: rgb(24, 139, 175);">**à compter de leur date d'achat**.</span>

<span style="color: rgb(24, 139, 175);">**Avant**</span><span style="color: rgb(0, 0, 0);"> toute mise à jour, assurez-vous que le module est</span> **<span style="color: rgb(24, 139, 175);">officiellement compatible</span>** <span style="color: rgb(0, 0, 0);">avec la version de Dolibarr sur laquelle vous souhaitez l'installer.</span>

<span style="color: rgb(0, 0, 0);">Pour mettre à jour un module, téléchargez-le à nouveau sur le [Dolistore](https://www.dolistore.com/fr/recherche?search_query=altairis) ou la </span>[<span style="color: rgb(24, 139, 175);">boutique en ligne d'Altairis</span>](https://www.altairis.fr/boutique/) <span style="color: rgb(0, 0, 0);">avec l'identifiant utilisé lors de l'achat initial. Nous rendons systématiquement disponibles en téléchargement les dernières versions de nos modules.</span>

<span style="color: rgb(0, 0, 0);">Dézippez les fichiers de la dernière version du module dans le répertoire custom de votre environnement et confirmez le remplacement de ceux déjà présents ou déployez-le via l’outil "**D**éployer un module" de votre Dolibarr.</span>

<p class="callout warning">**<span style="color: rgb(24, 139, 175);"><span style="color: rgb(186, 55, 42);">! Important !</span>  
  
</span>**<span style="color: rgb(0, 0, 0);">Pour le bon déroulement d'une mise à jour :   
  
- désactivez le module avant de lancer le remplacement de ses fichiers  
- ré-activez-le une fois la nouvelle version en place  
- vérifiez enfin que de nouveaux paramétrages ne soient pas nécessaires</span></p>

<div class="page-content clearfix" component="page-display" id="bkmrk-d%C3%A9sactivez-le-module" option:page-display:page-id="66"></div>

# 1.3- Mise en route

#### <span style="color: rgb(0, 0, 0);">**1.3.1- Procédure d’installation** </span>

<span style="color: rgb(0, 0, 0);">Si vous avez accès aux fichiers de votre Dolibarr, dézippez l'archive du module dans le dossier custom de son arborescence.</span>

<span style="color: rgb(0, 0, 0);">Sur les versions récentes de Dolibarr, le module zippé peut être installé directement depuis la page :</span>

<span style="color: rgb(0, 0, 0);">**A**ccueil &gt; **C**onfiguration &gt; **M**odules/**A**pplications &gt; onglet **D**éployer un **M**odule **E**xterne.</span>

#### <span style="color: rgb(0, 0, 0);">**1.3.2- Activation** </span>

<span style="color: rgb(0, 0, 0);">Activez le module en affichant la liste des modules depuis les menus **A**ccueil &gt; **C**onfiguration &gt; **M**odules/**A**pplications &gt; onglet **M**odules/**A**pplications **I**nstallés. Il sera affiché dans le tableau Altairis.</span>

[![image.png](https://doc.altairis.fr/uploads/images/gallery/2024-06/scaled-1680-/gJ9kxOflofHmv4OV-image.png)](https://doc.altairis.fr/uploads/images/gallery/2024-06/gJ9kxOflofHmv4OV-image.png)


#### <span style="color: rgb(0, 0, 0);">**1.3.3- Permissions**</span>

<span style="color: rgb(0, 0, 0);">Il n'y a aucune permissions particulière pour ce module. <span class="BxUVEf ILfuVd" lang="fr"><span class="hgKElc">À</span></span> partir du moment où un utilisateur peut créer ou modifier un produit, il/elle aura accès à la création/modification du champ supplémentaire de garantie.</span>

#### <span style="color: rgb(0, 0, 0);">**1.3.4- Paramétrage** </span>

<span style="color: rgb(0, 0, 0);">Vous pouvez trouver les paramétrages du module dans **A**ccueil &gt; **C**onfiguration &gt; **M**odules/Application &gt; module "garantie" en cliquant sur le petit rouage.  
</span>

# 2- Utilisation

Renseignez le champ garantie sur la fiche produit, choisissez où vous voulez l'imprimer sur le PDF.

C'est tout.

# 2.1- Gérer vos garanties produits

#### **<span style="color: rgb(0, 0, 0);">2.1.1- Ajouter une garantie manuellement  
</span>**

<span style="color: rgb(0, 0, 0);">Une fois le module activé, l'attribut supplémentaire de garantie s'affichera automatiquement dans la fiche de produit et à la création de produits.</span>

##### <span style="color: rgb(0, 0, 0);">Garantie vendeur :</span>

<span style="color: rgb(0, 0, 0);">Vous pouvez modifier la garantie d'un produit à tout moment, dans sa fiche produit en cliquant sur le petit crayon à côté du champ.  
</span><span style="color: rgb(0, 0, 0);">La garantie standard est exprimée en mois.</span>

##### <span style="color: rgb(0, 0, 0);">Garantie constructeur :</span>

<span style="color: rgb(0, 0, 0);">Si vos produits ont une garantie constructeur, vous pouvez la renseigner dans un champ spécial (la garantie sera exprimée en année(s)).  
Il est aussi possible d'ajouter la marque </span><span style="color: rgb(0, 0, 0);">qui propose cette garantie</span><span style="color: rgb(0, 0, 0);">, et de mettre un lien vers leur site (tout ceci peut être importé en masse via l'outil de Dolibarr).</span>

[![image.png](https://doc.altairis.fr/uploads/images/gallery/2025-03/scaled-1680-/IWF0OFe6A5I6rtJs-image.png)](https://doc.altairis.fr/uploads/images/gallery/2025-03/IWF0OFe6A5I6rtJs-image.png)

#### **<span style="color: rgb(0, 0, 0);">2.1.2- Importer les garanties</span>**

<span style="color: rgb(0, 0, 0);">Étant donné que les garanties sont des champs supplémentaires, vous pouvez les importer en utilisant l'import produit standard de Dolibarr. </span>

<span style="color: rgb(0, 0, 0);">Rajoutez une colonne "garantie" dans votre fichier d'import avec la valeur (en mois) que vous voulez pour vos produits, puis importez normalement.  
  
Si vous voulez importer une garantie constructeur, les étapes sont les mêmes mais la valeur sera exprimée en années plutôt qu'en mois.</span>

<span style="color: rgb(0, 0, 0);">Vous pourrez aussi ajouter une colonne pour la marque et une autre pour un lien vers le site constructeur.   
</span>

#### **<span style="color: rgb(0, 0, 0);">2.1.2- Réglages  
</span>**

<span style="color: rgb(0, 0, 0);">L'affichage de la garantie fonctionne sur les PDF des devis, commandes et factures uniquement. Vous pouvez choisir l'affichage que vous voulez par document. Pour ce faire, Vous pouvez accédez aux réglages du modules dans :</span>

**A**ccueil &gt; **C**onfiguration &gt; **M**odules/Application &gt; module "garantie"

[![Configuration_du_module_garantie_-_2025-04-08_16.47.30.png](https://doc.altairis.fr/uploads/images/gallery/2025-04/scaled-1680-/HZtwbYCcnxUW0ndr-configuration-du-module-garantie-2025-04-08-16-47-30.png)](https://doc.altairis.fr/uploads/images/gallery/2025-04/HZtwbYCcnxUW0ndr-configuration-du-module-garantie-2025-04-08-16-47-30.png)

<span style="color: rgb(0, 0, 0);">Pour chaque document vous pouvez paramétrer l'affichage de vos garanties et des garanties constructeur séparément. Et gérer l'affichage sur les écrans de Dolibarr et dans les PDFs.</span>

##### <span style="color: rgb(0, 0, 0);">Liste des options pour</span><span style="color: rgb(0, 0, 0);"> les PDFs :   
</span>

- <span style="color: rgb(0, 0, 0);">Ne pas afficher</span>
- <span style="color: rgb(0, 0, 0);">Afficher dans une colonne</span>
- <span style="color: rgb(0, 0, 0);">Afficher dans la colonne description après la description</span>
- <span style="color: rgb(0, 0, 0);">Afficher dans la colonne description uniquement si non vide</span>

##### <span style="color: rgb(0, 0, 0);">Liste des options pour les lignes sur les écrans Dolibarr :</span>

- <span style="color: rgb(0, 0, 0);">Jamais visible</span>
- <span style="color: rgb(0, 0, 0);">Visible sur les listes et les formulaires créer/mettre à jour/afficher</span>
    - <span style="color: rgb(0, 0, 0);">Vous pourrez voir les champs supplémentaires dans la pièce commerciale, et les modifier à l'ajout de la ligne, ou après l'ajout</span>
- <span style="color: rgb(0, 0, 0);">Visible sur les formulaires de mise à jour/affichage uniquement (pas en création)</span>
    - <span style="color: rgb(0, 0, 0);">Vous pourrez voir les champs supplémentaires, mais vous ne pourrez les modifier qu’après avoir ajouté la ligne.</span>
- <span style="color: rgb(0, 0, 0);">Visible sur le formulaire de consultation uniquement (pas en création, pas en mise à jour)</span>
    - <span style="color: rgb(0, 0, 0);">Vous pourrez voir les champs supplémentaires, mais ils ne seront pas modifiable avec le petit crayon.</span><span style="color: rgb(0, 0, 0);">  
        </span>[![image.png](https://doc.altairis.fr/uploads/images/gallery/2026-01/scaled-1680-/5BB0KLj3JTXjHB0h-image.png)](https://doc.altairis.fr/uploads/images/gallery/2026-01/5BB0KLj3JTXjHB0h-image.png)

<p class="callout info"><span style="color: rgb(0, 0, 0);">Note : les formulaires des pièces commerciales (devis, commandes, factures).</span></p>

##### <span style="color: rgb(0, 0, 0);">Exemples d'affichages :</span>

<span style="color: rgb(0, 0, 0);">**Afficher dans une colonne :**  
</span>[![image.png](https://doc.altairis.fr/uploads/images/gallery/2024-06/scaled-1680-/yfJpmGnbqviVFsCp-image.png)](https://doc.altairis.fr/uploads/images/gallery/2024-06/yfJpmGnbqviVFsCp-image.png)

<span style="color: rgb(0, 0, 0);">  
</span>

**<span style="color: rgb(0, 0, 0);">Dans la colonne description, après la description :</span>**

[![image.png](https://doc.altairis.fr/uploads/images/gallery/2024-06/scaled-1680-/3qR049w9ykRuTJsE-image.png)](https://doc.altairis.fr/uploads/images/gallery/2024-06/3qR049w9ykRuTJsE-image.png)

#### **<span style="color: rgb(0, 0, 0);">2.1.3- Modèles PDF compatibles  
</span>**

Tout les modèles PDF de Dolibarr ne sont pas compatible avec Gestion de garantie, car certains modèles sont plus vieux et ne prenaient pas encore en compte les attributs supplémentaires.

Les modèles compatibles sont les plus récents, c'est à dire ceux qui gèrent les attributs :

<table border="1" id="bkmrk-documents-mod%C3%A8le-com" style="border-collapse: collapse; width: 100%; height: 89.4px;"><colgroup><col style="width: 18.2739%;"></col><col style="width: 81.8453%;"></col></colgroup><thead><tr style="height: 29.8px;"><td style="height: 29.8px;">**Documents**  
</td><td style="height: 29.8px;">**Modèle compatibles**  
</td></tr></thead><tbody><tr style="height: 29.8px;"><td style="height: 29.8px;">Devis  
</td><td style="height: 29.8px;">Cyan  
</td></tr><tr style="height: 29.8px;"><td style="height: 29.8px;">Commandes  
</td><td style="height: 29.8px;">Eratosthène  
</td></tr><tr><td>Factures  
</td><td>Sponge  
</td></tr></tbody></table>

# 3- Pour finir

Question fréquentes, bonnes pratiques   
Licence, crédit et historique des modification

# 3.1- Questions fréquentes

#### <span style="color: rgb(0, 0, 0);">**3.1.1- Bonnes pratiques**</span>

<span style="color: rgb(0, 0, 0);">Ce chapitre répertorie les difficultés rencontrées avec le module. Vous y trouverez donc des éléments de réponse quant à son utilisation.</span>

<span style="color: rgb(0, 0, 0);">Si vous rencontrez une autre erreur que celles décrites ci-dessous lors de l'utilisation de ce module :</span>

1. 1. 1. <span style="color: rgb(0, 0, 0);">désactivez et réactivez le module ;  
            </span>
        2. <span style="color: rgb(0, 0, 0);">vérifiez sur le ChangeLog si une nouvelle version a été publiée et sa compatibilité avec votre version de Dolibarr ;  
            </span>
        3. <span style="color: rgb(0, 0, 0);">ré-installez/mettez à jour le module ;  
            </span>
        4. <span style="color: rgb(0, 0, 0);"> vérifiez qu'aucune incompatibilité avec un autre module ne soit indiquée ; le cas échéant, suivez nos préconisations.</span>

<span style="color: rgb(0, 0, 0);">Si, malgré ces manipulations, l'erreur persiste, contactez-nous en utilisant </span>[<span lang="en-US">notre interface de support.</span>](https://support.altairis.fr/)

<span style="color: rgb(0, 0, 0);"> Pour plus d’efficacité dans l’étude de votre demande, précisez :</span>

- - - <span style="color: rgb(0, 0, 0);">le nom et la version du module ;  
            </span>
        - <span style="color: rgb(0, 0, 0);">la version de Dolibarr ;  
            </span>
        - <span style="color: rgb(0, 0, 0);"> la liste des modules additionnels activés ;  
            </span>
        - <span style="color: rgb(0, 0, 0);"> tous les éléments nécessaires à la meilleure des prises en charge de votre demande, comme le contexte, les étapes successives pour reproduire l'erreur, captures d'écran, copie des messages d'erreur, etc.</span>

#### **<span style="color: rgb(0, 0, 0);">3.1.2- Difficultés rencontrées</span>**

<span style="color: rgb(0, 0, 0);">Un bug dolibarr fait que sur les pdf, dans la description, il est écrit "WarrantyMonth" au lieu de la traduction ("Garantie (mois)" en français par exemple) dans les versions antérieures à la v20.  
C'est un bug de dolibarr, pas du module.  
</span>

# 3.2- Informations pratiques

#### **3.2.1- Informations pratiques** 

##### <span style="color: rgb(0, 0, 0);">Liens directs</span>

<span style="color: rgb(0, 0, 0);">Pour accéder rapidement aux diverses ressources relatives au module, nous en avons listé les liens ci-dessous :</span>

- - - <span style="color: rgb(0, 0, 0);">Gestion de garantie sur <span style="color: rgb(24, 139, 175);">[notre site](https://www.altairis.fr/boutique/)</span></span>
        - <span style="color: rgb(0, 0, 0);">Le forum français : à venir  
            </span>

##### <span style="color: rgb(0, 0, 0);">Support</span>

<span style="color: rgb(0, 0, 0);">Nous assurons la maintenance corrective sur nos modules pendant un an à partir de leur date d'achat. Une interface de </span>[support ](https://support.altairis.fr/)<span style="color: rgb(0, 0, 0);">est à votre disposition pour signaler un bug rencontré. </span>

<span style="color: rgb(0, 0, 0);">Pour toute demande d'aide à l'utilisation, veuillez souscrire à l'un de</span> [nos forfaits de support](https://www.altairis.fr/assistance/).

#### **<span style="color: rgb(0, 0, 0);">3.2.2- Crédit et historique des modifications</span>**

<span style="color: rgb(0, 0, 0);">Pour la présente documentation du module Gestion des garanties de produits pour Dolibarr : </span>

<table border="1" id="bkmrk-version-auteurs-comm" style="border-collapse: collapse; width: 100%;"><colgroup><col style="width: 10.2596%;"></col><col style="width: 46.3378%;"></col><col style="width: 23.8723%;"></col><col style="width: 19.5303%;"></col></colgroup><tbody><tr><td><span style="color: rgb(0, 0, 0);">**Version**</span>  
</td><td><span style="color: rgb(0, 0, 0);">**Auteurs**</span>  
</td><td><span style="color: rgb(0, 0, 0);">**Date**</span>  
</td><td><span style="color: rgb(0, 0, 0);">**Licence** </span></td></tr><tr><td>1</td><td>Gebeer Lehnid ; Cloé Thévenon - Sarl ALTAIRIS

</td><td>Juin 2024</td><td>[GFDL](https://www.gnu.org/licenses/fdl-1.3.html "Gnu Free Documentation License")  
</td></tr><tr><td>  
</td><td>  
</td><td> </td><td>  
</td></tr></tbody></table>