Dolibarr ERP CRM Wiki - User contributions [en]

Module Pennylane Sync

2026-10-19T15:57:56Z

Arcchester: Pennylane Sync 1.0.5 : Dolibarr 18 à 24, section « Quel PDF part » (scan fournisseur déposé, <REF>.pdf, refus si plusieurs scans, relance au dépôt), historique 1.0.1 à 1.0.5

== Module Pennylane Sync ==

'''Pennylane Sync''' est un module complémentaire pour Dolibarr ERP/CRM qui '''envoie automatiquement vos factures vers Pennylane''' : gardez Dolibarr pour la gestion, donnez Pennylane à votre expert-comptable. Les factures clients et fournisseurs validées, leurs PDF et les tiers partent vers Pennylane sans ressaisie ni export mensuel.

Connecteur indépendant, '''non affilié à Pennylane SAS'''.

{| class="wikitable"
|-
! Éditeur || arcchester
|-
! Licence || GPL v3
|-
! Compatibilité Dolibarr || 18.0 à 24.x (testé sur 18.0.5, 20.0.4 et 24.0.0, PHP 8.2)
|-
! PHP || 7.4 à 8.3
|-
! Prérequis || Modules Facturation et Tiers ; module Cron recommandé ; un jeton d'API Pennylane
|-
! Dépendances || Aucune (cURL pur)
|-
! Distribution || [https://www.dolistore.com/product.php?id=3483 Fiche sur le Dolistore]
|}

== Fonctionnalités ==

# '''Factures clients''' validées envoyées avec leur PDF, leurs lignes, leurs taux de TVA et leur compte de produit. Avoirs et acomptes compris ; un avoir référence sa facture d'origine.
# '''Factures fournisseurs''' saisies dans Dolibarr, envoyées avec le scan du fournisseur déposé dans l'onglet ''Documents'' (voir [[#Quel PDF part|Quel PDF part]]).
# '''Création des tiers''' au premier envoi (société ou particulier, fournisseur sous son propre rôle), puis mise à jour ensuite.
# '''Résolution automatique des comptes comptables''' : le numéro de compte Dolibarr est traduit en identifiant Pennylane, avec mise en cache. Aucune table de correspondance à saisir à la main.
# '''File d'attente tracée''' : chaque envoi est un job avec son statut, ses tentatives et le message exact renvoyé par l'API. Reprise automatique, rejeu manuel, rattrapage d'historique.
# '''Rapport d'écart''' : mois par mois, ce que Dolibarr a validé face à ce que Pennylane a reçu — à vérifier avant une clôture.
# '''Panneau sur la fiche facture''' : PDF qui partira, date d'envoi, identifiant distant, lien vers la pièce.

Le module respecte les limites de débit de l'API Pennylane (25 requêtes par tranche de 5 secondes) en se freinant sur les en-têtes de quota renvoyés par le serveur.

== Les règlements : ce que le module fait, et pourquoi ==

L'API Pennylane ne permet pas d'attacher un paiement chiffré à une facture, et une écriture comptable créée par l'API ne peut pas être lettrée avec une pièce. Publier des règlements par ce biais laisserait des écritures à lettrer à la main et ferait double emploi avec le flux bancaire du cabinet.

'''Le module ne pousse donc aucune écriture de règlement.''' À la place, chaque facture part avec une '''référence de rapprochement''' qui indique à Pennylane comment reconnaître le mouvement bancaire correspondant : le numéro de facture, ou l'identifiant du paiement Stripe lorsque le module [[Module Stripe Payment Links|Stripe Payment Links]] est actif. Le lettrage devient exact parce que la référence l'est.

== Ce que le module ne fait pas ==

* Il ne rapatrie rien de Pennylane vers Dolibarr : pas de double source de vérité.
* Il ne remplace pas la comptabilité de Dolibarr : il alimente celle du cabinet.
* Il n'envoie ni commandes, ni devis, ni notes de frais, ni salaires.

== Installation ==

# Copier <code>pennylanesync/</code> dans <code>htdocs/custom/</code>, ou installer le zip depuis ''Accueil → Configuration → Modules/Applications → Déployer/installer un module externe''.
# Activer '''Pennylane Sync''' (famille « Finance / Facturation »).

== Configuration ==

# Dans Pennylane : ''Settings → Connectivity → Developers'' → créer un jeton d'API. '''Un jeton correspond à une société.'''
# Coller le jeton dans la configuration du module et tester la connexion.
# Choisir ce qui est envoyé (factures clients, factures fournisseurs), et activer la tâche planifiée qui traite la file d'attente.
# Facultatif : lancer un rattrapage d'historique sur une période passée.

== Utilisation ==

À la validation d'une facture, un job est déposé dans la file. La tâche planifiée l'exécute : le PDF est d'abord téléversé, puis la facture est importée avec sa référence au fichier. Le panneau de la fiche facture montre l'état de l'envoi, et la page de la file permet de rejouer un job en échec après correction. Avant une clôture, le rapport d'écart compare mois par mois les deux systèmes.

== Quel PDF part ==

Pennylane n'importe une facture qu'avec son PDF, et une pièce importée ne se remplace plus par l'API. Le module choisit donc le fichier avant l'envoi :

* '''Facture client''' : le PDF généré par Dolibarr.
* '''Facture fournisseur''' : le scan du fournisseur déposé dans l'onglet ''Documents'' de la facture, choisi dans cet ordre :
*# le fichier nommé <code><REF>.pdf</code>, où <REF> est la référence Dolibarr de la facture ;
*# sinon, le seul scan déposé ;
*# sinon, le scan dont le nom contient la référence du fournisseur.
* '''Sans aucun scan''', c'est le PDF généré par Dolibarr qui part. Quand une facture fournisseur a à la fois un PDF généré et un scan, c'est le scan qui part.
* '''Plusieurs scans sans indice''' : l'envoi est refusé avec le motif « PDF ambigu ». Renommez le bon fichier en <code><REF>.pdf</code> ou retirez les autres.
* '''Relance automatique''' : déposer, renommer ou retirer un PDF sur la facture remet en file un envoi bloqué pour PDF manquant ou ambigu, sans rejeu manuel. Même chose quand on génère le PDF d'une facture client. Les autres échecs restent en l'état.

Le panneau de la fiche facture indique le PDF qui partira, ou ce qu'il faut faire pour débloquer l'envoi.

== Historique des versions ==

{| class="wikitable"
|-
! Version !! Apports principaux
|-
| 1.0.0 || Version initiale : envoi des factures clients et fournisseurs avec PDF, création et mise à jour des tiers, résolution des comptes comptables, file d'attente tracée avec rejeu et rattrapage, référence de rapprochement bancaire, rapport d'écart mensuel, panneau sur la fiche facture, FR/EN
|-
| 1.0.1 || Corrections : la file d'attente ne distribue plus un même job à deux exécutions, la fusion de tiers ne crée plus de doublon chez Pennylane, la purge des journaux respecte l'entité, la reprise à 12 h est atteignable et les numéros de compte courts sont résolus
|-
| 1.0.2 || PDF obligatoire pour tout import ; factures abandonnées exclues ; recherche par référence externe avant de créer un tiers ou d'importer une facture ; devises non prises en charge refusées ; guide de démarrage FR/EN et messages d'erreur dépliables
|-
| 1.0.3 || Interface harmonisée (compteurs, filtres, tableaux, badges, panneau de la facture) ; moteur de synchronisation inchangé
|-
| 1.0.4 || Facture fournisseur : le scan déposé dans l'onglet ''Documents'' part avec la facture (<code><REF>.pdf</code>, sinon le seul scan, sinon celui dont le nom contient la référence du fournisseur ; refus « PDF ambigu » s'il y a plusieurs scans sans indice). Relance automatique au dépôt, au renommage ou au retrait d'un PDF. Le panneau de la facture indique le PDF qui partira
|-
| 1.0.5 || Compatible Dolibarr 18 et 19 (20 minimum auparavant) : le module s'installe de Dolibarr 18 à 24. En 18 et 19, le panneau de la fiche facture s'affiche dans le tableau des attributs. Moteur d'envoi inchangé
|}

== Support ==

* Contact : support@arcchester.com
* Autres modules du même éditeur : [https://www.dolistore.com/recherche?controller=search&search_query=arcchester recherche « arcchester » sur le Dolistore]

[[Category:Modules complémentaires]]

Module ExportFlow

2026-10-14T19:46:32Z

Arcchester: Création de la page du module ExportFlow 1.0.0 (exports Excel, LibreOffice, CSV, PDF et envois programmés)

== Module ExportFlow ==

{| class="wikitable"
|-
! Nom !! Éditeur !! Prix !! Compatibilité !! Langues
|-
| ExportFlow 1.0.0 || arcchester || 79 € HT (Dolistore) || Dolibarr 18 à 24, PHP 7.4 à 8.3 || fr, en, es, de, it
|}

'''ExportFlow''' est un module complémentaire pour Dolibarr ERP/CRM qui ajoute un bouton '''Exporter''' sur toutes les listes de Dolibarr et des modules externes. Le fichier reprend exactement l'écran (filtres, tri, colonnes, toutes les pages) au format '''Excel (.xlsx), LibreOffice Calc (.ods), CSV ou PDF'''. Une liste peut aussi être envoyée par e-mail en un clic, ou '''programmée''' (chaque jour, semaine, mois) avec une '''période glissante''' sur ses filtres de date.

== Installation ==
# Accueil › Configuration › Modules › ''Déployer un module externe'' : envoyez le fichier zip.
# Activez '''ExportFlow''' (famille Technique).
# Pour les envois programmés, activez le module '''Travaux planifiés''' (cron) et vérifiez l'onglet ''À propos et diagnostic'' de la configuration d'ExportFlow.

== Droits ==
{| class="wikitable"
|-
! Droit !! Par défaut !! Effet
|-
| Exporter les listes affichées || Oui || Bouton Exporter, téléchargement des fichiers
|-
| Envoyer une liste par e-mail et programmer ses propres envois || Non || Menus « Envoyer par e-mail » et « Programmer un envoi », écran des envois
|-
| Gérer tous les envois programmés et consulter tout le journal || Non || Envois et journal de tous les utilisateurs
|}

== Utilisation ==
=== Exporter une liste ===
Ouvrez une liste, filtrez-la et choisissez vos colonnes comme d'habitude. Le bouton '''Exporter''' se trouve à côté des boutons d'affichage (liste, kanban, statistiques). Un clic sur un format exporte '''toute la liste filtrée''' ; si des lignes sont cochées, seules celles-ci sont exportées. ''Options d'export…'' permet de choisir le périmètre (toute la liste, page affichée, lignes cochées), les colonnes, le titre du document, la ligne de totaux et l'orientation du PDF.

=== Ce que contient le fichier ===
* Nombres, montants, pourcentages et dates de vrais types, relus selon la langue de l'utilisateur.
* Codes postaux, téléphones, codes clients, EAN et SIRET gardés en texte.
* Ligne de totaux en SOUS.TOTAL (suit les filtres automatiques du tableur).
* Références cliquables vers les fiches Dolibarr.
* Feuille ''Informations'' : liste, filtres appliqués, tri, auteur, date, adresse de la liste.
* PDF : logo et coordonnées de la société, filtres, orientation et police calculées, entête répétée, totaux, page x / y.

=== Envoyer par e-mail ===
''Exporter › Envoyer par e-mail…'' : destinataires, copie, objet, message. Le fichier est envoyé par la messagerie de Dolibarr, avec un récapitulatif (liste, lignes, filtres).

=== Programmer un envoi ===
''Exporter › Programmer un envoi…'' ouvre un formulaire pré-rempli avec la liste courante :
* périodicité : tous les jours, du lundi au vendredi, chaque semaine (jour), chaque mois (jour ou dernier jour), heure ;
* '''période glissante''' : hier, aujourd'hui, 7 ou 30 derniers jours, semaine, mois, trimestre ou année en cours ou précédent(e), appliquée à l'un des filtres de date de la liste ;
* destinataires, objet (variables <code>{period}</code> et <code>{date}</code>), message ;
* options : envoyer même si la liste est vide, conserver une copie des fichiers.
Les envois se gèrent dans ''Outils › Exports et envois › Envois programmés'' (envoyer maintenant, télécharger maintenant, historique, fichiers archivés).

== Configuration ==
* Formats proposés et nombre maximal de lignes par format (au-delà, refus clair, jamais de troncature).
* Tableurs : totaux, liens, feuille Informations, lignes alternées.
* PDF : orientation, couleur de l'entête, logo, mention de pied de page.
* CSV : séparateur, nombres, BOM UTF-8.
* Pages exclues, tableaux secondaires.
* Envois programmés : URL interne, conservation des fichiers et du journal, test de connexion.

== Envois programmés : la connexion du serveur vers lui-même ==
La tâche planifiée rejoue chaque liste en appelant Dolibarr depuis le serveur, avec un jeton à usage unique. Si le test « Connexion du serveur vers lui-même » échoue (pare-feu, proxy, conteneur), renseignez une '''URL interne''' joignable depuis le serveur, par exemple <code>http://127.0.0.1/dolibarr</code> ou <code>http://localhost:8080</code>.

== Sécurité ==
* La liste est rejouée avec les droits de l'utilisateur : il n'exporte que ce qu'il voit.
* Les paramètres d'action (action, massaction, confirm…) ne sont jamais rejoués.
* Le texte n'est jamais interprété comme formule ; le CSV neutralise les cellules commençant par = + - @.
* Journal de chaque export (utilisateur, liste, format, lignes, destinataires).

== Support ==
support@arcchester.com

Page Dolistore : rechercher « ExportFlow » sur https://www.dolistore.com

[[Category:Modules complémentaires]]

List of modules id

2026-10-11T00:01:40Z

Arcchester: /* ID 100000 - 499999 */ Reserve 303620–303629 for Arcchester; assign 303620 to Focus.

{{TemplateDocDevEn}}
{{TemplateDocDevEs}}
{{TemplateDocDevFr}}
{{TemplateDocDevZh}}

This page list all reserved modules numbers / ID.

If you build or want to build your own modules, you should take an ID range here. Please pick range into existing holes first.

=ID 0 - 94999=
This range is reserved for Dolibarr's internal core modules, so all modules available into the standard distribution at https://github.com/Dolibarr/dolibarr

=ID 95000 - 99999=
This range is reserved for Dolibarr's community modules with sources hosted into the github repository: https://github.com/Dolibarr/dolibarr-community-modules

=ID 100000 - 499999=

Reserved area for editors in need for an ID range. You can edit this page to add your own range (take a range of 20 numbers only the first time, ask us for more)

[[File:Warning.png]] If you reserve more than 10 at once, we may automatically change your reservation range without information and you may experience conflicts with other modules in a future, so please follow the rules!

*ID 100000 - 100999: OpenThink (http://www.openthink.be) - Belgium
*ID 101000 - 101999: DoliCloud (https://www.dolicloud.com) - France
*ID 102000 - 102999: Tiaris (http://www.tiaris.fr) - France
*ID 103000 - 103999: Open-concept.pro (http://www.open-concept.pro) - France
*ID 104000 - 104999: ATM Consulting (http://www.atm-consulting.fr) - France
*ID 105000 - 105999: GPC.solutions - France
*ID 106000 - 106999: PHPASSO
*ID 107000 - 107999: TecLib (http://www.teclib.com) / Auguria (http://www.auguria.net) - France
*ID 108000 - 108999: ETHICWEB
*ID 109000 - 109999: Aplose ([http://www.aplose.fr https://www.aplose.fr]) - France
*ID 110000 - 110999: Association Dolibarr (https://www.dolibarr.org)
*ID 111000 - 111999: Asset IT (www.assetit.ch) - Suisse
*ID 112000 - 112999: Aarboard AG ([https://www.aarboard.ch www.aarboard.ch]) - Suisse
*ID 113000 - 113999: Asilib - Alexandre Spangaro
*ID 114000 - 114999: Iceleaf OÜ
*ID 115000 - 115999: 2A2C Conseil - Cyril ZEKSER
*ID 116000 - 116999: Wolftec GmbH
*ID 117000 - 117999: Oscim (http://www.oscim.fr)
*ID 118000 - 118999: Oarces Web (dev.oarces.com)
*ID 119000 - 119999: Manuel Berrocal - Absolacom
*ID 120000 - 120999: Régis Houssin (http://www.inodbox.com) - France
*ID 121000 - 121999: Oscss - Shop - France
*ID 122000 - 122999: MrSof - la Nation du Web
*ID 123000 - 123999: Bruno Généré (webiseasy.org)
*ID 124000 - 124999: 7reasons s.r.l. (www.7reasons.eu) - Austria
*ID 125000 - 125999: ProgSI (www.progsi.ma)
*ID 126000 - 126999: Catalanet
*ID 127000 - 127999: Virgilio Filho pt-BR Brasil (@dolibarr.br) - Brazil
*ID 128000 - 128999: Nicolas Frappé France (www.sospc.info)
*ID 129000 - 129999: Adeo-Informatique
*ID 130000 - 130999: Technicks ICT (http://www.technicks.eu) - Italy
*ID 131000 - 131999: Joan Louis (itaca.fr) - France
*ID 132000 - 132999: Jean-Marie Arsac (https://azimut.fr) - France
*ID 133000 - 133999: Oriel Systems Ltd, UK. (www.orielsystems.com)
*ID 134000 - 134999: ALSOFT PVT. LTD. (https://www.alsoft.org)
*ID 135000 - 135999: Net-Logic (https://netlogic.fr)
*ID 136000 - 136050: MONA.RE - France
*ID 136051 - 136099: La Vida Marketing
*ID 136100 - 136149: Synergies-Tech France. (https://www.synergies-france.fr/)
*ID 136150 - 136199: Lyta
*ID 136200 - 136219: Maison Théophile Leclerc
*ID 136220 - 136270: SegoFount - Spain
*ID 136271 - 136320: Labor Dispatch (Simon Sheng , China)
*ID 136321 - 136370: MB Informatique (https://www.mb-informatique.fr)
*ID 136371 - 136420: Daxit Solutions (https://www.daxit.be) [https://wiki.dolibarr.org/index.php/DAXIT-SOLUTIONS_List_of_modules_id Liste complète des modules Daxit]
*ID 136421 - 136470: HUSCH GmbH (https://husch-gmbh.de)
*ID 136471 - 138999: NSINFO (https://www.ns-info.fr)
*ID 139000 - 139999: Synergies-Tech France. (https://www.synergies-france.fr/)
*ID 140000 - 140999: Altairis (http://altairis.fr)
*ID 141000 - 141050: Projet2Team (https://www.projet2team.fr)
*ID 141051 - 141099: Elistair (http://elistair.com)
*ID 141100 - 141149: Blue Networks Technologies (https://www.blnt.fr)
*ID 141150 - 141199: Mainlab S.r.l. (https://www.mainlabonline.it) - Italy
*ID 141200 - 141249: Florian DUFOURG - France
*ID 141250 - 141299: SoftAddicts - Canada
*ID 141300 - 141349: Finanboo - (https://www.finanboo.com)
*ID 141350 - 141399: ConstruxZion Soft - Colombia (https://www.construxzionsoft.com.co)
*ID 141400 - 141450: COEXDIS - République Démocratique du Congo (https://www.coexdis.com)
*ID 141451 - 141501: HALFWARE - Algeria (https://www.half-ware.com)
*ID 141502 - 141552: Quantraum (https://quantraum.com)
*ID 141553 - 141603: Nateo Group
*ID 141604 - 141653: digital centric GmbH (https://www.digitalcentric.de/dolibarr)
*ID 141654 - 141699: Decrypting (https://www.decrypting.fr)
*ID 141700 - 141749: Zeise IT Consulting - Germany (https://www.zeise-it.de)
*ID 141750 - 141799: Data Rooster - France (https://datarooster.io)
*ID 141800 - 141849: IP Développement (https://www.ipdeveloppement.fr)
*ID 141850 - 141899: MSICCA | MRVL Soluciones de Ingeniería y Construcción, c.a (https://msicca.com)
*ID 141900 - 141949: THERSANE (https://www.thersane.fr)
*ID 141950 - 141999: MB Informatique (https://www.mb-informatique.fr)
*ID 142000 - 142049: ITANéA (https://www.itanea.fr)
*ID 142050 - 142099: ERP Consulting NZ ([https://www.erpconsulting.co.nz www.erpconsulting.co.nz])
*ID 142100 - 142149: Bloxera GmbH (https://www.bloxera.com)
*ID 142150 - 142199: Evangelos Souglakos - Greece
*ID 142200 - 142249: Luc CALARESU - France
*ID 142250 - 142299: OmnIT Services - Belgique (https://www.omnitservices.biz)
*ID 142300 - 142349: Gwadeyes - Guadeloupe (https://www.gwadeyes-informatique.com/)
*ID 142350 - 142399: Solution Libre (https://www.solution-libre.fr/)
*ID 142400 - 142449: Res Digital (https://res.digital)
*ID 142450 - 142499: itopie informatique (https://www.itopie.ch)
*ID 142500 - 142549: Weblinx.IT GbR (https://weblinx.it/) - Germany
*ID 142550 - 142599: ASCI-Automation - Mexico (https://asci-automation.com.mx/)
*ID 142600 - 142649: ZENKO Design - Japan / France / Spain
*ID 142650 - 142699: AWeerWolf
*ID 142700 - 148749: Lysis (https://lysis.net/)
*ID 142750 - 142769: Doliplug (https://www.doliplug.com)
*ID 142770 - 142799: PandaERP
*ID 142800 - 142849: Bloxera GmbH (https://www.bloxera.com)
*ID 142850 - 144999: Everlats S.L. - España (https://www.everlats.com)
*ID 145000 - 145299: Gestsuite ERP ([https://www.everlats.com https://www.gestsuite.com])
*ID 149000 - 149999: SydTech - America Central (https://www.sydtech.io/)
*ID 150000 - 150999: Jeffinfo
*ID 151000 - 151999: Konverseo (https://konverseo.com)
*ID 152000 - 152049: Tanguy Pénet (http://tanguype.net)
*ID 152050 - 152099: Web Solutions
*ID 152100 - 152149: MagicNet (https://www.magicnet.it)
*ID 152150 - 152199: Benjamin Falière (https://www.faliere.com)
*ID 152200 - 152249: Solauv
*ID 152250 - 156499: TecnoGestión Principado S.L. (https://www.tecnogestion.com) - Asturias - España
*ID 156500 - 156549: ACE Recycling (https://www.acerecycling.net.au/)
*ID 156550 - 156599: Kreativität Works ([http://www.kreativitat.com http://kreativitat.com])
*ID 156600 - 156649: [https://pierre-couy.dev Pierre Couy]
*ID 156650 - 156699: CXI (https://cyrix.co.za)
*ID 156700 - 156749: Mustafa Kemerci - Turkiye
*ID 156750 - 156799: [https://de-grandpre.quebec de Grandpré Technologies] - Québec (Canada)
*ID 156800 - 156849: Draceo
*ID 156850 - 156899: Valleiweb
*ID 156900 - 159949: NEOVIAQ Advisory LU(https://www.neoviaq.com)
*ID 159950 - 159999: Arve et Giffre INFOGESTION (https://www.ag-infogestion.fr)
*ID 160000 - 160999: Charles-François BENKE (http://www.patas-monkey.com)
*ID 161000 - 161999: Abbes Bahfir (https://01consulting.eu)
*ID 162000 - 162999: Jacques Rébiscoul
*ID 163000 - 163999: Open-DSI (https://www.open-dsi.fr)
*ID 164000 - 164999: Pixelada S. Coop. And. (https://pixelada.org)
*ID 165000 - 165049: DovConnect
*ID 165050 - 165099: Mind Operated Systems (https://www.mosystems.biz)
*ID 165100 - 165150: SD-Formation (https://sdformation.fr)
*ID 165151 - 165199: NUM'X (https://www.numx-sets.eu)
*ID 165200 - 165249: Benjam Préjent (https://www.benjam-prejent.fr)
*ID 165250 - 165299: Dhi Loka Private Limited, India (https://www.dhiloka.com)
*ID 165300 - 169999: Accellier Limited (https://www.accellier.com/)
*ID 170000 - 170999: TRIDENT CONSULTING LTD (www.tridentdxb.com)
*ID 171000 - 171999: LVSInformatique (www.lvsinformatique.com)
*ID 172000 - 172299: Ray Soft-Systems (https://www.ray-soft-systems.com)
*ID 172300 - 172349: Günter Lukas Consulting (https://gl.co.at)
*ID 172350 - 172399: MB Informatique (https://www.mb-informatique.fr)
*ID 172400 - 172449: Professional Structures Limited (https://pstructures.com)
*ID 172450 - 172699: IT-BS (https://www.it-bs.fr)
*ID 172700 - 172749: Indelog (https://www.indelog.fr)
*ID 172750 - 172799: NSINFO (https://www.ns-info.fr)
*ID 172800 - 172849: E-Concept Applications (https://e-concept-applications.fr)
*ID 172850 - 172899: B&R Stamm UG (https://stamm-ug.de)
*ID 172900 - 172949: Dolipive, support@dolipive.fr, www.dolipive.fr
*ID 172950 - 172999: CKD-Industrie (https://ckd-industrie.com/) - France
*ID 173000 - 173049: Aneosys (https://aneosys.fr) - France
*ID 173050 - 173099: Sebastian Schloßer - Germany
*ID 173100 - 173149: TecnoSoluciones (https://tecnosoluciones.com)
*ID 173150 - 173199: Digitalworks (https://www.digitalworks.fr) - France
*ID 173200 - 173249: UNi.D Consulting (https://www.unid-consulting.fr) - France
*ID 173250 - 173299: NetworkDigital(https://www.networkdigital.fr) - France
*ID 173300 - 173300: Módulo VeriFactu Dolibarr (https://verifactudolibarr.es/) - España
*ID 173301 - 173320: Sibanet (https://sibanet.net) - España
*ID 173321 - 173340: disQutons (https://wiki.dolibarr.org/index.php/Category:DisQutons) - France
*ID 173341 - 173360: Surática Software (https://suratica.es) - Spain
*ID 173361 - 173380: UpInvoice (https://upinvoice.eu) - Spain
*ID 173381 - 179999: Toutatis (https://toutatis.eu)
*ID 180000 - 180999: BM eXpert Labs
*ID 181000 - 181999: TI Sin Problemas (https://www.tisinproblemas.com)
*ID 182000 - 182049: Chipserv Pawel Wlizlo (https://www.testware.it)
*ID 182050 - 182070: Herolapse (https://herolapse.com/)
*ID 182061 - 182999: TMC
*ID 183000 - 183999: BB2A Anthony Berton (https://www.bb2a.fr)
*ID 184000 - 184999: DPS PRINTING & DOCUMENTS SOCIEDAD ANONIMA (https://www.dps-lat.com)
*ID 185000 - 185049: Telioskour (https://github.com/telioskour)
*ID 185050 - 185099: Moko Consulting ([[Moko Consulting]] || https://mokoconsulting.tech)
*ID 185100 - 185149: Sinabe (https://sinabe.ch) - Suisse
*ID 185150 - 185169: Anatole Conseil (https://anatoleconseil.com/)
*ID 185170 - 185189: cferoiu
*ID 185190 - 185209: Guillemonde (https://guillemonde.family)
*ID 185210 - 185229: ITized - Finta Ionut (https://itized.com)
*ID 185230 - 185249: svewa (https://github.com/svewa/)
*ID 185250 - 185269: Clément Jaunay (https://clement-jny.fr/ || contact@clement-jny.fr)
*ID 185270 - 185289: AMB Technologies (https://www.ambts.fr)
*ID 185290 - 185299: VIOLET IT UG (https://violet-it.de)
*ID 185300 - 185319: lorem.site '''('''https://lorem.site/''')'''
*ID 185320 - 185340: Rentageek (https://rentageek.hu) Hungary
*ID 185341 - 185360: Hamzavi Infotech (<nowiki>https://www.hamzaviinfotech.com</nowiki>)
*ID 185361 - 185380: La souris de Gutenberg (<nowiki>https://www.lasourisdegutenberg.fr</nowiki>)
*ID 185381 - 185400: LodinPay (https://www.lodinpay.io)
*ID 185401 - 185420: Avertissance (https://avertissance.fr). France
*ID 185421 - 185849: TH Investissements / Matelas No Stress - France (internal ERP / production / logistics modules)
*ID 185850 - 185899: B&R Stamm UG (<nowiki>https://stamm-ug.de</nowiki>)
*ID 185900 - 185919: OpenLine Solutions - Olaf John (https://openlinesolutions.de) - Germany
*ID 185920 - 189999: Abadia Tecnologica - (https://abadiatecnologica.com) - Spain
*ID 190000 - 190999: Diciannove (http://19.coop)
*ID 191000 - 191999: Elonet (https://elonet.fr)
*ID 192000 - 192049: IDFOR Consulting (https://www.idfor-consulting.fr/)
*ID 192050 - 192069: Stogger (<nowiki>https://stogger.com</nowiki>)
*ID 192070 - 192090: Protectora
*ID 192091 - 192110: CoopCircuits - OpenFoodNetwork (https://coopcircuits.fr/)
*ID 192111 - 192130: Saidigit - Belgique
*ID 192131 - 192150: Lia Concept (https://lia-concept.fr)
*ID 192151 - 192999: GHM LABS (https://ghm-labs.ma/)
*ID 193000 - 193020: Forlead (https://forlead.fr/)
*ID 193021 - 193041: Doliway (https://doliway.fr)
*ID 193042 - 193062: ERPkit ( https://erpkit.app )
*ID 193063 - 193083: Eric FALCON
*ID 193084 - 193103: Ienx2
*ID 193104 - 193123: OpenLine Solutions - Olaf John (https://openlinesolutions.de) - Germany
*ID 193124 - 193144: zeug.it - Germany
*ID 193145 - 193164: Alpenia (https://alpenia.app)
*ID 193165 - 193174: Nicolas Gracia - France
*ID 193174 - 193879: Ronald ASSOUS - OBS - France
*ID 193880 - 193899: Ideal Solutions
*ID 193900 - 193919: BRiCK (https://justbrick.fr)
*ID 193920 - 193929: '''DoliHub''' (ergoCogn, [https://dolihub.ch dolihub.ch]) - Switzerland
*ID 193930 - 193939: Unified Software
*ID 193940 - 193949: '''Anatole Conseil (<nowiki>https://anatoleconseil.com/</nowiki>)'''
*ID 193950 - 193959: KIZILTANLAR - Ayhan Kızıltan - Türkiye
*ID 193960 - 193969: DesignShot (https://design-shot.com) | Germany
*ID 193970 - 193979: Yurexa (<nowiki>https://ko-fi.com/yurexa</nowiki>) - France
*ID 193980 - 193989: Tekynod Sàrl (https://tekynod.ch) - Switzerland
*ID 193990 - 193999: '''DEVTHIS''' (https://devthis.fr) - France
*ID 194000 - 194019: Integmia
*ID 194020 - 194039: Goeger-IT (https://www.goeger-it.de) - Germany
*ID 194040 - 194050: '''Cédric Roy - France'''
*ID 194051 - 194060: '''Anatole Conseil (<nowiki>https://anatoleconseil.com/</nowiki>)'''
*ID 194061 - 194070: '''R. Juan - GMAO+ - France'''
*ID 194071 - 194080: Idoo (https://idoo.mx) - Mexico
*ID 194081 - 194090: FlowMatrix AI (https://flowmatrixai.com)
*ID 194091 - 194100: M Burak Şentürk (https://buraksenturk.net)
*ID 194101 - 194110: Master AI VC ([[User:Danny.wu|Danny.wu]]) (https://www.masteraivc.com) - Taiwan
*ID 194121 - 194130: Luckidea (https://www.luckidea.fr) - France
*ID 194131 - 194140: Studio Viking (<nowiki>https://www.studio-viking.fr</nowiki>) - France
*ID 194411 - 194420: Welters Datentechnik (https://welters.de)
*ID 194421 - 194430: Altaxia (https://www.altaxia.fr)
*ID 194431 - 194451: Profy Solutions (https://projectfactory.rs/)
*ID 194152 - 194161: Theo Pequignot (https://theopequignot.fr) - France
*ID 194162 - 194171: Personalised AI Solutions MCP Connect (Spain)
*ID 194172 - 194181: M2engineering GmbH (https://m-2-engineering.com) - Germany -
*ID 194182 - 197979: '''Free (take ranges of 10 only please at once, ask us for more)'''
*ID 197980 - 197989: Mercury Labs SAGL (https://mercurylabs.ch) - Swiss Banking - Switzerland
*ID 197990 - 197999: Mercury Labs SAGL (https://mercurylabs.ch) - Swiss Salaries - Switzerland
*ID 198000 - 198999: dolibaTeam
*ID 199000 - 199999: RFMS
*ID 200000 - 200999: Noxiome
*ID 201000 - 201999: Sasa Ostrouska (saxa)
*ID 202000 - 202999: Z-Application
*ID 203000 - 203099: Elidee - elidee.com
*ID 203100 - 203999: Garcia MICHEL (soamichel.fr)
*ID 204000 - 204999: Ari Elbaz elarifr - accedinfo.com
*ID 205000 - 205999: Kreiz IT
*ID 206000 - 206999: GBINFO (www.gbinfo.fr)
*ID 207000 - 207099: MacroProg (https://www.macroprog.com)
*ID 207100 - 207149: Reactiva Software
*ID 207150 - 207199: Ndejje University Water Research and Development Centre ([https://github.com/NDUWRDC/LIMS/])
*ID 207200 - 207299: Massaoud Bouzenad ([https://www.dzprod.net dzprod.net])
*ID 207300 - 207349: Ksar
*ID 207350 - 207399: Easylinux (www.easylinux.fr)
*ID 207400 - 207449: Arthur LENOBLE
*ID 207450 - 207499: Vaicop SAS de CV (México)
*ID 207500 - 207520: Frankie Wong - UK
*ID 207521 - 207540: Fyssec ([https://fyssec.fr/ fyssec.fr/])
*ID 207541 - 207560: My easy Office SAS ([https://www.myeasyoffice.fr www.myeasyoffice.fr])
*ID 207561 - 207580: All-Lock Védelem Kft.
*ID 207581 - 207599: Zenitique ([https://www.zenitique.fr www.zenitique.fr])
*ID 207600 - 207609: Vasile Panciuc - ProductExpiryIO - Moldova
*ID 207610 - 207619: Kunisolutions (https://kunisolutions.com)
*ID 207620 - 207629: INCREATION - France - ListColumnsManager*
*ID 207630 - 207639: DI404 (https://www.di404.fr)
*ID 207640 - 207649: Kajoz Business Hub - Zambia (https://kajozbizhub.africa)
*ID 207650 - 207679: Septmr (https://www.septmr.com)
*ID 207680 - 209989: '''Free (take ranges of 10 only please at once, ask us for more)'''
*ID 209990 - 209999: doliTeam
*ID 210000 - 210100: Lemon (https://hellolemon.fr)
*ID 210101 - 210120: Cebrian IT ([[cebrian-it.com]])
*ID 210121 - 210130: Vasile Panciuc - Warehouse Scanner Pro
*ID 210131 - 210140: Vasile Panciuc - PanciucSoft - Moldova
*ID 210141 - 210999: Free (take ranges of 10 only please at once, ask us for more)
*ID 212100 - 212149: Audio Vidéo Technologies (https://www.avtek.fr)
*ID 212150 - 212169: AI MYA GROUP ([https://Www.AI-MYA-GROUP.com www.AI-MYA-GROUP.com])
*ID 212170 - 212189: DoliPro Suite - Carlosh7 ([https://github.com/carlosh7/DoliPro-Suite DoliPro-Suite])
*ID 212190 - 213999: '''Free (take ranges of 10 only please at once, ask us for more)'''
*ID 214000 - 214049: X-Boss
*ID 214050 - 221999: PixelJM
*ID 220000 - 220050: Apex Tech (https://apextechmods.com)
*ID 220051 - 220100: Technology Xchange Solutions (https://www.txscorp.com)
*ID 222000 - 222999: dolibit (https://www.dolibit.de)
*ID 223000 - 223049: Tráfico Canada
*ID 223050 - 223099: VLTN (https://vltn.sh)
*ID 223100 - 229949: Dazax.io (https://www.dazax.io)
*ID 229950 - 229999: Solucions Informàtiques, Serveis i Innovació SLU (https://6innova.es)
*ID 230000 - 230049: Unareil (https://www.unareil.eu)
*ID 230050 - 230099: Lyra Network (https://www.lyra.com/)
*ID 230100 - 230149: Gheorghe Iftimi - CTW - RO
*ID 230150 - 230199: MEMA Machinery & Tools (https://www.mema.be)
*ID 230200 - 230249: Teleassist
*ID 230250 - 230299: Nh Developer
*ID 230300 - 230499: Chickenforce/code-chicken, IT Services Hahn (https://github.com/code-chicken [http://itservices-hahn.de/ https://itservices-hahn.de])
*ID 230500 - 230549: Hidup Consulting (https://consulting.hidup.io)
*ID 230550 - 230599: CMR Conseil (https://www.weblockup.fr)
*ID 230600 - 230649: aFreeMind Studio
*ID 230650 - 230699: Unideal (https://www.uni-deal.com)
*ID 230700 - 230749: DevLansdes (https://devlandes.com/)
*ID 230750 - 230769 Kristof56 / Serpette & Cie /
*ID 230770 - 230789: Webelys (<nowiki>https://webelys.com</nowiki>)
*ID 230790 - 230799: X Poitou Network (<nowiki>https://www.xpoitou.fr</nowiki>) - France
*ID 230800 - 230999: '''Free (take ranges of 10 only please at once, ask us for more)'''
*ID 231000 - 231039: inno3 (<nowiki>https://inno3.fr</nowiki>) - France - suite de modules open source Dolibarr (inno3dashboard, meetingnotes, supportcredits, caldavbridge, frameworkprojects, ...)
*ID 231040 - 231199: SBINFO - France - (https://sbinfo.fr)
*ID 231200 - 231219: Mugisha || Modules ERP personnalisés (facturation, RH, intégration)
*ID 231220 - 231229: Wdes SAS (https://wdes.fr) - France
*ID 231230 - 231239: WEBMAY (<nowiki>https://webmay.fr</nowiki>) - France
*ID 231240 - 249999: <nowiki>'''</nowiki>Free (take ranges of 10 only please at once, ask us for more)<nowiki>'''</nowiki>
*ID 250000 - 250019: Barnecki Spirits (https://github.com/Barnecki)
*ID 250020 - 250039: NEXORA COMMERCE (https://nexoratoolbox.com) - France
*ID 250040 - 262699: '''Free (take ranges of 10 only please at once, ask us for more)'''
*ID 262700 - 262799: Scopen (https://www.scopen.fr)
*ID 262800 - 262849: Christophe BATTAREL EI
*ID 262850 - 262870: Nicolaus Hofer - Autriche
*ID 262871 - 262890: Knot Tools (<nowiki>https://knot.tools</nowiki>) - France
*ID 262891 - 271799: '''Free (take ranges of 10 only please at once, ask us for more)'''
*ID 271800 - 271849: bee solutions sàrl (Switzerland)
*ID 271850 - 272999: '''Free (take ranges of 10 only please at once, ask us for more)'''
*ID 273000 - 273019: Taler (https://taler.net)
*ID 273020 - 274199: '''Free (take ranges of 10 only please at once, ask us for more)'''
*ID 274200 - 274249: Mathilde MAROCCO (https://mminformatique.fr)
*ID 274250 - 274299: Nerv Project (www.nerv-project.eu)
*ID 274300 - 274349: Knowhere Consulting S.L. (https://www.knowhere-consulting.eu)
*ID 274350 - 274399: Milen karaganski (https://blacktiehost.com)
*ID 274400 - 274449: Vincent MAURY ([https://www.timgroup.fr www.timgroup.fr])
*ID 274450 - 274499: Daraelmin
*ID 274500 - 274549: Emilie LAFORET (http://www.ermvallon.com)
*ID 274550 - 278999: '''Free (take ranges of 10 only please at once, ask us for more)'''
*ID 279000 - 279049: VSDigital Electronics (https://vsdigital.ar) - Argentina
*ID 279050 - 279959: Saar Systems (https://www.saarsystems.de) - Germany
*ID 279060 - 279999: '''Free (take ranges of 10 only please at once, ask us for more)'''
*ID 280000 - 280049: Bingroup (https://www.beinng.com)
*ID 280050 - 280099: Medialta (https://medialta.com)
*ID 280100 - 280149: Cédric Ancelin - Ancode (https://www.dolistore.com/fr/recherche?search_query=ancode)
*ID 280150 - 280169: Rafael CF (https://virtualmachine.digital) - México
*ID 280170 - 289999: '''Free (take ranges of 10 only please at once, ask us for more)'''
*ID 290000 - 290099: BNS - Project doliBRA ([https://www.beinng.com https://www.bns.net.br]) - Brasil
*ID 290100 - 299999: '''Free (take ranges of 10 only please at once, ask us for more)'''
*ID 300000 - 300049: RapidProgress (https://www.rapidprogress.eu) - Bulgaria
*ID 300050 - 300099: M@ Solution (https://www.ma-solution.fr/)
*ID 300100 - 300149: LAVA RUN (https://www.lavarun.re)
*ID 300150 - 300199: PsyCrow Code
*ID 300200 - 300249: Computences (https://www.computences.com/)
*ID 300250 - 300299: LEVEL IT (https://levelit.com.ar)
*ID 300300 - 300349: Progiseize (https://progiseize.fr)
*ID 300350 - 300399: MB Informatique (https://www.mb-informatique.fr)
*ID 300400 - 300449: Anouar Touati
*ID 300450 - 300499: Martin Danger
*ID 300500 - 300999: dolibaTeam
*ID 301000 - 301299: DOLIBA TEAM
*ID 301300 - 301499: '''Free (take ranges of 10 only please at once, ask us for more)'''
*ID 301500 - 301549: Tom Trust - International
*ID 301550 - 301599: MB Informatique (https://www.mb-informatique.fr)
*ID 301600 - 302479: '''Free (take ranges of 10 only please at once, ask us for more)'''
*ID 302480 - 302499: akyras (https://akyras.fr)
*ID 302500 - 302549: Diamubi (https://diamubi.com)
*ID 302550 - 302599: Datolab (https://www.datolab.com)
*ID 302600 - 302649: DuMaCo (https://www.dumaco.de)
*ID 302650 - 302699: Resilio SA
*ID 302700 - 302749: Aroga
*ID 302750 - 302799: Productivix (https://www.productivix.com)
*ID 302800 - 302849: Slibzz
*ID 302850 - 302899: idea design (https://ideadesign.dz)
*ID 302900 - 302949: AL MISBAH INFORMATIQUE (https://www.almisbah.ma)
*ID 302950 - 302999: Atis Solutions - France
*ID 303000 - 303499: Obixav - Nigeria
*ID 303500 - 303549: buschler plus GmbH, Germany (https://buschler.plus)
*ID 303550 - 303599: Prestalidaire - France (https://prestalidaire.com)
*ID 303600 - 303619: Apertice - France (https://apertice.fr)
*ID 303620 - 303629: Arcchester (https://arcchester.com) - Focus: 303620
*ID 303630 - 309999: '''Free (take ranges of 10 only please at once, ask us for more)'''
*ID 310000 - 310049: Neilson Dufour (<nowiki>https://hypercode.ca</nowiki>)
*ID 310050 - 313999: '''Free (take ranges of 10 only please at once, ask us for more)'''
*ID 314000 - 314049: Ruemmler IT Solutions (https://www.ruemmler.net)
*ID 314050 - 314059: Qwimo - Belgique (https://qwimo.com)
*ID 314060 - 314149: '''Free (take ranges of 10 only please at once, ask us for more)'''
*ID 314150 - 314199: Benoît PASCAL
*ID 314200 - 319999: '''Free (take ranges of 10 only please at once, ask us for more)'''
*ID 320000 - 320999: Novus Studios (www.novusstudios.it)
*ID 321000 - 321999: AtooNet (http://www.atoo-net.com)
*ID 322000 - 322049: Doymer Consultores
*ID 322050 - 329999: '''Free (take ranges of 10 only please at once, ask us for more)'''
*ID 330000 - 330049: XTEC Industries (www.xtec-ind.com)
*ID 330050 - 330099: 10100 S.R.L. - (www.10100.to)
*ID 330100 - 330149: AES Dana SRL (https://aes-dana.be)
*ID 330150 - 330199: Freshcore (https://www.freshcore.fr)
*ID 330200 - 331999: '''Free (take ranges of 10 only please at once, ask us for more)'''
*ID 332000 - 332099: Gecka (https://gecka.nc)
*ID 332100 - 332149: Agence Milkshake (http://agencemilkshake.com)
*ID 332150 - 332199: Daniel Prowald IT – Service (https://prowald-it.de)
*ID 332200 - 332249: UNITICE (https://unitice.com)
*ID 332250 - 332299: Sidonie Moulart
*ID 332300 - 332349: LTDJ (Antonin MARCHAL - Le Temple du Jeu)
*ID 332350 - 333299: '''Free (take ranges of 10 only please at once, ask us for more)'''
*ID 333300 - 333349: Sense Africa (http://sense.africa)
*ID 333350 - 333369: Orion module
*ID 333370 - 339999: '''Free (take ranges of 10 only please at once, ask us for more)'''
*ID 340000 - 340049: M34D (https://m34d.com)
*ID 340050 - 340069: WiwIT
*ID 340070 - 340089: TAD-IT & SERVICES ([https://tadit-services.com/ https://tadit-services.com])
*ID 340090 - 349999: '''Free (take ranges of 10 only please at once, ask us for more)'''
*ID 350000 - 350049: SOUNDOU & MIDAS (https://www.soundou.org/)
*ID 350050 - 350099: Ildefonso González (https://igontek.es)
*ID 350100 - 350149: 7Kas Servicios de Internet, S.L. (https://7kas.com)
*ID 350150 - 350169: Silias (https://silias.ch)
*ID 350170 - 350999: '''Free (take ranges of 10 only please at once, ask us for more)'''
*ID 351000 - 351049: P'tite Tête (https://ptitetete.com) - France
*ID 351050 - 358999: '''Free (take ranges of 10 only please at once, ask us for more)'''
*ID 359000 - 359049: Milen Karaganski0
*ID 359050 - 398999: '''Free (take ranges of 10 only please at once, ask us for more)'''
*ID 400000 - 400999: 2byte.es (http://www.2byte.es)
*ID 401000 - 401999: B&D Informática
*ID 402000 - 402999: Marcos García de La Fuente (marcosgdf)
*ID 403000 - 403999: Sergibyte
*ID 404000 - 404999: Aikhan
*ID 405000 - 405999: AIME (http://www.aime.mx)
*ID 406000 - 406999: Som Núvol (https://somnuvol.coop)
*ID 407000 - 407019: I-Motion SARL
*ID 407020 - 407029: valitool GmbH (https://valitool.org)
*ID 407030 - 408999: '''Free (take ranges of 10 only please at once, ask us for more)'''
*ID 409000 - 409999: LliureTIC (https://www.lliuretic.cat)
*ID 410000 - 410999: DoliGov
*ID 411000 - 411049: GATTEK SARL (https://www.ga-ttek.com)
*ID 411050 - 419999: '''Free (take ranges of 10 only please at once, ask us for more)'''
*ID 420000 - 420099: BBS Concept
*ID 420100 - 420199: LeMousticProduction (www.lemousticproduction.info) -< module DoliRH
*ID 420200 - 421199: VatCheck (www.abnc.be)
*ID 421200 - 421219: Dolix (https://dolix.fr)
*ID 421220 - 422199: '''Free (take ranges of 10 only please at once, ask us for more)'''
*ID 422200 - 422999: Artaban (http://artaban.fr)
*ID 423000 - 423049: cyberesprit
*ID 423050 - 423099: R.Bossard
*ID 423100 - 423199: Joliciel (www.joliciel.fr)
*ID 423200 - 423299: Pragma-tech (www.pragma-tech.fr)
*ID 423300 - 423399: Pragma-tech (www.pragma-tech.fr)
*ID 423399 - 423999: '''Free (take ranges of 10 only please at once, ask us for more)'''
*ID 424000 - 424019: Philazerty ([https://www.philazerty.fr www.philazerty.fr])
*ID 424020 - 424039<span> </span>: Studio 3 Points ([https://www.studio3points.ch www.studio3points.ch]) - Suisse
*ID 424040 - 424049: INTECH (https://www.intech.re) - Réunion
*ID 424050 - 424099: Pragma-tech (www.pragma-tech.fr)
*ID 424100 - 424149: Ohoo Solutions (http://www.ohoosolutions.com)
*ID 424150 - 424199: DAGARCAM Informática (https://www.dagarcam.com/)
*ID 424200 - 424999: Lab51 (https://github.com/lab51org)
*ID 425000 - 425999: Sébastien SERRE Thivinfo (www.thivinfo.com)
*ID 426000 - 426099: Arkesis-Solution
*ID 426100 - 426149: GetLandy (www.getlandy.com)
*ID 426150 - 426649: OOB Software
*ID 426650 - 426849: Soft-Task Serviços e Sistemas (www.soft-task.com.br)
*ID 426850 - 426999: Bruno Caldas (https://github.com/BCaldas)
*ID 427000 - 427999: Kevin GUERRIER (alias xcl.saian)
*ID 428000 - 428099: af83
*ID 428100 - 428199: Arnaud Serrut - Adalon
*ID 428200 - 428249: imschweiler consulting (http://www.imschweiler-consulting.de'''<nowiki/>''')
*ID 428250 - 428299: AL1FO
*ID 428300 - 428349: Federico García-Patiño Barbolani (<federico.garcia.patino@gmail.com>)
*ID 428350 - 428399: INTM Groupe - France (www.intm.com)
*ID 428400 - 428449: Nick Fragoulis - Greece
*ID 428450 - 428499: Kontava - France ([https://kontava.fr kontava.fr)]
*ID 428500 - 428549: hkwhitten - USA
*ID 428550 - 428999: SmartOne
*ID 429000 - 429999: induslab
*ID 430000 - 430099: Mixity sprl (www.mixity.be)
*ID 430100 - 430199: sgiraud
*ID 430200 - 430299: Merlion TI (www.merlion-si.com.br)
*ID 430300 - 431299: Libre Expert (www.libre-expert.com)
*ID 431300 - 431399: ptibogxiv (www.ptibogxiv.net)
*ID 431400 - 431499: Befox (www.befox.fr)
*ID 431500 - 431599: rue Béjo (www.ruebejo.fr)
*ID 431600 - 431699: Avizzeo (www.avizzeo.com)
*ID 431700 - 432199: Multisistemas (www.multisistemas.com.sv)
*ID 432200 - 432399: Burbuja - Chile (www.burbuja.cl)
*ID 432400 - 433399: INOVEA CONSEIL (https://www.inovea-conseil.com)
*ID 433400 - 434399: Rachid HRICH - Maroc (HricH ServiceS.)
*ID 434400 - 435399: Lance Bleakley - LanceIT (www.lanceit.net)
*ID 435400 - 435419: Victorien LOS - France
*ID 435420 - 435439: Clément ESTREM - France
*ID 435440 - 435999: '''Free (take ranges of 10 only please at once, ask us for more)'''
*ID 436000 - 436099: SOWEBIO ([https://www.soweb.io www.soweb.io])
*ID 436100 - 436199: CAP-REL (www.cap-rel.fr)
*ID 436200 - 436300: TDE-INFORMATIQUE (www.tde-informatique.fr)
*ID 436301 - 436349: Evarisk ([https://www.evarisk.com/id-module-dolibarr/ www.evarisk.com])
*ID 436350 - 436399: Eoxia ([https://www.eoxia.com/dolibarr/modules/ www.eoxia.com])
*ID 436400 - 437399: Mohamed AHERDANE - Morocco - IT Consultant ( www.wave.ma )
*ID 437400 - 437449: Martin Neubauer - Germany
*ID 437450 - 437599: Club1click (www.club1click.es)
*ID 437600 - 437629: Coulon Vincent (https://github.com/HoverEpic)
*ID 437630 - 437649: Aytechnet (https://www.aytechnet.fr/) - François Pons
*ID 437650 - 437699: LibreMaster (https://libremaster.com) - Christophe T.
*ID 437700 - 437749: STELLAR Broadband (https://www.stellarbb.com) - U.S.A. - Philip Laycock
*ID 437750 - 437799: DIGITA.LU Ajous Solutions
*ID 437800 - 437850: iProspective (https://iprospective.fr) - Mathieu Moulin
*ID 437851 - 437900: Theobald Groupe.
*ID 437901 - 437950: Neuronnexion (http://neuronnexion.coop)
*ID 437951 - 437952: jmbc - APIA-ASSO (https://www.apia-asso.fr)
*ID 437953 - 438002: IPCZEN SARL (https://www.ipczeninformatique.fr/)
*ID 438003 - 438052: FESF IT Department (https://fesf.org.pk)
*ID 438053 - 438103: Pilot Engineering team
*ID 438104 - 438153: u2042 (https://u2042.com)
*ID 438154 - 438204: Djair E Pereira (ocultooooo@gmail.com) - Brasil
*ID 438205 - 438255: yoandm (https://yoandm.com)
*ID 438256 - 438299: PTMSoft (<nowiki>https://www.ptmsoft.fr</nowiki>)
*ID 438300 - 438399: '''Free (take ranges of 10 only please at once, ask us for more)'''
*ID 438400 - 439399: Tetras Libre - France - Développement logiciels libres (www.tetras-libre.fr)
*ID 439400 - 440399: Dolibarr-pro - France - Développement Dolibarr (www.dolibarr-pro.com)
*ID 440400 - 441399: Quidlab Co., Ltd - Thailand - ( www.quidlab.com )
*ID 441400 - 442399: Ide@log - France - (https://www.idealog-info.net) - Laurent Leblanc
*ID 442400 - 443399: Valerio Bianchi (www.valeriobianchi.com)
*ID 443400 - 444399: delassalle - France - (www.delassalle.fr) - Joseph Delassalle
*ID 444400 - 445399: Webartis - Maroc - (www.webartis.net) - François Dry
*ID 445400 - 445499: SCOP Au-delà des nuages - France
*ID 445500 - 445549: X Net Systems - Egypt - (https://www.xneteg.com)
*ID 445550 - 445569: Schiefer.IT - Austria ([https://schiefer.it schiefer.it])
*ID 445570 - 445999: '''Free (take ranges of 10 only please at once, ask us for more)'''
*ID 446000 - 446999: iouston (http://www.iouston.com) - France - Julien Marchand
*ID 447000 - 447999: rSanjoSEO - Rafael San José Tovar (www.rsanjoseo.com) - Spain
*ID 448000 - 448999: Code 42 (www.code42.fr)
*ID 449000 - 449999: TakePOS (www.takepos.com)
*ID 450000 - 450999: Pierre ARDOIN
*ID 451000 - 451999: Éditeur depordi.fr
*ID 452000 - 452999: Dylan NAKONG
*ID 453000 - 453999: Menahd Ouchenir - France - menahd-ouchenir.com
*ID 454000 - 454999: Withheld - Canada
*ID 455000 - 455999: Gaëtan MAISON - Info Libre @ Dom - France (https://www.infolibreadom.com)
*ID 456000 - 456999: Laurent LEBLEU - B.L.C. - Blue Line Company - Lille - France (www.bluelinecompany.fr/dolibarr)
*ID 457000 - 457999: Sébastien BOUCHER
*ID 458000 - 458999: Lester HERNÁNDEZ - Argentina - (freelancerlrhd@gmail.com)
*ID 459000 - 459999: Infopen - France
*ID 460000 - 460049: torvista - Spain
*ID 460050 - 460099: ADVAISION.com (Belgique www.advaision.com)
*ID 460100 - 460119: Proximatic Digital - Spain (https://www.proximatic.digital)
*ID 460120 - 460129: Karite d'Or SARL - Burkina Faso (https://dolibarr.karite-dor.com) - module RHBurkina
*ID 460130 - 460139: INTECH (<nowiki>https://www.intech.re</nowiki>) - Réunion
*ID 460140 - 460999: Free (take ranges of 10 only please at once, ask us for more)
*ID 461000 - 461999: MEGALOGI - Maroc (www.erpcloud.ma)
*ID 462000 - 462999: Making Digital (www.making-digital.fr) - France
*ID 463000 - 463999: linx s.r.l.s.
*ID 464000 - 464999: NimbleCubed Inc. (www.nimblecubed.com)
*ID 465000 - 465999: Artefacts (www.artefacts.coop) - Pascal Daugeron
*ID 466000 - 466999: CDM Consultores - (www.cdm.guru)
*ID 467000 - 467999: M71 Service GmbH - (www.m71-service.de)
*ID 468000 - 468049: Clément Segonzac - France (clement.segonzac@gmail.com)
*ID 468050 - 468099: Flavien Belli - France (https://github.com/Marshlyin || belliflaviencontactpro@gmail.com)
*ID 468100 - 468119: Chl (https://code.bugness.org/Dolibarr)
*ID 468120 - 468169: Commotron GmbH (https://www.commotron.com/)
*ID 468170 - 468219: Infans Group (franck.lauby@infans.fr)
*ID 468175 - 468199: Gaëlle Rauffet - France (kiwiscan.net)
*ID 468200 - 468249: Paulo Oliveira - Brasil (paulorcdo@gmail.com)
*ID 468250 - 468269: CD-Systems - France (https://www.cd-systems.fr)
*ID 468270 - 468299: Nicolas Testori
*ID 468300 - 468349: Uvensys - Germany (https://uvensys.de)
*ID 468350 - 468399: Laudeco - Belgium (http://github.com/laudeco)
*ID 468400 - 468449: Alexis LAURIER - France (https://www.alexislaurier.fr)
*ID 468450 - 468499: Mehdi Belkhayat - Maroc (https://opensi.ma)
*ID 468500 - 468599: InvIT GmbH - Germany (https://invit.sh)
*ID 468600 - 468649: Ricardo Sequeira - Portugal (https://ricardo-sequeira.com)
*ID 468650 - 468699: J-IT - Belgique (https://www.j-it.be)
*ID 468700 - 468749: Fidesio - France (https://www.fidesio.com/)
*ID 468750 - 468799: Sgestion - Spain (http://www.sgestion.net/)
*ID 468800 - 468849: Denis JULIEN - Brasil (matrinxa@free.fr)
*ID 468850 - 468899: Mmariko - Module GED - Effios
*ID 468900 - 468949: Maazou Amadou Abdoul aziz - Maroc (yaronfada@gmail.com)
*ID 468950 - 468999: Alexis LAURIER - France (https://www.alexislaurier.fr)
*ID 469000 - 469049: John Livingston (https://github.com/JohnXLivingston/)
*ID 469050 - 469099: Macrorom ICT-services (https://macrorom.nl/)
*ID 469100 - 469149: HABOT IT - France (https://habot.it)
*ID 469150 - 469159: CaribbeanConsult.Com CCC - France Guadeloupe (https://dolibarr.ccc.gp)
*ID 469160 - 469171: GMBG - Portugal
*ID 469172 - 469199: BGi Lda - Portugal
*ID 469200 - 469219: elsotec GmbH
*ID 469220 - 469299: MODUL DISTRIBUTION - France
*ID 469300 - 469319: Experts Conseils Chanton - Grégoire Chanton (https://www.experts-conseils.ch) - Switzerland
*ID 469320 - 469329: Experts Conseils Chanton - Grégoire Chanton (https://www.experts-conseils.ch) - Switzerland - Terrain
*ID 469330 - 469339: Experts Conseils Chanton - Grégoire Chanton (https://www.experts-conseils.ch) - Switzerland - Doli Local Edit
*ID 469340 - 469949: '''Free (take ranges of 10 only please at once, ask us for more)'''
*ID 469950 - 469999: Goldoweb (http://goldoweb.com)
*ID 470000 - 470999: Reindeer Digital (https://rdeer.cz)
*ID 471000 - 471099: CAP-REL (www.cap-rel.fr)
*ID 471100 - 471199: M. Morillon
*ID 471200 - 471209: Pablo Nuñez
*ID 471210 - 471300: FANEL A.Ş (https://www.fanel.com.tr)
*ID 471300 - 480999: '''Free (take ranges of 10 only please at once, ask us for more)'''
*ID 481000 - 481999: Alhaidab-ITIS (https://alhaidab.dolibarr.sd)
*ID 482000 - 482999: Basix IT (https://www.basix.de)
*ID 483000 - 483049: SASCO SpA (https://www.sasco.cl)
*ID 483050 - 483099: WIP Engineering (https://www.wip-gmbh.com)
*ID 483100 - 483149: J.Kaiser
*ID 483150 - 483199: CodLines (https://www.codlines.com)
*ID 483200 - 483249: BleepalSoftware (https://bleepal.com)
*ID 485000 - 485049: Gest Info Service Plus (contact@gest-plus.fr)
*ID 485050 - 485069: DJOB' Services
*ID 485070 - 485079: Arobase Pixel (https://www.arobase-pixel.fr/) - France
*ID 485080 - 485089: Graphphon_Togo (<nowiki>https://www.graphphon.com)-Togo(Afrique</nowiki> de l'Ouest)
*ID 490000 - 490049: VOLD (https://www.voldgroup.com)
*ID 490050 - 490249: QUANTIVO (http://quantivo.eu/)
*ID 490250 - 490299: VOLD (https://www.voldgroup.com)
*ID 490300 - 490309: Synezia (https://www.synezia.fr) - France
*ID 490310 - 490999: Free (take ranges of 10 only please at once, ask us for more)
*ID 491000 - 491049: NORD ERP CRM (https://www.nord-erp-crm.fr/)
*ID 491050 - 491099: KJR-online (https://kjr-online.fr/)
*ID 491100 - 491149: eNova
*ID 491150 - 491199: App 4 Business
*ID 491200 - 491249: Mil24 (http://www.mil24.com.py)
*ID 491250 - 491299: M2AM
*ID 491300 - 491349: luigifab (https://github.com/luigifab), also reuse id:105009 for Sentry fork
*ID 491350 - 491399: Frédéric France (https://github.com/frederic34)
*ID 491400 - 491449: E-dem (https://www.e-dem.com/)
*ID 491450 - 491499: Burofree (https://burofreeai.es)
*ID 491500 - 491549: EMDELEN (https://emdelen.fr/)
*ID 491550 - 491599: eSoUrCeS Technologie (https://techno.esources.ca/) - Canada
*ID 491600 - 491649: GoSouce Peru - Peru
*ID 491650 - 491669: Kaféin Studio (https://kafein.studio) - France
*ID 491670 - 491699: Neykinfo - France
*ID 491700 - 491709: Bank Match
*ID 491710 - 491719: activiert IT (https://activiert.de/) - Germany
*ID 491720 - 491729: DoliLink (https://www.dolilink.app) - France
*ID 491730 - 491739: Dolibarr User Australia (dolibarruseraustralia@gmail.com) - Australia
*ID 491740 - 491999: '''Free (take ranges of 10 only please at once, ask us for more)'''
*ID 492000 - 492020: Anura (https://www.anura.fr/)
*ID 492021 - 492030: Marino Sedda - DoLib (https://www.dolib.it) - Italy
*ID 492031 - 492940: Lucky Ranasolonirina - Madagascar
*ID 492041 - 492990:'''Free (take ranges of 10 only please at once, ask us for more)'''
*ID 492991 - 492999: bcs - Germany (sellleads.de@gmail.com)
*ID 493000 - 493020: Bourez Bastien EI (https://bastien-b.fr/)
*ID 493021 - 493040 Pluginar (https://pluginar.com.ar/) - Argentina
*ID 493051 - 493071: benhmida ilyess (bhilyess98@gmail.com)
*ID 493101 - 493120: George TS, George SP (gspanos@makeasite.gr)
*ID 493121 - 493140: BavariaPixel GbR
*ID 493150 - 493179: KSI (https://www.ksidol.io)
*ID 493180 - 493210: KSI (https://www.ksidol.io)
*ID 493200 - 493219: Stéphane Mallet (https://framagit.org/Steph501/dolibarr-mod-autoreminder)
*ID 493220 - 493239: TBNETSYS (www.tbnetsys.fr)
*ID 493240 - 493259: PEREL
*ID 493260 - 493269: Thermasse (https://www.thermasse.fr) - France
*ID 493270 - 493290: LogicMod (https://logicmod.ca) - Canada
*ID 493291 - 493310: NANAKA BUSINESS SOLUTIONS (https://www.nanaka.re) - La Réunion, France
*ID 495000 - 495009: JB SMT Informatique (https://www.jbsmt.fr)
*ID 495010 - 495029: Vankenhove Finance (https://www.vankenhovefinance.com) - France - Solaria
*ID 499001 - 499020: IT GENIUSES (https://www.itgeniuses.com)
*ID 499051 - 499071: KREATIV PROJECT MANAGEMENT
*ID 499072 - 499082: RIAS BAIXAS RENTALS (https://riasbaixasrentals.com) - Vigo, Spain
*ID 499083 - 499092: NEXTWAYS - LEBANON

DO NOT ADD RECORD HERE, PLEASE FILL HOLES FIRST !!!!
...

=ID > 500000=

This range can't be reserved. It is a common range. If you don't plan to distribute your module, you can use an ID in this range with no need to reserve it.

If you don't already have reserved ids and need some, please don't use hazardous number and use a number higher than 500000, but it is better to ask a wiki account, and reserve your own range by editing the 100000 - 499999 range (10 ids at once).

Module PackTrace

2026-09-28T03:16:12Z

Arcchester: Création de la page du module PackTrace 1.0.0 (emballages PPWR (UE) 2025/40 et REP)

== Module PackTrace ==

'''PackTrace''' est un module complémentaire pour Dolibarr ERP/CRM consacré aux '''emballages''' : il met en œuvre le '''règlement européen (UE) 2025/40 relatif aux emballages et aux déchets d'emballages''' (PPWR), applicable depuis le 12 août 2026, et prépare les déclarations de '''responsabilité élargie du producteur''' (REP) en France (Citeo, Léko, emballages professionnels EPRO) et en Allemagne (registre LUCID, loi VerpackDG).

À partir de la composition d'emballage de chaque produit, le module calcule les poids mis sur le marché par matériau, par pays et par canal depuis les factures ou les expéditions, produit les fichiers de déclaration et génère la déclaration UE de conformité de chaque emballage.

{| class="wikitable"
|-
! Éditeur || arcchester
|-
! Licence || GPL v3
|-
! Compatibilité Dolibarr || 18.0 à 24.x (vérifiée sur 18.0.5, 20.0.4 et 24.0.0)
|-
! PHP || 7.4 à 8.3 (extension DOM pour l'export XML)
|-
! Dépendances || Aucune : tout s'exécute sur le serveur Dolibarr, aucun appel sortant
|-
! Langues || Français, anglais ; déclaration de conformité aussi en allemand
|}

== Qui est concerné, et ce que fait le module ==

{| class="wikitable"
|-
! Profil !! Obligation !! Réponse du module
|-
| Marque ou fabricant (vente en ligne, épicerie fine, cosmétique, vins, artisanat…) || Déclarer chaque année les emballages mis sur le marché (Citeo ou Léko ; EPRO à partir de 2027 ; LUCID pour l'Allemagne) ; déclaration UE de conformité || Composition d'emballage par produit, calcul automatique, fichiers de déclaration, PDF de conformité
|-
| Importateur || Mêmes obligations pour les emballages en provenance de pays tiers || Idem, rôle « importateur »
|-
| Distributeur || Vérifier l'inscription du producteur au registre (article 19) ; déclarer les emballages ajoutés, dont les colis || Numéros REP des fournisseurs et rappel sur leurs fiches, profils d'emballages d'expédition
|}

== Fonctionnalités ==

=== Catalogue d'emballages et composition des produits ===
* '''Éléments d'emballage''' décrits une seule fois : matériau parmi 30, rattaché automatiquement aux 22 catégories du tableau 1 de l'annexe II du PPWR, aux codes matériaux Citeo et Léko, aux 6 matériaux EPRO et aux codes matériaux LUCID ; poids, niveau (primaire, secondaire, tertiaire), type (vente, groupé, transport, service, e-commerce).
* Données PPWR : part de matière recyclée, classe de recyclabilité A/B/C, métaux lourds, PFAS pour le contact alimentaire, réemploi, fournisseur, emballage déjà déclaré en amont ; contrôle de complétude.
* '''Onglet Emballages''' sur la fiche produit : quantité par unité vendue, création rapide, copie depuis un produit similaire, poids et part recyclée calculés ; '''encart''' sur la fiche produit.
* Liste des '''produits vendus sans emballage''' sur les 12 derniers mois.

=== Calcul des déclarations ===
* Source : '''factures''' validées (avoirs déduits en option, factures abandonnées et brouillons exclus) ou '''expéditions''' validées.
* '''Pays de mise sur le marché''' : pays du contact de livraison du document, sinon celui du client.
* '''Canal''' ménager ou professionnel : réglage du produit, sinon type de tiers (« Particulier » = ménager), sinon réglage par défaut.
* Périmètre de chaque filière appliqué : l'emballage de transport ne va jamais chez Citeo ou Léko ; l'emballage de transport des ventes aux particuliers relève de la REP professionnelle.
* '''Emballages d'expédition''' (carton, calage, adhésif) ajoutés à chaque envoi, par mode d'expédition, ou à chaque facture si les expéditions ne sont pas utilisées.

=== Filières et exports ===
* '''Citeo''' et '''Léko''' (emballages ménagers) : poids par code matériau et '''fichier par UVC''' au format de la déclaration.
* '''EPRO''' (emballages professionnels, à partir du 1er janvier 2027) : poids par matériau.
* '''LUCID''' (Allemagne) : '''Datenmeldung XML''' conforme au guide ZSVR 1.3 (types HPM1, HMM1, HJM1, HNM1, HAM1 ; 14 systèmes duaux ; carton à boisson 68000 à partir de 2027).
* '''Registre PPWR''' de tout État membre (article 44, annexe IX) : 22 catégories, et déclaration simplifiée sous 10 tonnes.
* '''Barèmes''' 2026 Citeo et Léko embarqués, éditables par année ; contribution estimée au kilogramme et à l'unité.
* Cycle de vie : brouillon recalculable, validation refusée tant qu'un produit vendu n'a pas d'emballage (forçage tracé), dépôt avec référence, réouverture, historique.

=== Déclaration de conformité et enregistrements ===
* '''Déclaration UE de conformité''' au format de l'annexe VIII (procédure du module A, annexe VII) générée en PDF, en français, anglais ou allemand.
* '''Enregistrements REP''' de la société : IDU français (01 ménager, 02 professionnel) et numéro LUCID contrôlés au format, imprimés sur les PDF de devis, commandes, expéditions et factures (ajoutés au moment de la génération, sans modifier la note enregistrée).
* Enregistrements des '''fournisseurs''' dans l'onglet « REP emballages » du tiers, et encart sur les commandes, réceptions et factures fournisseurs.

=== Pilotage ===
* '''Tableau de bord''' : prochaine échéance réglementaire, indicateurs, feuille de route, pays de vente sans enregistrement valide, activité récente.
* Page ''À propos'' avec diagnostic de l'installation et textes de référence.

== Installation ==

# Décompresser l'archive pour obtenir le dossier <code>packtrace/</code> et le copier dans <code>htdocs/custom/</code> — ou installer le zip depuis ''Accueil → Configuration → Modules/Applications → Déployer/installer un module externe''.
# Activer '''PackTrace''' (famille « Produits »).

== Configuration ==

Menu ''Emballages → Configuration'' :

* '''Rôle''' de la société : fabricant ou marque, importateur, distributeur.
* '''Source des quantités''' (factures ou expéditions), '''canal par défaut''', déduction des avoirs, emballages d'expédition comptés à chaque facture, impression des numéros REP sur les PDF.
* Rubriques de la '''déclaration de conformité''' : signataire, mandataire, autres actes de l'Union, normes appliquées.

== Utilisation ==

# ''Emballages → Enregistrements'' : saisir les IDU et le numéro LUCID.
# ''Emballages → Catalogue d'emballages'' : décrire les éléments (ou les créer depuis l'onglet Emballages d'un produit).
# ''Emballages → Compositions produits'' : compléter les produits « vendus sans emballage ».
# ''Emballages → Déclarations REP'' : choisir le pays, la filière et la période, calculer, contrôler les alertes, valider, télécharger le fichier, puis marquer la déclaration déposée avec sa référence.
# Sur la fiche d'un élément : générer et signer la déclaration de conformité.

== État de la version 1.0.0 ==

Version initiale couverte par 224 contrôles automatisés exécutés sur Dolibarr 18.0.5, 20.0.4 et 24.0.0 : activation, règles (référentiels, correspondances, formats, exports, déclaration de conformité), calcul sur de vrais documents (factures, avoirs, expéditions, contact de livraison, canaux, profils d'expédition) et rendu HTTP de tous les écrans avec invariants de sécurité. Les actes d'exécution du PPWR (format du registre, étiquetage harmonisé) n'étant pas encore adoptés, les exports du registre suivent l'annexe IX et seront alignés dès leur publication.

PackTrace prépare les déclarations ; il ne remplace ni le portail de l'éco-organisme ni un conseil juridique.

== Historique des versions ==

{| class="wikitable"
|-
! Version !! Apports principaux
|-
| 1.0.0 || Version initiale : catalogue d'emballages PPWR, composition des produits, calcul depuis factures ou expéditions, déclarations Citeo, Léko, EPRO, LUCID (XML) et registre PPWR, barèmes 2026, déclaration UE de conformité (FR/EN/DE), enregistrements REP et mention sur les PDF
|}

== Support ==

* Contact : support@arcchester.com
* Autres modules du même éditeur : [https://www.dolistore.com/recherche?controller=search&search_query=arcchester recherche « arcchester » sur le Dolistore]

[[Category:Modules complémentaires]]

Module EUDR Trace

2026-09-28T00:50:14Z

Arcchester: Création de la page du module EUDR Trace 1.0.0

== Module EUDR Trace ==

'''EUDR Trace''' est un module complémentaire pour Dolibarr ERP/CRM qui met en œuvre le '''règlement européen anti-déforestation (UE) 2023/1115''' (EUDR), tel que modifié par le règlement (UE) 2025/2650. Il couvre tous les acteurs de la chaîne : le '''registre « collecter et conserver »''' des négociants et opérateurs en aval, et les '''déclarations de diligence raisonnée (DDS)''' et '''déclarations simplifiées (SD)''' des importateurs, exportateurs et producteurs, transmises par l''''API V3''' officielle du système d'information EUDR (TRACES).

Produits concernés : bovins, cacao, café, palmier à huile, caoutchouc, soja, bois et leurs dérivés listés à l'annexe I du règlement (meubles, papier, chocolat, cuir…). Dates d'application : '''30 décembre 2026''' pour les grandes et moyennes entreprises, '''30 juin 2027''' pour les micro et petites entreprises.

{| class="wikitable"
|-
! Éditeur || arcchester
|-
! Licence || GPL v3
|-
! Compatibilité Dolibarr || 18.0 à 24.x (vérifiée sur 18.0.5, 20.0.4 et 24.0.0)
|-
! PHP || 7.4 à 8.3 (extensions DOM, cURL, OpenSSL)
|-
! Dépendances || Aucune : tout s'exécute sur le serveur Dolibarr
|-
! Langues || Français, anglais
|}

== Qui est concerné, et ce que fait le module ==

{| class="wikitable"
|-
! Profil !! Obligation !! Réponse du module
|-
| Opérateur en aval, commerçant (négoce, menuiserie, torréfaction, chocolaterie, distribution) || Collecter et conserver 5 ans les numéros de référence reçus, l'identité des fournisseurs et des clients (art. 5) || Onglet EUDR sur les documents, propagation automatique aux documents clients, impression sur les PDF, registre exportable
|-
| Opérateur (importation, exportation, première mise sur le marché) || Déclaration de diligence raisonnée avant chaque mise sur le marché || DDS préparée depuis une commande fournisseur, parcelles GeoJSON, évaluation du risque, transmission et suivi par l'API V3
|-
| Micro ou petit producteur primaire établi dans un pays à faible risque || Déclaration simplifiée unique (art. 4a) || SD avec géolocalisation, adresse postale ou référence cadastrale
|-
| Mandataire || Déclarer pour le compte d'autrui || Rôles « mandataire d'opérateur » et « mandataire de micro-producteur », opérateur représenté
|}

== Fonctionnalités ==

=== Registre « collecter et conserver » ===
* '''Onglet EUDR''' sur les commandes et factures fournisseurs, les réceptions, les commandes clients, les expéditions, les factures et les produits, et '''encart''' de couverture sur chaque fiche.
* Numéro de référence (14 caractères, préfixe « S » pour une déclaration simplifiée) et numéro de vérification '''contrôlés au format officiel''' ; numéro de secours délivré par la douane accepté.
* '''Transmission automatique''' : à la validation d'une commande, d'une expédition ou d'une facture client, la référence amont la plus récente de chaque produit concerné est rattachée au document.
* '''Impression sur les PDF''' de commande, d'expédition et de facture (ajoutée à la note publique au moment de la génération, sans modifier la note enregistrée).
* Option de '''blocage''' : refus de valider un document client contenant un produit concerné sans référence.
* '''Registre''' filtrable et '''exportable en CSV''' avec l'identité complète des fournisseurs et des clients ; suppressions tracées ; piste d'audit jamais purgée.

=== Produits ===
* Détection automatique des produits concernés à partir de leur '''nomenclature douanière''' (champ natif « Code douane »), selon l'annexe I.
* Classement en masse (matière première, code SH, essences pour le bois) ; signalement des positions dont le retrait de l'annexe est proposé.

=== Déclarations DDS et simplifiées — API V3 ===
* Services officiels <code>EUDRDueDiligenceStatementServiceV3</code> et <code>EUDRSimplifiedDeclarationServiceV3</code>, authentification WS-Security (UsernameToken, PasswordDigest), en-tête BodyIdentity pour les comptes multi-opérateurs.
* '''DDS préparée en un clic''' depuis une commande fournisseur, une réception ou une facture fournisseur : marchandises, codes SH, poids nets calculés depuis le poids des produits, essences, parcelles du fournisseur ; importation détectée pour un fournisseur hors UE.
* '''Contrôles avant envoi (fail-closed)''' : règles de validation publiées par la Commission et '''schémas XSD officiels V3 embarqués'''. Rien n'est envoyé tant qu'un contrôle échoue.
* Transmission, '''relève automatique''' du numéro de référence et du numéro de vérification (tâche planifiée respectant les limites d'appel du système), '''modification et retrait dans les 72 heures''', regroupement de déclarations.
* Pièces XML échangées archivées (condensat d'authentification masqué) et historique par déclaration.

=== Parcelles et risque ===
* Import de fichier GeoJSON, collage ou simple point GPS ; adresse postale ou référence cadastrale pour les déclarations simplifiées.
* Contrôles hors ligne des erreurs listées par la Commission : polygone ouvert, troué ou dont les côtés se croisent, points dupliqués après troncature à 6 décimales, parcelle de plus de 4 ha décrite par un point (sauf bovins), propriétés mal orthographiées, fichier de plus de 25 Mo… Surface calculée et aperçu cartographique sans service externe.
* '''Classement des pays''' du règlement d'exécution (UE) 2025/1093 embarqué (140 pays à faible risque, 4 à risque élevé), surchargeable pays par pays pour suivre une révision de la liste.
* Niveau de risque de chaque déclaration calculé à partir des pays de production ; diligence simplifiée reconnue lorsque tous les pays sont à faible risque ; évaluation et conclusion exigées sinon.

=== Pilotage ===
* '''Tableau de bord''' avec compte à rebours jusqu'à la date d'application, indicateurs, feuille de route adaptée au profil et liste des documents à compléter.
* Page ''À propos'' avec diagnostic de l'installation.

== Installation ==

# Décompresser l'archive pour obtenir le dossier <code>eudrtrace/</code> et le copier dans <code>htdocs/custom/</code> — ou installer le zip depuis ''Accueil → Configuration → Modules/Applications → Déployer/installer un module externe''.
# Activer '''EUDR Trace''' (famille « Produits »).

== Configuration ==

Menu ''EUDR → Configuration'' (ou ''Configuration → Modules → EUDR Trace'') :

* '''Profil''' : opérateur en aval, commerçant, opérateur, micro ou petit producteur primaire, mandataire ; '''taille''' de l'entreprise ; '''numéro EORI''' (en France, repris du 5e identifiant professionnel de la société).
* '''Système d'information EUDR''' (opérateurs, producteurs et mandataires seulement) : environnement d'acceptation ou de production, utilisateur EU Login, clé d'authentification (chiffrée en base), WebServiceClientId, Operator Access Identifier si le compte gère plusieurs opérateurs. Bouton '''« Tester la connexion »'''.
* '''Transmission en aval''' : rattachement automatique des références, impression sur les PDF, blocage de la validation sans référence, géolocalisation confidentielle par défaut.

=== Obtenir les identifiants du système d'information ===

# Créer un compte EU Login, puis l'opérateur de la société dans le système d'information EUDR (TRACES).
# Dans le profil de l'utilisateur, section « Web Services Access », activer l'accès et relever la clé d'authentification.
# Tester d'abord dans l'environnement d'acceptation, puis refaire la démarche en production.

== Utilisation ==

# ''EUDR → Produits concernés'' : confirmer le classement proposé à partir des codes douaniers.
# Sur une commande fournisseur ou une réception, onglet '''EUDR''' : saisir le numéro de référence et le numéro de vérification communiqués par le fournisseur.
# Valider les commandes, expéditions et factures clients : les références sont rattachées et imprimées automatiquement ; l'encart de la fiche signale les produits sans référence.
# Opérateurs : ''Préparer une DDS depuis ce document'', rattacher les parcelles, documenter l'évaluation du risque, '''Valider''' puis '''Transmettre'''. Les numéros attribués apparaissent sur la déclaration et sont transmis aux clients.
# ''EUDR → Registre des références'' : consulter et exporter le registre à conserver 5 ans.

== État de la version 1.0.0 ==

Version initiale couverte par 331 contrôles automatisés exécutés sur Dolibarr 18.0.5, 20.0.4 et 24.0.0 : activation, règles GeoJSON (exemples et erreurs officiels de la Commission), cycle complet des déclarations contre un simulateur strict du système d'information (authentification, horodatage et schéma XSD vérifiés), registre sur de vrais documents (commandes, factures, avoirs, PDF), et rendu HTTP de tous les écrans. La transmission réelle au système d'information demande les identifiants de l'opérateur.

EUDR Trace est un outil de gestion : il ne remplace ni l'analyse juridique de la situation de l'entreprise ni la diligence raisonnée elle-même.

== Historique des versions ==

{| class="wikitable"
|-
! Version !! Apports principaux
|-
| 1.0.0 || Version initiale : registre « collecter et conserver », propagation aux documents clients et aux PDF, classement des produits (annexe I), parcelles GeoJSON contrôlées, classement des pays 2025/1093, déclarations DDS et SD via l'API V3 (transmission, relève, modification et retrait sous 72 h, regroupement), FR/EN
|}

== Support ==

* Contact : support@arcchester.com
* Autres modules du même éditeur : [https://www.dolistore.com/recherche?controller=search&search_query=arcchester recherche « arcchester » sur le Dolistore]

[[Category:Modules complémentaires]]

Module DoliBank Match

2026-09-25T13:23:24Z

Arcchester: Version 1.5.0 : salaires, charges et notes de frais, alerte anti-fraude IBAN, Mode Express repensé, compatibilité validée 18/20/24

== Module DoliBank Match ==

'''DoliBank Match''' est un module complémentaire pour Dolibarr ERP/CRM de '''rapprochement bancaire explicable'''. Il importe les relevés bancaires dans tous les formats courants, propose des correspondances avec les factures clients et fournisseurs, les salaires, les charges sociales et les notes de frais '''en justifiant chaque proposition''', et ne comptabilise rien sans validation humaine explicite.

{| class="wikitable"
|-
! Éditeur || arcchester
|-
! Licence || GPL v3
|-
! Compatibilité Dolibarr || 18.0 à 24.x (validé sur 18.0.5, 20.0.4 et 24.0.0)
|-
! PHP || 7.4 minimum
|-
! Prérequis || Module Banque / Caisse actif ; MySQL ou MariaDB
|-
! Dépendances || Aucune — les règlements sont écrits par les classes natives de Dolibarr
|-
! Distribution || [https://www.dolistore.com/product.php?id=3319 Fiche sur le Dolistore]
|}

== Fonctionnalités ==

=== Import de relevés ===

* Formats acceptés : '''CSV/TXT, OFX 1 et 2, QIF, ISO 20022 CAMT.052/.053/.054, MT940/STA et CODA 2.x'''.
* '''Prévisualisation avant import''' : le fichier est analysé, stocké côté serveur et rattaché à l'entité, à l'utilisateur et au compte bancaire ; rien n'est écrit tant que l'import n'est pas confirmé.
* '''Imports immuables''' et détection de doublons par empreinte SHA-256 : réimporter le même fichier ne crée jamais de doublon.
* '''Rapport des lignes rejetées''' : aucune ligne n'est perdue silencieusement.

Pour un fichier CSV, seules trois informations sont obligatoires : une date d'opération, un libellé, et soit une colonne de montant, soit deux colonnes débit et crédit. Les colonnes facultatives (devise, date de valeur, identifiant, référence, contrepartie, IBAN) sont reconnues sous leurs noms français et anglais usuels.

=== Rapprochement explicable ===

* Candidats proposés parmi les '''factures clients et fournisseurs''', les avoirs et les acomptes, les '''salaires''', les '''charges sociales et fiscales''' et les '''notes de frais''' (ces trois familles uniquement face aux débits, chacune désactivable), chaque proposition affichant '''les éléments de preuve qui l'ont produite'''.
* Preuves prises en compte : montant, date, référence fournisseur, '''références structurées belges OGM/VCS''', '''ISO 11649 RF''', et IBAN validé du tiers.
* Le '''montant exact ne suffit jamais''' à lui seul à déclencher une proposition — garde-fou volontaire contre les faux rapprochements.
* '''Règlement multi-factures''' : un virement affecté à plusieurs factures du même tiers ; '''paiements partiels''' pris en charge.
* '''Frais bancaires''' enregistrés via <code>PaymentVarious</code>, '''virements internes''' proposés et écritures croisées.
* '''Versements de plateformes''' Stripe, PayPal et Shopify Payments normalisés, avec contrôle brut / frais / remboursements / net.
* '''Alerte anti-fraude IBAN''' : un paiement fournisseur qui part vers un IBAN différent de ceux enregistrés pour ce fournisseur est signalé en rouge et ramené sous le seuil de forte confiance.
* '''Règles réutilisables''' et apprentissage IBAN — les règles '''proposent''', elles ne comptabilisent jamais d'elles-mêmes ; l'apprentissage n'a lieu qu'après validation humaine.

=== Sécurité de la comptabilisation ===

La comptabilisation native est '''désactivée par défaut''' et exige trois conditions simultanées : la permission de rapprochement, une décision explicitement validée, et la permission dédiée de comptabilisation accompagnée du réglage correspondant du module. S'y ajoutent la protection contre les doubles comptabilisations, contre les validations concurrentes et contre les sur-allocations cumulées, l'idempotence des décisions, un état d'erreur de comptabilisation explicitement non rejouable, et une '''piste d'audit en ajout seul'''.

=== Interface ===

Tableau de bord (taux de rapprochement, temps économisé, garde-fous actifs), boîte d'opérations avec filtres avancés et indices colorés, '''Mode Express''' au clavier (→ valider, ← ignorer, ↓ passer ; un virement multi-factures se valide d'un coup), écran de rapprochement détaillé, règles, versements de plateformes, connecteurs, bordereau imprimable et export CSV comptable, page de diagnostic et widget d'accueil. Interface et documentation en français et en anglais.

== Installation ==

# Télécharger le zip <code>module_dolibankmatch-x.y.z.zip</code> depuis le Dolistore.
# Dans Dolibarr : ''Accueil → Configuration → Modules/Applications → Déployer/installer un module externe''.
# Activer '''DoliBank Match''' (famille « Finance / Facturation »).
# Configurer un compte bancaire par défaut et les seuils de score.
# Attribuer les droits d'import et de rapprochement aux utilisateurs concernés.
# N'accorder la permission de comptabilisation qu'aux comptables autorisés, et n'activer la comptabilisation native qu'après un essai sur une copie de recette.

En cas de mise à jour, désactiver puis réactiver le module pendant une fenêtre de maintenance afin que Dolibarr enregistre les nouvelles tables, les menus, la tâche planifiée, le widget et les permissions. '''La désactivation ne supprime pas les tables du module.'''

== Utilisation ==

# Importer un relevé et contrôler la prévisualisation avant de confirmer.
# Parcourir les propositions : chacune indique le score et les preuves retenues.
# Valider les décisions ; la comptabilisation native n'intervient qu'ensuite, et seulement si elle a été explicitement autorisée.
# Les règles permettent d'automatiser la ''proposition'' des cas récurrents, jamais leur écriture.

== Périmètre des connecteurs ==

La couche Open Banking intégrée est livrée avec un connecteur bac à sable déterministe, pour les essais. Pour une '''connexion bancaire réelle''' (Qonto, open banking européen), voir le module complémentaire [[Module DoliBank Sync|DoliBank Sync]], qui alimente le moteur de rapprochement de DoliBank Match.

Les versements Stripe, PayPal et Shopify Payments acceptent aujourd'hui un JSON normalisé et relient les lignes de versement aux paiements Dolibarr par identifiant externe ; les clients d'API et webhooks temps réel de ces plateformes constituent le jalon suivant.

== Historique des versions ==

{| class="wikitable"
|-
! Version !! Apports principaux
|-
| 1.5.0 || Interface redessinée ; salaires, charges sociales et notes de frais proposés et réglés nativement ; alerte anti-fraude IBAN ; Mode Express repensé (multi-factures en une validation) ; bordereau et export CSV traduits ; diagnostic ; correction de la détection CODA sur les CSV à lignes longues et des réglages sans effet
|-
| 1.4.0 || Suivi des fusions de tiers ; widget ROI corrigé ; libellés traduits
|-
| 1.3.1 || Correction d'une collision d'identifiants de module et de permissions avec DoliTax ; restauration de l'accès au tableau de bord, à l'import et à la comptabilisation lorsque les deux modules sont activés
|-
| 0.3.0 || Prévisualisation avant import et rapport des rejets ; formats OFX, QIF, CAMT, MT940, CODA ; cycle brouillon → validation → comptabilisation native ; règlements multi-factures, partiels, avoirs et acomptes ; frais bancaires et virements internes ; protections anti-doublon et anti-sur-allocation ; règles et apprentissage IBAN ; interface Open Banking et connecteur bac à sable ; versements Stripe / PayPal / Shopify Payments
|-
| 0.2.0 || Références structurées OGM/VCS et ISO 11649 RF ; référence fournisseur et IBAN dans le moteur de score ; filtres avancés ; ignorance et restauration en masse, réversibles et auditées
|-
| 0.1.0 || Premier socle : import CSV, normalisation, détection de doublons, propositions explicables, tableau de bord, permissions, audit, FR/EN
|}

== Support ==

* Contact : support@arcchester.com
* Autres modules du même éditeur : [https://www.dolistore.com/recherche?controller=search&search_query=arcchester recherche « arcchester » sur le Dolistore]

[[Category:Modules complémentaires]]

Module Shopify Sync

2026-09-24T14:09:33Z

Arcchester: Version 1.8.1 : publication des produits à variantes, suivi facultatif du statut en vente, prérequis API et droits, guide de recette et mise à jour.

== Module Shopify Sync ==

'''Shopify Sync''' est un module complémentaire pour Dolibarr ERP/CRM qui assure une '''synchronisation bidirectionnelle quasi temps réel entre Shopify et Dolibarr''' : commandes, clients, remboursements, produits et variantes, stock et expéditions. Le module dialogue directement avec l'API '''GraphQL Admin''' de Shopify : sans SaaS intermédiaire, sans abonnement supplémentaire.

{| class="wikitable"
|-
! Éditeur || arcchester
|-
! Version || 1.8.1
|-
! Licence || GPL v3
|-
! Compatibilité Dolibarr || 18.0 à 24.x (validé sur 18.0.5, 20.0.4 et 24.0.0)
|-
! PHP || 7.4 minimum (extension cURL), validé jusqu'à 8.2
|-
! Dépendances || Aucune (cURL pur : pas de Composer, pas de SDK)
|-
! Version d'API Shopify || 2026-01 par défaut, configurable ; appels vérifiés sur 2025-07, 2025-10, 2026-01, 2026-04, 2026-07 et unstable
|-
! Distribution || [https://www.dolistore.com/product.php?id=3218 Fiche sur le Dolistore]
|}

La fréquence effective dépend des tâches planifiées, de l’hébergement et des limites de l’API Shopify. Une boutique Shopify est configurée par entité Dolibarr.

== Fonctionnalités ==

* '''Commandes''' Shopify → Dolibarr : client (ou client invité), commande à la date de la vente, lignes reliées aux fiches produits, remises, '''frais de port''', contact de livraison si l'adresse diffère ; '''facture''' dès que la commande est payée, même après son import.
* '''Prix TTC ou HT''' : le module lit le réglage « taxes incluses » de la boutique, les montants importés correspondent à ce que le client a payé.
* '''Annulations''' Shopify répercutées sur la commande Dolibarr.
* '''Remboursements''' → avoirs Dolibarr : partiel (montant réellement rendu) ou total (avoir miroir ligne à ligne).
* '''Expéditions''' Dolibarr → Shopify : articles et quantités expédiés, numéro de suivi et transporteur ; expéditions partielles gérées. En option, l'inverse : une étiquette imprimée dans Shopify crée et valide l'expédition Dolibarr.
* '''Produits''' dans les deux sens, avec une '''source de vérité configurable''' (produits, prix, stock).
* '''Catalogue existant''' : rattachement par SKU des variantes Shopify aux fiches Dolibarr existantes, sans produit parent ni module Variants.
* '''Produits à variantes''' (module Variants) : les attributs Dolibarr deviennent des options Shopify, une variante par combinaison. Limites de la boutique lues à l'exécution (2 048 variantes, 3 options).
* '''Stock multi-emplacements''' : table « entrepôts Dolibarr = emplacement Shopify », ou un emplacement unique alimenté par les entrepôts choisis.
* '''Metafields''' : attributs supplémentaires et champs standards (poids, dimensions, volume) publiés vers Shopify, avec conversion de type et d'unité.
* '''Catégories, images, poids''' : collections et tags Shopify, menu de navigation, images des fiches, poids d'expédition (options).
* '''Webhooks signés HMAC''' pour le quasi temps réel, doublés d'une '''réconciliation planifiée''' qui rattrape commandes, paiements, annulations et remboursements manqués.
* '''File d'attente asynchrone''' : limites de débit de l'API absorbées, nouvelles tentatives sûres, aucun job traité deux fois.
* '''Anti-boucle''' par empreinte d'état, et '''résolution de conflits''' configurable.
* '''Tableau de bord''' : file d'attente, échecs, journal ; traiter la file maintenant, relancer les échecs, rattraper les commandes des N derniers jours.
* '''Encart « État Shopify »''' sur les fiches produit et commande, avec bouton « Synchroniser ».
* Bouton '''« Tester la connexion »''' : contrôles de configuration, droits, emplacements, webhooks et tâches planifiées, chacun avec le correctif suggéré.
* '''Diagnostic opérationnel''' : état de connexion et du planificateur, suivi par flux, causes et conseils, historique, relances ciblées et export de diagnostic sans secrets (depuis la 1.6.0).
* '''Assistant de configuration initiale''' : six étapes pour relier Shopify, choisir le catalogue, vérifier les SKU, associer les entrepôts et préparer un premier lot avec aperçu (depuis la 1.7.0).
* '''Sélection du catalogue''' : plusieurs branches autorisées, exclusions prioritaires et aperçu complet sans synchroniser (1.8.0, facultatif).
* '''Validation des produits''' : condition par champ booléen, contrôlée avant mise en file et au traitement (1.8.0, facultatif).
* '''Ordre des photos''' : reprise des positions Dolibarr et réordonnancement des médias existants, sans renvoyer les images inchangées (1.8.0, facultatif).
* Interface du module en français et en anglais.

== Ce qui est synchronisé, flux par flux ==

Chaque flux s'active ou se coupe indépendamment dans la configuration (carte « Flux synchronisés »).

=== Commandes (Shopify → Dolibarr) ===

{| class="wikitable"
|-
! Événement Shopify !! Effet dans Dolibarr
|-
| Commande créée || Tiers retrouvé par e-mail (sinon créé, avec l'adresse de facturation et le pays) ; commande datée du jour de la vente, référence client = numéro Shopify ; une ligne par article, reliée à la fiche par la variante ou le SKU ; remises ; ligne « Frais de port » ; contact de livraison si l'adresse diffère. La commande reste en '''brouillon''' (validation automatique en option).
|-
| Commande payée (tout de suite ou plus tard) || Facture créée depuis la commande et validée ; règlement enregistré en option (mode de paiement et compte bancaire au choix).
|-
| Commande annulée || Commande Dolibarr annulée, sauf si une expédition est déjà en cours.
|-
| Commande de test (passerelle de test Shopify) || Importée et signalée comme telle ; peut être ignorée par option.
|}

Un tiers existant n'est jamais renommé par une commande : seuls les champs vides sont complétés.

Ventes sans client (caisse Shopify POS, commandes anonymes) : portées par un seul tiers, choisi dans la configuration, ou « Client comptoir (Shopify) » créé automatiquement. Le code client est attribué par la numérotation Dolibarr, y compris quand il est obligatoire.

=== Clients (dans les deux sens) ===

* Shopify → Dolibarr : un client créé ou modifié met à jour son tiers (nom, e-mail, adresse, téléphone, pays, province). Une raison sociale Shopify devient le nom du tiers.
* Dolibarr → Shopify : un tiers client créé ou modifié est publié (prénom, nom, e-mail, téléphone). Un tiers sans e-mail ni téléphone n'est pas publié (exigence Shopify).
* Client supprimé sur Shopify : le lien est retiré, le tiers Dolibarr est conservé.

=== Produits (dans les deux sens) ===

{| class="wikitable"
|-
! Sens !! Création !! Modification
|-
| Dolibarr → Shopify (source de vérité produits = Dolibarr) || Produit Shopify avec titre, description, prix, SKU (= référence), code-barres, suivi de stock, statut actif si la fiche est en vente, sinon brouillon. Publication sur la Boutique en ligne en option. || Titre, description et metafields. Prix, SKU et code-barres seulement si l'option « Réaligner prix, SKU et code-barres » est cochée ; statut seulement si « Suivre en vente » est cochée.
|-
| Shopify → Dolibarr || Fiche Dolibarr (référence = SKU, libellé, prix, code-barres, statut) ; une fiche par variante pour un produit à plusieurs variantes. Si le SKU correspond à une référence existante, la fiche est '''rattachée''' sans être modifiée. || Libellé. Prix seulement si Shopify est source de vérité des prix ; statut et code-barres seulement si Shopify est source de vérité des produits.
|}

* Produit supprimé sur Shopify : liens retirés, fiche Dolibarr conservée, jamais recréée d'office (un export manuel peut la recréer si les flux, la source et les conditions de publication l’autorisent).
* Fiche rattachée par SKU : utilisée pour les commandes et le stock ; son titre, sa description et son prix ne sont jamais réécrits.
* Prix envoyé à Shopify : HT de la fiche par défaut (fonctionnement historique), ou TTC si la boutique est en TTC (option « selon la boutique »).

=== Catégories, images et champs produit (Dolibarr → Shopify, options) ===

* '''Catégories''' : chaque catégorie produit devient une '''collection''' Shopify, un '''tag''', ou les deux. Le produit rejoint et quitte les collections selon ses catégories ; une collection parente peut contenir les produits de ses sous-catégories ; une catégorie renommée ou supprimée entraîne sa collection.
* '''Menu de navigation''' construit sur l'arborescence, jusqu'à 3 niveaux (limite Shopify), reconstruit seulement quand l'arborescence change. Droits <code>read_online_store_navigation</code> et <code>write_online_store_navigation</code>.
* '''Images''' de l'onglet « Fichiers joints » envoyées dans les médias du produit : ajout, remplacement quand le fichier change, retrait quand il disparaît, sans doublon.
* '''Metafields''' : un attribut supplémentaire ''ou'' un champ standard (<code>@weight</code>, <code>@length</code>, <code>@width</code>, <code>@height</code>, <code>@surface</code>, <code>@volume</code>) publié avec conversion de type et d'unité (texte riche, poids, dimension, volume, nombres, dates, listes). Une valeur vidée efface le metafield ; une valeur refusée par Shopify n'empêche pas les autres et le job apparaît en échec.
* '''Poids d'expédition''' : le poids Dolibarr publié sur la variante Shopify, pour le calcul des frais de port.
* '''Produit supprimé dans Dolibarr''' : passé en brouillon ou archivé sur Shopify, jamais supprimé.

Le module ne touche qu'à ce qu'il a créé : une collection, un tag ou une image ajoutés à la main sur Shopify ne sont jamais retirés.

=== Stock (sens selon la source de vérité) ===

* Source de vérité '''Dolibarr''' : chaque mouvement de stock publie la quantité des entrepôts choisis sur l'emplacement Shopify correspondant (écriture « comparer puis écrire », conforme aux API 2026-04 et suivantes). Les niveaux Shopify sont ignorés : l'expédition Dolibarr sortira le stock vendu.
* Source de vérité '''Shopify''' : un niveau modifié sur Shopify ajuste l'entrepôt Dolibarr associé à l'emplacement.
* Quantité échangée : physique publiée par défaut ; « Physique » dans les deux sens, ou « Disponible » si Dolibarr décrémente le stock dès la validation de commande (le diagnostic le suggère).

=== Expéditions (Dolibarr → Shopify) ===

* À la validation d'une expédition liée à une commande Shopify, la commande passe « expédiée » sur Shopify pour les articles et quantités réellement expédiés (expéditions partielles comprises).
* Numéro de suivi et transporteur (d'après le mode d'expédition) transmis ; Shopify envoie au client son e-mail d'expédition (désactivable).
* Une expédition n'est jamais déclarée deux fois ; les expéditions de commandes qui ne viennent pas de Shopify sont ignorées.
* Le stock d'un article expédié est publié après la déclaration de l'expédition, pour que Shopify ne le décompte pas deux fois.

=== Étiquettes imprimées dans Shopify (Shopify → Dolibarr, option) ===

Pour les boutiques qui impriment leurs étiquettes dans Shopify (Chronopost, Colissimo, Shopify Shipping) tout en gardant Dolibarr seul maître du stock, par exemple un entrepôt partagé avec le B2B :

* Chaque expédition Shopify crée et valide l'expédition Dolibarr de la commande (importée au passage si besoin), avec le numéro de suivi et le transporteur.
* L'entrepôt est celui de l'emplacement Shopify expéditeur (table entrepôts = emplacement).
* La validation sort le stock dans Dolibarr, qui le repousse vers Shopify : les sorties B2B ne sont jamais écrasées.
* Jamais plus que le reste à expédier de chaque ligne ; étiquettes antérieures à l'activation ignorées ; étiquette annulée sur Shopify = expédition annulée et stock remis.
* Prérequis : module Expéditions et « Décrémenter le stock réel à la validation des expéditions » dans le module Stocks (contrôlés par le diagnostic).

=== Remboursements (Shopify → Dolibarr) ===

* Remboursement partiel : avoir limité au montant réellement remboursé, avec répartition par taux lorsque le détail des lignes remboursées est disponible. Vérifier les taux et les frais de port pour un remboursement récupéré sans détail par réconciliation.
* Remboursement total : avoir reprenant chaque ligne de la facture.
* L'avoir reste en brouillon par défaut (validation en option). Un remboursement arrivé avant sa commande ou sa facture est mis en attente ; si la facture reste absente, il passe dans les reprises puis devient visible en échec si le problème persiste.

== Architecture ==

Webhook Shopify ─┐ ┌─ Trigger Dolibarr
▼ ▼
[ JobQueue ] ── cron process_queue ── [ SyncEngine ]
│ │
[ MappingRepository ] [ Mappers × 6 ]
(id ↔ id + hash anti-boucle) (Order / Customer / Refund /
Product / Inventory / Fulfillment)

== Prérequis ==

* Modules Dolibarr '''Produits''', '''Commandes''' et '''Tiers''' actifs ; '''Stocks''', '''Expéditions''' et '''Factures''' selon les flux utilisés.
* Une '''application Shopify''' disposant des droits Admin API (products, orders, inventory, customers, fulfillments, locations ; <code>read_publications</code> et <code>write_publications</code> pour publier les nouveautés sur la Boutique en ligne ; <code>read_online_store_navigation</code> et <code>write_online_store_navigation</code> pour le menu). Selon son type, elle fournit un jeton <code>shpat_…</code> à coller, ou un ''client ID'' et un ''client secret'' avec lesquels le module obtient et renouvelle le jeton lui-même.
* Pour le temps réel : un endpoint webhook '''HTTPS public'''. Voir ci-dessous le fonctionnement sans webhook.

== Installation et mise à jour ==

# Sauvegarder la base de données, les documents et la configuration du module.
# Télécharger <code>module_shopifysync-1.8.1.zip</code> depuis la [https://www.dolistore.com/product.php?id=3218 fiche DoliStore].
# Dans Dolibarr : ''Accueil → Configuration → Modules/Applications → Déployer/installer un module externe'', ou remplacer le dossier <code>custom/shopifysync</code>.
# '''Installer le nouveau code avant de désactiver l’ancienne version.''' Les versions antérieures à la 1.7.3 pouvaient effacer leurs réglages à la désactivation.
# Activer le module pour une première installation ; pour une mise à jour depuis une version antérieure à la 1.8.0, le désactiver puis le réactiver '''après le remplacement du code'''. Cette étape enregistre le hook de déplacement des photos et crée les tables manquantes des anciennes évolutions. Depuis la 1.7.3, identifiants, correspondances et flux désactivés sont conservés.
# Vérifier la configuration, tester la connexion et contrôler l’inscription des webhooks ainsi que les tâches planifiées.
# Tester les flux habituels sur un environnement de recette avant leur activation en production.

'''Compatibilité des réglages :''' le filtre de catégories, la condition de validation et la synchronisation de l’ordre des photos restent '''désactivés par défaut'''. Aucun export massif n’est lancé lors de leur enregistrement. La 1.8.0 n’ajoute pas de nouvelle table par rapport à une 1.7.3 complète. Des réglages déjà effacés par une ancienne version doivent être restaurés depuis une sauvegarde ou saisis à nouveau.

== Configuration ==

# '''Créer l'application Shopify''' et l'installer sur la boutique. ⚠️ Depuis le '''1er janvier 2026''', Shopify ne permet plus de créer une application personnalisée depuis l'admin (celles qui affichent un jeton <code>shpat_…</code> à copier) ; les installations existantes continuent de fonctionner sans rien changer, et une nouvelle installation passe par le '''Dev Dashboard'''.
# '''Choisir le mode d'authentification''' dans la carte « Connexion » :
#* ''Jeton permanent collé'' : mode par défaut et historique : coller le jeton <code>shpat_…</code> d'une application personnalisée créée avant 2026. Rien ne change pour les installations en service.
#* ''Client ID et secret'' : pour une application et une boutique appartenant à la '''même organisation Shopify''' : saisir le ''client ID'' et le ''client secret'' de l'application du Dev Dashboard ; le module obtient un jeton valable 24 heures et le renouvelle seul.
#* ''Autorisation Shopify'' : installation par le flux d'autorisation : déclarer comme ''redirect URL'' de l'application l'adresse affichée dans la configuration (<code>…/custom/shopifysync/oauth/callback.php</code>), puis cliquer sur '''« Se reconnecter »'''. Le module reçoit un jeton d'une heure et un jeton de rafraîchissement de 90 jours, tous deux renouvelés automatiquement.
# '''Connexion''' : domaine de la boutique, jeton (ou client ID et secret), app secret, version d'API.
# '''Stock''' : emplacement Shopify et entrepôts, ou table « entrepôts = emplacement » (une règle par ligne, ex. <code>23 = gid://shopify/Location/85613641922</code>).
# Choisir les '''flux''' et les '''sources de vérité''', puis cliquer sur '''« Inscrire les webhooks »'''.
# Catalogue déjà en place des deux côtés : '''« Rattacher les variantes par SKU »'''.
# Historique à reprendre : tableau de bord → '''« Rattraper les commandes des N derniers jours »'''.
# Activer les '''tâches planifiées''' Dolibarr : traitement de la file et réconciliation.

Depuis la 1.7.1, les champs de connexion s’affichent ou se masquent selon le mode choisi, sans effacer les identifiants déjà enregistrés. Enregistrer le nouveau mode avant d’utiliser la reconnexion. Le secret de signature des webhooks reste commun aux modes.

Références Shopify : [https://shopify.dev/docs/apps/build/authentication-authorization/client-credentials-grant authentification dans la même organisation], [https://shopify.dev/docs/apps/build/authentication-authorization/access-tokens durées des jetons].

=== Jetons d'accès et échéances Shopify ===

Un jeton expirable est renouvelé '''avant''' son échéance (marge de deux minutes) et '''immédiatement''' si Shopify le refuse en cours de route : la requête est alors rejouée avec le jeton neuf. La réconciliation nocturne force en plus un renouvellement, car un jeton de rafraîchissement inutilisé pendant 90 jours expire : une boutique calme perdrait sa connexion sans prévenir. L'écran de diagnostic affiche le mode, l'échéance du jeton et alerte quand le rafraîchissement approche de sa fin.

Deux échéances Shopify à ne pas confondre :

* '''1er janvier 2026''' : plus aucune création d'application personnalisée depuis l'admin Shopify. Concerne les '''nouvelles''' installations, qui passent par le Dev Dashboard.
* '''1er janvier 2027''' : jetons expirables obligatoires pour les '''applications publiques''' de l'App Store. Les applications personnalisées et celles créées par le marchand ne sont pas visées : une installation existante n'a rien à faire.

L'URL de retour d'autorisation est protégée par trois contrôles avant tout enregistrement : signature HMAC de Shopify, jeton d'état à usage unique valable 15 minutes, et domaine de boutique identique à celui configuré.

=== Assistant de configuration initiale (depuis la 1.7.0) ===

L’onglet '''Assistant d’installation''' facilite la configuration du lien Shopify après l’installation du module. Il est facultatif et ne remplace pas le déploiement du ZIP.

# '''Connexion''' : tester un jeton permanent ou des identifiants Client ID/secret ; une connexion OAuth déjà configurée peut être réutilisée. Une nouvelle autorisation OAuth se prépare dans la Configuration.
# '''Catalogue''' : choisir l’import Shopify, l’export de produits simples Dolibarr ou le rattachement de deux catalogues existants par SKU.
# '''Correspondances SKU''' : analyser les références absentes, doublons et ambiguïtés avant de créer des liens.
# '''Entrepôts''' : associer un entrepôt à un emplacement Shopify, ou conserver les correspondances avancées existantes.
# '''Facturation''' : vérifier les modules, options, moyen de paiement et compte bancaire, sans créer de facture ni de règlement.
# '''Aperçu et démarrage''' : examiner les changements de réglages et sélectionner explicitement les opérations du premier lot (20 au maximum).

Les choix restent dans un brouillon privé pendant une heure. Aucun réglage actif n’est enregistré avant la confirmation. L’aperçu expire après 10 minutes et doit être recalculé si le catalogue ou les réglages changent. La confirmation crée les liens et les jobs ; la file habituelle effectue ensuite les échanges.

'''Catalogue déjà existant :''' le rattachement par SKU conserve la gestion des fiches dans les catalogues existants et désactive leur synchronisation. Les liens servent notamment aux commandes et aux stocks. Les photos et champs de ces produits restent gérés dans Shopify.

'''Limites :''' l’assistant analyse au plus 2 000 variantes Shopify et 2 000 fiches Dolibarr ; au-delà, utiliser les outils avancés. Les combinaisons Dolibarr complexes sont également orientées vers ces outils. Les traitements déjà en attente ou en cours doivent être terminés avant confirmation. Vérifier séparément les webhooks et tâches planifiées ; l’assistant ne suspend pas les automatismes existants.

=== Sélection des catégories à exporter (1.8.0) ===

Dans '''Configuration → Catalogue → Périmètre du catalogue''', ouvrir '''Configurer et prévisualiser'''. Le filtre est '''désactivé par défaut'''.

# Cocher '''Activer le filtre par catégories pour les exports vers Shopify'''.
# Choisir au moins une branche avec '''Autoriser la branche'''. Plusieurs branches peuvent être sélectionnées.
# Choisir, si nécessaire, des branches avec '''Exclure la branche'''.
# Cliquer sur '''Prévisualiser sans synchroniser''' pour examiner les compteurs et motifs avant d’enregistrer.
# Enregistrer lorsque le périmètre correspond au catalogue souhaité.

Chaque sélection inclut la catégorie choisie et ses descendants actuels et futurs. Une exclusion est toujours prioritaire, même si le produit appartient aussi à une branche autorisée. Un produit sans branche autorisée voit son export suspendu.

'''Exemple :''' autoriser « Maison » et « Jardin », puis exclure « Usage interne ». Les sous-catégories de Maison et Jardin sont incluses. Un produit classé à la fois dans Maison et Usage interne reste exclu. Il n’est pas nécessaire de sélectionner les catégories internes situées hors des branches autorisées pour les écarter.

'''Variantes :''' les catégories du parent déterminent l’inclusion ; une catégorie exclue sur le parent ou sur un enfant suspend l’export du groupe entier.

L’aperçu utilise les valeurs du formulaire sans enregistrer ni contacter Shopify. Il compte toutes les fiches de l’entité et présente 20 exemples par page, les causes de suspension et les fiches déjà reliées concernées. Les variantes sont comptées comme fiches : le total « Filtres satisfaits » ne garantit pas autant de créations Shopify, car les règles de SKU, variantes, sources et flux restent applicables. Cet aperçu complet est distinct de l’assistant limité à 2 000 fiches.

=== Condition de validation des produits (1.8.0) ===

# Créer, si nécessaire, un attribut supplémentaire de produit de type '''booléen''', par exemple « Prêt pour la boutique », dans la configuration des produits Dolibarr.
# Dans '''Configuration → Catalogue → Exporter uniquement les produits validés''', sélectionner ce champ et enregistrer. Par défaut, '''Aucun filtre de validation''' est sélectionné.
# Cocher le champ sur les produits à exporter. Une case vide ou décochée suspend l’export du catalogue. Pour un produit à variantes, le parent et tous ses enfants doivent être validés.
# Si un filtre de catégories est également actif, les deux conditions doivent être satisfaites.

La règle est vérifiée avant la mise en file, dans les exports manuels et de nouveau lors du traitement des jobs déjà présents. Un produit devenu non éligible pendant l’attente n’est pas exporté. Un champ supprimé, devenu non booléen ou illisible bloque l’export avec une erreur ; le filtre n’est pas ignoré silencieusement.

=== Effet des filtres sur les produits existants ===

'''Enregistrer les filtres ne lance aucun export massif et ne supprime ni ne dépublie les produits Shopify.''' Sortir un produit du périmètre ou décocher sa validation suspend ses prochaines mises à jour du catalogue ; le retirer de la vente est une action distincte.

* Commandes, stocks et expéditions conservent leurs propres réglages. Le filtre concerne les exports du catalogue vers Shopify.
* Pour reprendre un produit précédemment écarté, corriger sa catégorie ou sa validation, puis modifier sa fiche ou utiliser '''Synchroniser'''. Changer seulement les branches de configuration ou déplacer une branche entière ne lance pas un export massif.
* Avec le filtre actif, les collections, tags et le menu configuré utilisent les branches sélectionnées à la place de la racine historique. Les collections existantes ne sont pas automatiquement supprimées et les produits suspendus conservent leurs associations déjà publiées.
* Le menu configuré est reconstruit lors d’un prochain traitement catalogue qui le déclenche. La prévisualisation et l’enregistrement ne le modifient pas immédiatement.
* Une catégorie sélectionnée supprimée ou inaccessible, ou une boucle dans la hiérarchie, bloque l’export jusqu’à correction. Désactiver le filtre rétablit les règles historiques, dont la racine de catégories conservée.
* Les produits rattachés par SKU conservent leur catalogue géré dans Shopify.

=== Publication des produits et statut des variantes (1.8.1) ===

'''Disponible à partir de la version 1.8.1.''' Installer le ZIP 1.8.1 avant d’utiliser les fonctions ci-dessous.

La 1.8.1 corrige la publication des nouveaux produits à variantes sur la '''Boutique en ligne''' lorsque l’option « Publier sur la Boutique en ligne » est activée. Un produit déjà créé mais non publié peut être réparé avec le bouton '''Synchroniser''', sans création d’un second produit Shopify. Les mises à jour ordinaires ne republient pas un produit volontairement retiré après une publication réussie.

L’option '''Suivre le statut en vente des variantes''' est '''désactivée par défaut'''. Elle permet de retirer de la Boutique en ligne un enfant Dolibarr hors vente, puis de le republier lorsqu’il est remis en vente. Les identifiants, quantités et autres variantes sont conservés.

'''Prérequis et activation :'''
# Installer le ZIP 1.8.1 et effectuer la recette sur une boutique de test.
# Utiliser un catalogue piloté par Dolibarr avec le module Variants. Les produits rattachés à un catalogue existant par SKU restent gérés dans Shopify.
# Sélectionner l’API Shopify '''2026-07 ou suivante''' et disposer des droits <code>read_publications</code> et <code>write_publications</code>. Renouveler l’autorisation Shopify si ces droits manquent.
# Activer « Suivre le statut en vente des variantes ». Le parent doit être actif et publié sur la Boutique en ligne ; activer également « Publier sur la Boutique en ligne » pour les nouvelles créations si nécessaire.
# Garder le champ de validation (« Ready for webshop », par exemple) coché sur le parent '''et tous ses enfants'''. Pour retirer un seul enfant, changer son statut '''en vente / hors vente''', sans décocher cette validation.
# Traiter la file puis vérifier la visibilité et l’achat de chaque variante dans Shopify. Remettre l’enfant en vente, relancer la synchronisation et vérifier sa republication.

'''Règles à connaître :'''
* Les filtres de catégories et de validation restent prioritaires et s’appliquent au groupe entier, y compris au traitement de la file.
* Pour une variante déjà présente, seule sa publication sur la Boutique en ligne est modifiée. Ses autres canaux restent inchangés.
* Une '''nouvelle''' variante déjà hors vente est créée non publiée sur '''tous les canaux''' pour éviter une exposition temporaire. Sa remise en vente par cette option publie uniquement sur la Boutique en ligne.
* Enregistrer l’option ne déclenche pas d’export massif. La désactiver ne republie pas automatiquement les variantes précédemment retirées.
* Les correspondances de tout le groupe sont vérifiées avant la première dépublication. Une variante Shopify inconnue, un SKU ambigu ou une lecture incomplète bloque l’export avec un motif visible.
* Un refus de publication est journalisé et peut être relancé, y compris après une création interrompue. Le diagnostic d’accès au canal ne remplace pas un essai réel de publication et ne prouve pas à lui seul le droit d’écriture.
* Tous les enfants peuvent être hors vente sans perdre leurs valeurs d’attributs.

'''Mise à jour :''' la 1.8.1 n’ajoute aucune table. Depuis une installation 1.8.0 complète, remplacer le code suffit ; conserver la procédure de réactivation après remplacement du code pour une ancienne installation qui doit encore enregistrer les hooks de la 1.8.0. Sauvegarder et tester avant toute mise en production.

'''Validation :''' 2 013 contrôles locaux réussis sur Dolibarr 18, 20 et 24, avec mutations de publication simulées. La recette sur une boutique Shopify réelle reste à confirmer avant utilisation en production.

=== Photos : ajout, suppression et ordre ===

'''Envoi des images :''' activer le flux produits, choisir Dolibarr comme source du catalogue et activer l’envoi des images. Depuis la 1.7.3, ajouter une photo seule dans '''Fichiers joints''' suffit à mettre le produit en file, sans modifier un autre champ et sans activer de lien public. Les fichiers sont téléversés directement. Les remplacements de contenu sont détectés et les retraits concernent les médias gérés par le module. Un dépôt direct sur le disque, hors des événements Dolibarr, nécessite un nouvel export du produit.

'''Ordre des photos (1.8.0) :'''

# Après installation du nouveau code, réactiver le module pour enregistrer le hook de déplacement des fichiers.
# Activer explicitement '''Configuration → Catalogue → Synchroniser l’ordre des photos'''. Cette option est désactivée par défaut et nécessite l’envoi des images actif.
# Réordonner les photos par glisser-déposer dans les fichiers joints du produit, puis laisser la file se traiter.
# Vérifier la galerie et l’image principale dans Shopify.

Les médias synchronisés sont placés en tête de galerie selon les positions Dolibarr ; la première photo devient l’image principale. Les fichiers non indexés suivent, triés par nom. Les médias ajoutés directement dans Shopify sont conservés après ceux du module, dans leur ordre relatif. Un simple déplacement '''ne renvoie pas les fichiers inchangés'''. Le réordonnancement Shopify étant asynchrone, sa fin est vérifiée lors d’un passage suivant de la file.

'''Si une photo ne se synchronise pas :''' vérifier la source du catalogue, le flux produits, l’option images, les filtres éventuels et le traitement de la file. Le journal indique les images trouvées, envoyées et retirées. Un stockage de documents indisponible produit une erreur au lieu de retirer les médias. Les photos des produits rattachés par SKU restent gérées dans Shopify.

=== Diagnostic et support (depuis la 1.6.0) ===

Le tableau de bord affiche l’état de la connexion, du planificateur et du dernier rattrapage. Par flux et sens, il présente la dernière opération terminée, les traitements en attente ou en cours, les échecs, conflits et l’ancienneté de la file. Une dernière opération terminée peut être un doublon ou un événement ignoré : consulter son détail pour savoir si une écriture a eu lieu.

* Ouvrir un blocage pour lire sa cause et l’action conseillée : identifiants, autorisations, facture attendue, écart de montant ou traitement interrompu.
* Corriger la cause puis relancer les échecs ou conflits sélectionnés, jusqu’à 50 à la fois. Les traitements en cours ne sont pas remis en attente.
* Utiliser '''Vérifier la connexion''' pour actualiser le contrôle ; la page ne contacte pas Shopify à chaque affichage. Les contrôles anciens deviennent non vérifiés et une tâche en retard empêche un état global sain.
* Télécharger l’export de diagnostic pour le support. Il contient les versions, statuts, compteurs et codes structurés, sans jetons, secrets, domaine de boutique, données clients, références, journaux bruts ni contenu des commandes. Il est téléchargé localement et n’est jamais envoyé automatiquement.

L’historique détaillé débute à l’installation de cette fonctionnalité. L’export couvre une période de 1 à 30 jours, avec au plus 500 événements et une indication si les résultats sont tronqués. Les jobs et événements anciens peuvent avoir été purgés selon leur conservation.

=== Options (désactivées par défaut) ===

{| class="wikitable"
|-
! Option !! Effet
|-
| Valider la commande || La commande importée reçoit sa référence définitive (et sort le stock si Dolibarr décrémente à la validation).
|-
| Valider l'avoir || L'avoir créé par un remboursement est validé aussitôt.
|-
| Réaligner prix, SKU et code-barres || Chaque modification Dolibarr réécrit ces champs sur un produit Shopify déjà publié.
|-
| Suivre « en vente » || Un produit retiré de la vente dans Dolibarr passe en brouillon sur Shopify.
|-
| Suivre le statut en vente des variantes (1.8.1) || Retirer ou republier un enfant sur la Boutique en ligne sans supprimer sa variante, changer ses quantités ni retirer ses frères et sœurs ; API 2026-07 minimum et droits de publication requis.
|-
| Prix envoyé selon la boutique || Prix TTC envoyés si la boutique affiche ses prix taxes incluses.
|-
| Catégories Dolibarr || Collections Shopify, tags, ou les deux, avec menu de navigation optionnel.
|-
| Images du produit || Fichiers joints envoyés dans les médias Shopify.
|-
| Synchroniser l’ordre des photos (1.8.0) || Positions Dolibarr reprises sur les médias existants sans renvoyer les fichiers inchangés.
|-
| Filtre de catégories (1.8.0) || Plusieurs branches autorisées et exclusions prioritaires ; aperçu avant enregistrement.
|-
| Exporter uniquement les produits validés (1.8.0) || Condition par champ booléen, vérifiée avant mise en file et au traitement.
|-
| Poids d'expédition || Poids Dolibarr publié sur la variante Shopify.
|-
| Produit supprimé dans Dolibarr || Brouillon ou archivage sur Shopify.
|-
| Étiquettes imprimées dans Shopify || Chaque expédition Shopify crée et valide l'expédition Dolibarr, stock sorti par Dolibarr.
|-
| Ignorer les commandes de test || Les commandes passées avec la passerelle de test Shopify ne sont pas importées.
|-
| Publier sur la Boutique en ligne || Un produit créé par le module est rendu visible sur la boutique.
|}

Autres réglages : service Dolibarr des frais de port, taux de TVA par défaut, quantité Shopify échangée, notification d'expédition au client (active par défaut), règlement et compte bancaire des commandes payées.

=== Tâches planifiées sous Dolibarr 24 ===

Les deux tâches du module sont de type <code>command</code> (exécution en ligne de commande). Depuis Dolibarr 24, une tâche CLI est comptée '''en erreur''' si la variable <code>$dolibarr_cron_allow_cli</code> n'est pas activée : en version 20 le cas était seulement journalisé. Ajoutez donc dans <code>conf/conf.php</code> :

$dolibarr_cron_allow_cli = 1;

Sans cela, les tâches « ShopifySync » s'affichent en rouge dans ''Outils → Tâches planifiées'' alors même que le module fonctionne. Sans tâche planifiée active, le bouton « Traiter la file maintenant » du tableau de bord exécute la file à la demande.

=== Fonctionnement sans endpoint webhook ===

Le module reste utilisable derrière un hébergement fermé aux connexions entrantes : la réconciliation planifiée, qui n'effectue que des appels sortants, rattrape les commandes, les paiements, les annulations et les remboursements. La fenêtre d'analyse (2 jours par défaut) se règle par la constante <code>SHOPIFYSYNC_RECONCILE_WINDOW_DAYS</code>. L'import étant idempotent, le recouvrement entre deux passages ne crée pas de doublon. Les jobs terminés sont purgés après 30 jours et le journal après 90 jours.

== Historique des versions ==

{| class="wikitable"
|-
! Version !! Apports principaux
|-
| 1.8.1 || Publication des nouveaux produits à variantes ; réparation manuelle des produits déjà créés ; suivi facultatif du statut en vente de chaque enfant, désactivé par défaut ; conservation des identifiants et quantités ; vérification du groupe avant dépublication ; erreurs rejouables ; contrôle de l’API et des autorisations ; aucune nouvelle table.
|-
| 1.8.0 || Sélection de plusieurs branches de catégories, exclusions prioritaires, aperçu complet paginé et validation facultative par champ booléen ; contrôles avant mise en file et au traitement ; collections, tags et menu alignés sur le périmètre ; ordre des photos Dolibarr repris sur les médias existants sans renvoi des fichiers inchangés et suivi asynchrone ; nouvelles options désactivées par défaut, sans export massif ni dépublication automatique.
|-
| 1.7.3 || Envoi des images depuis les dossiers réels et historiques, déclenchement par ajout ou retrait d’une photo seule, détection des remplacements par leur contenu, protection si le stockage est indisponible ; conservation des réglages et des flux désactivés lors d’une désactivation/réactivation après installation du correctif.
|-
| 1.7.2 || Chargement de Dolibarr dans l’assistant conforme au validateur de paquet pour les installations en racine et dans custom, sans changement de synchronisation.
|-
| 1.7.1 || Champs de connexion affichés selon le mode d’authentification dans la Configuration et l’assistant ; identifiants masqués conservés ; reconnexion après enregistrement du mode.
|-
| 1.7.0 || Assistant facultatif de configuration du lien Shopify en six étapes : connexion, catalogue, SKU, entrepôts, facturation et aperçu ; brouillon privé, confirmation explicite d’un premier lot de 20 opérations maximum, contrôle des ambiguïtés et des modifications concurrentes ; analyse limitée à 2 000 fiches de chaque côté.
|-
| 1.6.0 || Diagnostic de connexion et des tâches planifiées, suivi par flux et sens, causes compréhensibles, historique filtrable, relances ciblées et export de diagnostic sans secrets ; remboursements sans facture source visibles dans les reprises puis en échec si le blocage persiste.
|-
| 1.5.0 || Jetons d'accès qui expirent pris en charge : mode « client ID et secret » (jeton de 24 h renouvelé par le module) et mode « autorisation Shopify » (jeton d'une heure + rafraîchissement de 90 jours), renouvellement avant échéance et à la volée sur un refus, renouvellement préventif chaque nuit, bouton « Se reconnecter », URL de retour protégée par signature, état à usage unique et contrôle du domaine ; le mode « jeton permanent collé » reste le défaut et ne change pas
|-
| 1.4.3 || Correctifs : contrôle strict des montants appliqué aussi au rejeu, règlement retenté quand son enregistrement avait échoué, remboursement en échec distingué d'une attente de facture (job en échec au lieu d'un classement silencieux), frais de port remboursés portés à leur propre taux de TVA, renommage vers un tag déjà saisi à la main qui n'est plus adopté par le module
|-
| 1.4.2 || Correctifs du contre-audit : frais de port refusés rendus à la commande et reposés au rejeu, quantité modifiée sur Shopify détectée, validation de commande et de facture rejouées à la reprise, option de contrôle strict des montants, remboursements limités aux transactions réellement abouties et répartis par taux de TVA, ligne d'avoir refusée non enregistrée comme traitée, tags jamais adoptés et renommage limité aux produits suivis, renommage échoué réellement retenté au rejeu
|-
| 1.4.1 || Correctifs : unité forcée des metafields réellement convertie (2 kg publiés en 2000 g) ; un tag Shopify saisi à la main n'est plus retiré ; suppression de collection refusée signalée au lieu d'être déclarée réussie ; erreurs de renommage de tag remontées ; remboursement de montant nul ne crée plus d'avoir intégral ; commande dont une ligne a été refusée ni validée ni facturée, puis complétée au rejeu ; modification faite pendant un export conservée ; webhook non acquitté quand le job n'a pas pu être enregistré
|-
| 1.4.0 || Catégories Dolibarr en collections Shopify, tags et menu de navigation ; images des fiches envoyées dans les médias ; champs standards (poids, dimensions, volume) publiables en metafields avec conversion d'unité ; poids d'expédition ; metafields fiables (case décochée, valeur vidée, valeur refusée signalée sans bloquer les autres) ; produit supprimé dans Dolibarr passé en brouillon ou archivé
|-
| 1.3.1 || Code client obligatoire géré (clients créés avec le code de la numérotation Dolibarr) ; ventes sans client (caisse Shopify POS) portées par un tiers unique configurable ; motif des refus journalisé ; étiquettes d'un emplacement non géré ignorées
|-
| 1.3.0 || Étiquettes imprimées dans Shopify (option) : expédition Dolibarr créée et validée sur l'entrepôt de l'emplacement expéditeur, stock sorti par Dolibarr qui reste seul maître, suivi et transporteur repris, annulation gérée, rattrapage par la réconciliation
|-
| 1.2.0 || Prix TTC, frais de port, date de vente, contact de livraison et clients invités à l'import ; annulations Shopify ; expéditions partielles avec transporteur ; prix, SKU et code-barres posés à la création des produits ; import d'un produit par variante ; suppressions Shopify gérées ; réconciliation des paiements, annulations et remboursements ; actions du tableau de bord ; options de validation et de réalignement (désactivées par défaut, aucun changement de comportement à la mise à jour) ; validé sur Dolibarr 18, 20 et 24
|-
| 1.1.2 || Bouton « Synchroniser » des fiches commande ; facture créée quand le paiement arrive après l'import
|-
| 1.1.1 || Export de stock compatible avec les API Shopify 2026-04 et suivantes ; sonde de compatibilité multi-versions
|-
| 1.1.0 || Tableau de bord et écrans redessinés, encart « État Shopify » sur les fiches ; rattachement par SKU d'un catalogue existant ; stock multi-emplacements
|-
| 1.0.2 || Produits à variantes (options Shopify, 1 SKU par combinaison, pagination jusqu'à 2 048 variantes, refus au-delà de 3 attributs) ; stock multi-entrepôts ; metafields ; règlement automatique des commandes payées ; adresse de facturation complète ; bouton « Tester la connexion » ; remises Shopify à l'import ; réconciliation par horodatage absolu et rattrapage des remboursements
|-
| 1.0.1 || Gestion des erreurs GraphQL renvoyées en chaîne ; version d'API portée à 2026-01 ; <code>inventoryActivate</code> avant écriture de stock ; correction critique de la création des lignes de commande
|-
| 1.0.0 || Version initiale : commandes, clients, remboursements, produits, stock, expéditions, webhooks signés, file d'attente, tableau de bord
|}

== Support ==

* Contact : support@arcchester.com
* Autres modules du même éditeur : [https://www.dolistore.com/recherche?controller=search&search_query=arcchester recherche « arcchester » sur le Dolistore]

[[Category:Modules complémentaires]]

Module Shopify Sync

2026-09-24T11:55:19Z

Arcchester: Mise à jour 1.8.0 : catégories et validation produit, ordre des photos, assistant, diagnostic, migration et historique 1.6.0 à 1.8.0.

== Module Shopify Sync ==

'''Shopify Sync''' est un module complémentaire pour Dolibarr ERP/CRM qui assure une '''synchronisation bidirectionnelle quasi temps réel entre Shopify et Dolibarr''' : commandes, clients, remboursements, produits et variantes, stock et expéditions. Le module dialogue directement avec l'API '''GraphQL Admin''' de Shopify : sans SaaS intermédiaire, sans abonnement supplémentaire.

{| class="wikitable"
|-
! Éditeur || arcchester
|-
! Version || 1.8.0
|-
! Licence || GPL v3
|-
! Compatibilité Dolibarr || 18.0 à 24.x (validé sur 18.0.5, 20.0.4 et 24.0.0)
|-
! PHP || 7.4 minimum (extension cURL), validé jusqu'à 8.2
|-
! Dépendances || Aucune (cURL pur : pas de Composer, pas de SDK)
|-
! Version d'API Shopify || 2026-01 par défaut, configurable ; appels vérifiés sur 2025-07, 2025-10, 2026-01, 2026-04, 2026-07 et unstable
|-
! Distribution || [https://www.dolistore.com/product.php?id=3218 Fiche sur le Dolistore]
|}

La fréquence effective dépend des tâches planifiées, de l’hébergement et des limites de l’API Shopify. Une boutique Shopify est configurée par entité Dolibarr.

== Fonctionnalités ==

* '''Commandes''' Shopify → Dolibarr : client (ou client invité), commande à la date de la vente, lignes reliées aux fiches produits, remises, '''frais de port''', contact de livraison si l'adresse diffère ; '''facture''' dès que la commande est payée, même après son import.
* '''Prix TTC ou HT''' : le module lit le réglage « taxes incluses » de la boutique, les montants importés correspondent à ce que le client a payé.
* '''Annulations''' Shopify répercutées sur la commande Dolibarr.
* '''Remboursements''' → avoirs Dolibarr : partiel (montant réellement rendu) ou total (avoir miroir ligne à ligne).
* '''Expéditions''' Dolibarr → Shopify : articles et quantités expédiés, numéro de suivi et transporteur ; expéditions partielles gérées. En option, l'inverse : une étiquette imprimée dans Shopify crée et valide l'expédition Dolibarr.
* '''Produits''' dans les deux sens, avec une '''source de vérité configurable''' (produits, prix, stock).
* '''Catalogue existant''' : rattachement par SKU des variantes Shopify aux fiches Dolibarr existantes, sans produit parent ni module Variants.
* '''Produits à variantes''' (module Variants) : les attributs Dolibarr deviennent des options Shopify, une variante par combinaison. Limites de la boutique lues à l'exécution (2 048 variantes, 3 options).
* '''Stock multi-emplacements''' : table « entrepôts Dolibarr = emplacement Shopify », ou un emplacement unique alimenté par les entrepôts choisis.
* '''Metafields''' : attributs supplémentaires et champs standards (poids, dimensions, volume) publiés vers Shopify, avec conversion de type et d'unité.
* '''Catégories, images, poids''' : collections et tags Shopify, menu de navigation, images des fiches, poids d'expédition (options).
* '''Webhooks signés HMAC''' pour le quasi temps réel, doublés d'une '''réconciliation planifiée''' qui rattrape commandes, paiements, annulations et remboursements manqués.
* '''File d'attente asynchrone''' : limites de débit de l'API absorbées, nouvelles tentatives sûres, aucun job traité deux fois.
* '''Anti-boucle''' par empreinte d'état, et '''résolution de conflits''' configurable.
* '''Tableau de bord''' : file d'attente, échecs, journal ; traiter la file maintenant, relancer les échecs, rattraper les commandes des N derniers jours.
* '''Encart « État Shopify »''' sur les fiches produit et commande, avec bouton « Synchroniser ».
* Bouton '''« Tester la connexion »''' : contrôles de configuration, droits, emplacements, webhooks et tâches planifiées, chacun avec le correctif suggéré.
* '''Diagnostic opérationnel''' : état de connexion et du planificateur, suivi par flux, causes et conseils, historique, relances ciblées et export de diagnostic sans secrets (depuis la 1.6.0).
* '''Assistant de configuration initiale''' : six étapes pour relier Shopify, choisir le catalogue, vérifier les SKU, associer les entrepôts et préparer un premier lot avec aperçu (depuis la 1.7.0).
* '''Sélection du catalogue''' : plusieurs branches autorisées, exclusions prioritaires et aperçu complet sans synchroniser (1.8.0, facultatif).
* '''Validation des produits''' : condition par champ booléen, contrôlée avant mise en file et au traitement (1.8.0, facultatif).
* '''Ordre des photos''' : reprise des positions Dolibarr et réordonnancement des médias existants, sans renvoyer les images inchangées (1.8.0, facultatif).
* Interface du module en français et en anglais.

== Ce qui est synchronisé, flux par flux ==

Chaque flux s'active ou se coupe indépendamment dans la configuration (carte « Flux synchronisés »).

=== Commandes (Shopify → Dolibarr) ===

{| class="wikitable"
|-
! Événement Shopify !! Effet dans Dolibarr
|-
| Commande créée || Tiers retrouvé par e-mail (sinon créé, avec l'adresse de facturation et le pays) ; commande datée du jour de la vente, référence client = numéro Shopify ; une ligne par article, reliée à la fiche par la variante ou le SKU ; remises ; ligne « Frais de port » ; contact de livraison si l'adresse diffère. La commande reste en '''brouillon''' (validation automatique en option).
|-
| Commande payée (tout de suite ou plus tard) || Facture créée depuis la commande et validée ; règlement enregistré en option (mode de paiement et compte bancaire au choix).
|-
| Commande annulée || Commande Dolibarr annulée, sauf si une expédition est déjà en cours.
|-
| Commande de test (passerelle de test Shopify) || Importée et signalée comme telle ; peut être ignorée par option.
|}

Un tiers existant n'est jamais renommé par une commande : seuls les champs vides sont complétés.

Ventes sans client (caisse Shopify POS, commandes anonymes) : portées par un seul tiers, choisi dans la configuration, ou « Client comptoir (Shopify) » créé automatiquement. Le code client est attribué par la numérotation Dolibarr, y compris quand il est obligatoire.

=== Clients (dans les deux sens) ===

* Shopify → Dolibarr : un client créé ou modifié met à jour son tiers (nom, e-mail, adresse, téléphone, pays, province). Une raison sociale Shopify devient le nom du tiers.
* Dolibarr → Shopify : un tiers client créé ou modifié est publié (prénom, nom, e-mail, téléphone). Un tiers sans e-mail ni téléphone n'est pas publié (exigence Shopify).
* Client supprimé sur Shopify : le lien est retiré, le tiers Dolibarr est conservé.

=== Produits (dans les deux sens) ===

{| class="wikitable"
|-
! Sens !! Création !! Modification
|-
| Dolibarr → Shopify (source de vérité produits = Dolibarr) || Produit Shopify avec titre, description, prix, SKU (= référence), code-barres, suivi de stock, statut actif si la fiche est en vente, sinon brouillon. Publication sur la Boutique en ligne en option. || Titre, description et metafields. Prix, SKU et code-barres seulement si l'option « Réaligner prix, SKU et code-barres » est cochée ; statut seulement si « Suivre en vente » est cochée.
|-
| Shopify → Dolibarr || Fiche Dolibarr (référence = SKU, libellé, prix, code-barres, statut) ; une fiche par variante pour un produit à plusieurs variantes. Si le SKU correspond à une référence existante, la fiche est '''rattachée''' sans être modifiée. || Libellé. Prix seulement si Shopify est source de vérité des prix ; statut et code-barres seulement si Shopify est source de vérité des produits.
|}

* Produit supprimé sur Shopify : liens retirés, fiche Dolibarr conservée, jamais recréée d'office (un export manuel peut la recréer si les flux, la source et les conditions de publication l’autorisent).
* Fiche rattachée par SKU : utilisée pour les commandes et le stock ; son titre, sa description et son prix ne sont jamais réécrits.
* Prix envoyé à Shopify : HT de la fiche par défaut (fonctionnement historique), ou TTC si la boutique est en TTC (option « selon la boutique »).

=== Catégories, images et champs produit (Dolibarr → Shopify, options) ===

* '''Catégories''' : chaque catégorie produit devient une '''collection''' Shopify, un '''tag''', ou les deux. Le produit rejoint et quitte les collections selon ses catégories ; une collection parente peut contenir les produits de ses sous-catégories ; une catégorie renommée ou supprimée entraîne sa collection.
* '''Menu de navigation''' construit sur l'arborescence, jusqu'à 3 niveaux (limite Shopify), reconstruit seulement quand l'arborescence change. Droits <code>read_online_store_navigation</code> et <code>write_online_store_navigation</code>.
* '''Images''' de l'onglet « Fichiers joints » envoyées dans les médias du produit : ajout, remplacement quand le fichier change, retrait quand il disparaît, sans doublon.
* '''Metafields''' : un attribut supplémentaire ''ou'' un champ standard (<code>@weight</code>, <code>@length</code>, <code>@width</code>, <code>@height</code>, <code>@surface</code>, <code>@volume</code>) publié avec conversion de type et d'unité (texte riche, poids, dimension, volume, nombres, dates, listes). Une valeur vidée efface le metafield ; une valeur refusée par Shopify n'empêche pas les autres et le job apparaît en échec.
* '''Poids d'expédition''' : le poids Dolibarr publié sur la variante Shopify, pour le calcul des frais de port.
* '''Produit supprimé dans Dolibarr''' : passé en brouillon ou archivé sur Shopify, jamais supprimé.

Le module ne touche qu'à ce qu'il a créé : une collection, un tag ou une image ajoutés à la main sur Shopify ne sont jamais retirés.

=== Stock (sens selon la source de vérité) ===

* Source de vérité '''Dolibarr''' : chaque mouvement de stock publie la quantité des entrepôts choisis sur l'emplacement Shopify correspondant (écriture « comparer puis écrire », conforme aux API 2026-04 et suivantes). Les niveaux Shopify sont ignorés : l'expédition Dolibarr sortira le stock vendu.
* Source de vérité '''Shopify''' : un niveau modifié sur Shopify ajuste l'entrepôt Dolibarr associé à l'emplacement.
* Quantité échangée : physique publiée par défaut ; « Physique » dans les deux sens, ou « Disponible » si Dolibarr décrémente le stock dès la validation de commande (le diagnostic le suggère).

=== Expéditions (Dolibarr → Shopify) ===

* À la validation d'une expédition liée à une commande Shopify, la commande passe « expédiée » sur Shopify pour les articles et quantités réellement expédiés (expéditions partielles comprises).
* Numéro de suivi et transporteur (d'après le mode d'expédition) transmis ; Shopify envoie au client son e-mail d'expédition (désactivable).
* Une expédition n'est jamais déclarée deux fois ; les expéditions de commandes qui ne viennent pas de Shopify sont ignorées.
* Le stock d'un article expédié est publié après la déclaration de l'expédition, pour que Shopify ne le décompte pas deux fois.

=== Étiquettes imprimées dans Shopify (Shopify → Dolibarr, option) ===

Pour les boutiques qui impriment leurs étiquettes dans Shopify (Chronopost, Colissimo, Shopify Shipping) tout en gardant Dolibarr seul maître du stock, par exemple un entrepôt partagé avec le B2B :

* Chaque expédition Shopify crée et valide l'expédition Dolibarr de la commande (importée au passage si besoin), avec le numéro de suivi et le transporteur.
* L'entrepôt est celui de l'emplacement Shopify expéditeur (table entrepôts = emplacement).
* La validation sort le stock dans Dolibarr, qui le repousse vers Shopify : les sorties B2B ne sont jamais écrasées.
* Jamais plus que le reste à expédier de chaque ligne ; étiquettes antérieures à l'activation ignorées ; étiquette annulée sur Shopify = expédition annulée et stock remis.
* Prérequis : module Expéditions et « Décrémenter le stock réel à la validation des expéditions » dans le module Stocks (contrôlés par le diagnostic).

=== Remboursements (Shopify → Dolibarr) ===

* Remboursement partiel : avoir limité au montant réellement remboursé, avec répartition par taux lorsque le détail des lignes remboursées est disponible. Vérifier les taux et les frais de port pour un remboursement récupéré sans détail par réconciliation.
* Remboursement total : avoir reprenant chaque ligne de la facture.
* L'avoir reste en brouillon par défaut (validation en option). Un remboursement arrivé avant sa commande ou sa facture est mis en attente ; si la facture reste absente, il passe dans les reprises puis devient visible en échec si le problème persiste.

== Architecture ==

Webhook Shopify ─┐ ┌─ Trigger Dolibarr
▼ ▼
[ JobQueue ] ── cron process_queue ── [ SyncEngine ]
│ │
[ MappingRepository ] [ Mappers × 6 ]
(id ↔ id + hash anti-boucle) (Order / Customer / Refund /
Product / Inventory / Fulfillment)

== Prérequis ==

* Modules Dolibarr '''Produits''', '''Commandes''' et '''Tiers''' actifs ; '''Stocks''', '''Expéditions''' et '''Factures''' selon les flux utilisés.
* Une '''application Shopify''' disposant des droits Admin API (products, orders, inventory, customers, fulfillments, locations ; <code>read_publications</code> et <code>write_publications</code> pour publier les nouveautés sur la Boutique en ligne ; <code>read_online_store_navigation</code> et <code>write_online_store_navigation</code> pour le menu). Selon son type, elle fournit un jeton <code>shpat_…</code> à coller, ou un ''client ID'' et un ''client secret'' avec lesquels le module obtient et renouvelle le jeton lui-même.
* Pour le temps réel : un endpoint webhook '''HTTPS public'''. Voir ci-dessous le fonctionnement sans webhook.

== Installation et mise à jour ==

# Sauvegarder la base de données, les documents et la configuration du module.
# Télécharger <code>module_shopifysync-1.8.0.zip</code> depuis la [https://www.dolistore.com/product.php?id=3218 fiche DoliStore].
# Dans Dolibarr : ''Accueil → Configuration → Modules/Applications → Déployer/installer un module externe'', ou remplacer le dossier <code>custom/shopifysync</code>.
# '''Installer le nouveau code avant de désactiver l’ancienne version.''' Les versions antérieures à la 1.7.3 pouvaient effacer leurs réglages à la désactivation.
# Activer le module pour une première installation ; pour une mise à jour vers la 1.8.0, le désactiver puis le réactiver '''après le remplacement du code'''. Cette étape enregistre le hook de déplacement des photos et crée les tables manquantes des anciennes évolutions. Depuis la 1.7.3, identifiants, correspondances et flux désactivés sont conservés.
# Vérifier la configuration, tester la connexion et contrôler l’inscription des webhooks ainsi que les tâches planifiées.
# Tester les flux habituels sur un environnement de recette avant leur activation en production.

'''Compatibilité des réglages :''' le filtre de catégories, la condition de validation et la synchronisation de l’ordre des photos restent '''désactivés par défaut'''. Aucun export massif n’est lancé lors de leur enregistrement. La 1.8.0 n’ajoute pas de nouvelle table par rapport à une 1.7.3 complète. Des réglages déjà effacés par une ancienne version doivent être restaurés depuis une sauvegarde ou saisis à nouveau.

== Configuration ==

# '''Créer l'application Shopify''' et l'installer sur la boutique. ⚠️ Depuis le '''1er janvier 2026''', Shopify ne permet plus de créer une application personnalisée depuis l'admin (celles qui affichent un jeton <code>shpat_…</code> à copier) ; les installations existantes continuent de fonctionner sans rien changer, et une nouvelle installation passe par le '''Dev Dashboard'''.
# '''Choisir le mode d'authentification''' dans la carte « Connexion » :
#* ''Jeton permanent collé'' : mode par défaut et historique : coller le jeton <code>shpat_…</code> d'une application personnalisée créée avant 2026. Rien ne change pour les installations en service.
#* ''Client ID et secret'' : pour une application et une boutique appartenant à la '''même organisation Shopify''' : saisir le ''client ID'' et le ''client secret'' de l'application du Dev Dashboard ; le module obtient un jeton valable 24 heures et le renouvelle seul.
#* ''Autorisation Shopify'' : installation par le flux d'autorisation : déclarer comme ''redirect URL'' de l'application l'adresse affichée dans la configuration (<code>…/custom/shopifysync/oauth/callback.php</code>), puis cliquer sur '''« Se reconnecter »'''. Le module reçoit un jeton d'une heure et un jeton de rafraîchissement de 90 jours, tous deux renouvelés automatiquement.
# '''Connexion''' : domaine de la boutique, jeton (ou client ID et secret), app secret, version d'API.
# '''Stock''' : emplacement Shopify et entrepôts, ou table « entrepôts = emplacement » (une règle par ligne, ex. <code>23 = gid://shopify/Location/85613641922</code>).
# Choisir les '''flux''' et les '''sources de vérité''', puis cliquer sur '''« Inscrire les webhooks »'''.
# Catalogue déjà en place des deux côtés : '''« Rattacher les variantes par SKU »'''.
# Historique à reprendre : tableau de bord → '''« Rattraper les commandes des N derniers jours »'''.
# Activer les '''tâches planifiées''' Dolibarr : traitement de la file et réconciliation.

Depuis la 1.7.1, les champs de connexion s’affichent ou se masquent selon le mode choisi, sans effacer les identifiants déjà enregistrés. Enregistrer le nouveau mode avant d’utiliser la reconnexion. Le secret de signature des webhooks reste commun aux modes.

Références Shopify : [https://shopify.dev/docs/apps/build/authentication-authorization/client-credentials-grant authentification dans la même organisation], [https://shopify.dev/docs/apps/build/authentication-authorization/access-tokens durées des jetons].

=== Jetons d'accès et échéances Shopify ===

Un jeton expirable est renouvelé '''avant''' son échéance (marge de deux minutes) et '''immédiatement''' si Shopify le refuse en cours de route : la requête est alors rejouée avec le jeton neuf. La réconciliation nocturne force en plus un renouvellement, car un jeton de rafraîchissement inutilisé pendant 90 jours expire : une boutique calme perdrait sa connexion sans prévenir. L'écran de diagnostic affiche le mode, l'échéance du jeton et alerte quand le rafraîchissement approche de sa fin.

Deux échéances Shopify à ne pas confondre :

* '''1er janvier 2026''' : plus aucune création d'application personnalisée depuis l'admin Shopify. Concerne les '''nouvelles''' installations, qui passent par le Dev Dashboard.
* '''1er janvier 2027''' : jetons expirables obligatoires pour les '''applications publiques''' de l'App Store. Les applications personnalisées et celles créées par le marchand ne sont pas visées : une installation existante n'a rien à faire.

L'URL de retour d'autorisation est protégée par trois contrôles avant tout enregistrement : signature HMAC de Shopify, jeton d'état à usage unique valable 15 minutes, et domaine de boutique identique à celui configuré.

=== Assistant de configuration initiale (depuis la 1.7.0) ===

L’onglet '''Assistant d’installation''' facilite la configuration du lien Shopify après l’installation du module. Il est facultatif et ne remplace pas le déploiement du ZIP.

# '''Connexion''' : tester un jeton permanent ou des identifiants Client ID/secret ; une connexion OAuth déjà configurée peut être réutilisée. Une nouvelle autorisation OAuth se prépare dans la Configuration.
# '''Catalogue''' : choisir l’import Shopify, l’export de produits simples Dolibarr ou le rattachement de deux catalogues existants par SKU.
# '''Correspondances SKU''' : analyser les références absentes, doublons et ambiguïtés avant de créer des liens.
# '''Entrepôts''' : associer un entrepôt à un emplacement Shopify, ou conserver les correspondances avancées existantes.
# '''Facturation''' : vérifier les modules, options, moyen de paiement et compte bancaire, sans créer de facture ni de règlement.
# '''Aperçu et démarrage''' : examiner les changements de réglages et sélectionner explicitement les opérations du premier lot (20 au maximum).

Les choix restent dans un brouillon privé pendant une heure. Aucun réglage actif n’est enregistré avant la confirmation. L’aperçu expire après 10 minutes et doit être recalculé si le catalogue ou les réglages changent. La confirmation crée les liens et les jobs ; la file habituelle effectue ensuite les échanges.

'''Catalogue déjà existant :''' le rattachement par SKU conserve la gestion des fiches dans les catalogues existants et désactive leur synchronisation. Les liens servent notamment aux commandes et aux stocks. Les photos et champs de ces produits restent gérés dans Shopify.

'''Limites :''' l’assistant analyse au plus 2 000 variantes Shopify et 2 000 fiches Dolibarr ; au-delà, utiliser les outils avancés. Les combinaisons Dolibarr complexes sont également orientées vers ces outils. Les traitements déjà en attente ou en cours doivent être terminés avant confirmation. Vérifier séparément les webhooks et tâches planifiées ; l’assistant ne suspend pas les automatismes existants.

=== Sélection des catégories à exporter (1.8.0) ===

Dans '''Configuration → Catalogue → Périmètre du catalogue''', ouvrir '''Configurer et prévisualiser'''. Le filtre est '''désactivé par défaut'''.

# Cocher '''Activer le filtre par catégories pour les exports vers Shopify'''.
# Choisir au moins une branche avec '''Autoriser la branche'''. Plusieurs branches peuvent être sélectionnées.
# Choisir, si nécessaire, des branches avec '''Exclure la branche'''.
# Cliquer sur '''Prévisualiser sans synchroniser''' pour examiner les compteurs et motifs avant d’enregistrer.
# Enregistrer lorsque le périmètre correspond au catalogue souhaité.

Chaque sélection inclut la catégorie choisie et ses descendants actuels et futurs. Une exclusion est toujours prioritaire, même si le produit appartient aussi à une branche autorisée. Un produit sans branche autorisée voit son export suspendu.

'''Exemple :''' autoriser « Maison » et « Jardin », puis exclure « Usage interne ». Les sous-catégories de Maison et Jardin sont incluses. Un produit classé à la fois dans Maison et Usage interne reste exclu. Il n’est pas nécessaire de sélectionner les catégories internes situées hors des branches autorisées pour les écarter.

'''Variantes :''' les catégories du parent déterminent l’inclusion ; une catégorie exclue sur le parent ou sur un enfant suspend l’export du groupe entier.

L’aperçu utilise les valeurs du formulaire sans enregistrer ni contacter Shopify. Il compte toutes les fiches de l’entité et présente 20 exemples par page, les causes de suspension et les fiches déjà reliées concernées. Les variantes sont comptées comme fiches : le total « Filtres satisfaits » ne garantit pas autant de créations Shopify, car les règles de SKU, variantes, sources et flux restent applicables. Cet aperçu complet est distinct de l’assistant limité à 2 000 fiches.

=== Condition de validation des produits (1.8.0) ===

# Créer, si nécessaire, un attribut supplémentaire de produit de type '''booléen''', par exemple « Prêt pour la boutique », dans la configuration des produits Dolibarr.
# Dans '''Configuration → Catalogue → Exporter uniquement les produits validés''', sélectionner ce champ et enregistrer. Par défaut, '''Aucun filtre de validation''' est sélectionné.
# Cocher le champ sur les produits à exporter. Une case vide ou décochée suspend l’export du catalogue. Pour un produit à variantes, le parent et tous ses enfants doivent être validés.
# Si un filtre de catégories est également actif, les deux conditions doivent être satisfaites.

La règle est vérifiée avant la mise en file, dans les exports manuels et de nouveau lors du traitement des jobs déjà présents. Un produit devenu non éligible pendant l’attente n’est pas exporté. Un champ supprimé, devenu non booléen ou illisible bloque l’export avec une erreur ; le filtre n’est pas ignoré silencieusement.

=== Effet des filtres sur les produits existants ===

'''Enregistrer les filtres ne lance aucun export massif et ne supprime ni ne dépublie les produits Shopify.''' Sortir un produit du périmètre ou décocher sa validation suspend ses prochaines mises à jour du catalogue ; le retirer de la vente est une action distincte.

* Commandes, stocks et expéditions conservent leurs propres réglages. Le filtre concerne les exports du catalogue vers Shopify.
* Pour reprendre un produit précédemment écarté, corriger sa catégorie ou sa validation, puis modifier sa fiche ou utiliser '''Synchroniser'''. Changer seulement les branches de configuration ou déplacer une branche entière ne lance pas un export massif.
* Avec le filtre actif, les collections, tags et le menu configuré utilisent les branches sélectionnées à la place de la racine historique. Les collections existantes ne sont pas automatiquement supprimées et les produits suspendus conservent leurs associations déjà publiées.
* Le menu configuré est reconstruit lors d’un prochain traitement catalogue qui le déclenche. La prévisualisation et l’enregistrement ne le modifient pas immédiatement.
* Une catégorie sélectionnée supprimée ou inaccessible, ou une boucle dans la hiérarchie, bloque l’export jusqu’à correction. Désactiver le filtre rétablit les règles historiques, dont la racine de catégories conservée.
* Les produits rattachés par SKU conservent leur catalogue géré dans Shopify.

=== Photos : ajout, suppression et ordre ===

'''Envoi des images :''' activer le flux produits, choisir Dolibarr comme source du catalogue et activer l’envoi des images. Depuis la 1.7.3, ajouter une photo seule dans '''Fichiers joints''' suffit à mettre le produit en file, sans modifier un autre champ et sans activer de lien public. Les fichiers sont téléversés directement. Les remplacements de contenu sont détectés et les retraits concernent les médias gérés par le module. Un dépôt direct sur le disque, hors des événements Dolibarr, nécessite un nouvel export du produit.

'''Ordre des photos (1.8.0) :'''

# Après installation du nouveau code, réactiver le module pour enregistrer le hook de déplacement des fichiers.
# Activer explicitement '''Configuration → Catalogue → Synchroniser l’ordre des photos'''. Cette option est désactivée par défaut et nécessite l’envoi des images actif.
# Réordonner les photos par glisser-déposer dans les fichiers joints du produit, puis laisser la file se traiter.
# Vérifier la galerie et l’image principale dans Shopify.

Les médias synchronisés sont placés en tête de galerie selon les positions Dolibarr ; la première photo devient l’image principale. Les fichiers non indexés suivent, triés par nom. Les médias ajoutés directement dans Shopify sont conservés après ceux du module, dans leur ordre relatif. Un simple déplacement '''ne renvoie pas les fichiers inchangés'''. Le réordonnancement Shopify étant asynchrone, sa fin est vérifiée lors d’un passage suivant de la file.

'''Si une photo ne se synchronise pas :''' vérifier la source du catalogue, le flux produits, l’option images, les filtres éventuels et le traitement de la file. Le journal indique les images trouvées, envoyées et retirées. Un stockage de documents indisponible produit une erreur au lieu de retirer les médias. Les photos des produits rattachés par SKU restent gérées dans Shopify.

=== Diagnostic et support (depuis la 1.6.0) ===

Le tableau de bord affiche l’état de la connexion, du planificateur et du dernier rattrapage. Par flux et sens, il présente la dernière opération terminée, les traitements en attente ou en cours, les échecs, conflits et l’ancienneté de la file. Une dernière opération terminée peut être un doublon ou un événement ignoré : consulter son détail pour savoir si une écriture a eu lieu.

* Ouvrir un blocage pour lire sa cause et l’action conseillée : identifiants, autorisations, facture attendue, écart de montant ou traitement interrompu.
* Corriger la cause puis relancer les échecs ou conflits sélectionnés, jusqu’à 50 à la fois. Les traitements en cours ne sont pas remis en attente.
* Utiliser '''Vérifier la connexion''' pour actualiser le contrôle ; la page ne contacte pas Shopify à chaque affichage. Les contrôles anciens deviennent non vérifiés et une tâche en retard empêche un état global sain.
* Télécharger l’export de diagnostic pour le support. Il contient les versions, statuts, compteurs et codes structurés, sans jetons, secrets, domaine de boutique, données clients, références, journaux bruts ni contenu des commandes. Il est téléchargé localement et n’est jamais envoyé automatiquement.

L’historique détaillé débute à l’installation de cette fonctionnalité. L’export couvre une période de 1 à 30 jours, avec au plus 500 événements et une indication si les résultats sont tronqués. Les jobs et événements anciens peuvent avoir été purgés selon leur conservation.

=== Options (désactivées par défaut) ===

{| class="wikitable"
|-
! Option !! Effet
|-
| Valider la commande || La commande importée reçoit sa référence définitive (et sort le stock si Dolibarr décrémente à la validation).
|-
| Valider l'avoir || L'avoir créé par un remboursement est validé aussitôt.
|-
| Réaligner prix, SKU et code-barres || Chaque modification Dolibarr réécrit ces champs sur un produit Shopify déjà publié.
|-
| Suivre « en vente » || Un produit retiré de la vente dans Dolibarr passe en brouillon sur Shopify.
|-
| Prix envoyé selon la boutique || Prix TTC envoyés si la boutique affiche ses prix taxes incluses.
|-
| Catégories Dolibarr || Collections Shopify, tags, ou les deux, avec menu de navigation optionnel.
|-
| Images du produit || Fichiers joints envoyés dans les médias Shopify.
|-
| Synchroniser l’ordre des photos (1.8.0) || Positions Dolibarr reprises sur les médias existants sans renvoyer les fichiers inchangés.
|-
| Filtre de catégories (1.8.0) || Plusieurs branches autorisées et exclusions prioritaires ; aperçu avant enregistrement.
|-
| Exporter uniquement les produits validés (1.8.0) || Condition par champ booléen, vérifiée avant mise en file et au traitement.
|-
| Poids d'expédition || Poids Dolibarr publié sur la variante Shopify.
|-
| Produit supprimé dans Dolibarr || Brouillon ou archivage sur Shopify.
|-
| Étiquettes imprimées dans Shopify || Chaque expédition Shopify crée et valide l'expédition Dolibarr, stock sorti par Dolibarr.
|-
| Ignorer les commandes de test || Les commandes passées avec la passerelle de test Shopify ne sont pas importées.
|-
| Publier sur la Boutique en ligne || Un produit créé par le module est rendu visible sur la boutique.
|}

Autres réglages : service Dolibarr des frais de port, taux de TVA par défaut, quantité Shopify échangée, notification d'expédition au client (active par défaut), règlement et compte bancaire des commandes payées.

=== Tâches planifiées sous Dolibarr 24 ===

Les deux tâches du module sont de type <code>command</code> (exécution en ligne de commande). Depuis Dolibarr 24, une tâche CLI est comptée '''en erreur''' si la variable <code>$dolibarr_cron_allow_cli</code> n'est pas activée : en version 20 le cas était seulement journalisé. Ajoutez donc dans <code>conf/conf.php</code> :

$dolibarr_cron_allow_cli = 1;

Sans cela, les tâches « ShopifySync » s'affichent en rouge dans ''Outils → Tâches planifiées'' alors même que le module fonctionne. Sans tâche planifiée active, le bouton « Traiter la file maintenant » du tableau de bord exécute la file à la demande.

=== Fonctionnement sans endpoint webhook ===

Le module reste utilisable derrière un hébergement fermé aux connexions entrantes : la réconciliation planifiée, qui n'effectue que des appels sortants, rattrape les commandes, les paiements, les annulations et les remboursements. La fenêtre d'analyse (2 jours par défaut) se règle par la constante <code>SHOPIFYSYNC_RECONCILE_WINDOW_DAYS</code>. L'import étant idempotent, le recouvrement entre deux passages ne crée pas de doublon. Les jobs terminés sont purgés après 30 jours et le journal après 90 jours.

== Historique des versions ==

{| class="wikitable"
|-
! Version !! Apports principaux
|-
| 1.8.0 || Sélection de plusieurs branches de catégories, exclusions prioritaires, aperçu complet paginé et validation facultative par champ booléen ; contrôles avant mise en file et au traitement ; collections, tags et menu alignés sur le périmètre ; ordre des photos Dolibarr repris sur les médias existants sans renvoi des fichiers inchangés et suivi asynchrone ; nouvelles options désactivées par défaut, sans export massif ni dépublication automatique.
|-
| 1.7.3 || Envoi des images depuis les dossiers réels et historiques, déclenchement par ajout ou retrait d’une photo seule, détection des remplacements par leur contenu, protection si le stockage est indisponible ; conservation des réglages et des flux désactivés lors d’une désactivation/réactivation après installation du correctif.
|-
| 1.7.2 || Chargement de Dolibarr dans l’assistant conforme au validateur de paquet pour les installations en racine et dans custom, sans changement de synchronisation.
|-
| 1.7.1 || Champs de connexion affichés selon le mode d’authentification dans la Configuration et l’assistant ; identifiants masqués conservés ; reconnexion après enregistrement du mode.
|-
| 1.7.0 || Assistant facultatif de configuration du lien Shopify en six étapes : connexion, catalogue, SKU, entrepôts, facturation et aperçu ; brouillon privé, confirmation explicite d’un premier lot de 20 opérations maximum, contrôle des ambiguïtés et des modifications concurrentes ; analyse limitée à 2 000 fiches de chaque côté.
|-
| 1.6.0 || Diagnostic de connexion et des tâches planifiées, suivi par flux et sens, causes compréhensibles, historique filtrable, relances ciblées et export de diagnostic sans secrets ; remboursements sans facture source visibles dans les reprises puis en échec si le blocage persiste.
|-
| 1.5.0 || Jetons d'accès qui expirent pris en charge : mode « client ID et secret » (jeton de 24 h renouvelé par le module) et mode « autorisation Shopify » (jeton d'une heure + rafraîchissement de 90 jours), renouvellement avant échéance et à la volée sur un refus, renouvellement préventif chaque nuit, bouton « Se reconnecter », URL de retour protégée par signature, état à usage unique et contrôle du domaine ; le mode « jeton permanent collé » reste le défaut et ne change pas
|-
| 1.4.3 || Correctifs : contrôle strict des montants appliqué aussi au rejeu, règlement retenté quand son enregistrement avait échoué, remboursement en échec distingué d'une attente de facture (job en échec au lieu d'un classement silencieux), frais de port remboursés portés à leur propre taux de TVA, renommage vers un tag déjà saisi à la main qui n'est plus adopté par le module
|-
| 1.4.2 || Correctifs du contre-audit : frais de port refusés rendus à la commande et reposés au rejeu, quantité modifiée sur Shopify détectée, validation de commande et de facture rejouées à la reprise, option de contrôle strict des montants, remboursements limités aux transactions réellement abouties et répartis par taux de TVA, ligne d'avoir refusée non enregistrée comme traitée, tags jamais adoptés et renommage limité aux produits suivis, renommage échoué réellement retenté au rejeu
|-
| 1.4.1 || Correctifs : unité forcée des metafields réellement convertie (2 kg publiés en 2000 g) ; un tag Shopify saisi à la main n'est plus retiré ; suppression de collection refusée signalée au lieu d'être déclarée réussie ; erreurs de renommage de tag remontées ; remboursement de montant nul ne crée plus d'avoir intégral ; commande dont une ligne a été refusée ni validée ni facturée, puis complétée au rejeu ; modification faite pendant un export conservée ; webhook non acquitté quand le job n'a pas pu être enregistré
|-
| 1.4.0 || Catégories Dolibarr en collections Shopify, tags et menu de navigation ; images des fiches envoyées dans les médias ; champs standards (poids, dimensions, volume) publiables en metafields avec conversion d'unité ; poids d'expédition ; metafields fiables (case décochée, valeur vidée, valeur refusée signalée sans bloquer les autres) ; produit supprimé dans Dolibarr passé en brouillon ou archivé
|-
| 1.3.1 || Code client obligatoire géré (clients créés avec le code de la numérotation Dolibarr) ; ventes sans client (caisse Shopify POS) portées par un tiers unique configurable ; motif des refus journalisé ; étiquettes d'un emplacement non géré ignorées
|-
| 1.3.0 || Étiquettes imprimées dans Shopify (option) : expédition Dolibarr créée et validée sur l'entrepôt de l'emplacement expéditeur, stock sorti par Dolibarr qui reste seul maître, suivi et transporteur repris, annulation gérée, rattrapage par la réconciliation
|-
| 1.2.0 || Prix TTC, frais de port, date de vente, contact de livraison et clients invités à l'import ; annulations Shopify ; expéditions partielles avec transporteur ; prix, SKU et code-barres posés à la création des produits ; import d'un produit par variante ; suppressions Shopify gérées ; réconciliation des paiements, annulations et remboursements ; actions du tableau de bord ; options de validation et de réalignement (désactivées par défaut, aucun changement de comportement à la mise à jour) ; validé sur Dolibarr 18, 20 et 24
|-
| 1.1.2 || Bouton « Synchroniser » des fiches commande ; facture créée quand le paiement arrive après l'import
|-
| 1.1.1 || Export de stock compatible avec les API Shopify 2026-04 et suivantes ; sonde de compatibilité multi-versions
|-
| 1.1.0 || Tableau de bord et écrans redessinés, encart « État Shopify » sur les fiches ; rattachement par SKU d'un catalogue existant ; stock multi-emplacements
|-
| 1.0.2 || Produits à variantes (options Shopify, 1 SKU par combinaison, pagination jusqu'à 2 048 variantes, refus au-delà de 3 attributs) ; stock multi-entrepôts ; metafields ; règlement automatique des commandes payées ; adresse de facturation complète ; bouton « Tester la connexion » ; remises Shopify à l'import ; réconciliation par horodatage absolu et rattrapage des remboursements
|-
| 1.0.1 || Gestion des erreurs GraphQL renvoyées en chaîne ; version d'API portée à 2026-01 ; <code>inventoryActivate</code> avant écriture de stock ; correction critique de la création des lignes de commande
|-
| 1.0.0 || Version initiale : commandes, clients, remboursements, produits, stock, expéditions, webhooks signés, file d'attente, tableau de bord
|}

== Support ==

* Contact : support@arcchester.com
* Autres modules du même éditeur : [https://www.dolistore.com/recherche?controller=search&search_query=arcchester recherche « arcchester » sur le Dolistore]

[[Category:Modules complémentaires]]

Module Shopify Sync

2026-09-22T20:10:01Z

Arcchester: Versions 1.4.3 et 1.5.0 : correctifs de reprise et de TVA du port, puis jetons d'accès expirables (client ID/secret ou autorisation Shopify) renouvelés automatiquement ; parcours d'installation mis à jour (fin des applications personnalisées créées dans l'admin depuis 2026)

Module Shopify Sync

2026-09-22T19:16:42Z

Arcchester: Version 1.4.2 : correctifs du contre-audit (frais de port reposés au rejeu, quantité modifiée détectée, validations rejouées, contrôle strict des montants en option, remboursements par taux de TVA, tags limités à ceux posés par le module)

Module Shopify Sync

2026-09-22T18:53:21Z

Arcchester: Version 1.4.1 : correctifs (unité forcée des metafields convertie, tags posés à la main préservés, refus Shopify remontés, remboursement nul, commande incomplète réparée au rejeu, modification pendant export, webhook non acquitté)

Module Shopify Sync

2026-09-22T18:05:09Z

Arcchester: Version 1.4.0 : catégories en collections/tags/menu, images des fiches, champs standards en metafields, metafields fiabilisés, produit supprimé archivé

Module Shopify Sync

2026-09-18T16:27:04Z

Arcchester: Version 1.3.1 : étiquettes imprimées dans Shopify, ventes en caisse, code client obligatoire

Module Shopify Sync

2026-09-17T08:38:17Z

Arcchester: Version 1.2.0 : ce qui est synchronisé flux par flux, options, mise à jour, historique

Module WhatsApp Notify

2026-09-06T12:03:20Z

Arcchester: Categorie corrigee (Category: au lieu de Categorie:) et contact de support mis a jour

== Module WhatsApp Notify ==

'''WhatsApp Notify''' est un module complémentaire pour Dolibarr ERP/CRM qui envoie les factures et les relances de paiement directement sur le '''WhatsApp''' des clients, depuis Dolibarr, via l''''API Cloud officielle de Meta''' (messages template approuvés, envoi serveur, statuts de livraison). Il ne s'agit ni d'un lien « web.whatsapp » à ouvrir manuellement, ni d'une passerelle tierce payante.

{| class="wikitable"
|-
! Éditeur || arcchester
|-
! Licence || GPL v3
|-
! Compatibilité Dolibarr || 18.0 à 23.x
|-
! PHP || 7.4 minimum (extension cURL)
|-
! Dépendances || Aucune (cURL pur : pas de Composer, pas de SDK)
|-
! Distribution || [https://www.dolistore.com/product.php?id=3214 Fiche sur le Dolistore]
|}

== Fonctionnalités ==

* Bouton '''« Envoyer sur WhatsApp »''' sur la fiche facture, avec badge d'état coloré.
* '''Envoi automatique''' optionnel dès la validation de la facture (déclencheur BILL_VALIDATE).
* '''PDF de la facture en pièce jointe''' du message WhatsApp (template avec en-tête Document).
* '''Suivi de livraison en temps réel''' : envoyé / livré / '''lu''' / échec — mis à jour par le webhook Meta (signature HMAC-SHA256 vérifiée).
* Message '''template''' à 3 variables : nom du client, référence de la facture, montant TTC.
* '''Numéros internationaux''' : normalisation automatique au format E.164, indicatif par défaut configurable pour les numéros locaux.
* '''Traçabilité''' : chaque envoi est journalisé en base (identifiant de message Meta, statut, date).
* Interface et documentation en français et en anglais.

== Prérequis Meta (une seule fois, ~10 minutes) ==

Le module utilise l'API Cloud officielle — il faut donc un compte Meta :

# Un '''compte Meta Business''' (gratuit) et une application de type « Business ».
# Un '''numéro WhatsApp Business''' relié à l'API Cloud (un numéro de test est fourni gratuitement par Meta pour les essais).
# Un '''jeton d'accès permanent''' (System User) — Meta > Business Settings > Users > System users.
# Un '''template de message approuvé''' : le texte prêt à copier est fourni avec le module ; l'approbation Meta prend en général moins de 24 h.

''Note : Meta facture à la conversation/au message (directement à Meta). L'ouverture du compte et le premier template sont gratuits.''

== Installation ==

# Télécharger le zip <code>module_whatsappnotify-x.y.z.zip</code> depuis le Dolistore.
# Dans Dolibarr : ''Accueil → Configuration → Modules/Applications → Déployer/installer un module externe'' et sélectionner le zip.
# Activer le module '''WhatsApp Notify''' dans la liste des modules (famille « Interfaces avec des systèmes externes »).
# Aucune dépendance à installer sur le serveur.

== Configuration ==

Menu ''Configuration → Modules → WhatsApp Notify'' :

* '''Identifiants Meta''' : jeton d'accès permanent, Phone Number ID, WhatsApp Business Account ID, version de l'API.
* '''Webhook (suivi de livraison)''' : l'URL à déclarer dans Meta est affichée ; renseigner le verify token et l'app secret pour la vérification de signature.
* '''Messages''' : nom du template, langue du template, pièce jointe PDF (oui/non), envoi automatique à la validation (oui/non), indicatif téléphonique par défaut.

Prérequis de données : le '''numéro de téléphone''' du tiers (fiche client) doit être renseigné — de préférence au format international (+33…, +212…) ; à défaut, l'indicatif par défaut est appliqué.

== Utilisation ==

* Sur la fiche d'une '''facture validée''', un encart « Notification WhatsApp » propose le bouton d'envoi ; après envoi, il affiche le statut (envoyé / livré / lu) et le numéro du destinataire.
* En mode '''automatique''', le message part dès la validation de la facture, sans action de l'utilisateur.
* Chaque message envoyé est visible en base avec son identifiant Meta (wamid) pour audit.

== Historique des versions ==

{| class="wikitable"
|-
! Version !! Apports principaux
|-
| 1.0.0 || Version initiale : envoi manuel + automatique, template Meta, PDF en pièce jointe, webhook de statut signé, normalisation E.164, FR/EN
|}

== Support ==

* Contact : support@arcchester.com
* Assistance : https://github.com/chakibarrama/Dolistore/issues

[[Category:Modules complémentaires]]

Module Factur-X France

2026-09-06T12:03:18Z

Arcchester: Categorie corrigee (Category: au lieu de Categorie:) et contact de support mis a jour

== Module Factur-X France ==

'''Factur-X France''' est un module complémentaire pour Dolibarr ERP/CRM qui génère et contrôle des factures électroniques au format '''Factur-X''' (PDF/A-3 avec XML CII conforme à la norme européenne '''EN 16931'''), dans le cadre de la réforme française de la facturation électronique (dépôt PPF / plateformes agréées, Chorus Pro pour le secteur public).

{| class="wikitable"
|-
! Éditeur || arcchester
|-
! Licence || GPL v3
|-
! Compatibilité Dolibarr || 18.0 à 24.x
|-
! PHP || 7.4 minimum
|-
! Dépendances || Aucune (module autonome : pas de Java, pas de Composer, pas de service externe)
|-
! Distribution || [https://www.dolistore.com/product.php?id=3075 Fiche sur le Dolistore]
|}

== Fonctionnalités ==

* '''Génération automatique''' du fichier Factur-X (PDF/A-3 + XML CII EN 16931) à la validation de chaque facture client — profils Minimum, Basic et Comfort (EN 16931).
* '''Types de documents''' : factures standard (380), avoirs (381), factures d'acompte (386) et factures rectificatives (384), avec la référence à la facture d'origine (BG-3) lorsque la norme l'exige.
* '''Pré-contrôle « anti-rejet »''' : un encart sur la fiche facture indique, avant émission, si la facture est conforme ; en cas d'anomalie, l'identifiant officiel de la règle en cause est affiché (ex. BR-CL-23, BR-CO-15) avec le champ Dolibarr à corriger.
* '''Secteur public (B2G) — Chorus Pro''' : les clients de type « Administration » sont détectés automatiquement ; le SIRET du destinataire, le code service exécutant et le numéro d'engagement (BT-10 / BT-13) sont contrôlés avant émission.
* '''Tableau de bord de conformité''' : score de conformité sur une période, règles en échec agrégées, détail par facture, et export par lot (ZIP) des XML Factur-X.
* '''QR de paiement SEPA''' (option, norme EPC069-12) : un QR-code imprimé sur le PDF permet au client de pré-remplir son virement (bénéficiaire, IBAN, montant, référence) en le scannant avec son application bancaire. Jamais imprimé sur les avoirs.
* '''Comportement fail-safe''' : une facture non conforme ne produit aucun fichier électronique douteux — le PDF standard de Dolibarr est conservé tel quel et l'anomalie est expliquée.
* Interface et documentation en français et en anglais.

== Conformité ==

Les fichiers produits sont validés avec les outils de référence utilisés par les plateformes :

* '''Schéma XSD officiel''' Factur-X / EN 16931 (validation structurelle, également exécutée en local avant chaque émission) ;
* '''Schematron officiel EN 16931''' (règles métier BR-*, BR-CO-*, BR-CL-*) ;
* '''veraPDF''' pour la conformité PDF/A-3b du PDF final ;
* Compatibilité '''ZUGFeRD 2.x''' : Factur-X et ZUGFeRD partagent la même spécification, les fichiers sont donc également utilisables avec des clients allemands.

== Installation ==

# Télécharger le zip <code>module_facturxfrance-x.y.z.zip</code> depuis le Dolistore.
# Dans Dolibarr : ''Accueil → Configuration → Modules/Applications → Déployer/installer un module externe'' et sélectionner le zip.
# Activer le module '''FacturXFrance''' dans la liste des modules.
# Aucune dépendance à installer sur le serveur.

== Configuration ==

Menu ''Configuration → Modules → FacturXFrance'' :

* '''Profil Factur-X''' : Minimum, Basic ou Comfort (recommandé pour PPF/PDP).
* '''Correspondance des taux de TVA''' : associer chaque taux local au code UNCL 5305 (S, Z, E, AE, K, G, O).
* '''Correspondance des unités''' : associer les unités Dolibarr aux codes UN/CEFACT (C62, HUR, KGM…).
* '''QR de paiement''' : case à cocher (désactivé par défaut).
* Un onglet ''À propos'' fournit un panneau de diagnostic (versions, extensions PHP) utile au support.

Prérequis de données pour une facture conforme : SIRET de l'émetteur, TVA intracommunautaire, compte bancaire (IBAN/BIC) associé à la facture, SIRET du client français. Pour un client « Administration » : renseigner le code service exécutant ou le numéro d'engagement dans le champ « Réf. client » de la facture.

== Utilisation ==

* À la '''validation d'une facture''', le XML Factur-X est généré puis injecté dans le PDF (PDF/A-3). Les fichiers sont visibles dans les documents joints de la facture.
* L'encart '''Conformité Factur-X''' de la fiche facture permet de revérifier la conformité à tout moment.
* Le '''tableau de bord''' (lien depuis la page de configuration) permet d'analyser une période entière et de télécharger tous les XML conformes en un ZIP.

== Historique des versions ==

{| class="wikitable"
|-
! Version !! Apports principaux
|-
| 1.5.0 || QR de paiement SEPA (EPC069-12), compatibilité Dolibarr 18 renforcée
|-
| 1.4.0 || Secteur public B2G : contrôles Chorus Pro, BT-10 / BT-13
|-
| 1.3.0 || Factures d'acompte et rectificatives, tableau de bord de conformité, export par lot
|-
| 1.2.0 || Avoirs (BG-3), validation XSD à l'exécution, comportement fail-safe
|-
| 1.1.x || Pré-contrôle EN 16931 en PHP, conformité PDF/A-3 (veraPDF)
|-
| 1.0.x || Génération Factur-X initiale (XSD + Schematron)
|}

== Support ==

* Contact : support@arcchester.com
* Les demandes accompagnées d'une capture de l'onglet ''À propos'' (diagnostic) sont traitées plus rapidement.

[[Category:Modules complémentaires]]

Module DoliBank Sync

2026-09-06T12:02:08Z

Arcchester: Documentation du module externe DoliBank Sync (editeur arcchester)

== Module DoliBank Sync ==

'''DoliBank Sync''' est un module complémentaire pour Dolibarr ERP/CRM qui fait '''arriver vos relevés bancaires tout seuls dans Dolibarr''' : connexion directe à '''Qonto''' et, via l''''open banking''', aux banques européennes couvertes par GoCardless Bank Account Data. Chaque ligne est dédoublonnée, proposée au rapprochement, et peut devenir une dépense en un clic.

Connecteur indépendant, '''non affilié à Qonto ni à GoCardless'''.

{| class="wikitable"
|-
! Éditeur || arcchester
|-
! Licence || GPL v3
|-
! Compatibilité Dolibarr || 20.0 à 24.x (testé sur 20.0.4 et 24.0.0, PHP 8.2)
|-
! PHP || 7.4 à 8.3
|-
! Prérequis || Module Banque actif ; module Cron recommandé pour les relevés automatiques
|-
! Dépendances || Aucune (cURL pur)
|}

== Le besoin traité ==

Relever le compte automatiquement, rapprocher les factures et créer les dépenses depuis le relevé est le deuxième besoin exprimé sur le forum Dolibarr francophone, après la facture électronique. Aujourd'hui, il faut exporter un fichier depuis sa banque, l'importer, puis pointer à la main.

== Fonctionnalités ==

# '''Connexion Qonto''' en deux champs : identifiant d'organisation et clé secrète. Tous les comptes de l'organisation sont remontés, avec les pièces jointes des transactions récentes.
# '''Connexion open banking''' (GoCardless Bank Account Data) : choix de la banque, consentement sur le site de la banque, retour dans Dolibarr, et renouvellement guidé avant expiration du consentement.
# '''Relevé automatique''' toutes les heures par tâche planifiée, incrémental et sans doublon.
# '''Boîte de réception''' des lignes nouvelles : rapprocher avec une facture client ou fournisseur, créer une facture fournisseur réglée, enregistrer un paiement divers, lier un virement interne, ignorer, ou laisser une règle proposer l'action.
# '''Règles''' du type « le libellé contient X → fournisseur Y, compte Z ». Les règles '''proposent''', l'utilisateur valide.
# '''Deux chemins d'intégration''' : seul, le module écrit dans le compte bancaire natif de Dolibarr ; avec [[Module DoliBank Match|DoliBank Match]] installé, il alimente son moteur de rapprochement explicable (candidats, scores, lettrage multi-factures, paiements partiels).
# '''Contrôle de solde''' : solde de la banque comparé au solde Dolibarr, compte par compte, tout écart étant signalé.

Interface et documentation en français et en anglais.

== Installation ==

# Copier <code>dolibanksync/</code> dans <code>htdocs/custom/</code>, ou installer le zip depuis ''Accueil → Configuration → Modules/Applications → Déployer/installer un module externe''.
# Activer '''DoliBank Sync''' (famille « Finance / Facturation »).
# Attribuer les droits : consulter, traiter les lignes, gérer les connexions, configurer.
# Pour l'open banking : créer un compte sur <code>bankaccountdata.gocardless.com</code>, générer les « User secrets » et les saisir dans ''Configuration → DoliBank Sync''.

L'usage de l'open banking suppose un compte chez le fournisseur d'agrégation, dont les conditions et les éventuels frais lui sont propres.

== Utilisation ==

# ''Banque → DoliBank Sync → Connexions bancaires → Nouvelle connexion'' : Qonto (identifiant + clé secrète), open banking (choix de la banque puis consentement sur son site), ou bac à sable pour essayer sans compte.
# Associer chaque compte remonté à un compte bancaire Dolibarr, cocher « Relever », enregistrer.
# '''« Relever maintenant »''' ou attendre la tâche horaire. Les lignes apparaissent dans la boîte de réception, et dans le compte bancaire Dolibarr (mode natif) ou dans DoliBank Match.
# Depuis une ligne : rapprocher une facture, créer une facture fournisseur réglée, un paiement divers, lier un virement interne, ou ignorer. Les règles pré-remplissent l'action proposée.

=== Mode natif : traitement des lignes bancaires ===

À l'import, chaque transaction devient une ligne du compte bancaire, dite '''ligne provisoire'''. Rapprocher une facture crée le règlement natif et le '''lie à cette ligne''' — aucune ligne n'est créée en double. Un paiement divers crée sa propre ligne : la ligne provisoire, si elle n'est pas encore rapprochée, est remplacée. Un virement interne relie les deux lignes existantes.

== Historique des versions ==

{| class="wikitable"
|-
! Version !! Apports principaux
|-
| 1.0.0 || Version initiale : connecteurs Qonto et open banking GoCardless, relevé horaire incrémental et dédoublonné, boîte de réception avec six actions, règles de proposition, intégration native ou via DoliBank Match, contrôle de solde, FR/EN
|}

== Support ==

* Contact : support@arcchester.com
* Autres modules du même éditeur : [https://www.dolistore.com/recherche?controller=search&search_query=arcchester recherche « arcchester » sur le Dolistore]

[[Category:Modules complémentaires]]

Module Pennylane Sync

2026-09-06T12:02:07Z

Arcchester: Documentation du module externe Pennylane Sync (editeur arcchester)

Module E-Reporting France

2026-09-06T12:02:06Z

Arcchester: Documentation du module externe E-Reporting France (editeur arcchester)

== Module E-Reporting France ==

'''E-Reporting France''' est un module complémentaire pour Dolibarr ERP/CRM qui '''transmet vos données de transaction et de paiement à votre Plateforme Agréée''', directement depuis Dolibarr. C'est le second volet de la réforme française de la facturation électronique — celui que la facture Factur-X ne couvre pas.

Le module est développé contre les '''spécifications externes de la DGFiP v3.2 du 30 avril 2026''', dont les schémas XSD du flux 10 sont embarqués dans le module.

{| class="wikitable"
|-
! Éditeur || arcchester
|-
! Licence || GPL v3
|-
! Compatibilité Dolibarr || 20.0 à 24.x (testé sur 20.0.4 et 24.0.0)
|-
! PHP || 7.4 à 8.3
|-
! Prérequis || Modules Facturation et Tiers ; module Cron recommandé
|-
! Dépendances || Aucune (cURL seul : pas de Composer, pas de SDK)
|}

== L'obligation couverte ==

À partir du '''1er septembre 2027''', toute entreprise assujettie à la TVA doit transmettre à l'administration, via sa Plateforme Agréée :

* ses '''ventes aux particuliers''' (B2C), en France comme à l'étranger ;
* ses '''opérations avec des entreprises étrangères''', à la vente comme à l'achat ;
* les '''données de paiement''' de ses prestations de services.

Ces opérations n'ont pas de facture électronique et ne passent donc pas par le circuit Factur-X. L'amende est de '''500 € par transmission manquante''', plafonnée à 15 000 € par an (article 1788 D du CGI, montant doublé par la loi de finances pour 2026).

== Fonctionnalités ==

# '''Classement de chaque opération''' : B2B France (hors périmètre), B2C, vente à l'international, achat à l'international. Chaque décision affiche la règle qui l'a produite, et une surcharge par tiers permet de la contredire.
# '''Agrégation conforme''' : le B2C part par jour, devise et catégorie — jamais facture par facture, comme l'impose le flux 10.3. L'international part facture par facture.
# '''Deux calendriers tenus séparément''' : au réel normal mensuel, les transactions se déclarent par décade, trois fois par mois, mais les paiements '''une seule fois par mois'''. Le module suit les deux rythmes avec leurs échéances et leurs retards propres.
# '''Ventilation des encaissements''' par taux, au centime, sur la part prestations de services. Règlements partiels et multi-factures compris.
# '''Production du message officiel''' du flux 10, '''validé contre le XSD de la DGFiP avant l'envoi''' : un message non conforme n'est ni écrit ni transmis.
# '''Transmission''' via un bac à sable, un dépôt de fichier manuel, une API REST générique, ou les connecteurs du module [[Module PA Transmission|PA Transmission]] s'il est installé.
# '''Journalisation''' de chaque tentative, de chaque réponse et de chaque rejet, avec possibilité de rejeu.

== Ce que le module ne fait pas ==

* '''Il n'est pas une Plateforme Agréée.''' Dolibarr équipé de ce module est une « solution compatible » au sens des spécifications externes : il ne dialogue jamais directement avec le portail public de facturation, il remet son flux à votre plateforme.
* Il n'émet pas de factures électroniques B2B — voir [[Module Factur-X France|Factur-X France]] et [[Module PA Transmission|PA Transmission]].
* Il ne remplace pas la déclaration de TVA — voir [[Module DoliTax|DoliTax]].
* Il ne produit '''aucun message pour une période sans opération''' : les spécifications v3.2 suppriment l'obligation d'« e-reporting à blanc ».

== Installation ==

# Télécharger le zip <code>module_ereportingfrance-x.y.z.zip</code>, puis dans Dolibarr : ''Accueil → Configuration → Modules/Applications → Déployer/installer un module externe''.
# Activer '''E-Reporting France''' (famille « Finance / Facturation »).

== Configuration ==

# Renseigner le '''SIREN''' de votre société dans la configuration du système : sans lui, aucune transmission n'est possible.
# Choisir votre '''régime déclaratif de TVA''' et votre '''connecteur''' dans la configuration du module, puis tester le connecteur.
# Facultatif : fixer une '''date de début''' avant laquelle rien ne doit être déclaré, pour une mise en route sur un historique existant.

== Utilisation ==

Le module ouvre les périodes déclaratives selon le calendrier de votre régime, y range les opérations classées, produit le message du flux 10, le valide, puis le transmet. Chaque période affiche son échéance, son contenu, son état et l'historique de ses tentatives. Une page dédiée permet de reprendre à la main une opération dont le classement automatique ne convient pas.

== Historique des versions ==

{| class="wikitable"
|-
! Version !! Apports principaux
|-
| 1.0.0 || Version initiale : classement des opérations avec règle affichée et surcharge par tiers, agrégation B2C par jour/devise/catégorie, double calendrier transactions/paiements, ventilation des encaissements par taux, génération et validation XSD du flux 10 (spécifications DGFiP v3.2), connecteurs bac à sable / fichier / REST générique / PA Transmission, journal et rejeu, FR/EN
|}

== Support ==

* Contact : support@arcchester.com
* Autres modules du même éditeur : [https://www.dolistore.com/recherche?controller=search&search_query=arcchester recherche « arcchester » sur le Dolistore]

[[Category:Modules complémentaires]]

Module PeppolConnect

2026-09-06T12:02:05Z

Arcchester: Documentation du module externe PeppolConnect (editeur arcchester)

== Module PeppolConnect ==

'''PeppolConnect''' est un module complémentaire pour Dolibarr ERP/CRM qui génère des factures et avoirs au format '''UBL Peppol BIS Billing 3.0''', les '''valide localement avant envoi''', puis les transmet via l'API du '''point d'accès Peppol''' de votre choix. Il reçoit également les factures fournisseurs arrivées par le réseau.

Cible principale : les entreprises '''belges''' (facturation électronique B2B obligatoire par Peppol depuis le 1er janvier 2026) et les échanges intra-UE sur le réseau Peppol.

{| class="wikitable"
|-
! Éditeur || arcchester
|-
! Licence || GPL v3
|-
! Compatibilité Dolibarr || 18.0 à 24.x (activation vérifiée sur 18.0.5, 20.0.1 et 24.0.0)
|-
! PHP || 7.4 minimum (extensions cURL et XML)
|-
! Dépendances || Aucune (pas de Java, pas de Composer, pas de SDK)
|-
! Langues || Français, anglais, néerlandais
|}

== Ce que le module n'est pas ==

'''PeppolConnect n'est pas un point d'accès Peppol''' : il ne parle ni AS4 ni SMP. Il prépare, contrôle, dépose et suit vos documents chez un prestataire certifié (Peppyrus, e-invoice.be, Scrada, B2Brouter, Storecove…), chez qui un abonnement peut être nécessaire.

En France, la conformité à la réforme de la facturation électronique passe par une '''Plateforme Agréée''' : ce module ne la remplace pas — voir [[Module Factur-X France|Factur-X France]] et [[Module PA Transmission|PA Transmission]].

== Fonctionnalités ==

* '''Identifiants Peppol résolus automatiquement''' depuis la fiche société et les fiches tiers : numéro d'entreprise belge (schéma 0208, contrôle modulo 97), SIRET (0009), SIREN (0002), numéro de TVA par pays. Une surcharge reste possible par un champ « Identifiant Peppol » sur le tiers.
* '''Génération UBL''' : facture (380), acompte (386) et avoir (381) avec référence à la facture d'origine ; remises de ligne et remises globales ; déduction d'acomptes ; ventilation de TVA par catégorie EN 16931 avec motifs d'exonération et codes VATEX ; moyens de paiement UNTDID 4461, IBAN et BIC.
* '''Validation locale avant envoi''' : contrôle XSD, puis une quarantaine de règles EN 16931. La conformité est prouvée contre le '''Schematron officiel''' Peppol BIS Billing 3.0.
* '''Comportement fail-closed''' : une donnée obligatoire manquante bloque la génération et affiche une erreur lisible (adresse client incomplète, identifiant non résolu, taux nul sans catégorie de TVA…). Aucun fichier partiel n'est produit.
* '''Encart sur la fiche facture''' : destinataire Peppol résolu, statut du dernier document, boutons « Générer l'UBL » et « Télécharger ».
* '''Suivi''' : page ''Documents Peppol'' avec bandeau de KPI, filtre par statut, téléchargement et envoi dès qu'un connecteur est configuré.
* '''Réception des factures fournisseurs''' arrivées par le réseau, importées en brouillon.
* '''Diagnostic''' dans l'onglet ''À propos'' : extensions PHP, table, identifiant émetteur, TVA de la société, prestataire, correspondance des taux de TVA.

== Installation ==

# Décompresser l'archive pour obtenir le dossier <code>peppolconnect/</code> et le copier dans <code>htdocs/custom/</code> — ou installer le zip depuis ''Accueil → Configuration → Modules/Applications → Déployer/installer un module externe''.
# Activer '''PeppolConnect''' (famille « Finance / Facturation »).

== Configuration ==

Menu ''Configuration → Modules → PeppolConnect'' :

* '''Prestataire''' (point d'accès), '''clé API''', case « Environnement de test », '''identifiant émetteur'''.
* '''Correspondance des taux de TVA''' avec les catégories EN 16931 — importable en un clic depuis le module Factur-X France s'il est installé.
* Bouton '''« Tester la connexion »''' : le module affiche l'identifiant Peppol de votre participant tel que le prestataire le connaît.

=== Se connecter à Peppyrus (point d'accès, Belgique) ===

# Créer un compte sur <code>customer.test.peppyrus.be</code> (réseau de test) puis sur <code>customer.peppyrus.be</code> (production).
# Déclarer votre identifiant de participant et les types de documents « Peppol BIS Billing UBL Invoice V3 » et « Credit Note V3 ».
# Créer une clé API et la coller dans la configuration du module, en cochant « Environnement de test » tant que vous êtes sur le réseau de test.

== Utilisation ==

# Valider une facture client : l'encart Peppol de la fiche indique le destinataire résolu et l'état du document.
# '''« Générer l'UBL »''' produit et valide le fichier ; en cas de donnée manquante, l'erreur nomme le champ Dolibarr à corriger.
# Depuis la page ''Documents Peppol'', envoyer le document au point d'accès et suivre son statut.
# Les factures fournisseurs reçues par le réseau sont importées en brouillon, à contrôler puis valider.

== État de la version 1.0.0 ==

Génération et validation locales prouvées contre le Schematron officiel, connecteur Peppyrus (envoi, statuts, annuaire) et réception des factures fournisseurs. L'ensemble est couvert par 377 assertions exécutées hors ligne, et l'activation est vérifiée sur Dolibarr 18, 20 et 24. La validation sur le bac à sable Peppyrus en conditions réelles demande une clé d'API du prestataire.

== Historique des versions ==

{| class="wikitable"
|-
! Version !! Apports principaux
|-
| 1.0.0 || Version initiale : génération UBL Peppol BIS Billing 3.0 (factures, acomptes, avoirs), validation XSD et EN 16931, connecteur Peppyrus, réception des factures fournisseurs, résolution des identifiants Peppol, FR/EN/NL
|}

== Support ==

* Contact : support@arcchester.com
* Autres modules du même éditeur : [https://www.dolistore.com/recherche?controller=search&search_query=arcchester recherche « arcchester » sur le Dolistore]

[[Category:Modules complémentaires]]

Module DoliBank Match

2026-09-06T12:01:59Z

Arcchester: Documentation du module externe DoliBank Match (editeur arcchester)

== Module DoliBank Match ==

'''DoliBank Match''' est un module complémentaire pour Dolibarr ERP/CRM de '''rapprochement bancaire explicable'''. Il importe les relevés bancaires dans tous les formats courants, propose des correspondances avec les factures clients et fournisseurs '''en justifiant chaque proposition''', et ne comptabilise rien sans validation humaine explicite.

{| class="wikitable"
|-
! Éditeur || arcchester
|-
! Licence || GPL v3
|-
! Compatibilité Dolibarr || 18.0 à 24.x
|-
! PHP || 7.4 minimum
|-
! Prérequis || Module Banque / Caisse actif ; MySQL ou MariaDB
|-
! Dépendances || Aucune — les règlements sont écrits par les classes natives de Dolibarr
|-
! Distribution || [https://www.dolistore.com/product.php?id=3319 Fiche sur le Dolistore]
|}

== Fonctionnalités ==

=== Import de relevés ===

* Formats acceptés : '''CSV/TXT, OFX 1 et 2, QIF, ISO 20022 CAMT.052/.053/.054, MT940/STA et CODA 2.x'''.
* '''Prévisualisation avant import''' : le fichier est analysé, stocké côté serveur et rattaché à l'entité, à l'utilisateur et au compte bancaire ; rien n'est écrit tant que l'import n'est pas confirmé.
* '''Imports immuables''' et détection de doublons par empreinte SHA-256 : réimporter le même fichier ne crée jamais de doublon.
* '''Rapport des lignes rejetées''' : aucune ligne n'est perdue silencieusement.

Pour un fichier CSV, seules trois informations sont obligatoires : une date d'opération, un libellé, et soit une colonne de montant, soit deux colonnes débit et crédit. Les colonnes facultatives (devise, date de valeur, identifiant, référence, contrepartie, IBAN) sont reconnues sous leurs noms français et anglais usuels.

=== Rapprochement explicable ===

* Candidats proposés parmi les '''factures clients et fournisseurs''', les avoirs et les acomptes, chaque proposition affichant '''les éléments de preuve qui l'ont produite'''.
* Preuves prises en compte : montant, date, référence fournisseur, '''références structurées belges OGM/VCS''', '''ISO 11649 RF''', et IBAN validé du tiers.
* Le '''montant exact ne suffit jamais''' à lui seul à déclencher une proposition — garde-fou volontaire contre les faux rapprochements.
* '''Règlement multi-factures''' : un virement affecté à plusieurs factures du même tiers ; '''paiements partiels''' pris en charge.
* '''Frais bancaires''' enregistrés via <code>PaymentVarious</code>, '''virements internes''' proposés et écritures croisées.
* '''Versements de plateformes''' Stripe, PayPal et Shopify Payments normalisés, avec contrôle brut / frais / remboursements / net.
* '''Règles réutilisables''' et apprentissage IBAN — les règles '''proposent''', elles ne comptabilisent jamais d'elles-mêmes ; l'apprentissage n'a lieu qu'après validation humaine.

=== Sécurité de la comptabilisation ===

La comptabilisation native est '''désactivée par défaut''' et exige trois conditions simultanées : la permission de rapprochement, une décision explicitement validée, et la permission dédiée de comptabilisation accompagnée du réglage correspondant du module. S'y ajoutent la protection contre les doubles comptabilisations, contre les validations concurrentes et contre les sur-allocations cumulées, l'idempotence des décisions, un état d'erreur de comptabilisation explicitement non rejouable, et une '''piste d'audit en ajout seul'''.

=== Interface ===

Tableau de bord, boîte d'opérations avec filtres avancés, écran de rapprochement, règles, versements de plateformes, connecteurs, rapports. Interface et documentation en français et en anglais.

== Installation ==

# Télécharger le zip <code>module_dolibankmatch-x.y.z.zip</code> depuis le Dolistore.
# Dans Dolibarr : ''Accueil → Configuration → Modules/Applications → Déployer/installer un module externe''.
# Activer '''DoliBank Match''' (famille « Finance / Facturation »).
# Configurer un compte bancaire par défaut et les seuils de score.
# Attribuer les droits d'import et de rapprochement aux utilisateurs concernés.
# N'accorder la permission de comptabilisation qu'aux comptables autorisés, et n'activer la comptabilisation native qu'après un essai sur une copie de recette.

En cas de mise à jour depuis une version 0.2.x, désactiver puis réactiver le module pendant une fenêtre de maintenance afin que Dolibarr enregistre les nouvelles tables, les menus, la tâche planifiée et la permission de comptabilisation. '''La désactivation ne supprime pas les tables du module.'''

== Utilisation ==

# Importer un relevé et contrôler la prévisualisation avant de confirmer.
# Parcourir les propositions : chacune indique le score et les preuves retenues.
# Valider les décisions ; la comptabilisation native n'intervient qu'ensuite, et seulement si elle a été explicitement autorisée.
# Les règles permettent d'automatiser la ''proposition'' des cas récurrents, jamais leur écriture.

== Périmètre des connecteurs ==

La couche Open Banking et la synchronisation incrémentale sont implémentées avec un connecteur bac à sable déterministe : un fournisseur réel demande encore le choix du prestataire, des identifiants d'API, un parcours de consentement et son renouvellement. Pour une '''connexion bancaire réelle''' (Qonto, open banking européen), voir le module complémentaire [[Module DoliBank Sync|DoliBank Sync]], qui alimente le moteur de rapprochement de DoliBank Match.

Les versements Stripe, PayPal et Shopify Payments acceptent aujourd'hui un JSON normalisé et relient les lignes de versement aux paiements Dolibarr par identifiant externe ; les clients d'API et webhooks temps réel de ces plateformes constituent le jalon suivant.

== Historique des versions ==

{| class="wikitable"
|-
! Version !! Apports principaux
|-
| 1.3.1 || Correction d'une collision d'identifiants de module et de permissions avec DoliTax ; restauration de l'accès au tableau de bord, à l'import et à la comptabilisation lorsque les deux modules sont activés
|-
| 0.3.0 || Prévisualisation avant import et rapport des rejets ; formats OFX, QIF, CAMT, MT940, CODA ; cycle brouillon → validation → comptabilisation native ; règlements multi-factures, partiels, avoirs et acomptes ; frais bancaires et virements internes ; protections anti-doublon et anti-sur-allocation ; règles et apprentissage IBAN ; interface Open Banking et connecteur bac à sable ; versements Stripe / PayPal / Shopify Payments
|-
| 0.2.0 || Références structurées OGM/VCS et ISO 11649 RF ; référence fournisseur et IBAN dans le moteur de score ; filtres avancés ; ignorance et restauration en masse, réversibles et auditées
|-
| 0.1.0 || Premier socle : import CSV, normalisation, détection de doublons, propositions explicables, tableau de bord, permissions, audit, FR/EN
|}

== Support ==

* Contact : support@arcchester.com
* Autres modules du même éditeur : [https://www.dolistore.com/recherche?controller=search&search_query=arcchester recherche « arcchester » sur le Dolistore]

[[Category:Modules complémentaires]]

Module DoliTax

2026-09-06T12:01:58Z

Arcchester: Documentation du module externe DoliTax (editeur arcchester)

== Module DoliTax ==

'''DoliTax''' est un module complémentaire pour Dolibarr ERP/CRM destiné aux '''experts-comptables et directions financières''' : il produit une '''grille de TVA''', calcule les '''réintégrations fiscales''' et une '''provision d'impôt sur les sociétés''' à partir des seules données Dolibarr.

Le calcul est '''déterministe''' : aucune intelligence artificielle, aucun appel externe, uniquement des agrégations SQL. Mêmes entrées, mêmes résultats, au centime.

Presets '''France''' (par défaut), '''Suisse''' et '''Maroc''' — taux, régime et barèmes restent entièrement paramétrables.

{| class="wikitable"
|-
! Éditeur || arcchester
|-
! Licence || GPL v3
|-
! Compatibilité Dolibarr || 18.0 à 24.x
|-
! PHP || 7.4 minimum
|-
! Dépendances || Aucune — lecture pure : le module ne pose ni hook ni déclencheur et n'écrit dans aucune donnée métier
|-
! Distribution || [https://www.dolistore.com/product.php?id=3400 Fiche sur le Dolistore]
|}

== Fonctionnalités ==

=== 1. Grille de TVA ===

Bases HT et TVA ventilées par taux légal, côté collecté et déductible, avec le solde (TVA due ou crédit de TVA), par mois, trimestre ou année.

Les trois régimes d'exigibilité sont implémentés :

{| class="wikitable"
|-
! Régime !! Ventes !! Achats
|-
| '''Débits''' || à la date de facture || à la date de facture
|-
| '''Encaissements''' || au prorata des paiements de la période || idem
|-
| '''Mixte''' (droit commun français) || biens aux débits, services à l'encaissement || idem
|}

Règles particulières appliquées dans tous les régimes :

* '''Factures d'acompte''' : toujours prises à l'encaissement — France, art. 269-2 du CGI depuis le 01/01/2023, en alignement sur l'article 65 de la directive 2006/112/CE ; avances encaissées au Maroc.
* '''TVA déductible au paiement''' (option) : le droit à déduction naît au règlement de la facture fournisseur quel que soit le régime — droit commun marocain, activé par le preset MA.
* '''Prorata de déduction''' (option, 100 % par défaut) pour les assujettis partiels.
* Tout taux hors de la liste légale configurée bascule dans un bucket '''« Autres taux — à contrôler »''' visible à l'écran : jamais ignoré silencieusement.

Périmètre : factures validées ou payées ; brouillons et factures abandonnées exclus ; avoirs comptés en négatif.

=== 2. Réintégrations fiscales ===

Table de plafonds de déductibilité par compte comptable, avec deux sémantiques distinctes :

* '''Plafond annuel''' → réintégration du seul excédent : <code>max(0, total du compte − plafond)</code>. Exemple français : amortissements de véhicules de tourisme au-delà de 18 300 €.
* '''Plafond unitaire''' → réintégration de la '''totalité''' des lignes dont le prix unitaire dépasse le plafond : un cadeau au-dessus du seuil est intégralement non déductible, pas seulement pour son excédent. Exemple : cadeaux clients à 73 € TTC en France, 100 DH au Maroc.
* '''Plafond à 0''' en règle annuelle → compte intégralement non déductible (amendes, pénalités).

Source des montants : les écritures comptables si le module Comptabilité est actif et alimenté ; à défaut les lignes de factures fournisseurs via leur ventilation comptable, puis le compte d'achat du produit. '''La source réellement utilisée est toujours affichée.'''

=== 3. Cockpit impôt sur les sociétés ===

Chiffre d'affaires HT, résultat net comptable, réintégrations et '''provision d'IS''', puis le tableau de passage comptable → fiscal → impôt, détaillé tranche par tranche.

* Barème '''progressif''' (ventilation par tranches — France 15 % / 25 %) ou '''proportionnel par seuils''' (le taux de la tranche atteinte s'applique à tout le résultat — Maroc depuis la LF 2023, taux effectif cantonal suisse).
* '''Cotisation minimale''' optionnelle (Maroc) : <code>IS dû = max(IS barème, max(CA × taux, plancher))</code>, due même en situation déficitaire.
* Barème stocké '''par exercice''' : un nouveau barème de loi de finances ne casse pas l'historique.

== Installation ==

# Télécharger le zip <code>module_dolitax-x.y.z.zip</code> depuis le Dolistore.
# Dans Dolibarr : ''Accueil → Configuration → Modules/Applications → Déployer/installer un module externe''.
# Activer '''DoliTax''' (famille « Finance / Comptabilité »).

Les tables <code>llx_dolitax_is_brackets</code> et <code>llx_dolitax_ceilings</code> sont créées à l'activation et '''conservées''' en cas de désactivation.

== Configuration ==

# Ouvrir la configuration du module, onglet '''Options''' → choisir le preset pays → '''Appliquer le preset'''.
# Vérifier et adapter les comptes des plafonds à votre plan comptable, ainsi que le barème d'IS de l'exercice.
# Les préfixes de comptes (produits, charges, chiffre d'affaires, comptes d'impôt exclus des charges) sont paramétrables — indispensable hors plan comptable général français, le chiffre d'affaires étant en 71x au Maroc.

Droits : <code>dolitax → read</code> pour consulter les trois tableaux de bord, <code>dolitax → admin</code> pour la configuration.

== Limites assumées de la version 1.0 ==

DoliTax est un outil de '''pré-calcul et de contrôle de gestion''', pas un logiciel de liasse fiscale. Ne sont pas traités :

* l'exercice décalé (l'exercice est l'année civile) ;
* l'autoliquidation : acquisitions intracommunautaires et services intra-UE (France), impôt sur les acquisitions (Suisse), article 115 (Maroc) ;
* la TVA à l'importation, la TVA sur marge, la franchise en base ;
* la TVA non récupérable par nature (véhicules de tourisme, carburants) — à traiter via le prorata global ou hors module ;
* le report déficitaire, les crédits et réductions d'impôt, les acomptes provisionnels ;
* les contributions additionnelles (contribution sociale de 3,3 % en France, contribution sociale de solidarité marocaine) ;
* la méthode des taux de la dette fiscale nette (Suisse).

=== Points de vigilance ===

Ces comportements sont volontaires et documentés, mais doivent être connus :

* '''Mode « flux »''' (sans le module Comptabilité) : c'est une approximation de gestion. Les immobilisations achetées sur facture fournisseur y sont comptées en charge ''et'' amorties si le module Immobilisations est actif. Pour un résultat exact, activez la comptabilité : le module bascule alors automatiquement sur le grand livre.
* '''Plafond d'amortissement des véhicules''' : la règle annuelle compare le total du compte au plafond, alors que le plafond légal porte sur la base amortissable par véhicule. Avec plusieurs véhicules, saisissez le plafond cumulé correspondant.
* '''Règle unitaire''' : le seuil est comparé au prix unitaire TTC, ligne par ligne, conformément aux textes. Le cumul annuel par bénéficiaire (règle française des cadeaux) n'est pas reconstituable depuis les factures Dolibarr et n'est donc pas calculé.
* '''Factures de situation''' : traitées exactement comme le rapport de TVA natif de Dolibarr, afin que les deux états concordent.
* '''Factures abandonnées''' : exclues. Une créance devenue irrécouvrable ne fait donc pas remonter automatiquement la TVA déjà déclarée — l'ajustement reste manuel.
* '''Régime mixte et lignes de remise''' : le partage est exhaustif (services à l'encaissement, tout le reste aux débits), donc aucune ligne n'est perdue. En revanche, une ligne de remise ou de déduction d'acompte, que Dolibarr crée sans nature explicite, est traitée comme un bien : sur une facture de services, sa TVA est prise à la facturation alors que la prestation l'est à l'encaissement. Il s'agit d'un écart de calendrier — le cumul sur l'exercice reste juste.

== Historique des versions ==

{| class="wikitable"
|-
! Version !! Apports principaux
|-
| 1.0.0 || Version initiale : grille de TVA (débits / encaissements / mixte), réintégrations par plafonds annuels et unitaires, provision d'IS (barème progressif ou proportionnel, cotisation minimale), presets France / Suisse / Maroc, FR/EN
|}

== Support ==

* Contact : support@arcchester.com
* Autres modules du même éditeur : [https://www.dolistore.com/recherche?controller=search&search_query=arcchester recherche « arcchester » sur le Dolistore]

[[Category:Modules complémentaires]]

Module LogiCockpit

2026-09-06T12:01:57Z

Arcchester: Documentation du module externe LogiCockpit (editeur arcchester)

== Module LogiCockpit ==

'''LogiCockpit''' est un module complémentaire pour Dolibarr ERP/CRM qui regroupe dans un '''écran unique, entièrement en AJAX''', tout le flux commande → expédition → reliquat → facture. Expédier, suivre les reliquats et facturer les bons de livraison en masse se font sans jamais recharger la page.

{| class="wikitable"
|-
! Éditeur || arcchester
|-
! Licence || GPL v3
|-
! Compatibilité Dolibarr || 18.0 à 24.x (suite d'intégration rejouée sur Dolibarr 24.0.0)
|-
! PHP || 7.4 à 8.3
|-
! Bases de données || MySQL / MariaDB et PostgreSQL
|-
! Dépendances || Aucune — aucune modification du cœur, écritures effectuées par les classes natives Dolibarr
|-
! Distribution || [https://www.dolistore.com/product.php?id=3316 Fiche sur le Dolistore]
|}

== Le problème traité ==

Dans Dolibarr natif, expédier une commande demande une demi-douzaine d'écrans et une dizaine de clics. Suivre les reliquats impose d'ouvrir chaque commande une par une. Et en fin de mois, les bons de livraison se facturent un par un : le cœur ne sait pas regrouper plusieurs BL d'un même client dans une seule facture.

== Fonctionnalités ==

=== Bandeau de KPI temps réel ===

Quatre compteurs rafraîchis en continu : commandes en attente d'expédition, reliquats critiques en attente de stock, BL à facturer, et montant HT en attente de facturation.

=== Onglet « À expédier » — Quick-Dispatch ===

* Liste dense des commandes validées ou en cours, avec un '''badge de disponibilité du stock''' calculé produit par produit : tout en stock, livrable partiellement, ou rupture totale.
* Recherche instantanée, filtres par badge, alerte visuelle sur les commandes en retard par rapport à la date souhaitée.
* '''Tiroir de saisie rapide''' : quantités pré-remplies au maximum livrable selon le stock réel, choix de l'entrepôt source (le mieux fourni est présélectionné), détail du stock par entrepôt.
* '''« Générer et valider le bon de livraison » en un clic''', sans quitter l'écran. Le stock est décrémenté par le cœur de Dolibarr, comme d'habitude.
* '''Utilisation entièrement au clavier''' : Entrée passe à la ligne suivante, la dernière ligne valide, Échap ferme.
* '''Douchette code-barres''' : scanner une référence ou un code-barres incrémente la ligne de +1 ; enchaîner les scans puis valider.
* Garde-fous : détection des BL brouillon existants (anti-double expédition), produits gérés en lot/série redirigés vers la fiche native, revalidation de toutes les quantités côté serveur.

=== Onglet « Reliquats & backorders » ===

Liste dédiée des commandes '''partiellement livrées''', avec un badge indiquant si le stock permet de les solder. Trois résolutions, chacune en un clic :

* '''Créer une sous-commande de reliquat''' : nouvelle commande liée reprenant les lignes manquantes (prix, TVA, remises et champs complémentaires conservés) ; la commande initiale est classée livrée ; la traçabilité est visible dans les objets liés.
* '''Clôturer le solde''' : abandon du reste à livrer, libération du stock prévisionnel, trace horodatée en note privée.
* '''Alerte client''' : email d'information pré-rempli (articles restants et quantités), à copier ou à ouvrir dans votre messagerie.

=== Onglet « À facturer » — Facturation groupée ===

* Tous les BL validés non facturés, '''regroupés par client''' avec sous-totaux.
* Sélection par bon de livraison ou par client entier, barre de sélection flottante affichant le total en direct.
* '''Une seule facture par client''', quel que soit le nombre de BL sélectionnés, avec une ligne séparatrice entre les lots : ''« --- Bon de livraison BL2607-0012 du 12/07/2026 --- »''.
* Prix, TVA, remises, unités et champs complémentaires repris des lignes de commande d'origine ; liens de traçabilité facture ↔ BL ↔ commandes créés ; BL passés au statut ''Facturé'' (le déclencheur <code>SHIPPING_BILLED</code> est émis).
* Factures créées '''en brouillon''' pour relecture ; validation automatique disponible en option.

== Gain mesuré ==

{| class="wikitable"
|-
! Tâche !! Dolibarr natif !! Avec LogiCockpit
|-
| Expédier une commande || ~10 clics, 6 écrans || 2 clics, aucun rechargement
|-
| Trouver les reliquats || Commande par commande || Liste dédiée + badge de stock
|-
| Résoudre un reliquat || Recréation manuelle || 1 clic (sous-commande liée)
|-
| Facturer 40 BL en fin de mois || 40 factures une par une || 2 clics
|}

== Installation ==

# Télécharger le zip <code>module_logicockpit-x.y.z.zip</code> depuis le Dolistore.
# Dans Dolibarr : ''Accueil → Configuration → Modules/Applications → Déployer/installer un module externe''.
# Activer '''LogiCockpit''' dans la liste des modules (famille « Produits / Stock »).
# Les modules Commandes, Expéditions, Factures et Stocks doivent être actifs.

== Utilisation ==

Le module n'ajoute aucune table : il lit et écrit exclusivement via les classes natives de Dolibarr. Tout se passe dans la page ''Cockpit'', accessible depuis le menu logistique, organisée en trois onglets décrits ci-dessus.

== Historique des versions ==

{| class="wikitable"
|-
! Version !! Apports principaux
|-
| 1.0.1 || Compatibilité Dolibarr 24.0 : le modèle PDF de repli de la facturation groupée était <code>crabe</code>, supprimé du cœur en 24.0 — remplacé par <code>sponge</code>, présent de la V18 à la V24. Suite d'intégration rejouée sur 24.0.0 (69/69).
|-
| 1.0.0 || Version initiale : bandeau KPI, Quick-Dispatch avec douchette, reliquats et sous-commandes liées, facturation groupée par client, FR/EN
|}

== Support ==

* Contact : support@arcchester.com
* Autres modules du même éditeur : [https://www.dolistore.com/recherche?controller=search&search_query=arcchester recherche « arcchester » sur le Dolistore]

[[Category:Modules complémentaires]]

Module PDF Annexes

2026-09-06T12:01:56Z

Arcchester: Documentation du module externe PDF Annexes (editeur arcchester)

== Module PDF Annexes ==

'''PDF Annexes''' est un module complémentaire pour Dolibarr ERP/CRM qui '''fusionne automatiquement vos annexes PDF''' — conditions générales de vente, fiches techniques, RIB, plaquettes — dans les PDF de vos '''devis, commandes et factures'''. Le document généré est un fichier unique, envoyé tel quel par email : plus de CGV oubliées ni expédiées dans une pièce jointe séparée.

{| class="wikitable"
|-
! Éditeur || arcchester
|-
! Licence || GPL v3
|-
! Compatibilité Dolibarr || 18.0 à 24.x (validé sur Dolibarr 24.0.0)
|-
! PHP || 7.4 à 8.3
|-
! Dépendances || Aucune — le module utilise le moteur PDF déjà présent dans Dolibarr (TCPDI), sans librairie externe ni binaire serveur
|-
! Distribution || [https://www.dolistore.com/product.php?id=3315 Fiche sur le Dolistore]
|}

== Fonctionnalités ==

* '''Fusion native''' : le PDF officiel Dolibarr et vos annexes ne forment plus qu'un seul fichier, généré au même emplacement que d'habitude — aucun changement dans vos habitudes d'envoi.
* '''Règles conditionnelles sans code''' :
** par '''type de document''' : devis, commandes, factures ;
** par '''montant TTC''' (minimum / maximum) — par exemple joindre une plaquette seulement au-delà de 5 000 € ;
** par '''pays du tiers''' (« parmi FR, BE, CH » ou « hors de FR ») — par exemple des CGV export ;
** par '''langue du document''' — CGV françaises ou anglaises selon la langue de la facture.
* '''Position au choix''' : page de garde (avant le document) ou annexe (après).
* '''Fiches techniques produits automatiques''' : les PDF attachés aux produits présents dans les lignes du document sont annexés d'eux-mêmes, une seule fois par produit, selon un motif de nom configurable (par exemple <code>FT_*.pdf</code>).
* '''Validation à l'upload''' : chaque PDF est testé par le moteur de fusion au moment de l'envoi. Un fichier protégé ou incompatible est refusé immédiatement avec un message clair, au lieu d'échouer silencieusement plus tard.
* '''Jamais bloquant''' : si une annexe pose problème à la génération, elle est simplement omise ; en cas d'échec de la fusion, le document natif reste intact.
* '''Compatible Factur-X''' : les factures électroniques PDF/A-3 produites par le module [[Module Factur-X France|Factur-X France]] ne sont jamais altérées (option <code>PDFANNEXES_SKIP_IF_FACTURX</code>, activée par défaut).
* Compatible avec les modèles de document du cœur (azur, sponge, eratosthene…) sans aucune modification de ceux-ci.
* Interface et documentation en français et en anglais.

== Installation ==

# Télécharger le zip <code>module_pdfannexes-x.y.z.zip</code> depuis le Dolistore.
# Dans Dolibarr : ''Accueil → Configuration → Modules/Applications → Déployer/installer un module externe''.
# Activer '''PDF Annexes''' dans la liste des modules (famille « Outils »).

== Configuration : vos CGV en deux minutes ==

# Ouvrir la configuration du module et envoyer votre PDF de CGV.
# Créer la règle « CGV » : documents ciblés = devis + commandes + factures, position = fin de document. Enregistrer.
# C'est terminé. Chaque PDF généré contient désormais vos CGV, et l'envoi par email joint ce fichier unique.

Les règles suivantes se créent de la même manière, en ajoutant les conditions voulues (montant, pays, langue).

== Limites connues ==

* Les PDF '''protégés par mot de passe''' ne peuvent pas être fusionnés — ils sont refusés dès l'upload, avec un message explicite.
* Les liens cliquables et les champs de formulaire des annexes sont '''aplatis''' lors de la fusion. Sans conséquence pour des CGV ou des fiches techniques.
* La numérotation « Page X/Y » du document natif n'est pas recalculée après ajout des annexes.

== Historique des versions ==

{| class="wikitable"
|-
! Version !! Apports principaux
|-
| 1.0.0 || Version initiale : fusion via le hook <code>afterPDFCreation</code>, règles conditionnelles (type, montant, pays, langue), position avant/après, fiches techniques produits, validation à l'upload, exclusion Factur-X, FR/EN
|}

Ce module a été diffusé sous le nom « DoliSmart PDF » avant sa version 1.0.0 ; il a été renommé '''PDF Annexes''' pour éviter toute confusion avec l'application mobile ''DoliSmart'', sans lien avec ce module.

== Support ==

* Contact : support@arcchester.com
* Autres modules du même éditeur : [https://www.dolistore.com/recherche?controller=search&search_query=arcchester recherche « arcchester » sur le Dolistore]

[[Category:Modules complémentaires]]

Module PA Reception

2026-09-06T12:01:51Z

Arcchester: Documentation du module externe PA Reception (editeur arcchester)

== Module PA Reception ==

'''PA Reception''' (Réception PA) est un module complémentaire pour Dolibarr ERP/CRM qui '''reçoit les factures fournisseurs électroniques''' depuis une '''Plateforme Agréée''' (PA, ex-PDP), les importe automatiquement en factures fournisseurs Dolibarr, et émet les '''statuts obligatoires du cycle de vie''' (reçue, refusée, encaissée).

La réception des factures électroniques est obligatoire pour '''toutes''' les entreprises assujetties à la TVA dès le '''1er septembre 2026''', y compris celles qui n'émettront qu'en 2027. Ce module couvre cette obligation côté Dolibarr.

{| class="wikitable"
|-
! Éditeur || arcchester
|-
! Licence || GPL v3
|-
! Compatibilité Dolibarr || 18.0 à 24.x
|-
! PHP || 7.4 minimum (extension cURL)
|-
! Dépendances || Aucune (cURL pur : pas de Composer, pas de SDK, pas d'OCR)
|-
! Distribution || [https://www.dolistore.com/product.php?id=3322 Fiche sur le Dolistore]
|}

== Fonctionnalités ==

* '''Boîte de réception''' : relève les factures entrantes depuis la Plateforme Agréée.
* '''Import automatique''' en facture fournisseur Dolibarr à l'état brouillon, avec rapprochement du fournisseur par '''SIRET''' (création de la fiche tiers si elle n'existe pas) et protection anti-doublon.
* '''Émission des statuts obligatoires''' du cycle de vie vers la plateforme : ''reçue'' (accusé de réception), ''refusée'' (avec motif), ''encaissée''.
* '''Analyse Factur-X / CII (EN 16931) native''' : les données sont lues dans le XML structuré, il ne s'agit pas d'une reconnaissance de caractères sur le PDF — donc aucune erreur de lecture.
* Encart « origine PA » sur la fiche facture fournisseur, rappelant la provenance et l'état.
* '''Architecture ouverte à connecteurs''' : brancher une nouvelle plateforme revient à écrire une classe qui implémente <code>PaInboundConnectorInterface</code>.
* Interface et documentation en français et en anglais.

== Connecteurs fournis ==

{| class="wikitable"
|-
! Connecteur !! État !! Configuration
|-
| '''Sandbox''' || Prêt à l'emploi || Aucune — des factures d'exemple sont intégrées au module
|-
| '''PA REST générique''' || Prêt à l'emploi || Endpoint + clé de votre contrat
|}

=== Conventions du connecteur REST ===

GET {endpoint}/inbox → [{ "id", "filename", "date" }]
GET {endpoint}/messages/{id}/file → contenu XML brut
POST {endpoint}/messages/{id}/status → { "status", "reason" }

Authentification : <code>Authorization: Bearer <clé></code>.

== Prérequis ==

* Le module '''Fournisseurs''' de Dolibarr doit être actif.
* Un accès à une Plateforme Agréée pour le connecteur « PA REST ». Le connecteur Sandbox permet de tester le module de bout en bout sans aucun compte.

== Installation ==

# Télécharger le zip <code>module_pareception-x.y.z.zip</code> depuis le Dolistore.
# Dans Dolibarr : ''Accueil → Configuration → Modules/Applications → Déployer/installer un module externe''.
# Activer '''PA Reception''' dans la liste des modules (famille « Finance / Facturation »).

== Configuration ==

Menu ''Configuration → Modules → PA Reception'' :

* '''Connecteur''' : Sandbox (test immédiat) ou PA REST, puis l'endpoint et la clé de votre plateforme.
* Comportement d'import : création automatique du fournisseur inconnu, émission automatique de l'accusé de réception.

== Utilisation ==

# Menu ''Facturation | Paiement → Réception PA''.
# '''« Relever la boîte »''' : la liste des factures entrantes s'affiche.
# '''« Importer »''' : la facture fournisseur est créée en brouillon, rattachée au bon tiers, et l'accusé de réception est émis.
# Refuser une facture depuis la boîte de réception envoie le statut ''refusée'' à la plateforme avec le motif saisi.

== Place dans la gamme ==

Réception : '''PA Reception'''. Émission : [[Module Factur-X France|Factur-X France]] (génération) et [[Module PA Transmission|PA Transmission]] (envoi). Émission + réception = conformité complète à la réforme.

== Historique des versions ==

{| class="wikitable"
|-
! Version !! Apports principaux
|-
| 1.0.0 || Version initiale : boîte de réception, import Factur-X/CII en facture fournisseur, rapprochement par SIRET, statuts de cycle de vie, connecteurs Sandbox et PA REST, FR/EN
|}

== Support ==

* Contact : support@arcchester.com
* Autres modules du même éditeur : [https://www.dolistore.com/recherche?controller=search&search_query=arcchester recherche « arcchester » sur le Dolistore]

[[Category:Modules complémentaires]]

Module Shopify Sync

2026-09-06T12:01:50Z

Arcchester: Documentation du module externe Shopify Sync (editeur arcchester)

Module PA Transmission

2026-09-06T12:01:49Z

Arcchester: Documentation du module externe PA Transmission (editeur arcchester)

== Module PA Transmission ==

'''PA Transmission''' (anciennement « PDP Transmission ») est un module complémentaire pour Dolibarr ERP/CRM qui '''transmet vos factures Factur-X à une Plateforme Agréée''' (PA) du réseau français de facturation électronique, et suit leur '''cycle de vie''' (déposée → reçue → acceptée / refusée) directement dans Dolibarr.

Depuis juillet 2025, les PDP (Plateformes de Dématérialisation Partenaires) sont officiellement devenues des '''Plateformes Agréées (PA)''' dans la terminologie de la DGFiP.

C'est le complément du module [[Module Factur-X France|Factur-X France]] : celui-ci ''génère'' le fichier Factur-X, celui-là le ''transmet'' sur le réseau — l'étape qu'impose la réforme.

{| class="wikitable"
|-
! Éditeur || arcchester
|-
! Licence || GPL v3
|-
! Compatibilité Dolibarr || 18.0 à 24.x
|-
! PHP || 7.4 minimum (extension cURL)
|-
! Dépendances || Aucune (cURL pur : pas de Composer, pas de SDK)
|-
! Distribution || [https://www.dolistore.com/product.php?id=3211 Fiche sur le Dolistore]
|}

== Fonctionnalités ==

* Bouton '''« Transmettre »''' sur la fiche facture, avec badge de cycle de vie coloré : à transmettre / transmise / reçue / acceptée / refusée / erreur.
* Bouton '''« Rafraîchir le statut »''' : interrogation de la plateforme pour mettre à jour l'état.
* '''Transmission automatique''' optionnelle dès la validation de la facture.
* Choix du contenu transmis : le '''XML Factur-X''' seul ou le '''PDF/A-3''' complet.
* '''Architecture ouverte à connecteurs''' — brancher une nouvelle plateforme revient à écrire une classe qui implémente <code>PdpConnectorInterface</code>.
* Journalisation de chaque dépôt et de chaque réponse, pour l'audit.
* Interface et documentation en français et en anglais.

== Connecteurs fournis ==

{| class="wikitable"
|-
! Connecteur !! Type !! État !! Configuration
|-
| '''Sandbox''' || Simulateur intégré || Prêt à l'emploi || Aucune
|-
| '''Chorus Pro''' || B2G secteur public, API PISTE || Codé sur l'API documentée || Identifiants PISTE + compte technique
|-
| '''Docaposte''' || PA privée B2B (REST) || Preset nommé || Endpoint + clé de votre contrat
|-
| '''Yooz''' || PA privée B2B (REST) || Preset nommé || Endpoint + clé de votre contrat
|-
| '''PA REST générique''' || API REST || Prêt à l'emploi || Endpoint + clé
|}

'''À savoir :''' Docaposte et Yooz sont des plateformes privées dont les API ne sont pas publiques et nécessitent un contrat commercial. Le module fournit un preset nommé qui s'appuie sur le connecteur REST générique — vous renseignez l'endpoint et la clé fournis par votre prestataire. Le connecteur Chorus Pro est écrit d'après la documentation de l'API PISTE : validez-le sur la sandbox PISTE avec vos identifiants avant tout usage en production.

== Prérequis ==

* Le fichier Factur-X doit exister — il est produit par le module [[Module Factur-X France|Factur-X France]] à la validation de la facture.
* Un compte auprès d'une Plateforme Agréée pour les connecteurs autres que Sandbox.

== Installation ==

# Télécharger le zip <code>module_pdptransmission-x.y.z.zip</code> depuis le Dolistore.
# Dans Dolibarr : ''Accueil → Configuration → Modules/Applications → Déployer/installer un module externe''.
# Activer '''PA Transmission''' dans la liste des modules (famille « Finance / Facturation »).

== Configuration ==

Menu ''Configuration → Modules → PA Transmission'' :

* '''Connecteur''' : Sandbox pour tester immédiatement (aucun paramètre), ou l'un des connecteurs REST puis l'URL de l'API et la clé de votre contrat.
* '''Contenu transmis''' : XML Factur-X ou PDF/A-3.
* '''Transmission automatique''' à la validation de la facture (oui/non).

=== Conventions du connecteur REST générique ===

Le connecteur attend, de façon adaptable selon la plateforme :

POST {endpoint}/transmissions multipart : file + reference + metadata
→ { "id": "...", "status": "..." }
GET {endpoint}/transmissions/{id} Authorization: Bearer <clé>
→ { "status": "..." }

La correspondance entre les statuts de la plateforme et les statuts internes est centralisée dans <code>PdpGenericRestConnector::mapStatus()</code>.

== Utilisation ==

# Ouvrir une facture validée dont le Factur-X a été généré.
# Cliquer sur '''« Transmettre »''' — ou laisser la transmission automatique agir à la validation.
# Suivre le badge de cycle de vie ; « Rafraîchir le statut » interroge la plateforme à la demande.

== Place dans la gamme ==

Émission : [[Module Factur-X France|Factur-X France]] (génération) + '''PA Transmission''' (envoi). Réception : [[Module PA Reception|PA Reception]]. Les deux volets réunis couvrent la réforme française de la facturation électronique.

== Historique des versions ==

{| class="wikitable"
|-
! Version !! Apports principaux
|-
| 1.0.1 || Terminologie PA (ex-PDP) alignée sur la DGFiP, corrections de robustesse
|-
| 1.0.0 || Version initiale : transmission, cycle de vie, connecteurs Sandbox / Chorus Pro / REST générique / presets Docaposte et Yooz
|}

== Support ==

* Contact : support@arcchester.com
* Autres modules du même éditeur : [https://www.dolistore.com/recherche?controller=search&search_query=arcchester recherche « arcchester » sur le Dolistore]

[[Category:Modules complémentaires]]

Module Stripe Payment Links

2026-09-06T12:01:44Z

Arcchester: Documentation du module externe Stripe Payment Links (editeur arcchester)

== Module Stripe Payment Links ==

'''Stripe Payment Links''' est un module complémentaire pour Dolibarr ERP/CRM qui génère un '''lien de paiement Stripe''' (carte bancaire, Apple Pay, Google Pay) pour chaque facture client, et '''réconcilie automatiquement''' le règlement dans Dolibarr grâce au webhook Stripe. Le client paie en ligne, la facture passe à « payée » sans intervention.

{| class="wikitable"
|-
! Éditeur || arcchester
|-
! Licence || GPL v3
|-
! Compatibilité Dolibarr || 18.0 à 24.x
|-
! PHP || 7.4 minimum (extension cURL)
|-
! Dépendances || Aucune (cURL pur : pas de Composer, pas de SDK Stripe)
|-
! Distribution || [https://www.dolistore.com/product.php?id=3208 Fiche sur le Dolistore]
|}

== Fonctionnalités ==

* Bouton '''« Générer un lien de paiement Stripe »''' sur la fiche facture.
* Création de véritables ''Stripe Payment Links'' (chaîne Product → Price → Payment Link de l'API Stripe), et non de simples liens de checkout jetables.
* '''Statut visible''' sur la fiche facture : aucun lien / en attente de paiement / payé, avec la date de règlement.
* Copie du lien en un clic et '''insertion automatique dans les emails''' via le jeton de substitution <code>__STRIPEPAYMENTLINK__</code>.
* '''Webhook sécurisé''' (vérification de la signature HMAC-SHA256 de Stripe) : à réception de l'événement <code>checkout.session.completed</code>, le paiement est créé dans Dolibarr et la facture est marquée payée.
* '''Rapprochement bancaire optionnel''' : le règlement peut être affecté au compte bancaire de votre choix.
* Modes '''test''' et '''live''' séparés, bascule par la configuration.
* Interface et documentation en français et en anglais.

== Prérequis ==

* Un compte Stripe (l'ouverture est gratuite ; Stripe prélève sa commission sur les transactions).
* Une URL de webhook '''accessible en HTTPS depuis Internet''' pour la réconciliation automatique. Sans elle, le lien de paiement fonctionne mais le règlement doit être saisi à la main dans Dolibarr.

== Installation ==

# Télécharger le zip <code>module_stripepaymentlinks-x.y.z.zip</code> depuis le Dolistore.
# Dans Dolibarr : ''Accueil → Configuration → Modules/Applications → Déployer/installer un module externe'' et sélectionner le zip.
# Activer '''Stripe Payment Links''' dans la liste des modules (famille « Finance / Facturation »).
# Aucune dépendance à installer sur le serveur.

== Configuration ==

Menu ''Configuration → Modules → Stripe Payment Links'' :

* '''Clés API''' : coller la clé secrète <code>sk_test_…</code> pour les essais, et <code>sk_live_…</code> pour la production (''Stripe → Développeurs → Clés API'').
* '''Webhook''' : dans ''Stripe → Développeurs → Webhooks'', créer un endpoint pointant vers l'URL affichée par la page de configuration du module (<code>.../custom/stripepaymentlinks/webhook/stripe.php</code>), s'abonner à l'événement <code>checkout.session.completed</code>, puis coller le secret de signature <code>whsec_…</code> dans le module.
* '''Utilisateur auteur des paiements''' : l'utilisateur Dolibarr au nom duquel les règlements automatiques sont enregistrés.
* '''Compte bancaire''' de rapprochement (facultatif).
* '''Mode''' : test ou live.

== Utilisation ==

# Ouvrir une facture '''validée'''.
# Cliquer sur '''« Générer un lien de paiement Stripe »'''.
# Transmettre le lien au client — manuellement, ou en insérant <code>__STRIPEPAYMENTLINK__</code> dans le modèle d'email d'envoi de facture.
# À réception du paiement, Stripe appelle le webhook : le règlement est créé et la facture passe à « payée ». Le badge de la fiche facture affiche l'état et la date.

== Historique des versions ==

{| class="wikitable"
|-
! Version !! Apports principaux
|-
| 1.0.1 || Corrections de robustesse du webhook et du rapprochement bancaire
|-
| 1.0.0 || Version initiale : génération du lien de paiement, badge d'état, webhook signé, jeton d'email, modes test/live
|}

== Support ==

* Contact : support@arcchester.com
* Autres modules du même éditeur : [https://www.dolistore.com/recherche?controller=search&search_query=arcchester recherche « arcchester » sur le Dolistore]

[[Category:Modules complémentaires]]

Module WhatsApp Notify

2026-07-30T22:57:08Z

Arcchester: Created page with "== Module WhatsApp Notify == '''WhatsApp Notify''' est un module complémentaire pour Dolibarr ERP/CRM qui envoie les factures et les relances de paiement directement sur le..."

== Module WhatsApp Notify ==

'''WhatsApp Notify''' est un module complémentaire pour Dolibarr ERP/CRM qui envoie les factures et les relances de paiement directement sur le '''WhatsApp''' des clients, depuis Dolibarr, via l''''API Cloud officielle de Meta''' (messages template approuvés, envoi serveur, statuts de livraison). Il ne s'agit ni d'un lien « web.whatsapp » à ouvrir manuellement, ni d'une passerelle tierce payante.

{| class="wikitable"
|-
! Éditeur || arcchester
|-
! Licence || GPL v3
|-
! Compatibilité Dolibarr || 18.0 à 23.x
|-
! PHP || 7.4 minimum (extension cURL)
|-
! Dépendances || Aucune (cURL pur : pas de Composer, pas de SDK)
|-
! Distribution || [https://www.dolistore.com/product.php?id=3214 Fiche sur le Dolistore]
|}

== Fonctionnalités ==

* Bouton '''« Envoyer sur WhatsApp »''' sur la fiche facture, avec badge d'état coloré.
* '''Envoi automatique''' optionnel dès la validation de la facture (déclencheur BILL_VALIDATE).
* '''PDF de la facture en pièce jointe''' du message WhatsApp (template avec en-tête Document).
* '''Suivi de livraison en temps réel''' : envoyé / livré / '''lu''' / échec — mis à jour par le webhook Meta (signature HMAC-SHA256 vérifiée).
* Message '''template''' à 3 variables : nom du client, référence de la facture, montant TTC.
* '''Numéros internationaux''' : normalisation automatique au format E.164, indicatif par défaut configurable pour les numéros locaux.
* '''Traçabilité''' : chaque envoi est journalisé en base (identifiant de message Meta, statut, date).
* Interface et documentation en français et en anglais.

== Prérequis Meta (une seule fois, ~10 minutes) ==

Le module utilise l'API Cloud officielle — il faut donc un compte Meta :

# Un '''compte Meta Business''' (gratuit) et une application de type « Business ».
# Un '''numéro WhatsApp Business''' relié à l'API Cloud (un numéro de test est fourni gratuitement par Meta pour les essais).
# Un '''jeton d'accès permanent''' (System User) — Meta > Business Settings > Users > System users.
# Un '''template de message approuvé''' : le texte prêt à copier est fourni avec le module ; l'approbation Meta prend en général moins de 24 h.

''Note : Meta facture à la conversation/au message (directement à Meta). L'ouverture du compte et le premier template sont gratuits.''

== Installation ==

# Télécharger le zip <code>module_whatsappnotify-x.y.z.zip</code> depuis le Dolistore.
# Dans Dolibarr : ''Accueil → Configuration → Modules/Applications → Déployer/installer un module externe'' et sélectionner le zip.
# Activer le module '''WhatsApp Notify''' dans la liste des modules (famille « Interfaces avec des systèmes externes »).
# Aucune dépendance à installer sur le serveur.

== Configuration ==

Menu ''Configuration → Modules → WhatsApp Notify'' :

* '''Identifiants Meta''' : jeton d'accès permanent, Phone Number ID, WhatsApp Business Account ID, version de l'API.
* '''Webhook (suivi de livraison)''' : l'URL à déclarer dans Meta est affichée ; renseigner le verify token et l'app secret pour la vérification de signature.
* '''Messages''' : nom du template, langue du template, pièce jointe PDF (oui/non), envoi automatique à la validation (oui/non), indicatif téléphonique par défaut.

Prérequis de données : le '''numéro de téléphone''' du tiers (fiche client) doit être renseigné — de préférence au format international (+33…, +212…) ; à défaut, l'indicatif par défaut est appliqué.

== Utilisation ==

* Sur la fiche d'une '''facture validée''', un encart « Notification WhatsApp » propose le bouton d'envoi ; après envoi, il affiche le statut (envoyé / livré / lu) et le numéro du destinataire.
* En mode '''automatique''', le message part dès la validation de la facture, sans action de l'utilisateur.
* Chaque message envoyé est visible en base avec son identifiant Meta (wamid) pour audit.

== Historique des versions ==

{| class="wikitable"
|-
! Version !! Apports principaux
|-
| 1.0.0 || Version initiale : envoi manuel + automatique, template Meta, PDF en pièce jointe, webhook de statut signé, normalisation E.164, FR/EN
|}

== Support ==

* Contact : contact@arcchester.com
* Assistance : https://github.com/chakibarrama/Dolistore/issues

[[Catégorie:Modules complémentaires]]

Module Factur-X France

2026-07-29T23:31:50Z

Arcchester:

== Module Factur-X France ==

'''Factur-X France''' est un module complémentaire pour Dolibarr ERP/CRM qui génère et contrôle des factures électroniques au format '''Factur-X''' (PDF/A-3 avec XML CII conforme à la norme européenne '''EN 16931'''), dans le cadre de la réforme française de la facturation électronique (dépôt PPF / plateformes agréées, Chorus Pro pour le secteur public).

{| class="wikitable"
|-
! Éditeur || arcchester
|-
! Licence || GPL v3
|-
! Compatibilité Dolibarr || 18.0 à 24.x
|-
! PHP || 7.4 minimum
|-
! Dépendances || Aucune (module autonome : pas de Java, pas de Composer, pas de service externe)
|-
! Distribution || [https://www.dolistore.com/product.php?id=3075 Fiche sur le Dolistore]
|}

== Fonctionnalités ==

* '''Génération automatique''' du fichier Factur-X (PDF/A-3 + XML CII EN 16931) à la validation de chaque facture client — profils Minimum, Basic et Comfort (EN 16931).
* '''Types de documents''' : factures standard (380), avoirs (381), factures d'acompte (386) et factures rectificatives (384), avec la référence à la facture d'origine (BG-3) lorsque la norme l'exige.
* '''Pré-contrôle « anti-rejet »''' : un encart sur la fiche facture indique, avant émission, si la facture est conforme ; en cas d'anomalie, l'identifiant officiel de la règle en cause est affiché (ex. BR-CL-23, BR-CO-15) avec le champ Dolibarr à corriger.
* '''Secteur public (B2G) — Chorus Pro''' : les clients de type « Administration » sont détectés automatiquement ; le SIRET du destinataire, le code service exécutant et le numéro d'engagement (BT-10 / BT-13) sont contrôlés avant émission.
* '''Tableau de bord de conformité''' : score de conformité sur une période, règles en échec agrégées, détail par facture, et export par lot (ZIP) des XML Factur-X.
* '''QR de paiement SEPA''' (option, norme EPC069-12) : un QR-code imprimé sur le PDF permet au client de pré-remplir son virement (bénéficiaire, IBAN, montant, référence) en le scannant avec son application bancaire. Jamais imprimé sur les avoirs.
* '''Comportement fail-safe''' : une facture non conforme ne produit aucun fichier électronique douteux — le PDF standard de Dolibarr est conservé tel quel et l'anomalie est expliquée.
* Interface et documentation en français et en anglais.

== Conformité ==

Les fichiers produits sont validés avec les outils de référence utilisés par les plateformes :

* '''Schéma XSD officiel''' Factur-X / EN 16931 (validation structurelle, également exécutée en local avant chaque émission) ;
* '''Schematron officiel EN 16931''' (règles métier BR-*, BR-CO-*, BR-CL-*) ;
* '''veraPDF''' pour la conformité PDF/A-3b du PDF final ;
* Compatibilité '''ZUGFeRD 2.x''' : Factur-X et ZUGFeRD partagent la même spécification, les fichiers sont donc également utilisables avec des clients allemands.

== Installation ==

# Télécharger le zip <code>module_facturxfrance-x.y.z.zip</code> depuis le Dolistore.
# Dans Dolibarr : ''Accueil → Configuration → Modules/Applications → Déployer/installer un module externe'' et sélectionner le zip.
# Activer le module '''FacturXFrance''' dans la liste des modules.
# Aucune dépendance à installer sur le serveur.

== Configuration ==

Menu ''Configuration → Modules → FacturXFrance'' :

* '''Profil Factur-X''' : Minimum, Basic ou Comfort (recommandé pour PPF/PDP).
* '''Correspondance des taux de TVA''' : associer chaque taux local au code UNCL 5305 (S, Z, E, AE, K, G, O).
* '''Correspondance des unités''' : associer les unités Dolibarr aux codes UN/CEFACT (C62, HUR, KGM…).
* '''QR de paiement''' : case à cocher (désactivé par défaut).
* Un onglet ''À propos'' fournit un panneau de diagnostic (versions, extensions PHP) utile au support.

Prérequis de données pour une facture conforme : SIRET de l'émetteur, TVA intracommunautaire, compte bancaire (IBAN/BIC) associé à la facture, SIRET du client français. Pour un client « Administration » : renseigner le code service exécutant ou le numéro d'engagement dans le champ « Réf. client » de la facture.

== Utilisation ==

* À la '''validation d'une facture''', le XML Factur-X est généré puis injecté dans le PDF (PDF/A-3). Les fichiers sont visibles dans les documents joints de la facture.
* L'encart '''Conformité Factur-X''' de la fiche facture permet de revérifier la conformité à tout moment.
* Le '''tableau de bord''' (lien depuis la page de configuration) permet d'analyser une période entière et de télécharger tous les XML conformes en un ZIP.

== Historique des versions ==

{| class="wikitable"
|-
! Version !! Apports principaux
|-
| 1.5.0 || QR de paiement SEPA (EPC069-12), compatibilité Dolibarr 18 renforcée
|-
| 1.4.0 || Secteur public B2G : contrôles Chorus Pro, BT-10 / BT-13
|-
| 1.3.0 || Factures d'acompte et rectificatives, tableau de bord de conformité, export par lot
|-
| 1.2.0 || Avoirs (BG-3), validation XSD à l'exécution, comportement fail-safe
|-
| 1.1.x || Pré-contrôle EN 16931 en PHP, conformité PDF/A-3 (veraPDF)
|-
| 1.0.x || Génération Factur-X initiale (XSD + Schematron)
|}

== Support ==

* Contact : contact@arcchester.com
* Les demandes accompagnées d'une capture de l'onglet ''À propos'' (diagnostic) sont traitées plus rapidement.

[[Catégorie:Modules complémentaires]]

Module Factur-X France

2026-07-29T23:26:02Z

Arcchester: Création de la page du module Factur-X France (module complémentaire Dolistore)

== Module Factur-X France ==

'''Factur-X France''' est un module complémentaire pour Dolibarr ERP/CRM qui génère et contrôle des factures électroniques au format '''Factur-X''' (PDF/A-3 avec XML CII conforme à la norme européenne '''EN 16931'''), dans le cadre de la réforme française de la facturation électronique (dépôt PPF / plateformes agréées, Chorus Pro pour le secteur public).

{| class="wikitable"
|-
! Éditeur || arcchester
|-
! Licence || GPL v3
|-
! Compatibilité Dolibarr || 18.0 à 24.x
|-
! PHP || 7.4 minimum
|-
! Dépendances || Aucune (module autonome : pas de Java, pas de Composer, pas de service externe)
|-
! Distribution || [https://www.dolistore.com/product.php?id=3075 Fiche sur le Dolistore]
|}

== Fonctionnalités ==

* '''Génération automatique''' du fichier Factur-X (PDF/A-3 + XML CII EN 16931) à la validation de chaque facture client — profils Minimum, Basic et Comfort (EN 16931).
* '''Types de documents''' : factures standard (380), avoirs (381), factures d'acompte (386) et factures rectificatives (384), avec la référence à la facture d'origine (BG-3) lorsque la norme l'exige.
* '''Pré-contrôle « anti-rejet »''' : un encart sur la fiche facture indique, avant émission, si la facture est conforme ; en cas d'anomalie, l'identifiant officiel de la règle en cause est affiché (ex. BR-CL-23, BR-CO-15) avec le champ Dolibarr à corriger.
* '''Secteur public (B2G) — Chorus Pro''' : les clients de type « Administration » sont détectés automatiquement ; le SIRET du destinataire, le code service exécutant et le numéro d'engagement (BT-10 / BT-13) sont contrôlés avant émission.
* '''Tableau de bord de conformité''' : score de conformité sur une période, règles en échec agrégées, détail par facture, et export par lot (ZIP) des XML Factur-X.
* '''QR de paiement SEPA''' (option, norme EPC069-12) : un QR-code imprimé sur le PDF permet au client de pré-remplir son virement (bénéficiaire, IBAN, montant, référence) en le scannant avec son application bancaire. Jamais imprimé sur les avoirs.
* '''Comportement fail-safe''' : une facture non conforme ne produit aucun fichier électronique douteux — le PDF standard de Dolibarr est conservé tel quel et l'anomalie est expliquée.
* Interface et documentation en français et en anglais.

== Conformité ==

Les fichiers produits sont validés avec les outils de référence utilisés par les plateformes :

* '''Schéma XSD officiel''' Factur-X / EN 16931 (validation structurelle, également exécutée en local avant chaque émission) ;
* '''Schematron officiel EN 16931''' (règles métier BR-*, BR-CO-*, BR-CL-*) ;
* '''veraPDF''' pour la conformité PDF/A-3b du PDF final ;
* Compatibilité '''ZUGFeRD 2.x''' : Factur-X et ZUGFeRD partagent la même spécification, les fichiers sont donc également utilisables avec des clients allemands.

== Installation ==

# Télécharger le zip <code>module_facturxfrance-x.y.z.zip</code> depuis le Dolistore.
# Dans Dolibarr : ''Accueil → Configuration → Modules/Applications → Déployer/installer un module externe'' et sélectionner le zip.
# Activer le module '''FacturXFrance''' dans la liste des modules.
# Aucune dépendance à installer sur le serveur.

== Configuration ==

Menu ''Configuration → Modules → FacturXFrance'' :

* '''Profil Factur-X''' : Minimum, Basic ou Comfort (recommandé pour PPF/PDP).
* '''Correspondance des taux de TVA''' : associer chaque taux local au code UNCL 5305 (S, Z, E, AE, K, G, O).
* '''Correspondance des unités''' : associer les unités Dolibarr aux codes UN/CEFACT (C62, HUR, KGM…).
* '''QR de paiement''' : case à cocher (désactivé par défaut).
* Un onglet ''À propos'' fournit un panneau de diagnostic (versions, extensions PHP) utile au support.

Prérequis de données pour une facture conforme : SIRET de l'émetteur, TVA intracommunautaire, compte bancaire (IBAN/BIC) associé à la facture, SIRET du client français. Pour un client « Administration » : renseigner le code service exécutant ou le numéro d'engagement dans le champ « Réf. client » de la facture.

== Utilisation ==

* À la '''validation d'une facture''', le XML Factur-X est généré puis injecté dans le PDF (PDF/A-3). Les fichiers sont visibles dans les documents joints de la facture.
* L'encart '''Conformité Factur-X''' de la fiche facture permet de revérifier la conformité à tout moment.
* Le '''tableau de bord''' (lien depuis la page de configuration) permet d'analyser une période entière et de télécharger tous les XML conformes en un ZIP.

== Historique des versions ==

{| class="wikitable"
|-
! Version !! Apports principaux
|-
| 1.5.0 || QR de paiement SEPA (EPC069-12), compatibilité Dolibarr 18 renforcée
|-
| 1.4.0 || Secteur public B2G : contrôles Chorus Pro, BT-10 / BT-13
|-
| 1.3.0 || Factures d'acompte et rectificatives, tableau de bord de conformité, export par lot
|-
| 1.2.0 || Avoirs (BG-3), validation XSD à l'exécution, comportement fail-safe
|-
| 1.1.x || Pré-contrôle EN 16931 en PHP, conformité PDF/A-3 (veraPDF)
|-
| 1.0.x || Génération Factur-X initiale (XSD + Schematron)
|}

== Support ==

* Contact : chakibarrama@gmail.com
* Les demandes accompagnées d'une capture de l'onglet ''À propos'' (diagnostic) sont traitées plus rapidement.

[[Catégorie:Modules complémentaires]]