Module Banques (Comptes bancaires)

Le module Banques d'HtkDoli vous permet de consulter et gérer vos comptes bancaires Dolibarr : suivi des soldes, écritures (transactions), virements internes, rapprochement (pointage) et génération de RIB.

Interface et Fonctionnalités (Liste)

La vue principale affiche la liste de tous vos comptes bancaires.

Consultation et Recherche

Barre de recherche : Recherche par nom du compte ou référence.
Tri :
- Solde (Décroissant) — défaut
- Solde (Croissant)
- Nom
Filtres par statut, avec compteur affiché :
- Tous
- Ouverts (statut 0)
- Fermés (statut 1)
Rafraîchissement : Bouton dédié avec indicateur d'état.

Informations affichées (Cartes Banque)

Chaque ligne représente un compte avec :

Le nom du compte.
Le solde actuel avec sa devise.
Le statut (Ouvert / Fermé).
L'établissement bancaire (si renseigné).

Pagination

Bouton « Charger plus » pour la pagination.
Pull-to-refresh disponible.

Vue Détail (Consultation d'un compte)

En-tête (Hero Section)

Nom du compte.
Solde Actuel affiché en grand format.
Devise.

Informations

Référence du compte
Type (compte courant, livret, etc.)
Devise
IBAN / BIC
Numéro de compte
Code banque / code guichet / clé RIB

Propriétaire

Coordonnées du titulaire du compte.

Agence

Nom et adresse de l'agence
Site Web (lien cliquable)

Limites & Seuils

Solde minimum autorisé
Solde minimum souhaité
Solde de découvert autorisé

Commentaire

Texte libre lié au compte (note, particularité, contact gestionnaire…).

Documents

Consultation, aperçu PDF, téléchargement et ajout (justificatifs, contrats…). Un glissement vers la gauche sur la ligne d'un document expose l'action Supprimer (avec alerte de confirmation), qui retire le fichier du serveur Dolibarr.

Transactions

Liste paginée de toutes les écritures du compte. Trois filtres sont disponibles :

Sens : Tous / Crédit / Débit.
Mode : Virement, Carte Bancaire, Chèque, Prélèvement, Espèces, Autre.
Date : Toutes dates, Ce mois, 3 derniers mois, Cette année.

Pour chaque écriture :

La date de l'opération.
Le libellé.
Le montant (crédit en vert).
Le numéro de relevé si la ligne est pointée.
Une coche indiquant que l'écriture est rapprochée.
Un lien cliquable vers le Tiers (Société) ou le Projet associé, le cas échéant.

Pour chaque transaction, des actions par glissement (swipe) sont disponibles :

Glissement vers la droite : Modifier, puis Pointer (saisir un numéro de relevé pour rapprocher l'écriture) ou Dépointer (retirer le rapprochement d'une écriture déjà pointée).
Glissement vers la gauche : Supprimer.

Un bouton « Charger l'historique plus ancien » étend la pagination vers le passé, et « Charger plus » vers le présent.

Actions de l'en-tête flottant

Menu (•••) :

Rafraîchir : Recharge la fiche complète du compte (informations, transactions et documents) depuis Dolibarr.
Modifier : Édite la fiche du compte.
Voir le RIB : Affiche le RIB / relevé d'identité bancaire au format PDF. ⚠️ Le RIB n'est pas généré : l'app recherche, parmi les documents joints au compte, un PDF dont le nom contient « rib » ou « iban ».
Virement interne : Ouvre la feuille de virement vers un autre compte.
Rapprochement : Ouvre la vue de rapprochement bancaire.
Supprimer : Supprime le compte et toutes ses écritures (alerte de confirmation).

Actions principales

Ajouter une transaction

Une feuille dédiée permet de créer une écriture manuelle :

Date.
Type : Carte Bancaire (par défaut), Virement, Prélèvement, Chèque, Espèces, Divers.
Libellé.
Montant et Sens (Débit / Crédit). Un débit est enregistré en montant négatif, un crédit en positif.

Modifier une transaction

Mêmes champs que pour l'ajout, en pré-remplissage. Un Tiers lié à l'écriture est affiché (et cliquable) le cas échéant.

Virement interne

Crée un transfert entre deux comptes :

Compte source (le compte courant) et son solde.
Compte destination : ⚠️ seuls les comptes ouverts (hors compte source) sont proposés.
Montant.
Libellé.
Date.

Rapprochement bancaire

Une vue dédiée affiche uniquement les écritures non rapprochées (ni numéro de relevé, ni date de rapprochement) et permet de les pointer en lot avec un même numéro de relevé. Vous pouvez sélectionner/désélectionner les écritures (ou Tout sélectionner) et suivre en temps réel le nombre et le montant sélectionnés. Le numéro de relevé est demandé via une alerte de saisie avant validation.

Pointage individuel

Depuis la liste des transactions, le glissement (swipe) d'une écriture permet de saisir directement le numéro de relevé pour la pointer ou de dépointer une écriture déjà rapprochée.

Graphique d'évolution

Un graphique d'évolution du solde dans le temps est disponible (BalanceHistoryChart), s'appuyant sur l'historique des transactions du compte.

Comportement Métier et Dolibarr

Droits et Permissions

Lecture : Permission de lecture du module Banque requise.
Création / Modification de compte : Permission banque.modifier.
Écritures, pointage, virement : Permissions correspondantes côté Dolibarr.

Synchronisation

Liste des comptes paginée.
À l'ouverture de la fiche d'un compte, les informations complètes (IBAN, BIC, agence, domiciliation, notes, propriétaire, limites, etc.) sont rechargées automatiquement depuis Dolibarr (GET /bankaccounts/{id}), ce qui permet d'enrichir les champs parfois omis du listing.
Le pull-to-refresh et l'action Rafraîchir du menu relancent à la fois le détail du compte, les transactions et les documents.
Les transactions d'un compte sont chargées à l'ouverture de la fiche, avec pagination vers le passé et vers le présent.
Les rapprochements et les écritures créées en mobilité sont propagés vers Dolibarr.

Statuts de compte

Ouvert (0) : Compte actif, écritures autorisées.
Fermé (1) : Compte clôturé, consultation seule.

Captures d'écran

2 captures — cliquez pour agrandir