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- 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- Le module gestions des garanties de produits

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- Le module gestions des garanties de produits

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.

image.png

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

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).

image.png

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"

image.png

Exemples d'affichages :

Afficher dans une colonne :
image.png


Dans la colonne description, après la description :

image.png

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

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- Pour finir

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 :

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