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 et documents.

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, un appui long ouvre Modifier (le libellé seulement, voir plus bas).

Ni pointage, ni suppression d'écriture. L'API REST de Dolibarr n'a aucune route de rapprochement (vérifié le 15 septembre 2026 sur une 24.0.0), et la suppression d'une écriture y répond toujours par une erreur serveur. Ces deux gestes se font depuis l'interface web.

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.
• Virement interne : Ouvre la feuille de virement vers un autre compte.
• Supprimer : Supprime le compte et toutes ses écritures (alerte de confirmation).

Plus de « Voir le RIB » : l'API des documents de Dolibarr ne sert pas les pièces d'un compte bancaire (vérifié le 15 septembre 2026). Le RIB se consulte depuis l'interface web.

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

Seul le libellé se modifie : c'est le seul champ que l'API de Dolibarr accepte sur une écriture existante (vérifié le 15 septembre 2026). Date, type, montant et sens sont affichés figés. 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.

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, 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 écritures et virements créés 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

Fermer