Guide d'utilisation du module ImportBank

Table des matières

Introduction
Installation
Configuration
Utilisation
Fonctionnalités avancées
Dépannage
FAQ

1. Introduction

Le module ImportBank est conçu pour faciliter l'importation des opérations bancaires dans Dolibarr à partir de fichiers CSV. Il permet d'importer des relevés bancaires dans les comptes bancaires de Dolibarr, en offrant des fonctionnalités avancées comme :

Mappage flexible des colonnes
Prévisualisation des données avant importation
Édition des données avant importation
Mise en évidence des lignes problématiques
Choix de l'ordre d'importation

2. Installation

Pour installer le module ImportBank :

Téléchargez le module depuis le site officiel de Dolibarr ou depuis le marketplace.
Décompressez l'archive dans le répertoire htdocs/custom/ de votre installation Dolibarr.
Connectez-vous à Dolibarr en tant qu'administrateur.
Allez dans Accueil > Configuration > Modules.
Recherchez le module "ImportBank" dans la liste et cliquez sur le bouton "Activer".

3. Configuration

Aucune configuration spécifique n'est requise pour utiliser le module ImportBank. Cependant, assurez-vous que :

Vous avez au moins un compte bancaire configuré dans Dolibarr.
Vous avez les permissions nécessaires pour accéder aux comptes bancaires et y ajouter des opérations.

4. Utilisation

Étape 1 : Téléchargement du fichier CSV

Pour commencer l'importation :

Allez dans le menu Banques > Import Bancaire.
Sélectionnez le compte bancaire dans lequel vous souhaitez importer les opérations.
Cliquez sur le bouton "Parcourir" pour sélectionner votre fichier CSV.
Configurez les options d'importation :
- Séparateur CSV : Choisissez le caractère qui sépare les colonnes dans votre fichier (généralement ";" ou ",").
- Séparateur décimal : Choisissez le caractère utilisé comme séparateur décimal (généralement "," ou ".").
- Format de date : Sélectionnez le format de date utilisé dans votre fichier.
- Lignes d'en-tête : Indiquez le nombre de lignes d'en-tête à ignorer.
- Encodage : Sélectionnez l'encodage du fichier.
Cliquez sur le bouton "Envoyer" pour télécharger le fichier.

Note : Le module accepte les fichiers CSV avec différents formats. Si vous rencontrez des problèmes lors de l'importation, essayez de modifier les options d'importation pour qu'elles correspondent au format de votre fichier.

Étape 2 : Mappage des colonnes

Après avoir téléchargé le fichier, vous devez indiquer quelle colonne du CSV correspond à chaque type de donnée :

Pour chaque type de donnée (Date, Libellé, Débit, Crédit), sélectionnez la colonne correspondante dans votre fichier CSV.
Le module essaie de détecter automatiquement le mappage, mais vous devez vérifier qu'il est correct.
Cliquez sur "Enregistrer le mappage" pour confirmer votre sélection.

Astuce : Si votre fichier CSV contient une seule colonne pour le montant (positif pour les crédits, négatif pour les débits), vous pouvez sélectionner la même colonne pour "Débit" et "Crédit". Le module gérera automatiquement les valeurs positives et négatives.

Étape 3 : Prévisualisation et édition des données

Après avoir configuré le mappage des colonnes, vous verrez un aperçu des données à importer :

Vérifiez que les données sont correctement interprétées.
Vous pouvez modifier les données directement dans l'interface :
- Modifiez les dates si elles ne sont pas correctement formatées.
- Ajustez les libellés pour plus de clarté.
- Corrigez les montants si nécessaire.
Cochez ou décochez les cases à gauche pour sélectionner les lignes à importer.
Les lignes vides ou avec des montants nuls sont automatiquement désélectionnées et mises en évidence en rose.

Étape 4 : Importation des données

Une fois que vous êtes satisfait de la prévisualisation :

Sélectionnez l'ordre d'importation (du plus ancien au plus récent ou du plus récent au plus ancien).
Cliquez sur le bouton "Importer" pour importer les lignes sélectionnées dans Dolibarr.
Un message de confirmation s'affichera, indiquant le nombre de lignes importées avec succès.

Attention : L'importation est définitive. Une fois les opérations importées, elles ne peuvent pas être supprimées automatiquement. Vous devrez les supprimer manuellement si nécessaire.

5. Fonctionnalités avancées

Nettoyage automatique des caractères spéciaux

Le module inclut une fonctionnalité de nettoyage automatique des caractères spéciaux qui est activée par défaut. Cette fonctionnalité permet de :

Supprimer tous les caractères non-ASCII (valeur > 127) des fichiers CSV
Éliminer les caractères spéciaux qui peuvent causer des problèmes lors de l'importation
Nettoyer automatiquement les points utilisés comme séparateurs de milliers (ex: "1.234,56")

Un message d'information bleu s'affiche en haut de la page d'importation lorsque cette fonctionnalité est activée.

Pour activer ou désactiver cette fonctionnalité :

Allez dans Accueil > Configuration > Modules > ImportBank > Configuration
Cochez ou décochez l'option "Nettoyer automatiquement les caractères spéciaux"
Cliquez sur "Enregistrer"

Note : Si vous rencontrez des problèmes lors de l'importation de fichiers CSV contenant des caractères spéciaux ou des formats de nombres particuliers, assurez-vous que cette option est bien activée.

Nettoyage automatique du champ description

Le module inclut également une fonctionnalité de nettoyage automatique du champ description qui est activée par défaut. Cette fonctionnalité permet de :

Remplacer les espaces multiples par un seul espace
Remplacer les tabulations par un espace
Supprimer les retours à la ligne et retours chariot
Uniformiser la présentation des descriptions dans les opérations bancaires

Cette fonctionnalité est particulièrement utile lorsque les descriptions dans le fichier CSV contiennent des formatages complexes ou des caractères de contrôle qui peuvent rendre la lecture difficile.

Pour activer ou désactiver cette fonctionnalité :

Allez dans Accueil > Configuration > Modules > ImportBank > Configuration
Cochez ou décochez l'option "Nettoyer automatiquement le champ description"
Cliquez sur "Enregistrer"

Note : Cette fonctionnalité est particulièrement utile pour les fichiers CSV exportés depuis certaines banques qui incluent des retours à la ligne ou des tabulations dans les descriptions des opérations.

Mise en évidence des lignes avec montants vides

Le module met automatiquement en évidence (fond rose) les lignes où les colonnes Débit et Crédit sont toutes les deux vides ou à zéro. Cette fonctionnalité permet d'identifier rapidement les lignes qui pourraient nécessiter une attention particulière avant l'importation.

Choix de l'ordre d'importation

Vous pouvez choisir l'ordre dans lequel les opérations seront importées :

Du plus ancien au plus récent (ascendant) : Les opérations sont importées dans l'ordre chronologique, en commençant par la plus ancienne.
Du plus récent au plus ancien (descendant) : Les opérations sont importées en commençant par la plus récente.

Cette option est particulièrement utile si vous importez un grand nombre d'opérations et que vous souhaitez voir les plus récentes apparaître en premier dans Dolibarr.

Mode debug

Le mode debug permet d'afficher des informations supplémentaires sur les données importées. Pour activer le mode debug, cochez la case "Mode Debug" en haut à droite de l'écran de prévisualisation. Cela affichera les valeurs brutes de chaque ligne, ce qui peut être utile pour diagnostiquer des problèmes d'importation.

6. Dépannage

Problèmes courants et solutions

Problème	Cause possible	Solution
Le fichier ne se télécharge pas	Problème de permissions ou taille du fichier trop importante	Vérifiez que le répertoire temp est accessible en écriture Vérifiez la taille maximale de téléchargement dans votre configuration PHP
Les dates ne sont pas correctement interprétées	Format de date incorrect	Sélectionnez le bon format de date dans les options d'importation Modifiez manuellement les dates dans l'écran de prévisualisation
Les montants sont incorrects	Séparateur décimal incorrect ou problème de formatage	Sélectionnez le bon séparateur décimal dans les options d'importation Vérifiez que les montants ne contiennent pas de caractères non numériques (comme des espaces ou des symboles monétaires)
Certaines lignes ne sont pas importées	Lignes non sélectionnées ou données invalides	Vérifiez que les cases à cocher sont bien cochées pour les lignes que vous souhaitez importer Vérifiez que les données sont valides (dates, montants, etc.)

7. FAQ

Puis-je importer plusieurs fois le même fichier ?

Oui, mais le module ne vérifie pas automatiquement les doublons. Si vous importez plusieurs fois le même fichier, vous risquez d'avoir des opérations en double dans votre compte bancaire. Il est recommandé de vérifier manuellement les opérations existantes avant d'importer.

Quels formats de fichier sont supportés ?

Le module supporte uniquement les fichiers CSV (Comma-Separated Values). Si votre relevé bancaire est dans un autre format (XLS, PDF, etc.), vous devrez d'abord le convertir en CSV.

Comment convertir un fichier Excel en CSV ?

Dans Excel, allez dans "Fichier > Enregistrer sous" et sélectionnez le format "CSV (séparateur : point-virgule)" ou "CSV (séparateur : virgule)" selon le séparateur que vous souhaitez utiliser.

Puis-je sauvegarder mes paramètres d'importation pour les réutiliser ?

Actuellement, le module ne permet pas de sauvegarder les paramètres d'importation. Vous devrez les reconfigurer à chaque importation.

Comment gérer les opérations avec des montants négatifs ?

Si votre fichier CSV contient des montants négatifs, le module les interprétera automatiquement comme des débits. Si les montants sont positifs, ils seront interprétés comme des crédits.

Que faire si mon fichier CSV a un format particulier ?

Si votre fichier CSV a un format particulier (par exemple, des colonnes supplémentaires ou un formatage spécial), vous pouvez toujours l'importer en utilisant le mappage des colonnes pour indiquer quelles colonnes correspondent aux données requises (date, libellé, débit, crédit).