Support time tracking and billing for Dolibarr
Call timer Phone support Floating headset button Time billing Monthly allowance Third-party tab Per-customer KPIs
Overview
TempsSupport is an external module for Dolibarr ERP/CRM (publisher KSIDol) that adds phone-support time tracking, from the call to the invoice.
A floating button (headset icon) is present on every page: with one click you start a timer linked to a customer, describe the call subject, then save the time. Each third-party record gets a tab listing its times and letting you bill them, individually or in bulk, with a monthly allowance included.
The module does not modify any Dolibarr core file.
Publisher and support
| Item | Information |
|---|---|
| Publisher | KSIDol |
| Specialty | Dolibarr integrator |
| Services | Custom development, SaaS hosting, Dolibarr support |
| Website | https://www.ksidol.io |
| Support | support@ksidol.io |
| Dolistore modules | https://www.dolistore.com/index.php?controller=search&orderby=position&orderway=desc&website=marketplace&search_query=k.s.i&submit_search= |
Module information
| Information | Detail |
|---|---|
| Module name | TempsSupport |
| Main use | Track phone-support time per customer and bill it |
| Type | Dolibarr external module |
| Family | CRM / Customer relationship |
| Documented version | 24.0.0 |
| Dolibarr compatibility | Dolibarr 18.0 to 24.x |
| PHP compatibility | PHP 7.4 or higher |
| Dolibarr core modification | No |
| License | GNU GPLv3 |
| Available languages | French, English, German, Spanish, Italian |
Official links
- Demonstration video: TempsSupport — demo (YouTube)
- Shop: KSIDol.io
- Module page: ksidol.io/en
- K.S.I publisher page on DoliStore: K.S.I modules on DoliStore
Module goals
Let service providers, software publishers, after-sales and hotlines precisely measure the time spent on the phone with each customer, without an external tool, then turn that time into an invoice:
- time each call (inbound or outbound) from any Dolibarr page;
- attach the time to the right customer and subject;
- bill the time individually or in bulk, with rounding and a minimum duration;
- handle flat-rate support offers (minutes included per month, billing only the overage).
Who is it for?
- Service providers and software publishers offering billable phone support.
- After-sales and hotlines that want to track and value phone time.
- Any organisation offering flat-rate support with a monthly included volume of minutes.
Main features
- Floating headset button: present on every page, whatever the theme (eldy, moderntemplate), without core modification; can be enabled/disabled in the configuration.
- Call timer: search (or create) a third party, choose the direction (inbound / outbound), start the timer, enter the subject, then "End call". The timer persists while you navigate (browser local storage).
- Record: each call becomes a time entry (reference, third party, contact, direction, start/end, actual duration, billed duration, subject, status).
- Third-party tab: list of the customer's times (actual and billed duration) with Bill / Edit / Do not bill / Make billable actions, and checkboxes for bulk billing.
- Billing: creates a draft invoice with one line per time entry (quantity in hours); the price comes from the configured product/service or a fallback hourly rate. Rounding (step) and a minimum duration are applied to the billed duration.
- Per-third-party KPIs: number of recorded times, cumulative actual duration and time to bill.
Monthly allowance included
Each third party can have a volume of minutes included per month (or a default module allowance). The tracking shows the used, the remaining and the overage:
- the time covered by the allowance is marked "Included" and generates no invoice;
- the overage is billed at the additional-hour price (per-third-party extrafield).
Menus
The module adds a main menu Support Time with:
- Times list — all recorded times
- To bill — times with status "To bill"
- Configuration — module settings
A Support Time tab is also added to the third-party record.
Configuration
From Home → Setup → Modules → Support Time:
- show the floating button (yes/no);
- billing product/service (reference on invoice lines);
- use the product price (yes/no);
- fallback hourly rate (if the product has no price);
- billed-duration rounding (minutes; 0 = actual duration);
- minimum billed duration (minutes; 0 = none);
- default support allowance / month (minutes).
Two extrafields are added on the third-party record: included allowance / month and additional-hour price.
User permissions
The module defines five permissions:
- Read the support times (read)
- Create / edit the support times (write)
- Bill the support times (bill)
- Delete the support times (delete)
- Configure the module (config)
Daily use
- The phone rings: click the headset button.
- Search the customer, direction "Inbound call", "Start timer".
- During the call, browse Dolibarr freely — the timer keeps running.
- Enter the subject, "End call": the time is recorded.
- At month end, the customer's "Support Time" tab: select the times, "Bill the selection".
- The draft invoice is created (one line per call); time covered by the allowance is marked "Included".
Technical note
- Table:
llx_tempssupport_ticket(one record per support time). - Assets loaded on every page via
module_parts(main hook, module CSS and JS). - Timer persistence on the browser side (local storage).
- Dolibarr standards respected: hooks, permissions, CSRF tokens,
GETPOST, escaping. - No Dolibarr core modification.
Installation
- Unzip the archive to get a
tempssupport/folder. - Copy it into
htdocs/custom/of your Dolibarr. - Check write permissions on
documents/tempssupport/. - Enable the module from Home → Setup → Modules/Applications.
- On activation, the required table and extrafields are created automatically.
Update
- Replace the
htdocs/custom/tempssupport/folder with the new version. - Reload an administration page: the schema (columns, extrafields) is checked and completed automatically, idempotently.
- No existing data is deleted by the update.
Troubleshooting
- The button does not appear: check that the "Show floating button" option is set to Yes and that the user has read permission.
- Nothing to bill: times must have the "To bill" status and belong to the same third party; a time fully covered by the allowance produces no line.
- Zero price on the invoice: set a price on the product/service or a fallback hourly rate.
See also
- KSIDol Signature Terminal: signing of all native Dolibarr records, compatible with every KSIDol module.
- Compatibility: Dolibarr 18.0 to 24.x — PHP 7.4+ — GPLv3 license — Publisher: KSIDol.
Summary
TempsSupport times your customers' phone-support from any Dolibarr page (headset button), records it per third party and turns it into an invoice — individually or in bulk, with rounding, a minimum duration and a monthly included allowance (billing only the overage).