Outil de rapprochement bancaire (ERPNext)

S'applique à : l'écran Outil de rapprochement bancaire, à l'adresse /desk/bank-reconciliation-tool, repris d'ERPNext.

Reconnaître les deux écrans

Les deux écrans travaillent sur les mêmes Transactions bancaires. Une transaction rapprochée dans l'un l'est aussi dans l'autre.

Rapprocher une transaction

1. Ouvrez l'Outil de rapprochement bancaire.
2. Choisissez la Société, le Compte bancaire et les dates de début et de fin de la période.
3. Cliquez sur Obtenir les écritures non rapprochées. Le tableau affiche les transactions bancaires non rapprochées.
4. Sur une ligne, cliquez sur Actions. La fenêtre Rapprocher la transaction bancaire s'ouvre.
5. Dans Action, choisissez :
   • Match Against Voucher pour rapprocher la transaction avec une pièce existante ;
   • Create Voucher pour créer la pièce manquante (voir ci-dessous) ;
   • Update Bank Transaction pour modifier la référence ou le tiers de la transaction.
6. Cliquez sur Valider.

Les options du champ Action et le bouton Edit in Full Page ne sont pas traduits dans l'interface.

Créer la pièce manquante

1. Dans la fenêtre Rapprocher la transaction bancaire, choisissez l'action Create Voucher.
2. Dans Type de document, choisissez le type de pièce. Par défaut : Écriture de paiement ou Écriture de journal.
3. Renseignez les champs. Dokos reprend la date, la référence et le mode de paiement de la transaction bancaire.
4. Cliquez sur Valider pour créer la pièce et rapprocher la transaction. Pour ajuster la pièce avant de la valider, cliquez sur Edit in Full Page : Dokos ouvre le brouillon. Quand vous validez ce brouillon, Dokos rapproche la transaction bancaire.

Types de pièces ajoutés par une application

Une application installée sur votre site peut ajouter ses propres types de pièces au champ Type de document. Un type ajouté :

• affiche ses propres champs dans la fenêtre ;
• peut ne s'afficher que pour certaines transactions, par exemple les dépôts seulement ;
• se comporte comme les types de base : Valider crée et rapproche la pièce, Edit in Full Page ouvre le brouillon puis rapproche la transaction à sa validation.

Les types ajoutés par une application apparaissent après Écriture de paiement et Écriture de journal. Si un type attendu n'apparaît pas, vérifiez que l'application est installée et que la transaction est du bon sens (dépôt ou retrait).

Ces types n'existent que dans l'Outil de rapprochement bancaire. La page Rapprochement bancaire ne les propose pas.

      
flowchart TD
    A[Transaction bancaire] --> B[Bouton Actions]
    B --> C{Action}
    C -- Match Against Voucher --> D[Choisir une pièce existante]
    C -- Create Voucher --> E[Type de document]
    E --> F[Écriture de paiement]
    E --> G[Écriture de journal]
    E --> H[Type ajouté par une application]
    F --> I[Valider ou Edit in Full Page]
    G --> I
    H --> I
    D --> J[Transaction bancaire rapprochée]
    I --> J

    

Pour les développeurs

Une application ajoute un type de pièce dans le registre JavaScript erpnext.accounts.bank_reconciliation.voucher_types. La clé est le nom du type de document. Chaque entrée peut définir :

• is_applicable(bank_transaction) : afficher le type seulement pour certaines transactions ;
• get_fields(dialog_manager) : les champs à ajouter à la fenêtre ;
• create(dialog_manager, values, allow_edit) : l'appel serveur qui crée la pièce et renvoie la transaction bancaire rapprochée, ou le brouillon si allow_edit est vrai.

Les entrées enregistrées avant le chargement de l'outil sont conservées. Les types de base restent en tête de la liste.

// Exemple : noms à adapter à votre application
frappe.provide("erpnext.accounts.bank_reconciliation.voucher_types");

erpnext.accounts.bank_reconciliation.voucher_types["Mon type de pièce"] = {
  is_applicable: (bank_transaction) => bank_transaction.deposit > 0,
  get_fields: (dialog_manager) => [
    // champs de la fenêtre pour ce type de pièce
  ],
  create: (dialog_manager, values, allow_edit) =>
    frappe.xcall("mon_app.api.creer_piece", {
      bank_transaction_name: dialog_manager.bank_transaction.name,
      allow_edit: allow_edit,
    }),
};

Voir aussi

• Rapprochement bancaire : la page recommandée
• Module Banque (bêta)