Documentation
Version de développement
Cette documentation décrit la version « next » (develop), non encore publiée. Pour la version stable, basculez sur « v5 » dans l'en-tête.
Comptabilité

Rapprochement bancaire

Un nouveau module bancaire unifié est disponible, regroupant import, rapprochement et règles en une seule interface. Consultez la page Nouveau module bancaire pour en savoir plus.

Transaction bancaire

Ce formulaire affiche les transactions bancaires dans Lyon.

1. Prérequis avant utilisation

Avant d'utiliser la saisie d'opérations bancaires, il est conseillé de créer d'abord les éléments suivants :

  • Banque
  • Compte bancaire

2. Comment utiliser la transaction bancaire

Habituellement, une transaction bancaire n'est pas destinée à être créée manuellement. Il est automatiquement créé à l'aide de du téléchargement du relevé bancaire depuis le Rapprochement Bancaire.

2.1 Champs supplémentaires dans Transaction bancaire

  • Date : Date de l'opération bancaire.
  • Numéro de référence : Référence de l'opération bancaire.
  • Compte bancaire : Le compte bancaire à partir duquel les transactions ont été effectuées.

3. Caractéristiques / Champs

Ces champs sont mis à jour via le rapprochement bancaire et ne sont pas destinés à être modifiés à partir de là.

3.1 Devise et débit/crédit

  • Débit : Le montant débité.
  • Crédit : Le montant crédité.
  • Devise : La devise dans laquelle la transaction a été effectuée.
  • Description : une description de l'instruction.

3.2 Référence

Numéro de référence : Un chèque ou autre numéro de référence.

3.3 Saisies de paiement

  • Document de paiement : Le document par rapport auquel la transaction a été effectuée, qu'il s'agisse d'une facture de vente, d'une note de frais, d'une facture d'achat, d'une écriture de paiement ou d'une écriture au journal.
  • Saisie de paiement : La transaction spécifique.
  • Montant alloué : Le montant alloué pour cette transaction particulière.
  • **Montant alloué **: Le montant total alloué. Montant non alloué : Le montant total non alloué.

Rapprochement bancaire

Le rapprochement bancaire sert à pointer les opérations enregitrées sur votre relevé bancaire avec les transactions enregistrées dans votre logiciel de gestion.

1. Comment importer ses relevés bancaires ?

Le nouveau module bancaire propose un importateur intelligent prenant en charge les formats CSV, XLSX, OFX et PDF avec détection automatique des colonnes, sans configuration préalable. Il permet également d'importer des relevés PDF et d'ajuster le mapping de colonnes manuellement lorsque nécessaire.

1.1 Format OFX

  1. Téléchargez votre relevé bancaire au format OFX.
  2. Allez dans Transaction Bancaire, cliquez sur Menu et sélectionnez Télécharger un relevé en OFX
  3. Téléchargez vos transactions

Avec le format OFX, Dokos ne créera pas de doublons, car chaque transaction est identifiée de manière unique. Vous pouvez donc importer un fichier contenant des données déjà téléchargées.

1.2 Format CSV/XLSX

  1. Sélectionnez la banque concernée par cet import dans la liste Banque
  2. Dans la section Configuration pour l'import de données, créez un mapping entre les données d'en-tête de votre fichier CSV/XLSX et celles du type de document Transaction Bancaire de Dokos.
  3. Téléchargez votre relevé bancaire au format CSV ou XLSX. Vérifiez que la ligne d'en-tête soit la première ligne du fichier.
  4. Allez dans Transaction Bancaire, cliquez sur Menu et sélectionnez Télécharger un relevé en csv/xlsx
  5. Téléchargez vos transactions

Avec le format XLSX/CSV, si le champ reference_number n'est pas renseigné, le logiciel ne pourra pas identifier distinctement les transactions et importera les doublons.

1.3 Importer manuellement les transactions bancaire

Détails de la transaction

  1. Allez dans la liste Transaction bancaire, puis cliquer sur Ajouter une Transaction bancaire
  2. Indiquez la date de la transaction qui apparaît sur votre compte bancaire
  3. Renseignez le numéro de référence de la transaction
  4. Choisissez la société concerné par cette transaction
  5. Indiquez le compte bancaire

Montant de la transaction

Indiquez le montant de la transaction, soit au débit s'il s'agit d'une sortie, soit au crédit s'il s'agit d'une entrée.

Vous pouvez ajouter une description si besoin.

2. Rapprocher les lignes de relevé bancaire

Ouvrez la page Rapprochement bancaire

  1. Sélectionnez le compte bancaire et la période concernés
  2. Sélectionnez une ou plusieurs transactions bancaires
  3. Sélectionnez le type de transaction à rapprocher
  4. Vérifiez que le montant des transactions bancaires correspond au montant des transactions du système
  5. Cliquez sur Rapprocher

2.1 Spécificités

Rapprochement 1 <-> n / n <-> n

L'outil de rapprochement permet de rapprocher une ou plusieurs lignes du relevé bancaire avec une transaction dans Dokos (Ecriture de paiement, écriture de journal, ...) Il permet également de rapprocher une ligne du relevé bancaire avec plusieurs transactions dans Dokos. Par contre il ne permet pas de rapprocher plusieurs lignes du relevé bancaire avec plusieurs transactions en même temps.

Si les options proposées par l'outil ne permettent pas de gérer certains cas de figures, vous pouvez toujours ouvrir la transaction et ajouter des lignes de rapprochement en allouant les montant rapprochés manuellement.

Création automatique de paiement

Si vous rapprochez une facture, Dokos va automatiquement créer le paiement correspondant. Par contre si la devise de la facture n'est pas celle du compte bancaire, il faudra créer le paiement manuellement.

Le paiement créé reprend les dimensions comptables communes à toutes les factures rapprochées : si les factures d'une même remise portent le même projet ou la même dimension, le paiement la porte aussi. Quand les factures portent des valeurs différentes, la dimension reste vide sur le paiement.

2.2 Rapprochement avec un Ordre de Paiement

Il est désormais possible de rapprocher une transaction bancaire directement avec un Ordre de Paiement (document regroupant plusieurs paiements fournisseurs émis en une seule opération bancaire, par exemple un virement de masse).

Pourquoi utiliser cette option ?

Lorsque vous effectuez un virement groupé vers plusieurs fournisseurs via un Ordre de Paiement, votre banque enregistre une seule opération pour le montant total. Le rapprochement avec l'Ordre de Paiement permet de faire le lien direct entre cette ligne du relevé et l'ensemble des paiements qu'il regroupe, sans avoir à rapprocher chaque écriture individuellement.

Comment rapprocher un Ordre de Paiement ?

  1. Ouvrez la page Rapprochement bancaire.
  2. Sélectionnez le compte bancaire et la période concernés.
  3. Cliquez sur la transaction bancaire correspondant au virement groupé.
  4. Dans le panneau de correspondance, sélectionnez le type Ordre de Paiement.
  5. Choisissez l'Ordre de Paiement dont le montant correspond au débit bancaire.
  6. Cliquez sur Rapprocher.

Dokos met à jour l'Ordre de Paiement et marque la transaction bancaire comme rapprochée.

Exemple — Bureau Moderne
La comptable émet un Ordre de Paiement regroupant trois virements fournisseurs pour un total de 4 750 €. Le lendemain, le relevé bancaire affiche un débit unique de 4 750 €. Elle sélectionne cette transaction, choisit le type Ordre de Paiement dans le panneau et sélectionne l'ordre correspondant. En un clic, la transaction est rapprochée et l'Ordre de Paiement est mis à jour.

Flux de rapprochement avec un Ordre de Paiement

2.3 Rapprochement automatique

Stripe

Si vous utilisez la passerelle de paiement Stripe, Dokos peut rapprocher vos paiements avec les versements effectués par Stripe sur votre compte bancaire. Il suffit pour cela de renseigner l'identifiant de "Charge" Stripe dans le champ "Chèque/N° de référence" de l'écriture de paiement.

Nom du document

Si vous demandez à vos clients de mettre le numéro de facture dans les références de virement, Dokos peut alors faire le rapprochement automatiquement lorsque vous cliquez sur "Rapprochement automatique"

La détection du numéro de facture dans la description ou la référence de la transaction bancaire est insensible à la casse : que le donneur d'ordre ait saisi FAC-2605-0006, fac-2605-0006 ou Fac-2605-0006, Dokos reconnaît la facture et effectue le rapprochement.

Exemple — Maison Verte SARL Un virement reçu contient la description paiement fac-2605-0006. Dokos identifie automatiquement la facture FAC-2605-0006 et propose le rapprochement, même si la casse diffère du préfixe configuré dans la série de nommage.

Options locales

La méthode regional_reconciliation permet de configurer des méthodes de rapprochement spécifiques à certaines régions.

Suisse

Vous pouvez ajouter un champ esr_reference dans vos factures pour que Dokos les rapproche automatiquement sur la base du numéro ESR.

Hook

Le hook auto_reconciliation_methods permet de créer vos propres méthodes de rapprochement automatique dans une application personnalisée.

2.4 Créer une nouvelle écriture depuis le rapprochement

Lorsqu'une transaction bancaire n'a pas de correspondance dans Dokos (par exemple un virement reçu sans facture associée), vous pouvez créer une nouvelle écriture directement depuis le panneau de rapprochement sans quitter l'outil.

Comment ça marche ?

  1. Ouvrez la page Rapprochement bancaire.
  2. Sélectionnez le compte bancaire et la période concernés.
  3. Cliquez sur une transaction bancaire non rapprochée.
  4. Dans le panneau de correspondance, au lieu de rechercher un document existant, cliquez sur le bouton Créer une nouvelle écriture.
  5. Sélectionnez le type de pièce à créer : Écriture de paiement ou Écriture au journal.
  6. Renseignez les champs proposés (tiers, montant, date…). Dokos pré-remplit automatiquement les informations connues à partir de la transaction bancaire.
  7. Cliquez sur Soumettre pour créer et rapprocher la transaction en une seule opération, ou sur Éditer en pleine page pour ouvrir le brouillon dans une nouvelle fenêtre et l'ajuster avant validation.

Dokos crée l'écriture, la soumet et rapproche automatiquement la transaction bancaire.

Exemple — Maison Verte SARL Un virement de 1 200 € est reçu sans facture ni référence. La comptable sélectionne la transaction bancaire, clique sur Créer une nouvelle écriture, choisit Écriture de paiement et indique le tiers correspondant. En un clic, Dokos crée l'écriture de paiement, la soumet et marque la transaction comme rapprochée.

Type de pièce à créer

Par défaut, deux types de pièces sont proposés :

  • Écriture de paiement — pour enregistrer un paiement entrant ou sortant
  • Écriture au journal — pour un ajustement comptable

La liste des types de pièces disponibles est mise à jour automatiquement en fonction de la transaction : par exemple, seul le type pertinent est proposé selon qu'il s'agit d'un dépôt ou d'un retrait.

Les modules complémentaires peuvent enrichir cette liste avec leurs propres types de pièces. Par exemple, le module de prêts ajoutera le type Remboursement de prêt avec ses champs spécifiques. Cette extensibilité est gérée par le registre erpnext.accounts.bank_reconciliation.voucher_types.

Flux de création d'écriture

Éditer en pleine page

Si vous devez ajuster le document avant de le soumettre, cliquez sur Éditer en pleine page plutôt que sur Soumettre. Dokos ouvre le brouillon dans une nouvelle fenêtre. Une fois le document soumis manuellement, la transaction bancaire est automatiquement rapprochée — quel que soit le type de pièce créé.

Correspondance par montant non réconcilié

Dans ERPNext, l'outil de rapprochement ne propose en correspondance que les écritures de paiement sans date de rapprochement bancaire (champ clearance_date vide). Dans Dokos, ce filtre est remplacé par une condition sur le montant non réconcilié : seules les écritures dont le champ unreconciled_amount est non nul sont proposées.

Cette approche permet de rapprocher un paiement partiellement alloué avec une nouvelle transaction bancaire pour le solde restant, même si ce paiement a déjà une date de rapprochement.

Exemple — Dokompany Un virement de 1 000 € est partiellement alloué à une facture de 700 €. Il reste 300 € à réconcilier. Dokos propose cette écriture dans la liste de correspondance pour la prochaine transaction bancaire correspondante — même si la première allocation a déjà été rapprochée.

Détection de doublons lors de l'import et de la saisie

Dokos applique deux contrôles automatiques pour éviter les doublons dans les transactions bancaires.

À l'import (OFX ou CSV) — si une transaction avec le même numéro de référence existe déjà pour ce compte bancaire, Dokos l'ignore silencieusement. Il est donc sans risque d'importer plusieurs fois le même fichier de relevé : les lignes déjà présentes ne sont pas dupliquées.

En saisie manuelle — si une transaction avec le même numéro de référence existe déjà pour ce compte bancaire, Dokos bloque la création et affiche une erreur. Si des transactions similaires existent (même date, même montant, même devise, même description), un message d'avertissement est affiché sans bloquer.

Exemple — Dokompany Le comptable importe le relevé de janvier deux fois par erreur. Dokos ajoute les nouvelles lignes et ignore celles déjà présentes. En saisie manuelle d'un virement avec la référence "VIR-2024-001" déjà existante, Dokos refuse la création.

Extensibilité des types de pièces de rapprochement

Le rapprochement bancaire peut être étendu par des modules complémentaires pour prendre en charge de nouveaux types de pièces au-delà des écritures de paiement et d'écritures au journal intégrées.

Comment enregistrer un nouveau type de pièce

Un module complémentaire peut enregistrer un type de pièce dans le registre erpnext.accounts.bank_reconciliation.voucher_types. Chaque entrée peut définir :

  • is_applicable(bank_transaction) — conditionner l'affichage du type selon le sens de la transaction (dépôt ou retrait)
  • get_fields(dialog_manager) — fournir les champs supplémentaires à afficher dans le dialogue de création
  • create(dialog_manager, values, allow_edit) — effectuer l'appel serveur pour créer le document et renvoyer la transaction bancaire rapprochée (ou le brouillon en cas d'édition en pleine page)

Les types de pièces enregistrés par d'autres modules avant le chargement de l'outil sont conservés, et les types intégrés (Écriture de paiement, Écriture au journal) restent en tête de la liste de sélection.

Exemple de registre

frappe.provide("erpnext.accounts.bank_reconciliation.voucher_types");

erpnext.accounts.bank_reconciliation.voucher_types["Remboursement de prêt"] = {
  is_applicable: (bank_transaction) => bank_transaction.deposit > 0,
  get_fields: (dialog_manager) => [
    // champs du dialogue pour ce type de pièce
  ],
  create: (dialog_manager, values, allow_edit) =>
    frappe.xcall("lending.api.create_loan_repayment", { ... }),
};

Rapprochement automatique après soumission

Quel que soit le type de pièce créé (intégré ou personnalisé), si vous choisissez d'éditer en pleine page, la transaction bancaire est automatiquement rapprochée une fois le document soumis manuellement — une seule fois, sans duplication.