Zakât - Stock immobilisé 1- Le module Zakât Présentation générale, installation, activation 1.1- Présentation 1.1.1 - Fonctionnalités Le module Zakât permet de calculer la valorisation des stocks immobilisés entre deux dates (par exemple au cours d’une année entière). Si on sélectionne la même date en début et fin, on a alors un instantané de stock à une date donnée. Le module se base sur les mouvements de stock (entrées, sorties), et peut donc « remonter » en arrière dans le temps. Le module vous présente la valorisation à l’achat et la vente de votre stock. Il est alors très facile de connaître : la valeur du stock immobilisé sur l’année précédente la valeur du stock à un instant donné 1.1.2- Compatibilité et conformité du module Il est conforme à la loi de finances 2016 . 1.1.3- Cible  Le module s'adresse à tous les utilisateurs de Dolibarr. Son utilisation ne nécessite aucune connaissance technique ou d'administration. 1.1.4 - Licence  Tous nos modules sont distribués sur le Dolistore et sur notre boutique en ligne sous licence GPL v3. 1.1.5 - Ressources  1.1.5.1- La présente documentation Nos guides utilisateur sont là pour vous accompagner dans l’utilisation de nos modules. Notre module Zakat est simple et facile a utiliser. 1.1.5.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.5.3- Forum sur dolibarr.org  Consultez toutes les informations sur le module dans les discussions du forum sur le fil dédié au module Zakât - Valorisation du stock immobilisé . 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. 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 plateforme de support . Par ailleurs, nous vous remercions de ne pas multiplier les canaux d'échange pour un même objet. 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. Cette documentation s'appuie sur le module en version 2024.03 avec Dolibarr version 19. En cas d'utilisation d'autres versions ou selon le thème utilisé, vous pourrez constater des différences de fonctionnement ou d'affichage.. 1.2.2-Pré-requis Le module Zakat est compatible avec Dolibarr à partir de la version 14 jusqu’à la 19.   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 notre boutique en ligne . L'accès aux mises à jour de nos modules est gratuit pendant 1 an à compter de la date d'achat. ! Important !   Avant tout changement de version de votre Dolibarr, assurez-vous que le module est officiellement compatible avec la version de Dolibarr que vous souhaitez l'installer. Pour mettre à jour un module, téléchargez-le à nouveau sur le Dolistore ou sur notre boutique en ligne   avec l'identifiant utilisé lors de l'achat initial. Nous rendons systématiquement disponibles en téléchargement sur le Dolistore ou sur notre boutique en ligne   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 bien utilisez la fonction de déploiement de module de votre Dolibarr dans A ccueil >  C onfiguration >  M odules/Applications : onglet D éployer un module externe. Note : Pour le bon déroulement d'une mise à jour, désactivez un module avant de lancer le remplacement de ses fichiers puis réactivez-le une fois la mise à jour terminée. 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ézipper 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 A ccueil > c onfiguration > M odules/applications, onglet D éployer un module externe. 1.3.2- Activation Activez le module en affichant la liste des modules depuis le menu :  A ccueil > c onfiguration > M odules/applications, onglet M odules/applications installés. Il sera affiché dans le tableau Altairis. Les pastilles et    indiquent l’état du module : pastille grisée, le module est désactivé. Pastille verte, le module est activé. Cliquez simplement sur la pastille pour activer ou désactiver le module. 1.3.3- Permissions Le module Zakât ne dispose pas de permissions. Les utilisateurs ayant accès aux stocks ont accès à Zakât. 1.3.4- Paramétrage La page de configuration du module est accessible depuis la liste des modules installés (accueil > configuration > modules/applications) en cliquant sur son icône    Vous pourrez choisir la méthode de calcul de la valeur du stock. Par défaut la valeur est calculée sur le Prix Moyen Pondéré. En cochant la case, la valeur sera calculée à partir du prix de revient du produit.   Le chapitre suivant vous détaille comment configurer votre module. 2- Utilisation Une fois le module Zakât activé, vous pouvez y accéder via : Produits / Services > Entrepôts > Zakât 2.1- Valorisation du stock immobilisé Une fois le module Zakât activé, vous pouvez y accéder via : Produits / Services > Entrepôts > Zakât 2.1.1- Options avant calcul Choisissez de filtrer sur un ou plusieurs entrepôts, ou bien ne choisissez pas d’entrepôt pour tout voir. Si vous avez une organisation d'entrepôts avec des sous-entrepôts, vous pouvez les inclure en cochant la case. En cochant ces cases, vous aurez le détail du nombre de stock par entrepôt. et la valorisation de chaque produit par stock entrepôt.   (cocher ces cases rajoute une colonne par entrepôt qui possède du stock sur le produit recherché). La date est par défaut sur le jour et le mois en cours sur une année.    ou   Vous pouvez cliquer sur "Maintenant" pour mettre la date du jour si cela ne s'est pas mis par défautl.   ou   Choisissez une date de début et une date de fin d’évaluation, en cliquant sur le petit calendrier ou en mettant directement la date.     Choisissez d’afficher ou non (case à cocher) les valorisation des prix de vente à zéro :   si certains de vos produits n’ont pas de prix de vente mais des prix d’achat que vous souhaitez scruter, cochez cette case. Choisissez d’afficher les produits en vente (tout, oui ou non) et les produits en achat (tout, oui ou non).   Cliquez sur le bouton pour  lancer le calcul 2.2- Possibilités de tri et filtres Une fois le tableau calculé et affiché, vous pouvez filtrer et afficher les données de manière plus fine. Voici un exemple de tableau généré par le bouton démarrer. Voyons les détails des filtres du tableau :     Vous pouvez faire une recherche sur une référence produit ou un libellé (ou une partie seulement de la réf ou du libellé) :    le résultat filtré s’affiche immédiatement. Ce menu permet de choisir le nombre de lignes à afficher à l’écran (10 ; 25 ; 50 ; 100 ; 200 ; 500 ; 1000 ou toutes).     En passant votre souris sur le bouton "Choix colonnes", ce menu apparaitra et vous pourrez cochez / décochez les colonnes à afficher en fonction de vos choix.      Vous pouvez réinitialiser en cliquant sur "Conf.initale" pour de nouveau tout afficher en bas du choix des colonnes.         En bas du tableau vous pouvez faire une recherche sur chaque colonnes du tableau le résultat filtré s’affiche immédiatement.     Tout en bas du tableau, vous avez les totaux de valorisation d’achat et de vente.   Tout en bas du tableau à droite vous pouvez  passer à la page suivante ou revenir à la page précédente s’il y a plusieurs pages. Vous pouvez également trier une colonne en cliquant sur son nom. Astuce vous pouvez mettre en surbrillance des lignes en cliquant dessus (cliquez de nouveau dessus pour enlever la surbrillance). 2.3- Export du tableau Si vous disposez du module Dolitools, vous pouvez exporter le tableau présent sur votre écran en cliquant sur le picto d’export qui s'ajoute au menu du haut de votre Dolibarr.  2.4 - Constantes cachées Voici les constantes que vous pouvez rajouter à votre Dolibarr pour une personnalisation plus poussée de votre module ZAKAT : ZAKAT_USE_COSTPRICE utiliser le prix de revient au lieux du pmp (prix moyen pondéré) ZAKAT_NO_NEGATIVE_VALORIZATION met à zéro tout le stock immobilisé qui est en négative ZAKAT_USE_CATALOG_PRICE (uniquement avec le module Prices/Gestion des prix) échange pmp par le prix de revient ZAKAT_VALODATE Défini par defaut la date de début et la date de fin identique à la date du jour (sinon, la date de début est 1 an avant la date de fin). 3- Pour finir Question fréquentes, bonnes pratiquesLicence, crédit et historique des modifications 4.1- Question fréquentes / Informations pratiques 7.1.1- Question fréquentes 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 Si, malgré ces manipulations, l'erreur persiste, contactez-nous en utilisant notre plateforme 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 ; Autres difficultés Aucune difficulté connue à ce jour. 7.1.2- Informations pratiques  Liens directs Pour accéder rapidement aux diverses ressources relatives au module, nous en avons listé les liens ci-dessous : La fiche du module sur notre site La discussion sur le forum français de dolibarr 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 . Crédit et historique des modifications Pour la présente documentation du module Gestion de prix pour Dolibarr :  Version Auteurs Date Licence 1 Gebeer Lehnid, Lotfi Lehnid - Altaris mars 2022 GFDL 2 Mélina Joum juillet 2024 GFDL 3 Agnès Rambaud octobre 2024 GFDL 4 - Non french documentation If you would like to read Zakât's documentation in English or Arabic, you can find them below. Please note that these versions are not up to date yet, we are working on it. Guide utilisteur Zakât - English Guide utilisateur Zakât - Arabic