Gestion des garanties de produits
Le module gestion de garantie est un module qui vous permet d'ajouter un attribut supplémentaire "garantie" sur vos produits, pour vous aider à gérer la période (en mois) de garantie de vos produits.
Cet attribut supplémentaire est ensuite affichable dans vos documents, devis, commandes, et factures 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
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
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
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.
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"
Exemples d'affichages :
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 |
Note : La garantie constructeur n'est pas encore affichable dans les PDF de Dolibarr, ce tableau sert donc d'indication uniquement pour les garanties standards.
3- Pour finir
Question fréquentes, bonnes pratiques
Licence, crédit et historique des modification
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 :
-
-
- désactivez et réactivez le module ;
- vérifiez sur le ChangeLog si une nouvelle version a été publiée et sa compatibilité avec votre version de Dolibarr ;
- ré-installez/mettez à jour le module ;
- vérifiez qu'aucune incompatibilité avec un autre module ne soit indiquée ; le cas échéant, suivez nos préconisations.
- désactivez et réactivez le module ;
-
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.
- le nom et la version du module ;
-
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
- Gestion de garantie sur notre site
-
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 |