Dolibarr ERP CRM Wiki - User contributions [en]

Loi finances sur les logiciels de caisse et Certification NF525 ou LNE

2023-04-03T09:24:35Z

Florian.mortgat: /* Conclusion pour le logiciel Open Source Dolibarr ERP CRM */ quelque → quel que

<seo metak="loi finance 2016, loi finance 2018, loi finance 2019, NF525, logs inaltérables, logiciels de caisse, logiciels comptabilité, TPE" />
Ceci est une page d'explication de l'Article 88 de la Loi finance 2016 (n° 2015-1785 du 29 décembre 2015), communément appelée Loi anti-fraude à la TVA, applicable au 1er janvier 2018 en France (cette loi ayant donné lieu à la certification NF525 ou encore au principe d'attestation de conformité).

=Résumé=

La '''loi finances 2016, article 88 modifiant le 286 du CGI''', impose à tous les commerçants, '''assujettis à la TVA hors franchise en base de TVA''' (et seulement ces derniers) ET qui sont équipés d'un "logiciel ou système de caisse" (comprendre logiciel d'encaissement d'argent, cela inclut les logiciels de gestion) ET qui réalisent de l'encaissement de particuliers, d'utiliser un logiciel dans un cadre "conforme" à la loi finance 2016, et ce dès le 1er janvier 2018.

La "conformité Loi Finance" dite aussi "Anti Fraude TVA" est absolument sans aucun rapport avec la notion de "Compatible avec les normes de logiciels comptables", normes requises pour établir les documents fiscaux officiels et les télétransmettre à l'administration. Ces normes (par exemple "la compatibilité avec le format FEC", obligatoire depuis le 1er janvier 2014 et [https://www.legifrance.gouv.fr/affichCodeArticle.do?cidTexte=LEGITEXT000006069583&idArticle=LEGIARTI000027804775 défini ici], ou encore "la compatibilité pour télétransmission EDI") existent d'ailleurs depuis plusieurs années, bien avant la loi finance 2016, et concernent uniquement le "logiciel de comptabilité" de l'expert comptable qui approuve les comptes, logiciel utilisé en fin de chaîne pour produire la liasse fiscale. Seul ce dernier logiciel a cette contrainte de "compatibilité logiciel comptable" : le logiciel de gestion ou de suivi de l'entreprise (comme par exemple Dolibarr), même si il est utilisé pour réaliser une comptabilité interne de l'entreprise (par exemple en préparation d'export vers le logiciel de l'expert-comptable, ou utilisé pour offrir un suivi ou mâcher le travail du comptable pour réduire son coût), n'a aucune obligation sur le point de '''logiciel comptable''', si c'est un autre qui sert pour établir les documents légaux...

Par contre, ce logiciel de gestion d'entreprise peut avoir l'obligation d'être '''conforme Loi finance 2016 - Anti Fraude TVA'''. Ce qui est tout autre chose. Cette conformité s'applique à tout "logiciel d'encaissements", ce qui est différent de "logiciel comptable" (et donc s'applique aux logiciels de facturation ou de gestion avec saisie d'encaissements, aux logiciels de caisse enregistreuse (Point de Vente) et, éventuellement, aux logiciels de comptabilité si c'est lui qui est utilisé pour saisir et suivre les encaissements clients, ce qui est rarissime car cela sous-entend que la gestion de l'entreprise est faite directement dans le logiciel du comptable qui certifie les comptes).

Cette conformité "Loi Finance" pour son logiciel d'encaissement, peut s'obtenir de 3 manières différentes ('''une seule des 3 solutions suffit'''):

*Par l'utilisation d'une version '''certifiée Loi Finance''' du logiciel (Exemple via l'obtention de la certification LNE ou l'obtention de la norme NF525 de l'AFNOR). Une version certifiée l'est pour tout le monde mais, pour évoluer, il faut attendre la prochaine version certifiée, et le processus de certification est long et coûteux pour l'éditeur. Le principe de certification n'est donc plus adapté aux logiciels modernes ni aux logiciels en Cloud/SaaS qui évoluent rapidement). Le choix de conformité du logiciel par obtention d'une certification LNE ou NF525 n'est donc pas celui fait majoritairement par les éditeurs. La certification LNE ou NF525 n'est donc absolument pas obligatoire (même si les éditeurs qui ont fait ce choix essaie de sous-entendre le contraire), à condition qu'une des autres solutions pour être conforme soit mis en oeuvre (voir point suivants).

ou bien

*Par obtention d'une '''attestation individuelle de conformité Loi Finance''' décernée par une société Tiers, comme un éditeur ou intégrateur informatique (Voici un exemple de modèle d'attestation suggéré par le gouvernement: http://bofip.impots.gouv.fr/bofip/10692-PGP.html). Une attestation est individuelle, chaque société utilisatrice doit en obtenir une, auprès d'un Tiers, pour elle même. Remarque: pour cette solution, il faut employer le terme de "Attestation" et non de "Certification", ce dernier terme étant réservé pour la première solution. Mais hélas 9 fois sur 10, on trouvera le terme "certification" ou "certifié" pour ce cas également, car le plus utilisé et mieux compris du grand publique, entrainant des confusions.

ou bien

*En '''se délivrant à soi-même cette attestation''' (sans la demander à un tiers donc), on parle d'auto-attestation, mais ce cas est limité aux sociétés qui ont, entre autre, une activité '''avérée''' d'édition de logiciel de caisse (le code Nace n'ayant qu'une valeur indicative statistique, c'est votre activité réelle, dont il vous revient d'en démontrer le côté avéré qui sera pris en compte, et non un code Nace spécifique comme cela avait été cité dans des versions intermédiaires de textes sur le travail de la loi)

Le chapitre "Historique" vous permet de voir les rebondissements et changements de direction de la loi. Connaitre ces rebondissements aide à comprendre pourquoi de nombreux acteurs se sont trompés ou continuent de se tromper sur cette loi. Le chapitre d'après "Questions / Réponses" vous offre une vue rapide de la loi '''définitive''' par une approche de questions/réponses.

==Historique de la définition de la loi et rebondissements==

Pour ceux qui ont le temps de lire (sinon allez directement au chapitre "Conclusion" ou aux "FAQ"), voici un flux qui décrit les documents originaux qui ont été communiqués par le gouvernement et les mises à jours qui ont suivi pour définir le périmètre et la conclusion de la loi, avec les rebondissements :

*Voici l'article, '''pour sa publication au BOFIP, de la version définitive du 04/07/2018''': https://bofip.impots.gouv.fr/bofip/10691-PGP.html?identifiant=BOI-TVA-DECLA-30-10-30-20180704

Pour résumer, cette publication indique qu'il faudra, pour toute société/organisme ''"... assujettie à la taxe sur la valeur ajoutée (TVA) qui effectue des livraisons de biens et des prestations de services à destination de clients particuliers et qui enregistre les règlements reçus en contrepartie au moyen d’un logiciel ou d'un système de caisse, est tenue d'utiliser un logiciel ou un système qui satisfasse aux conditions d'inaltérabilité, de sécurisation, de conservation et d'archivage des données en vue du contrôle de l'administration fiscale. ... Le respect des conditions d'inaltérabilité, de sécurisation, de conservation et d'archivage des données peut être justifié par un certificat délivré par un organisme accrédité '''ou''' par une attestation individuelle de l'éditeur. ..."''

Le texte mentionne bien également qu'il n'y a pas obligation à s'informatiser pour tracer ses paiements (''"... En revanche, cette disposition ne crée pas d'obligation de s'équiper d'un logiciel ou système de caisse..."'') mais si cela est fait, et que l'on est dans le périmètre, le texte est applicable.

'''Historique :'''

Voici l'article '''initial''' de la loi finance, datant du 29/12/2015: [https://www.legifrance.gouv.fr/affichTexteArticle.do?cidTexte=JORFTEXT000031732865&idArticle=LEGIARTI000031734740&dateTexte=20151230 Article sur LegiFrance]

Voici l'article, '''pour sa publication au BOFIP''', du 03/08/2016: https://bofip.impots.gouv.fr/bofip/10691-PGP.html?identifiant=BOI-TVA-DECLA-30-10-30-20160803

[[File:Warning.png]] 15 juin 2017: Communiqué de presse du cabinet du ministère: http://proxy-pubminefi.diffusion.finances.gouv.fr/pub/document/18/22503.pdf ->
Seules les "logiciels de caisse" seraient concernés (la définition de logiciel de caisse n'est toutefois pas encore apportée, elle le sera le 15 juillet 2018, voir la suite).
Dès logiciels ERP (comme Dolibarr), ainsi que les logiciels de site ecommerce (comme Prestashop, Magento, ...) n'étant dans pas la catégorie logiciels de caisse (Les ERP sont dans la catégorie logiciels de gestion), on aurait cru que l'obligation de mise en conformité, et tout ce qui suit, semblait ne plus être avéré pour eux, mais la suite des événements (voir la suite) indiquera le contraire si vous enregistrez dans le logiciel des paiements de particuliers, quelquesoit la catégorie du logiciel (seules les sociétés encaissant exclusivement d'autres sociétés, ou ceux en tva en franchise, seront finalement exemptées)...

[[File:Warning.png]] 27 septembre 2017: Voici l'avenant publié le 27 septembre 2017 qui réduit la portée/périmètre de la loi aux seuls "logiciels de caisse": http://www.assemblee-nationale.fr/15/projets/pl0235.asp (Article 46). En d'autres terme, les applications ERP (Comme Dolibarr) semblent la encore ne plus être concernées, mais la suite des événements (voir la suite) indiquera le contraire si vous encaissez des particuliers (seules les sociétés encaissant exclusivement d'autres sociétés, ou ceux en franchises seront finalement exemptées)...

Suite aux questions des industriels de l'informatique, une FAQ, issue du ministère des finances, est alors parue pour tenter de clarifier le périmètre. Elle indique que tous les assujetis à TVA qui vendent à un non assujetti (particuliers) sont concernés. Si on lit tel quel cette FAQ, alors le périmètre est non seulement pas réduit, comme communiqué par le ministère dans son courrier du 15 juin, mais élargit, y compris aux sites e-commerce. Cette FAQ est le premier élément qui apporte donc une définition au terme "système de caisse" en considérant tout logiciel traçant des encaissements, comme "systeme de caisse".
Des amendements ont été rédigés pour tenter de clarifier ou restreindre cette définition, voir la suite...

[[File:Warning.png]] 14 octobre 2017: Une reformulation du texte, plus complète que la FAQ, est donnée stipulant qu'une entité est concernée... "''Si elle effectue des livraisons de biens et des prestations de services ne donnant pas lieu à facturation conformément à l’article 289 et enregistre ces opérations au moyen d’un logiciel ou d'un système de caisse'' ... ". Dans ce cas, il faut "''... utiliser un logiciel ou un système satisfaisant à des conditions d'inaltérabilité, de sécurisation, de conservation et d'archivage des données en vue du contrôle de l'administration fiscale, attestées par un certificat délivré par un organisme accrédité dans les conditions prévues à l'article L. 433-4 du code de la consommation OU par une attestation individuelle de l'éditeur, conforme à un modèle fixé par l'administration ;''"

Il est aussi précisé: ''« 2. Les assujettis bénéficiant d'une franchise de taxe mentionnée à l'article 293 B, ceux placés sous le régime du remboursement forfaitaire prévu aux articles 298 quater et 298 quinquies et ceux effectuant exclusivement des opérations ou des prestations exonérées de taxe sur la valeur ajoutée sont dispensés de l'obligation mentionnée au 3° bis du I. » ; ''

Voir: [https://www.legifrance.gouv.fr/eli/loi/2017/12/30/CPAX1723900L/jo/texte/fr#JORFARTI000036339313 Article sur LegiFrance] pour le texte complet mentionnant ces 2 points.

[[File:Warning.png]] 20 novembre 2017: Nouveaux éléments permettant de mieux cibler le périmètre. En effet, l'amendement II-CF15 = II-1649 de la loi Finance 2018 sur l'article 46 pour exclure les encaissements de particuliers qui font l'objet de fabrication d'une facture en bon et du forme (afin d'exclure les ERP et plateforme ecommerce) a été rejeté en séance à l'assemblée: Seule l'encaissement de sociétés est bien hors périmètre. En effet, considérant que l'administration a le droit de vérification chez les clients de type société, les traces fournies par les factures suffisent pour assurer un contrôle satisfaisant, mais ce droit n'existe pas en ce qui concerne la facturation des particuliers. Dans ce cas la, même la facture est peu utile à l'administration et par conséquent les contraintes d'inaltérabilité deviennent requises, même si on émet une facture en bon et du forme. Cette conclusion fait suite aux échanges suites à l'amendement II-CF15 = II-1649 de la loi Finance 2018 sur l'article 46.

Pour info, texte complet de la tentative d'amendement: http://www.assemblee-nationale.fr/15/amendements/0235C/AN/1649.asp ou en PDF http://www.assemblee-nationale.fr/15/amendements/0235C/CION_TOUTE/CF15.pdf

Et voici les extraits importants de la discussion:

D'abord, la tentative de M. Bruno Millienne pour tenter d'exclure les logiciels émettant des factures en bon et du forme:

''M. Bruno Millienne. "[...]le renvoi à l’article 289 du code général des impôts – CGI – ne vise que les cas d’émission de factures obligatoires au sens fiscal pour les opérations entre assujettis ou personnes morales. En l’état, le texte conduirait à appliquer le dispositif de certification ou d’attestation à toutes les opérations réalisées avec les particuliers, même lorsqu’elles donnent lieu à l’émission de factures conformes au CGI, par exemple dans le cadre du commerce électronique. [...] La rédaction actuelle de l’article peut conduire à requalifier en logiciel de caisse un logiciel de facturation, si des factures sont émises à l’attention d’un particulier ou d’une administration, ou un logiciel de comptabilité, si des règlements sont comptabilisés directement par l’utilisateur. L’éditeur deviendrait ainsi responsable du mode d’utilisation de son logiciel par l’assujetti. Il est impossible de transposer les exigences d’un logiciel de caisse à un logiciel de facturation : leurs fonctionnalités respectives sont totalement différentes. Actuellement, il existe des dispositifs de certification en matière de caisse, mais pas en matière de facturation."''

''...''

Réponse de ''M. Joël Giraud, rapporteur général de la commission des finances, de l’économie générale et du contrôle budgétaire: Avis défavorable. L’article 46 précise que l’obligation de certification ne vaut que pour les logiciels ou systèmes de caisse. L’obligation ne concernera plus les progiciels de gestion intégrée ou de comptabilité : pour ces logiciels multifonctions qui traitent à la fois la comptabilité, la gestion et la caisse, seuls les modules caisse enregistreuse et encaissement devront être certifiés, non l’ensemble du logiciel.''

''...''

Et enfin le complément de ''M. Benjamin Griveaux, secrétaire d’État auprès du ministre de l’économie et des finances: Avis défavorable. Une facture n’est obligatoire, au sens fiscal, que dans le cadre d’une relation B to B – business to business, c’est-à-dire d’entreprise à entreprise. L’administration fiscale peut la contrôler car elle dispose d’un droit de communication envers l’entreprise cliente. A contrario, elle ne peut exercer de droit de communication auprès des particuliers. Cet amendement conduirait donc à exclure du dispositif de sécurisation les entreprises qui émettent des factures contenant les mentions légales, qu’elles soient adressées à des entreprises ou à des particuliers. Je suis donc l’avis du rapporteur général quant au risque de fraude accrue que cet amendement ferait courir.''

La discussion complète de la séance ayant rejeté l'amendement est disponible ici: http://www.assemblee-nationale.fr/15/cri/2017-2018/20180063.asp#P1103690

'''En conclusion, l'amendement ayant été rejeté, il faut en déduire que la volonté est bien d'intégrer, dans le périmètre, toutes les parties/modules de logiciels, utilisés comme caisse enregistreuse OU pour enregistrer des paiements de particuliers (logiciel ecommerce, de caisse, de gestion,...)''' et que l'émission de facture en bon et du forme à des particuliers ne suffit pas pour sortir du périmètre...

[[File:Warning.png]] 30 décembre 2017:

L'article 88 qui disaient ''..toute personne assujettie à la taxe sur la valeur ajoutée (TVA) qui enregistre les règlements de ses clients au moyen d'un logiciel de comptabilité ou de gestion ou d'un système de caisse, doit utiliser un logiciel ou un système satisfaisant à des conditions d'inaltérabilité, de sécurisation, de conservation et d'archivage des données en vue du contrôle de l'administration fiscale''
est complété par l'article 105 qui remplace "''logiciel de comptabilité ou de gestion ou d'un système de caisse''" par "''logiciel ou d'un système de caisse''"

[[File:Warning.png]] 23 janvier 2018: Un représentant du projet Dolibarr, avec des représentants de l'APRIL et du logiciel libre de caisse Pasteque, ont été reçus au ministère des finances afin d'échanger sur l'interprétation du texte. Les interprétations faites sur cette page (ainsi que les réponses faites aux FAQ qui suivent) ont pu être confirmées.
Toutefois, il y a intention de réduire le périmètre aux seuls logiciels de caisse. A suivre donc. Une version de travail revue, du Bofip doit être publiée à un comité restreint d'acteurs, dont l'April, fin janvier, afin de faciliter le travail d'interprétations, pour une publication officielle au printemps. En attendant, on ne peut qu'attendre (Cette publication aura lieu finallement le 4 juillet 2018 et une grande partie de nos retours s'avèrera prise en compte).

[[File:Warning.png]] 18 mai 2018: Réponse du gouvernement à quelques questions sur le sujet: https://www.nosdeputes.fr/15/question/QE/3257 . La réponse évoque l'année de tolérance en précisant que l'utilisateur devra montrer sa diligence en cas de contrôle (Soin appliqué à la mise en oeuvre de l'obtention de l'attestation individuelle)

[[File:Warning.png]] 5 juin 2018: Réponse du gouvernement à quelques questions sur le sujet: https://www.nosdeputes.fr/15/question/QE/2736 . La réponse évoque l'année de tolérance en précisant que l'utilisateur devra montrer sa diligence en cas de contrôle (Soin appliqué à la mise en oeuvre de l'obtention de l'attestation individuelle)

[[File:Warning.png]] 4 juillet 2018: Publication de la version corrigée du texte de loi au BOFIP: https://bofip.impots.gouv.fr/bofip/10691-PGP.html?identifiant=BOI-TVA-DECLA-30-10-30-20180704. Cette version conforte tous les points évoqués (le texte clarifie la loi et confirme que les interprétations vu ci-dessus s'avéraient justes), avec toutefois 2 ajouts majeures:

*La définition de logiciel de caisse a été donnée:

''Un logiciel ou système de caisse est un système informatique doté d'une fonctionnalité de caisse, laquelle consiste à mémoriser et à enregistrer extra-comptablement des paiements reçus en contrepartie d'une vente de marchandises ou de prestations de services c'est-à-dire que le paiement enregistré ne génère pas concomitamment, automatiquement et obligatoirement la passation d'une écriture comptable.''

''Ne sont pas considérés comme enregistrés extra-comptablement, quel que soit le mode de paiement, les paiements pour lesquels le logiciel ou système déclenche obligatoirement, instantanément et automatiquement, sans intervention humaine, une écriture dans le système d’information comptable.''

''Sont visés tous les logiciels ou systèmes de caisse permettant l'enregistrement des règlements de leurs clients quel que soit le mode de règlement (espèces, chèques, CB, virements, prélèvements...).''
Cette obligation s'applique y compris en cas d'enregistrement sur un logiciel ou système accessible en ligne.

''Sans que cette liste ne soit limitative, sont concernés par l'obligation les instruments de mesures réglementés, comme les balances, mais également les rampes de boissons automatisées, les automates de paiement ou encore les distributeurs automatiques de marchandises (boissons, gâteaux…) qui disposent d'une fonctionnalité de caisse.''

''Seule cette fonctionnalité de caisse, et non les autres fonctions telles que celles relatives à la pesée, doivent être certifiées.''"

*L'article 35 qui est un allègement du périmètre: Les professionnels réalisant leur paiement avec l'intermédiation d'un établissement de crédit européen ne sont plus soumis à l'obligation de certification ou attestation. Mais attention, on parle bien de paiements "directs" (donc Virement ou Carte de Débit ou de Crédit mais pas chèques qui n'est pas "direct") et surtout via un système de paiement géré par un organisme bancaire européen. En d'autres terme, si on ne fait que du paiement CB avec un module de VAD d'une banque, on est NON soumis à la certification/attestation mais si le paiement CB (carte de crédit ou débit) se fait par un service comme Stripe ou Paypal, sauf à être exempté pour un autre motif, on l'est toujours (car l'état français n'a pas de moyen d'obtenir le listing des transactions via ces solutions non européennes, bien que le paiement soit par carte bancaire).

==Conclusion pour le logiciel Open Source Dolibarr ERP CRM==

Dolibarr ERP CRM est une application de gestion qui enregistre des factures (factures acomptes, avoirs ou standards). L'application permet aussi d'enregistrer des paiements. Le module POS (celui fourni par défaut appelé TakePOS), fonctionne aussi sur le principe de génération systématique de facture et d'enregistrement du paiement en temps réel. L'application est donc bien dans le périmètre (comme n'importe quel autre ERP, logiciel de caisse ou de Ecommerce). Mais en tant qu'utilisateur, vous n'êtes concerné que si vous n'êtes pas en franchise de base ET si vous l'utilisez pour saisir des '''encaissements''' de particuliers (B2C=Business To Consumer) ou en mode mixte, à savoir encaissement aussi bien de particuliers (B2C) et d'entreprises (B2B), quel que soit le ratio entre les 2. Si vous ne facturez QUE des professionnels, dans ce cas, vous n'êtes pas concerné par la LF2016 (Loi finance 2016, applicable depuis 2018).

Dans le cas où vous utilisez le module Facture, ou le module POS, pour encaisser des particuliers, et êtes assujettis à la TVA mais pas en franchise, vous êtes concerné. Il vous faut alors vous assurer que le module "Log inaltérable" ("BlockedLog") est bien activé. Sa désactivation, une fois les premières saisies faites ne sera ensuite plus envisageable. Avec Dolibarr v10 ou plus et l'activation de ce module vous aurez alors une version conforme sur le plan technique et fonctionnel. Il vous faudra ensuite, obtenir une attestation de conformité auprès d'un tiers qui confirme cette conformité technique/fonctionnelle pour être conforme d'un point de vue juridique. Si vous utilisez une version en ligne SaaS/Cloud fournie par un tiers, ce dernier vous la fournira sûrement (voir exemples sur https://saas.dolibarr.org). Dans le cas contraire, il vous faut contactez votre intégrateur informatique ou un prestataire pouvant fournir cette d'attestation.

Remarque: cette contrainte sera identique quel que soit l'ERP choisi. L'utilisation d'outils non spécialisés comme un tableur Excel ou autre, DANS LE BUT D'AVOIR UNE CONSERVATION DE TRACES DES PAIEMENTS, ne devient plus permis car le logiciel n'étant pas conforme, vous ne réussirez pas à trouver un prestataire pour fournir l'attestation de conformité. Par contre, si l'utilisation que vous faites d'Excel ou autre tableur est à des fins juste de "génération du PDF de la facture" sans ''conservation des données'' (Le texte de loi parle alors de logiciel "facturier"), vous pouvez continuer à l'utiliser ainsi. Dans le cas où l'utilisation est faite pour conserver trace de vos paiements, et si vous êtes dans le périmètre de la loi, un logiciel '''certifié OU attestable''' sur la partie encaissement (comme l'est Dolibarr) devient obligatoire.

Voyons aussi, par une autre approche, à savoir un système de question-réponse, comment synthétiser autrement tout cela:

=Questions / Réponses (FAQ)=

==J'utilise Dolibarr ou autre logiciel ERP, suis-je concerné, pour quelle fonctionnalité ?==

*Votre logiciel n'est concerné que si vous êtes '''assujetties à la TVA (et pas en franchise en base de TVA)''', ET si vous l'utilisez pour saisir des '''encaissements de particuliers''' (B2C=Business To Consumer) ou en mode mixte, à savoir encaissement aussi bien de particuliers (B2C) et d'entreprises (B2B), quelque soit le ratio entre les 2, quelque soit les modes de paiement utilisés (sauf à ne faire que du paiement direct par l'intermédiation d'un organisme bancaire européen). Donc:
**si vous n'encaissez pas d'argent, vous n'êtes PAS concerné.
**si vous êtes une association/organisme non assujettie à la TVA (association, médecin, ...), vous n'êtes PAS concerné.
**si vous êtes un professionnel bénéficiant du régime de remboursement forfaitaire de TVA agricole, vous n'êtes PAS concerné.
**si vous êtes un auto-entrepreneur, vous n'êtes (peut-être) PAS concerné (dispense si vous relevez de la franchise en base).
**si vous êtes une entreprise dont l'intégralité des encaissements est réalisée avec l'intermédiation directe d’un établissement de crédit (système de paiement VAD d'une banque ou Virements), vous n'êtes PAS concerné. Remarque: Des encaissements par Carte bancaire via Paypal ou via Stripe ne sont pas des encaissements avec intermédiation directe d’un établissement de crédit, car ni Paypal ni Stripe ne sont des établissements de crédit (comprendre Banque).
**si vous ne facturez QUE des entreprises/professionnels, dans ce cas, vous n'êtes PAS concerné non plus par la loi finance (non B2C). Remarque: Si vous facturez des professionnels la plupart du temps et, exceptionnellement de temps en temps des particuliers via un mode de paiement non assuré par un organisme de crédit européen, si vous pouvez gérer/suivre ces facturations de particuliers à part sur papier, vous sortez alors du champ et n'êtes pas concerné.

Si vous n'êtes dans aucun des cas d'exception précédent, vous êtes concernés si vous utilisez le module Facture pour enregistrer vos paiements et/ou le module POS. Il vous faut alors vous assurer que le module "Log inaltérable" ("BlockedLog") fourni avec la v10 ou plus est bien activé. Sa désactivation, une fois les premières saisies faites ne sera ensuite plus envisageable. Avec la migration en v10 ou plus et l'activation de ce module vous aurez alors une version conforme sur le plan technique et fonctionnel. Il vous faudra ensuite, obtenir une attestation de conformité auprès d'un tiers qui confirme cette conformité technique/fonctionnelle pour être conforme d'un point de vue juridique.

Si vous utilisez une version en ligne Saas/Cloud fournie par un tiers, ce dernier vous la fournira surement (exemple: https://www.dolicloud.com ou https://www.novafirstcloud.com). Dans le cas contraire, il vous faut contactez votre intégrateur ou un prestataire pouvant fournir cette d'attestation.

Remarque: cette contrainte sera identique quelque soit l'ERP choisi. L'utilisation d'outils non spécialisés comme un tableur Excel ou autre, DANS LE BUT D'AVOIR UNE CONSERVATION DE TRACE DES PAIEMENTS, ne devient plus permis car le logiciel n'étant pas conforme, vous ne réussirez pas à trouver un prestataire pour fournir l'attestation de conformité. Par contre, si l'utilisation que vous faites d'Excel ou autre tableur est à des fins juste de "génération du PDF de la facture" sans ''conservation des données'' (Le texte de loi parle alors de logiciel ''facturier''), vous pouvez continuer à l'utiliser ainsi. Dans le cas ou l'utilisation est faite pour conserver trace de vos paiements, et si vous êtes dans le périmètre de la loi, un logiciel '''certifié OU attestable''' sur la partie encaissement (comme l'est Dolibarr) devient obligatoire (dans le cas d'un logiciel non certifié mais attestable comme Dolibarr, il vous faudra obtenir une attestation papier ou PDF d'un Tiers).

==Je suis concerné, mais à partir de quand ?==

*Si vous êtes concerné, la loi s'applique au 1er janvier 2018. Toutefois, le texte de loi clarifié datant de juillet 2018, si on ajoute le temps requis par les logiciels pour s'adapter à la version définitive, puis le temps de migration sur la nouvelle version, une tolérance est de mise la première année (donc 2018), à condition de montrer que vous suivez le sujet et avez attendu pour avoir le texte définitif puis pour avoir la version conforme puis pour avoir le bon moment de faire votre migration. Si vous utilisez Dolibarr, les différentes évolutions de cette page montre que la démarche est engagée sur le logiciel depuis novembre 2016 et ce alors que le périmètre de la loi était encore contradictoire début novembre 2017.

A la question posée en janvier 2018 au ministère des finances: "Que pouvons nous dire aux utilisateurs qui sont en attente de texte/règle clarifiée pour agir, sachant que la loi est sensé être déjà effective ?", la réponse donnée a été que la première année (2018 donc), il y aurait tolérance, dès lors que vous montrez que vous avez pris une trajectoire sur 2018 pour bien faire. Cette année transitoire ayant été officiellement annoncée par le secrétaire d'état, dont voici les propos:

''« Je veux toutefois rassurer les entreprises : la direction générale des finances publiques les accompagnera pendant la première année d’application de ce dispositif, en vertu non pas d’une culture de la sanction ou du contrôle fondée sur le présupposé d’une malveillance des entreprises, mais d’un rôle de conseil. La DGFIP tiendra notamment compte des démarches engagées et des diligences effectuées par les entreprises pour obtenir le certificat ou l’attestation. C’est dans cet esprit que nous travaillerons. Les deux organismes certificateurs prendront également leur part de cet effort de pédagogie, qui est normal. »''

==La nécessité d'attestation ou certification disparaît-elle si on n'enregistre nos paiements que via un mode de règlement qui laisse déjà des traces, comme les chèques ou cartes ?==

Au départ, le type de règlement n'avait aucun impact sur la loi. Tous les types de paiement (chèque, carte, liquide, virement, ...) rentrent dans le périmètre de la loi et aucun ne permet d'être hors du champs d'application. L'amendement suivant https://www.nosdeputes.fr/15/amendement/235/1325C a tenté de restreindre le périmètre à un certain mode de paiement, mais a été rejeté.

Ceci se comprend dans la mesure où, même un paiement par carte, peut se faire via un système comme Paypal ou Stripe, et que l'administration fiscale française a très peu de pouvoir de contrôle sur une société étrangère.
Toutefois, il existe des cas où l'administration fiscale a un pouvoir de contrôle, c'est pourquoi, dans la re-publication au BOFIP de la loi le 4 juillet 2018, une exception a été introduite: Les professionnels réalisant leur paiement avec l'intermédiation directe d'un établissement de crédit européen ne sont plus soumis à l'obligation de certification ou attestation. Mais attention, on parle bien de paiements "directs" (donc Virement ou Carte de Débit ou de Crédit, mais pas chèques qui n'est pas "direct") et surtout via un système de paiement géré par un organisme bancaire européen. En d'autres terme, si on ne fait que du paiement CB avec un module de VAD d'une banque, on est NON soumis à la certification/attestation mais si le paiement CB (carte de crédit ou débit) se fait par un service comme Stripe ou Paypal, sauf à être exempté pour un autre motif, on l'est toujours (car l'état français n'a pas de moyen d'obtenir le listing des transactions via ces solutions, bien que le paiement soit par carte bancaire).

==Quelles sont les conditions pour une application concernée pour être conforme (conditions pour obtenir la certification OU être attestable conforme par un tiers) ?==

*Principe d'inaltérabilité
**Logs non modifiable par chaînage (principe de somme de contrôle incluant la somme de contrôle de la trace précédente) pour tout ce qui concerne les saisies d'encaissements (incluant toutes les mentions obligatoires d'une facture). Il est possible d'aller au delà de la loi en traçant aussi ce qui concerne les factures et leur envoi sur une imprimante. Aucune fonction pour modifier ou supprimer ces logs ne doit exister.
**Quand un paiement est enregistré, la trace et les informations qui ont donné lieu à ce paiement (information du paiement mais aussi de la facture ne peuvent plus être modifier). Rem: Il est toujours possible de faire des modification sur l'objet de gestion mais la trace historique (la log archivée) doit rester non modifié et fidèle à l'acte d'origine. Et si un changement est fait, ce changement doit lui aussi être tracé et reprendre toutes les nouvelles informations et être lui aussi non effaçable, non modifiable.

*Conservation sur 6 ans ou plus (Remarque: Dolibarr conserve les données en base à vie)

*Fonction "Archiver" annuellement qui permet d'exporter dans un fichier externe dans un format lisible sans le logiciel, et par l'administration, pour consulter l'archive (et retrouver les infos d'origine qui composaient la facture, les paiements).

*Fournir, soit la certification de conformité du logiciel, soit une attestation de conformité (Voir dans les FAQ plus loin "Quel éditeur peut fournir des attestations pour ma version ?" sur comment l'obtenir)

!!! En d'autres termes, il ne sera plus possible d'utiliser des logiciels tableurs comme Excel ou Google Apps, ni autre solution développée soi même pour avoir une trace et conservation de vos paiements, sans considération de cette loi (sauf à continuer de saisir en parallèle soit dans un autre système conforme, soit sur le bon vieux carnet à souche). Mais vous pouvez continuer à utiliser votre tableur à des fins de logiciel pour générer vos Factures (la loi parle de "logiciel facturier") si il n'y a pas de conservation de données (le logiciel est alors considéré comme simple facturier et donc hors périmètre).
Pour un suivi et conservation de vos encaissements via un outils informatique, des logiciels, conforme loi finance 2016 comme Dolibarr ERP CRM v10 ou + deviennent alors obligatoires, dès lors que l'on est concerné (voir FAQ '''...suis-je concerné...''').

==Quelle est la différence entre certification et attestation ?==

La certification est une procédure par laquelle une tierce partie, l’organisme certificateur (Par exemple la LNE ou L'AFNOR), donne une assurance écrite qu’un système d’organisation, un processus, une personne, un produit ou un service est conforme à des exigences spécifiées dans une norme ou un référentiel. Elle est encadrée par le Code de la Consommation. Sur un logiciel, la certification est faite pour une version donnée sur le périmètre de l'application ou d'une partie de l'application uniquement. Chaque nouvelle version devant être re-certifiée.

L'attestation de conformité est fournie par une tierce partie également, mais ce dernier n'a pas besoin d'être un organisme certifiant. Il peut s'agir de n'importe quelle société. C'est souvent l'éditeur du logiciel, mais il peut s'agir en fait de n'importe quelle société. Cette attestation est une déclaration par laquelle l’éditeur témoigne et s’engage à ce que le système d’encaissement qu’il atteste respecte les conditions d’inaltérabilité, de sécurisation, de conservation et d’archivage des données. L'attestation est elle aussi valable pour une version et éventuellement un paramétrage donné.

Dans le cadre de la loi des finances pour 2016, et si vous êtes dans le périmètre de cette loi (voir autres FAQ), vous devez, soit avoir un logiciel "certifié", soit avoir un logiciel "attesté conforme" (Notez que le terme "certifié" est souvent utilisé dans les textes (plus rarement dans le texte définitif de la loi) comme raccourci pour signifier "certifié ou attesté conforme".

==L'application Dolibarr sera-t-elle certifiée par l'éditeur ?==

Pour Dolibarr, et de nombreux logiciels Open Source, il n'y a pas un éditeur bien identifié car de nombreuses sociétés différentes contribuent à son évolution.

Au sens de la loi, l'éditeur du logiciel est le '''"dernier" qui a modifié/validé le code'''. L'entité qui postule pour une certification peut donc être, aussi bien l'association Dolibarr, comme tout intégrateur, hébergeur ou autre institution externe.

Il est possible que l'association Dolibarr, qui a pour rôle la promotion du logiciel, fasse les démarches pour obtenir la certification pour certaines versions majeures, celles qui sont officiellement packagées par le release manager et qui sont mises à disposition sur l'espace de téléchargement officiel par l'association. Dans cette éventualité, seules quelques versions bien identifiées feront l'objet d'une demande de certification. Toutefois, cette obtention de certification qui fige une version (Certification LNE ou certification NF525) n'est pas obligatoire pour être conforme et non adapté avec les lois du marché qui veut qu'un logiciel doit évoluer très vite. L'autre solution, celle de l'obtention d'une attestation s'avère donc recommandée et plus simple.
Nous encourageons donc les utilisateurs qui ont obligation d'utiliser un logiciel conforme anti-fraude à la TVA selon la loi finance 2016 (donc les assujettis à TVA hors franchise de base, et qui facture/encaisse des particuliers) à '''se tourner vers la solution d'attestation'''. Voir point suivant.

==L'attestation de conformité, autre possibilité, sera-t-elle fournie par l'éditeur ou autre tiers ?==

L'autre solution pour être en règle est d'obtenir une attestation de conformité de votre logiciel de suivi des encaissements.

En tant qu'utilisateur, et si vous êtes dans le périmètre de la loi, vous pourrez obtenir une attestation auprès de n'importe quel tiers/intégrateur prêt à la fournir (en général moyennant finance), ou vous la délivrer à vous même si vous êtes une société d'édition de logiciel. Voir les 2 FAQ suivantes pour savoir qui pourra délivrer les attestations de conformité...
Dans le cas d'un logiciel hébergé en Saas, la société qui propose la solution en Saas fournira souvent cette attestation mais parfois non (voir point suivant).

==Quel éditeur peut fournir des attestations pour ma version, à quel prix ?==

N'importe quelle société qui a les compétences pour analyser le logiciel et vérifier que ses fonctionnalités sont bien en règle peut fournir une attestation à autrui. Le code d'une application libre étant ouvert, toute société compétente dans la technologie du produit, peut maîtriser le code aussi bien que les développeurs initiaux. Une telle société peut donc être qualifiée d'"éditeur", même si elle n'a pas produit ou très peu produit de code au projet final, et par conséquent, et à même de fournir un attestation individuelle à ses clients.

Le BOFIP dit clairement:

"310. Lorsque le logiciel ou système est conçu de manière ouverte pour permettre son adaptation aux besoins spécifiques des clients, on entend par « éditeur » qui peut valablement demander la certification ou fournir l'attestation individuelle."

Bref, si vous utilisez une version en ligne SaaS/Cloud fournie par un tiers, ce dernier vous la fournira surement (Exemple avec https://www.dolicloud.com ou encore https://www.novafirstcloud.com). Dans le cas contraire, il vous faut contactez votre intégrateur ou un prestataire pouvant fournir cette d'attestation. Remarque: cette contrainte sera identique quelque soit l'outil informatique d'enregistrements des encaissements qui aura été choisi.

En ce qui concerne le prix, tout dépend du tiers qui fournit l'attestation. Certains, par exemple, pourront donner l'attestation gratuitement à condition d'héberger le logiciel attesté chez eux. D'autres vous feront payer la prestation d'audit et la délivrance de l'attestation. Cela peut être de manière récurrente si l'attestation doit être réémise régulièrement suite à modification/mise à jour de l'application.

==La loi finance est-elle compatible avec les licences libres de logiciels de caisse ?==

Si le logiciel libre n'est pas un logiciel qui réalise des encaissements ou si vous n'encaissez que des entreprises, la question ne se pose même pas puisque la loi ne s'applique pas à ces cas.

Si le logiciel libre est un logiciel d'encaissements et que les clients encaissés sont des particuliers, alors oui, le logiciel libre est parfaitement compatible:

Le paragraphe 40 du BOI le dit explicitement en reconnaissant aux utilisateurs la possibilité « ''d'adapter le logiciel à leurs besoins spécifiques'' » :

"''... Sont notamment concernés les logiciels de comptabilité ou de gestion dits "libres" ou développés en interne, c'est-à-dire développés par l'assujetti lui-même. On entend par logiciel libre un logiciel dont les utilisateurs ont un libre usage, une libre étude, une libre modification et une libre distribution. Ces libertés permettent aux utilisateurs d'adapter le logiciel à leurs besoins spécifiques. Les modifications que les utilisateurs peuvent apporter au logiciel libre ou développé en interne ne doivent pas avoir pour objet ou pour effet d'altérer le respect des conditions d'inaltérabilité, de sécurisation, de conservation et d'archivage décrites ci-dessous...''"

Par ailleurs, le paragraphe 310 évoque à nouveau le cas des logiciels « conçus de manière ouverte », c.à.d les logiciels libres.

Donc, aucune objection à utiliser des logiciels libres. Mais attention, l'autorisation de modification est restreinte au code et paramètres "triviaux". En effet, que ce soit lors d'une utilisation de la version certifiée ou d'une version rendue conforme par obtention d'une attestation de conformité, la nouvelle loi vous prive d'une partie de votre liberté de '''modifier le logiciel de caisse SUR LES PARTIES qui concernent les fonctions d'inaltérabilité, sécurisation, conservation et archivage'''. En effet, en faisant une telle modification, la version est considérée comme changée de manière "non triviale", aussi la certification n'est plus valable, l'attestation d'un tiers non plus. Les logiciels libres sont donc tout à fait légaux et compatible avec la loi, par contre, c'est à condition de ne pas faire n'importe quelle modification. Vous perdez donc une partie de votre liberté (non pas du fait de la licence du logiciel qui le permet, mais du fait de la loi qui est prioritaire sur les droits accordés par la licence). Le logiciel libre est donc bien compatible avec la loi, mais la loi vous prive d'une des 4 libertés que le logiciel libre apportait, celle de le modifier librement. Vous pouvez toujours le faire, mais à condition que cela ne porte pas sur le comportement de l'encaissement, ou, si cela porte sur celui-ci, que vous ré-obteniez soit la certification à nouveau (complexe et long), soit une nouvelle attestation d'un éditeur ou intégrateur.

==Pour ma propre utilisation, puis-je m'auto-délivrer l'attestation de conformité pour une version que j'ai modifié moi même sur les parties d'encaissements==

Uniquement un nombre très restreints d'entreprise le pourront, celles qui sont dans le domaine de l''''Edition de logiciel de comptabilité ou de gestion ou de système de caisse'''. Toutefois, sur le plan juridique une telle classification n'existe que par les faits. En effet, on serait tenté de penser que les entreprises ayant le codes NACE (Code NACE = terme européen du code NAF/APE) '''58.29''' qui signifie '''Edition de logiciel autre''' et/ou '''62.01Z''' qui signifie '''Développement de logiciels''' pourrait être qualifiées. Toutefois, il faut avoir en tête que le code APE est "''attribué par l'INSEE à des fins statistiques, et ne saurait suffire à créer des droits ou des obligations pour les entreprises''" (Ceci est dans le décret qui approuve la nomenclature: décret n° 2007-1888 du 26 décembre 2007, article 5, point I). Dans la réalité, ce code est malgré tout utilisé pour avoir des présomptions d'activité au niveau fiscal ou administratif. Donc, c'est un avantage, mais aucunement une garantie et inversement, une entreprise n'ayant pas cette classification peut avoir des arguments suffisamment solide pour démontrer son activité d'"éditeur de logiciel de caisse". <ref>BOI-TVA-DECLA-30-10-30-20180704, point 375</ref>

==Je suis intégrateur ou développeur informatique, je sais que Dolibarr v10 et ultérieur répond aux exigences de conformité, puis-je délivrer l'attestation de conformité, à mon client qui est en v10 ou plus, moi même ?==

Oui. A vous de fournir/indiquer à votre client la version/paramétrage que vous attestez. Avec Dolibarr, vous pouvez générez la signature de la version et paramétrage que vous attestez avec l'outil '''generate_filelist_xml.php''' fourni avec les sources de l'application.
Cette signature vous permettra de vérifier que votre client n'a pas fait de '''modification de code ou paramétrage sur les parties qui concernent l'encaissement'''. Auquel cas, il devient l'éditeur, et votre attestation en tant qu'éditeur n'est plus valide, vous n'êtes alors plus responsable d'une apparition d'une fonctionnalité non conforme dans le logiciel.

==Je suis intégrateur ou développeur informatique, quel outil ai-je à ma disposition pour m'assurer que les exigences sur le logiciel sont bien assurées par une version installée de Dolibarr==

Les versions 10.0 et supérieures contiennent l'ensemble des exigences et notamment le module "Log inaltérable" qu'il vous revient d'activer (l'obligation d'activation dépend du fait que vous êtes concerné ou non, voir FAQ précédente pour cela). L'application est une application Open Source, le client utilisateur peut réussir à modifier le code (notons que ceci est aussi possible avec du propriétaire, juste plus difficile). De même, un hacker peut toujours réussir à trafiquer un logiciel. Face à cela, Dolibarr fourni un outil pour obtenir la liste de tous les fichiers qui auraient été modifiés par rapport à la version officielle, ou par rapport à une version packagée par un intégrateur tiers, ainsi que la liste des paramètres de configuration obligatoires pour la conformité (voir plus bas) et qui aurait aussi été modifiés. Le certificat étant délivré pour une version avec une configuration donnée, si un utilisateur ou hacker a pu altérer partiellement l'application sur du code ou des paramètres sensibles, l'outil de contrôle pourra le révéler, auquel cas, la responsabilité de non conformité n'est plus du ressort de l'entité qui a fournit l'attestation, puisque ce n'est plus la même application, mais de la responsabilité de celui qui est à l'origine des modifications.

Paramètres recommandées à contrôler/imposer dans une attestation:

*Pays de la société (doit rester à France). Rem: Une fois le premier encaissement fait avec le module "Log inaltérable", sa désactivation renverra un warning.
*Constante MAIN_MODULE_BLOCKEDLOG doit être définie (Cela signifie que le module "Log inaltérable" est bien actif).

Optionnellement, vous pouvez:

*Imposer que la constante BLOCKEDLOG_DISABLE_NOT_ALLOWED_FOR_COUNTRY soit définie et contient le code pays FR (ceci bloque la désactivation du module par erreur).

Remarque:
Vous pouvez utiliser l'outil '''build/generate_filecheck_xml.php''' pour générer un fichier empreinte de la version et/ou paramétrage donné que vous voulez imposer.
Ensuite utilisez l'outil dans le menu '''Accueil - Outils administration - Dolibarr - Files integrity check''' ou bien à distance l'API '''/setup/checkintegrity''' (le module API REST doit avoir été activée) pour vérifier qu'une version est conforme à ce fichier empreinte.

==Je suis dans le périmètre de la loi, j'ai ajouté un module externe sur mon Dolibarr, faut-il une attestation Loi Finance pour ce module ?==

Il n'y a pas de notion de "certificat ou d'attestation loi finance" sur un module.

En effet, ce qui doit être certifié ou attesté, c'est la partie du logiciel qui réalise les enregistrements des paiements, pris dans le contexte de l'ensemble du système d'information, et non chaque module de votre application individuellement. Le logiciel Dolibarr v10 ou + est attestable, donc, si vous êtes dans le périmètre de la loi, ce qu'il vous faut obtenir, c'est une attestation de conformité de l'ensemble de la solution, validant les modules ajoutés qui impactent l'enregistrement des paiements. Donc,

*Si vous êtes dans le périmètre de la loi et que le module ajouté ne concerne pas l'enregistrement des paiements, il n'y a rien de particulier à faire de plus (dès lors que vous êtes dans le périmètre de la loi, vous devez obtenir l'attestation pour les fonctions encaissements de paiements de votre Dolibarr, peu importe que vous ajoutiez ce module ou pas, le module n'ayant pas d'effet sur les fonctions d'encaissements, on perle d'effet trivial ou mineur au code).
*Si toutefois, vous êtes dans le périmètre de la loi et que le module touche à la partie encaissement, il faudra que le tiers fournissant l'attestation prenne en considération ce module (si vous aviez déjà obtenu l'attestation, il vous faudra la ré-obtenir car l'ajout du module l'invalide puisque ce module touche au code de la partie encaissement des paiements).

La nature du module doit vous permettre de savoir si c'est un module qui touche à l'enregistrement des encaissements ou pas. Dans le doute, renseignez vous auprès de l'auteur du module (ce n'est pas lui qui fournira l'attestation mais pourra dire si le module doit être pris en compte ou non dans le processus d'attestation).

=Travaux dans Dolibarr pour permettre la conformité via attestation=

Et Dolibarr dans tout cela ?
Dolibarr v10+ est prêt et attestable sur l'intégralité de ses modules standard.
Voici le suivi des travaux réalisés depuis la v5: [[Loi article 88 finances 2016 et Certification NF525 - Travaux Dolibarr]]

=Où trouver un modèle d'attestation ?=
Les services des impôts proposent un modèle d'attestation individuelle que vous pouvez consulter [https://bofip.impots.gouv.fr/bofip/10692-PGP.html/identifiant%3DBOI-LETTRE-000242-20201230 dans le Bulltein Officiel des Impots du 30/12/2020]

=Notes et références=
<references />

*Synthèse détaillée du BOFIP par La Revue Fiduciaire, rédigé le 06/10/2016: [http://revuefiduciaire.grouperf.com/article/3661/hb/20160919173548859.html Article sur la revue fiduciaire]
*Synthèse courante par l'APRIL (document en évolution permanente): https://pad.april.org/p/logiciel-caisse-publication-BOI
*Article de l'APRIL: https://www.april.org/loi-de-finances-2016-une-doctrine-fiscale-qui-reconnait-les-logiciels-libres-mais-avec-une-marge-de
*Echanges sur les mailing-list de l'April: https://listes.april.org/wws/arc/comptabilite/ (réservé aux adhérents April)
*Note d'information très courte du service public: https://www.service-public.fr/professionnels-entreprises/actualites/A10279
*http://creativekara.fr/doku.php?id=pasteque:lf2016
*Réunion entre le chef de projet Dolibarr, autres représentants April et le ministère des finances en 2018 pour participation à la refonte et clarification du texte de loi.

Roadmap and Release 14.0.0

2021-10-22T14:45:09Z

Florian.mortgat: Added warning about signature change vs. 13.0 for LignePrelevement::construct() and RejetPrelevement::construct()

[[Category:RoadMap]]
{{TemplateVersion|
version=14.0|
date=July 2021|
mainfocus=... }}

{{Flag_fr}} https://www.atm-consulting.fr/les-nouveautes-de-la-version-14-0-de-dolibarr-erp-crm/

{{Flag_fr}} https://easya.solutions/comptabilite-nouveautes-easya-solutions-dolibarr-v14/

'''Detailed Changelog''':<pre>

For users:
----------
NEW: Module Recruitement to follow application to job positions is now stable.
NEW: Feature to make Stock Inventories
NEW: Several security issues after a second private bug hunting campaign.
NEW: A lot of fix into english text after a small proofreading campaign (still not perfect, but really better)
NEW: All main menu entries are using the picto of the module
NEW: Add a copy to clipboard button on some fields
NEW: Add an example of scheduled job to send email reminder for unpaid invoices
NEW: Add some color and picto for the direction of movement
NEW: add the column "Channel" into the list of orders
NEW: Add the column "alias" of company in the list of proposal, order, invoice
NEW: Add the column "Office phone" and "User mobile" in user list
NEW: Add the column "Price level" in thirdparty list
NEW: Add some company information in the dropdown login menu
NEW: Add edit/delete action icons on categories list pages
NEW: Add hidden option to auto load input line extrafield into new lines
NEW: Add import profile to import BOM
NEW: Add link picto to the stock movement on the detail of production
NEW: Add mass action "Set tag" for product/service, user, thirdparty, warehouse, project, bank account, members
NEW: Add bulk action Validate and Set to billed on order list.
NEW: Add possibility to exports userGroups fields on user exports
NEW: Can search on lots or serials into the quick search bar
NEW: Add support for Friday as a non working day
NEW: auto notification with module Notification can use templated emails
NEW: Can clone a cron job
NEW: Can create a lot from the list view (Look and feel standardization).
NEW: Can filter on extrafields date on lists
NEW: Can filter on rowid in list of blocked logs
NEW: Can hide columns "time consumed" on timesheet per week
NEW: Can set an employee on each social contribution
NEW: Can set order of execution of hooks
NEW: Can toggle FCKeditor on public/private notes
NEW: Check update availability for externals modules using a button on module page
NEW: Choose lines to use while creating intervention card from origin
NEW: Columns shipment method, payment mode, payment term in proposal and order list
NEW: Conf for default actioncomm status
NEW: Dictionary for availability - Add a column position
NEW: Can set a user related to a social contribution
NEW: ICS Direct debit can be set with a different value for each bank account
NEW: LDAP: usergroup search can be filtered
NEW: Make public bookmarks editable by admin users only
NEW: If main logo not defined, can use the squarred logo on login page
NEW: The manifest file can use the squared image if available
NEW: Enhance the multicurrency rate editor
NEW: Normalyse Type company field with ajax combobox
NEW: preload product description on selection for customer propal/order/invoice
NEW: Search usergroups & resources
NEW: Setup Page for module creation with module builder enhancement #FoundationFunding
NEW: Show picto of module into the list of dictionaries
NEW: Show the total of payment on the payment confirmation page
NEW: The global setup for Mandatory fields can now be done on combo list too.
NEW: translate in "en_US" to complete PR 16980
NEW: Update the list of taxes available by default for France
NEW: Salary payment request and Salary payment are 2 different steps in workflow on Salary payment recording
NEW: VAT payment request and VAT payment are now 2 different steps in workflow on VAT payment recording
NEW: VAT report - Optimisation & collapse by rate
NEW: When a doc file is shared, link is visible from the main page of doc.
NEW: #16378 more E-Mail Contact substitution Values for better salutation
NEW: option to keep the "Automatically create the payment" checkbox empty on the tax creation page

Accountancy
NEW: Accountancy - Add FEC import
NEW: Accountancy - Add a confirmation form with options on export
NEW: Accountancy - Add select date from/to in already bind customer and supplier list
NEW: Accountancy - Format FEC - Add new field DateLimitReglmt
NEW: Accountancy - In ledger & journals, show link on bank transaction
NEW: Accountancy - Possibility to filter on journals in balance
NEW: Accountancy - Add a page to list subledger accounts
NEW: Multiselect ledger account code filter on book keeping list

Agenda
NEW: add support for Friday as a non working day
NEW: can show the leave dates/holidays on the agenda view
NEW: Support color for types of event

Bank
NEW: Bank Entries : display user linked to a salary or a taxes
NEW: Add bulk actions for Bank Transfer

ECM/GED
NEW: add DB fields note_public and note_private for ECM module
NEW: can filter files in ECM/GED on status Shared / Not shared

Invoices
NEW: add a check to avoid an invoice date in the future
NEW: add the total of margin in invoice list
NEW: can set a percentage when creating an invoice from another object
NEW: Support down payment on supplier invoice (& somes ajustments)

Margin
NEW: add the total of margin in invoice list
NEW: add the total of margin in page by user

Members
NEW: #17292 default subscription amount by adherent type
NEW: option to automatically create a login/user when a new subscription of a member is done online
NEW: option to select membership type on the online payment page for membership subscription or renewal

Products
NEW: Add price min and price min including tax into product export
NEW: Add a ref in product customer price
NEW: customer ref for product customer prices
NEW: Set status of all variants when changing status of parent

Projects/Tasks
NEW: option to automatically close an open project when all its tasks are done (=progress 100%)
NEW: can show the project ref into PDF documents
NEW: when we add contacts/users to a project, ask to also affect them on tasks
NEW: Can hide columns "time consumed" on timesheet per week

Proposals
NEW: add bulk action to set a commercial proposal to status "Refused"
NEW: can set a warehouse in a proposal
NEW: date and user signature on proposal (Issue 16062) #16980

Shipment
NEW: add option in Workflow module to set a shipment as closed

TakePOS
NEW: delayed payment in TakePOS #14456?
NEW: display date range if exist in TakePOS
NEW: display resiliate status in TakePOS for member
NEW: edit sales lines rights in TakePOS
NEW: option for TakePOS to show the total price without tax
NEW: more permissions in TakePOS (can edit added line, can modify once order sent to kitchen)

Third Party / Contacts
NEW: add contact tag and bulk email status on the thirdparty + contact create form
NEW: can set a warehouse on a thirdparty

Tickets
NEW: can use captcha on public page to create a ticket #16347
NEW: can set if a ticket group is visible on public interface or not

Warehouse/Stock
NEW: Feature to make Stock Inventories
NEW: can make massive stock transfers from a CSV file
NEW: Stock movement list - add more complete date field
NEW: can set a warehouse in a proposal
NEW: can set a warehouse on a thirdparty

Website Module
NEW: #17113 Can upload a favicon in website module
NEW: add a new permission "Export website"
NEW: add last date of modification for website pages in the list of pages
NEW: Save old page with .old extension on disk when editing a website page

Workflows
NEW: add option in Workflow module to set a shipment as closed

for Admins
NEW: Add a security center page with all information and advices related to the security of your instance
NEW: Add a performance center page with all information and advices related to the performance of your instance

Modules
NEW: Module Recruitement is now stable
NEW: start new experimental module Event Organization Management
NEW: start new experimental module Partnership Management
NEW: start new experimental module Knowledge Management
NEW: start new experimental module Workstations Management
NEW: Check update availability for externals modules using a button on module page
Module SimplePOS is deprecated - TakePOS is recommended for the future

new Options
NEW: add option CONTRACT_ALLOW_EXTERNAL_DOWNLOAD to make generated doc automatically shared
NEW: add option SUPPLIER_PROPOSAL_ALLOW_EXTERNAL_DOWNLOAD to make generated doc automatically shared
NEW: add option MAIN_SECURITY_ANTI_SSRF_SERVER_IP to define list of IPs that are local IPs
NEW: add option SOCIETE_DISABLE_WORKFORCE to hide staff field
NEW: add constant MAIN_BUGTRACK_URL to set a custom url to redirect to when clicking on link "declare a bug"

For developers:
---------------
NEW: Can edit an object property in module builder
NEW: Add data-eec=1 for EEC countries on select for js interaction
NEW: Add experimental repair script to switch to dynamic row format and utf8mb4 encoding
NEW: Add function showValueWithClipboardCPButton() to add a copy/paste
NEW: Upgrade Stripe PHP lib to 7.67.0
NEW: Support sepa_debit in stripe paymentmethods list
NEW: Update doleditor.class.php for easily activate SCAYT
NEW: Add triggers in the function add_object_linked(), updateObjectLinked() and deleteObjectLinked()
NEW: Add triggers OBJECT_LINK_INSERT, OBJECT_LINK_UPDATE et OBJECT_LINK_DELETE in the function add_object_linked(), updateObjectLinked() and deleteObjectLinked()
NEW: can set a target image in dolcropresize function
NEW: can set a label as placeholder for combo lists
NEW: Add pagination on Get Products response API
NEW: Add the DefaultValues CRUD class
NEW: Extrafields of documents lines are inside the lines, not any more on separate TR
NEW: unit selection on object edit line

APIs
NEW: API add option $includeifobjectisused to get a product
NEW: API get the list of product ids only
NEW: add link to OpenAPI specifications XML file in REST API module setup: swagger.json file can be included into external tools like redoc
NEW: add native compression in REST APIs
NEW: Product Variants API, add variant stock to response by parameter
NEW: Product API route added to get product stock and product with or without variants #13739 #17390

Hooks
NEW: hook printFieldListTitle for cabyprodserv.php
NEW: hook to allow external modules to add their own shortlist of recent objects
NEW: SQL-altering hooks in the turnover by product report
NEW: add form confirm hook on company card
NEW: add hook addSectionECMAuto method to add custom diretory into ECM auto files

WARNING:

Following changes may create regressions for some external modules, but were necessary to make Dolibarr better:
* Module SimplePOS is deprecated. If you need a POS module, please use the module TakePOS.
* The ICS value for direct debit or credit transfer is now stored on each bank account instead of into the global setup.
* API /setup/shipment_methods has been replaced with API /setup/shipping_methods
* Field "total" renamed into "total_ht" for table llx_facture, llx_facture_rec for better field name consistency
* Field "tva" renamed into "total_tva" for table llx_propal, llx_supplier_proposal, llx_commande, llx_commande_fournisseur for better field name consistency
* Field "total" renamed into "total_ttc" for table llx_propal, llx_supplier_proposal for better field name consistency
* Signature changed: one more required parameter for the constructor of LignePrelevement and RejetPrelevement
* If your database is PostgreSQL, you must use version 9.1.0 or more (Dolibarr need the SQL function CONCAT)
* If your database is MySQL or MariaDB, you need at least version 5.1
* Function set_price_level() has been renamed into setPriceLevel() to follow camelcase rules
* removed deprecated subtituion key __REFCLIENT__ (replaced with __REF_CLIENT__)
* Removed constant MAIN_COUNTRIES_IN_EEC. You can now set if country is in Europe or not from the dictionary of countries.

Installation - Upgrade

2021-08-02T16:48:52Z

Florian.mortgat: /* File:Gnu.png With Dolibarr (standard .zip package or from git) */ add --depth to git clone command + explanation

[[fr:Installation_-_Mise_à_jour]]
[[es:Instalación_-_Actualización]]
[[zh:安装_-_升级]]


[[Category:Admin_en]]
{{TemplateDocUser}}

The following documentation describes processes to install or upgrade Dolibarr on a Windows, MAC OS or Unix like platform.

=Install Dolibarr=
This chapter describe different available methods to install Dolibarr for the first time (from the most simple to the manual one). See next chapter for upgrades.

==On your dedicated computer/server (installation "On Premise")==
===[[File:Logo_windows.png]] Manually or with DoliWamp===
- '''Prerequisite''': Windows

- '''Level''': Non experienced users

This process works only for Windows users and is recommended for user with no computer knowledge. If you have experience with Apache, PHP and Mysql installation, next chapter is better for you.

If you have time and want to learn how to install an Apache, PHP and MariaDB web server, see the [[Manual installation on Windows]] page for step-by-step instructions.

However, if you are a newbie user and running Windows, you can use DoliWamp. DoliWamp is a specialized Dolibarr distribution for Windows. This distribution allows you to make an installation under Windows with all prerequisites (Apache, Mysql, PHP) and with no computer knowledge. This is steps to install DoliWamp:

*Download last Dolibarr version for Windows DoliWamp.

For this, see at {{TemplateURLToDownloadDoliWamp}}

*Run the downloaded .exe and follow instructions.

===[[File:Logo_ubuntu.png]] With DoliDeb (Debian or Ubuntu .deb package)===
- '''Prerequisite''': Linux Ubuntu

- '''Level''': Non experienced users

This process works only for Ubuntu or Debian Linux users and is recommended for user with little computer knowledge. If you are experienced with Apache, PHP and Mysql installation, the chapter 'with standard package' is better for you. However, if you are a newbie user and running Ubuntu, you can use DoliDeb. DoliDeb is a specialized Dolibarr distribution for Debian or Ubuntu. This distribution allows you to make an installation under Ubuntu with all prerequisites (Apache, Mysql, PHP) and with no computer knowledge.

*Steps to install DoliDeb are described into page [[Dolibarr for Ubuntu or Debian]].

===[[File:Logo_rpm.png|42px]] With DoliRpm (Fedora, Redhat, Mandriva, Mageia or OpenSuse .rpm package)===
- '''Prerequisite''': Linux Fedora, Redhat, Mandriva, Mageia or OpenSuse

- '''Level''': Non experienced users

This process works only for Fedora, Redhat, Mandriva, Mageia or OpenSuse Linux users and is recommended for user with no computer knowledge. If you have experience with Apache, PHP and Mysql installation, next chapter 'with standard package' is better for you. However, if you are a newbie user and running Fedora or Redhat, you can use DoliRpm. DoliRpm is a specialized Dolibarr distribution for Fedora, Redhat or Mandriva. This distribution allows you to make an installation under such OS with all prerequisites (Apache, Mysql, PHP) and with no computer knowledge.

*Steps to install DoliRpm are described into page [[Dolibarr for Redhat or Fedora (rpm package)]] or [[Dolibarr for Mandriva or Mageia (rpm package)]] or [[Dolibarr for OpenSuse (rpm package)]].

===[[File:Gnu.png]] With Dolibarr (standard .zip package or from git)===
- '''Prerequisite''': Apache, PHP and a database server (MySQL or PostgreSQL) are already running correctly and user/pass (of a new database or root server) is known.

- '''Level''': Users with few Web and Database administration knowledge.

This procedure describe manual (and recommended) installation on a GNU/Linux system (Debian, Mandriva, ...), it can be used for other OS with minor changes.
You can follow this tutorial for any Dolibarr version >= 2.0.0

*Check that you have installed Apache, PHP {{PHPMinVersion}} and a database server (MySQL {{MySqlMinVersion}} or PostGreSQL) correctly (check list of installed packaged on your server by using the package manager of your distribution). If not, install them (use last recent version).

*Check that main root or admin user/password couple for the server is known and works correctly. If this root or admin user/password is not known because not yet defined, read following chapter. Otherwise go on next step:

'''MySQL database :'''

For Linux users, if you have just installed a MySQL server, the admin user is''' root'''. If the root password has never been set yet, you must run the following command to initialize the password:
<source lang="bash">
mysql
</source>
Once in Mysql interface, run the SQL command to modify the root password:
<source lang="sql">
grant all privileges on *.* to root@'localhost' identified by 'newrootpass' with grant option;
</source>
Then enter and \q to quit.

To check that the connection with the new couple user/password works, launch the command
<source lang="bash">
mysql -u root -p
</source>
And type your password ''newrootpass'' then \q to quit if the connection has been successful.

'''PostgreSQL database :'''

For Linux users, if you have just installed a PostgreSQL server, you must run the following command to initialize an admin user and password. For this, add the following line in file '''/etc/postgresql/x.x/main/pg_hba.conf''' (replace x.x with your postgres version)
<source lang="ini">
local all dolibarrowner md5
</source>
Also, comment the line
<source lang="ini">
#local all all ident
</source>
This line ensure that system login used to connect to database (it will be login the web server run with), is same than database account (this is never the case).

Then launch commands from a root shell
<source lang="bash">
sudo -s -u postgres
createuser dolibarrowner
psql -U postgres -d template1
alter user dolibarrowner with password 'dolibarrownerpass';
ALTER USER dolibarrowner WITH SUPERUSER;
ALTER USER dolibarrowner WITH CREATEDB;
ALTER USER dolibarrowner WITH CREATEROLE;
\du
exit
sudo /etc/init.d/postgresql restart
</source>
You can test a connection with this user with command
<source lang="bash">
psql -d postgres -U dolibarrowner -W
</source>
And type your ''dolibarrownerpass'' as password and \q to quit if connection is ok.

'''web root :'''

*Go into the directory where to install Dolibarr (the web root directory defined for your web server)

#For Debian and Ubuntu families, it is generally: /var/www (newer versions: /var/www/html)
#For Mandriva, RedHat, Fedora: /var/www/html
#For Suse: /srv/www/htdocs

<source lang="bash">
$ cd /var/www
or
$ cd /var/www/html
</source>

*Get the application archive of last stable version

'''from zip file'''
<source lang="bash">
$ wget http://www.dolibarr.org/files/dolibarr.zip
</source>

*Uncompress archive

<source lang="bash">
$ unzip dolibarr.zip
</source>

'''or from git repository'''
<source lang="bash">
$ git clone --depth 1 -b X.Y http://github.com/Dolibarr/dolibarr.git dolibarr
</source>
Replace X.Y with the version you want to get. Remove "--depth 1" if you don't mind downloading the entire history of the project (programmers may find it useful but end users probably won't).

*Rename directory dolibarr-x.y.z into dolibarr to have a directory name that does not depends on version (replace x.y.z with source version)

<source lang="bash">
$ mv dolibarr-x.y.z dolibarr
</source>

*Change permissions and owner of the 'dolibarr' directory to that of the group under which the web server runs (assumed to be 'www-data' for debian, 'apache' for redhat, mandriva, fedora)

<source lang="bash">
$ chmod -R 755 /var/www/dolibarr
$ chown -R www-data.www-data /var/www/dolibarr
or
$ chmod -R 755 /var/www/html/dolibarr
$ chown -R apache.apache /var/www/html/dolibarr
</source>

*For Fedora, since SELinux is usually enabled, it is also advisable to run the following commands to make the 'dolibarr' directory compliant with the SELinux requirement (else you are likely to get quite a few alerts) :

<source lang="bash">
$ semanage fcontext -a -t httpd_sys_rw_content_t '/var/www/html/dolibarr(/.*)?'
$ restorecon -R -v '/var/www/html/dolibarr'
</source>

*As a root user, create, into directory dolibarr/htdocs/conf, an empty configuration file called conf.php and set the web server user as owner (for instance www-data on Debian, apache on Mandriva, RedHat, Fedora or other distributions ...). This is required because the web server will have to write into this file during install process.

<source lang="bash">
$ cd dolibarr ; touch htdocs/conf/conf.php ; chown www-data htdocs/conf/conf.php
</source>
Note: For Ubuntu no need of htdocs, you just have to make dolibarr root by placing all files and folders of htdocs in /var/www/dolibarr then from browser do <MyIP>/dolibarr/index.php (see this discussion as reference to this addendum [http://askubuntu.com/questions/874456/php-code-displays-in-browser?noredirect=1#comment1357943_874456])

*As a root user, create a directory that will be used to save all files generated and stocked by Dolibarr (PDf invoices, uploaded images, ...), and attribute to this directory a owner that must be the web server (example www-data on Debian, apache on Mandriva, RedHat, Fedora...). The web server must have write permission into this directory. It is recommanded to use a directory outside of your directory of web pages, for example - "/var/lib/dolibarr/documents"

<source lang="bash">
$ mkdir -p /var/lib/dolibarr/documents ; chown www-data /var/lib/dolibarr/documents
</source>

*Now call your browser to point to the main page

<source lang="ini">
http://127.0.0.1/dolibarr/htdocs/
</source>
or if you didn't create the htdocs directory
<source lang="ini">
http://127.0.0.1/dolibarr/
</source>

*Follow instructions of setup steps until end of install process.

*For security reason, we recommend, once setup is finished, to create a file install.lock into Dolibarr document directory that only root user can delete. This will lock the call of the install process again (you will have to remove this file for upgrades).

If this is not done, Dolibarr will show you a warning once logged by an administrator user.
<source lang="bash">
$ touch /var/lib/dolibarr/documents/install.lock; chmod go-w /var/lib/dolibarr/documents;
</source>

==On a mutualized Web Hosting Provider (without terminal/SSH access)==
It is not possible to provide a generic documentation to install Dolibarr on a particular Web hosting provider as this depends on provider.
In most cases, using the following process should works for most providers:

- '''Prerequisite''': Apache web server, PHP and a database server (MySQL or PostgreSQL) are already running correctly and user/pass (of a new database or root server) is known.

- '''Level''': Users with few Web and Database administration knowledge. Knowledge to use a tool (FTP, SFTP) to upload files on the server.

*Check that you have an Apache web server, PHP and a database server (MySQL or PostGreSQL) that works correctly.

[[File:warning.png]] Warning, check that code page of PHP server and database server are same (utf8 recommended).

*Check that main root or admin user/password couple for the server is known and works correctly. Ask them to your Web Hosting Provider if unknown.

*Get the application archive of last stable version and uncompress it locally.

*Upload all content of htdocs directory to your web root directory, for example using FTP in binary mode.

*Create a directory called "documents" into Dolibarr directory that will serve to save all documents generated and stocked by Dolibarr (PDF invoices, uploaded images, ...). The web server must have write permission into this directory. You can set permissions with your FTP client.

*Now call your browser to point to the main page index.php

*Follow instructions of setup steps until end of install process.

*For security reason, we recommend, once setup is finished, to create a file install.lock into Dolibarr installed directory. This will lock the call of the install process again (you will have to remove it for upgrades). If this is not done, Dolibarr will show you a warning once logged as an administrator user.

==On a SaaS or Cloud web hosting provider==
Dolibarr is also available on a lot of "ready to use" SaaS or Cloud platforms/services that provides preinstalled versions.

See page [[Cloud Solutions]].

Dolibarr can also be installed manually on all Cloud platforms that support PHP and Mysql.

See page [[Cloud Solutions]].

==Using Docker==
For admins with Docker experience, it is possible to use the docker build files located in the source repo here: https://github.com/Dolibarr/dolibarr/tree/develop/build
git clone https://github.com/Dolibarr/dolibarr/
cd ./dolibarr
git checkout tags/<desiredrelease>

cd build/docker

docker-compose up

Read the README carefully. As of version 12+ it recommends to use the built in docker files for development only, while an outside repo: https://hub.docker.com/r/tuxgasy/dolibarr is recommended for production environments.

=Setup=

==First setup==
See page [[First setup|Setup]].

==Setup a LDAP connection==
If you want to use a LDAP: See [[Install and configure OpenLDAP]].

=Import external data=
For this operation, read page [[Mass imports]].

=Upgrade Dolibarr=
This chapter describe processes to upgrade an existing installation of Dolibarr from an old version to a new one. The process is the same, whatever version you are coming from and version you are going to, but it will differ according to the distribution/operating system you used for your first installation. You should use the same for upgrade.

==[[File:Logo_windows.png]] With DoliWamp (Windows .exe package)==

*First make a backup of your current installation
*Download new .exe package of DoliWamp.
*Run downloaded .exe file and follow steps without changing any default values. This will upgrades all your files.
*At the end of the execution, your browser is launched with a page to ask you to run upgrade of your database. Choose the upgrade according to your case.

If there is more than one version late, the page in your browser will loop to start again the upgrade wizard as often as required to run upgrade process, version by version, until your reach the new installed version.

==[[File:Logo_ubuntu.png]] With DoliDeb (Debian or Ubuntu .deb package)==

*First make a backup of your current installation
*Process to upgrade using Debian/Ubuntu package is the same as the install process (see previous chapters), so it is as easy as installing a package.

You can also read page [[Dolibarr for Ubuntu or Debian]].

==[[File:Logo_rpm.png|40px]] With DoliRpm (Fedora, Redhat, Mandriva, Mageia or OpenSuse .rpm package)==

*First make a backup of your current installation
*Process to upgrade using rpm package is the same as the install process, so it is as easy as installing a package (see previous chapters).

==[[File:Gnu.png]] With Dolibarr (standard .zip package or from Git)==
This is tutorial to use when using standard distribution for a manual upgrade.

*First make a backup of your current installation

*Go into the directory where you installed Dolibarr (it might be the root directory of your web, for example /var/www under Debian)

<source lang="bash">
$ cd /var/www
</source>

===For installation that used the zip file===

*Get archive of last version

<source lang="bash">
$ wget https://www.dolibarr.org/files/dolibarr.zip
</source>

*Uncompress the archive

<source lang="bash">
$ unzip dolibarr.zip
</source>

*Copy all new extracted files (the one uncompressed into directory dolibarr-x.y.z) to the directory where you put your old Dolibarr version. This will overwrite old files with new ones without removing files specifics to your installation (like conf.php file or complementary non official installed modules).

<source lang="bash">
$ cp -r dolibarr-x.y.z/* dolibarr
</source>

*If no error, you can now remove the directory of source files

<source lang="bash">
$ rm -fr dolibarr-x.y.z
</source>

*Now open your Dolibarr in your browser. It should open automatically the install/

and choose ''Update'' in suggested menu.

===For installation that used GIT===
If you already cloned the repo simply upgrade by checking out a version tag like so:
<source lang="bash">
$ git checkout 13.0
$ git pull origin 13.0
</source>

*Now open your Dolibarr in your browser. It should open automatically the install/

and choose ''Update'' in suggested menu.

Note:

If you want to script the database upgrade process (to avoid the upgrade process from web browser), you can run the 3 upgrade processes from command line:
<source lang="bash">
$ cd htdocs/install
$ php upgrade.php oldx.oldy.oldz x.y.z > output.html
$ php upgrade2.php oldx.oldy.oldz x.y.z > output2.html
$ php step5.php oldx.oldy.oldz x.y.z > output3.html
</source>
Note: z must be "0" because only major versions have a migration script to run.

Return code will be 0 if success, 1 if error (if this happens, see file output.html, output2.html or output3.html).

Note: If you have a message that tell the install process is locked by a file, remove the file install.lock stored in Dolibarr root directory.

*For security reason, once setup is finished, you should create a file install.lock into Dolibarr documents directory. This will lock the call of the install process again (you will have to remove this file for future upgrades). If this is not done, Dolibarr will show you a warning once logged with an administrator user.

<source lang="bash">
$ echo > documents/install.lock
$ chmod 444 documents/install.lock
</source>

Installation - Upgrade

2021-08-02T16:42:01Z

Florian.mortgat: /* For installation that used GIT */ fix git commands

[[fr:Installation_-_Mise_à_jour]]
[[es:Instalación_-_Actualización]]
[[zh:安装_-_升级]]


[[Category:Admin_en]]
{{TemplateDocUser}}

The following documentation describes processes to install or upgrade Dolibarr on a Windows, MAC OS or Unix like platform.

=Install Dolibarr=
This chapter describe different available methods to install Dolibarr for the first time (from the most simple to the manual one). See next chapter for upgrades.

==On your dedicated computer/server (installation "On Premise")==
===[[File:Logo_windows.png]] Manually or with DoliWamp===
- '''Prerequisite''': Windows

- '''Level''': Non experienced users

This process works only for Windows users and is recommended for user with no computer knowledge. If you have experience with Apache, PHP and Mysql installation, next chapter is better for you.

If you have time and want to learn how to install an Apache, PHP and MariaDB web server, see the [[Manual installation on Windows]] page for step-by-step instructions.

However, if you are a newbie user and running Windows, you can use DoliWamp. DoliWamp is a specialized Dolibarr distribution for Windows. This distribution allows you to make an installation under Windows with all prerequisites (Apache, Mysql, PHP) and with no computer knowledge. This is steps to install DoliWamp:

*Download last Dolibarr version for Windows DoliWamp.

For this, see at {{TemplateURLToDownloadDoliWamp}}

*Run the downloaded .exe and follow instructions.

===[[File:Logo_ubuntu.png]] With DoliDeb (Debian or Ubuntu .deb package)===
- '''Prerequisite''': Linux Ubuntu

- '''Level''': Non experienced users

This process works only for Ubuntu or Debian Linux users and is recommended for user with little computer knowledge. If you are experienced with Apache, PHP and Mysql installation, the chapter 'with standard package' is better for you. However, if you are a newbie user and running Ubuntu, you can use DoliDeb. DoliDeb is a specialized Dolibarr distribution for Debian or Ubuntu. This distribution allows you to make an installation under Ubuntu with all prerequisites (Apache, Mysql, PHP) and with no computer knowledge.

*Steps to install DoliDeb are described into page [[Dolibarr for Ubuntu or Debian]].

===[[File:Logo_rpm.png|42px]] With DoliRpm (Fedora, Redhat, Mandriva, Mageia or OpenSuse .rpm package)===
- '''Prerequisite''': Linux Fedora, Redhat, Mandriva, Mageia or OpenSuse

- '''Level''': Non experienced users

This process works only for Fedora, Redhat, Mandriva, Mageia or OpenSuse Linux users and is recommended for user with no computer knowledge. If you have experience with Apache, PHP and Mysql installation, next chapter 'with standard package' is better for you. However, if you are a newbie user and running Fedora or Redhat, you can use DoliRpm. DoliRpm is a specialized Dolibarr distribution for Fedora, Redhat or Mandriva. This distribution allows you to make an installation under such OS with all prerequisites (Apache, Mysql, PHP) and with no computer knowledge.

*Steps to install DoliRpm are described into page [[Dolibarr for Redhat or Fedora (rpm package)]] or [[Dolibarr for Mandriva or Mageia (rpm package)]] or [[Dolibarr for OpenSuse (rpm package)]].

===[[File:Gnu.png]] With Dolibarr (standard .zip package or from git)===
- '''Prerequisite''': Apache, PHP and a database server (MySQL or PostgreSQL) are already running correctly and user/pass (of a new database or root server) is known.

- '''Level''': Users with few Web and Database administration knowledge.

This procedure describe manual (and recommended) installation on a GNU/Linux system (Debian, Mandriva, ...), it can be used for other OS with minor changes.
You can follow this tutorial for any Dolibarr version >= 2.0.0

*Check that you have installed Apache, PHP {{PHPMinVersion}} and a database server (MySQL {{MySqlMinVersion}} or PostGreSQL) correctly (check list of installed packaged on your server by using the package manager of your distribution). If not, install them (use last recent version).

*Check that main root or admin user/password couple for the server is known and works correctly. If this root or admin user/password is not known because not yet defined, read following chapter. Otherwise go on next step:

'''MySQL database :'''

For Linux users, if you have just installed a MySQL server, the admin user is''' root'''. If the root password has never been set yet, you must run the following command to initialize the password:
<source lang="bash">
mysql
</source>
Once in Mysql interface, run the SQL command to modify the root password:
<source lang="sql">
grant all privileges on *.* to root@'localhost' identified by 'newrootpass' with grant option;
</source>
Then enter and \q to quit.

To check that the connection with the new couple user/password works, launch the command
<source lang="bash">
mysql -u root -p
</source>
And type your password ''newrootpass'' then \q to quit if the connection has been successful.

'''PostgreSQL database :'''

For Linux users, if you have just installed a PostgreSQL server, you must run the following command to initialize an admin user and password. For this, add the following line in file '''/etc/postgresql/x.x/main/pg_hba.conf''' (replace x.x with your postgres version)
<source lang="ini">
local all dolibarrowner md5
</source>
Also, comment the line
<source lang="ini">
#local all all ident
</source>
This line ensure that system login used to connect to database (it will be login the web server run with), is same than database account (this is never the case).

Then launch commands from a root shell
<source lang="bash">
sudo -s -u postgres
createuser dolibarrowner
psql -U postgres -d template1
alter user dolibarrowner with password 'dolibarrownerpass';
ALTER USER dolibarrowner WITH SUPERUSER;
ALTER USER dolibarrowner WITH CREATEDB;
ALTER USER dolibarrowner WITH CREATEROLE;
\du
exit
sudo /etc/init.d/postgresql restart
</source>
You can test a connection with this user with command
<source lang="bash">
psql -d postgres -U dolibarrowner -W
</source>
And type your ''dolibarrownerpass'' as password and \q to quit if connection is ok.

'''web root :'''

*Go into the directory where to install Dolibarr (the web root directory defined for your web server)

#For Debian and Ubuntu families, it is generally: /var/www (newer versions: /var/www/html)
#For Mandriva, RedHat, Fedora: /var/www/html
#For Suse: /srv/www/htdocs

<source lang="bash">
$ cd /var/www
or
$ cd /var/www/html
</source>

*Get the application archive of last stable version

'''from zip file'''
<source lang="bash">
$ wget http://www.dolibarr.org/files/dolibarr.zip
</source>

*Uncompress archive

<source lang="bash">
$ unzip dolibarr.zip
</source>

'''or from git repository'''
<source lang="bash">
$ git clone -b X.Y http://github.com/Dolibarr/dolibarr.git dolibarr
</source>
Replace X.Y with the version you want to get.

*Rename directory dolibarr-x.y.z into dolibarr to have a directory name that does not depends on version (replace x.y.z with source version)

<source lang="bash">
$ mv dolibarr-x.y.z dolibarr
</source>

*Change permissions and owner of the 'dolibarr' directory to that of the group under which the web server runs (assumed to be 'www-data' for debian, 'apache' for redhat, mandriva, fedora)

<source lang="bash">
$ chmod -R 755 /var/www/dolibarr
$ chown -R www-data.www-data /var/www/dolibarr
or
$ chmod -R 755 /var/www/html/dolibarr
$ chown -R apache.apache /var/www/html/dolibarr
</source>

*For Fedora, since SELinux is usually enabled, it is also advisable to run the following commands to make the 'dolibarr' directory compliant with the SELinux requirement (else you are likely to get quite a few alerts) :

<source lang="bash">
$ semanage fcontext -a -t httpd_sys_rw_content_t '/var/www/html/dolibarr(/.*)?'
$ restorecon -R -v '/var/www/html/dolibarr'
</source>

*As a root user, create, into directory dolibarr/htdocs/conf, an empty configuration file called conf.php and set the web server user as owner (for instance www-data on Debian, apache on Mandriva, RedHat, Fedora or other distributions ...). This is required because the web server will have to write into this file during install process.

<source lang="bash">
$ cd dolibarr ; touch htdocs/conf/conf.php ; chown www-data htdocs/conf/conf.php
</source>
Note: For Ubuntu no need of htdocs, you just have to make dolibarr root by placing all files and folders of htdocs in /var/www/dolibarr then from browser do <MyIP>/dolibarr/index.php (see this discussion as reference to this addendum [http://askubuntu.com/questions/874456/php-code-displays-in-browser?noredirect=1#comment1357943_874456])

*As a root user, create a directory that will be used to save all files generated and stocked by Dolibarr (PDf invoices, uploaded images, ...), and attribute to this directory a owner that must be the web server (example www-data on Debian, apache on Mandriva, RedHat, Fedora...). The web server must have write permission into this directory. It is recommanded to use a directory outside of your directory of web pages, for example - "/var/lib/dolibarr/documents"

<source lang="bash">
$ mkdir -p /var/lib/dolibarr/documents ; chown www-data /var/lib/dolibarr/documents
</source>

*Now call your browser to point to the main page

<source lang="ini">
http://127.0.0.1/dolibarr/htdocs/
</source>
or if you didn't create the htdocs directory
<source lang="ini">
http://127.0.0.1/dolibarr/
</source>

*Follow instructions of setup steps until end of install process.

*For security reason, we recommend, once setup is finished, to create a file install.lock into Dolibarr document directory that only root user can delete. This will lock the call of the install process again (you will have to remove this file for upgrades).

If this is not done, Dolibarr will show you a warning once logged by an administrator user.
<source lang="bash">
$ touch /var/lib/dolibarr/documents/install.lock; chmod go-w /var/lib/dolibarr/documents;
</source>

==On a mutualized Web Hosting Provider (without terminal/SSH access)==
It is not possible to provide a generic documentation to install Dolibarr on a particular Web hosting provider as this depends on provider.
In most cases, using the following process should works for most providers:

- '''Prerequisite''': Apache web server, PHP and a database server (MySQL or PostgreSQL) are already running correctly and user/pass (of a new database or root server) is known.

- '''Level''': Users with few Web and Database administration knowledge. Knowledge to use a tool (FTP, SFTP) to upload files on the server.

*Check that you have an Apache web server, PHP and a database server (MySQL or PostGreSQL) that works correctly.

[[File:warning.png]] Warning, check that code page of PHP server and database server are same (utf8 recommended).

*Check that main root or admin user/password couple for the server is known and works correctly. Ask them to your Web Hosting Provider if unknown.

*Get the application archive of last stable version and uncompress it locally.

*Upload all content of htdocs directory to your web root directory, for example using FTP in binary mode.

*Create a directory called "documents" into Dolibarr directory that will serve to save all documents generated and stocked by Dolibarr (PDF invoices, uploaded images, ...). The web server must have write permission into this directory. You can set permissions with your FTP client.

*Now call your browser to point to the main page index.php

*Follow instructions of setup steps until end of install process.

*For security reason, we recommend, once setup is finished, to create a file install.lock into Dolibarr installed directory. This will lock the call of the install process again (you will have to remove it for upgrades). If this is not done, Dolibarr will show you a warning once logged as an administrator user.

==On a SaaS or Cloud web hosting provider==
Dolibarr is also available on a lot of "ready to use" SaaS or Cloud platforms/services that provides preinstalled versions.

See page [[Cloud Solutions]].

Dolibarr can also be installed manually on all Cloud platforms that support PHP and Mysql.

See page [[Cloud Solutions]].

==Using Docker==
For admins with Docker experience, it is possible to use the docker build files located in the source repo here: https://github.com/Dolibarr/dolibarr/tree/develop/build
git clone https://github.com/Dolibarr/dolibarr/
cd ./dolibarr
git checkout tags/<desiredrelease>

cd build/docker

docker-compose up

Read the README carefully. As of version 12+ it recommends to use the built in docker files for development only, while an outside repo: https://hub.docker.com/r/tuxgasy/dolibarr is recommended for production environments.

=Setup=

==First setup==
See page [[First setup|Setup]].

==Setup a LDAP connection==
If you want to use a LDAP: See [[Install and configure OpenLDAP]].

=Import external data=
For this operation, read page [[Mass imports]].

=Upgrade Dolibarr=
This chapter describe processes to upgrade an existing installation of Dolibarr from an old version to a new one. The process is the same, whatever version you are coming from and version you are going to, but it will differ according to the distribution/operating system you used for your first installation. You should use the same for upgrade.

==[[File:Logo_windows.png]] With DoliWamp (Windows .exe package)==

*First make a backup of your current installation
*Download new .exe package of DoliWamp.
*Run downloaded .exe file and follow steps without changing any default values. This will upgrades all your files.
*At the end of the execution, your browser is launched with a page to ask you to run upgrade of your database. Choose the upgrade according to your case.

If there is more than one version late, the page in your browser will loop to start again the upgrade wizard as often as required to run upgrade process, version by version, until your reach the new installed version.

==[[File:Logo_ubuntu.png]] With DoliDeb (Debian or Ubuntu .deb package)==

*First make a backup of your current installation
*Process to upgrade using Debian/Ubuntu package is the same as the install process (see previous chapters), so it is as easy as installing a package.

You can also read page [[Dolibarr for Ubuntu or Debian]].

==[[File:Logo_rpm.png|40px]] With DoliRpm (Fedora, Redhat, Mandriva, Mageia or OpenSuse .rpm package)==

*First make a backup of your current installation
*Process to upgrade using rpm package is the same as the install process, so it is as easy as installing a package (see previous chapters).

==[[File:Gnu.png]] With Dolibarr (standard .zip package or from Git)==
This is tutorial to use when using standard distribution for a manual upgrade.

*First make a backup of your current installation

*Go into the directory where you installed Dolibarr (it might be the root directory of your web, for example /var/www under Debian)

<source lang="bash">
$ cd /var/www
</source>

===For installation that used the zip file===

*Get archive of last version

<source lang="bash">
$ wget https://www.dolibarr.org/files/dolibarr.zip
</source>

*Uncompress the archive

<source lang="bash">
$ unzip dolibarr.zip
</source>

*Copy all new extracted files (the one uncompressed into directory dolibarr-x.y.z) to the directory where you put your old Dolibarr version. This will overwrite old files with new ones without removing files specifics to your installation (like conf.php file or complementary non official installed modules).

<source lang="bash">
$ cp -r dolibarr-x.y.z/* dolibarr
</source>

*If no error, you can now remove the directory of source files

<source lang="bash">
$ rm -fr dolibarr-x.y.z
</source>

*Now open your Dolibarr in your browser. It should open automatically the install/

and choose ''Update'' in suggested menu.

===For installation that used GIT===
If you already cloned the repo simply upgrade by checking out a version tag like so:
<source lang="bash">
$ git checkout 13.0
$ git pull origin 13.0
</source>

*Now open your Dolibarr in your browser. It should open automatically the install/

and choose ''Update'' in suggested menu.

Note:

If you want to script the database upgrade process (to avoid the upgrade process from web browser), you can run the 3 upgrade processes from command line:
<source lang="bash">
$ cd htdocs/install
$ php upgrade.php oldx.oldy.oldz x.y.z > output.html
$ php upgrade2.php oldx.oldy.oldz x.y.z > output2.html
$ php step5.php oldx.oldy.oldz x.y.z > output3.html
</source>
Note: z must be "0" because only major versions have a migration script to run.

Return code will be 0 if success, 1 if error (if this happens, see file output.html, output2.html or output3.html).

Note: If you have a message that tell the install process is locked by a file, remove the file install.lock stored in Dolibarr root directory.

*For security reason, once setup is finished, you should create a file install.lock into Dolibarr documents directory. This will lock the call of the install process again (you will have to remove this file for future upgrades). If this is not done, Dolibarr will show you a warning once logged with an administrator user.

<source lang="bash">
$ echo > documents/install.lock
$ chmod 444 documents/install.lock
</source>

Module Web Services API REST (développeur)

2021-05-31T10:28:39Z

Florian.mortgat: /* Développer un nouveau service / sa propre API */ fix typo

[[en:Module_Web_Services_API_REST_(developer)]]


{{TemplateDocDevFr}}
{{TemplateModFR}}
[[Category:Liste des Modules (développeur)]]
{{BasculeDevUser|
nom=Web services|
num=2610|
devdoc=Cette page|
userdoc=Non applicable|}}

= Fonction =
Quand ce module est activé, vous activez l'utilisation des Webservices fournis par Dolibarr. Vous pouvez alors faire des appels REST sur différents Webservices fournis par Dolibarr.

= Serveur de Web services REST Dolibarr =
Une fois que le module Web services REST est activé, Dolibarr devient également un serveur de Web services REST. Vous pouvez alors envoyer vos propres requêtes sur l'url relative :
'''/api/index.php/xxx''' où xxx est l'API à appeler.

= Liste des services fournis =
Seuls quelques services sont disponibles. À compter de la version 5.0 de Dolibarr, vous pouvez consulter la liste complète des web services proposés en appelant l'explorer à cette adresse :

'''http://yourdolibarrurl/api/index.php/explorer'''.

Vous devez au préalable faire un premier appel au service '''login''' pour obtenir une clé API.
Vous entrez alors la clé pour obtenir la liste des services proposés

Par exemple, vous pouvez essayer l'explorateur sur l'instance de démonstration à l'adresse suivante :

'''https://demo.dolibarr.org/api/index.php/explorer'''

Vous pouvez ensuite tester directement à partir de cet explorateur n'importe quelle API. Ceci est la solution recommandée pour tester toute API Dolibarr, car toutes les API et paramètres sont documentés ici. À la suite d'un test, vous obtiendrez la réponse, mais également un exemple sur la façon d'appeler l'API à partir de la ligne de commande à l'aide de curl.

= Installation =

Pour l'installer, ouvrez la page des modules et activez le module API REST. Sur la page de configuration du module, il y a un lien vers un explorateur. Cliquez dessus pour ouvrir l'explorateur d'API.

Dans le coin supérieur droit, collez le <token> de l'utilisateur que vous souhaitez utiliser pour appeler l'API, puis cliquez sur le bouton "explorer". Remarque: Le jeton de chaque utilisateur peut être défini sur la page d'enregistrement de l'utilisateur.

Après avoir cliqué sur "Explorer", vous devriez voir toutes les actions disponibles avec ce jeton. Si vous n'avez pas beaucoup d'actions, c'est probablement parce que les modules correspondants ne sont pas activés. Si vous voulez voir les factures, vous devez activer le module Factures dans la configuration de Dolibarr. Même chose pour les Produits, les Tiers, etc.

Sur cette page d'exploration de l'API, vous pouvez faire beaucoup de tests. Lire des données de Dolibarr et écrire, modifier et supprimer également. Attention: les données sont vraiment modifiées dans votre base de données.

= Utilisation =

Grosso modo, pour utiliser REST, il faut appeler une url du genre suivant <nowiki>http://<mon_serveur>/api/index.php/<action></nowiki> 
avec une des 4 méthodes : GET, POST, PUT, DELETE, en remplaçant <action> par l'action sur laquelle vous voulez intervenir. Ex : <nowiki>http://<mon_serveur>/api/index.php/invoices</nowiki>

Pour ce faire, il existe plusieurs méthodes. Voici un morceau de code opérationnel pour appeler une API, mais il existe également des librairies qui simplifie le travail, telles que phphttpclient.com.

<source lang="php">
function CallAPI($method, $apikey, $url, $data = false)
{
$curl = curl_init();
$httpheader = ['DOLAPIKEY: '.$apikey];

switch ($method)
{
case "POST":
curl_setopt($curl, CURLOPT_POST, 1);
$httpheader[] = "Content-Type:application/json";

if ($data)
curl_setopt($curl, CURLOPT_POSTFIELDS, $data);

break;
case "PUT":

curl_setopt($curl, CURLOPT_CUSTOMREQUEST, 'PUT');
$httpheader[] = "Content-Type:application/json";

if ($data)
curl_setopt($curl, CURLOPT_POSTFIELDS, $data);

break;
default:
if ($data)
$url = sprintf("%s?%s", $url, http_build_query($data));
}

// Optional Authentication:
// curl_setopt($curl, CURLOPT_HTTPAUTH, CURLAUTH_BASIC);
// curl_setopt($curl, CURLOPT_USERPWD, "username:password");

curl_setopt($curl, CURLOPT_URL, $url);
curl_setopt($curl, CURLOPT_RETURNTRANSFER, 1);
curl_setopt($curl, CURLOPT_HTTPHEADER, $httpheader);

$result = curl_exec($curl);

curl_close($curl);

return $result;
}
</source>

Ce n'est qu'un exemple, ce n'est pas sécurisé, cela ne prend pas en compte les codes erreurs mais vous pouvez le modifier et l'adapter à vos besoins.
la fonction prend 4 paramètres :
* $method : string "GET", "POST", "PUT", "DELETE"
* $apikey : string "votre <token> généré plus haut"
* $url : string l'url à appeler. Ex : "<nowiki>http://<mon_serveur>/api/index.php/invoices</nowiki>"
* $data : string flux au format json. Ce champ est requis pour les appels POST ou PUT.

= Exemples =

Maintenant, quelques exemples opérationnels pour différents cas d'utilisation. 

Dans tous les cas, on a :
* $apiKey = "<mon token>";
* $apiUrl = "<nowiki>http://<mon_serveur>/api/index.php/</nowiki>";

<source lang="php">
// Récupérer la liste des produits
$listProduits = [];
$produitParam = ["limit" => 10000, "sortfield" => "rowid"];
$listProduitsResult = CallAPI("GET", $apiKey, $apiUrl."products", $produitParam);
$listProduitsResult = json_decode($listProduitsResult, true);

if (isset($listProduitsResult["error"]) && $listProduitsResult["error"]["code"] >= "300") {
} else {
foreach ($listProduitsResult as $produit) {
$listProduits[intval($produit["id"])] = html_entity_decode($produit["ref"], ENT_QUOTES);
}
}
</source>
Commentaires :
* récupérer les 10'000 premiers produits triés par leur id dans la base
* html_entity_decode est nécessaire car les apostrophes sont encodés
* il est facile d'utiliser la même méthode (en remplaçant products par dictionnarycountries) pour récupérer la liste des pays

<source lang="php">
// Créer un produit
$ref = "ma_reference_produit_X203ZZ";
$newProduct = [
"ref" => $ref,
"label" => $ref
];
$newProductResult = CallAPI("POST", $apiKey, $apiUrl."products", json_encode($newProduct));
$newProductResult = json_decode($newProductResult, true);
</source>
Commentaires :
* avant de créer un produit, il peut être sage de vérifier qu'il existe. En reprenant le premier exemple, cela fait :

<source lang="php">
// ma référence
$ref = "ma_reference_produit_X203ZZ";
// existe-t-elle dans mon tableau
$produitKey = array_search($ref, $listProduits);
if ($produitKey) {
// oui
$fk_product = $produitKey;
} else {
// non
// Créer un produit
$newProduct = [
"ref" => $ref,
"label" => $ref
];
$newProductResult = CallAPI("POST", $apiKey, $apiUrl."products", json_encode($newProduct));
$newProductResult = json_decode($newProductResult, true);
if (isset($newProductResult["error"]) && $newProductResult["error"]["code"] >= "300") {
// il y a eu une erreur
echo "<pre>ERROR", var_dump($newProductResult), "</pre>";
exit;
} else {
// tout va bien
$fk_product = $newProductResult;
$listProduits[$fk_product] = $ref;
}
}
</source>
Commentaires :
* je regarde si la référence de mon article existe dans le tableau créé dans le premier exemple.
* si elle existe, j'utilise sa clé dans le tableau comme id
* si elle n'existe pas, je crée l'article puis le j'ajoute à mon tableau pour les prochaines fois et je récupère l'id créé
* cette méthode permet de limiter les appels API quand on doit importer 500 commandes par exemple. Récupérer une fois la liste des produits au début au lieu de chercher à chaque fois dans Dolibarr.

<source lang="php">
// créer une commande avec 2 articles

// le tableau qui contiendra toutes les lignes d'articles de la commande
$newCommandeLine = [];

// article 1
$ref1 = "ma_reference_produit_X203ZZ";
$prix1 = 10;
$qtt1 = 100;
$tva1 = 20;
$fk_product1
// article 2
$ref2 = "ma_reference_produit_B707FD";
$prix2 = 13;
$qtt2 = 37;
$tva2 = 20;

$newCommandeLine[] = [
"desc" => $ref1,
"subprice" => $prix1,
"qty" => $qtt1,
"tva_tx" => floatval($tva1),
"fk_product"=> $fk_product1
];

$newCommandeLine[] = [
"desc" => $ref2,
"subprice" => $prix2,
"qty" => $qtt2,
"tva_tx" => floatval($tva2),
"fk_product"=> $fk_product2
];

if (count($newCommandeLine) > 0) {
$newCommande = [
"socid" => $clientDoliId,
"type" => "0",
"lines" => $newCommandeLine,
"note_private" => "Commande importée automatiquement depuis l'application",
];
$newCommandeResult = CallAPI("POST", $apiKey, $apiUrl."orders", json_encode($newCommande));
$newCommandeResult = json_decode($newCommandeResult, true);
}
</source>
Commentaires :
* $clientDoliId vaut l'id du client dans la base doli. Soit vous le connaissez, soit vous pouvez le chercher auparavant
* type => 0, c'est une commande client (par opposition à 1 = commande fournisseur)

<source lang="php">
// Valider une commande
$newCommandeValider = [
"idwarehouse" => "0",
"notrigger" => "0"
];
$newCommandeValiderResult = CallAPI("POST", $apiKey, $apiUrl."orders/".$newCommandeResult."/validate", json_encode($newCommandeValider));
$newCommandeValiderResult = json_decode($newCommandeValiderResult, true);
</source>
Commentaires :
* on voit dans cet exemple, en avant dernière lignes, on a : $apiUrl."orders/".$newCommandeResult."/validate". 
$newCommandeResult est l'id de la commande crée (récupéré dans l'exemple précédent)

<source lang="php">
// chercher si le client existe dans la base
$clientSearch = json_decode(CallAPI("GET", $apiKey, $apiUrl."thirdparties", array(
"sortfield" => "t.rowid",
"sortorder" => "ASC",
"limit" => "1",
"mode" => "1",
"sqlfilters" => "(t.nom:=:'".$nom_client."')"
)
), true);
</source>
Commentaires :
* limit => 1 pour ne renvoyer que 1 client
* mode => 1 car on cherche un client (on aurait aussi pu chercher un fournisseur qui est aussi un tiers mais avec un statut différent)
* sqlfilters syntaxe un peu particulière mais il y a qq autres exemples sur la page d'explorer d'API

<source lang="php">
//client n'existe pas. le crée puis on récupère son id
$newClient = [
"name" => "nom société client",
"email" => "email société client",
"client" => "1",
"code_client" => "-1"
];
$newClientResult = CallAPI("POST", $apiKey, $apiUrl."thirdparties", json_encode($newClient));
$newClientResult = json_decode($newClientResult, true);
$clientDoliId = $newClientResult;
</source>
Commentaires :
* client => 1 car c'est un client (et pas un fournisseur)
* code_client => -1 pour que le code client soit généré automatiquement.
* on récupère l'id du client dans $clientDoliId

= Développer un nouveau service / sa propre API =

Ajouter un nouveau service est aussi facile qu'ajouter un fichier nommé '''api_monmoduleobject.class.php''' dans le dossier '''htdocs/monmodule/class'''.
Si vous utilisez le "modulebuilder" pour développer sur Dolibarr, cette API avec les méthode CRUD pourra même être générée pour vous.
Sinon, un copié-collé d'un fichier API existant fera l'affaire. Vous pouvez prendre comme exemple le fichier dans '''htdocs/commande/class/api_orders.class.php''' et l'adapter à votre classe / besoin.

Le framework détecte automatiquement les API et elle devrait être visible dans l'explorateur.

Les méthodes et paramètres sont détectées en fonction de l'introspection réalisée dans les classes PHP de l'objet ('''htdocs/monmodule/class/object.class.php''') en utilisant les '''annotations''' trouvées dans la classe.

Pour une documentation à propos des annotations : https://github.com/Luracast/Restler/blob/master/ANNOTATIONS.md

Vous trouverez pas mal d'autres informations dans le code de Dolibarr, en regardant dans '''htdocs/<dossier>/class/api_xxx_class.php''' 
Ex pour les tiers: htdocs/societe/class/api_thirdparties.class.php pour les tiers. 
Ex pour les factures: htdocs/compta/facture/class/api_invoices.class.php 
...

Ce que ne fait pas Dolibarr

2020-03-13T14:26:32Z

Florian.mortgat: entre elle -> entre elles

[[en:What_Dolibarr_can't_do]]
[[es:Lo_que_no_hace_Dolibarr]]
[[zh:Dolibarr不能做什么？]]


[[Category:FAQ_FR]]
{{TemplateDocUtil}}

Ces fonctionnalités ne sont pas disponibles, y compris dans les dernières versions

*Dolibarr ne contient pas de module de Gestion de la paie. Un module Salaire permet la saisie et donc le suivi du paiement des salaires, mais il n'y a pas de fonction pour calculer et générer la feuille de paie.
*Les taches du module de gestion de projets n'ont pas de dépendance entre elles.
*Dolibarr ne contient pas de Webmail.
*La comptabilité double-partie est disponible depuis la version 6.0, toutefois les rapports ne sont pas encore tous disponibles.
*La gestion du multi-société (plusieurs sociétés gérées avec une seule installation et partage d'éléments, comme les clients) nécessite d'installer le module [[Module MultiCompany]] disponible sur {{LinkToPluginDownloadDoliStore}}. A défaut, il est toujours possible de créer autant d'instance que de sociétés mais il n'y aura pas de partages d'information (comme le partage des clients comme on peut le faire avec le module).
*Dolibarr ne fait pas le café (pas encore... enfin avec un rasbpberry et un peu de connaissances en électronique : c'est quand même faisable ;) ).

Pour la liste des fonctionnalités fournies, voir la page [[Ce que fait Dolibarr]].

Système de menus

2020-02-20T15:23:21Z

Florian.mortgat: /* Le système de menu Dolibarr */ conjugaison

[[en:Menus_system]]
[[es:Sistema_de_menús]]
[[de:Menü_System]]
[[zh:菜单]]


[[Category:Noyau]]
{{TemplateDocDev}}

=Le système de menu Dolibarr=

Il y a 2 systèmes de menu. Un système de menu définit les entrées de menu à afficher, conditions et localisation.

Changer de système de menu est possible via la page '''Configuration - Menus'''. Choisir ensuite '''Editeur de menus'''. Prendre par exemple les gestionnaires de menu "auguria", fournis en standard au lieu de "eldy". Ces gestionnaires de menu (gauche et haut) sont complètement opérationnels et offre la même vision mais en utilisant une technologie de stockage différente.

Pour personnaliser ces menus par défaut, vous pouvez, soit ajouter votre propre entrée menu, soit développer votre propre gestionnaire de menu qui remplacera complètement le gestionnaire par défaut. Vous décidez alors comment stocker votre menu (en base de données comme avec le gestionnaire de menu '''auguria''', centralisé en dur dans un fichier comme avec le gestionnaire de menu '''eldy''', dans un fichier xml, ...). Voir les chapitres suivant pour cela....

=Ajouter votre entrée menu=
Imaginez que vous vouliez ajouter une entrée menu. Allez dans '''Accueil - Configuration - Menus'''. Choisir '''Editeur de menu'''. Ajouter l'entrée.

Par exemple, pour ajouter une entrée de menu afin d'arriver sur la page qui liste uniquement les opportunités avec les filtres déjà positionnées, vous ajouterez une entrée qui ressemblera à ceci:

<div class="divforimgcentpercent">
[[File:Menu editor.png]]
</div>

=Développer son propre système de menu=

Le but de cet article est de décrire comment créer un nouveau système de menu dans son intégralité (remplacement de l'intégralité des entrées menus, chamboulement complet du concept de navigation).

Cela ne concerne pas le simple ajout d'entrées de menus. Si tel et le cas et que vous désirez juste savoir comment ajouter des entrées menus au sein d'un gestionnaire de menu existant, dans le cadre du développement d'une extension ou d'un nouveau module par exemple, reporter vous plutôt à la page [[Developpement module]].

Si vous voulez remplacer intégralement un systeme de menu par le votre, le plus simple est de prendre exemple sur le gestionnaire de menu "eldy_backoffice".

==Pour développer son '''système de menu haut'''==
Il suffit de

#Copier le fichier htdocs/core/menus/standard/eldy_backoffice.php sous un autre nom comme htdocs/core/menus/standard/monmenu.php
#Editer ensuite le fichier monmenu.php. La fonction showmenu() de la classe MenuTop est la fonction appelée par Dolibarr lorsqu'il génère une page pour afficher ce menu haut. On peut y mettre le code que l'on veut, cette fonction ne modifie aucune variable extérieur et doit juste afficher par des "print" le menu que l'on veut voir. On peut ainsi récupérer le menu à afficher depuis un fichier de configuration, une base de données et le personnaliser par rapport à l'environnement. L'environnement Dolibarr étant stocké dans les 3 objets global suivant: $user, $conf, $langs.

$user contient les informations propres à l'utilisateur.
$conf contient les informations propres à la configuration (modules actifs, permissions actives, etc...)
$langs contient les informations propres à la langue active.

Exemple de fonction showmenu() du fichier htdocs/core/menus/standard/monmenu.php
<source lang="php">
function showmenu()
{
global $user,$conf,$langs,$dolibarr_main_db_name;

print '<table class="tmenu"><tr class="tmenu">';

// Menu Home
print '<td class="tmenu"><a '.$class.' href="'.DOL_URL_ROOT.'/index.php?mainmenu=home&leftmenu="'.($this->atarget?" target=".$this->atarget:"").'>'.$langs->trans("Home").'</a></td>';

// Put here other entries
// ...

print '</tr></table>';
}
</source>

==Pour développer son '''système de menu gauche'''==
Le principe est aussi simple que le menu haut.

#Copier le fichier htdocs/core/menus/standard/eldy_backoffice.php sous un autre nom comme htdocs/core/menus/standard/monmenu.php.
#Il faut ensuite modifier la fonction showmenu() de la classe MenuLeft afin de fabriquer son menu gauche. Si on veut afficher le menu standard ou juste le modifier légèrement sans recréer le sien complètement, il suffit de boucler sur le contenu du tableau $menu->liste. Si vous voulez afficher un menu complètement différent et totalement contrôlé par vous, il vous faut, dans la fonction showmenu(), créer un objet $newmenu=new Menu() et utiliser les méthodes $newmenu->add et $newmenu->add_submenu pour définir la liste des entrées menu gauche à faire apparaitre. Une fois cela fait, on affiche par des "print" le contenu du tableau $newmenu->liste (qui vient d’être construit) au lieu de $menu->liste.

Exemple de fichier htdocs/core/menus/standard/monmenu.php
<source lang="php">
function showmenu()
{
global $user,$conf,$langs,$dolibarr_main_db_name;
$newmenu = new Menu();

// Put here left menu entries
// ***** START *****

$langs->load("admin"); // Load translation file admin.lang
$newmenu->add(DOL_URL_ROOT."/admin/index.php?leftmenu=setup", $langs->trans("Setup"));
$newmenu->add_submenu(DOL_URL_ROOT."/admin/company.php", $langs->trans("MenuCompanySetup"));
$newmenu->add_submenu(DOL_URL_ROOT."/admin/modules.php", $langs->trans("Modules"));
$newmenu->add_submenu(DOL_URL_ROOT."/admin/ihm.php", $langs->trans("GUISetup"));
$newmenu->add_submenu(DOL_URL_ROOT."/admin/boxes.php", $langs->trans("Boxes"));
$newmenu->add_submenu(DOL_URL_ROOT."/admin/delais.php",$langs->trans("Alerts"));
$newmenu->add_submenu(DOL_URL_ROOT."/admin/triggers.php", $langs->trans("Triggers"));
$newmenu->add_submenu(DOL_URL_ROOT."/admin/perms.php", $langs->trans("Security"));
$newmenu->add_submenu(DOL_URL_ROOT."/admin/dict.php", $langs->trans("DictionnarySetup"));
$newmenu->add_submenu(DOL_URL_ROOT."/admin/const.php", $langs->trans("OtherSetup"));

// ***** END *****

// do not change code after this

// override menu_array by value array in $newmenu
$this->menu_array=$newmenu->liste;

$alt=0;
for ($i = 0 ; $i < sizeof($this->menu_array) ; $i++)
{
$alt++;
if ($this->menu_array[$i]['level']==0) {
if (($alt%2==0))
{
print '<div class="blockvmenuimpair">'."\n";
}
else
{
print '<div class="blockvmenupair">'."\n";
}
}

if ($this->menu_array[$i]['level']==0) {
if ($this->menu_array[$i]['enabled'])
print '<a class="vmenu" href="'.$this->menu_array[$i]['url'].'">'.$this->menu_array[$i]['titre'].'</a> ';
else
print ''.$this->menu_array[$i]['titre'].' ';
}
if ($this->menu_array[$i]['level']==1) {
if ($this->menu_array[$i]['enabled'])
print '<a class="vsmenu" href="'.$this->menu_array[$i]['url'].'">'.$this->menu_array[$i]['titre'].'</a> ';
else
print ''.$this->menu_array[$i]['titre'].' ';
}
if ($this->menu_array[$i]['level']==2) {
if ($this->menu_array[$i]['enabled'])
print '    <a class="vsmenu" href="'.$this->menu_array[$i]['url'].'">'.$this->menu_array[$i]['titre'].'</a> ';
else
print '    '.$this->menu_array[$i]['titre'].' ';
}
if ($this->menu_array[$i]['level']==3) {
if ($this->menu_array[$i]['enabled'])
print '        <a class="vsmenu" href="'.$this->menu_array[$i]['url'].'">'.$this->menu_array[$i]['titre'].'</a> ';
else
print '        '.$this->menu_array[$i]['titre'].' ';
}

if ($i == (sizeof($this->menu_array)-1) || $this->menu_array[$i+1]['level']==0) {
print "</div>\n";
}
}

}
</source>

=Forcer l'utilisation de votre gestionnaire de menu=
Vous pouvez aussi forcer l'utilisation de votre gestionnaire au dépend de tout autre en développant un module.
Pour cela, il suffit d'ajouter les 4 constantes suivantes dans le tableau $this->const de votre descripteur de module (Voir la page [[Développement module]]).
<source lang="php">
* 1=>array('MAIN_MENU_STANDARD_FORCED','chaine','monmenu.php','Force menu handler to this value',1,'current',1),
* 2=>array('MAIN_MENUFRONT_STANDARD_FORCED','chaine','monmenu.php','Force menu handler to this value',1,'current',1),
* 3=>array('MAIN_MENU_SMARTPHONE_FORCED','chaine','monmenu.php','Force menu handler to this value',1,'current',1),
* 4=>array('MAIN_MENUFRONT_SMARTPHONE_FORCED','chaine','monmenu.php','Force menu handler to this value',1,'current',1),
</source>
Votre gestionnaire de menu sera utilisé, quelque soit la configuration, une fois que le module aura été activé.

Loi finances sur les logiciels de caisse et Certification NF525 ou LNE

2020-02-19T13:07:48Z

Florian.mortgat: /* Résumé */ à soit même → à soi-même

<seo metak="loi finance 2016, loi finance 2018, loi finance 2019, NF525, logs inaltérables, logiciels de caisse, logiciels comptabilité" />
Ceci est une page de suivi du projet Article 88 de la Loi finance 2016 (n° 2015-1785 du 29 décembre 2015), applicable au 1er janvier 2018 en France (sans tolérance en 2019).

= Résumé =

La '''loi finances 2016, article 88 modifiant le 286 du CGI''', impose à tous les commerçants, '''assujettis à la TVA hors franchise en base de TVA''' (et seulement ces derniers) ET qui sont équipés d'un "logiciel ou système de caisse" (comprendre logiciel d'encaissement d'argent, cela inclut les logiciels de gestion) ET qui réalisent de l'encaissement de particuliers, d'utiliser un logiciel dans un cadre "conforme" à la loi finance 2016, et ce dès le 1er janvier 2018 (avec tolérance sur 2018 si l'utilisateur peut montrer qu'il a entamé une trajectoire dans le but de mise en conformité, mais n'a pas encore pu finaliser sa démarche par exemple pour cause d'attente de publication d'une version conforme, ou de délai nécessaire pour la migration technique).

La "conformité Loi Finance" dite aussi "Anti Fraude TVA" est absolument sans aucun rapport avec la notion de "Compatible avec les normes de logiciels comptables", normes requises pour établir les documents fiscaux officiels et les télétransmettre à l'administration. Ces normes (par exemple "la compatibilité avec le format FEC" obligatoire depuis le 1er janvier 2014 [https://www.legifrance.gouv.fr/affichCodeArticle.do?cidTexte=LEGITEXT000006069583&idArticle=LEGIARTI000027804775 défini ici], ou encore "la compatibilité pour télétransmission EDI") existent d'ailleurs depuis plusieurs années bien avant la loi finance 2016 et concernent uniquement le "logiciel de comptabilité" de l'expert comptable qui approuve les comptes, logiciel utilisé en fin de chaîne pour produire la liasse fiscale, et, seul ce dernier logiciel a cette contrainte de "compatibilité logiciel comptable" : le logiciel de gestion ou de suivi de l'entreprise (comme par exemple Dolibarr), même si il est utilisé pour réaliser une comptabilité interne de l'entreprise (par exemple en préparation d'export vers le logiciel de l'expert-comptable, ou utilisé pour offrir un suivi ou mâcher le travail du comptable pour réduire son coût), n'a '''aucune obligation sur ce point ''' si c'est un autre qui sert pour établir les documents légaux.

Par contre, le logiciel de l'entreprise peut avoir l'obligation d'être '''conforme Loi finance 2016 - Anti Fraude TVA'''. Cette conformité s'applique à tout "logiciel d'encaissements", ce qui est différent de "logiciel comptable" (et donc s'applique aux logiciels de facturation ou de gestion avec saisie d'encaissements, aux logiciels de caisse enregistreuse (Point de Vente) et, éventuellement, aux logiciels de comptabilité si c'est lui qui est utilisé pour saisir et suivre les encaissements clients, ce qui est rarissime car cela sous-entend que la gestion de l'entreprise est faite directement dans le logiciel du comptable qui certifie les comptes !).

Cette conformité "Loi Finance" pour son logiciel d'encaissement, peut s'obtenir de 3 manières différentes (une seule des 3 solutions suffit):

* Par l'utilisation d'une version '''certifiée Loi Finance''' du logiciel (Exemple via l'obtention de la certification LNE ou l'obtention de la norme NF525 de l'AFNOR). Une version certifiée l'est pour tout le monde mais, pour évoluer, il faut attendre la prochaine version certifiée, et le processus de certification est long et coûteux pour l'éditeur. Le principe de certification n'est donc plus adapté aux logiciels modernes ni aux logiciels en Cloud/SaaS qui évoluent rapidement).
ou bien
* Par obtention d'une '''attestation individuelle de conformité Loi Finance''' décernée par une société Tiers, comme un éditeur ou intégrateur informatique (Exemple d'attestation vierge proposé par le gouvernement: http://bofip.impots.gouv.fr/bofip/10692-PGP.html). Une attestation est individuelle, chaque société utilisatrice doit en obtenir une, auprès d'un Tiers, pour elle même.
ou bien
* En '''se délivrant à soi-même cette attestation''' (sans la demander à un tiers donc), on parle d'auto-attestation, mais ce cas est limité aux sociétés qui ont, entre autre, une activité '''avérée''' d'édition de logiciel de caisse (le code Nace n'ayant qu'une valeur indicative statistique, c'est votre activité réelle, dont il vous revient d'en démontrer le côté avéré qui sera pris en compte, et non un code Nace spécifique comme cela avait été cité dans des versions intermédiaires de texte de loi)

Le chapitre "Historique" vous permet de voir les rebondissements et changements de direction de la loi. Connaitre ces rebondissements aide à comprendre pourquoi de nombreux acteurs se sont trompés ou continuent de se tromper sur cette loi. Le chapitre d'après "Questions / Réponses" vous offre une vue rapide de la loi définitive par une approche de questions/réponses.

== Historique de la définition de la loi et rebondissements ==

Pour ceux qui ont le temps de lire, voici un flux qui décrit les documents originaux qui ont été communiqués par le gouvernement et les mises à jours qui ont suivi pour définir le périmètre et la conclusion de la loi, avec les rebondissements:

* Voici l'article '''initial''' de la loi finance, datant du 29/12/2015: [https://www.legifrance.gouv.fr/affichTexteArticle.do?cidTexte=JORFTEXT000031732865&idArticle=LEGIARTI000031734740&dateTexte=20151230 Article sur LegiFrance]
* Voici l'article, '''pour sa publication au BOFIP''', du 03/08/2016: http://bofip.impots.gouv.fr/bofip/10691-PGP.html?identifiant=BOI-TVA-DECLA-30-10-30-20160803

Pour résumer, ces 2 publications indiquent qu'il faudra, pour toute société/organisme qui ''enregistre les règlements de ses clients au moyen d'un logiciel de comptabilité ou de gestion ou d'un système de caisse, utiliser un logiciel ou un système satisfaisant à des conditions d'inaltérabilité, de sécurisation, de conservation et d'archivage des données en vue du contrôle de l'administration fiscale, attestées par un certificat délivré par un organisme accrédité dans les conditions prévues à l'article L. 115-28 du code de la consommation OU par une attestation individuelle de l'éditeur, conforme à un modèle fixé par l'administration''

[[File:Warning.png]] 15 juin 2017: Communiqué de presse du cabinet du ministère: http://proxy-pubminefi.diffusion.finances.gouv.fr/pub/document/18/22503.pdf ->
Seules les "logiciels de caisse" seraient concernés (la définition de logiciel de caisse n'est toutefois pas encore apportée, elle le sera le 15 juillet 2018, voir la suite).
Dès logiciels ERP (comme Dolibarr), ainsi que les logiciels de site ecommerce (comme Prestashop, Magento, ...) n'étant dans pas la catégorie logiciels de caisse (Les ERP sont dans la catégorie logiciels de gestion), on aurait cru que l'obligation de mise en conformité et tout ce qui suit semblait ne plus être avéré pour eux, mais la suite des événements (voir la suite) indiquera le contraire si vous enregistrez dans le logiciel des paiements de particuliers, quelquesoit la catégorie du logiciel (seules les sociétés encaissant exclusivement d'autres sociétés, ou ceux en tva en franchise, seront finalement exemptées)...

[[File:Warning.png]] 27 septembre 2017: Voici l'avenant publié le 27 septembre 2017 qui réduit la portée/périmètre de la loi aux seuls "logiciels de caisse": http://www.assemblee-nationale.fr/15/projets/pl0235.asp (Article 46). En d'autres terme, les applications ERP (Comme Dolibarr) semblent la encore ne plus être concernées, mais la suite des événements (voir la suite) indiquera le contraire si vous encaissez des particuliers (seules les sociétés encaissant exclusivement d'autres sociétés, ou ceux en franchises seront finalement exemptées)...

Suite aux questions, une FAQ, issue du ministère des finances, est alors parue pour tenter de clarifier le périmètre. Elle indique que tous les assujetis à TVA qui vendent à un non assujetti (particuliers) sont concernés. Si on lit tel quel cette FAQ, alors le périmètre est non seulement pas réduit, comme communiqué par le ministère dans son courrier du 15 juin, mais élargit, y compris aux sites e-commerce. Cette FAQ est le premier élément qui apporte donc une définition au terme "système de caisse" en considérant tout logiciel traçant des encaissements, comme "systeme de caisse".
Des amendements ont été rédigés pour tenter de clarifier ou restreindre cette définition, voir la suite...

[[File:Warning.png]] 14 octobre 2017: Une reformulation du texte, plus complète que la FAQ, est donnée stipulant qu'une entité est concernée... "''Si elle effectue des livraisons de biens et des prestations de services ne donnant pas lieu à facturation conformément à l’article 289 et enregistre ces opérations au moyen d’un logiciel ou d'un système de caisse'' ... ". Dans ce cas, il faut "''... utiliser un logiciel ou un système satisfaisant à des conditions d'inaltérabilité, de sécurisation, de conservation et d'archivage des données en vue du contrôle de l'administration fiscale, attestées par un certificat délivré par un organisme accrédité dans les conditions prévues à l'article L. 433-4 du code de la consommation OU par une attestation individuelle de l'éditeur, conforme à un modèle fixé par l'administration ;''"

Il est aussi précisé: ''« 2. Les assujettis bénéficiant d'une franchise de taxe mentionnée à l'article 293 B, ceux placés sous le régime du remboursement forfaitaire prévu aux articles 298 quater et 298 quinquies et ceux effectuant exclusivement des opérations ou des prestations exonérées de taxe sur la valeur ajoutée sont dispensés de l'obligation mentionnée au 3° bis du I. » ;
''

Voir: [https://www.legifrance.gouv.fr/eli/loi/2017/12/30/CPAX1723900L/jo/texte/fr#JORFARTI000036339313 Article sur LegiFrance] pour le texte complet mentionnant ces 2 points.

[[File:Warning.png]] 20 novembre 2017: Nouveaux éléments permettant de mieux cibler le périmètre. En effet, l'amendement II-CF15 = II-1649 de la loi Finance 2018 sur l'article 46 pour exclure les encaissements de particuliers qui font l'objet de fabrication d'une facture en bon et du forme (afin d'exclure les ERP et plateforme ecommerce) a été rejeté en séance à l'assemblée: Seule l'encaissement de sociétés est bien hors périmètre. En effet, considérant que l'administration a le droit de vérification chez les clients de type société, les traces fournies par les factures suffisent pour assurer un contrôle satisfaisant, mais ce droit n'existe pas en ce qui concerne la facturation des particuliers. Dans ce cas la, même la facture est peu utile à l'administration et par conséquent les contraintes d'inaltérabilité deviennent requises, même si on émet une facture en bon et du forme. Cette conclusion fait suite aux échanges suites à l'amendement II-CF15 = II-1649 de la loi Finance 2018 sur l'article 46.

Pour info, texte complet de la tentative d'amendement: http://www.assemblee-nationale.fr/15/amendements/0235C/AN/1649.asp ou en PDF http://www.assemblee-nationale.fr/15/amendements/0235C/CION_TOUTE/CF15.pdf

Et voici les extraits importants de la discussion:

D'abord, la tentative de M. Bruno Millienne pour tenter d'exclure les logiciels émettant des factures en bon et du forme:

''M. Bruno Millienne. "[...]le renvoi à l’article 289 du code général des impôts – CGI – ne vise que les cas d’émission de factures obligatoires au sens fiscal pour les opérations entre assujettis ou personnes morales. En l’état, le texte conduirait à appliquer le dispositif de certification ou d’attestation à toutes les opérations réalisées avec les particuliers, même lorsqu’elles donnent lieu à l’émission de factures conformes au CGI, par exemple dans le cadre du commerce électronique. [...] La rédaction actuelle de l’article peut conduire à requalifier en logiciel de caisse un logiciel de facturation, si des factures sont émises à l’attention d’un particulier ou d’une administration, ou un logiciel de comptabilité, si des règlements sont comptabilisés directement par l’utilisateur. L’éditeur deviendrait ainsi responsable du mode d’utilisation de son logiciel par l’assujetti. Il est impossible de transposer les exigences d’un logiciel de caisse à un logiciel de facturation : leurs fonctionnalités respectives sont totalement différentes. Actuellement, il existe des dispositifs de certification en matière de caisse, mais pas en matière de facturation."''

''...''

Réponse de ''M. Joël Giraud, rapporteur général de la commission des finances, de l’économie générale et du contrôle budgétaire: Avis défavorable. L’article 46 précise que l’obligation de certification ne vaut que pour les logiciels ou systèmes de caisse. L’obligation ne concernera plus les progiciels de gestion intégrée ou de comptabilité : pour ces logiciels multifonctions qui traitent à la fois la comptabilité, la gestion et la caisse, seuls les modules caisse enregistreuse et encaissement devront être certifiés, non l’ensemble du logiciel.''

''...''

Et enfin le complément de ''M. Benjamin Griveaux, secrétaire d’État auprès du ministre de l’économie et des finances: Avis défavorable. Une facture n’est obligatoire, au sens fiscal, que dans le cadre d’une relation B to B – business to business, c’est-à-dire d’entreprise à entreprise. L’administration fiscale peut la contrôler car elle dispose d’un droit de communication envers l’entreprise cliente. A contrario, elle ne peut exercer de droit de communication auprès des particuliers. Cet amendement conduirait donc à exclure du dispositif de sécurisation les entreprises qui émettent des factures contenant les mentions légales, qu’elles soient adressées à des entreprises ou à des particuliers. Je suis donc l’avis du rapporteur général quant au risque de fraude accrue que cet amendement ferait courir.''

La discussion complète de la séance ayant rejeté l'amendement est disponible ici: http://www.assemblee-nationale.fr/15/cri/2017-2018/20180063.asp#P1103690

'''En conclusion, l'amendement ayant été rejeté, il faut en déduire que la volonté est bien d'intégrer, dans le périmètre, toutes les parties/modules de logiciels, utilisés comme caisse enregistreuse OU pour enregistrer des paiements de particuliers (logiciel ecommerce, de caisse, de gestion,...)''' et que l'émission de facture en bon et du forme à des particuliers ne permet pas de sortir du périmètre...

[[File:Warning.png]] 30 décembre 2017:

L'article 88 qui disaient ''..toute personne assujettie à la taxe sur la valeur ajoutée (TVA) qui enregistre les règlements de ses clients au moyen d'un logiciel de comptabilité ou de gestion ou d'un système de caisse, doit utiliser un logiciel ou un système satisfaisant à des conditions d'inaltérabilité, de sécurisation, de conservation et d'archivage des données en vue du contrôle de l'administration fiscale''
est complété par l'article 105 qui remplace "''logiciel de comptabilité ou de gestion ou d'un système de caisse''" par "''logiciel ou d'un système de caisse''"

[[File:Warning.png]] 23 janvier 2018: Un représentant du projet Dolibarr, avec des représentants de l'APRIL et du logiciel libre de caisse Pasteque, ont été reçus au ministère des finances afin d'échanger sur l'interprétation du texte. Les interprétations faites sur cette page (ainsi que les réponses faites aux FAQ qui suivent) ont pu être confirmées.
Toutefois, il y a intention de réduire le périmètre aux seuls logiciels de caisse. A suivre donc. Une version de travail revue, du Bofip doit être publiée à un comité restreint d'acteurs, dont l'April, fin janvier, afin de faciliter le travail d'interprétations, pour une publication officielle au printemps. En attendant, on ne peut qu'attendre (Cette publication aura lieu finallement le 4 juillet 2018 et une grande partie de nos retours s'avèrera prise en compte).

[[File:Warning.png]] 18 mai 2018: Réponse du gouvernement à quelques questions sur le sujet: https://www.nosdeputes.fr/15/question/QE/3257 . La réponse évoque l'année de tolérance en précisant que l'utilisateur devra montrer sa diligence en cas de contrôle (Soin appliqué à la mise en oeuvre de l'obtention de l'attestation individuelle)

[[File:Warning.png]] 5 juin 2018: Réponse du gouvernement à quelques questions sur le sujet: https://www.nosdeputes.fr/15/question/QE/2736 . La réponse évoque l'année de tolérance en précisant que l'utilisateur devra montrer sa diligence en cas de contrôle (Soin appliqué à la mise en oeuvre de l'obtention de l'attestation individuelle)

[[File:Warning.png]] 4 juillet 2018: Publication de la version corrigée du texte de loi au BOFIP: http://bofip.impots.gouv.fr/bofip/10691-PGP.html?ftsq=boi-tva-decla-30-10-30&identifiant=BOI-TVA-DECLA-30-10-30-20180704. Cette version conforte tous les points évoqués (le texte clarifie la loi et confirme que les interprétations vu ci-dessus s'avéraient justes), avec toutefois 2 ajouts majeures:
* La définition de logiciel de caisse a été donnée:

''Un logiciel ou système de caisse est un système informatique doté d'une fonctionnalité de caisse, laquelle consiste à mémoriser et à enregistrer extra-comptablement des paiements reçus en contrepartie d'une vente de marchandises ou de prestations de services c'est-à-dire que le paiement enregistré ne génère pas concomitamment, automatiquement et obligatoirement la passation d'une écriture comptable.''

''Ne sont pas considérés comme enregistrés extra-comptablement, quel que soit le mode de paiement, les paiements pour lesquels le logiciel ou système déclenche obligatoirement, instantanément et automatiquement, sans intervention humaine, une écriture dans le système d’information comptable.''

''Sont visés tous les logiciels ou systèmes de caisse permettant l'enregistrement des règlements de leurs clients quel que soit le mode de règlement (espèces, chèques, CB, virements, prélèvements...).
Cette obligation s'applique y compris en cas d'enregistrement sur un logiciel ou système accessible en ligne.''

''Sans que cette liste ne soit limitative, sont concernés par l'obligation les instruments de mesures réglementés, comme les balances, mais également les rampes de boissons automatisées, les automates de paiement ou encore les distributeurs automatiques de marchandises (boissons, gâteaux…) qui disposent d'une fonctionnalité de caisse.''

''Seule cette fonctionnalité de caisse, et non les autres fonctions telles que celles relatives à la pesée, doivent être certifiées.''"

* L'article 35 qui est un allègement du périmètre: Les professionnels réalisant leur paiement avec l'intermédiation d'un établissement de crédit européen ne sont plus soumis à l'obligation de certification ou attestation. Mais attention, on parle bien de paiements "directs" (donc Virement ou Carte de Débit ou de Crédit mais pas chèques qui n'est pas "direct") et surtout via un système de paiement géré par un organisme bancaire européen. En d'autres terme, si on ne fait que du paiement CB avec un module de VAD d'une banque, on est NON soumis à la certification/attestation mais si le paiement CB (carte de crédit ou débit) se fait par un service comme Stripe ou Paypal, sauf à être exempté pour un autre motif, on l'est toujours (car l'état français n'a pas de moyen d'obtenir le listing des transactions via ces solutions, bien que le paiement soit par carte bancaire).

== Conclusion pour le logiciel Open Source Dolibarr ERP CRM ==

Dolibarr ERP CRM est une application de gestion qui enregistre des factures (factures acomptes, avoirs ou standards). L'application permet aussi d'enregistrer des paiements. Le module POS (celui fourni par défaut), fonctionne aussi sur le principe de génération systématique de facture et d'enregistrement du paiement en temps réel. L'application est donc bien dans le périmètre (comme n'importe quel autre ERP, logiciel de caisse ou de Ecommerce). Mais en tant qu'utilisateur, vous n'êtes concerné que si vous n'etes pas en franchise de base ET si vous l'utilisez pour saisir des '''encaissements''' de particuliers (B2C=Business To Consumer) ou en mode mixte, à savoir encaissement aussi bien de particuliers (B2C) et d'entreprises (B2B), quelquesoit le ratio entre les 2. Si vous ne facturez QUE des professionnels, dans ce cas, vous n'êtes pas concerné par la LF2018 (Loi finance 2018).

Dans le cas où vous utilisez le module Facture, ou le module POS, pour encaisser des particuliers, et êtes assujettis à la TVA mais pas en franchise, vous êtes concerné. Il vous faut alors vous assurer que le module "Log inaltérable" ("BlockedLog") fourni avec la v7 est bien activé. Sa désactivation, une fois les premières saisies faites ne sera ensuite plus envisageable. Avec la migration en v7 et l'activation de ce module vous aurez alors une version conforme sur le plan technique et fonctionnel. Il vous faudra ensuite, obtenir une attestation de conformité auprès d'un tiers qui confirme cette conformité technique/fonctionnelle pour être conforme d'un point de vue juridique. Si vous utilisez une version en ligne Saas/Cloud fournie par un tiers, ce dernier vous la fournira surement (voir exemples sur https://saas.dolibarr.org). Dans le cas contraire, il vous faut contactez votre intégrateur informatique ou un prestataire pouvant fournir cette d'attestation.

Remarque: cette contrainte sera identique quelque soit l'ERP choisi. L'utilisation d'outils non spécialisés comme un tableur Excel ou autre, DANS LE BUT D'AVOIR UNE CONSERVATION DE TRACES DES PAIEMENTS, ne devient plus permis car le logiciel n'étant pas conforme, vous ne réussirez pas à trouver un prestataire pour fournir l'attestation de conformité. Par contre, si l'utilisation que vous faites d'Excel ou autre tableur est à des fins juste de "génération du PDF de la facture" sans ''conservation des données'' (Le texte de loi parle alors de logiciel "facturier"), vous pouvez continuer à l'utiliser ainsi. Dans le cas où l'utilisation est faite pour conserver trace de vos paiements, et si vous êtes dans le périmètre de la loi, un logiciel '''certifié ou attestable''' sur la partie encaissement (comme l'est Dolibarr) devient obligatoire.

Voyons aussi, par une autre approche, à savoir un système de question-réponse, comment synthétiser autrement tout cela:

= Questions / Réponses (FAQ) =

'''J'utilise Dolibarr ou autre logiciel ERP, suis-je concerné, pour quelle fonctionnalité ?'''

* Votre logiciel n'est concerné que si vous êtes '''assujetties à la TVA (et pas en franchise en base de TVA)''', ET si vous l'utilisez pour saisir des '''encaissements de particuliers''' (B2C=Business To Consumer) ou en mode mixte, à savoir encaissement aussi bien de particuliers (B2C) et d'entreprises (B2B), quelque soit le ratio entre les 2, quelque soit les modes de paiement utilisés (sauf à ne faire que du paiement direct par l'intermédiation d'un organisme bancaire européen). Donc:
** si vous n'encaissez pas d'argent, vous n'êtes PAS concerné.
** si vous êtes une association/organisme non assujettie à la TVA (association, médecin, ...), vous n'êtes PAS concerné.
** si vous êtes un professionnel bénéficiant du régime de remboursement forfaitaire de TVA agricole, vous n'êtes PAS concerné.
** si vous êtes un auto-entrepreneur, vous n'êtes PAS concerné (car assujettie en franchise en base).
** si vous êtes une entreprise dont l'intégralité des encaissements est réalisée avec l'intermédiation directe d’un établissement de crédit (système de paiement VAD d'une banque ou Virements), vous n'êtes PAS concerné. Remarque: Des encaissements par Carte bancaire via Paypal ou via Stripe ne sont pas des encaissements avec intermédiation directe d’un établissement de crédit, car ni Paypal ni Stripe ne sont des établissements de crédit (comprendre Banque).
** si vous ne facturez QUE des entreprises/professionnels, dans ce cas, vous n'êtes PAS concerné non plus par la loi finance (non B2C). Remarque: Si vous facturez des professionnels la plupart du temps et, exceptionnellement de temps en temps des particuliers via un mode de paiement non assuré par un organisme de crédit européen, si vous pouvez gérer/suivre ces facturations de particuliers à part sur papier, vous sortez alors du champ et n'êtes pas concerné.

Si vous n'êtes dans aucun des cas d'exception précédent, vous êtes concernés si vous utilisez le module Facture pour enregistrer vos paiements et/ou le module POS. Il vous faut alors vous assurer que le module "Log inaltérable" ("BlockedLog") fourni avec la v7 est bien activé. Sa désactivation, une fois les premières saisies faites ne sera ensuite plus envisageable. Avec la migration en v7 et l'activation de ce module vous aurez alors une version conforme sur le plan technique et fonctionnel. Il vous faudra ensuite, obtenir une attestation de conformité auprès d'un tiers qui confirme cette conformité technique/fonctionnelle pour être conforme d'un point de vue juridique.

Si vous utilisez une version en ligne Saas/Cloud fournie par un tiers, ce dernier vous la fournira surement (exemple: https://www.dolicloud.com ou https://www.novafirstcloud.com). Dans le cas contraire, il vous faut contactez votre intégrateur ou un prestataire pouvant fournir cette d'attestation.

Remarque: cette contrainte sera identique quelque soit l'ERP choisi. L'utilisation d'outils non spécialisés comme un tableur Excel ou autre, DANS LE BUT D'AVOIR UNE CONSERVATION DE TRACE DES PAIEMENTS, ne devient plus permis car le logiciel n'étant pas conforme, vous ne réussirez pas à trouver un prestataire pour fournir l'attestation de conformité. Par contre, si l'utilisation que vous faites d'Excel ou autre tableur est à des fins juste de "génération du PDF de la facture" sans ''conservation des données'' (Le texte de loi parle alors de logiciel ''facturier''), vous pouvez continuer à l'utiliser ainsi. Dans le cas ou l'utilisation est faite pour conserver trace de vos paiements, et si vous êtes dans le périmètre de la loi, un logiciel '''certifié ou attestable''' sur la partie encaissement (comme l'est Dolibarr) devient obligatoire.

'''Je suis concerné, mais à partir de quand ?'''
* Si vous êtes concerné, la loi s'applique au 1er janvier 2018. Toutefois, le texte de loi clarifié datant de juillet 2018, si on ajoute le temps requis par les logiciels pour s'adapter à la version définitive, puis le temps de migration sur la nouvelle version, une tolérance est de mise la première année (donc 2018), à condition de montrer que vous suivez le sujet et avez attendu pour avoir le texte définitif puis pour avoir la version conforme puis pour avoir le bon moment de faire votre migration. Si vous utilisez Dolibarr, les différentes évolutions de cette page montre que la démarche est engagée sur le logiciel depuis novembre 2016 et ce alors que le périmètre de la loi était encore contradictoire début novembre 2017.

A la question posée en janvier 2018 au ministère des finances: "Que pouvons nous dire aux utilisateurs qui sont en attente de texte/règle clarifiée pour agir, sachant que la loi est sensé être déjà effective ?", la réponse donnée a été que la première année (2018 donc), il y aurait tolérance, dès lors que vous montrez que vous avez pris une trajectoire sur 2018 pour bien faire. Cette année transitoire ayant été officiellement annoncée par le secrétaire d'état, dont voici les propos:

''« Je veux toutefois rassurer les entreprises : la direction générale des finances publiques les accompagnera pendant la première année d’application de ce dispositif, en vertu non pas d’une culture de la sanction ou du contrôle fondée sur le présupposé d’une malveillance des entreprises, mais d’un rôle de conseil. La DGFIP tiendra notamment compte des démarches engagées et des diligences effectuées par les entreprises pour obtenir le certificat ou l’attestation. C’est dans cet esprit que nous travaillerons. Les deux organismes certificateurs prendront également leur part de cet effort de pédagogie, qui est normal. »''

'''La nécessité d'attestation ou certification disparaît-elle si on n'enregistre nos paiements que via un mode de règlement qui laisse déjà des traces, comme les chèques ou cartes ?'''

Au départ, le type de règlement n'avait aucun impact sur la loi. Tous les types de paiement (chèque, carte, liquide, virement, ...) rentrent dans le périmètre de la loi et aucun ne permet d'être hors du champs d'application. L'amendement suivant https://www.nosdeputes.fr/15/amendement/235/1325C a tenté de restreindre le périmètre à un certain mode de paiement, mais a été rejeté.

Ceci se comprend dans la mesure où, même un paiement par carte, peut se faire via un système comme Paypal ou Stripe, et que l'administration fiscale française a très peu de pouvoir de contrôle sur une société étrangère.
Toutefois, il existe des cas où l'administration fiscale a un pouvoir de contrôle, c'est pourquoi, dans la re-publication au BOFIP de la loi le 4 juillet 2018, une exception a été introduite: Les professionnels réalisant leur paiement avec l'intermédiation directe d'un établissement de crédit européen ne sont plus soumis à l'obligation de certification ou attestation. Mais attention, on parle bien de paiements "directs" (donc Virement ou Carte de Débit ou de Crédit, mais pas chèques qui n'est pas "direct") et surtout via un système de paiement géré par un organisme bancaire européen. En d'autres terme, si on ne fait que du paiement CB avec un module de VAD d'une banque, on est NON soumis à la certification/attestation mais si le paiement CB (carte de crédit ou débit) se fait par un service comme Stripe ou Paypal, sauf à être exempté pour un autre motif, on l'est toujours (car l'état français n'a pas de moyen d'obtenir le listing des transactions via ces solutions, bien que le paiement soit par carte bancaire).

'''Quelles sont les conditions pour une application concernée pour être conforme (conditions pour obtenir la certification ou l'attestation de conformité) ?'''

* Principe d'inaltérabilité
** Logs non modifiable par chaînage pour tout ce qui concerne les ventes, encaissements et impression (incluant toutes les mentions obligatoires d'une facture)
** Quand une facture est validée, la trace et les informations qui ont donné lieu au contenu de la facture ne peuvent plus être modifier. Rem: Il est toujours possible de modifier mais la trace historique (log archivé) doit rester. Si un changement est fait, ce changement doit lui aussi être tracé et reprendre toutes les nouvelles informations et être lui aussi non effaçable.
** Liens de correspondance afin de vérifier différence entre les logs/archives et les tables de factures et paiements.

* Conservation sur 6 ans ou plus (Remarque: Dolibarr conserve les données en base à vie)

* Fonction "Archiver" annuellement qui permet d'exporter dans un fichier externe dans un format lisible sans le logiciel, et par l'administration, pour consulter l'archive (et retrouver les infos qui compose la facture, les paiements).

* Fournir, soit la certification de conformité du logiciel, soit une attestation de conformité (Voir dans les FAQ plus loin "Quel éditeur peut fournir des attestations pour ma version ?" sur comment l'obtenir)

!!! En d'autres termes, il ne sera plus possible d'utiliser des logiciels tableurs comme Excel ou Google Apps, ni autre solution développée soi même pour avoir une trace et conservation de vos paiements, sans considération de cette loi (sauf à continuer de saisir en parallèle soit dans un autre système conforme, soit sur le bon vieux carnet à souche). Mais vous pouvez continuer à utiliser votre tableur à des fins de logiciel pour générer vos Factures (la loi parle de "logiciel facturier") si il n'y a pas de conservation de données (le logiciel est alors considéré comme simple facturier et donc hors périmètre).
Pour un suivi et conservation de vos encaissements via un outils informatique, des logiciels, conforme loi finance 2016 comme Dolibarr ERP CRM v7 ou + deviennent alors obligatoires, dès lors que l'on est concerné (voir FAQ '''...suis-je concerné...''').

'''L'application Dolibarr sera-t-elle certifiée par l'éditeur ?'''

Pour Dolibarr, et de nombreux logiciels Open Source, il n'y a pas un éditeur bien identifié car de nombreuses sociétés différentes contribuent à son évolution.

Au sens de la loi, l'éditeur du logiciel est le '''"dernier" qui a modifié/validé le code'''. L'entité qui postule pour une certification peut donc être, aussi bien l'association Dolibarr, comme tout intégrateur ou autre institution externe.

Il est possible que l'association Dolibarr, qui a pour rôle la promotion du logiciel, fasse les démarches pour obtenir la certification pour certaines versions majeures, celles qui sont officiellement packagées par le release manager et qui sont mises à disposition sur l'espace de téléchargement officiel par l'association. Il est fort probable que seules quelques versions bien identifiées feront l'objet d'une demande de certification. Toutefois, cette obtention de certification n'est pas obligatoire pour être conforme. L'autre solution, celle de l'obtention d'une attestation s'avère plus simple.
Nous encourageons donc les utilisateurs qui ont obligation d'utiliser un logiciel conforme (donc les assujettis à TVA hors franchise de base, et qui facture/encaisse des particuliers) à '''se tourner vers la solution d'attestation'''. Voir point suivant.

'''L'attestation de conformité, autre possibilité, sera-t-elle fournie par l'éditeur ou autre tiers ?'''

L'autre solution pour être en règle est d'obtenir une attestation de conformité de votre logiciel de caisse.

En tant qu'utilisateur, et si vous êtes dans le périmètre de la loi, vous pourrez obtenir une attestation auprès de n'importe quel tiers/intégrateur prêt à la fournir (en général moyennant finance), ou vous la délivrer à vous même si vous êtes une société d'édition de logiciel. Voir les 2 FAQ suivantes pour savoir qui pourra délivrer les attestations de conformité...

'''Quel éditeur peut fournir des attestations pour ma version, à quel prix ?'''

N'importe quelle société qui a les compétences pour analyser le logiciel et vérifier que ses fonctionnalités sont bien en règle peut fournir une attestation à autrui. Le code d'une application libre étant ouvert, toute société compétente dans la technologie du produit, peut maîtriser le code aussi bien que les développeurs initiaux. Une telle société peut donc être qualifiée d'"éditeur", même si elle n'a pas produit ou très peu produit de code au projet final, et par conséquent, et à même de fournir un attestation individuelle à ses clients.

Le BOFIP dit clairement:

"310. Lorsque le logiciel ou système est conçu de manière ouverte pour permettre son adaptation aux besoins spécifiques des clients, on entend par « éditeur » qui peut valablement demander la certification ou fournir l'attestation individuelle."

Bref, si vous utilisez une version en ligne saas/cloud fournie par un tiers, ce dernier vous la fournira surement (Exemple avec https://www.dolicloud.com ou encore https://www.novafirstcloud.com). Dans le cas contraire, il vous faut contactez votre intégrateur ou un prestataire pouvant fournir cette d'attestation. Une liste de prestataires possibles, non exhaustive, sera ouverte courant 1er trimestre 2018.
Remarque: cette contrainte sera identique quelque soit l'outil d'enregistrements des encaissements choisi.

En ce qui concerne le prix, tout dépend du tiers qui fournit l'attestation. Certains, par exemple, pourront donner l'attestation gratuitement à condition d'héberger le logiciel attesté chez eux. D'autres vous feront payer la prestation d'audit et la délivrance de l'attestation. Cela peut être de manière récurrente si l'attestation doit être réémise régulièrement suite à modification/mise à jour de l'application.

'''La loi finance est-elle compatible avec les licences libres de logiciels de caisse ? '''

Si le logiciel libre n'est pas un logiciel qui réalise des encaissements ou si vous n'encaissez que des entreprises, la question ne pose même pas.

Si le logiciel libre est un logiciel d'encaissements et que les clients encaissés sont des particuliers, alors oui, le logiciel libre est parfaitement compatible:

Le paragraphe 40 du BOI le dit explicitement en reconnaissant aux utilisateurs la possibilité « ''d'adapter le logiciel à leurs besoins spécifiques'' » :

"''... Sont notamment concernés les logiciels de comptabilité ou de gestion dits "libres" ou développés en interne, c'est-à-dire développés par l'assujetti lui-même. On entend par logiciel libre un logiciel dont les utilisateurs ont un libre usage, une libre étude, une libre modification et une libre distribution. Ces libertés permettent aux utilisateurs d'adapter le logiciel à leurs besoins spécifiques. Les modifications que les utilisateurs peuvent apporter au logiciel libre ou développé en interne ne doivent pas avoir pour objet ou pour effet d'altérer le respect des conditions d'inaltérabilité, de sécurisation, de conservation et d'archivage décrites ci-dessous...''"

Par ailleurs, le paragraphe 310 évoque à nouveau le cas des logiciels « conçus de manière ouverte », c.à.d les logiciels libres.

Donc, aucune objection à utiliser des logiciels libres. Mais attention, l'autorisation de modification est restreinte au code et paramètres "triviaux". En effet, que ce soit lors d'une utilisation de la version certifiée ou d'une version rendue conforme par obtention d'une attestation de conformité, la nouvelle loi vous prive d'une partie de votre liberté de '''modifier le logiciel de caisse SUR LES PARTIES qui concernent les fonctions d'inaltérabilité, sécurisation, conservation et archivage'''. En effet, en faisant une telle modification, la version est considérée comme changée de manière "non triviale", aussi la certification n'est plus valable, l'attestation d'un tiers non plus. Les logiciels libres sont donc tout à fait légaux et compatible avec la loi, par contre, c'est à condition de ne pas faire n'importe quelle modification. Vous perdez donc une partie de votre liberté (non pas du fait de la licence du logiciel qui le permet, mais du fait de la loi qui est prioritaire sur les droits accordés par la licence. Le logiciel libre est donc bien compatible avec la loi, mais la loi vous prive d'une des 4 libertés que le logiciel libre apportait, celle de le modifier librement. Vous pouvez toujours le faire, mais à condition que cela ne porte pas sur le comportement de l'encaissement, ou, si cela porte sur celui-ci, que vous ré-obteniez soit la certification à nouveau (complexe et payant), soit une nouvelle attestation d'un éditeur ou intégrateur.

'''Pour ma propre utilisation, puis-je m'auto délivré l'attestation de conformité pour une version que j'ai modifié moi même sur les parties d'encaissements'''

Uniquement un nombre très restreints d'entreprise le pourront, celles qui sont dans le domaine de l''''Edition de logiciel de comptabilité ou de gestion ou de système de caisse'''. Toutefois, sur le plan juridique une telle classification n'existe que par les faits. En effet, on serait tenté de penser que les entreprises ayant le codes NACE (Code NACE = terme européen du code NAF/APE) '''58.29''' qui signifie '''Edition de logiciel autre''' et/ou '''62.01Z''' qui signifie '''Développement de logiciels''' pourrait être qualifiées. Toutefois, il faut avoir en tête que le code APE est "''attribué par l'INSEE à des fins statistiques, et ne saurait suffire à créer des droits ou des obligations pour les entreprises''" (Ceci est dans le décret qui approuve la nomenclature: décret n° 2007-1888 du 26 décembre 2007, article 5, point I). Dans la réalité, ce code est malgré tout utilisé pour avoir des présomptions d'activité au niveau fiscal ou administratif. Donc, c'est un avantage, mais aucunement une garantie et inversement, une entreprise n'ayant pas cette classification peut avoir des arguments suffisamment solide pour démontrer son activité d'"éditeur de logiciel de caisse".

'''Je suis intégrateur ou développeur informatique, je sais que Dolibarr v7 répond aux exigences de conformité, puis-je délivrer l'attestation de conformité, à mon client qui est en v7, moi même ?'''

Oui. A vous de fournir/indiquer à votre client la version/paramétrage que vous attestez. Vous pouvez générez la signature de la version et paramétrage que vous attestez avec l'outil '''generate_filelist_xml.php''' fourni avec les sources de l'application.
Cette signature vous permettra de vérifier que votre client n'a pas fait de '''modification de code ou paramétrage sur les parties qui concernent l'encaissement'''. Auquel cas, il devient éditeur, et votre attestation n'est plus valide, vous n'êtes alors plus responsable d'une apparition d'une fonctionnalité non conforme dans le logiciel.

'''Je suis intégrateur ou développeur informatique, quel outil ai-je à ma disposition pour m'assurer que les exigences sur le logiciel sont bien assurées par une version installée de Dolibarr'''

La version 7.0 contient l'ensemble des exigences et notamment le module "Log inaltérable" qu'il vous revient d'activer (l'obligation d'activation dépend du fait que vous êtes concerné ou non, voir FAQ précédente pour cela). L'application est une application Open Source, le client utilisateur peut réussir à modifier le code (notons que ceci est aussi possible avec du propriétaire, juste plus difficile). De même, un hacker peut toujours réussir à trafiquer un logiciel. Face à cela, Dolibarr fourni, à partir de la version 6.0, un outil pour obtenir la liste de tous les fichiers qui auraient été modifiés par rapport à la version officielle, ou par rapport à une version packagée par un intégrateur tiers, ainsi que la liste des paramètres de configuration obligatoires pour la conformité (voir plus bas) et qui aurait aussi été modifiés. Le certificat étant délivré pour une version avec une configuration donnée, si un utilisateur ou hacker a pu altérer partiellement l'application sur du code ou des paramètres sensibles, l'outil de contrôle pourra le révéler, auquel cas, la responsabilité de non conformité n'est plus du ressort de l'entité qui a fournit l'attestation, puisque ce n'est plus la même application, mais de la responsabilité de celui qui est à l'origine des modifications.

Paramètres recommandées à contrôler/imposer dans une attestation:

* Pays de la société (doit rester à France). Rem: Une fois le premier encaissement fait avec le module "Log inaltérable LF 2016", sa désactivation renverra un warning.
* Constante MAIN_MODULE_BLOCKEDLOG doit être définie (Cela signifie que le module "Log inaltérable LF 2016" est bien actif).
Optionnellement, vous pouvez:
* Imposer que la constante BLOCKEDLOG_DISABLE_NOT_ALLOWED_FOR_COUNTRY soit définie et contient le code pays FR (ceci bloque la désactivation du module par erreur).

Remarque:
Vous pouvez utiliser l'outil '''build/generate_filecheck_xml.php''' pour générer un fichier emprunte de la version et/ou paramétrage donné que vous voulez imposer.
Ensuite utilisez l'outil dans le menu '''Accueil - Outils administration - Dolibarr - Files integrity check''' ou bien à distance l'API '''/setup/checkintegrity''' (le module API REST doit avoir été activée) pour vérifier qu'une version est conforme à ce fichier emprunte.

'''Je suis dans le périmètre de la loi, j'ai ajouté un module externe sur mon Dolibarr, faut-il une attestation Loi Finance pour ce module ?'''

Il n'y a pas notion de "certificat ou d'attestation loi finance" sur un module:

En effet, ce qui doit être certifié ou attesté, c'est la partie du logiciel qui réalise les enregistrements des paiements, pris dans le contexte de l'ensemble du système d'information, et non chaque module de votre application individuellement. Le logiciel Dolibarr v7 ou + est attestable, donc, si vous êtes dans le périmètre de la loi, ce qu'il vous faut obtenir, c'est une attestation de conformité de l'ensemble de la solution, validant les modules ajoutés qui impactent l'enregistrement des paiements. Donc,
* Si vous êtes dans le périmètre de la loi et que le module ajouté ne concerne pas l'enregistrement des paiements, il n'y a rien de particulier à faire de plus (dès lors que vous êtes dans le périmètre de la loi, vous devez obtenir l'attestation pour les fonctions encaissements de paiements de votre Dolibarr, peu importe que vous ajoutiez ce module ou pas, le module n'ayant pas d'effet sur les fonctions d'encaissements, on perle d'effet trivial ou mineur au code).
* Si toutefois, vous êtes dans le périmètre de la loi et que le module touche à la partie encaissement, il faudra que le tiers fournissant l'attestation prenne en considération ce module (si vous aviez déjà obtenu l'attestation, il vous faudra la ré-obtenir car l'ajout du module l'invalide puisque ce module touche au code de la partie encaissement des paiements).

La nature du module doit vous permettre de savoir si c'est un module qui touche à l'enregistrement des encaissements ou pas. Dans le doute, renseignez vous auprès de l'auteur du module (ce n'est pas lui qui fournira l'attestation mais pourra dire si le module doit être pris en compte ou non dans le processus d'attestation).

= Travaux dans Dolibarr pour permettre la conformité via attestation =

Et Dolibarr dans tout cela ?
Dolibarr v7+ est prêt et attestable (si vous n'utilisez pas le module POS). Dolibarr v10+ est prêt et attestable même pour la fonction POS.
Voici le suivi des travaux réalisés depuis la v5: [[Loi article 88 finances 2016 et Certification NF525 - Travaux Dolibarr]]

= Autres ressources diverses sur le sujet =

* Synthèse détaillée du BOFIP par La Revue Fiduciaire, rédigé le 06/10/2016: [http://revuefiduciaire.grouperf.com/article/3661/hb/20160919173548859.html Article sur la revue fiduciaire]
* Synthèse courante par l'APRIL (document en évolution permanente): https://pad.april.org/p/logiciel-caisse-publication-BOI
* Article de l'APRIL: https://www.april.org/loi-de-finances-2016-une-doctrine-fiscale-qui-reconnait-les-logiciels-libres-mais-avec-une-marge-de
* Echanges sur les mailing-list de l'April: https://listes.april.org/wws/arc/comptabilite/ (réservé aux adhérents April)
* Note d'information très courte du service public: https://www.service-public.fr/professionnels-entreprises/actualites/A10279
* http://creativekara.fr/doku.php?id=pasteque:lf2016

User:Florian.mortgat

2020-01-15T09:53:36Z

Florian.mortgat: aide-mémoire sur l’attribut "visible"

==== Aide-mémoire sur la valeur de l’attribut 'visible' des champs d’objet et champs complémentaires ====
{| class="wikitable"
|+
!Valeur
!Affichage sur
!Exclu de
!Note
|-
|0
|
|toutes les pages
|
|-
|1
|liste, fiche (en affichage, création, modification)
|aucune page
|
|-
|2
|liste
|fiche (en affichage, création, modification)
|
|-
|3
|fiche (en affichage, création, modification)
|liste
|
|-
|4
|liste, fiche (en affichage, modification)
|fiche en création
|
|-
| -1
|fiche (en affichage, création, modification)
|liste (par défaut)
|L’utilisateur peut sélectionner le champ pour affichage sur liste
|-
| -2
|
|liste (par défaut), fiche (en affichage, création, modification)
|L’utilisateur peut sélectionner le champ pour affichage sur liste
|-
| -3
|??
|??
|
|-
| -4
|fiche (en affichage, modification)
|fiche en création
liste (par défaut)
|L’utilisateur peut sélectionner le champ pour affichage sur liste
|}

Créer un modèle de document PDF

2019-10-31T09:25:35Z

Florian.mortgat: /* Créer le nouveau modèle */

[[en:Create_a_PDF_document_template]]
[[es:Crear_un_modelo_de_documento_PDF]]
[[zh:创建PDF模板]]


{{TemplateDocDev}}
Ce document décrit comment créer son propre modèle de génération de document PDF afin de personnaliser ses documents (propales, factures, etc...)
Il se base sur les propositions commerciales comme exemple mais s'applique à tout type de document.

Pour savoir comment générer un modèle de document ODT, voir la page [[Créer un modèle de document ODT]].
Créer un modèle PDF requiert des connaissances en programmation PHP mais pas la création de modèles ODT.

=Prérequis=

*Dolibarr: 3.0+
*Connaissance en PHP

=Trouver le modèle existant le plus proche=
Dans Dolibarr, tester les modèles existants en allant dans la configuration du module puis en consultant l'aperçu en cliquant le picto "Aperçu" en fin de ligne du modèle. Consulter chacun des modèles disponibles.

Parmi ceux existant, noter le modèle le plus proche de vos besoins. Dans cet exemple, c'est le modèle azur (correspondant au fichier pdf_propale_azur.modules.php).

Pour info, tous les modèles sont dans '''htdocs/core/modules''' puis le sous-répertoire propale pour les propositions commerciales, facture pour les factures, commandes pour les commandes, etc... et enfin '''doc'''.
Par exemple, un modèle personnalisé de proposition sera dans '''...core/modules/propale/doc/'''

=Créer le nouveau modèle=
Par sécurité, on conservera les modèles d'origine. Pour l'exemple, on part du principe qu'on crée un nouveau module de proposition commerciale qu'on nommera 'masocietebleu' et qui s'inspire du module 'azur':

*Copier-coller pdf_propale_azur.modules.php
*Renommer la copie en pdf_propale_masocietebleu.modules.php
*L'éditer et faire les modifs suivantes dans le code:

#Renommer “''Class pdf_propale_azur {''” en “''Class pdf_propale_masocietebleu {''” (important : le nom de la classe et celui du fichier doivent correspondre)
#Pour les anciennes versions de dolibarr (dans les nouvelles __construct($db) n'a pas besoin d'être renommé,)Renommer 'Function pdf_propale_azur($db=0)' en 'Function pdf_propale_masocietebleu($db=0)'
#Renommer la variable $this->name pour refléter le nouveau nom. Par exemple pour le modèle 'azur', changer la ligne '$this->name = "azur";' en '$this->name = "masocietebleu";'.
#Sauvegarder : le modèle 'masocietebleu' est disponible dans la liste des modèles de propales de Dolibarr

*Tester ce modèle (Voir chapitre précédent) avant d'aller plus loin...
*Ajouter dans la table llx_document_model le nouveau modéle que vous venez de créer

=Personnaliser votre nouveau modèle=
Personnaliser le modèle créé.
Toujours dans pdf_propale_masocietebleu.modules.php, chercher la fonction 'Function _pagehead(&$pdf, $fac)'. C'est elle qui gère l'affichage de l'entête.

==Librairie de manipulation de PDF==
La librairie utilisée pour la création de documents en PDF se nomme TCPDF et peut être trouvée dans htdocs/includes/tcpdf/tcpdf.class.php. C'est également dans cette classe que l'on trouve les nombreuses méthodes utilisées pour générer les différents éléments des documents.

Les modèles eux-même instancient la classe FPDF et utilisent ensuite ses méthodes, combinées avec les données d'une facture, d'une commande ou d'autres types de données.

On retrouve généralement les appels suivants dans les scripts de création de documents:

*$pdf->SetFont() - ''Désigne la fonte à utiliser pour le texte qui suivra''
*$pdf->SetXY() - ''Désigne le point de départ pour dessiner le prochain texte en coordonnées X,Y qui sont exprimées en millimètres de la page''
*$pdf->MultiCell() - ''Dessine une boîte pouvant contenir du texte, et dont on doit d'abord donner la largeur et la hauteur - très utilisée''
*$pdf->GetY() - ''Renvoie la position courante en Y''
*$pdf->SetDrawColor() - ''Désigne la couleur à utiliser pour le prochain texte à écrire - généralement noir (0,0,0) ou blanc (255,255,255)''
*$pdf->Rect() - ''Dessine un rectangle dont le coin supérieur gauche est au point indiqué par les deux premiers paramètres et le coin inférieur droit utilise les deux derniers paramètres en mode relatif aux deux premiers''

==Structure des scripts==
Les scripts de génération des documents PDF, au moment du développement de la version 2.2, disposent des méthodes suivantes (prenant pour exemple le modèle "crabe") au sein de la classe du nom du modèle:

*pdf_crabe() - ''Constructeur de l'objet pdf''
*write_pdf_file() - ''Méthode générale pour la génération du fichier. Cette méthode appelle toute les suivantes après avoir initialisé quelques variables''
*_pagehead() - ''Méthode de dessin de l'en-tête du document, incluant généralement le logo, le titre du document (et la date) ainsi que les cadres de l'émetteur et du destinataire du document''
*_tableau() - ''Méthode de dessin du tableau de détails (produits, services, etc)''
*_tableau_info() - ''Méthode de dessin du tableau reprenant une liste d'informations sur la facture''
*_tableau_tot() - ''Méthode de dessin du tableau des totaux''
*_tableau_versement() - ''Méthode de dessin du tableau des règles de versement''
*_pagefoot() - ''Méthode de dessin du pied de page''

==Example de personnalisation==
===Insertion d'un logo===

*Ajouter l'instruction:

<source lang="php">
$pdf->Image('\www\htdocs\dolibarr\document\societe\logo.jpg', 10, 5, 60.00);
</source>
Avec dans l'exemple: 10=abscisse, 5=ordonnée, 60=largeur logo

*Si le logo se trouve par dessous ou dessus du text existant, supprimer le texte existant en commentant le code qui affiche l'information ou en modifiant sa position.

===Insertion d'une signature ou autre en bas de page facture===

*ouvrir le modèle à modifier crabe ou oursin (dans htdocs/core/modules/facture/)
*insérer (pour ma part ligne 618 juste avant // Show payment mode CHQ)

<source lang="php">
$pdf->Image('http://localhost/dolibarr/doc/images/signature.jpg',120,250,74);
</source>
l'image (largeur 74mm) est affichée colonne de droite juste avant le pied de page.

*copier l'image dans le répertoire. il semble qu'une image png avec transparence pose problème.
*générer le pdf, la signature apparaît.

===Insertion de texte===
Principales fonctions utilisées
<source lang="php">
$pdf->setX(float a); // fixe la position x courante
$pdf->setY(float b); // fixe la position y courante
$pdf->setXY(float a,float b); // fixe les positions x et y courantes
$pdf->SetTextColor(0,0,200); // fixe la couleur du texte
$pdf->SetFont('Arial','B',14); // fixe la police, le type ( 'B' pour gras, 'I' pour italique, '' pour normal,...)
$pdf->MultiCell(60, 8, 'Mon texte", 0, 'L'); // imprime 'Mon texte' avec saut de ligne
</source>
Rappel: l'origine des fonctions setXY est le coin supérieur gauche de la page

==Pour plus d'infos==

*http://www.fpdf.org/?lang=fr
*Liste des méthodes: tcpdf.org/doc/code/classTCPDF.html

=Activer son modèle dans Dolibarr=
Dans la fonction d'initialisation du module ajoutez votre modèle:

<source lang="php">
sql=array("INSERT INTO ".MAIN_DB_PREFIX."document_model (nom, type, entity) VALUES(".$MODELNAME.",".$MODEL_TARGET_MODULE.",".$conf->entity." )");
</source>

avant

<source lang="php"> return $this->_init($sql,$option);</source>

Puis

Dans Accueil => Configuration => Modules =>

*activer votre module qui doit apparaitre
*éventuellement le mettre en modèle proposé par défaut.

Objets métiers

2019-07-26T09:47:29Z

Florian.mortgat: /* Lien entre Objets métiers */ Exemple mis à jour pour les versions plus récentes de Dolibarr où load_object_linked est remplacé par fetchObjectLinked

[[en:Business_Objects]]
[[es:Objetos_de_negociado]]
[[zh:业务对象]]


{{TemplateDocDev}}

= Objets métiers =
Tous les objets métiers sont définis par une classe PHP qui hérite de la classe CommonObject (définie dans le fichier commonobject.class.php).

Pour trouver la classe qui correspond à l'objet métier qui vous interessent, parcourez l'arborescence de fichiers de Dolibarr à la recherche des fichier '''*/class/*.class.php'''. En effet, toutes les classes se trouvent dans un sous répertoire class d'un répertoire en rapport avec l'objet.
Par exemple:
* htdocs/societe/class/societe.class.php pour les tiers
* htdocs/compta/facture/class/facture.class.php pour les factures clients
* htdocs/fourn/class/fournisseur.facture.class.php pour les factures fournisseurs
...

Chaque classe métier possède les 4 méthodes CRUD à utiliser pour réaliser vos lectures ou mises à jours en base:
* Créer (C pour Create): Utiliser la méthode create()
* Lire (R pour Read): Utiliser la méthode fetch()
* Modifier (U pour Update): Utiliser la méthode update()
* Supprimer (D pour Delete): Utiliser la méthode delete()

Voir exemples plus bas...

= Lien entre Objets métiers =
Certains objets métiers sont liés les uns aux autres. Ceci est fait dans Dolibarr via la [[Table llx_element_element]]. Mais vous n'avez pas à lire cette table pour récupérer les objets liés à un autre.
Voici la portion de code qui montre comment faire cela:

Dolibarr 3.1 et versions ultérieures :
<source lang="php">
$commande = new Commande($db);
$commande->fetch($commande_id);

// on veut récupérer des factures à partir d’une commande dont on connaît l’ID
$result = $commande->fetchObjectLinked($commande->id, 'commande', null, 'facture');
if ($result <= 0) {
// erreur
}

// important : les tableaux créés sont associatifs : leurs clés sont des rowid de llx_element_element.

// FAUX (renverra NULL):
$facture_id = $commande->linkedObjectsIds['facture'][0]

// CORRECT:
$facture_id = array_values($commande->linkedObjectsIds['facture'])[0]

// MIEUX (permet de gérer le cas où il y aurait plus d’une facture) :
foreach ($commande->linkedObjectsIds['facture'] as $element_element_id => $facture_id) {
// ...
}
</source>

Avant Dolibarr 3.1 :
<source lang="php">
// This load the array linked_object with objects that link to this one
$object->load_object_linked($object->id, $object->element);
// To load array linked_object with objects that are linked by this one
$object->load_object_linked($object->id, $object->element);

// Then choose id with objects type you need
$org_order_array = $object->linked_object["commande"];

// Now use them
$thelinkedobjectid = $org_order_array[0];
// new order instance
$thelinkedobject = new Commande($object->db);
// load the object
$thelinkedobject->fetch($thelinkedobjectid);
</source>

= Exemples =
== Exemple pour la création d'un tiers ==

Voici un exemple pour la création d'un tiers (société client par exemple):

Si on est dans le cas d'un script nouveau ou externe à Dolibarr, il est nécessaire de faire au début de son code, avant toute chose

<source lang="php">
include('/pathofdolibarrhtdocs/master.inc.php');
</source>

pour que l'environnement Dolibarr (objets $conf, $db, $lang et $user) soit créé. Si on veut que les actions (creation, mise à jour), soit associées dans le suivi à un utilisateur particulier, il est nécessaire de faire après l'include du master.inc.php

<source lang="php">
$user->fetch(0,'loginuser');
</source>

Ensuite, on peut manipuler nos actions métiers.

<source lang="php">
// On declare la classe que l'on va manipuler
include_once('/pathofdolibarrhtdocs/societe/class/societe.class.php');

// On cree une instance de l'objet à manipuler
$mycompany = new Societe($db);

// On renseigne ces caractéristiques
$mycompany->nom='Big Brother';
$mycompany->client=1;

// Si on veut que l'action de création soit associé a un utilisateur 'loginuser' particulier,
// il faut decommenter cette ligne pour charger les caractéristiques de cet utilisateur.
// Si on laisse commenté, Dolibarr mettra null dans les champs du user de création ou mise à jour.
// $user->fetch('loginuser');

// On invoque la creation
$id=$mycompany->create($user);

// Pour relire l'objet
$mycompany->fetch($id);

// Pour le mettre à jour
$mycompany->nom='Big Brother 2'
$mycompany->update($user);
</source>

== Autres exemples ==
Vous trouverez d'autres exemples de manipulation d'objet Dolibarr (Création, Lecture, Modification, Suppression) dans le répertoire dev/samples du snapshot de Dolibarr.

Business Objects

2019-07-26T09:43:46Z

Florian.mortgat: /* Link between Business objects */ updated for Dolibarr 3.1 & higher

[[fr:Objets_métiers]]
[[es:Objetos_de_negociado]]
[[zh:业务对象]]


{{TemplateDocDevEn}}
= Business objects =
All business objects are defined by a PHP class that inherits the class CommonObject (defined in file commonobject.class.php).
Every business object has the 4 CRUD methods you can use to read or save into database:
* Create: create()
* Read: fetch()
* Update: update()
* Delete: delete()

See examples later...

= Link between Business objects =
Some business objects are linked to other business objects. This is done in Dolibarr using the [[Table llx_element_element]]. But you don't have to read this table to get objects linked to another.

Here is how you can use this (Dolibarr 3.1 and higher):
<source lang="php">
// get invoices from an already loaded order:
$result = $order->fetchObjectLinked($order->id, 'commande', null, 'facture');
if ($result <= 0) {
// handle error
}
// important notice : the newly populated arrays are associative. Keys are llx_element_element row ids.

// now if we expect only one linked invoice:

// WRONG way to get it ($invoice_id will be NULL):
$invoice_id = $order->linkedObjectsIds['facture'][0]

// CORRECT way ($invoice_id will hold the ID):
$invoice_id = array_values($order->linkedObjectsIds['facture'])[0]

// Better (if there are more than one linked invoices) :
foreach ($order->linkedObjectsIds['facture'] as $element_element_id => $facture_id) {
// process it
}
</source>

Prior to Dolibarr < 3.1:
<source lang="php">
// This load the array linked_object with objects that link to this one
$object->load_object_linked($object->id, $object->element);
// To load array linked_object with objects that are linked by this one
$object->load_object_linked($object->id, $object->element);

// Then choose id with objects type you need
$org_order_array = $object->linked_object["commande"];

// Now use them
$thelinkedobjectid = $org_order_array[0];
// new order instance
$thelinkedobject = new Commande($object->db);
// load the object
$thelinkedobject->fetch($thelinkedobjectid);
</source>

= Examples =

== Example for a third party ==
Here is an example for the creation of a third party (eg customer company):

If we make a new script or an external script, we must add at the beginning, before making anything else:
<source lang="php">
include('/pathofdolibarrhtdocs/master.inc.php');
</source>
This will initialize Dolibarr environment objects ($conf, $db, $lang and $user).
If we want that actions (create, update) are tagged with a particular user as the create/update user, we must do after the include of master.inc.php and before calling any create or update method
<source lang="php">
$user->fetch(0,'loginuser');
</source>

Now we can make our business code.

<source lang="php">
// We declare the class we want to use
include_once('/pathofdolibarrhtdocs/societe/class/societe.class.php');

// We create an instance of object to manipulate
$mycompany = new Societe($db);

// We set properties on object
$mycompany->nom='Big Brother';
$mycompany->client=1;

// If we want that creation is tagged as done by a particular user 'loginuser',
// you must uncomment this line to load all characteristics of this user.
// If we keep the comment, Dolibarr will use null into fields that should store the create or update user.
// $user->fetch('loginuser');

// We call method to create
$id=$mycompany->create($user);

// This is to read/load an already created object
$mycompany->fetch($id);

// To update object
$mycompany->nom='Big Brother 2';
$mycompany->update($user);
</source>

== Other examples ==
You may find other example for manipulating Dolibarr objects (Create, Read, Update, Delete) into directory '''dev/samples''' of Dolibarr snapshot.

Module Comptabilité en Partie Double

2019-07-24T08:37:47Z

Florian.mortgat: Coquille (expert -> export)

[[en:Module_Accounting_Advanced]]


[[Category:Compta]]
{{TemplateDocUtil}}
{{TemplateModFR}}
{{BasculeDevUser|
nom=Comptabilité Avancée|
num=50400|
devdoc=[[Module Comptabilité Avancée (développeur)]]|
userdoc=Cette page|}}

= Introduction =
Ce module offre des fonctions comptables plus évolués que le module comptabilité et permet de générer des écritures comptables.

= Installation =
{{NoInstallModuleFr}}

= Configuration =
{{ActivationModuleFr}}

= Cycle de vie / Règles de gestion =

L'utilisation du module de comptabilité se fait en plusieurs étapes:

Les actions suivantes sont habituellement exécutées une seule fois, ou une fois par an ...

Etape 1: Créer un modèle de plan de compte depuis le menu Compta/Tréso-Comptabilité-Configuration-Modèle de plan de compte

Etape 2: Créer ou vérifier le contenu de votre plan de compte depuis le menu Compta/Tréso-Comptabilité-Configuration-Plan comptable

Les prochaines étapes doivent être faites pour vous faire gagner du temps à l'avenir en vous proposant le bon compte comptable par défaut lors de la journalisation (écrire des enregistrements dans les journaux et Grand Livre)

Etape 3: Vérifier que la liaison par défaut entre les lignes de transactions diverses et le compte comptable est faite. Compléter les liaisons manquantes. Pour cela, vous pouvez utiliser l'entrée de menu Compta/Tréso-Comptabilité-Configuration-Comptes par défaut.

Etape 4: Vérifiez que la liaison entre le paiement de la TVA et le compte comptable est faite. Compléter les liaisons manquantes. Vous pouvez définir les comptes comptables à utiliser pour chaque taux de TVA sur la page Compta/Tréso-Comptabilité-Configuration-Compte TVA.

Etape 5: Vérifier que la liaison entre les dépenses spéciales (cotisations sociales ou fiscales) et le compte comptable est faite. Compléter les liaisons manquantes. Pour cela, vous pouvez utiliser l'entrée de menu Compta/Tréso-Comptabilité-Configuration-Comptes charges.

Etape 6: Vérifiez que la liaison entre le type de notes de frais et le compte comptable est faite. Compléter les liaisons manquantes. Vous pouvez définir les comptes comptables à utiliser pour chaque type de ligne de note de frais sur la page Compta/Tréso-Comptabilité-Configuration-Comptes notes de frais.

Etape 7: Vérifier que la liaison entre les paiements de prêts et les comptes comptables est faite. Compléter les liaisons manquantes. Pour cela, vous pouvez utiliser l'entrée de menu Compta/Tréso-Dépenses spéciales-Emprunts ou Compta/Tréso-Comptabilité-Configuration-Comptes par défaut.

Etape 8: Vérifier que la liaison entre les comptes bancaires et le compte comptable est faite. Compléter les liaisons manquantes. Pour cela, rendez-vous sur la fiche de chaque compte financier. Vous pouvez commencer à partir de la page Accueil-Banques/Caisses.

Etape 9: Vérifier que la liaison entre les produits/services et le compte comptable est faite. Compléter les liaisons manquantes. Pour cela, vous pouvez utiliser l'entrée de menu Compta/Tréso-Comptabilité-Configuration-Comptes produits.

Les actions suivantes sont habituellement exécutées chaque mois, semaine, ou jour pour les très grandes entreprises ...

Etape 1: Vérifier que la liaison entre les lignes de factures client existantes et le compte comptable est faite. Compléter les liaisons manquantes. Pour cela, vous pouvez utiliser l'entrée de menu Compta/Tréso-Comptabilité-Liaison factures client.

Etape 2: Vérifier que la liaison entre les lignes de factures fournisseurs existantes et le compte comptable est faite. Compléter les liaisons manquantes. Pour cela, vous pouvez utiliser l'entrée de menu Compta/Tréso-Comptabilité-Liaison factures fournisseur.

Etape 3: Vérifiez que la liaison entre le type de notes de frais et le compte comptable est faite. Compléter les liaisons manquantes. Vous pouvez définir les comptes comptables à utiliser pour chaque type de ligne de note de frais sur la page Compta/Tréso-Comptabilité-Liaison notes de frais.

Etape 4: Ecrire les transactions dans le Grand Livre. Pour cela, aller sur chaque Journal, et cliquer sur le bouton "Enregistrer les opérations dans le Grand Livre".

Etape 5: Ajouter ou modifier les opérations existantes et générer des rapports et des exportations.

= Plan comptable =

= Exports =

Voici un exemple des formats d'export disponibles. L'export se fait depuis le grand livre:

{{AccountingExpertExportExamples}}

Système de Hooks

2019-07-10T09:31:11Z

Florian.mortgat: spelling

{{TemplateDocDevFr}}

= Introduction =
Les Hooks sont une fonctionnalité pour les développeurs, disponible à partir de Dolibarr 3.2, leur permettant d'ajouter du code personnalisé aux pages standards de Dolibarr sans avoir à modifier les fichiers du coeur de Dolibarr. Contrairement aux [[triggers]] (autre manière d'interagir avec le code de Dolibarr) qui sont liés aux événements de Dolibarr, les Hooks peuvent s'exécuter n'importe ou et à n'importe quel moment dès lors qu'ils ont été prévu dans le core de Dolibarr. Ce sont des points d'insertion dans le programme.
* Les Hooks sont actifs ou pas selon un contexte (souvent un contexte par module : par exemple "productcard" pour les produits, "invoicecard" pour les factures...). Pour trouver les Hooks existants faites une recherche pour "'''initHooks('''"
* Les Hooks sont des fonctions qui s'insèrent dans ou remplacent le code standard. Pour rechercher le code qu'il est possible de surcharger faites une recherche pour "'''executeHooks('''".

= Ajouter un hook pour permettre l'insertion de code =
Pour implémenter un hook dans votre propre module (afin que votre module puisse être "hooké" par d'autres), vous devrez procéder à 2 étapes.

Ces étapes doivent êtres reproduites pour chaque script php de votre module où vous voulez implémenter des hooks.

1- Initialiser l'object HookManager (placez ce bout de code au début de votre script php, juste après ou avant les includes):

<source lang="php">
// Initialize technical object to manage hooks of thirdparties. Note that conf->hooks_modules contains array array
include_once(DOL_DOCUMENT_ROOT.'/core/class/hookmanager.class.php');
$hookmanager=new HookManager($db);
$hookmanager->initHooks(array('context'));
</source>

$hookmanager->initHooks() accepte 1 paramètre (un array de contextes) et active la prise en charge des hooks pour ce script:

- ''''context'''' est la chaine qui contient le contexte d'exécution. C'est un simple indicateur qui peut être utilisé par les fonctions de hook pour détecter dans quel cas elles sont appelées (plusieurs pages/modules peuvent appeler le même hook à différent endroit, et une fonction de hook peut ne vouloir s'exécuter que pour un contexte donné et pas les autres).

Note: Vous pouvez positionner plusieurs contextes en même temps (par exemple si vous avez besoin d'avoir un context commun à plusieurs pages mais que vous voulez aussi un context propre à une page donnée).

2- Placer ensuite l'appel des hooks la où permettre l'ajout de code:

<source lang="php">
$parameters=array();
$reshook=$hookmanager->executeHooks('hookname',$parameters,$object,$action); // See description below
// Note that $action and $object may have been modified by hook
if (empty($reshook))
{
... // standard code that can be disabled/replaced by hook if return code > 0.
}
</source>

'''$hookmanager->executeHooks()''' accepte 4 paramètres et ajoute un hook (qui est un point d'entrée dans votre script pour des fonctions externes à votre script et module):

- ''''hookname'''' est le nom de la méthode qui sera appelée. Par exemple: 'formObjectOptions'

- '''$parameters''' est un tableau personnalisé pour transmettre plus de données personnalisées au hook (la fonction dans le hook peut traiter ces données). Placez ici ce que vous voulez, ce peut être un fichier, un tableau de chaînes de caractères, n'importe quoi... Par exemple :
<source lang="php">
$parameters=array('file'=>'my/path/to/a/file', 'customnames'=>array('henry','david','john'));
</source>

- '''$object''' est l'objet que vous voulez passer à la fonction du hook, certainement les données du module courant (ex: l'objet facture si on est dans un module de facture, etc..). Ce peut être ce que vous voulez, mais souvenez vous qu'il sera le principal composant utilisé par les fonctions du hook.

- '''$action''' est une chaîne indiquant l'action courante (peut être null ou quelque chose qui ressemble à 'create' ou 'edit').

Note: Vous devrez refaire cette étape plusieurs fois si vous voulez ajouter plusieurs hooks à différent endroits de votre script.

Maintenant votre module devrait pouvoir être hooké, vous pouvez suivre la procédure ci-dessous dans '''Implémenter un hook''' pour implémenter une fonction hook qui en prendra avantage (permet aussi de tester que cela fonctionne).

= Implémenter un Hook =
Pour utiliser un Hook (donc ajouter ou surcharger une partie de code), vous devez d'abord avoir défini un descripteur de module (voir [[Développement_module#Créer_un_descripteur_de_Module_(obligatoire)]] pour cela). Ensuite vous devez suivre les étapes suivantes :

1. Ajouter votre module au contexte où le hook doit s'exécuter.
Ce qui veut dire que lorsqu'on se trouve dans le contexte donné, votre code sera appelé.
Pour cela, éditer le descripteur de votre module ('''/htdocs/''yourmodulename''/core/modules/mod''YourModuleName''.class.php''') et renseignez la variable '''$this->module_parts''' comme sur l'exemple :
<source lang="php">
$this->module_parts = array(
'hooks' => array('hookcontext1','hookcontext2') // Set here all hooks context you want to support
);
</source>

Note: il est possible de trouver le contexte d'un module en rajoutant
<source lang="php">
print('Module context: '.$object->context);
</source>
(rajoutez ce bout de code dans le fichier php où réside l'appel des hooks, et supprimez le, une fois la valeur du context relevée).

[[File:warning.png]] Attention: N'oubliez pas de désactiver puis de réactiver votre module dans l'interface d'administration des modules afin que la modification soit prise en compte car la sauvegarde des couples "modules-hooks" qui doit être gérée est faite en base, laquelle n'est mise à jour qu'au moment de l'activation du module.

2. Pour remplacer une fonction existante par la votre (surcharge)

Créez '''/htdocs/''yourmodulename''/class/actions_''yourmodulename''.class.php''' dans votre module avec un code qui contient la méthode appelée par le hook (le nom de cette méthode se voit au moment de l'appel executeHooks). Voici un exemple:

<source lang="php">
class ActionsYourModuleName
{
/**
* Overloading the doActions function : replacing the parent's function with the one below
*
* @param array() $parameters Hook metadatas (context, etc...)
* @param CommonObject &$object The object to process (an invoice if you are in invoice module, a propale in propale's module, etc...)
* @param string &$action Current action (if set). Generally create or edit or null
* @param HookManager $hookmanager Hook manager propagated to allow calling another hook
* @return int < 0 on error, 0 on success, 1 to replace standard code
*/
function doActions($parameters, &$object, &$action, $hookmanager)
{
$error = 0; // Error counter
$myvalue = 'test'; // A result value

print_r($parameters);
echo "action: " . $action;
print_r($object);

if (in_array('somecontext', explode(':', $parameters['context'])))
{
// do something only for the context 'somecontext'
}

if (! $error)
{
$this->results = array('myreturn' => $myvalue);
$this->resprints = 'A text to show';
return 0; // or return 1 to replace standard code
}
else
{
$this->errors[] = 'Error message';
return -1;
}
}
}
</source>

La méthode sera alors automatiquement appelée au moment de l'appel du code qui contient le executeHooks fournissant à votre code les éléments $parameters, $object et $action.

'''Avec''':
* '''$parameters''' est un tableau (array) de meta-data regroupant les données du hook (son contexte accessible par $parameters['context'] mais d'autres information peuvent etre disponible selon le cas)
* '''$object''' est l'objet sur lequel vous désirez travailler (par exemple : product pour le contexte productcard)
* '''$action''' désigne l'action à exécuter (par exemple "create", "edit" or "view").
* '''$hookmanager''' n'est propagé que pour permettre à votre hook d'appeler d'autres hooks.

'''Retours''':
* Le code retour d'un hook doit 0 ou 1 en cas de succès, négatif en cas d'erreur. En général, il sera 0. Il peut être 1, ce qui dans certains cas signifie que ce que fait votre hook remplace complètement ce que devait faire Dolibarr juste après l'appel du hook. Si le code est négatif, il est possible de fournir un message d'erreur à l'utilisateur en positionnant $this->errors[]='Message erreur'
* Si la méthode positionne la propriété $this->results avec un tableau, alors le tableau $hookmanager->resArray sera automatiquement enrichi avec le contenu de ce tableau, lequel pourra être réutilisé plus tard.
* Si la méthode positionne la propriété $this->resprints avec une chaîne, alors cette chaîne sera affiché par le gestionnaire de hook (executeHook), tout de suite à la sortie de votre méthode.
* Votre hook peut de plus modifier les valeurs de $object et $action.

= Liste des Hooks disponibles dans Dolibarr =
Trouver les hooks disponibles dans Dolibarr ?
Faites une recherche sur "'''executeHooks('''" dans le code source et vous trouverez facilement toutes les fonctions déjà implémentées.

En voici une liste (non complète):
{{ListOfHooks}}
...

Note: veuillez noter que cette liste s'enrichit à chaque version, donc si vous voulez vraiment savoir si un hook ou contexte spécifique existe, veuillez chercher directement dans le code source avec la méthode indiquée ci-dessus.

= Liste des Contexts disponibles dans Dolibarr =
Pour trouver les contextes disponibles dans Dolibarr, la procédure est similaire aux hooks.
Faites une recherche sur "'''initHooks('''" dans le code source et vous trouverez facilement tous les contextes déjà implémentées.

{| class="wikitable"
|-
! Context
! File / Fichier
|-
| accountancycustomerlist
| htdocs\accountancy\customer\list.php
|-
| accountancyindex
| htdocs\accountancy\index.php
|-
| accountancysupplierlist
| htdocs\accountancy\supplier\list.php
|-
| actioncard
| htdocs\comm\action\card.php
|-
| actiondao
| htdocs\comm\action\class\actioncomm.class.php
|-
| admin
| htdocs\accountancy\admin\accountmodel.php 
htdocs\accountancy\admin\categories_list.php 
htdocs\accountancy\admin\journals_list.php 
htdocs\admin\dict.php 
htdocs\admin\website_options.php
|-
| admincompany
| htdocs\admin\company.php
|-
| admindefaultvalues
| htdocs\admin\defaultvalues.php
|-
| adminldap
| htdocs\admin\ldap.php
|-
| adminmodules
| htdocs\admin\modules.php
|-
| admintranslation
| htdocs\admin\translation.php
|-
| agenda
| htdocs\comm\action\index.php
htdocs\comm\action\pertype.php
htdocs\comm\action\peruser.php
|-
| agendaexport
| htdocs\public\agenda\agendaexport.php
|-
| agendalist
| htdocs\comm\action\list.php
|-
| agendaresource
| htdocs\resource\agenda.php
|-
| agendathirdparty
| htdocs\societe\agenda.php
htdocs\product\agenda.php
|-
| assetcard
| htdocs\asset\card.php
|-
| assetdocument
| htdocs\asset\document.php
|-
| assetlist
| htdocs\asset\list.php
|-
| assetnote
| htdocs\asset\note.php
|-
| assettypecard
| htdocs\asset\type.php
|-
| bankaccountlist
| htdocs\compta\bank\list.php
|-
| bankcard
| htdocs\compta\bank\card.php
|-
| banktransactionlist
| htdocs\compta\bank\bankentries_list.php
|-
| banktreso
| htdocs\compta\bank\treso.php
|-
| bomagenda
| htdocs\bom\bom_agenda.php
|-
| bomcard
| htdocs\bom\bom_card.php
|-
| bomdao
| htdocs\bom\class\bom.class.php
|-
| bomdocument
| htdocs\bom\bom_document.php
|-
| bomlinedao
| htdocs\bom\class\bom.class.php
|-
| bomlist
| htdocs\bom\bom_list.php
|-
| bomnote
| htdocs\bom\bom_note.php
|-
| cashcontrol
| htdocs\compta\cashcontrol\cashcontrol_list.php
|-
| cashcontrolcard
| htdocs\compta\cashcontrol\cashcontrol_card.php
|-
| cashdeskloginpage
| htdocs\cashdesk\index.php
|-
| cashdeskTplTicket
| htdocs\cashdesk\validation_ticket.php
|-
| cashfencedao
| htdocs\compta\cashcontrol\class\cashcontrol.class.php
|-
| categorycard
| htdocs\categories\card.php 
htdocs\categories\edit.php 
htdocs\categories\viewcat.php
|-
| commandefournisseurdispatchdao
| htdocs\fourn\class\fournisseur.commande.dispatch.class.php
|-
| commonobject
| htdocs\core\class\html.form.class.php
|-
| comptafileslist
| htdocs\compta\compta-files.php
|-
| consumptioncontact
| htdocs\contact\consumption.php
|-
| consumptionthirdparty
| htdocs\societe\consumption.php
|-
| contactagenda
| htdocs\contact\agenda.php
|-
| contactcard
| htdocs\contact\card.php
|-
| contactdao
| htdocs\contact\class\contact.class.php
|-
| contactlist
| htdocs\contact\list.php
|-
| contactthirdparty
| htdocs\societe\societecontact.php
|-
| contacttpl
| htdocs\core\tpl\contacts.tpl.php
htdocs\projet\tasks\contact.php
|-
| contractcard
| htdocs\contrat\card.php htdocs\contrat\contact.php 
htdocs\contrat\document.php 
htdocs\contrat\info.php htdocs\contrat\note.php
|-
| contractlist
| htdocs\contrat\list.php
|-
| contractservicelist
| htdocs\contrat\services_list.php
|-
| cron
| htdocs\cron\class\cronjob.class.php
|-
| cronjoblist
| htdocs\cron\list.php
|-
| defineholidaylist
| htdocs\holiday\define_holiday.php
|-
| deliverycard
| htdocs\livraison\card.php
|-
| doncard
| htdocs\don\card.php
|-
| element_resource
| htdocs\resource\element_resource.php
|-
| emailcollectoractiondao
| htdocs\emailcollector\class\emailcollectoraction.class.php
|-
| emailcollectorcard
| htdocs\admin\emailcollector_card.php
|-
| emailcollectordao
| htdocs\emailcollector\class\emailcollector.class.php
|-
| emailcollectorfilterdao
| htdocs\emailcollector\class\emailcollectorfilter.class.php
|-
| emailcollectorlist
| htdocs\admin\emailcollector_list.php
|-
| emailingdao
| htdocs\comm\mailing\class\mailing.class.php
|-
| emailsenderprofilelist
| htdocs\admin\mails_senderprofile_list.php
|-
| emailtemplates
| htdocs\admin\mails_templates.php
|-
| expeditioncard
| htdocs\expedition\card.php
|-
| expensereportcard
| htdocs\expensereport\card.php
|-
| expensereportlist
| htdocs\expensereport\list.php
|-
| externalbalance
| htdocs\compta\localtax\clients.php 
htdocs\compta\localtax\index.php 
htdocs\compta\resultat\clientfourn.php 
htdocs\compta\resultat\index.php 
htdocs\compta\tva\clients.php 
htdocs\compta\tva\index.php 
htdocs\compta\tva\quadri_detail.php
|-
| fichinterdao
| htdocs\fichinter\class\fichinter.class.php
|-
| fileslib
| htdocs\core\lib\files.lib.php
|-
| formfile
| htdocs\core\class\html.formfile.class.php
|-
| formmail
| htdocs\core\class\html.formmail.class.php
|-
| globaladmin
| htdocs\admin\company.php 
htdocs\admin\defaultvalues.php 
htdocs\admin\ldap.php 
htdocs\admin\modules.php 
htdocs\admin\translation.php
|-
| globalcard
| htdocs\adherents\card.php 
htdocs\categories\viewcat.php 
htdocs\comm\action\card.php 
htdocs\asset\type.php 
htdocs\bom\bom_agenda.php 
htdocs\bom\bom_card.php 
htdocs\bom\bom_document.php 
htdocs\bom\bom_note.php 
htdocs\adherents\type.php 
htdocs\adherents\type_ldap.php 
htdocs\comm\propal\card.php 
htdocs\commande\card.php 
htdocs\compta\bank\card.php 
htdocs\compta\bank\treso.php 
htdocs\compta\bank\various_payment\card.php 
htdocs\compta\cashcontrol\cashcontrol_card.php 
htdocs\compta\deplacement\card.php 
htdocs\compta\facture\card.php 
htdocs\compta\facture\fiche-rec.php 
htdocs\compta\facture\invoicetemplate_list.php 
htdocs\compta\localtax\card.php 
htdocs\compta\paiement.php 
htdocs\compta\recap-compta.php 
htdocs\compta\salaries\card.php 
htdocs\compta\tva\card.php 
htdocs\contact\agenda.php 
htdocs\contact\card.php 
htdocs\contrat\card.php 
htdocs\contrat\contact.php 
htdocs\contrat\document.php 
htdocs\contrat\info.php 
htdocs\contrat\note.php 
htdocs\comm\card.php 
htdocs\comm\mailing\card.php 
htdocs\don\card.php 
htdocs\expedition\card.php 
htdocs\expensereport\card.php 
htdocs\fichinter\card.php 
htdocs\fourn\card.php 
htdocs\fourn\commande\card.php 
htdocs\fourn\facture\card.php 
htdocs\fourn\recap-fourn.php 
htdocs\livraison\card.php 
htdocs\loan\card.php 
htdocs\margin\tabs\thirdpartyMargins.php 
htdocs\modulebuilder\template\myobject_agenda.php 
htdocs\modulebuilder\template\myobject_card.php 
htdocs\modulebuilder\template\myobject_document.php 
htdocs\modulebuilder\template\myobject_note.php 
htdocs\product\card.php 
htdocs\product\fournisseurs.php 
htdocs\product\price.php 
htdocs\product\stock\card.php 
htdocs\product\stock\product.php 
htdocs\product\stock\productlot_card.php 
htdocs\projet\card.php 
htdocs\projet\comment.php 
htdocs\projet\contact.php 
htdocs\projet\tasks\comment.php 
htdocs\projet\tasks\task.php 
htdocs\projet\tasks\time.php 
htdocs\projet\tasks.php 
htdocs\reception\card.php 
htdocs\resource\card.php 
htdocs\societe\card.php 
htdocs\societe\contact.php 
htdocs\societe\document.php 
htdocs\societe\note.php 
htdocs\societe\notify\card.php 
htdocs\societe\paymentmodes.php 
htdocs\societe\price.php 
htdocs\societe\societecontact.php 
htdocs\stripe\payment.php 
htdocs\supplier_proposal\card.php 
htdocs\ticket\card.php 
htdocs\user\agenda_extsites.php 
htdocs\user\card.php 
htdocs\user\clicktodial.php 
htdocs\user\document.php 
htdocs\user\group\card.php 
htdocs\user\group\perms.php 
htdocs\user\ldap.php 
htdocs\user\note.php 
htdocs\user\param_ihm.php 
htdocs\user\perms.php
|-
| globallist
| htdocs\compta\compta-files.php
|-
| groupcard
| htdocs\user\group\card.php
|-
| groupdao
| htdocs\user\class\usergroup.class.php
|-
| groupperms
| htdocs\user\group\perms.php
|-
| holidaylist
| htdocs\holiday\list.php
|-
| homesetup
| htdocs\admin\index.php
|-
| idprofurl
| htdocs\societe\class\societe.class.php
|-
| index
| htdocs\index.php
|-
| interventioncard
| htdocs\fichinter\card.php
|-
| interventionlist
| htdocs\fichinter\list.php
|-
| intervnetiondao
| htdocs\fichinter\class\fichinter.class.php
|-
| inventorycard
| htdocs\product\inventory\card.php
|-
| inventorylist
| htdocs\product\inventory\list.php
|-
| invoicecard
| htdocs\compta\facture\card.php
|-
| invoicedao
| htdocs\compta\facture\class\facture.class.php
|-
| invoiceindex
| htdocs\compta\index.php
|-
| invoicelist
| htdocs\compta\facture\list.php
|-
| invoicereccard
| htdocs\compta\facture\fiche-rec.php
htdocs\compta\facture\invoicetemplate_list.php
|-
| invoicesuppliercard
| htdocs\fourn\facture\card.php
|-
| leavemovementlist
| htdocs\holiday\view_log.php
|-
| leftblock
| htdocs\main.inc.php
|-
| loancard
| htdocs\loan\card.php
|-
| localtaxvatcard
| htdocs\compta\localtax\card.php
|-
| login
| htdocs\main.inc.php
|-
| logout
| htdocs\user\logout.php
|-
| mail
| htdocs\core\class\CMailFile.class.php
|-
| mailingcard
| htdocs\comm\mailing\card.php
|-
| mailinglist
| htdocs\comm\mailing\list.php
|-
| main
| htdocs\core\lib\security.lib.php
htdocs\main.inc.php
|-
| mainloginpage
| htdocs\core\lib\security2.lib.php
|-
| membercard
| htdocs\adherents\card.php
|-
| memberlist
| htdocs\adherents\list.php
|-
| membertypecard
| htdocs\adherents\type.php
|
|-
| membertypeldapcard
| htdocs\adherents\type_ldap.php
|-
| movementlist
| htdocs\core\modules\stock\doc\pdf_stdmovement.modules.php
htdocs\product\stock\movement_card.php
htdocs\product\stock\movement_list.php
|-
| myobjectagenda
| htdocs\modulebuilder\template\myobject_agenda.php
|-
| myobjectcard
| htdocs\modulebuilder\template\myobject_card.php
|-
| myobjectdao
| htdocs\comm\mailing\class\mailing.class.php 
htdocs\modulebuilder\template\class\myobject.class.php 
htdocs\compta\bank\class\paymentvarious.class.php 
htdocs\compta\cashcontrol\class\cashcontrol.class.php 
htdocs\compta\salaries\class\paymentsalary.class.php 
htdocs\emailcollector\class\emailcollector.class.php
|-
| myobjectdocument
| htdocs\modulebuilder\template\myobject_document.php
|-
| myobjectlist
| htdocs\modulebuilder\template\myobject_list.php
|-
| myobjectnote
| htdocs\modulebuilder\template\myobject_note.php
|-
| notification
| htdocs\core\class\notify.class.php
|-
| odtgeneration
| htdocs\core\modules\user\doc\doc_generic_user_odt.modules.php 
htdocs\core\modules\usergroup\doc\doc_generic_usergroup_odt.modules.php 
htdocs\core\modules\supplier_proposal\doc\doc_generic_supplier_proposal_odt.modules.php 
htdocs\core\modules\societe\doc\doc_generic_odt.modules.php 
htdocs\core\modules\stock\doc\doc_generic_stock_odt.modules.php 
htdocs\core\modules\facture\doc\doc_generic_invoice_odt.modules.php 
htdocs\core\modules\product\doc\doc_generic_product_odt.modules.php 
htdocs\core\modules\project\doc\doc_generic_project_odt.modules.php 
htdocs\core\modules\propale\doc\doc_generic_proposal_odt.modules.php 
htdocs\core\modules\reception\doc\doc_generic_reception_odt.modules.php 
htdocs\core\modules\commande\doc\doc_generic_order_odt.modules.php 
htdocs\core\modules\contract\doc\doc_generic_contract_odt.modules.php 
htdocs\core\modules\expedition\doc\doc_generic_shipment_odt.modules.php
|-
| ordercard
| htdocs\commande\card.php
|-
| orderdao
| htdocs\commande\class\commande.class.php
|-
| orderlist
| htdocs\commande\list.php 
htdocs\don\list.php
|-
| ordershipmentcard
| htdocs\expedition\shipment.php
|-
| orderstoinvoice
| htdocs\commande\orderstoinvoice.php
|-
| orderstoinvoicesupplier
| htdocs\fourn\commande\orderstoinvoice.php
|-
| ordersuppliercard
| htdocs\fourn\commande\card.php
|-
| ordersupplierdispatch
| htdocs\fourn\commande\dispatch.php
|-
| paiementcard
| htdocs\stripe\payment.php 
htdocs\compta\paiement.php
|-
| passwordforgottenpage
| htdocs\user\passwordforgotten.php
|-
| paymentlist
| htdocs\compta\paiement\list.php
|-
| paymentsupplierlist
| htdocs\fourn\facture\paiement.php
|-
| pdfgeneration
| htdocs\core\modules\action\rapport.pdf.php 
htdocs\core\modules\bank\doc\pdf_ban.modules.php 
htdocs\core\modules\bank\doc\pdf_sepamandate.modules.php 
htdocs\core\modules\cheque\doc\pdf_blochet.class.php 
htdocs\core\modules\commande\doc\pdf_einstein.modules.php 
htdocs\core\modules\commande\doc\pdf_eratosthene.modules.php 
htdocs\core\modules\contract\doc\pdf_strato.modules.php 
htdocs\core\modules\expedition\doc\pdf_espadon.modules.php 
htdocs\core\modules\expedition\doc\pdf_merou.modules.php 
htdocs\core\modules\expedition\doc\pdf_rouget.modules.php 
htdocs\core\modules\expensereport\doc\pdf_standard.modules.php 
htdocs\core\modules\facture\doc\pdf_crabe.modules.php 
htdocs\core\modules\facture\doc\pdf_sponge.modules.php 
htdocs\core\modules\fichinter\doc\pdf_soleil.modules.php 
htdocs\core\modules\livraison\doc\pdf_typhon.modules.php 
htdocs\core\modules\product\doc\pdf_standard.modules.php 
htdocs\core\modules\project\doc\pdf_baleine.modules.php 
htdocs\core\modules\project\doc\pdf_beluga.modules.php 
htdocs\core\modules\project\doc\pdf_timespent.modules.php 
htdocs\core\modules\propale\doc\pdf_azur.modules.php 
htdocs\core\modules\propale\doc\pdf_cyan.modules.php 
htdocs\core\modules\rapport\pdf_paiement.class.php 
htdocs\core\modules\reception\doc\pdf_squille.modules.php 
htdocs\core\modules\stock\doc\pdf_standard.modules.php 
htdocs\core\modules\stock\doc\pdf_stdmovement.modules.php 
htdocs\core\modules\supplier_invoice\pdf\pdf_canelle.modules.php 
htdocs\core\modules\supplier_order\pdf\pdf_cornas.modules.php 
htdocs\core\modules\supplier_order\pdf\pdf_muscadet.modules.php 
htdocs\core\modules\supplier_payment\doc\pdf_standard.modules.php 
htdocs\core\modules\supplier_proposal\doc\pdf_aurore.modules.php
|-
| pricesuppliercard
| htdocs\product\fournisseurs.php
|-
| product_lotlist
| htdocs\product\stock\productlot_list.php
|-
| productcard
| htdocs\product\card.php
|-
| productdao
| htdocs\product\class\product.class.php
|-
| productdocuments
| htdocs\product\document.php
|-
| productindex
| htdocs\product\index.php
|-
| productlotcard
| htdocs\product\stock\productlot_card.php
|-
| productlotdocuments
| htdocs\product\stock\productlot_document.php
|-
| productpricecard
| htdocs\product\price.php
|-
| productservicelist
| htdocs\product\list.php
|-
| productstatscontract
| htdocs\product\stats\contrat.php
|-
| productstatsinvoice
| htdocs\product\stats\facture.php
|-
| productstatsorder
| htdocs\product\stats\commande.php
|-
| productstatspropal
| htdocs\product\stats\propal.php
htdocs\product\stats\supplier_proposal.php
|-
| productstatssupplyinvoice
| htdocs\product\stats\facture_fournisseur.php
|-
| productstatssupplyorder
| htdocs\product\stats\commande_fournisseur.php
|-
| projectcard
| htdocs\projet\card.php
htdocs\projet\comment.php
|-
| projectcontactcard
| htdocs\projet\contact.php
|-
| projectdao
| htdocs\projet\class\project.class.php
|-
| projectlist
| htdocs\projet\list.php
|-
| projectOverview
| htdocs\projet\element.php
|-
| projecttaskcard
| htdocs\projet\tasks\task.php
|-
| projecttaskcommentcard
| htdocs\projet\tasks\comment.php
|-
| projecttaskscard
| htdocs\projet\tasks.php
|-
| projecttasktime
| htdocs\projet\tasks\time.php
|-
| projectthirdparty
| htdocs\societe\project.php
|-
| projectticket
| htdocs\ticket\list.php
|-
| propalcard
| htdocs\comm\propal\card.php
|-
| propallist
| htdocs\comm\propal\list.php
|
|-
| purchasesjournal
| htdocs\accountancy\journal\purchasesjournal.php
|-
| recapcomptacard
| htdocs\compta\recap-compta.php
|-
| receptioncard
| htdocs\reception\card.php
|-
| receptiondao
| htdocs\reception\card.php
htdocs\reception\class\reception.class.php
|-
| receptionlist
| htdocs\reception\list.php
|-
| resource
| htdocs\resource\card.php
|-
| resource_card
| htdocs\resource\card.php
|-
| resourcelist
| htdocs\resource\list.php
|-
| salarycard
| htdocs\compta\salaries\card.php
|-
| salarypayment
| htdocs\compta\salaries\class\paymentsalary.class.php
|-
| searchform
| htdocs\core\ajax\selectsearchbox.php 
htdocs\core\search_page.php 
htdocs\main.inc.php
|-
| sellsjournal
| htdocs\accountancy\journal\sellsjournal.php
|-
| shipmentlist
| htdocs\expedition\list.php
|-
| stockproductcard
| htdocs\product\stock\product.php
|-
| stockreplenishlist
| htdocs\product\stock\replenish.php
|-
| subscription
| htdocs\adherents\subscription.php
|-
| subscriptionlist
| htdocs\adherents\subscription\list.php
|-
| supplier_proposalcard
| htdocs\supplier_proposal\card.php
|-
| supplier_proposallist
| htdocs\supplier_proposal\list.php
|-
| supplierbalencelist
| htdocs\compta\recap-compta.php
htdocs\fourn\recap-fourn.php
|-
| suppliercard
| htdocs\fourn\card.php
|-
| supplierinvoicelist
| htdocs\fourn\facture\list.php
|-
| supplierorderlist
| htdocs\fourn\commande\list.php
|-
| supplierpricelist
| htdocs\fourn\product\list.php
|-
| surveylist
| htdocs\opensurvey\list.php
|-
| takeposfrontend
| htdocs\takepos\takepos.php
|-
| tasklist
| htdocs\projet\tasks\list.php
|-
| tasktimelist
| htdocs\projet\tasks\time.php
|-
| taxvatcard
| htdocs\compta\tva\card.php
|-
| thirdpartybancard
| htdocs\societe\paymentmodes.php
|-
| thirdpartycard
| htdocs\core\tpl\advtarget.tpl.php
htdocs\societe\card.php
|-
| thirdpartycomm
| htdocs\comm\card.php
|-
| thirdpartycontact
| htdocs\societe\contact.php
|-
| thirdpartycustomerprice
| htdocs\societe\price.php
|-
| thirdpartydao
| htdocs\societe\class\societe.class.php
|-
| thirdpartydocument
| htdocs\societe\document.php
|-
| thirdpartylist
| htdocs\societe\list.php
|-
| thirdpartymargins
| htdocs\margin\tabs\thirdpartyMargins.php
|-
| thirdpartynote
| htdocs\societe\note.php
|-
| thirdpartynotification
| htdocs\societe\notify\card.php
|-
| thirdpartyticket
| htdocs\ticket\list.php
|-
| ticketcard
| htdocs\ticket\card.php
|-
| ticketlist
| htdocs\ticket\list.php
|-
| timesheetperdaycard
| htdocs\projet\activity\perday.php
|-
| timesheetperweekcard
| htdocs\projet\activity\perweek.php
|-
| toprightmenu
| htdocs\main.inc.php
|-
| tripsandexpensescard
| htdocs\compta\deplacement\card.php
|-
| upgrade
| htdocs\install\upgrade2.php
|-
| useragenda
| htdocs\user\agenda_extsites.php
|-
| usercard
| htdocs\user\agenda_extsites.php 
htdocs\user\card.php 
htdocs\user\clicktodial.php 
htdocs\user\document.php 
htdocs\user\ldap.php 
htdocs\user\note.php 
htdocs\user\param_ihm.php 
htdocs\user\perms.php
|-
| userdao
| htdocs\user\class\user.class.php
|-
| userdoc
| htdocs\user\document.php
|-
| userhome
| htdocs\user\home.php
|-
| userihm
| htdocs\user\param_ihm.php
|-
| userldap
| htdocs\user\ldap.php
|-
| userlist
| htdocs\user\list.php
|-
| usernote
| htdocs\user\note.php
|-
| userperms
| htdocs\user\perms.php
|-
| variouscard
| htdocs\compta\bank\various_payment\card.php
|-
| variouspayment
| htdocs\compta\bank\class\paymentvarious.class.php
|-
| warehousecard
| htdocs\product\stock\card.php
|-
| website
| htdocs\admin\website.php
|-
| websiteaccountcard
| htdocs\website\websiteaccount_card.php
|-
| websitethirdpartylist
| htdocs\societe\website.php
|}

Note: veuillez noter que cette liste s'enrichie à chaque version, donc si vous voulez vraiment savoir si un hook ou contexte spécifique existe, veuillez chercher directement dans le code source avec la méthode indiquée ci-dessus.

= Voir aussi =
* [[Triggers]]
* [[Interfaces Dolibarr toward foreign systems]]
* [[Interfaces from foreign systems toward Dolibarr]]

Système de Triggers

2019-06-06T12:36:27Z

Florian.mortgat: typo

{{TemplateDocDevFr}}

= Ajouter son code sur un événement Dolibarr =

Pour permettre de déclencher du code personnalisé en réaction à un évènement Dolibarr (création/modification/suppression d'une société/facture/produit/utilisateur ou autre), Dolibarr propose un mécanisme de triggers métiers. Ce mécanisme vous permet de personnaliser un workflow afin que les évènements de gestion Dolibarr soient répercutés dans une autre application par exemple.
Rien n'empêche également de l'utiliser pour modifier le comportement de Dolibarr même: par exemple, pour que la validation d'une facture provoque la création d'un contrat automatiquement.

Donc, pour ajouter son propre code qui sera déclenché par trigger, la procédure est la suivante:

1) Copier le fichier '''htdocs/core/triggers/interface_90_all_Demo.class.php-NORUN''' sous le nom:
* '''interface_99_all_''Xxx''.class.php'''
ou bien
* '''interface_99_mod''MonModule_Xxx''.class.php'''
où ''Xxx'' est une chaine de votre choix commençant par une majuscule, ''99'' est le numéro de priorité du trigger (''01'' étant le plus prioritaire), ''MonModule'' est le nom du module si votre trigger ne doit être activé que si le module MonModule est actif. Si on désire que le trigger soit toujours actif, on mettra ''all'' à la place de modMonModule.
Il faut laisser ce nouveau fichier dans le même répertoire.
Rem: Les valeurs utilisables pour modMonModule sont visibles dans le répertoire
''htdocs/core/modules''.
'''ATTENTION''': '''Tous''' ces paramètres sont nécessaires pour que le trigger soit détecté! Ex: si vous oubliez le numéro de priorité, le module ne sera pas detecté!

Par exemple, on pourra nommer notre nouveau trigger:
''htdocs/core/triggers/interface_99_modFacture_Monworkflow.class.php''

En créant un fichier nommé comme dans cet exemple, notre nouveau trigger sera déclenché à chaque évènement métier Dolibarr et à condition que le module Facture soit actif.

'''Note''': Avec Dolibarr 3.2+, il est aussi possible de placer les fichiers triggers dans un sous-dossier de module. Ex: si le module réside dans htdocs/mymodule/, alors il est possible de placer les triggers dans htdocs/mymodule/core/triggers/.
Mais dans ce cas, le trigger ne sera trouvé que si vous le déclarer dans le fichier descripteur de votre module. Pour cela, ajouter ajouter triggers->1 dans le tableau module_parts (ex: '''/monmodule/core/modules/modMonModule.class.php'''):
<source lang="php">
// Defined all module parts (triggers, login, substitutions, menus, etc...) (0=disable,1=enable)
$this->module_parts = array('triggers' => 1);
//$this->module_parts = array('triggers' => 1,
// 'login' => 0,
// 'substitutions' => 0,
// 'menus' => 0);
</source>
Puis désactiver et réactiver le module. Ceci aura pour effet d'ajouter une ligne dans la [[Table llx_const]] pour indiquer à Dolibarr qu'il faut recherch un trigger dans le répertoire de votre module '''htdocs/monmodule/core/triggers'''.

2) Editer ce fichier ''interface_99_modMonModule_Monworkflow.class.php'' afin de renommer la classe ''InterfaceDemo'' par ''InterfaceMonworkflow''

Ensuite, accéder à la page Accueil-> Infos Systèmes -> Dolibarr -> Triggers.
Votre fichier trigger doit apparaitre dans la liste sans erreur indiquant que les opérations précédentes ont été réalisées avec succès.

3) Revenez maintenant à l'édition du fichier trigger afin d'ajouter votre code dans la fonction ''run_trigger''.
Cette fonction est appelée à chaque évènement Dolibarr. Placer votre code en fonction du ou des évènements sur lesquels vous voulez réagir, chaque évènement étant identifié par un code (voir chapitres suivant pour la liste des codes), on peut réagir ou non à un évènement donné par un test sur la variable '''$action''':

<source lang="php">
public function runtrigger($action,$object,$user,$langs,$conf)
{
// Mettre ici le code à exécuter en réaction de l'action
// Le type de l'évènement Dolibarr est stocké dans $action
// Les données de l'action sont stockées dans $object
// La configuration, utilisateur et langage sont dans $conf,$user et $lang
if ($action == 'COMPANY_CREATE')
{
dol_syslog("Trigger for action '$action' launched. id=".$object->id);
}
elseif ($action == 'COMPANY_MODIFY')
{
dol_syslog("Trigger for action '$action' launched. id=".$object->id);
}
elseif ($action == 'COMPANY_DELETE')
...
}
</source>

Vous pouvez faire ce que vous voulez dans cette portion de code du moment que la fonction runtrigger renvoie un code retour sur le principe suivant:

<0 si ko, 0 si aucune action faite, >0 si ok

Vous pouvez de plus dans cette fonction utiliser les objets suivant:
* '''$object''' est l'objet sur lequel porte l'action (voir chapitre suivant)
* '''$user''' est l'objet de l'utilisateur Dolibarr qui réalise l'action
* '''$langs''' est l'objet qui contient la langue de l'utilisateur Dolibarr
* '''$conf''' est l'objet qui contient toute la configuration de Dolibarr.

4) Une fois le code réalisé, il n'y a plus qu'à tester, en provoquant l'évènement déclencheur dans Dolibarr. Attention, l'appel au '''runtrigger''' et encapsuler dans un transaction. Si votre trigger renvoie un code ko, la fonction appelante peut annuler la transaction (ceci dépend de la fonction appelante).
Ajouter des traces dans un fichier dans la fonction '''run_trigger''' afin de vous assurer que le code s'exécute bien. Vous pouvez pour cela si vous le désirer, utiliser la fonction
dol_syslog("mon texte de trace", LOG_DEBUG);

= Liste des événements gérés =
La liste de tous les événements qui provoquent un déclenchement de trigger est disponible dans la table [[Table llx c action trigger]]. Voici un vue rapide des événements identifiés par la valeur suivante au code '''$action''', avec le type de l'objet reçu dans '''$object'''.

En général, le code action de trigger est composé du:
* Nom du module (en majuscule)
* D'autres informations isolés par le caractère _
* L'action.

{{TemplateListOfTriggers}}

Liste non exhaustive.

= Gérer de nouveau évènements =

Pour gérer d'autre évènements que ceux ci-dessus, il faut modifier le code Dolibarr pour y ajouter la séquence suivante dans les méthodes métiers des classes utilisées pour gérer les évenements:

<source lang="php">
// Appel des triggers
include_once(DOL_DOCUMENT_ROOT . "/core/class/interfaces.class.php");
$interface=new Interfaces($this->db);
$result=$interface->run_triggers('XXXXX_YYYYY',$this,$user,$langs,$conf);
if ($result < 0) { $error++; $this->errors=$interface->errors; }
// Fin appel triggers
</source>

Ici, $this doit être l'objet de la classe métier qui contient toutes les informations à passer au trigger. Remplacer, de plus, le 'XXXXX_YYYYY' par un code évènement non déjà utilisé.
'''D'autre part, si l’exécution du trigger revient en erreur, vous devez annuler l'action correspondante.'''

'''A partir de la version 3.7, vous devez utiliser ce type de code :'''
<source lang="php">
// Call trigger
$result=$this->call_trigger('XXXXX_YYYYY',$user);
if ($result < 0) $error++;
// End call triggers
</source>

Il sera alors possible d'ajouter dans la méthode run_trigger, un if qui permet de gérer ce code. La méthode run_trigger serait alors de la forme :

<source lang="php">
function run_trigger($action,$object,$user,$lang,$conf)
{
// Mettre ici le code à exécuter en réaction de l'action
// Le type de l'évènement Dolibarr est stocké dans $action
// Les données de l'action sont stockées dans $object
// La configuration, utilisateur et langage sont dans $conf,$user et $lang
if ($action == 'XXXXX_YYYYY')
{
dol_syslog("Trigger for action '$action' launched. id=".$object->id);
}
elseif ($action == 'COMPANY_CREATE')
{
dol_syslog("Trigger for action '$action' launched. id=".$object->id);
}
elseif ($action == 'COMPANY_MODIFY')
{
dol_syslog("Trigger for action '$action' launched. id=".$object->id);
}
elseif ($action == 'COMPANY_DELETE')
...
}
</source>

= Conclusion =
Vous pouvez donc en quelques minutes, ajouter une interface Dolibarr vers exterieur sans risque puisqu'on ne touche pas au code Dolibarr, on s'est contenté de placer un nouveau fichier trigger dans le répertoire des triggers.
Si cette interface peut être utile à d'autre, n'hésitez pas à la packager en tgz (voir la page [[Développement_module#Créer_un_package_pour_livrer_et_installer_votre_module]]) et de la soumettre dans l'espace des téléchargement-contributions sur le site de Dolibarr.

= Voir aussi =
* [[Système de Hooks]]
* [[Interfaces Dolibarr vers exterieur]]
* [[Interfaces Exterieur vers Dolibarr]]

Prerequisites

2019-05-29T07:31:35Z

Florian.mortgat: /* Disk storage */ wording

[[Category:Admin]]
[[Category:Admin_en]]
{{TemplateDocUser}}

Dolibarr was built to work on following components:

= OS (Operating Systems) =
Nearly every modern OS is supported.
* Clients: every OS, that can run a webbrowser
* Server: every os, that supports a webserver with PHP and a SQL Database (see below)

for example: GNU/Linux, BSD, Windows, MacOS, AIX, ...

'''Note for Windows 7 users:'''

When using Windows 7 the Visual C++ Redistributable for Visual Studio 2012 Update 4 must be already installed.
An error message during installation will indicate if this is missing.
'''Make sure you choose the 32-bit version (vcredist_x86.exe).'''
It can be obtained here:
* https://www.microsoft.com/en-us/download/details.aspx?id=30679

= Database =
* MySQL {{MySqlMinVersion}} (any MySQL options/parameters supported).
!! Do not use MySQL version 5.5.40 nor 5.5.41, this version has critical bugs with data loss.
If using option mode=STRICT returns some warnings or error, please report them to us.
* MariaDB {{MySqlMinVersion}}
* PostgreSQL {{PostgresMinVersion}}

* MS SQL (experimental support not working yet)

* Database size need is lower than '''1Mb per 100''' customers/suppliers registered into database.

= PHP =
* Min. required version: {{PHPMinVersion}}, Max {{PHPMaxVersion}}
* Support for user sessions must be enabled (it is the default value for PHP)
* PHP configuration must allow use of {{PHPMinMemory}}Mb of memory (parameter PHP memory_limit).
* Works however magick_quotes parameter is set
* Works however register_globals parameter is set
* Works however safe_mode parameter is set

'''Oldest versions'''

'''Dolibarr 9.0.x'''
* min. required version: PHP 5.4+
* max version: PHP 7.3

'''Dolibarr 8.0.x'''
* min. required version: PHP 5.4+
* max version: PHP 7.2

'''Dolibarr 7.0.x'''
* min. required version: PHP 5.3+
* max version: PHP 7.2

= Disk storage =

* Dolibarr program files use about '''150 MByte''' on disk.
* Extra Modules or Templates need some additional disk space.
* Dolibarr Database Files use about '''35 MByte''' on disk.
* Database-System itself need also some disk-space and more space for temporary files.

However, it will need more disk space if you upload joined files or to store generated PDF or ODT documents. Storage will depend on number and size of attached files.

= CPU =
You can start even with an old Intel Pentium processor or equal.
If you have more than 30 users, a 1GHz CPU or more is recommended.

Champs personnalises

2019-05-24T07:34:21Z

Florian.mortgat: coquilles

{{TemplateDocDevFr}}
= Extrafields =

Extrafields permet d’ajouter d’autres données au schéma de base de données standard Dolibarr. Introduits dans la version 3.2, les extrafields sont maintenant implémentés dans la plupart des objets métier:
* Tiers et contacts
* Utilisateurs
* Événements
* Proposition
* Factures Clients
* Ordres
* Proposition du fournisseur
* Factures fournisseurs
* Commandes de fournisseurs
* Produits
* Membre & type de membre
* Projets et tâches du projet (depuis 3.4)
* Les catégories
* Rapport de dépenses

= Mise en œuvre technique =

Chaque objet a sa table dans la base de données pour stocker les valeurs de extrafields.

== Modèles de tables extrafield de Datatables ==

llx_''BaseTableNAme''_extrafields
rowid integer AUTO_INCREMENT PRIMARY KEY,
tms timestamp,
fk_object integer NOT NULL,
import_key varchar(14)

Un exemple de fichier de définition mysql pour l'implémentation extrafields sur un objet:

créer la table llx_place_room_extrafields
(
rowid integer AUTO_INCREMENT PRIMARY KEY,
tms timestamp,
fk_object integer NOT NULL,
import_key varchar(14) -- import key
) ENGINE=innodb;

== Classe de chargement des extrafields ==
Pour utiliser extrafields, toutes les pages doivent inclure
<source lang="php">
require_once DOL_DOCUMENT_ROOT.'/core/class/extrafields.class.php';
</source>

== Charger un tableau extrafield dans un objet ==
<source lang="php">
$extrafields = new ExtraFields($db);
$extralabels=$extrafields->fetch_name_optionals_label($object->table_element);
</source>

$ extralabels sera un tableau avec le code et l’étiquette des extrafields.
Ce code doit être placé dans la classe par exemple dans la fonction "write_file".

== Charger extrafield dans l'objet ==

Les extra-champs sont chargés dans le tableau $object->array_options.

<source lang="php">
$object->fetch($rowid);
$object->fetch_optionals($rowid,$extralabels);
</source>

Ce code doit être placé juste après ce qui précède.

== Afficher la valeur extrafield en PDF ou HTML ==
Après chargement extrafields

Exemple HTML
<source lang="php">
print $object->array_options ['options_XXX'];
</source>
Où XXX est le code des extrafields

Exemple PDF
<source lang="php">
$pdf->MultiCell (0,5, $outputlangs->convToOutputCharset($object->array_options ['options_XXX']),0,'L'); )
</source>
Où XXX est le code des extrafields

== Afficher la valeur supplémentaire des lignes en PDF ou HTML ==
Après chargement extrafields

Exemple HTML
<source lang="php">
print $object->lines[$i]->array_options['options_XXX'];
</source>
Où XXX est le code des extrafields

Exemple PDF
<source lang="php">
$pdf->MultiCell (0,5, $outputlangs->convToOutputCharset($object->lines[$i]->array_options['options_XXX']),0,'L');
</source>
Où XXX est le code des extrafields

== Avant l'appel $object->create() ou $object->update() ==

Les valeurs des extrafields envoyées par formulaire doivent être récupérées. Pour ce faire, utilisez cette méthode:
<source lang="php">
$ret = $extrafields->setOptionalsFromPost($extralabels,$object);
</source>

== Dans la page d'édition pour afficher des champs supplémentaires ==

<source lang="php">
$reshook=$hookmanager->executeHooks('formObjectOptions',$parameters,$object,$action); // Note that $action and $object may have been modified by hook
if (empty($reshook) && ! empty($extrafields->attribute_label))
{
print $object->showOptionals($extrafields,'edit');
}
</source>

== Dans une page pour afficher des champs supplémentaires ==

<source lang="php">
$reshook=$hookmanager->executeHooks('formObjectOptions',$parameters,$object,$action); // Note that $action and $object may have been modified by hook
if (empty($reshook) && ! empty($extrafields->attribute_label))
{
print $object->showOptionals($extrafields);
}
</source>

== Après la méthode de récupération de cette classe d'objet ==
<source lang="php">
require_once(DOL_DOCUMENT_ROOT.'/core/class/extrafields.class.php');
$extrafields=new ExtraFields($this->db);
$extralabels=$extrafields->fetch_name_optionals_label($this->table_element,true);
if (count($extralabels)>0) {
$this->fetch_optionals($this->id,$extralabels);
}
</source>

== Après la méthode Update de cette classe d'objet : ==
<source lang="php">
// Actions sur des champs supplémentaires (par module externe ou code standard)
// FIXME le hook fait double emploi avec le trigger !!
$hookmanager->initHooks(array('HookModuleNamedao'));
$parameters=array('socid'=>$this->id);
$reshook=$hookmanager->executeHooks('insertExtraFields',$parameters,$this,$action); // Note that $action and $object may have been modified by some hooks
if (empty($reshook))
{
if (empty($conf->global->MAIN_EXTRAFIELDS_DISABLED)) // For avoid conflicts if trigger used
{
$result=$this->insertExtraFields();
if ($result < 0)
{
$error++;
}
}
}
else if ($reshook < 0) $error++;
</source>

== Après la méthode supprimer de cette classe d'objet ==
<source lang="php">
// Suppression d'extrafields
if (! $error)
{
if (empty($conf->global->MAIN_EXTRAFIELDS_DISABLED)) // For avoid conflicts if trigger used
{
$result=$this->deleteExtraFields();
if ($result < 0)
{
$error++;
dol_syslog(get_class($this)."::delete erreur ".$errorflag." ".$this->error, LOG_ERR);
}
}
}
</source>

== Pages d'administration ==
<source lang="php">
$elementtype='facture'; // Doit être l'élément $table_element de la classe qui gère extrafield
</source>

== Réparation de Base de données ==
Rechercher et trouver la définition de $listofmodulesextra ajouter la nouvelle déclaration extrafield
<source lang="php">
$listofmodulesextra=array('societe'=>'societe','adherent'=>'adherent','product'=>'product',
'socpeople'=>'socpeople', 'commande'=>'commande', 'facture'=>'facture',
'commande_fournisseur'=>'commande_fournisseur', 'actioncomm'=>'actioncomm',
'adherent_type'=>'adherent_type','user'=>'user','projet'=>'projet', 'projet_task'=>'projet_task');
</source>

== Comment changer les étiquettes des colonnes lors de l'utilisation de modèles (propals, etc.) ==

Dans le code PHP du modèle, vous pouvez changer les étiquettes de votre extrafield en changeant la fonction "_tableau (...)"