HTKapp Logo

Salaries Module

HtkDoli's Salaries module lets you view and manage the salary payments paid to the users (employees) of your Dolibarr instance. It is the accounting-entry module for compensation, not a full payroll module. It connects to your Dolibarr instance to give you an accurate view of recorded payments, their amounts and their beneficiaries.

⚠️ Known limitation — neither deletion nor validation. Dolibarr's REST API exposes no route to delete a salary (DELETE /salaries/{id} answers "Not Found") nor to validate one (POST /salaries/{id}/validate does not exist, and no key writes its status). Both actions have therefore been removed from the app: they were displayed and failed silently. Creation and editing work; to validate or delete a salary, use Dolibarr's web interface.

Interface and Features (List)

The main view displays the list of all your salary payments.

Viewing and Searching

  • List of payments: Displays the salaries/payments recorded in Dolibarr.
  • Refresh: You can refresh the list manually (dedicated button or ⌘R shortcut) to retrieve the latest data. Pull-to-refresh is also available.
  • Search: A search bar lets you quickly filter the list by label, beneficiary name (cached) or payment notes.
  • Pagination: The list is paginated with a "Load more" button when more payments are available.

Sorting and Filtering

Options are available in the header to organize the list:

  • Filters by payment status:
    • All (default)
    • Paid
    • Unpaid
  • Sorting:
    • Date (Recent) (default)
    • Date (Oldest)
    • Amount (High)
    • Amount (Low)

When sorting by date, payments are grouped by month (e.g. "January 2026"), with a floating section indicator while scrolling.

Information Displayed (Salary Cards)

Each card (or row) in the list represents a salary payment and displays:

  • The payment label (e.g. "Salary payment" by default).
  • The beneficiary name (cached).
  • The payment date.
  • The amount.

Detail View (Viewing a Payment)

Tapping a payment in the list opens the detailed view bringing together all the information.

Header (Hero Section)

The detail view highlights the main data:

  • The salary label.
  • The total amount.
  • Status: A visual badge indicating whether the salary is Paid (green) or Unpaid (orange).

Information

A block containing the payment information:

  • Label: The name given to the payment.
  • Payment date: The date on which the payment was (or will be) made.
  • Period: The period concerned (start date and end date), shown when set.
  • Project: If applicable, a link to the associated project.

Beneficiary

Information about the person (Dolibarr user) receiving the salary:

  • Name, Position, and Email (when the user record is available in the application).
  • In offline mode or if the full record is not loaded: the User ID and Name (cache) are shown, with the message "Details not available offline.".

Notes

Displays the comment / note associated with the payment.

Documents

  • The list of documents attached to the payment.
  • Preview and download of documents (PDF, etc.).
  • An "Add document" button allowing you to upload a new file or image directly from the application (pay slip, payment receipt, etc.).

Creation and Editing

The + button in the top bar (⌘N shortcut) opens the edit screen, which is also reachable via the Edit action. This screen lets you fill in:

  • Label (required).
  • Amount.
  • Project: Picker, shown if projects are available.
  • Bank account: Picker for the debited account, shown if accounts are available.
  • Payment mode: Transfer, cheque, cash… (list taken from the Dolibarr dictionary).
  • Period: A "Set a period" toggle enabling the Start date and End date fields. It is only needed for a period DIFFERENT from the day of entry: Dolibarr always requires a period, and the day of entry serves as one by default.
  • Beneficiary: Selection of the Dolibarr user via the dedicated search screen ("Select a user").
  • Note: Free comment.

Saving is only possible when a label is filled in and a beneficiary is selected.

No more "Payment date", "Payment ref." or "Paid" toggle: Dolibarr's REST API stores none of these three fields on a salary (verified on 15 September 2026 against a 24.0.0 — sent, never read back). A salary payment is recorded from the web interface; the app shows the Paid / Unpaid status as the server returns it.

Available Actions

From the list (via a long press or swipe) or from the detail view, you have several actions:

  • Edit: Edit the salary payment information.

The "…" menu on the detail view is gone: its only two entries were "Validate" and "Delete", both impossible (see the known limitation above). Only "Edit" remains.

  • See the PDF slip: (Coming soon) Will generate and display the pay slip in PDF format.
  • Mark as paid: (Coming soon) Will let you quickly change the status of an unpaid salary from the list.

Business Behaviour and Dolibarr

Statuses

  • Unpaid: Salary recorded but not yet settled.
  • Paid: Settlement recorded, with payment date and mode filled in.

A salary payment recorded in Dolibarr can be tied to a bank account. The associated entry is then visible in the Banks Module.

Synchronization

  • The list is paginated and fetched in batches.
  • Beneficiary details are fetched on demand.
  • Documents are loaded when the record is opened.

Prerequisites and Permissions

For the Salaries module to be accessible and to work correctly, the corresponding module must be enabled on your Dolibarr instance. Access requires the following permissions:

  • Viewing: read permission for the Salaries module.
  • Creation / Editing: write permission for the Salaries module.

Screenshots

2 screenshots — click to enlarge

← Previous Recruitment Module Next → Services Module