Connexions bancaires

Ce guide détaille la connexion en direct à une banque (open banking PSD2): comment se connecter, comment lier les comptes bancaires à votre grand livre, comment faire en sorte que chaque synchronisation crée des tiers, rapproche les factures et comptabilise les frais via un modèle d'importation, et enfin ce que renvoie la synchronisation. Les détails de l'API se trouvent dans la section Importations bancaires et de paiements. Pour utiliser des fichiers de relevés à la place d'une connexion en direct, consultez Importation de relevés bancaires (camt.053).

1. Connecter la banque

Sous Banque → Connexions, sélectionnez le pays et cliquez sur Afficher les banques. Choisissez votre banque ainsi que le type de titulaire de compte (professionnel ou particulier), puis cliquez sur Connecter. Vous êtes redirigé vers la page de consentement de la banque, où vous devez vous connecter et approuver l'accès; la banque vous renvoie ensuite vers Nordlet. La connexion apparaît dans la liste avec sa date d'expiration du consentement. Les consentements ont une durée limitée fixée par la banque (généralement 90 ou 180 jours); lorsqu'un consentement expire, effectuez une nouvelle connexion.

La liste des banques provient du fournisseur d'open banking configuré pour l'instance Nordlet. Si aucun établissement n'apparaît pour un pays, cela signifie que le fournisseur ne le prend pas encore en charge.

2. Lier les comptes de la banque

Sous la connexion, chaque compte exposé par la banque est répertorié avec son IBAN et sa devise. Pour chacun d'eux, choisissez un compte bancaire existant dans le grand livre ou cliquez sur Créer un nouveau compte bancaire, définissez éventuellement la date de début de synchronisation, puis cliquez sur Lier. Seuls les comptes liés sont synchronisés. En l'absence de date de début, la première synchronisation récupère les 90 derniers jours.

3. Créer le modèle d'importation

Sous Banque → Modèles d'importation, cliquez sur Nouveau modèle d'importation, sélectionnez le type Connexion bancaire et attribuez-lui un nom. Les lignes correspondent aux attributs renvoyés par le flux bancaire pour chaque transaction. La case Obligatoire dans le fichier est conservée par souci d'exhaustivité, mais un flux en direct n'est pas validé par rapport à celle-ci.

Compte du grand livre. La ligne de montant brut transaction_amount.amount et les lignes de règles peuvent être affectées à un compte du grand livre; chaque transaction synchronisée issue d'une ligne affectée est comptabilisée immédiatement et marquée comme rapprochée de l'écriture au journal. Les lignes de règles sélectionnent les transactions par code de transaction bancaire ou par sens:

Ligne	Sélectionne	Compte type
Frais bancaires (code CHRG)	les transactions dont la famille de codes est CHRG	charges de frais bancaires (6800 dans le plan comptable standard)
Intérêts (code INTR)	la famille de codes INTR	produits ou charges d'intérêts
Taxes (code TAXE)	la famille de codes TAXE	paiements de taxes
Autres décaissements	tout autre débit	laisser "Non comptabilisé" pour que les paiements soient rapprochés des factures d'achat
Autres encaissements	tout autre crédit	laisser "Non comptabilisé" pour que les encaissements soient rapprochés des factures de vente
transaction_amount.amount	toute transaction non interceptée par une règle	généralement "Non comptabilisé"

Une transaction est imputée au compte de la première ligne qu'elle satisfait: d'abord sa famille de codes, puis son sens, et enfin la ligne de montant brut. Le code provient du champ bank_transaction_code de la banque; les banques qui n'en transmettent pas laissent les lignes de codes sans correspondance.

Créer les clients et fournisseurs manquants. Cochez Créer les clients manquants sur la ligne debtor.name pour créer un client pour chaque payeur inconnu lors d'un encaissement, et Créer les fournisseurs manquants sur la ligne creditor.name pour chaque bénéficiaire inconnu lors d'un décaissement. Les tiers sont reconnus par leur IBAN (debtor_account.iban / creditor_account.iban, enregistré dans les comptes bancaires du tiers), puis par leur nom exact; un tiers trouvé par son nom se voit ajouter l'IBAN. Un nouveau tiers est considéré comme une entreprise si son nom comporte une forme juridique (UAB, MB, SIA, GmbH, Ltd, …) et comme un particulier dans le cas contraire.

Créer un tiers pour la banque. Cochez cette option sur la ligne de règle des frais bancaires. La synchronisation crée un fournisseur portant le nom de la banque connectée et enregistre chaque frais dans le journal avec ce tiers.

Lier les factures par ce champ. Cochez cette option sur la ligne remittance_information ou reference_number. Chaque nouvelle transaction dont le libellé ou la référence contient le numéro d'une facture de vente émise et ouverte (encaissement) ou d'une facture d'achat enregistrée (décaissement) y est rattachée et le paiement est comptabilisé. Lorsque le payeur est un tiers connu, identifié par un IBAN enregistré ou par son nom exact ou son code, la facture doit appartenir à ce tiers. Un paiement provenant d'un payeur inconnu n'est rapproché que s'il correspond exactement au solde restant et que le numéro de facture inclut son préfixe de série. Un paiement supérieur au solde restant n'est jamais rapproché. Les transactions qui échouent à ces vérifications restent non rapprochées afin que vous puissiez les traiter manuellement. L'option Créer des factures d'acompte pour les encaissements non rapprochés transforme un encaissement non rapproché provenant d'un tiers connu en une facture d'acompte émise pour le montant correspondant, datée du jour du paiement, au taux de TVA indiqué ou pour l'article de catalogue choisi; cette option requiert l'activation de Créer les clients manquants pour que le tiers soit identifié.

Enregistrez le modèle.

4. Appliquer le modèle et choisir la planification

De retour sous Banque → Connexions, chaque compte lié dispose d'un sélecteur de modèle et d'un sélecteur de planification. Choisissez le modèle, optez pour Synchroniser manuellement, Synchronisation quotidienne, Synchronisation hebdomadaire ou Synchronisation mensuelle, puis cliquez sur Appliquer. Un compte lié sans modèle se synchronise tout de même, mais il enregistre uniquement les transactions; aucune écriture n'est comptabilisée, rapprochée ou créée.

Avec une planification quotidienne, hebdomadaire ou mensuelle, l'API synchronise le compte de manière autonome: toutes les heures, elle recherche les comptes dont la dernière synchronisation dépasse la période définie (24 heures, 7 jours ou 30 jours) et les synchronise exactement comme le ferait l'action Synchroniser maintenant, en exécutant le modèle à la suite. Une synchronisation planifiée est décomptée de votre utilisation au même titre qu'une synchronisation manuelle (toutes les 10 transactions récupérées comptent pour une requête). Si la banque rejette la synchronisation, par exemple en raison de l'expiration du consentement, la connexion est signalée par une erreur et ignorée jusqu'à ce que vous renouveliez la connexion.

5. Synchronisation

Cliquez sur Synchroniser maintenant sur la connexion. Nordlet récupère les nouvelles transactions comptabilisées pour chaque compte lié; les transactions en attente sont ignorées jusqu'à ce que la banque les comptabilise. L'application les récupère (depuis la dernière synchronisation, avec un chevauchement d'une semaine pour ne pas manquée les écritures tardives), les enregistre une seule fois - les transactions étant reconnues par la référence d'écriture de la banque - puis exécute le modèle du compte. La ligne de résultat indique le nombre de transactions importées et le nombre de transactions déjà existantes; via l'API, la synchronisation renvoie également le nombre de mouvements comptabilisés, de tiers créés, de factures liées et créées, de paiements rapprochés, ainsi que des avertissements pour les paiements qui n'ont pas pu être rapprochés.

Les synchronisations peuvent être déclenchées depuis l'API (bank/feeds/sync) selon une planification; chaque tranche de 10 transactions récupérées compte pour une requête API.

6. Où consulter les résultats par la suite

• Banque → Transactions - regroupe l'ensemble des transactions synchronisées, réparties par onglets de comptes; les transactions rapprochées renvoient vers la facture ou l'écriture au journal.
• Factures - les factures d'acompte générées pour les encaissements non rapprochés.
• Tiers - les clients et fournisseurs créés, chacun avec leur IBAN associé dans les comptes bancaires.
• Grand livre → Journal - les écritures de charges (avec la banque comme tiers), d'intérêts, de taxes et de paiements.

Que faire lorsque la connexion ne fonctionne plus

Une synchronisation en échec associe à la connexion le message d'erreur renvoyé par la banque. L'expiration du consentement en est la cause la plus fréquente: cliquez à nouveau sur Connexion pour la même banque et approuvez l'accès; les comptes liés et leurs modèles sont conservés. L'action Déconnecter supprime la connexion ainsi que ses liaisons de compte, mais conserve les transactions déjà enregistrées.