Module guide: Interventions

Non-technical user guide: what the module does, how to use it day to day and how it fits in with Dolibarr.

ModuleInterventions (KSIDol)
PurposeManage field interventions from A to Z.
UsageKSIDol modules
Key pointsScheduling · Vehicles · Times · Signature · Statistics · Technician area

1. Module overview

This module turns Dolibarr's intervention sheets into a complete tool for managing field interventions: scheduling, technicians, time entry, signature, signed weekly reports, statistics and invoicing, adaptable to every trade (repair, maintenance, installation, services…). It relies entirely on Dolibarr's native objects (third parties, interventions, quotations, orders, invoices, agenda): nothing is isolated, everything remains usable by the rest of Dolibarr.

  • Each intervention receives a unique number (IE no.), is scheduled, assigned to a technician and signed on site by the technician then by the customer.
  • The register of each customer's vehicles or machines links interventions, quotations and invoices to the equipment concerned, with assisted entry by registration number or serial number.
  • Working and travel times are entered as a start time and an end time on a single screen; labour is invoiced from the intervention, with no re-entry.
  • Each technician can have their own area, limited to their interventions, and a weekly report of their hours that they sign on the touch screen.
  • A statistics dashboard tracks activity, revenue and the invoicing of interventions.
  • Labels and menus can be renamed to match the vocabulary of your business.

2. Creating an intervention

An intervention is created like a classic Dolibarr intervention sheet, from the module's menu or from a customer's card.

  • Choose the customer concerned: their contact details and address are picked up automatically.
  • Enter the description of the work and the planned slot (planned start and end).
  • Complete the information specific to your trade through the custom fields (intervention type, equipment concerned, etc.).
  • Upon creation, an intervention number is assigned and a default scheduling lead time can position the appointment automatically.

3. The intervention number (IE no.)

Each intervention carries a unique, sequential number of its own (for example IE00001), displayed at the top of the sheet.

  • The number is clickable and leads straight back to the intervention sheet.
  • It is assigned both to interventions created by hand and to automatically generated interventions.

4. The register of vehicles and machines

For each customer, the module keeps the register of their vehicles or machines: it is what links interventions, quotations and invoices to the equipment concerned.

  • The "Vehicles / Customer" menu lists the fleet, and each third party's card carries a "Vehicles" tab: sorting and filtering by column (registration number tolerant of dashes, spaces and dots; odometer with >, < or =), with the date of the last visit.
  • A vehicle's card carries its full identity: registration number, brand, model, version, type, serial number (VIN), mileage, date of first registration, inspection validity, public note and private note.
  • On an intervention, a quotation, an order or an invoice, entry is assisted: vehicles already registered for the customer are picked from a list, and a known registration number automatically completes the fields left empty.
  • A document enriches the register but never overwrites it: an unknown vehicle is registered, a missing field is completed, and a known vehicle is only corrected from its own card.
  • The odometer reading entered on a document belongs to that document: it is not overwritten by the frozen value of the register.
  • Brands and models entered automatically feed the module's dictionaries, for consistent entry from one document to the next.
  • The vehicle's identity follows the intervention onto the quotation, the order and the invoice; fields ticked "PDF" are printed on the documents, only when they are filled in.
  • In the intervention list, clicking a registration number filters the sheets on that vehicle; Dolibarr's global search finds an intervention by its reference, registration number, serial number, brand or model.

5. Scheduling and moving on the planning

The planning displays interventions as appointments that you move with the mouse.

  • Move or resize an appointment to change its date, time or duration.
  • The sheet's dates, the time lines and the linked agenda event automatically follow the move.
  • A mouse selection directly on the calendar offers to create an intervention: the chosen slot is carried into the "Début planifié" and "Fin planifiée" fields.
  • A default scheduling lead time (adjustable) positions new interventions at X days.
  • Technicians' unavailability is displayed to avoid appointment conflicts.
  • When a move is refused, the reason is displayed directly on the appointment concerned.

6. Technicians

The module manages the list of technicians and their availability.

  • Assign a technician to each intervention.
  • The technician list shows the number of interventions for each; a click displays them in detail without leaving the page.
  • View and manage absences from the "Availability / Leave" entry.
  • The planning takes unavailability into account when assigning a slot.

7. The technician area

Each technician can be linked to their own user account and have an area limited to their own data only.

  • A technician's card is linked to an existing user account, or to an account created directly from the screen, with a chosen or generated password; a button lets you reset it at any time.
  • A "Technician" menu gathers four screens: My interventions today, My schedule, Signed interventions and Weekly hours (two tabs: To sign and Signed history).
  • Partitioning is strict: a technician never sees another's data, whatever the screen.
  • A banner of indicators in large touch-friendly buttons, designed for tablets, shows the current figures and leads to each screen.
  • The visibility of the "Interventions" and "Tools" menus is set account by account, with a simple toggle.
  • Each account is explicitly classified "Technician" or "Other"; this classification always prevails over the native right.
  • On the Weekly hours screen, the manager can choose which technician is displayed; a technician remains limited to their own hours.

8. Scheduled interventions

For contracts and regular servicing, a scheduled intervention automatically generates the interventions when they fall due.

  • The "Intervention programmée" button creates the recurring template from the sheet.
  • Set the template's frequency, duration and technician.
  • At each due date, a daily task automatically creates an already-scheduled intervention.
  • An "Add to calendar" checkbox adds the corresponding event to the agenda.
  • The "Schedule the periodic inspection" button opens the pre-filled form (title, yearly frequency, due date); nothing is created without your validation.

9. Automatic due-date reminders (periodic inspection and servicing)

The module watches the inspection (periodic inspection) and servicing due dates of equipment, and sends the reminder emails on your behalf.

  • The "Prochain entretien" field is entered on the intervention sheet and is carried automatically to the equipment register, which feeds the reminders.
  • An hour-meter threshold is set in the register for equipment tracked by operating hours rather than by calendar.
  • On the sheet, an alert banner flags a missing due date, without ever blocking validation, invoicing, signing or printing.
  • Reminder emails go out through a daily task; a log keeps every send, and an anti-duplicate guarantee ensures each piece of equipment is only reminded once per due date, at the smallest threshold crossed.
  • The "Reminders" configuration tab sets everything: separate periodic inspection / servicing activation, lead-time thresholds, email template, sender, copies, sending time window and reminders after the due date.
  • A test send to the address of your choice and a preview of what will go out on the next run let you check the settings before enabling the reminders.

10. Preparing the intervention: the preparation blocks

The intervention sheet carries preparation blocks: simple working notes, distinct from the invoiced items.

  • Three zones are offered: "Work to be done", "Intervention details" and "Date to be scheduled".
  • The date to be scheduled is entered as free text ("week 44", "after the part is delivered") with, alongside, an optional date the planning can read.
  • Each block can carry a start time and an end time, to give an appointment as "from … to …".
  • Add as many blocks as needed; each can be deleted individually.
  • The blocks remain editable at any time, including on a validated sheet: they are preparation notes, not an accounting document.
  • These zones exist only on the intervention sheet: they are never copied onto a quotation, an order or an invoice.

11. Entering times: the "Intervention times" screen

All times — work and travel — are entered in the same place, in the "Intervention times" tab of the sheet.

  • The "Time of" selector offers three natures: "Home travel", "Intervention travel" and "Labour".
  • Each time is entered as a start time and an end time: the duration is computed automatically, in 15-minute steps — in the field, you know the arrival and departure times, not the duration.
  • Shortcuts fill the time without a keyboard: "Now", "+15 min", "+1 h" and "Clear".
  • The list below the form shows all the times already entered, in chronological order, with the "Arrival time" and "Departure time" columns, and one-click deletion.
  • A pencil opens the correction directly on the line concerned: an end time earlier than the start is refused, the overlap check is replayed, and a time already invoiced can no longer be changed.
  • Lines can be reordered by drag and drop; only the display order changes, never the times or the amounts.
  • Travel is not invoiced: it is recorded as time, broken down by origin for payroll preparation, and appears neither in the lines to invoice nor on the documents given to the customer.

12. Actual hours and the overlap check

The module cross-checks the times actually entered to detect — or refuse — overlapping schedules.

  • The "Actual hours" tab shows a per-technician planning of the slots actually entered, days as rows on a time scale common to all the plannings.
  • One colour per intervention sheet, stable from one screen to the next, distinguishes the interventions of a single day; each block links back to its sheet.
  • A hover tooltip details the reference, the customer, the type, the times and the duration; totals can be read per day, per technician and over the period.
  • Overlapping slots are shown in red.
  • On save, a time whose schedule overlaps another slot of the same technician, on the same day and across all sheets, is refused; the message names the conflicting slot.
  • The slots of two different technicians are never compared with each other.
  • This check is an option in the General tab, enabled by default; overlaps already recorded are only flagged, never blocked.

13. The lines to invoice (product, service, labour)

From the intervention, add the services, parts and labour that will be invoiced.

  • Add product, service or labour lines.
  • Enter the price excluding or including tax: the missing amount is computed automatically.
  • The labour generation button creates the billable line from the recorded intervention times; travel is never included, and a guard prevents invoicing the same time twice.
  • Correct or delete each line with the pencil and the bin, as in Dolibarr; the description of the chosen product is picked up automatically, with a hand-typed description keeping priority.
  • Move lines by drag and drop, with the mouse or a finger: the resulting order is that of the screen, the PDF and the invoice.
  • The VAT applied follows the business rule (0% if the customer or the company is not liable).

14. Invoicing an intervention

The lines entered on the intervention are used to create the invoice, with no re-entry.

  • From the Billing tab of a validated intervention, one click creates a draft invoice: any account allowed to create invoices benefits from it.
  • An anti-double-invoicing guard greys the button out as soon as an invoice is already linked to the intervention, with an explanation.
  • A "Create order" button complements the natively offered quotation and invoice.
  • An intervention created from a quotation, an order or an invoice picks up all the original lines: quantities, prices, VAT and descriptions, parts included.
  • The payment terms and method as well as the bank account are set in the configuration and apply to the documents created, when the third party does not define them itself.
  • The "Billing by customer" screen groups several interventions of the same customer onto a single invoice; the third party's card carries the same "Interventions to invoice" tab.
  • An option (General tab, disabled by default) attaches the intervention reports when sending an invoice by email: the already generated PDFs are added to the attachments, editable before sending.
  • The invoice remains a native Dolibarr invoice, with all the associated accounting.

15. Future work on the invoice

Each invoice carries a "Future work / Remark(s)" tab, to keep track of what will remain to be done or pointed out to the customer.

  • The note is entered with Dolibarr's usual text editor, directly on the invoice's tab.
  • When filled in, it is displayed on the invoice card and printed on its PDF, below the lines.
  • It adds no billable line: it is information, not an amount.

16. The intervention sheet PDF

The intervention sheet is printed with a PDF template of the module's own, selected automatically, which integrates the equipment and the costing into the body of the sheet.

  • An "Information" block picks up the fields ticked "PDF" in the configuration, with their customised labels; an empty field is not printed.
  • The detail to invoice (parts, services, labour) is printed after the report, within the frame of the sheet, with proper pagination: column headers repeated on every page, totals never separated from the table.
  • The entered times are printed with the date, the start time, the end time and the duration; travel never appears on the documents given to the customer.
  • The vehicle's public note can be printed, at the configuration's choice.

17. Touch signature of the intervention

The sheet is signed on site, on the touch screen, by the technician then by the customer.

  • On a validated sheet, the "Sign the intervention" button opens the signature screen.
  • Signing takes place in two steps: first the technician (name pre-filled with the logged-in user), then the customer (name to enter); the order of the steps cannot be bypassed.
  • Once finalised, the sheet switches to the native "Signed by all parties" status and remains viewable via "View signatures".
  • The PDF is regenerated automatically: the two signature frames show the stroke, the name actually entered and the date.
  • The "Send the signed sheet" button opens the native email form, contact pre-filled and signed PDF already attached; nothing goes out without your validation.
  • Each signature is recorded in a log — date, reference, signer's name, device and stroke — viewable from the "Signature logs" entry of the Configuration menu.
  • The "IE signature tracking" screen, reserved for administrators, shows the state of signatures customer by customer.

18. The signed weekly time report

A weekly report per technician freezes the week's hours and has them signed.

  • The dedicated screen is set to a technician and a week; the preview is immediate, with no second entry: it re-reads the times already recorded on the sheets.
  • The table presents the week day by day, with three totals: home travel, intervention travel and intervention.
  • "Validate the report" freezes a complete snapshot: a later correction of an intervention never modifies an already validated report.
  • The technician signs their report on the touch screen, which finalises it.
  • Five formats are produced from the same snapshot: PDF, XML, ODT, XLSX and CSV, each starting with three indicators — hours of the week, intervention hours and travel hours.
  • A correction after signing generates a new report; the old one and its files remain intact.
  • The week's time grid is also displayed on a validated or signed report, drawn from the archived snapshot.

19. The statistics dashboard

A dedicated dashboard tracks intervention activity, protected by its own right.

  • The "View statistics" right controls both the menu and access to the pages, independently of the module's other rights.
  • Six tabs share the view: Activity (hours and invoicing per technician, with a curve), Revenue (compared with the previous period), Invoicing (in progress, overdue, settled, outstanding balance), Ongoing and upcoming, Actual hours, and Signed weekly reports.
  • The period is chosen for all the tabs at once: day, week, month or custom range.
  • Filters by technician, by third party and by intervention type refine each view.
  • The revenue displayed covers interventions only: it remains distinct from the company's overall revenue.

20. Badges and menus

Numbered markers flag what needs action, directly on the menus and the lists.

  • Three indicators are tracked: interventions to carry out, completed interventions not yet invoiced, and those without an appointment.
  • The badges sit on the menu entries concerned; a badge at zero is not displayed.
  • On the intervention list, these markers join the band of clickable indicators — interventions in progress, awaiting signature, signed, created this month — which filter the list.
  • An "Interventions to invoice" entry sits in the Invoices menu, with its badge; it only appears to users allowed to view interventions and create invoices.
  • Four submenus under "Billing by customer" lead directly to the invoices filtered on their state: list, drafts, unpaid and paid.
  • The module's menu is organised into four groups — Interventions, Technicians, Sales documents and Configuration — the "Sales documents" group giving direct access to quotations, orders, invoices and interventions, with their native statistics.

21. Lists and tablet use

The screens stay readable and finger-friendly, on a tablet as at the desk.

  • The intervention list shows four columns by default — number, machine, technician and scheduled date — the others remaining available in one click from the column selector.
  • On the vehicle lists, the Version and Type columns are hidden by default; the data remains viewable on the card.
  • The column choice is per user and kept from one visit to the next; a choice already made is never overwritten.
  • The side menu folds away on narrow screens and reopens with a gesture; wide tables scroll within their frame, with filters and buttons staying in place.
  • On a tablet, the system's native time pickers open at a touch.

22. Adapting the module (configuration)

The configuration opens with the "Configure the module" right — without requiring an administrator account — and adapts the module to the vocabulary and the needs of your business, in tabs.

  • "General settings": default scheduling lead time, service used to invoice labour, default payment terms, method and bank account, refusal of overlapping times (enabled by default), adding intervention reports to invoice emails (disabled by default).
  • The General tab also carries the option that hides the registration number field for machinery fleets: the serial number (VIN) then becomes the mandatory key, and a registration number already recorded is never erased.
  • "Labels": each field is set on a single row — renaming the label (for example renaming the vehicle "Type" label to a machine-oriented wording), display on the card, printing on the PDF — and the setting applies to all the documents concerned; menus can be renamed too.
  • "Documents and PDF": default PDF template and printing of the vehicle's public note.
  • "Reminders": all the due-date reminder settings, detailed above.
  • "Google Calendar": calendar synchronisation is set technician by technician, each with their own calendar.
  • "Signature tracking": enabling the intervention signature and its requirements.
  • Two technical tabs, "Diagnostic" and "Advanced", are reserved for administrators: read-only module state, menu repair and explicit maintenance actions.
  • Next to the configuration, the menu offers "Vehicle categories", "Dictionaries" — brands and models managed by hand or imported from a file, dictionaries that start empty and grow with use — and "Signature logs".
  • Each major function has its own right, adjustable user by user with plain-language labels: reading, creation and deletion, planning, configuration, statistics, technician area.
  • The module's guide remains viewable at any time from the "Notice" entry of the menu, and can be downloaded as a PDF.

23. Links with Dolibarr

The module does not work in isolation: it integrates with the native building blocks of Dolibarr.

  • Customer (third party) : Each intervention is linked to a Dolibarr third party and its contacts; the third party's card carries the "Vehicles" and "Interventions to invoice" tabs.
  • Invoicing : The intervention's lines feed a native Dolibarr invoice, with all the associated accounting.
  • Quotations and orders : The intervention fits into the usual sales cycle: quotation, order and invoice are created from the sheet, and their lines are carried over in both directions.
  • Products and services : The lines to invoice rely on the native catalogue; labour uses a Dolibarr service chosen in the configuration.
  • Agenda : Scheduled interventions can create agenda events, which follow the moves made on the planning.
  • Users : Each technician can be linked to a Dolibarr user account; the necessary rights are granted automatically.
  • Emails : Due-date reminders and the sending of the signed sheet go through Dolibarr's native email templates and mechanism.
  • Documents : PDFs and attachments remain managed by Dolibarr.
Need help? WhatsApp Phone: 07 45 15 75 87 Phone: 07 43 52 58 29 Email Open the form