Support time tracking and billing for Dolibarr


TempsSupport for Dolibarr
Track phone-support time per customer and bill it directly in Dolibarr, monthly allowance included
   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

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

  1. The phone rings: click the headset button.
  2. Search the customer, direction "Inbound call", "Start timer".
  3. During the call, browse Dolibarr freely — the timer keeps running.
  4. Enter the subject, "End call": the time is recorded.
  5. At month end, the customer's "Support Time" tab: select the times, "Bill the selection".
  6. 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

  1. Unzip the archive to get a tempssupport/ folder.
  2. Copy it into htdocs/custom/ of your Dolibarr.
  3. Check write permissions on documents/tempssupport/.
  4. Enable the module from Home → Setup → Modules/Applications.
  5. On activation, the required table and extrafields are created automatically.

Update

  1. Replace the htdocs/custom/tempssupport/ folder with the new version.
  2. Reload an administration page: the schema (columns, extrafields) is checked and completed automatically, idempotently.
  3. 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).