Garage-atelier-réparation/en

From Dolibarr ERP CRM Wiki
Jump to navigation Jump to search


Concept

Workshop/garage/repair module. Create and manage Repair Orders (RO), **prefilled** vehicle registry (cars, motorcycles), scheduling, RO links ↔ proposals/orders/invoices/interventions. Technicians management, appointments, RO signing via link and QR-Code, RO line items, email sending.

Features

  • Create and manage Repair Orders (RO)
  • “Create RO” button on Thirdparty, Proposal, Order, Invoice, Intervention cards
  • From an RO: create order, intervention, proposal, invoice reusing RO key data
  • From an order, intervention, proposal, invoice, thirdparty: create an RO with vehicle data
  • Technicians planning, leave/sickness management with proof upload if needed
  • Technician appointment planner with unavailability lock. Create an RO from the planner, delete an RO…
  • Vehicle extrafields (brand, model, plate, VIN/serial, mileage, etc.) editable from RO, invoice, proposal, intervention, order
  • Bi-directional propagation of extrafields RO ↔ linked documents (mappings)
  • Technician planning with suggested time slots
  • RO PDF
  • RO list and search by customer/vehicle

DEMO/ https://dolibarr.ksi30.fr/


Languages

 English    Français    Italiano    Deutsch    Español

Installation

  1. Copy servicegarage into htdocs/custom/ or install from Dolibarr
  2. Enable the module in Setup → Modules/Applications
  3. Grant RO permissions to the relevant roles

Configuration

You can set or edit the constants below, then reload pages.

Constant Description
SERVICEGARAGE_ORBUTTON_ENABLE Enable the “Create RO” button on Dolibarr cards (0/1)
SERVICEGARAGE_MAINMENU Force the mainmenu parameter when redirecting to RO
SERVICEGARAGE_LEFTMENU Force the leftmenu parameter in RO URLs
SERVICEGARAGE_IDMENU Menu ID used to build module URLs
SERVICEGARAGE_OR_DEFAULT_TEMPLATE Default internal RO template
SERVICEGARAGE_DEFAULT_OR_PDF_MODEL Default RO PDF model (code)
SERVICEGARAGE_DEFAULT_PLANNING_DELAY Default suggested planning delay (minutes)
SERVICEGARAGE_XF_COPY_MAP Extrafields mapping DOC → RO
SERVICEGARAGE_OR_XF_COPY_MAP Extrafields mapping RO → DOC
SERVICEGARAGE_DOC_XF_COPY_MAP_FROM_OR Force copy of extrafields from RO to linked documents
SERVICEGARAGE_COPY_THIRDPARTY_REF Copy thirdparty reference into RO (0/1)
SERVICEGARAGE_ENABLE_IMPORT_SELECTOR Enable import selector (experimental)
SERVICEGARAGE_CGV_FILE Terms PDF to link on public pages (optional)
SERVICEGARAGE_DISABLE_CDN Disable third-party CDNs for the planner (compatibility)

Propagated vehicle extrafields

or_brand, or_model, or_version, or_type, or_serial, or_first_registration, or_immat, or_mileage

Permissions

  • RO read/write rights
  • Rights on Proposals/Orders/Invoices/Interventions for linking

Compatibility

Tested on Dolibarr 22.x. Generally compatible 21–23.

Hooks/Contexts

  • globalcard
  • thirdpartycard
  • propalcard
  • ordercard
  • invoicecard
  • fichintercard
  • interventioncard
  • productcard
  • documents

Troubleshooting

  • No RO button : check SERVICEGARAGE_ORBUTTON_ENABLE
  • Extrafields not copied : check SERVICEGARAGE_XF_COPY_MAP and SERVICEGARAGE_OR_XF_COPY_MAP
  • Wrong menus : adjust SERVICEGARAGE_MAINMENU/SERVICEGARAGE_LEFTMENU/SERVICEGARAGE_IDMENU

License

GPL v3.

Author : KSI 30 — contact@ksi30.fr