HTKapp Logo

Bank Accounts Module

The HtkDoli Bank Accounts module lets you view and manage your Dolibarr bank accounts: balance tracking, entries (transactions), internal transfers and documents.

Interface and Features (List)

The main view displays the list of all your bank accounts.

  • Search bar: Search by account label, bank name or account number.
  • Sorting:
    • Balance (Descending) — default
    • Balance (Ascending)
    • Name
  • Filters by status, with a counter shown next to each entry:
    • All
    • Open (status 0)
    • Closed (status 1)
  • Refresh: Dedicated button (or ⌘R shortcut) with a status indicator (loading, success, error, stale).

Information Displayed (Bank Cards)

Each row represents an account with:

  • The account label (e.g. Current Account).
  • The bank name (or, if absent, the account number).
  • The current balance with its currency and a color code (green for positive, red for negative).
  • The status (Open / Closed).

Pagination

  • A "Load more" button to browse the list in batches.
  • Pull-to-refresh available.

Quick Actions on the List

  • Swipe left: Edit the account.
  • Swipe right or long press (context menu): Edit / Delete the account (with a confirmation alert).
  • The "+" button in the top bar opens the creation of a new account.

Detail View (Viewing an Account)

Tapping an account in the list opens the detail view (BankDetailView), which gathers all the account's information and history.

When the record opens, the full account details (IBAN, BIC, branch, domiciliation, notes, owner, limits, etc.) are automatically reloaded from Dolibarr (GET /bankaccounts/{id}), which enriches fields that may be omitted from the list endpoint.

Header (Hero Section) and Current Balance

The detail view highlights the main data:

  • The account label and the bank name.
  • Badges indicating the status (e.g. Open) and the account type (Current Account, Savings / Passbook).
  • Current Balance: The balance shown in large format, formatted according to the account currency, together with a balance evolution chart over time (BalanceHistoryChart), based on the transaction history.

Information

A block with the account's technical information:

  • Account number, IBAN, BIC/SWIFT.
  • Bank code, branch code, RIB key (if available).
  • Currency and account opening date.

Owner and Branch

  • Owner: The name and address of the account holder.
  • Branch: The bank branch contact details (address, city, country) as well as a Website shown as a clickable link.

Limits & Thresholds

If configured in Dolibarr, the thresholds are displayed:

  • Min. Allowed: The authorized overdraft.
  • Min. Desired: The desired minimum balance.

Comment

Any comment entered in Dolibarr for this account.

Documents

  • Documents: The list of documents attached to the account in Dolibarr. You can tap a document to preview it (PDF), download it, and add new attachments. A swipe left on a document row reveals the Delete action (with a confirmation alert), which removes the file from the Dolibarr server.

Transactions (History)

The paginated list of all the account's bank entries. Three filters are available:

  • Direction: All / Credit / Debit.
  • Mode: Transfer, Bank Card, Check, Direct Debit, Cash, Other.
  • Date: All dates, This month, Last 3 months, This year.

For each entry:

  • The operation date.
  • The label.
  • The amount (green for credit).
  • The statement number if the row is reconciled.
  • A checkmark indicating the entry is reconciled.
  • A clickable link to the associated Third Party (Company) or Project, where applicable.

A "Load more" button extends pagination toward the present, and "Load older history" goes further back in the statements.

Floating Header Actions

Menu (•••):

  • Refresh: Reloads the full account record (information, transactions and documents) from Dolibarr.
  • Edit: Edits the account record.
  • Internal transfer: Opens the transfer sheet to another account.
  • Delete: Deletes the account and all its entries (confirmation alert).

No more "View the RIB": Dolibarr's documents API does not serve a bank account's attachments (verified on 15 September 2026). The RIB is viewed from the web interface.

A "+" button in the header opens the creation of a new entry.

Main Actions

Add a Transaction

A dedicated sheet lets you create a manual entry:

  • Date.
  • Type: Bank Card (default), Transfer, Direct Debit, Check, Cash, Miscellaneous.
  • Label.
  • Amount and Direction (Debit / Credit). A debit is recorded as a negative amount, a credit as positive.

Edit a Transaction

Only the label can be changed: it is the only field Dolibarr's API accepts on an existing entry (verified on 15 September 2026). Date, type, amount and direction are shown read-only. A linked Third Party for the entry is shown (and clickable) where applicable.

Internal Transfer

Creates a transfer between two of your accounts:

  • Source account (the current account) and its balance.
  • Destination account: ⚠️ only open accounts (excluding the source account) are offered.
  • Amount.
  • Label.
  • Date.

No reconciliation, no entry deletion. Dolibarr's REST API has no reconciliation route at all (verified on 15 September 2026 against a 24.0.0), and deleting an entry always answers with a server error. Both are done from the web interface. A long press on an entry opens Edit (label only, see above).

Balance Evolution Chart

A balance evolution chart over time is available (BalanceHistoryChart), based on the account's transaction history.

Business Behavior and Dolibarr

Synchronization

  • The account list is paginated and sorted by label.
  • When an account record opens, the full details (IBAN, BIC, branch, domiciliation, notes, owner, limits, etc.) are reloaded from Dolibarr.
  • Transactions are loaded when the record opens, with pagination toward the past and toward the present.
  • Pull-to-refresh and the Refresh menu action re-run the account detail, the transactions and the documents together.
  • Creations, label edits and transfers performed on the go are queued and then propagated to Dolibarr by synchronization.

Account Statuses

  • Open (0): Active account, entries allowed.
  • Closed (1): Closed account, view-only.

Rights and Permissions

For the Bank Accounts module to be accessible and to work correctly, the corresponding module must be enabled on your Dolibarr instance. Dolibarr rights apply:

  • Viewing: banque.lire (right to read bank accounts and their transactions).
  • Account creation / editing: bank account modification permission on the Dolibarr side.
  • Entries, transfer: corresponding permissions on the Dolibarr side.

Screenshots

2 screenshots — click to enlarge

← Previous Agenda Module Next → Knowledge Base Module