Gestion des garanties de produits

• 1- Le module gestions des garanties de produits
• 1.1- Présentation
• 1.2- Avant de commencer
• 1.3- Mise en route
• 2- Utilisation
• 2.1- Gérer vos garanties produits
• 3- Pour finir
• 3.1- Questions fréquentes
• 3.2- Informations pratiques

1- Le module gestions des garanties de produits

1.1- Présentation

1.1.1- Fonctionnalités 

Le module Gestion des garanties ajoute un attribut supplémentaire de ligne (extrafield) sur vos produits, pour indiquer leur période de garantie.

Cet attribut est supplémentaire peut être affichable dans les devis, commandes et factures, et dans leur PDF associés.

1.1.2- Cible 

Le module s'adresse à tous les utilisateurs de Dolibarr désirant ajouter une garantie à leurs produits.

1.1.3- Licence 

Tous nos modules sont distribués sur sur notre boutique en ligne et sur le Dolistore sous licence GPL v3. 

1.1.4- Ressources 

1.1.4.1- La présente documentation

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. 

1.1.4.2- Notre site de démonstration

Le module est installé sur notre environnement de démonstration. Connectez-vous avec l’identifiant demo et le mot de passe demo. 

1.1.4.3- Forum sur dolibarr.org

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. 

Voir la discussion sur le forum français pour le module Garanties.

Note : 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.

1.2- Avant de commencer

1.2.1- Avertissement

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. 

1.2.2- Pré-requis

Le module Gestion des garanties de produits est compatible avec Dolibarr à partir de version la version 14.

1.2.3- Maintenance 

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.

1.2.4- Mises à jour 

Les dernières versions de nos modules sont mises à disposition sur le Dolistore et sur la boutique en ligne d'Altairis. 

L'accès aux mises à jour de nos modules est gratuit pendant 1 an à compter de leur date d'achat.

Avant toute mise à jour, assurez-vous que le module est officiellement compatible avec la version de Dolibarr sur laquelle vous souhaitez l'installer.

Pour mettre à jour un module, téléchargez-le à nouveau sur le Dolistore ou la boutique en ligne d'Altairis 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.

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.

! Important !

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

1.3- Mise en route

1.3.1- Procédure d’installation 

Si vous avez accès aux fichiers de votre Dolibarr, dézippez l'archive du module dans le dossier custom de son arborescence.

Sur les versions récentes de Dolibarr, le module zippé peut être installé directement depuis la page :

Accueil > Configuration > Modules/Applications > onglet Déployer un Module Externe.

1.3.2- Activation 

Activez le module en affichant la liste des modules depuis les menus Accueil > Configuration > Modules/Applications > onglet Modules/Applications Installés. Il sera affiché dans le tableau Altairis.

1.3.3- Permissions

Il n'y a aucune permissions particulière pour ce module. À 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.

1.3.4- Paramétrage 

Vous pouvez trouver les paramétrages du module dans Accueil > Configuration > Modules/Application > module "garantie" en cliquant sur le petit rouage.

2- Utilisation

2.1- Gérer vos garanties produits

2.1.1- Ajouter une garantie manuellement

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.

Garantie vendeur :

Vous pouvez modifier la garantie d'un produit à tout moment, dans sa fiche produit en cliquant sur le petit crayon à côté du champ.
La garantie standard est exprimée en mois.

Garantie constructeur :

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 qui propose cette garantie, et de mettre un lien vers leur site (tout ceci peut être importé en masse via l'outil de Dolibarr).

 

2.1.2- Importer les garanties

Étant donné que les garanties sont des champs supplémentaires, vous pouvez les importer en utilisant l'import produit standard de Dolibarr.

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.

Vous pourrez aussi ajouter une colonne pour la marque et une autre pour un lien vers le site constructeur. 

2.1.2- Réglages

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 :

Accueil > Configuration > Modules/Application > module "garantie"

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.

Liste des options pour les PDFs : 

• Ne pas afficher
• Afficher dans une colonne
• Afficher dans la colonne description après la description
• Afficher dans la colonne description uniquement si non vide

Liste des options pour les lignes sur les écrans Dolibarr :

• Jamais visible
• Visible sur les listes et les formulaires créer/mettre à jour/afficher
• Visible sur les listes uniquement
• Visible sur les formulaires créer/mettre à jour/afficher uniquement (pas les listes)
• Visible sur les listes et formulaires de mise à jour/affichage uniquement (pas en création)
• Visible sur la liste et le formulaire de consultation uniquement (pas en création, pas en mise à jour)

Exemples d'affichages :

Afficher dans une colonne :

Dans la colonne description, après la description :

2.1.3- Modèles PDF compatibles

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 :

Documents	Modèle compatibles
Devis	Cyan
Commandes	Eratosthene
Factures	Sponge

3- Pour finir

3.1- Questions fréquentes

3.1.1- Bonnes pratiques

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.

Si vous rencontrez une autre erreur que celles décrites ci-dessous lors de l'utilisation de ce module :

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

Si, malgré ces manipulations, l'erreur persiste, contactez-nous en utilisant notre interface de support.

 Pour plus d’efficacité dans l’étude de votre demande, précisez :

• • • le nom et la version du module ;
      
    • la version de Dolibarr ;
      
    •  la liste des modules additionnels activés ;
      
    •  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.

3.1.2- Difficultés rencontrées

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.

3.2- Informations pratiques

3.2.1- Informations pratiques 

Liens directs

Pour accéder rapidement aux diverses ressources relatives au module, nous en avons listé les liens ci-dessous :

• • • Gestion de garantie sur notre site
      
    • Le forum français : à venir
      

Support

Nous assurons la maintenance corrective sur nos modules pendant un an à partir de leur date d'achat. Une interface de support est à votre disposition pour signaler un bug rencontré. 

Pour toute demande d'aide à l'utilisation, veuillez souscrire à l'un de nos forfaits de support.

3.2.2- Crédit et historique des modifications

Pour la présente documentation du module Gestion des garanties de produits pour Dolibarr : 

Version	Auteurs	Date	Licence
1	Gebeer Lehnid ; Cloé Thévenon - Sarl ALTAIRIS	Juin 2024	GFDL