ImportFactuSOL — Module Dolibarr

Migrez vos données FactuSOL vers Dolibarr en un seul clic.

ImportFactuSOL est un module Dolibarr destiné aux entreprises espagnoles qui souhaitent passer de FactuSOL — l'un des logiciels de gestion et de facturation pour PME les plus populaires en Espagne — à Dolibarr, sans avoir à ressaisir des années de données à la main.

Téléversez le ZIP de sauvegarde FactuSOL, cliquez sur Démarrer et le module s'occupe du reste : il lit les fichiers de base de données Access, fait correspondre chaque entité à son équivalent Dolibarr et importe tout au sein d'une transaction unique. En cas d'échec, un rollback complet laisse votre base de données Dolibarr intacte.

Ce qui est importé

Ce qui N'est PAS importé (par conception)

Les factures historiques, devis, bons de livraison et règlements sont intentionnellement conservés dans FactuSOL. Votre installation FactuSOL reste l'archive de tous les documents passés. Dès le jour de la migration, vous créez vos nouvelles factures dans Dolibarr, avec tous vos clients, fournisseurs, produits et stocks déjà chargés.

TVA espagnole (IVA)

Les codes de type TVA de FactuSOL sont convertis en taux réels :

Pourquoi choisir ce module

• Aucune ressaisie. Des milliers de produits, clients et fournisseurs — importés en quelques minutes, pas en plusieurs mois.
• Sécurité transactionnelle. L'intégralité de l'import s'exécute dans une transaction de base de données unique. Un échec à n'importe quelle étape annule proprement toutes les modifications.
• Résolution des provinces. Les provinces des clients et fournisseurs sont associées à la liste officielle espagnole de Dolibarr, garantissant l'intégrité référentielle plutôt que de stocker du texte libre.
• Codes-barres EAN13. Les codes-barres des produits sont importés si le type EAN13 est installé dans Dolibarr.
• Liens fournisseurs. Le fournisseur principal de chaque article est enregistré dans llx_product_fournisseur_price.
• Rapport détaillé. Après l'import, un tableau affiche importés / ignorés / avertissements par entité.
• Notification d'erreur. En cas d'échec, le développeur est automatiquement averti par e-mail pour une résolution plus rapide.

Prérequis

Serveur

Installer mdbtools

Vérification : mdb-tables --version

Hébergement mutualisé : Si votre hébergeur désactive exec(), ce module ne peut pas fonctionner. Un VPS ou un serveur dédié est nécessaire.

Installation

1. Téléchargez le ZIP du module depuis Dolistore et décompressez-le.
2. Copiez le dossier importfactusol/ dans htdocs/custom/ de votre installation Dolibarr.
3. Connectez-vous en tant qu'administrateur et allez dans Accueil → Configuration → Modules/Applications.
4. Recherchez ImportFactuSOL et cliquez sur Activer.
5. Allez dans Accueil → Configuration → ImportFactuSOL pour accéder à la page d'import.

Comment l'utiliser

1. Dans FactuSOL, allez dans Archivo → Copia de seguridad (Fichier → Sauvegarde). Le résultat est un ZIP du type FactuSOL_0012026.ZIP.
2. Sur la page de configuration ImportFactuSOL dans Dolibarr, téléversez ce ZIP.
3. Cliquez sur Démarrer l'import et patientez. Les bases volumineuses (milliers de produits et clients) peuvent prendre plusieurs minutes.
4. Consultez le tableau récapitulatif. Les enregistrements qui n'ont pas pu être importés apparaissent dans la colonne Avertissements.

Résolution des problèmes

« mdbtools n'est pas installé » — Installez mdbtools sur votre serveur (voir tableau ci-dessus) et rechargez la page. Le bouton d'upload se réactive automatiquement.

L'import échoue en cours de route — Toutes les modifications sont annulées. Aucune donnée partielle n'est écrite dans Dolibarr. Consultez le message d'erreur dans l'interface et le journal Dolibarr dans DOL_DATA_ROOT/dolibarr.log.

Avertissements de province — Un nom de province FactuSOL ne correspond pas à la liste Dolibarr. Le tiers est quand même importé ; le champ province reste vide. Vous pouvez le renseigner manuellement sur la fiche client ou fournisseur.

exec() est désactivée — Passez sur un VPS ou contactez votre hébergeur pour activer exec().

Historique des versions

1.0.0

• Version initiale
• Importe : catégories de produits, entrepôts, clients, fournisseurs, produits (avec TVA, EAN13, catégories, liens fournisseurs) et niveaux de stock
• Sécurité transactionnelle avec rollback complet en cas d'erreur
• Résolution des provinces via llx_c_departements de Dolibarr
• Compatible avec Dolibarr 17 – 22

Licence

Ce module est distribué sous licence GNU GPL v3. Chaque licence achetée autorise l'installation sur une seule instance Dolibarr. Pour les déploiements multi-instances, veuillez acheter une licence par instance.

Le code source est disponible selon les termes de la GPL v3 ; toutefois, la redistribution ou la revente de ce module — modifié ou non — n'est pas autorisée sans accord écrit préalable de l'auteur.

Auteur

Diego Cebrián — diego@cebrian-it.fr