Importer les transactions bancaires (Camt ISO20022) [BETA]

Cette nouvelle fonctionnalité vous permet de mettre à jour votre comptabilité en important automatiquement les transactions bancaires à partir de fichiers Camt (052, 053, 054). Grâce à cette innovation, vous pouvez :

• Accélérer l’ensemble du processus d’enregistrement des transactions.
• Réduire le risque d’erreurs manuelles.
• Éviter les doublons, car seules les transactions non encore présentes dans votre comptabilité sont importées.

Le programme lit les fichiers Camt dans un dossier sélectionné, en enregistre le contenu dans une base de données locale et détecte toutes les nouvelles transactions non encore comptabilisées. Celles-ci vous sont ensuite proposées pour l’importation dans votre comptabilité, ce qui simplifie considérablement la gestion financière. Une fois importées, vous pouvez tirer parti des règles d’auto-complétion pour optimiser davantage votre travail.

Cette fonctionnalité est actuellement en version BETA, disponible à des fins expérimentales avec Banana Accounting Plus (plan Advanced) en comptabilité en partie double ou en recettes & dépenses. Nous vous invitons à nous faire part de vos suggestions et de vos commentaires afin d’améliorer cette fonctionnalité.

Conditions préalables

• Utiliser Banana accounting Dev-Channel avec le plan Advanced.
• Utiliser une comptabilité en Partie Double ou en Recettes & Dépenses.

Préparation des Données

Avant de commencer l’importation, assurez-vous de remplir les conditions suivantes :

• Organisation des Fichiers Camt:
  Créez un dossier dédié contenant tous les fichiers Camt (*.xml) que vous souhaitez importer dans votre comptabilité.
  Vous pouvez organiser les fichiers dans le dossier comme vous le souhaitez, par exemple par exercice comptable ou par institution financière.
• Autorisations d’Accès:
  Assurez-vous que le dossier sélectionné soit accessible en lecture et en écriture par le programme, garantissant ainsi la sauvegarde correcte des données et des informations d’importation.
• Paramétrage des IBAN:
  Pour chaque compte dans la comptabilité, vérifiez que vous avez bien saisi l’IBAN dans la colonne ‘BankIban’ du tableau ‘Accounts’.
  • Si la colonne n’est pas présente, ajoutez-la via le menu : Outils → Ajouter/Supprimer une fonction → Ajouter colonnes Adresse au tableau Comptes .
  • Saisissez l’IBAN en majuscules, sans espaces ni caractères spéciaux.
• Extension Swiss Camt ISO20022 Reader:
  Installez l’extension Swiss Camt ISO20022 Reader. Elle est nécessaire pour permettre au programme d’interpréter correctement les fichiers Camt et de lancer le processus d’importation.

Première Utilisation

La première fois que vous utilisez la commande "Import bank transactions (Camt ISO20022)", le programme vous demandera de sélectionner le dossier contenant les fichiers Camt. Ce choix sera enregistré, de sorte que lors des importations suivantes, le programme utilisera automatiquement le même dossier sans demander à nouveau le chemin.

Notez que la première exécution peut prendre plus de temps. Le programme doit lire, traiter et enregistrer tous les fichiers du dossier, et analyser le contenu de chaque fichier. Pendant cette phase, une barre de progression affiche l’état actuel de l’opération, indiquant à la fois le pourcentage d’achèvement et le nombre de fichiers traités sur le total. Le même indicateur de progression est affiché lors de la lecture des fichiers dans le dossier et lors de l’ouverture et la lecture de leur contenu.

Lors des importations suivantes, le processus sera nettement plus rapide, car le programme ne lira et n’importera que le contenu des nouveaux fichiers, sachant déjà quelles données ont été précédemment enregistrées dans la base de données. Ainsi, les opérations futures nécessitent beaucoup moins de temps et garantissent un flux de travail plus fluide et plus efficace.

Traitement des Fichiers

Le traitement des fichiers Camt se déroule en deux phases distinctes :

• Lecture des Fichiers dans le Dossier :
  Dans la première phase, le programme analyse le dossier sélectionné et identifie tous les fichiers présents, qu’il ajoute à la base de données interne. Pendant ce processus, une barre de progression indique le pourcentage de lecture effectué par rapport au nombre total de fichiers.
• Lecture du Contenu des Fichiers :
  Une fois la lecture des fichiers terminée, le programme passe à la deuxième phase : il ouvre les fichiers enregistrés dans la base de données, en lit le contenu et traite les données. Dans cette phase, une barre de progression spécifique est également affichée, indiquant clairement le pourcentage d’achèvement et le nombre de fichiers traités.

Si, pour une raison quelconque, l’un de ces processus est interrompu, le programme conserve les données déjà enregistrées. Lors de l’exécution suivante de l’importation, il reprendra automatiquement là où il s’était arrêté, sans avoir à tout recommencer. Cela garantit un flux de travail efficace et évite de répéter des étapes déjà complétées.

Boîte de Dialogue d’Importation des Transactions Bancaires

La boîte de dialogue d’importation fournit une vue d’ensemble des fichiers traités, des paramètres utilisés et des transactions à importer. Vous pouvez modifier ces paramètres à tout moment, et les données seront recalculées immédiatement.

Onglet "Folder"

L’onglet “Folder” offre une vue globale de l’importation, en affichant le dossier actuellement sélectionné, les fichiers à traiter ainsi que certaines options pour filtrer le contenu.

• Select Folder:
  Vous pouvez ici afficher et modifier le chemin du dossier de travail. Le programme vérifie constamment la validité du chemin sélectionné et, si le dossier n’existe pas ou n’est pas accessible, il affiche une erreur.
• Renommer ou Déplacer le Dossier:
  Si vous changez le nom ou l’emplacement du dossier, n’oubliez pas de mettre à jour le chemin dans cette boîte de dialogue. Le programme mémorise le dernier chemin utilisé et, s’il ne le trouve pas, affichera un avertissement.
• Renommer les Fichiers dans le Dossier:
  Vous pouvez renommer librement les fichiers dans le dossier ; le programme ne se base pas sur leur nom, mais sur leur contenu. Même si deux fichiers ont des noms différents mais un contenu identique, le programme les considérera comme des doublons et n’en importera qu’un seul.
• Ignore Subfolders:
  Par défaut, cette option est activée, ce qui vous permet d’exclure les fichiers situés dans les sous-dossiers. Cela est utile, par exemple, si vous ne souhaitez importer que les fichiers relatifs à la période comptable en cours, en évitant les données plus anciennes ou non pertinentes. Si vous désactivez cette option, tous les fichiers Camt présents dans les sous-répertoires seront inclus dans la base de données, quelle que soit leur date ou leur organisation.
• Ignore Files Older Than...:
  Si vous définissez une date dans ce champ, le programme n’analysera pas le contenu des fichiers antérieurs à cette date. Par défaut, les fichiers plus anciens que la date d’ouverture de la comptabilité sont enregistrés dans la base de données, mais non analysés. En ajustant cette date, vous pouvez affiner davantage le filtre temporel. Si vous entrez une date invalide, le programme la remplace automatiquement par la date actuelle.
• Read All Files:
  En cliquant sur ce bouton, vous forcez la relecture immédiate de tous les fichiers présents dans le dossier au lieu d’attendre la vérification quotidienne. Cette fonction est particulièrement utile lorsque vous ajoutez de nouveaux fichiers et souhaitez les importer sans attendre la prochaine mise à jour automatique.

Onglet "Bank Accounts"

L’onglet “Bank Accounts” offre une vue détaillée de tous les comptes bancaires présents dans votre comptabilité. Pour chaque compte, le programme affiche à la fois des informations statiques (comme le solde actuel dans votre comptabilité) et des données dynamiques, mises à jour en fonction des derniers imports.

Informations Affichées pour Chaque Compte

• Accounting Balance:
  Indique le montant actuel enregistré dans la comptabilité pour ce compte.
• Last Bank Balance:
  Affiche le dernier solde bancaire détecté directement à partir des fichiers Camt. Cela vous permet de comparer instantanément la valeur enregistrée dans votre comptabilité avec le solde réel de la banque.
• New Transactions:
  Indique le nombre de nouveaux mouvements détectés dans les fichiers Camt qui ne sont pas encore enregistrés dans la comptabilité.
• Total New Transactions:
  Montre la valeur monétaire totale des nouvelles transactions à importer pour ce compte, vous aidant ainsi à évaluer rapidement l’ampleur des opérations en attente.
• Last Import:
  Indique la date à laquelle le dossier a été entièrement lu pour la dernière fois, fournissant un repère temporel utile pour savoir quand a eu lieu la dernière mise à jour.
• Status:
  • Updated: Aucun nouveau mouvement à importer pour ce compte.
  • New transactions: De nouveaux mouvements, non enregistrés, ont été trouvés, prêts à être importés dans la comptabilité.

Onglet "Transaction Details"

Dans l’onglet “Transaction Details”, vous trouverez toutes les opérations bancaires identifiées dans les fichiers Camt qui ne sont pas encore importées dans la comptabilité, regroupées par compte. Cette vue vous permet d’analyser rapidement les mouvements en attente, d’en vérifier la pertinence et de sélectionner ceux que vous souhaitez importer.

• Sélection des Transactions à Importer:
  Vous pouvez exclure temporairement certaines transactions ou, si vous le souhaitez, toutes celles liées à un compte particulier en utilisant les cases à cocher. Les transactions exclues ne sont pas définitivement supprimées ; elles vous seront à nouveau proposées lors de la prochaine ouverture de la boîte de dialogue, vous permettant de réévaluer leur importation à tout moment. Actuellement, il n’est pas possible d’exclure définitivement une transaction.
• Ne Considérer les Transactions qu’à Partir d’une Date Spécifique:
  Pour réduire le nombre de mouvements affichés, vous pouvez définir une date à partir de laquelle considérer de nouvelles transactions pour l’importation. Par défaut, le programme utilise la date d’ouverture de la comptabilité. En définissant une date différente, il n’affichera que les opérations postérieures à ce jour, ignorant les précédentes. Cette fonction est particulièrement utile si, par le passé, des transactions ont été importées sans ID unique (colonne ExternalReference), comme c’est souvent le cas pour les importations de fichiers CSV. Dans de tels cas, il suffit de choisir une date postérieure à la dernière transaction enregistrée pour éviter de reproposer des mouvements antérieurs. Si vous entrez une date invalide, le programme la remplace automatiquement par la date actuelle.
• Identification Unique des Transactions:
  Les transactions issues de fichiers Camt (052, 053, 054) devraient toujours inclure un ID unique, conformément à la norme ISO20022. Cet identifiant permet au programme de déterminer avec précision quelles opérations ont déjà été importées et lesquelles sont nouvelles, réduisant ainsi le risque de doublons ou d’erreurs.

Onglet "Settings"

Settings Tab

Dans l’onglet “Settings”, vous pouvez gérer certains aspects avancés du processus d’importation, notamment la possibilité de restaurer l’état initial des données et de définir la méthode de reconnaissance des fichiers déjà traités.

• Delete Saved Data:
  Cette fonction vous permet de supprimer toutes les données relatives aux importations précédentes, enregistrées dans la base de données interne. Une fois la suppression confirmée, vous serez automatiquement redirigé vers l’onglet “Folder”, où les valeurs par défaut seront restaurées.
  • New Import: Si vous souhaitez effectuer un nouvel import après avoir supprimé les données, il vous suffit de cliquer sur le bouton “Read all files”.
  • Limited Impact on Import Data: La suppression des données de la base interne n’affecte en rien les informations déjà présentes dans la comptabilité.
  • Complete Database Removal: La commande disponible ici ne supprime que le contenu des tables de la base de données. Si vous souhaitez supprimer complètement la base de données, vous devez supprimer manuellement le fichier “*.db” dans le dossier sélectionné.
• Always Verify the Existence of Files Using Hashing:
  Cette option vous permet de choisir comment le programme identifie les fichiers déjà traités :
  • Hashing (plus lent): Si vous sélectionnez cette option, le programme calculera un hash unique pour chaque fichier, garantissant une détection précise des doublons même si les noms ou les chemins changent. Cependant, cette méthode peut ralentir la lecture des fichiers.
  • Vérifier Nom, Date et Taille (par défaut): Si la case n’est pas cochée, le programme se limite à comparer le nom du fichier (y compris le chemin), la date de création et la taille du fichier pour déterminer son unicité. Cette approche est plus rapide, mais peut être moins robuste dans les scénarios où les fichiers sont renommés tout en conservant le même contenu.

Fichier de Base de Données

Le programme utilise une base de données SQLite pour stocker les données liées à l’importation. La première fois que vous activez cette fonction, si le dossier sélectionné est valide, un fichier de base de données (*.db) sera créé dans ce dossier.

Il est important de ne pas déplacer ni supprimer ce fichier, car le programme l’utilise comme référence pour toutes les opérations ultérieures. En cas de perte ou de suppression, le programme générera un nouveau fichier .db, vous obligeant à relire et retraiter tous les fichiers du dossier.

Que Contient la Base de Données ?

• Liste des Fichiers:
  Tous les fichiers détectés dans le dossier sont enregistrés. Si vous avez choisi d’ignorer les sous-dossiers dans les paramètres, les fichiers qu’ils contiennent ne seront pas enregistrés. Cette option est activée par défaut.
• Comptes Bancaires et Données Associées:
  La base de données conserve les informations relatives aux comptes bancaires présents dans la comptabilité. Si ces données sont modifiées dans la comptabilité, la base de données les mettra à jour en conséquence.
• Transactions Importées:
  Les transactions trouvées dans les fichiers ouverts et lus sont enregistrées dans la base de données, vous permettant de les retraiter ou de les consulter ultérieurement sans avoir à relire les fichiers.
• Historique des Importations:
  Le programme enregistre qui a effectué les opérations d’importation, quand elles ont été réalisées et avec quelle version du logiciel, garantissant ainsi une traçabilité historique détaillée des activités.

Fichier de Journal (Log)

Pendant le processus d’importation, le programme génère un fichier de journal (log) permettant d’identifier et de diagnostiquer d’éventuels problèmes. En cas d’anomalies ou de comportements inattendus, ce fichier fournit des informations détaillées sur les opérations effectuées, aidant les développeurs à comprendre l’origine de l’erreur.
Si vous avez besoin d’aide pour localiser ou interpréter le fichier log, contactez notre équipe d’assistance ; elle vous guidera pas à pas pour trouver ce fichier dans votre répertoire actif.

Dépannage

Si aucune transaction n’apparaît pour l’importation alors que vous avez correctement sélectionné le dossier, vérifiez les points suivants :

• Comptes Bancaires: Assurez-vous que les données relatives aux comptes bancaires (y compris les IBAN) dans le tableau “Accounts” sont complètes et correctes.
• Période Comptable: Vérifiez que la période comptable actuellement définie inclut les dates des transactions que vous souhaitez importer. Si les transactions se situent en dehors de la période définie, le programme ne les proposera pas à l’importation.

Si le problème persiste après ces vérifications, contactez notre support technique pour obtenir une assistance supplémentaire.