Dolibarr ERP CRM Wiki - User contributions [en]

Módulo Gestión de vehículos

2026-09-07T09:19:21Z

Mapiolca: Crear la guía de usuario completa en español con QUARTIX QWS v2, capturas anonimizadas y enlaces entre idiomas.

[[fr:Module Gestion des véhicules]]
[[en:Module Vehicle Management]]
[[it:Modulo Gestione dei veicoli]]
[[de:Modul Fahrzeugverwaltung]]

'''Gestión de vehículos y maquinaria''' es un módulo externo de Dolibarr para administrar vehículos de carretera, furgonetas y máquinas. Reúne características técnicas, asignaciones de conductores, lecturas del cuentakilómetros, consumos, intervenciones, seguros e inspecciones reglamentarias.

Permite vincular facturas de proveedores a intervenciones e inspecciones, generar un expediente del vehículo en PDF y ZIP e integrar '''QUARTIX QWS v2''' para estimaciones de kilometraje, resúmenes de utilización, posiciones, trayectos y mapas de recorridos.

Este artículo incluye una guía ilustrada de instalación y uso. Las capturas proceden de un entorno de demostración francés con Dolibarr 24 y Multicompany. Las direcciones y matrículas están difuminadas. Los valores de ejemplo no son recomendaciones de configuración ni referencias de consumo. La presentación y los textos de la interfaz pueden variar según la versión y el tema de Dolibarr.

Documentación actualizada el 7 de septiembre de 2026. El desarrollo de QUARTIX amplía la versión 1.0.0; un archivo anterior con ese número de versión puede no incluirlo. El módulo ofrece traducciones de software en francés e inglés. Las versiones italiana, alemana y española de este artículo no añaden esos idiomas al programa.

__TOC__

== Información ==

{| class="wikitable"
! Elemento !! Valor
|-
| Módulo || Gestión de vehículos y maquinaria
|-
| Identificador técnico || <code>lmdbvehiclemanagement</code>
|-
| Autor / familia || Pierre Ardoin / Les Métiers du Bâtiment
|-
| Versión || 1.0.0, primera versión estable del 4 de septiembre de 2026; ampliación QUARTIX documentada más abajo
|-
| Requisitos || Dolibarr 20+, PHP 8.0+, MySQL o MariaDB
|-
| Idiomas del programa || Francés e inglés
|-
| Multicompany || Compatible; opcional
|-
| Licencia || GNU GPL versión 3 o posterior
|}

== Funcionalidades ==

=== Gestión de la flota ===

* Fichas de vehículos, furgonetas y maquinaria, con matrícula opcional.
* Características técnicas, energía, capacidades de consumibles y autonomía WLTP.
* Ciclo de vida desde borrador hasta cesión o venta.
* Asignaciones simultáneas de conductores, con una sola asignación principal por período.
* Lecturas del cuentakilómetros, correcciones y sustituciones del contador.
* Intervenciones, averías e incidentes; historial consolidado con inspecciones y consumos.
* Modelos de numeración, incluido un modelo basado en la matrícula.

Las listas incluyen filtros, ordenación, paginación y columnas configurables. Las fichas utilizan las funciones nativas de Dolibarr para notas, contactos, archivos adjuntos y objetos vinculados cuando corresponda.

=== Repostajes, recargas y consumos ===

El módulo gestiona combustibles, recarga eléctrica, hidrógeno y aditivos. Cada consumible tiene su unidad y sus energías compatibles. Las capacidades del vehículo permiten advertir de cantidades superiores a las configuradas.

* Los consumos se sincronizan con sus lecturas del cuentakilómetros.
* Los resúmenes distinguen vehículos, consumibles y unidades.
* Los gráficos nativos muestran costes, distancias y estadísticas de consumo.
* Se ofrecen importación CSV y exportación nativa.
* El precio de un aditivo puede ser desconocido: un importe vacío se excluye de las estadísticas de precios; cero representa un precio conocido de cero.

Una opción por entorno crea un '''pago diverso''' nativo para un repostaje o una recarga. Requiere cuenta bancaria, datos de pago y justificante PDF, JPEG o PNG. Se eliminan los metadatos de las imágenes. La contabilidad es opcional; la partida doble requiere una cuenta general del plan contable activo. Los datos financieros y el justificante quedan bloqueados tras la conciliación bancaria o la transferencia contable.

'''La importación CSV de consumos no está disponible mientras esté activada la creación de pagos diversos.''' La activación no crea pagos para consumos históricos.

=== Seguros ===

* Contratos individuales o de flota, con varios vehículos y coberturas principales y adicionales.
* Contactos de aseguradora y mediador.
* Certificados para toda la flota o para un vehículo, con justificantes, revisión, validación, rechazo y archivo.
* Usuarios o grupos responsables y personas asignadas que cumplan los criterios.
* Recordatorios antes y después del vencimiento mediante plantillas de correo y tareas programadas nativas, evitando duplicados.

=== Inspecciones reglamentarias ===

Un cuestionario guiado determina los requisitos aplicables a partir de las características y el uso declarados. La versión 1.0.0 incluye un catálogo versionado '''francés''' de inspecciones técnicas, emisiones, categoría L, usos especiales, verificaciones generales periódicas (VGP), puesta en servicio/reanudación, tacógrafos, ADR y ATP. Admite excepciones por entorno y reglas propias. Traducir este artículo no convierte ese catálogo en normativa española ni de otro país.

* Inspecciones numeradas con organismo, resultado, fechas y justificante obligatorio.
* Validación inmutable, anulación motivada, sustitución, inspección de seguimiento y archivo controlado.
* Calendario de vencimientos, registro de seguridad, exportación e importación como borradores.
* Bloqueo configurable de nuevas asignaciones y puestas en servicio.
* Recálculo diario y recordatorios mediante tareas programadas, con un evento de agenda por requisito.

Cuando falta información esencial, no se calcula una fecha arbitraria. El módulo ayuda al seguimiento documental: no realiza inspecciones ni emite informes oficiales.

=== Facturas de proveedores vinculadas ===

En una intervención o inspección, '''Crear factura de proveedor''' abre el formulario nativo. Si el proveedor es conocido y accesible, se propone, pero puede cambiarse. Al guardar se crea un borrador de factura vinculado al origen.

También puede seleccionarse una factura existente o utilizar '''Vincular a''' desde una factura de proveedor. Ambos objetos muestran la relación en '''Objetos vinculados'''. Una intervención admite varias facturas. Desvincular elimina solo la relación, no la factura ni los datos reglamentarios validados. Ambos objetos deben pertenecer al entorno actual y requieren sus respectivos permisos.

=== Expediente del vehículo: PDF y ZIP ===

El modelo '''Expediente del vehículo''' genera:

* un PDF con características, historial disponible, eventos, inspecciones, facturas vinculadas, resumen de repostajes/recargas e inventario documental;
* un ZIP con ese PDF y los archivos originales adjuntos al vehículo, sus eventos, inspecciones y facturas vinculadas.

Se incluyen borradores, anulaciones y registros archivados. Una factura vinculada varias veces se incorpora una sola vez. Los archivos indexados que falten se señalan en el PDF. Se excluyen justificantes de consumo y pagos diversos, archivos temporales, vistas previas y expedientes anteriores. El resumen de consumos incluye fechas, lecturas, referencias, consumibles, tipos, unidades y referencias de aceite; excluye cantidades e importes.

La generación utiliza datos y archivos existentes. No genera documentos de facturas de proveedor ni reconstruye un historial no registrado. Requiere lectura/escritura del vehículo y lectura de facturas de proveedores. La consulta exige los correspondientes permisos de lectura combinados. Los usuarios externos y enlaces públicos no acceden al expediente.

=== Varios entornos ===

Las comparticiones se configuran en los ajustes nativos de Multicompany. Las listas correspondientes muestran una columna y un filtro '''Entorno'''. Los archivos permanecen en el directorio documental del entorno propietario, incluso al consultarlos desde otro entorno autorizado. Ajustes, modelos y comparticiones se conservan al desactivar y reactivar el módulo.

== Requisitos e instalación ==

Además de Dolibarr 20+, PHP 8.0+ y MySQL/MariaDB, compruebe las dependencias de las funciones utilizadas:

{| class="wikitable"
! Dependencia !! Uso
|-
| Agenda y Tareas programadas || Vencimientos, eventos, recálculo y recordatorios automáticos
|-
| Bancos y Cajas || Pagos diversos asociados a consumos
|-
| Contabilidad || Opcional; las cuentas exigidas dependen del modo contable
|-
| Facturas de proveedores || Vinculación de facturas y expediente del vehículo
|-
| Extensión PHP ZIP (<code>ZipArchive</code>) || Generación del expediente PDF/ZIP
|-
| Multicompany / Recursos || Compartición opcional / vínculo a un recurso de Dolibarr
|-
| Acceso QUARTIX QWS, cURL, OpenSSL y cifrado nativo || Integración QUARTIX opcional; Leaflet nativo para mapas
|}

# Obtenga la distribución del módulo necesaria, incluida la integración QUARTIX si se utiliza.
# Coloque <code>lmdbvehiclemanagement</code> en el directorio de módulos externos de Dolibarr, sin un segundo directorio anidado con el mismo nombre. Un archivo compatible también puede instalarse mediante la pantalla nativa de despliegue de módulos.
# Acceda como administrador a '''Inicio → Configuración → Módulos/Aplicaciones'''.
# Active el módulo en la familia '''Les Métiers du Bâtiment'''.
# Abra la configuración con la rueda dentada, revise '''Compatibilidad''' y asigne los permisos necesarios a usuarios/grupos.

== Configuración inicial ==

# Revise los diccionarios de energías, consumibles, tipos de maquinaria, perfiles, tipos de inspección y resultados.
# Seleccione modelos de numeración y documentos.
# Configure responsables de seguros, plantillas de recordatorio y plazos.
# Revise reglas reglamentarias y opciones de bloqueo.
# Active y compruebe las tareas programadas necesarias.
# Configure bancos y pagos por entorno si utiliza pagos diversos.
# Configure comparticiones y acceso a entornos de Multicompany cuando proceda.
# Configure QUARTIX según la sección específica si lo utiliza.

'''Compatibilidad''' y '''Acerca de''' son pestañas internas de configuración. Compatibilidad identifica dependencias ausentes en el entorno actual.

=== Numeración y modelo de expediente ===

En '''Configuración → Modelos de documentos''', active '''Expediente del vehículo'''; elegirlo como predeterminado es una operación distinta. En '''Modelos de numeración''', seleccione un modelo por objeto. Los vehículos pueden usar <code>standard</code> para referencias secuenciales o <code>registration</code> para matrículas normalizadas. Con el segundo, la maquinaria sin matrícula recibe una referencia MAT. Compruebe los ejemplos y utilice el procedimiento de migración del módulo si necesita cambiar referencias existentes.

[[File:LMDBVehicleManagement-2026-09-15-modeles-anonymise.png|thumb|center|1100px|Modelos de documentos y numeración. La activación y la selección predeterminada son independientes.]]

=== Gastos de consumo ===

En los ajustes de justificantes/pagos diversos, seleccione cuenta bancaria y medio de pago habitual del entorno, y después las cuentas contables apropiadas. La partida doble exige una cuenta general; la cuenta auxiliar es opcional. Active y guarde la opción. Compruebe que un nuevo consumo solicita los datos de pago y un justificante. Los registros históricos no se convierten y la importación CSV de consumos deja de estar disponible.

=== Recordatorios de seguros ===

En '''Seguros''', elija usuarios/grupos responsables, inclusión de personas asignadas y tipos de asignación admitidos. Defina plazos anteriores al vencimiento e intervalos de repetición tras el vencimiento o ante justificantes ausentes; seleccione las plantillas de depósito/revisión. Active los recordatorios, guarde y compruebe en Tareas programadas su activación y último resultado. '''Enviar correo de prueba''' envía un correo real: revise antes los destinatarios. Los intervalos de las capturas son de demostración.

[[File:LMDBVehicleManagement-1.0.0-16-relances-assurance.jpg|thumb|center|1100px|Destinatarios, plazos, plantillas y acceso a tareas programadas de seguros.]]

=== Recordatorios de inspecciones ===

En '''Inspecciones reglamentarias''', defina anticipación de recordatorios y período de próximos vencimientos. Seleccione usuarios/grupos, inclusión del conductor asignado, plantilla y, opcionalmente, recordatorios diarios de retrasos. Guarde y compruebe la tarea de recálculo/recordatorios. Las excepciones por entorno y reglas propias deben corresponder al equipo y conservar su justificación.

== Primeros pasos ==

=== Buscar o crear un vehículo ===

Abra el menú de vehículos, identificado por un automóvil. El menú lateral da acceso a flota, eventos, inspecciones, consumos y seguros.

# Abra la lista de vehículos/maquinaria y filtre por referencia, matrícula, etiqueta, modelo o estado.
# Busque con la lupa; la cruz restablece los filtros. Los encabezados ordenan la lista y el selector de columnas cambia las columnas visibles.
# Elija el tamaño de página y abra una ficha por su referencia. Con compartición activa, el filtro Entorno identifica la pertenencia.

[[File:LMDBVehicleManagement-2026-09-01-liste-anonymise.png|thumb|center|1100px|Navegación y filtros de la flota.]]

Para crear una ficha, seleccione '''Nuevo vehículo o maquinaria''', introduzca una etiqueta clara y matrícula si corresponde. Elija el tipo principal y complete categoría, pesos, plazas, territorio, número de serie, marca y modelo conocidos. Indique energía, autonomía conocida, fechas de fabricación/matriculación/puesta en servicio, régimen de propiedad y propietario. El vínculo a un recurso es opcional. Añada descripción y guarde; después ajuste capacidades de consumibles si procede. La ficha empieza como borrador y recibe la referencia del modelo configurado.

[[File:LMDBVehicleManagement-1.0.0-03-creation.jpg|thumb|center|1100px|Creación: identificación, características y fechas.]]

=== Leer la ficha y su estado ===

La ficha muestra identificación, estado, características, capacidades y cobertura de seguro. Según permisos, las pestañas permiten consultar notas, archivos, agenda, asignaciones, kilometraje, consumos, inspecciones, historial y QUARTIX.

[[File:LMDBVehicleManagement-2026-09-02-fiche-anonymise.png|thumb|center|1100px|Vehículo en servicio con características, capacidades y resumen de seguro.]]

{| class="wikitable"
! Estado !! Significado
|-
| Borrador || Preparar y comprobar la ficha
|-
| Validado || Identificado y aprobado, antes de la puesta en servicio
|-
| En servicio || En uso en la flota
|-
| Fuera de servicio || Retirado de la operación
|-
| Cedido / vendido || Salida de la flota tras su cesión o venta
|}

Utilice las acciones disponibles de validación, puesta en servicio, retirada o cesión según estado y permisos. Las reglas reglamentarias pueden impedir la puesta en servicio. Registre una cesión mediante su acción de ciclo de vida para conservar el historial; eliminar una ficha tiene otra finalidad.

== Uso diario ==

=== Asignar un conductor ===

Abra '''Asignaciones → Añadir asignación'''. Elija conductor, fecha/hora inicial y final si se conoce; indique tipo, carácter principal, estado y motivo, y guarde. Varias asignaciones pueden coincidir, pero solo una puede ser principal. Para terminarla, edítela con el lápiz y establezca final y estado.

[[File:LMDBVehicleManagement-2026-09-04-affectations-anonymise.png|thumb|center|1100px|Asignaciones de conductores: fechas, tipo, carácter principal y estado.]]

=== Lecturas del cuentakilómetros ===

En '''Kilometraje''', añada una lectura con fecha, valor observado y tipo. Justifique correcciones o sustituciones del contador. Guarde y revise cronología y diferencias. '''Una lectura generada por un consumo debe corregirse desde el repostaje/recarga de origen.''' No añada una lectura manual duplicada para corregirla. Las estimaciones QUARTIX se distinguen de las lecturas reales.

[[File:LMDBVehicleManagement-2026-09-05-kilometrage-anonymise.png|thumb|center|1100px|Lecturas, diferencias y fuentes. Las lecturas de consumos se gestionan desde su origen.]]

=== Registrar repostaje, recarga o aditivo ===

# Elija '''Nuevo repostaje / recarga''', introduzca fecha/hora y seleccione vehículo.
# Seleccione tipo y consumible; indique referencia de aceite cuando sea obligatoria.
# Compruebe conductor e introduzca cantidad en la unidad indicada y lectura del cuentakilómetros.
# Indique total con impuestos. Deje vacío un precio desconocido de aditivo; cero significa precio conocido nulo.
# Seleccione proyecto si procede. Con pagos diversos activados, revise datos de pago y adjunte justificante PDF/JPEG/PNG.
# Use lectura estándar para registros ordinarios; justifique corrección o sustitución del contador. Guarde y compruebe la ficha.

Ante una advertencia de exceso de capacidad, compruebe cantidad, unidad, vehículo y capacidad. Los datos financieros y justificantes conciliados o transferidos a contabilidad quedan bloqueados.

[[File:LMDBVehicleManagement-1.0.0-06-plein.jpg|thumb|center|1100px|Formulario de consumo con justificante y pago cuando la opción está activa.]]

=== Estadísticas de consumo ===

Abra el resumen general '''Consumos''' o la pestaña del vehículo. Defina fechas y filtros de vehículo/conductor/consumible/tipo. Busque, lea cantidades, costes, medias y máximos, revise gráficos y abra la lista de repostajes para rastrear un valor. Litros, kWh y kilogramos se mantienen separados y no se suman. Los intervalos excluidos identifican lecturas omitidas del cálculo. Los máximos de demostración no son consumos normales de referencia.

[[File:LMDBVehicleManagement-2026-09-07-synthese-anonymise.png|thumb|center|1100px|Filtros, resumen y gráficos nativos de consumos con datos de demostración.]]

=== Intervenciones, averías y facturas ===

Desde la ficha, seleccione '''Nuevo evento del vehículo'''. Introduzca etiqueta, tipo, fecha, conductor y proveedor; complete gravedad, kilometraje y posibles fechas de inmovilización. Describa los trabajos, guarde y adjunte justificantes al evento. La lista de eventos cubre la flota; el historial del vehículo reúne sus operaciones.

En el evento o inspección, cree una factura de proveedor o seleccione una existente y vincúlela. Compruebe la relación en Objetos vinculados; la referencia abre la factura. Desvincular conserva ambas fichas.

[[File:LMDBVehicleManagement-2026-09-13-intervention-facture-anonymise.png|thumb|center|1100px|Intervención con acciones de factura de proveedor y objetos vinculados.]]

== Seguros y certificados ==

=== Crear un contrato ===

Elija '''Nuevo contrato''' en Contratos de seguro. Seleccione aseguradora y, si procede, contacto/mediador. Introduzca número de póliza, etiqueta, garantías y período, renovación, preaviso conocido y contactos de asistencia. Seleccione vehículos cubiertos, tipo de cobertura y período. Guarde y compruebe vínculos. La cobertura puede ser principal o adicional; un contrato de flota reúne varios vehículos bajo una póliza.

[[File:LMDBVehicleManagement-1.0.0-18-creation-assurance.jpg|thumb|center|1100px|Creación del contrato y cobertura de vehículos.]]
[[File:LMDBVehicleManagement-2026-09-11-assurance-anonymise.png|thumb|center|1100px|Contrato guardado con vehículo cubierto.]]

=== Presentar y revisar un certificado ===

# Abra el contrato y su pestaña de certificados de seguro.
# Elija alcance: flota cubierta o vehículo admisible. Introduzca validez y adjunte justificante.
# Seleccione '''Guardar borrador''' para continuar preparando o '''Enviar a revisión''' cuando esté listo.
# Un revisor autorizado comprueba documento y fechas y lo valida o rechaza con un motivo.
# Al renovar, cree un certificado nuevo y archive el anterior mediante el proceso previsto.

La tabla muestra alcance, fechas, justificante descargable y estado. Un borrador no sustituye a un certificado revisado y validado.

[[File:LMDBVehicleManagement-1.0.0-12-attestations.jpg|thumb|center|1100px|Certificado validado y formulario de presentación; borrador y revisión son acciones distintas.]]

== Guía de inspecciones reglamentarias ==

=== Calificar el vehículo o equipo ===

Abra la pestaña de inspecciones del vehículo. Responda al cuestionario según características y uso reales, complete fechas aplicables y guarde. Revise requisitos calculados, inspección anterior, fecha calculada, fecha retenida y estado. Para equipos de elevación, determine el intervalo VGP según su calificación técnica; no suponga un período. Complete información faltante con la documentación del equipo.

[[File:LMDBVehicleManagement-2026-09-09-qualification-anonymise.png|thumb|center|1100px|Cuestionario de calificación reglamentaria.]]

=== Consultar vencimientos ===

Abra el calendario de inspecciones, filtre por período, vehículo, equipo, perfil, inspección o estado y ordene por fecha retenida. Abra el vehículo para examinar un requisito. Los estados distinguen requisitos al día y vencidos. Interprete la fecha retenida junto con la calificación y los justificantes.

[[File:LMDBVehicleManagement-2026-09-08-echeancier-anonymise.png|thumb|center|1100px|Calendario de inspecciones con fechas y estados de requisitos.]]

=== Registrar y validar una inspección ===

Use '''Registrar una inspección''' desde un requisito o Nueva inspección. Compruebe vehículo, requisito y tipo. Introduzca fecha, organismo, referencia del informe, resultado y validez oficial. Justifique una fecha efectiva distinta. Guarde observaciones, adjunte el justificante obligatorio al borrador y revise antes de validar. Compruebe después el requisito y vencimiento actualizados.

[[File:LMDBVehicleManagement-2026-09-10-controle-anonymise.png|thumb|center|1100px|Formulario de inspección: organismo, resultado, referencia y fechas.]]

Una inspección validada es inmutable. Corrija errores mediante anulación motivada y sustitución. Conserve el vínculo a la original para inspecciones de seguimiento. Las facturas pueden vincularse o desvincularse sin reescribir datos reglamentarios validados.

== Documentos, historial e importación/exportación ==

Use '''Notas''' para notas públicas/privadas autorizadas. Adjunte cada archivo al objeto correspondiente: informes de intervención al evento y justificantes de inspección a la inspección. La consulta, descarga, carga y eliminación nativas respetan los permisos del objeto. El permiso de lectura no permite modificar archivos.

=== Generar el expediente del vehículo ===

# Abra la ficha y el bloque '''Archivos adjuntos'''.
# Seleccione '''Expediente del vehículo''' en Modelo de documento y pulse '''Generar'''.
# Compruebe PDF y ZIP. La lupa abre la vista previa del PDF, el nombre permite descargarlo y el ZIP se descarga como archivo.
# Vuelva a generar para actualizar; no sustituya manualmente los archivos reservados del expediente.

[[File:LMDBVehicleManagement-1.0.0-14-dossier.jpg|thumb|center|754px|Selección nativa de modelo, generación, vista previa y descarga.]]
[[File:LMDBVehicleManagement-2026-09-19-apercu-pdf-anonymise.png|thumb|center|793px|Primera página de un expediente existente.]]

Los justificantes de consumo/pago no se incluyen en el ZIP. La consulta requiere lectura del vehículo y de facturas de proveedores.

=== Encontrar una operación anterior ===

Abra '''Historial''', filtre fechas, origen, tipo, etiqueta o estado, ordene por fecha y abra una operación mediante su etiqueta. Compruebe el indicador documental. '''Eventos/Agenda''' muestra eventos de agenda vinculados; Historial reúne la cronología de operaciones disponible.

[[File:LMDBVehicleManagement-2026-09-17-historique-anonymise.png|thumb|center|1100px|Historial consolidado de eventos, lecturas, consumos, seguros y asignaciones.]]

Utilice importación/exportación nativa con los conjuntos de datos del módulo y permisos correspondientes. Prepare columnas CSV según la importación elegida, compruebe referencias y entorno y revise resultados. Las inspecciones importadas quedan en borrador. Se rechaza la importación de consumos con pagos diversos activados. Mantenga vacío un precio desconocido de aditivo y cero para un precio conocido nulo.

== Integración de la API QUARTIX ==

=== Acceso, permisos y conexión ===

QUARTIX QWS v2 se utiliza en modo de solo lectura. Solicite a QUARTIX acceso QWS, código de cliente, usuario, contraseña y '''APPLICATION NAME''', y confirme el acceso a datos de recorridos. Compruebe distribución del módulo y Compatibilidad: se requieren, según función, cURL, OpenSSL, cifrado nativo con la clave de instancia de Dolibarr y Leaflet nativo. Tras el despliegue, desactive/reactive el módulo para registrar tablas, derechos y tareas conservando los ajustes existentes.

La lectura de vehículos, consulta GPS y sincronización QUARTIX son permisos separados. Conceda al usuario interno de tareas programadas lectura de vehículos, sincronización QUARTIX y gestión del cuentakilómetros. Sincronizar no concede acceso GPS. Los usuarios externos no acceden a QUARTIX. Los ajustes y asociaciones pertenecen al entorno propietario, que también sincroniza sus vehículos compartidos.

# Abra los ajustes del módulo y '''QUARTIX'''.
# Introduzca código de cliente, usuario, contraseña y el APPLICATION NAME exacto facilitado por QUARTIX. Un campo de contraseña vacío conserva la almacenada.
# Confirme la interpretación de fechas y horas. La '''convención QWS''' respeta un desfase horario explícito y, en su ausencia, utiliza la zona horaria local del vehículo. Use un modo forzado solo tras confirmar la convención de la cuenta.
# Confirme con QUARTIX la unidad de las duraciones. Hasta configurarla, las duraciones son desconocidas, no cero.
# Configure '''Conservación de trayectos (días)'''; el valor inicial es 30 cuando no existe un ajuste anterior.
# Guarde, pruebe después la conexión y cargue el catálogo de vehículos.
# Active la sincronización una vez configurada y las cuatro tareas nativas indicadas abajo.

Cada entorno tiene credenciales, tokens, asociaciones y estado de sincronización propios. Las contraseñas almacenadas no se muestran. Cambiar credenciales renueva la autenticación de ese entorno.

=== Asociaciones de vehículos y reasignación del dispositivo ===

Seleccione vehículo Dolibarr y su equivalente QUARTIX, confirme zona horaria IANA y fecha/hora real de instalación del dispositivo y guarde. El inicio de jornada procede de QUARTIX. Compruebe los primeros valores en '''Utilización QUARTIX''' del vehículo. La instalación limita nuevos datos: se rechazan posiciones y estimaciones anteriores; los resúmenes empiezan en la primera jornada QUARTIX completa posterior. Las asociaciones migradas sin fecha de instalación permanecen sin una fecha inventada. Revise la asociación si cambia la zona horaria o el inicio de jornada en QUARTIX.

El interruptor nativo suspende/reactiva una asociación. '''Desasociar''' distingue:

* '''Reasignación del dispositivo''': conservar importaciones en el vehículo antiguo. Los recorridos ya cargados siguen disponibles hasta su caducidad; cesan las nuevas solicitudes de la asociación anterior.
* '''Asociación incorrecta''': eliminar definitivamente trayectos, resúmenes y estimaciones QUARTIX del vehículo según la confirmación.

Ambas opciones borran la última posición y liberan el dispositivo. Se conservan lecturas manuales y de consumos. Una asociación nueva no puede solaparse con el historial conservado del mismo vehículo.

=== Tareas programadas ===

Las tareas se instalan '''desactivadas''', inicialmente con una ejecución cada quince minutos. Compruebe usuario de ejecución, actívelas en las Tareas programadas nativas y revise sus últimos resultados.

{| class="wikitable"
! Tarea QUARTIX !! Función
|-
| Últimas posiciones || Actualizar posiciones por lotes de vehículos
|-
| Kilometraje diario || Importar estimaciones del cuentakilómetros mediante procesamiento diario de vehículos
|-
| Utilización y recuperación histórica || Importar jornadas completas y recuperar progresivamente el historial de utilización
|-
| Registro de trayectos || Actualizar jornadas actuales/abiertas, recuperar historial, atender solicitudes de recorridos y purgar trayectos caducados
|}

El intervalo no garantiza una actualización completa de la flota en quince minutos. Tamaño de flota, lotes, tiempos de respuesta y cuotas influyen en la finalización. Los errores de cuota o servicio imponen una espera compartida por el entorno; repetir pruebas de conexión no la evita.

=== Utilización y cuadro de mando ===

La pestaña Utilización QUARTIX muestra asociación e información importada autorizada. El cuadro de mando de flota utiliza filtros, indicadores y gráficos nativos.

* Las estimaciones de kilometraje se identifican y no sustituyen lecturas reales ni de consumos. Las contradicciones se señalan sin bloquear lecturas reales.
* La última posición requiere permiso GPS. Compruebe su fecha: una posición antigua no demuestra avería ni inmovilización.
* La utilización incluye distancia, número de trayectos, días activos y cobertura de datos. Los resúmenes diarios se conservan doce meses; el día actual se excluye de resúmenes de jornadas completas.
* Un día desconocido no equivale a un día conocido sin actividad. Los totales solo utilizan días informados.
* El cuadro muestra inicialmente los treinta últimos días completos. Totales y evolución diaria abarcan la selección; la comparación de vehículos muestra las veinte distancias más altas. Sin permiso GPS se omiten lugares y enlaces GPS.

Leer datos importados no llama a QWS. Los cálculos de consumo continúan utilizando lecturas reales.

[[File:LMDBVehicleManagement-2026-09-quartix-utilisation.png|thumb|center|1000px|Utilización diaria de QUARTIX: cobertura de días, distancias y número de trayectos. Las duraciones no están disponibles hasta confirmar su unidad.]]

=== Registro de trayectos ===

Abra '''Trayectos''' con permiso GPS, seleccione un período (inicialmente los últimos siete días), aplique filtros y examine salida, llegada, distancia y estado. Use selección de columnas, ordenación y paginación. Compruebe cobertura de días y hora de sincronización antes de concluir que no hubo trayectos.

Las horas visibles siguen la zona horaria de la sesión Dolibarr; la jornada sigue el límite diario QUARTIX del vehículo. Las llegadas provisionales no se presentan como definitivas. '''Los trayectos privados conservan solo día y distancia''': no direcciones, coordenadas, horas exactas, duraciones ni recorridos. La ausencia de indicadores de privacidad recibe la misma protección.

[[File:LMDBVehicleManagement-2026-09-quartix-trajets-anonymise.png|thumb|center|1000px|Registro QUARTIX con filtros de período y estados de los trayectos. Las direcciones están difuminadas.]]

=== Mapa del recorrido ===

Active los recorridos en los ajustes QUARTIX del propietario tras confirmar acceso QWS a esos datos. Pulse '''Ver recorrido''' en un trayecto no privado. El diálogo nativo muestra el recorrido en caché o lo solicita si falta. '''Cargar / actualizar recorrido''' se habilita cuando se permite otro intento. En vehículos compartidos, si falta en caché, la solicitud espera a la tarea Registro de trayectos del propietario.

La ventana modal nativa no contiene historial de navegación incrustado ni barra de depuración. Información y advertencias permanecen visibles como bloques de alerta. El mapa une posiciones QUARTIX; '''no calcula un itinerario por carretera'''. Los trayectos terminados muestran marcadores de salida y llegada. Solo los abiertos muestran la nota de trayecto en curso y carecen de llegada definitiva. Menos de dos puntos, datos ausentes o incompatibles producen un estado de no disponibilidad.

Un recorrido terminado en caché no vuelve a consultar QUARTIX. Las solicitudes para el mismo día se espacian al menos quince minutos, sujetas a cuotas. Las comprobaciones periódicas del diálogo releen caché y permisos; no son seguimiento GPS en directo.

Se utilizan por defecto teselas OpenStreetMap, sin clave API y con atribución visible. Puede configurarse otra URL HTTPS de teselas y su atribución. El proveedor del mapa recibe solicitudes de la zona consultada, no secretos QUARTIX. Un fallo de teselas se informa por separado de la falta de recorrido.

[[File:LMDBVehicleManagement-2026-09-quartix-route-anonymise.png|thumb|center|1000px|Trayecto terminado en el diálogo nativo con mensajes persistentes. La matrícula y el fondo del mapa están difuminados para proteger las ubicaciones; se conserva la atribución cartográfica.]]

=== Conservación y confidencialidad ===

Trayectos y recorridos comparten un plazo. Al reducirlo, los días caducados se ocultan inmediatamente; la tarea Registro de trayectos los purga después por lotes. Ampliarlo permite recuperar progresivamente días todavía disponibles en QUARTIX. La purga continúa si solo se suspende la sincronización, siempre que módulo y tarea Registro de trayectos sigan activos; detener cualquiera de ellos detiene la purga. Los resúmenes de utilización mantienen su ventana independiente de doce meses.

Los recorridos almacenados están cifrados. Si un trayecto pasa a ser privado o incompatible con el registro, pierde acceso al recorrido anterior. Posiciones y trazas GPS se excluyen de documentos, exportaciones y API del módulo. No se importan identidades de conductores, puntuaciones de conducción ecológica ni velocidades detalladas.

=== Diagnóstico QUARTIX ===

{| class="wikitable"
! Síntoma !! Comprobación
|-
| Falla la prueba de conexión || Guarde todas las credenciales, especialmente APPLICATION NAME. Anote etapa y estado HTTP mostrados sin compartir secretos ni respuestas API sin tratar.
|-
| No llegan datos || Compruebe asociación activa, sincronización, instalación, permisos del usuario y las cuatro tareas. La recuperación histórica necesita varias ejecuciones.
|-
| Duraciones no disponibles || Confirme la unidad con QUARTIX y guárdela.
|-
| Falta el icono de mapa || Compruebe permiso GPS, activación de recorridos, privacidad y conservación.
|-
| Solicitud pendiente || Compruebe tarea Registro de trayectos del propietario, sincronización y plazo de espera.
|-
| Mapa vacío || Lea la alerta persistente: puntos ausentes, sesión caducada, acceso retirado y fallo de teselas son causas distintas. Recargue después de actualizar el módulo.
|-
| Diferencias con QUARTIX || Compare mismo vehículo, jornada, zona horaria, límite diario, cobertura y sincronización; distinga estimaciones de lecturas reales.
|}

== Preguntas frecuentes ==

{| class="wikitable"
! Situación !! Comprobación o acción
|-
| Falta una acción || Revise permisos, estado del objeto y dependencias de Compatibilidad.
|-
| Falla el expediente || Compruebe activación del modelo, Facturas de proveedores, PHP ZIP y derechos de vehículo/facturas.
|-
| No puede editarse una lectura || Corrija las lecturas vinculadas a consumo desde su registro de origen.
|-
| Certificado sin validar || Revise estado, alcance, fechas y justificante; un borrador aún requiere revisión.
|-
| Falta vencimiento || Complete características y fechas exigidas por la regla.
|-
| No se envían recordatorios || Revise activación, destinatarios, plantillas, correo Dolibarr y resultados de tareas programadas.
|-
| Gasto no modificable || Compruebe conciliación o transferencia contable y use el proceso financiero nativo de corrección.
|-
| Aparecen datos de otro entorno || Compruebe Entorno y comparticiones Multicompany autorizadas.
|}

== Actualización y límites ==

Haga copia de seguridad de base de datos y documentos antes de actualizar. Sustituya los archivos y desactive/reactive el módulo para aplicar migraciones y declaraciones nativas conservando ajustes. Lea <code>ChangeLog.md</code>, compruebe modelos y tareas, regenere expedientes cuando cambie su presentación y revise los ajustes bancarios antes de activar pagos de consumos. Los eventos futuros usan etiquetas actualizadas; no se reescriben historial existente ni inspecciones validadas. QUARTIX requiere credenciales, asociaciones y cuatro tareas; los paquetes antiguos 1.0.0 pueden no incluirlo.

No se preconfiguran inspecciones detalladas de extintores, equipos a presión, accesorios de elevación ni refrigerantes. Quedan fuera la gestión de documentos de matriculación, siniestros, primas, franquicias y multas. Las facturas de compra se gestionan en Facturas de proveedores nativo. Los recordatorios periódicos requieren tareas programadas y entrega de correo operativas. No se ofrecen exportación de recorridos QUARTIX, conducción ecológica ni cambios automáticos de asignaciones de conductores.

== Fuentes y enlaces útiles ==

* [https://github.com/mapiolca/lmdbvehiclemanagement Código fuente del módulo]
* [https://github.com/mapiolca/lmdbvehiclemanagement/blob/094fc89/README.md Documentación original de la versión 1.0.0]
* [https://github.com/mapiolca/lmdbvehiclemanagement/blob/094fc89/ChangeLog.md Historial original de la versión 1.0.0]
* [https://github.com/mapiolca Perfil del autor]

[[Category:Módulos complementarios]]

Modul Fahrzeugverwaltung

2026-09-07T09:18:18Z

Mapiolca: Vollständige deutsche Benutzeranleitung mit QUARTIX QWS v2, anonymisierten Bildschirmaufnahmen und Sprachverknüpfungen erstellen.

[[fr:Module Gestion des véhicules]]
[[en:Module Vehicle Management]]
[[it:Modulo Gestione dei veicoli]]
[[es:Módulo Gestión de vehículos]]

'''Fahrzeug- und Maschinenverwaltung''' ist ein externes Dolibarr-Modul für Straßenfahrzeuge, Transporter und Maschinen. Es bündelt technische Fahrzeugdaten, Fahrerzuordnungen, Kilometerstände, Verbrauch, Wartungsereignisse, Versicherungen und vorgeschriebene Prüfungen.

Lieferantenrechnungen lassen sich mit Wartungen und Prüfungen verknüpfen. Eine Fahrzeugakte wird als PDF und ZIP erstellt. Die Anbindung an '''QUARTIX QWS v2''' ergänzt geschätzte Kilometerstände, Nutzungsübersichten, Positionen, Fahrten und Karten mit Fahrtverläufen.

Dieser Artikel enthält eine bebilderte Installations- und Bedienungsanleitung. Die Abbildungen stammen aus einer französischen Dolibarr-24-Demonstrationsumgebung mit Multicompany. Adressen und Kennzeichen sind unkenntlich gemacht. Beispielwerte sind weder Einstellungsempfehlungen noch Verbrauchsrichtwerte. Darstellung und übersetzte Bedienoberfläche können je nach Dolibarr-Version und Design abweichen.

Stand der Dokumentation: 7. September 2026. Die QUARTIX-Entwicklung erweitert Version 1.0.0; ältere Archive mit dieser Versionsnummer enthalten die Anbindung möglicherweise noch nicht. Das Modul selbst enthält französische und englische Übersetzungen. Die deutsche, italienische und spanische Dokumentation ergänzt keine entsprechenden Softwareübersetzungen.

__TOC__

== Informationen ==

{| class="wikitable"
! Merkmal !! Wert
|-
| Modul || Fahrzeug- und Maschinenverwaltung
|-
| Technischer Name || <code>lmdbvehiclemanagement</code>
|-
| Autor / Modulfamilie || Pierre Ardoin / Les Métiers du Bâtiment
|-
| Version || 1.0.0, erste stabile Veröffentlichung am 4. September 2026; QUARTIX-Erweiterung siehe unten
|-
| Voraussetzungen || Dolibarr 20+, PHP 8.0+, MySQL oder MariaDB
|-
| Softwaresprachen || Französisch und Englisch
|-
| Multicompany || Unterstützt, optional
|-
| Lizenz || GNU GPL Version 3 oder neuer
|}

== Funktionen ==

=== Fuhrpark ===

* Datensätze für Fahrzeuge, Transporter und Maschinen; Kennzeichen sind optional.
* Technische Daten, Energieart, Betriebsmittelkapazitäten und WLTP-Reichweite.
* Lebenszyklus vom Entwurf bis zur Veräußerung.
* Gleichzeitige Fahrerzuordnungen; nur eine Hauptzuordnung je Zeitraum.
* Kilometerstände, Korrekturen und Zählerwechsel.
* Wartungen, Pannen und Vorfälle sowie eine gemeinsame Historie einschließlich Prüfungen und Verbrauch.
* Nummerierungsmodelle, darunter ein Modell anhand des Kennzeichens.

Listen unterstützen Filter, Sortierung, Seitennavigation und auswählbare Spalten. Datensätze verwenden die nativen Dolibarr-Funktionen für Notizen, Kontakte, Anhänge und verknüpfte Objekte, soweit anwendbar.

=== Tanken, Laden und Verbrauch ===

Das Modul verwaltet Kraftstoffe, elektrische Ladungen, Wasserstoff und Zusätze. Betriebsmittel besitzen eigene Einheiten und kompatible Energiearten. Bei Mengen über der hinterlegten Fahrzeugkapazität erscheint eine Warnung.

* Verbrauchseinträge werden mit ihren Kilometerständen synchronisiert.
* Übersichten unterscheiden Fahrzeuge, Betriebsmittel und Einheiten.
* Native Diagramme zeigen Kosten, Strecken und Verbrauchsstatistiken.
* CSV-Import und nativer Export sind verfügbar.
* Bei Zusätzen kann der Preis unbekannt bleiben: ein leerer Betrag wird aus Preisstatistiken ausgeschlossen; null ist ein bekannter Preis von null.

Eine Einstellung je Umgebung ermöglicht eine native '''sonstige Zahlung''' zu einem Tank- oder Ladevorgang. Dafür werden Bankkonto, Zahlungsangaben und ein Beleg als PDF, JPEG oder PNG benötigt. Bildmetadaten werden entfernt. Die Buchhaltung ist optional; bei doppelter Buchführung ist ein Sachkonto aus dem aktiven Kontenplan erforderlich. Nach Bankabgleich oder Übertragung in die Buchhaltung werden Finanzdaten und Beleg gesperrt.

'''Der CSV-Verbrauchsimport ist bei aktivierter Erzeugung sonstiger Zahlungen nicht verfügbar.''' Die Aktivierung erstellt keine Zahlungen für alte Verbrauchseinträge.

=== Versicherungen ===

* Einzel- und Flottenverträge mit mehreren Fahrzeugen sowie Haupt- und Zusatzdeckung.
* Kontakte für Versicherer und Vermittler.
* Versicherungsnachweise für die Flotte oder einzelne Fahrzeuge, mit Datei, Prüfung, Freigabe, Ablehnung und Archivierung.
* Zuständige Benutzer oder Gruppen sowie berechtigte zugeordnete Personen.
* Erinnerungen vor und nach Ablauf über native E-Mail-Vorlagen und geplante Aufgaben, mit Schutz gegen doppelte Sendungen.

=== Vorgeschriebene Prüfungen ===

Ein geführter Fragebogen bestimmt aus den Fahrzeugmerkmalen und der Nutzung die anwendbaren Anforderungen. Version 1.0.0 enthält einen versionierten '''französischen''' Katalog: technische Fahrzeugprüfung, Emissionen, Kategorie L, besondere Nutzungen, wiederkehrende allgemeine Prüfungen (VGP), Inbetriebnahme/Wiederinbetriebnahme, Fahrtenschreiber, ADR und ATP. Umgebungsspezifische Abweichungen und eigene Regeln ergänzen ihn. Die Übersetzung dieser Anleitung ersetzt diesen Katalog nicht durch deutsches oder anderes nationales Recht.

* Nummerierte Prüfdatensätze mit Prüfstelle, Ergebnis, Daten und vorgeschriebenem Nachweis.
* Unveränderliche Freigabe, begründete Aufhebung, Ersatz, Nachprüfung und kontrollierte Archivierung.
* Fälligkeitsübersicht, Sicherheitsregister, Export und Import als Entwürfe.
* Konfigurierbare Sperren für neue Zuordnungen und Inbetriebnahmen.
* Tägliche Neuberechnung und Erinnerungen über geplante Aufgaben, mit einem Kalenderereignis je Anforderung.

Fehlen wesentliche Angaben, wird kein beliebiges Fälligkeitsdatum berechnet. Das Modul unterstützt die Dokumentation; es führt selbst keine Prüfungen durch und erstellt keine amtlichen Prüfberichte.

=== Verknüpfte Lieferantenrechnungen ===

Bei einer Wartung oder Prüfung öffnet '''Lieferantenrechnung erstellen''' das native Formular. Ein bekannter und zugänglicher Dienstleister wird vorgeschlagen, kann aber geändert werden. Beim Speichern entsteht ein Rechnungsentwurf mit Verknüpfung zum Ausgangsobjekt.

Eine vorhandene Rechnung kann ebenfalls ausgewählt werden. Umgekehrt ist die Zuordnung über '''Verknüpfen mit''' in der Lieferantenrechnung möglich. Beide Seiten zeigen die Verbindung in '''Verknüpfte Objekte'''. Eine Wartung darf mehrere Rechnungen haben. Das Lösen der Verbindung löscht weder Rechnung noch freigegebene Prüfdaten. Beide Objekte müssen zur aktuellen Umgebung gehören; die jeweiligen Berechtigungen bleiben erforderlich.

=== Fahrzeugakte als PDF und ZIP ===

Das Dokumentmodell '''Fahrzeugakte''' erzeugt:

* eine PDF-Datei mit technischen Daten, vorhandener Historie, Ereignissen, Prüfungen, verknüpften Rechnungen, einer Tank-/Ladeübersicht und einem Dokumentverzeichnis;
* ein ZIP-Archiv mit dieser PDF-Datei und den Originalanhängen des Fahrzeugs, seiner Ereignisse, Prüfungen und verknüpften Rechnungen.

Entwürfe, aufgehobene und archivierte Datensätze werden berücksichtigt. Eine mehrfach verknüpfte Rechnung wird nur einmal aufgenommen. Fehlende indizierte Dateien werden in der PDF vermerkt. Verbrauchs- und Zahlungsbelege, temporäre Dateien, Vorschauen und frühere Fahrzeugakten sind ausgeschlossen. Die Verbrauchsübersicht enthält Daten, Kilometerstände, Referenzen, Betriebsmittel, Arten, Einheiten und Ölreferenzen, jedoch keine Mengen oder Beträge.

Verwendet werden vorhandene Daten und Dateien. Das Verfahren erstellt keine Lieferantenrechnungsdokumente und rekonstruiert keine nicht erfasste Historie. Zum Erzeugen sind Fahrzeug-Lese-/Schreibrechte und Leserechte auf Lieferantenrechnungen erforderlich; zum Lesen die entsprechenden kombinierten Leserechte. Externe Benutzer und öffentliche Links haben keinen Zugriff auf die Fahrzeugakte.

=== Mehrere Umgebungen ===

Freigaben werden in den nativen Multicompany-Einstellungen verwaltet. Betroffene Listen besitzen eine Spalte und einen Filter '''Umgebung'''. Dateien verbleiben im Dokumentverzeichnis der besitzenden Umgebung, auch beim Zugriff über Freigaben. Einstellungen, Modelle und Freigaben bleiben bei Deaktivierung und erneuter Aktivierung erhalten.

== Voraussetzungen und Installation ==

Neben Dolibarr 20+, PHP 8.0+ und MySQL/MariaDB sind die Abhängigkeiten der verwendeten Funktionen zu prüfen:

{| class="wikitable"
! Abhängigkeit !! Verwendung
|-
| Kalender und geplante Aufgaben || Automatische Termine, Ereignisse, Neuberechnung und Erinnerungen
|-
| Banken und Kassen || Sonstige Zahlungen zu Verbrauchseinträgen
|-
| Buchhaltung || Optional; Kontenanforderungen abhängig vom Buchhaltungsmodus
|-
| Lieferantenrechnungen || Rechnungsverknüpfungen und Fahrzeugakte
|-
| PHP-ZIP-Erweiterung (<code>ZipArchive</code>) || Erzeugung der PDF-/ZIP-Fahrzeugakte
|-
| Multicompany / Ressourcen || Optionale Freigaben / Verbindung zu einer Dolibarr-Ressource
|-
| QUARTIX-QWS-Zugang, cURL, OpenSSL, native Verschlüsselung || Optionale QUARTIX-Anbindung; natives Leaflet für Karten
|}

# Die benötigte Modulausgabe beziehen, gegebenenfalls einschließlich QUARTIX.
# <code>lmdbvehiclemanagement</code> im Verzeichnis für externe Dolibarr-Module ablegen, ohne ein zweites gleichnamiges Unterverzeichnis. Ein passendes Installationsarchiv kann auch über die native Modulbereitstellung installiert werden.
# Als Administrator '''Startseite → Einrichtung → Module/Anwendungen''' öffnen.
# Das Modul in der Familie '''Les Métiers du Bâtiment''' aktivieren.
# Über das Zahnrad die Einstellungen öffnen, '''Kompatibilität''' prüfen und Benutzern/Gruppen die benötigten Rechte zuweisen.

== Ersteinrichtung ==

# Wörterbücher für Energiearten, Betriebsmittel, Maschinenarten, Prüfprofile, Prüfarten und Ergebnisse prüfen.
# Nummerierungs- und Dokumentmodelle auswählen.
# Versicherungsverantwortliche, Erinnerungsvorlagen und Fristen konfigurieren.
# Prüfregeln und mögliche Sperren kontrollieren.
# Benötigte native geplante Aufgaben aktivieren und prüfen.
# Bei sonstigen Zahlungen Bank- und Zahlungseinstellungen je Umgebung vornehmen.
# Gegebenenfalls Multicompany-Freigaben und Umgebungszugriffe einstellen.
# QUARTIX bei Bedarf wie unten beschrieben konfigurieren.

'''Kompatibilität''' und '''Über''' sind interne Einstellungsregister. Die Kompatibilitätsseite nennt fehlende Abhängigkeiten der aktuellen Umgebung.

=== Nummerierung und Fahrzeugaktenmodell ===

Unter '''Einstellungen → Dokumentmodelle''' das Modell '''Fahrzeugakte''' aktivieren; die Wahl als Standard ist davon getrennt. Unter '''Nummerierungsmodelle''' ein Modell je Objekt wählen. Fahrzeuge können <code>standard</code> für fortlaufende Referenzen oder <code>registration</code> für normalisierte Kennzeichen verwenden. Beim zweiten Modell erhalten Maschinen ohne Kennzeichen eine MAT-Referenz. Beispiele kontrollieren und für Änderungen bestehender Referenzen das Migrationsverfahren des Moduls verwenden.

[[File:LMDBVehicleManagement-2026-09-15-modeles-anonymise.png|thumb|center|1100px|Dokument- und Nummerierungsmodelle. Aktivierung und Standardauswahl sind getrennte Einstellungen.]]

=== Verbrauchsausgaben ===

In den Beleg-/Zahlungseinstellungen Bankkonto und übliches Zahlungsmittel der Umgebung wählen, danach die passenden Buchhaltungskonten. Bei doppelter Buchführung ist ein Sachkonto erforderlich; das Personenkonto ist optional. Option aktivieren und speichern. Kontrollieren, dass ein neuer Verbrauchseintrag Zahlungsangaben und einen Beleg verlangt. Alte Einträge werden nicht umgewandelt; der CSV-Verbrauchsimport ist anschließend nicht verfügbar.

=== Versicherungserinnerungen ===

In den '''Versicherungseinstellungen''' zuständige Benutzer/Gruppen, Einbeziehung zugeordneter Personen und zulässige Zuordnungsarten auswählen. Fristen vor Ablauf und Wiederholungsabstände bei abgelaufenen oder fehlenden Nachweisen festlegen; Vorlagen für Einreichung und Prüfung wählen. Erinnerungen aktivieren, speichern und unter Geplante Aufgaben Aktivierung und letztes Ergebnis prüfen. '''Test-E-Mail senden''' verschickt eine echte E-Mail: Empfänger vorher kontrollieren. Die abgebildeten Zeitabstände sind Demonstrationseinstellungen.

[[File:LMDBVehicleManagement-1.0.0-16-relances-assurance.jpg|thumb|center|1100px|Empfänger, Fristen, Vorlagen und geplante Aufgaben für Versicherungserinnerungen.]]

=== Prüfungserinnerungen ===

Unter '''Vorgeschriebene Prüfungen''' Erinnerungshorizonte und den Zeitraum bevorstehender Fälligkeiten festlegen. Benutzer/Gruppen, gegebenenfalls den zugeordneten Fahrer, Erinnerungsvorlage und optional tägliche Überfälligkeitserinnerungen auswählen. Speichern und die Neuberechnungs-/Erinnerungsaufgabe prüfen. Umgebungsspezifische Abweichungen und eigene Regeln müssen zum Gerät passen und begründet bleiben.

== Erste Schritte ==

=== Fahrzeug suchen oder anlegen ===

Das Fahrzeugmenü mit dem Autosymbol öffnen. Das Seitenmenü führt zu Fuhrpark, Ereignissen, Prüfungen, Verbrauch und Versicherungen.

# Fahrzeug-/Maschinenliste öffnen und nach Referenz, Kennzeichen, Bezeichnung, Modell oder Status filtern.
# Mit der Lupe suchen; das Kreuz setzt Filter zurück. Spaltenüberschriften sortieren, die Spaltenauswahl steuert sichtbare Spalten.
# Seitengröße wählen und einen Datensatz über seine Referenz öffnen. Bei Freigaben zeigt der Umgebungsfilter die Zugehörigkeit.

[[File:LMDBVehicleManagement-2026-09-01-liste-anonymise.png|thumb|center|1100px|Fuhrparkliste mit Navigation und Filtern.]]

Zum Anlegen '''Neues Fahrzeug oder neue Maschine''' wählen, eine verständliche Bezeichnung und gegebenenfalls das Kennzeichen eingeben. Hauptart auswählen und bekannte Kategorie, Gewichte, Sitzplätze, Gebiet, Seriennummer, Marke und Modell ergänzen. Energieart, bekannte Reichweite, Herstellungs-/Zulassungs-/Inbetriebnahmedaten, Besitzart und Eigentümer eintragen. Eine Ressourcenverknüpfung ist optional. Beschreibung ergänzen und speichern; anschließend bei Bedarf Betriebsmittelkapazitäten bearbeiten. Der Datensatz beginnt als Entwurf und erhält seine Referenz über das konfigurierte Nummerierungsmodell.

[[File:LMDBVehicleManagement-1.0.0-03-creation.jpg|thumb|center|1100px|Neuanlage mit Identifikation, technischen Angaben und Daten.]]

=== Fahrzeugkarte und Status ===

Die Karte zeigt Identifikation, Status, technische Daten, Kapazitäten und Versicherungsschutz. Register bieten je nach Berechtigung Notizen, Dateien, Kalender, Zuordnungen, Kilometerstände, Verbrauch, Prüfungen, Historie und QUARTIX.

[[File:LMDBVehicleManagement-2026-09-02-fiche-anonymise.png|thumb|center|1100px|Fahrzeug in Betrieb mit technischen Daten, Kapazitäten und Versicherungsübersicht.]]

{| class="wikitable"
! Status !! Bedeutung
|-
| Entwurf || Datensatz vorbereiten und prüfen
|-
| Freigegeben || Identifiziert und geprüft, noch nicht in Betrieb
|-
| In Betrieb || Im Fuhrpark eingesetzt
|-
| Außer Betrieb || Aus dem Betrieb genommen
|-
| Abgegeben / verkauft || Nach Veräußerung aus dem Fuhrpark ausgeschieden
|}

Die verfügbaren Aktionen zur Freigabe, Inbetriebnahme, Stilllegung oder Veräußerung hängen von Status und Berechtigungen ab. Prüfregeln können die Inbetriebnahme sperren. Eine Veräußerung über die vorgesehene Statusaktion erfassen, damit die Historie erhalten bleibt; das Löschen eines Datensatzes hat einen anderen Zweck.

== Tägliche Arbeit ==

=== Fahrer zuordnen ===

'''Zuordnungen → Zuordnung hinzufügen''' öffnen. Fahrer, Beginn mit Uhrzeit und ein bekanntes Ende wählen; Art, Hauptzuordnung, Status und Grund ergänzen und speichern. Mehrere Zuordnungen dürfen sich überschneiden, jedoch nur eine als Hauptzuordnung. Zum Beenden über den Stift bearbeiten und Ende sowie Status setzen.

[[File:LMDBVehicleManagement-2026-09-04-affectations-anonymise.png|thumb|center|1100px|Fahrerzuordnungen mit Zeitraum, Art, Hauptzuordnung und Status.]]

=== Kilometerstände ===

Unter '''Kilometerstände''' Ablesedatum, beobachteten Wert und Art erfassen. Korrekturen und Zählerwechsel begründen. Nach dem Speichern Reihenfolge und Differenzen prüfen. '''Ein aus einem Verbrauchseintrag erzeugter Kilometerstand wird im ursprünglichen Tank-/Ladeeintrag korrigiert.''' Dafür keinen zusätzlichen manuellen Stand anlegen. QUARTIX-Schätzungen bleiben von tatsächlichen Ablesungen unterscheidbar.

[[File:LMDBVehicleManagement-2026-09-05-kilometrage-anonymise.png|thumb|center|1100px|Kilometerstände, Differenzen und Quellen. Verbrauchsbezogene Werte werden am Ursprung bearbeitet.]]

=== Tanken, Laden oder Zusätze erfassen ===

# '''Neuer Tank-/Ladevorgang''' wählen, Datum/Uhrzeit eingeben und Fahrzeug auswählen.
# Art und Betriebsmittel wählen; eine Ölreferenz ergänzen, wenn erforderlich.
# Fahrer prüfen, Menge in der angegebenen Einheit und Kilometerstand erfassen.
# Bruttogesamtbetrag eingeben. Einen unbekannten Preis für Zusätze leer lassen; null bedeutet einen bekannten Nullpreis.
# Bei Bedarf ein Projekt zuordnen. Bei aktivierten sonstigen Zahlungen Zahlungsdaten prüfen und PDF-/JPEG-/PNG-Beleg anhängen.
# Im Normalfall eine Standardablesung verwenden; Korrektur oder Zählerwechsel begründen. Speichern und Ergebnis prüfen.

Bei einer Kapazitätswarnung Menge, Einheit, Fahrzeug und hinterlegte Kapazität kontrollieren. Finanzdaten und Belege sind nach Bankabgleich oder Buchhaltungsübertragung gesperrt.

[[File:LMDBVehicleManagement-1.0.0-06-plein.jpg|thumb|center|1100px|Verbrauchsformular mit Beleg- und Zahlungsangaben bei aktivierter Option.]]

=== Verbrauchsstatistik ===

Die allgemeine '''Verbrauchsübersicht''' oder das Verbrauchsregister eines Fahrzeugs öffnen. Zeitraum und passende Fahrzeug-/Fahrer-/Betriebsmittel-/Artfilter setzen. Suchen, Mengen, Kosten, Mittelwerte und Spitzen prüfen und auffällige Werte über die Liste der Tank-/Ladevorgänge zurückverfolgen. Liter, kWh und Kilogramm bleiben getrennt und werden nicht addiert. Ausgeschlossene Intervalle kennzeichnen nicht berücksichtigte Kilometerstände. Spitzenwerte der Demonstration sind keine üblichen Verbrauchsrichtwerte.

[[File:LMDBVehicleManagement-2026-09-07-synthese-anonymise.png|thumb|center|1100px|Verbrauchsfilter, Kennzahlen und native Diagramme mit Demonstrationsdaten.]]

=== Wartung, Panne und Rechnungen ===

Auf der Fahrzeugkarte '''Neues Fahrzeugereignis''' wählen. Bezeichnung, Art, Datum, Fahrer und Dienstleister erfassen, danach Schweregrad, Kilometerstand und mögliche Ausfallzeiten. Arbeiten beschreiben, speichern und Nachweise am Ereignis anhängen. Die Ereignisliste umfasst den Fuhrpark; die Fahrzeughistorie bündelt zugehörige Vorgänge.

Am Ereignis oder an der Prüfung eine Lieferantenrechnung erstellen oder eine vorhandene Rechnung auswählen und verknüpfen. Verbindung unter Verknüpfte Objekte prüfen; die Referenz öffnet die Rechnung. Beim Lösen der Verbindung bleiben beide Datensätze erhalten.

[[File:LMDBVehicleManagement-2026-09-13-intervention-facture-anonymise.png|thumb|center|1100px|Wartungsereignis mit Lieferantenrechnungsaktionen und verknüpften Objekten.]]

== Versicherungen und Nachweise ==

=== Vertrag anlegen ===

Unter Versicherungsverträge '''Neuer Vertrag''' wählen. Versicherer und gegebenenfalls Kontakt/Vermittler auswählen. Versicherungsnummer, Bezeichnung, Deckung, Vertragszeitraum, Verlängerung und bekannte Kündigungsfrist sowie Assistance-Kontakte erfassen. Versicherte Fahrzeuge mit Deckungsart und Zeitraum auswählen. Speichern und Fahrzeugverknüpfungen prüfen. Haupt- und Zusatzdeckung sind möglich; ein Flottenvertrag fasst mehrere Fahrzeuge in einer Police zusammen.

[[File:LMDBVehicleManagement-1.0.0-18-creation-assurance.jpg|thumb|center|1100px|Vertragsanlage und Fahrzeugdeckung.]]
[[File:LMDBVehicleManagement-2026-09-11-assurance-anonymise.png|thumb|center|1100px|Gespeicherter Vertrag mit versichertem Fahrzeug.]]

=== Versicherungsnachweis einreichen und prüfen ===

# Vertrag und Register für Versicherungsnachweise öffnen.
# Geltungsbereich wählen: versicherte Flotte oder zulässiges Fahrzeug. Gültigkeitsdaten erfassen und Nachweis anhängen.
# Zum Weiterbearbeiten '''Entwurf speichern''' wählen, andernfalls '''Zur Prüfung einreichen'''.
# Ein berechtigter Prüfer kontrolliert Datei und Daten und gibt den Nachweis frei oder lehnt ihn mit Begründung ab.
# Bei Erneuerung einen neuen Nachweis anlegen und den alten über den vorgesehenen Ablauf archivieren.

Die Tabelle zeigt Geltungsbereich, Daten, herunterladbare Nachweise und Status. Ein Entwurf ersetzt keinen geprüften und freigegebenen Nachweis.

[[File:LMDBVehicleManagement-1.0.0-12-attestations.jpg|thumb|center|1100px|Freigegebener Nachweis und Einreichungsformular. Entwurf und Einreichung sind getrennte Schritte.]]

== Anleitung für vorgeschriebene Prüfungen ==

=== Fahrzeug oder Maschine qualifizieren ===

Das Prüfungsregister der Fahrzeugkarte öffnen. Den Fragebogen anhand tatsächlicher Merkmale und Nutzung beantworten, erforderliche Daten ergänzen und speichern. Berechnete Anforderungen, letzte Prüfung, berechnetes Datum, maßgebliches Datum und Status kontrollieren. Bei Hebezeugen ergibt sich das VGP-Intervall aus der technischen Qualifikation; keine beliebige Frist annehmen. Fehlende Angaben anhand der Fahrzeug-/Maschinenunterlagen ergänzen.

[[File:LMDBVehicleManagement-2026-09-09-qualification-anonymise.png|thumb|center|1100px|Fragebogen zur Ermittlung der anwendbaren Prüfanforderungen.]]

=== Fälligkeitsübersicht lesen ===

Die Prüfungsübersicht öffnen, nach Zeitraum, Fahrzeug, Maschinenart, Profil, Prüfung oder Status filtern und nach maßgeblichem Datum sortieren. Zur Detailprüfung das Fahrzeug öffnen. Statuskennzeichen unterscheiden aktuelle und überfällige Anforderungen. Das maßgebliche Datum zusammen mit Qualifikation und Nachweisen beurteilen.

[[File:LMDBVehicleManagement-2026-09-08-echeancier-anonymise.png|thumb|center|1100px|Prüfungsübersicht mit Daten und Anforderungsstatus.]]

=== Prüfung erfassen und freigeben ===

'''Prüfung erfassen''' an einer Anforderung oder '''Neue Prüfung''' wählen. Fahrzeug, Anforderung und Prüfart prüfen. Datum, Prüfstelle, Berichtsreferenz, Ergebnis und offizielle Gültigkeit erfassen. Ein abweichendes wirksames Datum begründen. Beobachtungen speichern, vorgeschriebenen Nachweis am Entwurf anhängen und vor Freigabe kontrollieren. Anschließend aktualisierte Anforderung und Fälligkeit prüfen.

[[File:LMDBVehicleManagement-2026-09-10-controle-anonymise.png|thumb|center|1100px|Prüfformular mit Prüfstelle, Ergebnis, Berichtsreferenz und Daten.]]

Eine freigegebene Prüfung ist unveränderlich. Fehler durch begründete Aufhebung und Ersatz korrigieren. Nachprüfungen behalten ihre Verbindung zur ursprünglichen Prüfung. Rechnungsverknüpfungen dürfen geändert werden, ohne freigegebene Prüfdaten umzuschreiben.

== Dokumente, Historie und Import/Export ==

'''Notizen''' für zulässige öffentliche/private Notizen verwenden. Dateien am richtigen Objekt ablegen: Wartungsberichte am Ereignis, Prüfnachweise an der Prüfung. Native Vorschau, Download, Upload und Löschung beachten die Objektberechtigungen. Leserechte allein erlauben keine Dateiänderung.

=== Fahrzeugakte erzeugen ===

# Fahrzeugkarte und Block '''Anhänge''' öffnen.
# Bei Dokumentmodell '''Fahrzeugakte''' auswählen und '''Erzeugen''' anklicken.
# PDF und ZIP prüfen. Die Lupe zeigt die PDF-Vorschau; Dateinamen laden die PDF bzw. das ZIP herunter.
# Für eine Aktualisierung erneut erzeugen; reservierte Fahrzeugaktendateien nicht manuell ersetzen.

[[File:LMDBVehicleManagement-1.0.0-14-dossier.jpg|thumb|center|754px|Native Modellauswahl, Erzeugung, Vorschau und Download.]]
[[File:LMDBVehicleManagement-2026-09-19-apercu-pdf-anonymise.png|thumb|center|793px|Erste Seite einer vorhandenen Fahrzeugakte.]]

Verbrauchs-/Zahlungsbelege gehören nicht zum ZIP. Zum Lesen der Akte bleiben Leserechte für Fahrzeug und Lieferantenrechnungen erforderlich.

=== Frühere Vorgänge finden ===

'''Historie''' öffnen, nach Datum, Quelle, Art, Bezeichnung oder Status filtern, nach Datum sortieren und einen Vorgang über seine Bezeichnung öffnen. Dokumentindikator prüfen. '''Ereignisse/Kalender''' zeigt verknüpfte Kalenderereignisse; die Historie bündelt die vorhandenen fachlichen Vorgänge.

[[File:LMDBVehicleManagement-2026-09-17-historique-anonymise.png|thumb|center|1100px|Gemeinsame Historie mit Ereignissen, Kilometerständen, Verbrauch, Versicherungen und Zuordnungen.]]

Native Import-/Exportfunktionen mit den Moduldaten und passenden Berechtigungen verwenden. CSV-Spalten entsprechend dem gewählten Import vorbereiten, Referenzen und Umgebung prüfen und Ergebnisse kontrollieren. Importierte Prüfungen bleiben Entwürfe. Bei aktivierten sonstigen Zahlungen wird der Verbrauchsimport abgewiesen. Unbekannte Zusatzpreise leer lassen, bekannte Nullpreise als null erfassen.

== Anbindung der QUARTIX-API ==

=== Zugang, Berechtigungen und Verbindung ===

QUARTIX QWS v2 wird ausschließlich lesend verwendet. Von QUARTIX QWS-Zugang, Kundencode, Benutzername, Passwort und '''APPLICATION NAME''' beziehen und die Berechtigung für Fahrtverläufe bestätigen lassen. Modulausgabe und Kompatibilitätsregister prüfen: je nach Funktion werden cURL, OpenSSL, native Verschlüsselung mit dem Dolibarr-Instanzschlüssel und natives Leaflet benötigt. Nach Bereitstellung das Modul deaktivieren/reaktivieren, um Tabellen, Rechte und Aufgaben unter Beibehaltung vorhandener Einstellungen zu registrieren.

Fahrzeuglesen, GPS-Anzeige und QUARTIX-Synchronisierung sind getrennte Rechte. Der interne Benutzer für geplante Aufgaben benötigt Fahrzeuglesen, QUARTIX-Synchronisierung und Kilometerstandsverwaltung. Synchronisierungsrechte gewähren keinen GPS-Zugriff. Externe Benutzer können QUARTIX-Funktionen nicht verwenden. Einstellungen und Zuordnungen gehören der besitzenden Umgebung; sie synchronisiert auch freigegebene Fahrzeuge.

# Moduleinstellungen und Register '''QUARTIX''' öffnen.
# Kundencode, Benutzername, Passwort und den exakten von QUARTIX gelieferten APPLICATION NAME erfassen. Ein leeres Passwortfeld behält das gespeicherte Passwort bei.
# Zeitstempelinterpretation bestätigen. Die '''QWS-Konvention''' berücksichtigt einen ausdrücklichen UTC-Versatz und verwendet sonst die lokale Fahrzeugzeitzone. Einen erzwungenen Modus nur nach Bestätigung der Kontokonvention wählen.
# Die Einheit für Zeitdauern mit QUARTIX klären. Solange sie nicht konfiguriert ist, bleiben Dauern unbekannt und werden nicht als null behandelt.
# '''Aufbewahrung der Fahrten in Tagen''' einstellen. Ohne vorhandene Einstellung beträgt der Anfangswert 30.
# Speichern, anschließend Verbindung testen und Fahrzeugkatalog laden.
# Nach Einrichtung Synchronisierung und die vier nativen Aufgaben aktivieren.

Jede Umgebung hat eigene Zugangsdaten, Token, Zuordnungen und Synchronisierungszustände. Gespeicherte Passwörter werden nicht angezeigt. Geänderte Zugangsdaten erneuern die Authentifizierung dieser Umgebung.

=== Fahrzeuge verbinden und Geräte neu zuordnen ===

Dolibarr-Fahrzeug und entsprechendes QUARTIX-Fahrzeug auswählen, IANA-Zeitzone sowie tatsächlichen Einbauzeitpunkt des Geräts bestätigen und speichern. Der Tagesbeginn stammt aus QUARTIX. Erste Werte im Fahrzeugregister '''QUARTIX-Nutzung''' prüfen. Neue Importe beginnen frühestens beim Einbau: ältere Positionen und Schätzungen werden abgewiesen; Übersichten beginnen mit dem ersten vollständigen QUARTIX-Tag danach. Bei migrierten Verbindungen ohne Einbaudatum wird kein Datum erfunden. Nach Änderungen von Zeitzone oder Tagesbeginn in QUARTIX die Verbindung prüfen.

Der native Schalter pausiert/reaktiviert die Verbindung. '''Verbindung lösen''' unterscheidet:

* '''Gerät neu zuordnen''': Importe beim alten Fahrzeug behalten. Bereits geladene Fahrtverläufe bleiben bis zum Ablauf lesbar; neue Anfragen für die alte Verbindung enden.
* '''Fehlerhafte Zuordnung''': QUARTIX-Fahrten, Übersichten und Schätzungen des Fahrzeugs entsprechend der Bestätigung dauerhaft löschen.

Beide Aktionen entfernen die letzte Position und geben das Gerät für eine neue Zuordnung frei. Manuelle und verbrauchsbezogene Kilometerstände bleiben erhalten. Eine neue Zuordnung darf auf demselben Fahrzeug keine Zeiträume mit aufbewahrter Historie überlappen.

=== Geplante Aufgaben ===

Die Aufgaben werden '''deaktiviert''' installiert und anfänglich alle fünfzehn Minuten aufgerufen. Ausführungsbenutzer prüfen, Aufgaben in der nativen Verwaltung aktivieren und letzte Ergebnisse kontrollieren.

{| class="wikitable"
! QUARTIX-Aufgabe !! Zweck
|-
| Letzte Positionen || Positionen fahrzeugweise in Gruppen aktualisieren
|-
| Täglicher Kilometerstand || Geschätzte Kilometerstände im täglichen Fahrzeugdurchlauf importieren
|-
| Nutzung und historische Nachladung || Abgeschlossene Tage importieren und Nutzungshistorie schrittweise ergänzen
|-
| Fahrtenprotokoll || Aktuelle/offene Tage aktualisieren, Historie nachladen, Kartenanfragen bearbeiten und abgelaufene Fahrten bereinigen
|}

Das Aufrufintervall garantiert keine vollständige Aktualisierung der Flotte innerhalb von fünfzehn Minuten. Fahrzeugzahl, Verarbeitungspakete, Antwortzeit und Kontingente beeinflussen die Fertigstellung. Kontingent- und Dienstfehler erzeugen eine gemeinsame Wartefrist der Umgebung; wiederholte Verbindungstests umgehen sie nicht.

=== Nutzung und Übersicht auswerten ===

Das Register QUARTIX-Nutzung zeigt die Verbindung und die freigegebenen importierten Angaben. Die Flottenübersicht verwendet native Filter, Kennzahlen und Diagramme.

* Geschätzte Kilometerstände sind gekennzeichnet und ersetzen keine tatsächlichen oder verbrauchsbezogenen Ablesungen. Widersprüche werden gemeldet, ohne tatsächliche Ablesungen zu blockieren.
* Die letzte Position benötigt GPS-Rechte. Datum prüfen: eine alte Position beweist weder Panne noch Stillstand.
* Nutzung umfasst Strecke, Fahrtenzahl, aktive Tage und Datenabdeckung. Tagesübersichten bleiben zwölf Monate erhalten; der laufende Tag gehört nicht zu abgeschlossenen Tagesübersichten.
* Ein unbekannter Tag unterscheidet sich von einem bekannten Tag ohne Aktivität. Summen berücksichtigen nur gemeldete Tage.
* Die Übersicht zeigt anfänglich die letzten dreißig abgeschlossenen Tage. Summen und Tagesverlauf umfassen die Auswahl; der Fahrzeugvergleich zeigt die zwanzig höchsten Strecken. Ohne GPS-Rechte entfallen Orte und GPS-Links.

Das Lesen importierter Daten löst keine QWS-Anfrage aus. Verbrauchsberechnungen verwenden weiterhin tatsächliche Ablesungen.

[[File:LMDBVehicleManagement-2026-09-quartix-utilisation.png|thumb|center|1000px|Tägliche QUARTIX-Nutzung: Tagesabdeckung, Entfernungen und Anzahl der Fahrten. Zeitangaben bleiben unverfügbar, bis ihre Einheit bestätigt ist.]]

=== Fahrtenprotokoll ===

Mit GPS-Rechten '''Fahrten''' öffnen, Zeitraum wählen (anfänglich die letzten sieben Tage), Filter anwenden und Abfahrt, Ankunft, Strecke und Status prüfen. Spaltenauswahl, Sortierung und Seitennavigation verwenden. Tagesabdeckung und Synchronisierungszeit prüfen, bevor aus einer leeren Liste auf fehlende Fahrten geschlossen wird.

Angezeigte Uhrzeiten verwenden die Dolibarr-Sitzungszeitzone; der Fahrttag folgt der QUARTIX-Tagesgrenze des Fahrzeugs. Vorläufige Ankünfte werden nicht als endgültig angezeigt. '''Private Fahrten speichern nur Tag und Strecke''': keine Adressen, Koordinaten, genauen Zeiten, Dauern oder Fahrtverläufe. Fehlende Datenschutzkennzeichen erhalten denselben Schutz.

[[File:LMDBVehicleManagement-2026-09-quartix-trajets-anonymise.png|thumb|center|1000px|QUARTIX-Fahrtenprotokoll mit Zeitraumfiltern und Fahrtstatus. Adressen sind unkenntlich gemacht.]]

=== Karte des Fahrtverlaufs ===

Nach Bestätigung des QWS-Zugriffs die Kartenanzeige in den QUARTIX-Einstellungen der besitzenden Umgebung aktivieren. Bei einer nicht privaten Fahrt '''Fahrtverlauf anzeigen''' wählen. Der native Dialog zeigt den zwischengespeicherten Verlauf oder fordert ihn bei Bedarf an. '''Verlauf laden/aktualisieren''' wird verfügbar, sobald ein neuer Versuch erlaubt ist. Bei freigegebenen Fahrzeugen wartet ein nicht vorhandener Verlauf auf die Fahrtenprotokoll-Aufgabe des Besitzers.

Die native Modale enthält weder eingebettete Navigationshistorie noch Debugleiste. Hinweise und Warnungen bleiben als dauerhafte Meldungsblöcke sichtbar. Die Karte verbindet QUARTIX-Positionen; '''sie berechnet keine Straßenroute'''. Abgeschlossene Fahrten zeigen Start- und Zielmarkierungen. Nur laufende Fahrten erhalten den Hinweis auf einen vorläufigen Verlauf ohne endgültige Ankunft. Weniger als zwei Punkte, fehlende oder unvereinbare Daten führen zu einer Nichtverfügbarkeitsmeldung.

Ein abgeschlossener, gespeicherter Verlauf ruft QUARTIX nicht erneut auf. Anfragen für denselben Tag liegen mindestens fünfzehn Minuten auseinander, abhängig von Kontingenten. Regelmäßige Prüfungen im Dialog lesen nur Cache und Rechte; sie sind keine GPS-Liveverfolgung.

Standardmäßig werden OpenStreetMap-Kacheln ohne API-Schlüssel und mit sichtbarer Quellenangabe verwendet. Eine alternative HTTPS-Kachel-URL und Quellenangabe sind konfigurierbar. Der Kartenanbieter erhält Anfragen für den betrachteten Bereich, keine QUARTIX-Zugangsdaten. Fehler beim Kartenhintergrund werden getrennt von fehlenden Fahrtverläufen gemeldet.

[[File:LMDBVehicleManagement-2026-09-quartix-route-anonymise.png|thumb|center|1000px|Abgeschlossene Fahrt im nativen Dialog mit dauerhaft sichtbaren Meldungen. Kennzeichen und Kartenhintergrund sind zum Schutz der Orte unkenntlich gemacht; der Kartennachweis bleibt sichtbar.]]

=== Aufbewahrung und Vertraulichkeit ===

Fahrten und Fahrtverläufe teilen sich eine Aufbewahrungsfrist. Eine Verkürzung blendet abgelaufene Tage sofort aus; die Fahrtenprotokoll-Aufgabe löscht sie anschließend gruppenweise. Eine Verlängerung ermöglicht das schrittweise Nachladen noch bei QUARTIX verfügbarer Tage. Die Bereinigung läuft bei bloß pausierter Synchronisierung weiter, solange Modul und Fahrtenprotokoll-Aufgabe aktiv bleiben; das Abschalten eines dieser beiden stoppt sie. Nutzungsübersichten behalten ihr separates Zwölfmonatsfenster.

Gespeicherte Fahrtverläufe sind verschlüsselt. Wird eine Fahrt privat oder mit dem Protokoll unvereinbar, entfällt der Zugriff auf ihren bisherigen Verlauf. GPS-Positionen und Verläufe sind aus Moduldokumenten, Exporten und APIs ausgeschlossen. Fahreridentitäten, Eco-Driving-Bewertungen und detaillierte Geschwindigkeiten werden nicht importiert.

=== QUARTIX-Fehlersuche ===

{| class="wikitable"
! Symptom !! Prüfung
|-
| Verbindungstest scheitert || Alle Zugangsdaten speichern, insbesondere APPLICATION NAME. Angezeigten Schritt und HTTP-Status festhalten, ohne Zugangsdaten oder rohe API-Antworten zu teilen.
|-
| Keine neuen Daten || Aktive Verbindung, Synchronisierung, Einbaudatum, Benutzerrechte und alle vier Aufgaben prüfen. Historische Nachladung benötigt mehrere Durchläufe.
|-
| Dauern fehlen || Einheit mit QUARTIX bestätigen und speichern.
|-
| Kartensymbol fehlt || GPS-Rechte, Kartenaktivierung, Privatstatus und Aufbewahrungsfrist prüfen.
|-
| Anfrage wartet || Fahrtenprotokoll-Aufgabe der besitzenden Umgebung, Synchronisierung und Wartefrist prüfen.
|-
| Karte bleibt leer || Dauerhafte Meldung lesen: fehlende Punkte, abgelaufene Sitzung, entzogener Zugriff und Kartenkachelfehler sind verschiedene Ursachen. Nach Modulaktualisierung die Seite neu laden.
|-
| Abweichung von QUARTIX || Dasselbe Fahrzeug, Datum, Zeitzone, Tagesgrenze, Datenabdeckung und Synchronisierungszeit vergleichen; Schätzungen und echte Ablesungen unterscheiden.
|}

== Häufige Fragen ==

{| class="wikitable"
! Situation !! Prüfung oder Maßnahme
|-
| Aktion fehlt || Rechte, Objektstatus und Abhängigkeiten unter Kompatibilität prüfen.
|-
| Fahrzeugakte wird nicht erzeugt || Modellaktivierung, Lieferantenrechnungen, PHP ZIP und Fahrzeug-/Rechnungsrechte prüfen.
|-
| Kilometerstand nicht bearbeitbar || Verbrauchsbezogenen Stand am ursprünglichen Verbrauchseintrag korrigieren.
|-
| Nachweis nicht freigegeben || Status, Geltungsbereich, Daten und Datei prüfen; ein Entwurf benötigt noch eine Prüfung.
|-
| Fälligkeit fehlt || Von der Regel benötigte Merkmale und Daten ergänzen.
|-
| Erinnerungen fehlen || Aktivierung, Empfänger, Vorlagen, Dolibarr-E-Mail-Versand und Aufgabenergebnisse prüfen.
|-
| Ausgabe nicht änderbar || Bankabgleich oder Buchhaltungsübertragung prüfen und das native finanzielle Korrekturverfahren verwenden.
|-
| Daten einer anderen Umgebung sichtbar || Umgebung und erlaubte Multicompany-Freigaben prüfen.
|}

== Aktualisierung und Grenzen ==

Vor Aktualisierungen Datenbank und Dokumente sichern. Moduldateien ersetzen und das Modul deaktivieren/reaktivieren, um Migrationen und native Deklarationen unter Erhaltung der Einstellungen anzuwenden. <code>ChangeLog.md</code> lesen, Modelle und Aufgaben prüfen, Fahrzeugakten nach Layoutänderungen neu erzeugen und Bankeinstellungen vor Aktivierung von Verbrauchszahlungen kontrollieren. Neue Kalenderereignisse verwenden aktualisierte Bezeichnungen; bestehende Historie und freigegebene Prüfungen werden nicht umgeschrieben. QUARTIX benötigt eigene Zugangsdaten, Verbindungen und vier Aufgaben; ältere 1.0.0-Pakete können die Anbindung noch nicht enthalten.

Detailprüfungen für Feuerlöscher, Druckgeräte, Lastaufnahmemittel und Kältemittel sind nicht vorkonfiguriert. Zulassungsdokumentverwaltung, Schadensfälle, Prämien, Selbstbeteiligungen und Bußgelder liegen außerhalb des Umfangs. Einkaufsrechnungen bleiben im nativen Lieferantenrechnungsmodul. Regelmäßige Erinnerungen benötigen funktionierende geplante Aufgaben und E-Mail-Zustellung. QUARTIX-Verlaufsexport, Eco-Driving und automatische Änderungen der Fahrerzuordnungen werden nicht angeboten.

== Quellen und Links ==

* [https://github.com/mapiolca/lmdbvehiclemanagement Modulquellcode]
* [https://github.com/mapiolca/lmdbvehiclemanagement/blob/094fc89/README.md Ursprüngliche Dokumentation der Version 1.0.0]
* [https://github.com/mapiolca/lmdbvehiclemanagement/blob/094fc89/ChangeLog.md Ursprüngliches Änderungsprotokoll der Version 1.0.0]
* [https://github.com/mapiolca Profil des Autors]

Modulo Gestione dei veicoli

2026-09-07T09:17:21Z

Mapiolca: Creare la guida utente completa in italiano con QUARTIX QWS v2, schermate anonimizzate e collegamenti alle altre lingue.

[[fr:Module Gestion des véhicules]]
[[en:Module Vehicle Management]]
[[de:Modul Fahrzeugverwaltung]]
[[es:Módulo Gestión de vehículos]]

'''Gestione dei veicoli e dei mezzi''' è un modulo esterno per Dolibarr che riunisce le caratteristiche del parco, le assegnazioni dei conducenti, i chilometraggi, i consumi, gli interventi, le assicurazioni e i controlli normativi. Collega le fatture dei fornitori agli interventi e ai controlli e genera un fascicolo del veicolo in PDF e ZIP.

L’integrazione '''QUARTIX QWS v2''' aggiunge stime chilometriche, ultima posizione, riepiloghi di utilizzo, registro dei viaggi e visualizzazione dei percorsi.

Questa guida illustrata è aggiornata al 7 settembre 2026. Le schermate provengono da un ambiente dimostrativo Dolibarr 24 in francese con Multicompany: indirizzi e targhe sono sfocati. I valori mostrati non sono impostazioni consigliate né riferimenti di consumo. Aspetto e diciture possono variare secondo versione e tema.

Il modulo fornisce traduzioni software in francese e inglese. Le versioni italiana, tedesca e spagnola della documentazione non aggiungono queste lingue al software. Il lavoro QUARTIX descritto estende la versione 1.0.0: un archivio precedente con lo stesso numero può non includerlo.

__TOC__

== Informazioni ==

{| class="wikitable"
! Voce !! Valore
|-
| Nome || Gestione dei veicoli e dei mezzi
|-
| Identificativo tecnico || <code>lmdbvehiclemanagement</code>
|-
| Autore / famiglia || Pierre Ardoin / Les Métiers du Bâtiment
|-
| Versione || 1.0.0, prima versione stabile del 4 settembre 2026; integrazione QUARTIX descritta separatamente
|-
| Requisiti || Dolibarr 20+, PHP 8.0+, MySQL o MariaDB
|-
| Lingue del modulo || Francese e inglese
|-
| Multicompany || Compatibile, facoltativo
|-
| Licenza || GNU GPL versione 3 o successiva
|}

== Funzionalità ==

=== Parco, conducenti e interventi ===

* Schede per veicoli stradali, furgoni e mezzi, anche senza targa.
* Caratteristiche tecniche, energia, capacità dei consumabili e autonomia WLTP.
* Ciclo di vita dalla bozza alla cessione.
* Assegnazioni simultanee dei conducenti, con una sola assegnazione principale nello stesso periodo.
* Letture del contachilometri, correzioni e sostituzioni del contatore.
* Manutenzioni, guasti e incidenti; cronologia che comprende controlli e consumi.
* Modelli di numerazione, compreso quello basato sulla targa.

Le liste offrono filtri, ordinamento, paginazione e colonne selezionabili. Le schede usano note, contatti, allegati e oggetti collegati nativi di Dolibarr secondo le funzioni disponibili.

=== Rifornimenti, ricariche e consumi ===

Sono gestiti carburanti, ricariche elettriche, idrogeno e additivi. I consumabili hanno unità proprie e compatibilità con le energie del veicolo. Le capacità configurate consentono di segnalare quantità eccessive.

* Sincronizzazione dei consumi con le relative letture chilometriche.
* Riepiloghi per veicolo, consumabile e unità.
* Statistiche di costi, distanze e consumi con grafici nativi.
* Importazione CSV ed esportazione nativa.
* Prezzo facoltativo per gli additivi: un importo vuoto è sconosciuto ed escluso dalle statistiche di prezzo; zero è un prezzo noto pari a zero.

Un’opzione per entità crea un '''pagamento diverso''' nativo per un rifornimento o una ricarica. Richiede conto bancario, dati di pagamento e ricevuta PDF, JPEG o PNG. I metadati delle immagini vengono eliminati. La contabilità è facoltativa; con la partita doppia occorre un conto generale del piano attivo. Dati finanziari e ricevuta sono bloccati dopo riconciliazione bancaria o trasferimento contabile.

'''Quando questa opzione è attiva, l’importazione CSV dei consumi non è disponibile.''' L’attivazione non crea pagamenti per i consumi storici.

=== Assicurazioni ===

* Contratti individuali o di flotta, con più veicoli e coperture principali o aggiuntive.
* Contatti dell’assicuratore e dell’intermediario.
* Attestazioni comuni alla flotta o specifiche per veicolo, con documenti, verifica, convalida, rifiuto e archiviazione.
* Referenti utenti/gruppi e personale assegnato avente diritto.
* Promemoria prima e dopo la scadenza tramite modelli email e lavori pianificati nativi, senza duplicazioni.

=== Controlli normativi ===

Un questionario guidato identifica i requisiti applicabili in base alle caratteristiche e all’uso registrati. La versione 1.0.0 contiene un catalogo '''francese''' versionato: controlli stradali, emissioni, categoria L, usi speciali, verifiche generali periodiche (VGP), messa/rimessa in servizio, tachigrafo, ADR e ATP. Sono possibili adattamenti per entità e regole personalizzate. La traduzione della guida non costituisce una localizzazione del catalogo alla normativa italiana.

* Controlli numerati con organismo, esito, date e documento obbligatorio.
* Convalida immutabile, annullamento motivato, sostituzione, controllo successivo e archiviazione regolata.
* Scadenzario, registro di sicurezza, esportazione e importazione in bozza.
* Blocco configurabile di nuove assegnazioni e messe in servizio.
* Ricalcolo quotidiano e promemoria pianificati, con un evento di agenda per requisito.

In assenza di dati indispensabili non viene inventata una scadenza. Il modulo supporta il monitoraggio documentale: non esegue verifiche e non emette rapporti ufficiali.

=== Fatture dei fornitori collegate ===

Da un intervento o controllo, '''Crea fattura fornitore''' apre il modulo nativo. Il fornitore dell’intervento è proposto se noto e accessibile, ma può essere cambiato. Il salvataggio crea una fattura in bozza collegata all’origine.

È possibile selezionare una fattura esistente o usare '''Collega a''' dalla fattura. La relazione appare negli '''Oggetti collegati''' delle due schede; uno stesso intervento può avere più fatture. Scollegare rimuove soltanto la relazione, senza cancellare la fattura o modificare i dati di un controllo convalidato. Entrambi gli oggetti devono appartenere all’entità corrente e restano necessari i rispettivi permessi.

=== Fascicolo del veicolo PDF e ZIP ===

Il modello '''Fascicolo del veicolo''' genera un PDF con caratteristiche, cronologia disponibile, interventi, controlli, fatture collegate, riepilogo dei consumi e inventario dei documenti. Lo ZIP contiene questo PDF e i file originali del veicolo, degli interventi, dei controlli e delle fatture collegate.

Sono inclusi bozze, annullamenti e archivi. Una fattura collegata più volte viene inserita una sola volta. I file indicizzati ma mancanti sono segnalati nel PDF. Ricevute dei consumi e dei relativi pagamenti, file temporanei, anteprime e fascicoli precedenti sono esclusi. Il riepilogo consumi mostra date, chilometraggi, riferimenti, consumabili, tipologie, unità e riferimenti dell’olio; non quantità né importi.

La generazione usa quanto già registrato: non produce nuovi documenti delle fatture e non ricostruisce una cronologia assente. Richiede lettura/scrittura del veicolo e lettura delle fatture fornitori. La consultazione richiede i relativi permessi di lettura cumulativi. Utenti esterni e collegamenti pubblici non possono accedervi.

=== Gestione multientità ===

Le condivisioni si configurano nelle impostazioni native Multicompany. Le liste interessate mostrano colonna e filtro '''Ambiente'''. I file restano nella directory documentale dell’entità proprietaria anche quando consultati da un’entità autorizzata alla condivisione. Impostazioni, modelli e scelte di condivisione vengono conservati alla disattivazione/riattivazione.

== Requisiti e installazione ==

Oltre a Dolibarr 20+, PHP 8.0+ e MySQL/MariaDB, verificare le dipendenze delle funzioni utilizzate.

{| class="wikitable"
! Dipendenza !! Utilizzo
|-
| Agenda e Lavori pianificati || Scadenze, eventi automatici, ricalcoli e promemoria
|-
| Banche e Casse || Pagamenti diversi dei consumi
|-
| Contabilità || Facoltativa; conti richiesti secondo il regime attivo
|-
| Fatture fornitori || Collegamenti di fatture e fascicolo veicolo
|-
| PHP ZIP (<code>ZipArchive</code>) || Generazione del fascicolo PDF/ZIP
|-
| Multicompany / Risorse || Condivisioni / collegamento a una risorsa, facoltativi
|-
| Accesso QWS, cURL, OpenSSL e cifratura nativa || Integrazione QUARTIX; Leaflet nativo per le mappe
|}

# Procurarsi la distribuzione del modulo richiesta, comprensiva di QUARTIX se necessario.
# Inserire <code>lmdbvehiclemanagement</code> nella directory dei moduli esterni Dolibarr, senza una seconda directory omonima annidata. Un archivio compatibile può essere caricato dallo strumento nativo di installazione moduli.
# Accedere come amministratore a '''Home → Configurazione → Moduli/Applicazioni'''.
# Attivare il modulo nella famiglia '''Les Métiers du Bâtiment'''.
# Aprire la rotella delle impostazioni, consultare '''Compatibilità''' e assegnare i permessi agli utenti/gruppi.

== Configurazione iniziale ==

# Verificare dizionari di energie, consumabili, mezzi, profili, tipi ed esiti dei controlli.
# Scegliere modelli di numerazione e documenti.
# Configurare referenti, modelli email e soglie assicurative.
# Verificare regole normative e opzioni di blocco.
# Attivare e controllare i lavori pianificati necessari.
# Impostare conti e pagamenti in ogni entità che usa le spese dei consumi.
# Configurare condivisioni Multicompany e accessi alle entità.
# Configurare QUARTIX secondo il capitolo dedicato.

'''Compatibilità''' e '''Informazioni''' sono schede interne delle impostazioni. La prima mostra le dipendenze mancanti nell’ambiente corrente.

=== Modelli di numerazione e fascicolo ===

Nelle impostazioni, attivare '''Fascicolo del veicolo''' nel blocco dei modelli documentali; la selezione come predefinito è separata. Scegliere il modello di numerazione di ogni oggetto. Per i veicoli, <code>standard</code> genera riferimenti sequenziali e <code>registration</code> usa la targa normalizzata; senza targa, quest’ultimo genera un riferimento di tipo MAT. Controllare gli esempi e usare la migrazione prevista se devono cambiare riferimenti esistenti.

[[File:LMDBVehicleManagement-2026-09-15-modeles-anonymise.png|thumb|center|1100px|Modelli documentali e numerazione: attivazione e scelta predefinita sono distinte.]]

=== Spese per rifornimenti e ricariche ===

Nel blocco ricevute/pagamenti diversi, scegliere conto bancario e metodo di pagamento dell’entità. Inserire i conti previsti dal regime contabile: generale obbligatorio in partita doppia, ausiliario facoltativo. Attivare e salvare, quindi verificare che un nuovo consumo richieda ricevuta e pagamento. I dati storici non vengono convertiti e l’importazione CSV dei consumi diventa indisponibile.

=== Promemoria assicurativi ===

Nella scheda Assicurazione scegliere referenti utenti/gruppi, eventuale personale assegnato e tipi di assegnazione ammessi. Configurare soglie prima della scadenza e ripetizioni dopo scadenza o mancanza di documenti, quindi modelli email di deposito/verifica. Attivare, salvare e controllare il lavoro pianificato. '''Invia email di prova''' effettua un invio reale: controllare i destinatari. Gli intervalli nella schermata sono dimostrativi.

[[File:LMDBVehicleManagement-1.0.0-16-relances-assurance.jpg|thumb|center|1100px|Referenti, soglie, modelli email e lavori pianificati assicurativi.]]

=== Promemoria dei controlli ===

Impostare gli orizzonti di avviso, il periodo di prossima scadenza, utenti/gruppi destinatari e l’eventuale conducente. Scegliere il modello email e gli avvisi quotidiani dopo scadenza se desiderati. Salvare e controllare ricalcolo e promemoria pianificati. Adattamenti e regole dell’entità devono corrispondere al mezzo e avere una giustificazione.

== Primi passi ==

=== Cercare o creare un veicolo ===

Il menu con l’icona dell’auto apre il modulo. Il menu laterale raggruppa parco, interventi, controlli, consumi e assicurazioni. Aprire la lista, filtrare riferimento/targa/descrizione/modello/stato, cercare con la lente e azzerare con la croce. Le intestazioni ordinano; il selettore gestisce le colonne e il limite regola la paginazione. Il riferimento apre la scheda. Il filtro Ambiente identifica l’entità proprietaria quando vi è condivisione.

[[File:LMDBVehicleManagement-2026-09-01-liste-anonymise.png|thumb|center|1100px|Navigazione e ricerca nel parco dimostrativo.]]

Per creare, scegliere '''Nuovo veicolo o mezzo'''. Inserire una denominazione chiara, eventuale targa e tipo principale. Completare i dati noti: categoria, masse, posti, territorio, seriale, marca e modello, energia e autonomia, date di costruzione, immatricolazione e servizio. Scegliere disponibilità e proprietario; la risorsa è facoltativa. Aggiungere descrizione e salvare. La scheda nasce in bozza e segue il modello di numerazione. Completare in modifica le capacità dei consumabili.

[[File:LMDBVehicleManagement-1.0.0-03-creation.jpg|thumb|center|1100px|Creazione: identificazione, caratteristiche tecniche e date.]]

=== Leggere scheda e stato ===

La scheda mostra identificazione, badge di stato, caratteristiche, capacità e assicurazione. Le schede secondarie espongono note, allegati, agenda, assegnazioni, chilometraggi, consumi, controlli, cronologia e QUARTIX secondo i permessi.

[[File:LMDBVehicleManagement-2026-09-02-fiche-anonymise.png|thumb|center|1100px|Veicolo in servizio con riepilogo tecnico e assicurativo.]]

{| class="wikitable"
! Stato !! Significato
|-
| Bozza || Preparazione e verifica
|-
| Convalidato || Identificato e approvato prima del servizio
|-
| In servizio || Utilizzato nel parco
|-
| Fuori servizio || Ritirato dall’utilizzo
|-
| Ceduto / venduto || Uscito dal parco a seguito di cessione
|}

Usare le azioni proposte per convalidare, mettere in servizio, ritirare o cedere secondo stato e permessi. Le regole normative possono impedire il servizio. Registrare una cessione con la transizione prevista mantiene la cronologia; la cancellazione ha uno scopo diverso.

== Uso quotidiano ==

=== Assegnare un conducente ===

Aprire Assegnazioni e aggiungere una riga. Selezionare conducente, inizio con ora, eventuale fine, tipo, carattere principale, stato e motivo; salvare. Più assegnazioni possono sovrapporsi, ma una sola è principale. Per terminarne una, modificarla con la matita e impostare fine e stato.

[[File:LMDBVehicleManagement-2026-09-04-affectations-anonymise.png|thumb|center|1100px|Assegnazioni: conducente, periodo, tipo e stato.]]

=== Letture chilometriche ===

Nella scheda Chilometraggio aggiungere una lettura con data, valore osservato e natura; motivare correzioni e sostituzioni. Salvare e controllare cronologia e differenze. '''Una lettura generata da un consumo si corregge dalla scheda del consumo d’origine''', senza aggiungere una lettura manuale duplicata. Le stime QUARTIX restano riconoscibili rispetto alle letture reali.

[[File:LMDBVehicleManagement-2026-09-05-kilometrage-anonymise.png|thumb|center|1100px|Letture chilometriche, differenze e fonti.]]

=== Registrare rifornimento, ricarica o additivo ===

# Aprire Nuovo rifornimento/ricarica, inserire data/ora e veicolo.
# Selezionare natura e consumabile, completando il riferimento dell’olio se richiesto.
# Verificare conducente, quantità nell’unità proposta e chilometraggio.
# Inserire il totale IVA inclusa; per additivi di prezzo ignoto lasciare vuoto, conservando zero soltanto per un prezzo noto nullo.
# Selezionare l’eventuale progetto; con i pagamenti diversi attivi verificare il regolamento e allegare la ricevuta PDF/JPEG/PNG.
# Conservare una lettura standard per un inserimento ordinario; motivare eventuali correzioni. Salvare e verificare.

Un avviso di capacità richiede di controllare quantità, unità, veicolo e capacità impostata. Dati finanziari e ricevute riconciliati o trasferiti in contabilità non sono liberamente modificabili.

[[File:LMDBVehicleManagement-1.0.0-06-plein.jpg|thumb|center|1100px|Modulo di consumo con ricevuta e pagamento quando abilitati.]]

=== Statistiche dei consumi ===

Aprire il riepilogo globale Consumi o la scheda del veicolo. Filtrare periodo, veicolo, conducente, consumabile e natura secondo necessità. Dopo la ricerca, leggere quantità, costi, medie e picchi e consultare i grafici. La lista dei rifornimenti permette di risalire ai dati. Litri, kWh e chilogrammi restano distinti; gli intervalli esclusi segnalano quelli non usati nel calcolo. I picchi dimostrativi non indicano un consumo normale.

[[File:LMDBVehicleManagement-2026-09-07-synthese-anonymise.png|thumb|center|1100px|Riepilogo filtrabile e grafici dei consumi dimostrativi.]]

=== Interventi, guasti e fatture ===

Dalla scheda veicolo creare un evento con denominazione, tipo, data, conducente e fornitore. Inserire gravità, chilometraggio e periodi di fermo se necessari. Descrivere, salvare e allegare i documenti all’evento. La lista degli eventi comprende l’intero parco e la cronologia del veicolo riunisce le sue operazioni.

Sull’evento o sul controllo creare una fattura fornitore oppure selezionarne una esistente e collegarla. Verificare la riga negli Oggetti collegati e aprirla dal riferimento. Scollegare non cancella i due oggetti.

[[File:LMDBVehicleManagement-2026-09-13-intervention-facture-anonymise.png|thumb|center|1100px|Intervento con creazione/collegamento di fatture fornitori.]]

== Assicurazioni e attestazioni ==

=== Creare un contratto ===

Aprire Nuovo contratto nella sezione assicurazioni. Selezionare assicuratore ed eventuale contatto/intermediario, inserire polizza, denominazione, garanzie, periodo, rinnovo e preavviso noto. Aggiungere recapiti di assistenza e selezionare veicoli, tipo e periodo di copertura. Salvare e verificare i veicoli collegati. La copertura può essere principale o aggiuntiva; una polizza di flotta comprende più veicoli.

[[File:LMDBVehicleManagement-1.0.0-18-creation-assurance.jpg|thumb|center|1100px|Creazione del contratto e scelta dei veicoli.]]
[[File:LMDBVehicleManagement-2026-09-11-assurance-anonymise.png|thumb|center|1100px|Contratto registrato e copertura del veicolo.]]

=== Depositare e verificare un’attestazione ===

# Aprire contratto e scheda delle attestazioni.
# Scegliere flotta o veicolo tra le opzioni ammesse, periodo e documento.
# Salvare in bozza per proseguire la preparazione oppure inviare alla verifica quando completo.
# Il revisore autorizzato controlla documento e date, poi convalida o rifiuta con motivazione.
# Al rinnovo depositare la nuova attestazione e archiviare quella precedente tramite il flusso previsto.

La tabella mostra ambito, date, documento scaricabile e stato. La bozza non sostituisce un’attestazione verificata e convalidata.

[[File:LMDBVehicleManagement-1.0.0-12-attestations.jpg|thumb|center|1100px|Attestazione convalidata e modulo: bozza e invio alla verifica sono azioni distinte.]]

== Guida ai controlli normativi ==

=== Qualificare il mezzo ===

Nella scheda dei controlli del veicolo rispondere al questionario secondo caratteristiche e uso reali, inserire le date necessarie e salvare. Esaminare requisiti, ultimo controllo, date calcolata e adottata, e stato. Per il sollevamento, l’intervallo VGP deriva dalla qualificazione tecnica: non va indovinato. Completare i dati mancanti con la documentazione del mezzo.

[[File:LMDBVehicleManagement-2026-09-09-qualification-anonymise.png|thumb|center|1100px|Questionario di qualificazione normativa.]]

=== Leggere lo scadenzario ===

Aprire lo scadenzario, filtrare periodo, veicolo, mezzo, profilo, controllo e stato, quindi ordinare per data adottata. Aprire il veicolo per i dettagli. I badge distinguono requisiti aggiornati e scaduti. La data deve essere interpretata insieme alla qualificazione e ai documenti.

[[File:LMDBVehicleManagement-2026-09-08-echeancier-anonymise.png|thumb|center|1100px|Scadenzario con date e stati dei requisiti.]]

=== Registrare e convalidare un controllo ===

Avviare la registrazione dal requisito o da Nuovo controllo. Verificare veicolo, requisito e natura, poi inserire data, organismo, riferimento del verbale, esito e validità ufficiale. Motivare un’eventuale diversa data effettiva. Salvare le osservazioni, allegare il documento obbligatorio alla bozza e verificare prima di convalidare. Controllare infine requisito e scadenza aggiornati.

[[File:LMDBVehicleManagement-2026-09-10-controle-anonymise.png|thumb|center|1100px|Controllo: organismo, esito, verbale e date.]]

Il controllo convalidato è immutabile. Correggere con annullamento motivato e sostituzione; mantenere il legame con l’originale per una verifica successiva. Le relazioni con fatture possono cambiare senza riscrivere i dati normativi.

== Documenti, cronologia e importazione/esportazione ==

Usare Note per i testi pubblici/privati autorizzati. Allegare ogni documento all’oggetto corretto: rapporto d’intervento all’evento, prova del controllo al controllo. Anteprima, scaricamento, caricamento e cancellazione seguono i permessi; la lettura non autorizza modifiche ai file.

=== Generare il fascicolo ===

# Dalla scheda principale raggiungere Allegati, selezionare Fascicolo del veicolo come modello e generare.
# Verificare PDF e ZIP; la lente apre l’anteprima, il nome permette lo scaricamento.
# Per aggiornare, generare nuovamente senza sostituire manualmente i file riservati.

[[File:LMDBVehicleManagement-1.0.0-14-dossier.jpg|thumb|center|754px|Blocco documentale nativo: modello, generazione, anteprima e download.]]
[[File:LMDBVehicleManagement-2026-09-19-apercu-pdf-anonymise.png|thumb|center|793px|Prima pagina di un fascicolo esistente.]]

Lo ZIP esclude ricevute dei consumi e pagamenti. Per consultarlo restano necessari i diritti di lettura su veicolo e fatture fornitori.

=== Ritrovare un’operazione ===

Aprire Cronologia, filtrare date, fonte, tipo, descrizione o stato, ordinare per data e aprire l’origine dal titolo. Verificare l’indicazione dei documenti. Eventi/Agenda mostra gli eventi collegati; Cronologia riunisce le operazioni aziendali disponibili.

[[File:LMDBVehicleManagement-2026-09-17-historique-anonymise.png|thumb|center|1100px|Cronologia consolidata di interventi, letture, consumi, assicurazioni e assegnazioni.]]

Usare import/export nativi con dataset e diritti del modulo. Preparare il CSV nei campi previsti, verificare riferimenti ed entità e controllare il risultato. I controlli importati rimangono bozze. L’importazione consumi è rifiutata con i pagamenti diversi attivi. Prezzi ignoti degli additivi restano vuoti; uno zero noto resta zero.

== Integrazione API QUARTIX ==

=== Accesso, permessi e connessione ===

QWS v2 è usato in sola lettura. Richiedere a QUARTIX accesso, codice cliente, login, password e '''APPLICATION NAME''', verificando anche l’accesso ai percorsi. Verificare distribuzione e Compatibilità: cURL, OpenSSL, cifratura nativa con chiave dell’istanza e Leaflet per le mappe. Dopo il caricamento dei file riattivare il modulo per registrare tabelle, diritti e lavori conservando le impostazioni.

Lettura veicoli, consultazione GPS e sincronizzazione sono diritti distinti. L’utente interno dei lavori richiede lettura parco, sincronizzazione QUARTIX e gestione delle letture chilometriche. Sincronizzare non autorizza a vedere il GPS. Gli utenti esterni sono esclusi. Impostazioni, associazioni e importazioni appartengono all’entità proprietaria, anche per veicoli condivisi.

# Aprire impostazioni del modulo → QUARTIX.
# Inserire codice cliente, login, password ed esatto APPLICATION NAME. Lasciare la password vuota conserva quella memorizzata.
# Confermare gli orari: Convenzione QWS rispetta lo scostamento esplicito e altrimenti usa l’ora locale del veicolo. Usare modalità forzate solo dopo verifica della convenzione del conto.
# Confermare con QUARTIX l’unità delle durate. Senza conferma esse restano indisponibili, non nulle.
# Impostare la conservazione dei viaggi in giorni, inizialmente 30 se non esiste un valore.
# Salvare, verificare la connessione e caricare il catalogo dei veicoli.
# Attivare la sincronizzazione e i quattro lavori pianificati.

Ogni entità ha credenziali, token, associazioni e stato propri. Le password salvate non vengono mostrate. Cambiare credenziali rinnova l’autenticazione della sola entità.

=== Associazioni e riassegnazione del dispositivo ===

Selezionare veicolo Dolibarr e corrispondente QUARTIX, confermare fuso IANA e data/ora reali d’installazione, quindi salvare. L’inizio giornata deriva da QUARTIX. Verificare i primi valori nella scheda Utilizzo QUARTIX. Non vengono importate posizioni o stime anteriori all’installazione; i riepiloghi partono dalla prima giornata QUARTIX completa successiva. Le associazioni migrate senza data rimangono senza data inventata. Rivedere l’associazione se cambiano fuso o inizio giornata.

L’interruttore sospende o riattiva l’associazione. '''Scollega''' distingue:

* '''Riassegnazione del dispositivo''': conserva gli import del vecchio veicolo; i percorsi già caricati restano disponibili fino alla scadenza, ma cessano le nuove richieste della vecchia associazione.
* '''Associazione errata''': elimina definitivamente viaggi, riepiloghi e stime QUARTIX del veicolo secondo la conferma mostrata.

Entrambe cancellano l’ultima posizione e liberano il dispositivo. Letture manuali e da consumi sono conservate. Una nuova associazione non deve sovrapporsi alla cronologia mantenuta sullo stesso veicolo.

=== Lavori pianificati ===

I lavori nascono '''disattivati''', con frequenza iniziale di quindici minuti. Verificare utente, attivazione e ultimo risultato nell’interfaccia nativa.

{| class="wikitable"
! Lavoro QUARTIX !! Funzione
|-
| Ultime posizioni || Aggiornamento per gruppi di veicoli
|-
| Chilometraggio quotidiano || Import delle stime con trattamento giornaliero
|-
| Utilizzo e recupero storico || Giornate concluse e recupero progressivo dei riepiloghi
|-
| Registro dei viaggi || Giornate correnti/aperte, storico, richieste dei percorsi ed eliminazione dei viaggi scaduti
|}

La frequenza non garantisce l’aggiornamento dell’intero parco ogni quindici minuti: dimensioni, gruppi, risposte e quote incidono. Errori o quote applicano un intervallo comune di ripresa nell’entità; ripetere il test di connessione non lo evita.

=== Utilizzo e cruscotto ===

La scheda Utilizzo QUARTIX mostra associazione e dati autorizzati. Il cruscotto del parco usa filtri, indicatori e grafici nativi.

* Le stime chilometriche sono identificate e non sostituiscono le letture reali o dei consumi. Le contraddizioni sono segnalate senza impedirne la correzione.
* L’ultima posizione richiede il diritto GPS. La sua anzianità non prova un guasto o un fermo.
* I riepiloghi comprendono distanze, numero di viaggi, giorni attivi e copertura; vengono conservati dodici mesi e non includono la giornata in corso fra quelle concluse.
* Un giorno sconosciuto è diverso da un giorno noto senza attività. I totali considerano soltanto i giorni conosciuti.
* Il cruscotto parte dalle trenta giornate concluse precedenti. Totali ed evoluzione coprono la selezione; il confronto mostra le venti distanze maggiori. Luoghi e link GPS sono assenti senza il relativo diritto.

La lettura della cache non chiama QWS. I consumi continuano a basarsi sulle letture reali.

[[File:LMDBVehicleManagement-2026-09-quartix-utilisation.png|thumb|center|1000px|Utilizzo quotidiano QUARTIX: copertura delle giornate, distanze e numero di viaggi. Le durate restano indisponibili finché non ne viene confermata l’unità.]]

=== Registro dei viaggi ===

Aprire Viaggi con il diritto GPS, scegliere periodo (inizialmente gli ultimi sette giorni) e filtri, quindi leggere partenze, arrivi, distanze e stati. Adattare colonne, ordinamento e paginazione. Verificare copertura e ultima sincronizzazione prima di concludere che non vi siano viaggi.

Gli orari usano il fuso della sessione Dolibarr, mentre la giornata mantiene il confine QUARTIX del veicolo. Un arrivo provvisorio non diventa definitivo. '''Per i viaggi privati sono conservati solo giorno e distanze''': niente indirizzi, coordinate, orari precisi, durate o percorso. La stessa protezione vale quando mancano le indicazioni di riservatezza necessarie.

[[File:LMDBVehicleManagement-2026-09-quartix-trajets-anonymise.png|thumb|center|1000px|Registro QUARTIX con filtri per periodo e stato dei viaggi. Gli indirizzi sono sfocati.]]

=== Percorso sulla mappa ===

Attivare la consultazione dei percorsi nelle impostazioni dell’entità proprietaria dopo verifica dell’accesso QWS. Cliccare Visualizza percorso su un viaggio non privato. La finestra nativa mostra la cache o richiede il caricamento. Carica/aggiorna percorso consente un nuovo tentativo quando ammesso. Per un veicolo condiviso senza cache si attende il lavoro Registro dei viaggi del proprietario.

La modale non incorpora cronologia di navigazione o barra di debug. Informazioni e avvisi rimangono visibili. La mappa unisce i punti QUARTIX: '''non calcola un itinerario stradale'''. I viaggi conclusi mostrano partenza e arrivo; soltanto quelli aperti mostrano la nota In corso e non hanno arrivo definitivo. Meno di due punti o dati assenti/incompatibili rendono il percorso indisponibile.

Un percorso concluso in cache non richiama QUARTIX. Tentativi sulla stessa giornata sono distanziati di almeno quindici minuti, rispettando le quote. I controlli periodici della finestra rileggono cache e permessi; non sono un inseguimento GPS in tempo reale.

Il fondo predefinito usa OpenStreetMap senza chiave API e con attribuzione visibile. È configurabile un altro URL HTTPS con attribuzione. Il fornitore delle mappe riceve richieste per l’area visualizzata, non segreti QUARTIX. Un errore delle tessere cartografiche è distinto da un percorso indisponibile.

[[File:LMDBVehicleManagement-2026-09-quartix-route-anonymise.png|thumb|center|1000px|Viaggio completato nella finestra di dialogo nativa, con messaggi persistenti. La targa e lo sfondo della mappa sono sfocati per proteggere i luoghi; l’attribuzione cartografica è conservata.]]

=== Conservazione e riservatezza ===

Viaggi e percorsi condividono la durata di conservazione. Ridurla nasconde subito le giornate scadute; il lavoro del registro le elimina poi a gruppi. Aumentarla consente di recuperare progressivamente i giorni ancora disponibili in QUARTIX. La pulizia continua con la sola sincronizzazione sospesa se modulo e lavoro del registro rimangono attivi; disattivare uno dei due la arresta. I riepiloghi di utilizzo conservano il periodo separato di dodici mesi.

I percorsi in cache sono cifrati. Un viaggio divenuto privato o incompatibile perde l’accesso al vecchio percorso. Posizioni e tracciati GPS sono esclusi da documenti, export e API del modulo. Non vengono importati conducenti, punteggi di guida ecologica o dettagli di velocità.

=== Diagnosi QUARTIX ===

{| class="wikitable"
! Problema !! Verifica
|-
| Connessione fallita || Salvare credenziali e APPLICATION NAME. Rilevare fase e stato HTTP senza diffondere credenziali o risposte API complete.
|-
| Dati assenti || Controllare associazione, sincronizzazione, data d’installazione, diritti e quattro lavori. Il recupero richiede più passaggi.
|-
| Durate indisponibili || Confermare l’unità con QUARTIX e salvarla.
|-
| Icona percorso assente || Controllare diritto GPS, attivazione, riservatezza e conservazione.
|-
| Richiesta in attesa || Verificare lavoro del proprietario, sincronizzazione e intervallo di ripresa.
|-
| Mappa vuota || Leggere l’avviso: dati incompleti, sessione scaduta, accesso revocato e fondo cartografico non disponibile sono casi distinti. Ricaricare dopo un aggiornamento.
|-
| Valori diversi da QUARTIX || Confrontare stesso veicolo, giorno, fuso, inizio giornata, copertura e sincronizzazione; distinguere stime e letture reali.
|}

== Domande frequenti ==

{| class="wikitable"
! Situazione !! Azione
|-
| Pulsante assente || Verificare permessi, stato e dipendenze in Compatibilità.
|-
| Fascicolo non generabile || Controllare modello, Fatture fornitori, PHP ZIP e diritti su veicolo/fatture.
|-
| Lettura non modificabile || Correggere la lettura dal consumo che l’ha generata.
|-
| Attestazione non valida || Verificare stato, ambito, periodo e documento; la bozza va sottoposta a verifica.
|-
| Scadenza assente || Completare caratteristiche, qualificazione e date richieste.
|-
| Promemoria non inviati || Controllare attivazione, destinatari, modelli email, invio Dolibarr e risultati dei lavori.
|-
| Spesa bloccata || Verificare riconciliazione/trasferimento e usare la correzione finanziaria nativa.
|-
| Dati di un’altra entità || Verificare Ambiente e condivisioni autorizzate.
|}

== Aggiornamenti e limiti ==

Prima di aggiornare salvare database e documenti. Sostituire i file, disattivare/riattivare il modulo per migrazioni e dichiarazioni native preservando le impostazioni. Consultare <code>ChangeLog.md</code>, verificare modelli e lavori, rigenerare i fascicoli per applicare modifiche grafiche e controllare i conti prima di attivare le spese. Le nuove diciture Agenda valgono per eventi futuri: cronologia e controlli convalidati non vengono riscritti. QUARTIX richiede credenziali, associazioni e quattro lavori; vecchi pacchetti 1.0.0 possono esserne privi.

Non sono preconfigurati i controlli dettagliati di estintori, apparecchi in pressione, accessori di sollevamento e refrigeranti. Gestione dedicata dei documenti di immatricolazione, sinistri, premi, franchigie e multe non è inclusa. Le fatture d’acquisto restano nel modulo nativo Fatture fornitori. I promemoria richiedono pianificazione e invio email funzionanti. Non sono inclusi esportazione dei percorsi QUARTIX, guida ecologica e modifiche automatiche delle assegnazioni.

== Fonti e collegamenti ==

* [https://github.com/mapiolca/lmdbvehiclemanagement Codice sorgente]
* [https://github.com/mapiolca/lmdbvehiclemanagement/blob/094fc89/README.md Documentazione originale 1.0.0]
* [https://github.com/mapiolca/lmdbvehiclemanagement/blob/094fc89/ChangeLog.md Cronologia originale 1.0.0]
* [https://github.com/mapiolca Profilo dell’autore]

Module Vehicle Management

2026-09-07T09:16:15Z

Mapiolca: Create the complete English user guide, including QUARTIX QWS v2, anonymised screenshots and language links.

[[fr:Module Gestion des véhicules]]
[[it:Modulo Gestione dei veicoli]]
[[de:Modul Fahrzeugverwaltung]]
[[es:Módulo Gestión de vehículos]]

'''Vehicle and Equipment Management''' is an external Dolibarr module for managing road vehicles, vans and machinery. It brings together vehicle specifications, driver assignments, odometer readings, consumption, maintenance events, insurance and regulatory inspections.

It also links supplier invoices to maintenance events and inspections, generates a vehicle dossier as PDF and ZIP files, and integrates '''QUARTIX QWS v2''' for mileage estimates, usage summaries, positions, journeys and route maps.

This article provides an illustrated installation and user guide. Screenshots show a French Dolibarr 24 demonstration environment with Multicompany. Addresses and registration numbers are blurred. Example values are not recommended settings or consumption benchmarks. Layout and translated interface labels may vary with the Dolibarr version and theme.

The documentation was updated on 7 September 2026. The QUARTIX development extends version 1.0.0; an older archive bearing that version number may not contain it. The module itself provides French and English translations; Italian, German and Spanish versions of this article do not add those languages to the software.

__TOC__

== Information ==

{| class="wikitable"
! Item !! Value
|-
| Module || Vehicle and Equipment Management
|-
| Technical identifier || <code>lmdbvehiclemanagement</code>
|-
| Author / family || Pierre Ardoin / Les Métiers du Bâtiment
|-
| Version || 1.0.0, first stable release on 4 September 2026; QUARTIX development documented separately below
|-
| Requirements || Dolibarr 20+, PHP 8.0+, MySQL or MariaDB
|-
| Software languages || French and English
|-
| Multicompany || Supported; optional
|-
| Licence || GNU GPL version 3 or later
|}

== Features ==

=== Fleet management ===

* Vehicle, van and machinery records, with optional registration numbers.
* Technical specifications, energy, consumable capacities and WLTP range.
* Lifecycle management from draft to disposal.
* Concurrent driver assignments, with only one primary assignment for a given period.
* Odometer readings, corrections and meter replacements.
* Maintenance, breakdown and incident events; a consolidated timeline including inspections and consumption.
* Numbering models, including a model based on the registration number.

Lists support filters, sorting, pagination and configurable columns. Records use native Dolibarr notes, contacts, attachments and linked objects where applicable.

=== Refuelling, charging and consumption ===

The module manages fuels, electric charging, hydrogen and additives. Consumables have their own units and compatible energy types. Vehicle capacities allow warnings when an entered quantity exceeds the configured capacity.

* Consumption records are synchronised with their odometer readings.
* Summaries distinguish vehicles, consumables and units.
* Native charts display costs, distances and consumption statistics.
* CSV import and native export are available.
* An additive may have an unknown price: an empty amount is excluded from price statistics, while zero remains a known price of zero.

An optional setting per entity creates a native '''miscellaneous payment''' for a refuelling or charging record. It requires a bank account, payment details and a PDF, JPEG or PNG receipt. Image metadata is removed. Accounting is optional; double-entry accounting requires a general ledger account from the active chart. Financial data and the receipt become locked after bank reconciliation or accounting transfer.

'''Consumption CSV import is unavailable while miscellaneous payment creation is enabled.''' Enabling the option does not create payments for historical consumption records.

=== Insurance ===

* Individual or fleet contracts covering several vehicles, with primary and additional coverage.
* Insurer and broker contacts.
* Fleet-wide or vehicle-specific certificates, with supporting files, review, validation, rejection and archiving.
* Responsible users or groups and eligible assigned personnel.
* Reminders before and after expiry, using native email templates and scheduled jobs, with duplicate prevention.

=== Regulatory inspections ===

A guided qualification questionnaire determines applicable requirements from the recorded characteristics and use. Version 1.0.0 includes a versioned '''French''' catalogue covering roadworthiness, emissions, category L, specialised uses, periodic general inspections (VGP), commissioning/recommissioning, tachographs, ADR and ATP. Entity-specific overrides and custom rules extend it. Translating this article does not turn this catalogue into another country's regulatory rules.

* Numbered inspection records with inspection body, result, dates and mandatory supporting document.
* Immutable validation, cancellation with reasons, replacement, follow-up inspection and controlled archiving.
* Due-date schedule, safety register, export and import as drafts.
* Configurable blocking of new assignments and commissioning.
* Daily recalculation and reminders through scheduled jobs, with one calendar event per requirement.

When essential information is missing, no arbitrary due date is calculated. The module helps with documentary tracking: it neither performs inspections nor issues official inspection reports.

=== Linked supplier invoices ===

On a maintenance event or inspection, '''Create supplier invoice''' opens the native form. The intervention supplier is proposed if known and accessible, but remains editable. Saving creates a draft invoice linked to the source record.

You can also select an existing invoice, or use '''Link to''' from a supplier invoice. Both records display the relationship in '''Linked objects'''. Several invoices may be linked to one intervention. Unlinking removes only the relationship, not the invoice or validated regulatory data. Both objects must belong to the current entity, and permissions on each object remain required.

=== Vehicle dossier: PDF and ZIP ===

The '''Vehicle dossier''' document model generates:

* a PDF with vehicle specifications, available timeline, events, inspections, linked invoices, a refuelling/charging summary and document inventory;
* a ZIP with that PDF and the original files attached to the vehicle, events, inspections and linked invoices.

Drafts, cancellations and archived records are included. An invoice linked several times is packaged once. Indexed files that are missing are reported in the PDF. Consumption and miscellaneous payment receipts, temporary files, previews and previous dossiers are excluded. The consumption summary contains dates, readings, references, consumables, types, units and oil references; it excludes quantities and amounts.

Generation uses existing data and files. It does not generate supplier invoice documents or reconstruct an unrecorded history. Generating requires vehicle read/write and supplier invoice read permissions. Viewing requires the corresponding combined read permissions. External users and public links cannot access the dossier.

=== Multiple entities ===

Multicompany sharing is configured in its native settings. Relevant lists display an '''Environment''' column and filter. Files remain in the owning entity's document directory, including when viewed through sharing. Entity settings, models and sharing choices survive module deactivation and reactivation.

== Requirements and installation ==

In addition to Dolibarr 20+, PHP 8.0+ and MySQL/MariaDB, check the dependencies of the features you use:

{| class="wikitable"
! Dependency !! Purpose
|-
| Calendar and Scheduled jobs || Automatic due dates, events, recalculation and reminders
|-
| Banks and Cash || Miscellaneous payments for consumption records
|-
| Accounting || Optional; account requirements depend on the accounting mode
|-
| Supplier invoices || Invoice links and vehicle dossiers
|-
| PHP ZIP extension (<code>ZipArchive</code>) || PDF/ZIP dossier generation
|-
| Multicompany / Resources || Optional sharing / link to a Dolibarr resource
|-
| QUARTIX QWS access, cURL, OpenSSL, native encryption || Optional QUARTIX integration; native Leaflet for route maps
|}

# Obtain the required module distribution, including QUARTIX if needed.
# Place <code>lmdbvehiclemanagement</code> in Dolibarr's external modules directory, without a second nested directory of the same name. A compatible deployment archive may also be installed through the native module deployment screen.
# Sign in as an administrator and open '''Home → Setup → Modules/Applications'''.
# Enable the module in the '''Les Métiers du Bâtiment''' family.
# Open its cogwheel settings, check '''Compatibility''' and grant users/groups their required permissions.

== Initial configuration ==

# Review energy, consumable, equipment type, regulatory profile, inspection type and result dictionaries.
# Choose numbering models and document models.
# Configure insurance contacts, reminder templates and thresholds.
# Review regulatory rules and any blocking options.
# Enable and check the required native scheduled jobs.
# Configure bank/payment options separately in each entity if miscellaneous payments are used.
# Configure Multicompany sharing and entity access where applicable.
# Configure QUARTIX as described below if it is used.

'''Compatibility''' and '''About''' are internal settings tabs. Compatibility identifies missing dependencies in the current environment.

=== Numbering and dossier model ===

In '''Settings''', enable '''Vehicle dossier''' in '''Document models'''; selecting it as the default is a separate choice. In '''Numbering models''', choose a model for each object. Vehicles can use <code>standard</code> for sequential references or <code>registration</code> for normalised registration numbers. With the latter, unregistered equipment receives a MAT-style reference. Check the examples; use the module's migration procedure if existing references must be changed.

[[File:LMDBVehicleManagement-2026-09-15-modeles-anonymise.png|thumb|center|1100px|Document models and numbering settings. Activation and default selection are separate.]]

=== Consumption expenses ===

In the receipt/miscellaneous payment settings, choose the entity's bank account and usual payment method, then the accounting accounts appropriate to the active accounting mode. A general ledger account is required for double-entry accounting; the auxiliary account is optional. Enable the option and save. Check that a new consumption form requests payment details and a receipt. Historical records are not converted and consumption CSV import becomes unavailable.

=== Insurance reminders ===

In '''Insurance''' settings, choose responsible users/groups, whether assigned personnel are included, and the eligible assignment types. Set pre-expiry thresholds and repetition intervals after expiry or missing evidence; select the deposit/review email templates. Enable reminders, save, then open Scheduled jobs to inspect activation and the latest result. '''Send test email''' sends a real email: check recipients first. Screenshot intervals are demonstration settings.

[[File:LMDBVehicleManagement-1.0.0-16-relances-assurance.jpg|thumb|center|1100px|Insurance reminder recipients, thresholds, templates and scheduled job access.]]

=== Inspection reminders ===

In '''Regulatory inspections''', choose reminder horizons and the upcoming-due period. Select users/groups and whether the assigned driver is included, choose the reminder template and optionally daily overdue reminders. Save and check the recalculation/reminder job. Entity overrides and custom rules must reflect the equipment and retain their justification.

== Getting started ==

=== Find or create a vehicle ===

Open the vehicle menu, identified by a car icon. Its side menu provides access to the fleet, events, inspections, consumption and insurance.

# Open the vehicle/equipment list and filter by reference, registration, label, model or status.
# Search with the magnifying glass; the cross resets filters. Column headings sort the list and the column selector changes visible columns.
# Set the page size and open a record through its reference. With sharing enabled, use the Environment filter to identify ownership.

[[File:LMDBVehicleManagement-2026-09-01-liste-anonymise.png|thumb|center|1100px|Fleet navigation and filters.]]

To create a record, choose '''New vehicle or equipment''', enter a clear label and a registration number if applicable. Select the main equipment type and complete known category, weights, seats, territory, serial number, make and model. Set energy and known range, construction/registration/commissioning dates, ownership mode and owner. The resource link is optional. Add a description and save, then edit consumable capacities if needed. The record starts as a draft and receives its reference from the configured model.

[[File:LMDBVehicleManagement-1.0.0-03-creation.jpg|thumb|center|1100px|Vehicle creation: identification, technical information and dates.]]

=== Read the record and status ===

The card shows identification, status, specifications, capacities and insurance coverage. Tabs expose notes, files, calendar, assignments, mileage, consumption, inspections, history and QUARTIX according to permissions.

[[File:LMDBVehicleManagement-2026-09-02-fiche-anonymise.png|thumb|center|1100px|Vehicle in service: specifications, capacities and insurance summary.]]

{| class="wikitable"
! Status !! Meaning
|-
| Draft || Prepare and check the record
|-
| Validated || Identified and approved, before commissioning
|-
| In service || In use in the fleet
|-
| Out of service || Withdrawn from operation
|-
| Transferred / sold || Removed from the fleet following disposal
|}

Use the available validate, commission, withdraw or dispose actions according to the current state and permissions. Regulatory rules may prevent commissioning. Record disposal through its lifecycle action to retain history; deleting a record serves a different purpose.

== Daily use ==

=== Assign a driver ===

Open '''Assignments → Add assignment'''. Choose the driver, start date/time and a known end date; specify type, primary assignment, status and reason, then save. Several assignments may overlap, but only one can be primary. End an assignment by editing it with the pencil and setting its end and status.

[[File:LMDBVehicleManagement-2026-09-04-affectations-anonymise.png|thumb|center|1100px|Driver assignments, dates, type, primary flag and status.]]

=== Odometer readings ===

In '''Mileage''', add a reading with its date, observed value and type. Explain corrections or meter replacements. Save and verify chronology and differences. '''A reading created by consumption must be corrected on the originating refuelling/charging record.''' Do not add a duplicate manual reading to correct it. QUARTIX estimates remain distinguishable from actual readings.

[[File:LMDBVehicleManagement-2026-09-05-kilometrage-anonymise.png|thumb|center|1100px|Readings, differences and sources. Consumption-linked readings are managed from their source.]]

=== Record refuelling, charging or an additive ===

# Choose '''New refuelling / charging''', enter date/time and select the vehicle.
# Select the type and consumable; enter an oil reference when required.
# Check the driver, enter quantity in the stated unit and the odometer value.
# Enter the total including tax. Leave an unknown additive price empty; zero means a known zero price.
# Select a project if relevant; with miscellaneous payments enabled, check payment details and attach the PDF/JPEG/PNG receipt.
# Use a standard reading for ordinary entries; justify a correction or meter replacement. Save and check the resulting card.

Check quantity, unit, vehicle and capacity when an over-capacity warning appears. Reconciled or accounting-transferred financial data and receipts are locked.

[[File:LMDBVehicleManagement-1.0.0-06-plein.jpg|thumb|center|1100px|Consumption form with receipt and payment information when enabled.]]

=== Consumption statistics ===

Open the global '''Consumption''' summary or a vehicle's consumption tab. Set dates and relevant vehicle/driver/consumable/type filters. Search, read quantities, costs, averages and peaks, inspect the charts and open the refuelling list to trace a value. Litres, kWh and kilograms remain separate; they are not added together. Excluded intervals identify readings omitted from calculations. Demonstration peaks are not normal vehicle consumption benchmarks.

[[File:LMDBVehicleManagement-2026-09-07-synthese-anonymise.png|thumb|center|1100px|Consumption filters, summary and native charts using demonstration data.]]

=== Maintenance, breakdowns and invoices ===

From the vehicle card, choose '''New vehicle event'''. Enter label, type, date, driver and service provider, then severity, mileage and any downtime dates. Describe the work, save and attach supporting files to the event. The event list covers the fleet; vehicle history consolidates related operations.

On the event or inspection, create a supplier invoice or select an existing one and link it. Check the relation in Linked objects; its reference opens the invoice. Unlinking leaves both records intact.

[[File:LMDBVehicleManagement-2026-09-13-intervention-facture-anonymise.png|thumb|center|1100px|Maintenance event, supplier invoice actions and linked objects.]]

== Insurance and certificates ==

=== Create a contract ===

Choose '''New contract''' under Insurance contracts. Select insurer and, if applicable, contact/broker. Enter policy number, label, coverage and contract period, renewal and known notice date, plus assistance contacts. Select covered vehicles, coverage type and period. Save and verify the linked vehicles. Coverage can be primary or additional; a fleet contract groups several vehicles under one policy.

[[File:LMDBVehicleManagement-1.0.0-18-creation-assurance.jpg|thumb|center|1100px|Contract creation and vehicle coverage.]]
[[File:LMDBVehicleManagement-2026-09-11-assurance-anonymise.png|thumb|center|1100px|Saved contract and covered vehicle.]]

=== Submit and review a certificate ===

# Open the contract and its insurance certificate tab.
# Choose the scope: covered fleet or eligible vehicle. Enter validity dates and attach evidence.
# Choose '''Save draft''' to continue preparing, or '''Submit for review''' when ready.
# An authorised reviewer checks the document and dates, then validates it or rejects it with a reason.
# On renewal, create the new certificate and archive the former one through the provided workflow.

The table shows scope, dates, downloadable evidence and status. A draft does not replace a reviewed, validated certificate.

[[File:LMDBVehicleManagement-1.0.0-12-attestations.jpg|thumb|center|1100px|Validated certificate and submission form; draft saving and review submission are distinct.]]

== Regulatory inspection guide ==

=== Qualify the equipment ===

Open the vehicle's Regulatory inspections tab. Answer the qualification questions according to actual characteristics and use, complete applicable dates and save. Review the calculated requirements, previous inspection, calculated date, retained date and status. For lifting equipment, determine the VGP interval from its technical qualification; do not guess a period. Complete missing information from equipment documents.

[[File:LMDBVehicleManagement-2026-09-09-qualification-anonymise.png|thumb|center|1100px|Regulatory qualification questionnaire.]]

=== Read the schedule ===

Open the inspection schedule, filter by period, vehicle, equipment type, profile, inspection or status, then sort by retained date. Open a vehicle to inspect a requirement. Status badges distinguish up-to-date and overdue requirements. Interpret the retained date alongside qualification and supporting documents.

[[File:LMDBVehicleManagement-2026-09-08-echeancier-anonymise.png|thumb|center|1100px|Inspection schedule with dates and requirement statuses.]]

=== Record and validate an inspection ===

Start from '''Record an inspection''' on a requirement, or use New inspection. Check vehicle, requirement and inspection type. Enter date, inspection body, report reference, result and official validity date. Explain any different effective date. Save observations, attach the mandatory document to the draft and verify before validation. Then review the updated requirement and due date.

[[File:LMDBVehicleManagement-2026-09-10-controle-anonymise.png|thumb|center|1100px|Inspection form: body, result, report reference and dates.]]

A validated inspection is immutable. Correct errors through reasoned cancellation and replacement. Retain the connection to the original inspection for follow-up checks. Invoice links may change without rewriting validated regulatory data.

== Documents, history and import/export ==

Use '''Notes''' for permitted public/private notes. Attach each file to its proper object: intervention reports to events and inspection evidence to inspections. Native viewing, downloading, upload and deletion follow object permissions. Read permission alone does not allow file modification.

=== Generate the vehicle dossier ===

# Open the vehicle card and its '''Attached files''' block.
# Select '''Vehicle dossier''' in Document model and click '''Generate'''.
# Check both PDF and ZIP files. Use the magnifying glass to preview the PDF, its name to download it, or download the ZIP archive.
# Generate again to update it; do not manually replace reserved dossier files.

[[File:LMDBVehicleManagement-1.0.0-14-dossier.jpg|thumb|center|754px|Native document model selection, generation, preview and download.]]
[[File:LMDBVehicleManagement-2026-09-19-apercu-pdf-anonymise.png|thumb|center|793px|First page of an existing vehicle dossier.]]

Consumption/payment receipts are excluded from the ZIP. Viewing the dossier still requires vehicle and supplier invoice read permissions.

=== Find a past operation ===

Open '''History''', filter dates, source, type, label or status, sort by date and open an operation through its label. Check its document indicator. '''Events/Calendar''' shows linked calendar events; History consolidates the available business timeline.

[[File:LMDBVehicleManagement-2026-09-17-historique-anonymise.png|thumb|center|1100px|Consolidated history of events, readings, consumption, insurance and assignments.]]

Use native import/export with the module's datasets and the relevant permissions. Prepare CSV columns according to the selected import, check references and entity, then verify the results. Imported regulatory inspections remain drafts. Consumption import is refused when miscellaneous payments are enabled. Keep an unknown additive price empty and a known zero as zero.

== QUARTIX API integration ==

=== Access, permissions and connection ===

QUARTIX QWS v2 is used in read-only mode. Obtain QWS access, customer code, username, password and '''APPLICATION NAME''' from QUARTIX, and confirm access to route data. Check the module distribution and Compatibility tab: cURL, OpenSSL, native encryption with the Dolibarr instance key and native Leaflet are required as applicable. After deployment, deactivate/reactivate the module to register its tables, rights and jobs while retaining existing settings.

Vehicle reading, GPS viewing and QUARTIX synchronisation are separate permissions. Grant the internal scheduled-job user vehicle reading, QUARTIX synchronisation and odometer management. Synchronisation permission does not grant GPS access. External users cannot access QUARTIX features. Settings and links belong to the owning entity, which also synchronises shared vehicles.

# Open the module settings and '''QUARTIX'''.
# Enter customer code, login, password and the exact APPLICATION NAME supplied by QUARTIX. An empty password field retains the stored password.
# Confirm timestamp interpretation. '''QWS convention''' honours an explicit offset and otherwise uses the vehicle's local timezone. Use a forced mode only after confirming the account's convention.
# Confirm the duration unit with QUARTIX. Until configured, durations remain unavailable, not zero.
# Set '''Journey retention (days)'''; the initial value is 30 when no setting exists.
# Save, then test the connection and load the vehicle catalogue.
# Enable synchronisation once configured, and activate the four native jobs below.

Each entity has its own credentials, tokens, links and synchronisation state. Stored passwords are not displayed. Changed credentials renew authentication for that entity.

=== Vehicle links and device reassignment ===

Select the Dolibarr vehicle and its QUARTIX counterpart, confirm the IANA timezone and actual device installation date/time, then save. The day start comes from QUARTIX. Check initial values in '''QUARTIX usage''' on the vehicle card. New imports are bounded by installation: earlier positions and estimates are rejected and summaries start at the first complete QUARTIX day after installation. Migrated links without an installation date keep it unset; no historical date is invented. Review a link if its timezone or day-start setting changes in QUARTIX.

The native switch suspends/resumes a link. '''Unlink''' distinguishes:

* '''Device reassignment''': keep imports on the old vehicle. Previously loaded routes remain readable until expiry, but new requests for the old link stop.
* '''Incorrect association''': permanently remove the vehicle's QUARTIX journeys, summaries and estimates as described in the confirmation.

Both clear the last position and release the device for linking. Manual and consumption-linked readings remain intact. A new association must not overlap retained history on the same vehicle.

=== Scheduled jobs ===

Jobs are installed '''disabled''', initially waking every fifteen minutes. Verify the execution user, enable them in native Scheduled jobs and check their latest results.

{| class="wikitable"
! QUARTIX job !! Purpose
|-
| Latest positions || Refresh positions in vehicle batches
|-
| Daily mileage || Import estimated odometer readings through daily vehicle processing
|-
| Usage and historical backfill || Import completed days and progressively recover usage history
|-
| Journey log || Refresh current/open days, recover history, process route requests and purge expired journeys
|}

Wake-up frequency does not guarantee a full-fleet update within fifteen minutes. Fleet size, batches, response time and quotas affect completion. Quota and service errors impose a shared retry delay for the entity; repeated connection tests do not bypass it.

=== Read usage and the dashboard ===

The vehicle's QUARTIX usage tab shows its association and permitted imported information. The fleet dashboard uses native filters, indicators and charts.

* Mileage estimates are labelled and do not replace real or consumption-linked readings. Contradictions are reported without blocking real readings.
* The last position requires GPS permission. Check its date: an old position does not prove breakdown or downtime.
* Usage includes distance, journey count, active days and data coverage. Daily summaries are retained for twelve months; the current day is excluded from completed-day summaries.
* An unknown day differs from a known day without activity. Totals use only reported days.
* The dashboard initially covers the preceding thirty completed days. Totals and daily trends cover the selection; the vehicle comparison shows the twenty highest distances. Places and GPS links are omitted without GPS permission.

Reading imported data does not call QWS. Consumption calculations continue to use actual readings.

[[File:LMDBVehicleManagement-2026-09-quartix-utilisation.png|thumb|center|1000px|Daily QUARTIX usage: day coverage, distances and journey counts. Durations remain unavailable until their unit is confirmed.]]

=== Journey log ===

Open '''Journeys''' with GPS permission, select a period (initially the last seven days), apply filters and inspect departure, arrival, distance and status. Use column selection, sorting and pagination. Check day coverage and synchronisation time before concluding that no journey occurred.

Displayed times follow the Dolibarr session timezone; the journey day follows the vehicle's QUARTIX day boundary. Provisional arrivals are not presented as final. '''Private journeys retain only day and distance''': no addresses, coordinates, exact times, durations or routes. Missing privacy indicators receive the same protection.

[[File:LMDBVehicleManagement-2026-09-quartix-trajets-anonymise.png|thumb|center|1000px|QUARTIX journey log with date filters and journey statuses. Addresses are blurred.]]

=== Route map ===

Enable route viewing in the owning entity's QUARTIX settings after confirming QWS route access. Click '''View route''' on a non-private journey. The native dialog displays the cached route or requests it if needed. '''Load / refresh route''' becomes available when another attempt is allowed. Shared-vehicle requests wait for the owner's Journey log job when the route is not cached.

The native modal contains no embedded navigation history or debug bar. Information and warnings remain in persistent alert blocks. The map connects QUARTIX positions; '''it does not calculate a road itinerary'''. Completed journeys show departure and arrival markers. Only open journeys show the in-progress note and lack a definitive arrival. Fewer than two points, missing data or incompatible data yield an unavailable state.

A completed cached route does not call QUARTIX again. Requests for the same day are spaced at least fifteen minutes apart, subject to quotas. The dialog's periodic checks reread cache and permissions; they are not live GPS tracking.

OpenStreetMap tiles are the default, without an API key and with visible attribution. An alternative HTTPS tile URL and attribution can be configured. The tile provider receives requests for the viewed map area, not QUARTIX secrets. Tile failure is reported separately from route unavailability.

[[File:LMDBVehicleManagement-2026-09-quartix-route-anonymise.png|thumb|center|1000px|Completed journey in the native route dialog with persistent messages. The registration number and map background are blurred to protect locations; map attribution is retained.]]

=== Retention and confidentiality ===

Journeys and routes share one retention setting. A reduction immediately hides expired days; the Journey log job then purges them in batches. An increase allows gradual backfill of days still available from QUARTIX. Purging continues when only synchronisation is suspended, provided the module and Journey log job remain enabled; stopping either stops purging. Usage summaries retain their separate twelve-month window.

Cached routes are encrypted. A journey becoming private or incompatible with the log loses access to its former route. GPS positions and tracks are excluded from module documents, exports and APIs. Driver identities, eco-driving scores and detailed speeds are not imported.

=== QUARTIX troubleshooting ===

{| class="wikitable"
! Symptom !! Check
|-
| Connection test fails || Save all credentials, especially APPLICATION NAME. Record the displayed stage and HTTP status, without sharing credentials or raw API responses.
|-
| Data does not arrive || Check active link, synchronisation, installation date, execution-user rights and all four jobs. Backfill requires multiple runs.
|-
| Durations unavailable || Confirm the unit with QUARTIX and save it.
|-
| Missing route icon || Check GPS permission, route setting, privacy and retention.
|-
| Request pending || Check the owner's Journey log job, synchronisation and retry delay.
|-
| Blank map || Read the persistent message: missing points, expired session, withdrawn access and tile failure are different cases. Reload after module updates.
|-
| Values differ from QUARTIX || Compare the same vehicle, day, timezone, day boundary, coverage and synchronisation time; distinguish estimates from actual readings.
|}

== Frequently asked questions ==

{| class="wikitable"
! Situation !! Check or action
|-
| An action is missing || Check permissions, object status and Compatibility dependencies.
|-
| Dossier generation fails || Check model activation, Supplier invoices, PHP ZIP and vehicle/invoice rights.
|-
| A reading cannot be edited || Correct consumption-linked readings from their originating consumption record.
|-
| Certificate is not validated || Check state, scope, dates and evidence; a draft still requires review.
|-
| Due date missing || Complete qualification characteristics and dates required by the rule.
|-
| Reminders are not sent || Check activation, recipients, templates, Dolibarr email delivery and scheduled job results.
|-
| Expense cannot be changed || Check bank reconciliation or accounting transfer and use the native financial correction process.
|-
| Another entity's data appears || Check Environment and authorised Multicompany sharing.
|}

== Updates and limits ==

Back up the database and documents before updating. Replace module files, then deactivate/reactivate to apply migrations and register native declarations while preserving settings. Read <code>ChangeLog.md</code>, check models and jobs, regenerate dossiers for layout changes and review bank settings before enabling consumption payments. Future calendar events use updated labels; existing history and validated inspections are not rewritten. QUARTIX setup requires its credentials, links and four jobs; old version 1.0.0 packages may lack the integration.

Detailed extinguisher, pressure equipment, lifting accessory and refrigerant inspections are not preconfigured. Registration-document management, claims, premiums, deductibles and traffic fines are outside scope. Commercial purchase invoice management stays in native Supplier invoices. Periodic reminders require working scheduled jobs and email delivery. QUARTIX track export, eco-driving and automatic driver-assignment changes are not provided.

== Sources and useful links ==

* [https://github.com/mapiolca/lmdbvehiclemanagement Module source code]
* [https://github.com/mapiolca/lmdbvehiclemanagement/blob/094fc89/README.md Original version 1.0.0 documentation]
* [https://github.com/mapiolca/lmdbvehiclemanagement/blob/094fc89/ChangeLog.md Original version 1.0.0 changelog]
* [https://github.com/mapiolca Author profile]

[[Category:Complementary modules]]
[[Category:DocUserEN]]

Module Gestion des véhicules

2026-09-07T09:14:32Z

Mapiolca: Documenter QUARTIX QWS v2, ajouter les captures anonymisées et relier les notices EN, IT, DE et ES.

[[en:Module Vehicle Management]]
[[it:Modulo Gestione dei veicoli]]
[[de:Modul Fahrzeugverwaltung]]
[[es:Módulo Gestión de vehículos]]

'''Gestion des véhicules et engins''' est un module externe pour Dolibarr permettant de centraliser le suivi d'un parc de véhicules routiers, d'utilitaires et d'engins. Il regroupe les caractéristiques du matériel, les affectations des conducteurs, les kilométrages, les consommations, les interventions, les assurances et les contrôles réglementaires.

Le module permet également de relier les factures fournisseurs aux interventions et aux contrôles, puis de générer un dossier véhicule réunissant un récapitulatif PDF et une archive des documents associés. L’intégration QUARTIX QWS v2 ajoute les estimations kilométriques, les synthèses d’utilisation, les positions, les trajets et leur visualisation sur carte.

Cette page comprend la présentation du module, son installation et sa '''notice d'utilisation illustrée'''. Les captures ont été réalisées les 5 et 7 septembre 2026 sur une instance de démonstration Dolibarr 24 avec Multicompany. Les adresses et plaques d’immatriculation sont floutées. Les valeurs affichées servent uniquement d'exemples ; elles ne constituent ni des réglages recommandés ni des références de consommation. Le thème et la version de Dolibarr peuvent faire varier la présentation.

Documentation actualisée le 7 septembre 2026. Le développement QUARTIX complète la version 1.0.0 ; les anciennes archives portant ce numéro peuvent ne pas l’inclure. Le logiciel fournit le français et l’anglais. Les traductions EN, IT, DE et ES de cette notice ne modifient ni les langues du logiciel ni le catalogue réglementaire français.

__TOC__

==Informations==

{| class="wikitable"
!Information!!Valeur
|-
|Nom||Gestion des véhicules et engins
|-
|Identifiant technique||<code>lmdbvehiclemanagement</code>
|-
|Auteur||Pierre Ardoin
|-
|Famille||Les Métiers du Bâtiment
|-
|Version présentée||1.0.0 — première version stable du 4 septembre 2026
|-
|Dolibarr minimum||20.0
|-
|PHP minimum||8.0
|-
|Base de données||MySQL ou MariaDB
|-
|Langues fournies||Français et anglais
|-
|Multicompany||Compatible ; module Multicompany facultatif
|-
|Licence||GNU GPL version 3 ou ultérieure
|}

==Fonctionnalités==

===Gestion du parc===

*Fiches pour les véhicules routiers, utilitaires et engins, avec immatriculation facultative.
*Caractéristiques techniques, énergie, capacités et autonomie WLTP.
*Suivi du cycle de vie, du brouillon à la cession.
*Affectations des conducteurs, avec plusieurs affectations simultanées possibles et une seule affectation principale par période.
*Relevés kilométriques et prise en charge des corrections ou remplacements de compteur.
*Événements d'entretien, pannes et incidents.
*Chronologie regroupant événements, contrôles et consommations.
*Modèles de numérotation, dont un modèle fondé sur l'immatriculation.

Les listes proposent des filtres, le tri, la pagination et des colonnes personnalisables. Les fiches utilisent les notes, contacts, fichiers joints et objets liés de Dolibarr selon les fonctions concernées.

===Pleins, recharges et consommations===

Le module suit les carburants, les recharges électriques, l'hydrogène et les additifs. Les consommables sont associés à leurs unités et aux énergies compatibles. Les capacités du véhicule permettent de signaler un dépassement lors de la saisie.

*Synchronisation des consommations avec les relevés kilométriques.
*Synthèses par véhicule, consommable et unité.
*Statistiques de coûts, distances et consommations, avec graphiques Dolibarr.
*Import CSV et export natif.
*Prix facultatif pour les additifs : un montant absent est distingué d'un montant égal à zéro et n'entre pas dans les statistiques de prix.

Une option par entité permet de créer une '''opération diverse''' native pour un plein ou une recharge. Elle nécessite un compte bancaire, les informations de règlement et un justificatif PDF, JPEG ou PNG. Les métadonnées des images justificatives sont nettoyées.

La comptabilité reste facultative. En comptabilité en partie double, un compte général du plan actif est requis. Les données financières et le justificatif sont verrouillés après rapprochement bancaire ou transfert comptable.

'''Lorsque la création d'opérations diverses est activée, l'import CSV des consommations est indisponible.''' L'activation de cette option ne crée pas d'opérations pour les consommations historiques.

===Assurances===

*Contrats individuels ou contrats de flotte couvrant plusieurs véhicules.
*Couverture principale et couvertures complémentaires.
*Contacts de l'assureur et du courtier.
*Attestations communes ou propres à un véhicule, avec justificatifs, validation, rejet et archivage.
*Référents utilisateurs ou groupes et personnels affectés éligibles.
*Relances avant et après échéance, avec modèles d'emails et travaux planifiés natifs.

===Contrôles réglementaires===

Un questionnaire guidé permet de qualifier les véhicules et engins et de déterminer les exigences applicables à partir des informations enregistrées.

La version 1.0.0 fournit un catalogue français versionné couvrant notamment les contrôles routiers, la pollution, la catégorie L, les usages spécialisés, les vérifications générales périodiques (VGP), la mise ou remise en service, le tachygraphe, l'ADR et l'ATP. Des surcharges par entité et des règles personnalisées complètent le catalogue.

*Contrôles numérotés avec organisme, résultat, dates et justificatif obligatoire.
*Validation immuable, annulation motivée, remplacement, contre-visite et archivage encadré.
*Échéancier et registre de sécurité.
*Export et import de contrôles en brouillon.
*Blocage configurable des nouvelles affectations et mises en service.
*Recalcul quotidien et rappels par travail planifié, avec événement Agenda unique par exigence.

Lorsqu'une information indispensable manque, le module ne calcule pas d'échéance arbitraire. Il constitue une aide au suivi documentaire : il ne réalise pas les contrôles et ne délivre aucun rapport officiel.

===Factures fournisseurs liées===

Depuis un événement ou un contrôle, l'action '''Créer une facture fournisseur''' ouvre le formulaire natif Dolibarr. Le fournisseur de l'intervention est proposé lorsqu'il est renseigné et accessible ; il peut être modifié. La facture est créée en brouillon et liée à l'objet d'origine.

Il est également possible de sélectionner une facture existante ou d'utiliser l'action '''Lier à''' depuis une facture fournisseur. Les relations sont visibles dans les blocs '''Objets liés''' des deux fiches. Plusieurs factures peuvent être associées à une même intervention.

Une déliaison retire uniquement la relation. Elle ne supprime pas la facture et ne modifie pas les données réglementaires d'un contrôle validé. Les objets liés doivent appartenir à l'entité courante et les droits requis sur chacun d'eux restent nécessaires.

===Dossier véhicule PDF et ZIP===

Le modèle '''Dossier véhicule''' produit deux fichiers :

*un '''PDF''' regroupant les caractéristiques du véhicule, la chronologie disponible, les événements, les contrôles, les factures liées, une synthèse des pleins et recharges et l'inventaire documentaire ;
*un '''ZIP''' contenant ce PDF et les fichiers originaux du véhicule, des événements, des contrôles et des factures liées.

Les brouillons, annulations et archives sont inclus. Une facture liée à plusieurs interventions n'est embarquée qu'une fois. Les fichiers indexés mais absents sont signalés dans le PDF.

Les justificatifs des consommations et de leurs opérations diverses, les fichiers temporaires, les aperçus et les dossiers précédents sont exclus de l'archive. Le tableau de synthèse des consommations présente les dates, kilométrages, références, consommables, natures, unités et références d'huile ; il ne présente ni les quantités ni les montants.

La génération utilise les données et documents déjà disponibles : elle ne génère pas les documents commerciaux des factures et ne reconstitue pas un historique non enregistré.

La génération nécessite les droits de lecture et d'écriture du véhicule ainsi que la lecture des factures fournisseurs. La consultation du dossier nécessite les droits cumulés de lecture correspondants. Le dossier n'est pas accessible aux utilisateurs externes ni par lien public.

===Gestion multientité===

Avec Multicompany, les objets partageables sont configurables dans les réglages natifs de partage. Les listes concernées affichent un filtre et une colonne '''Environnement'''.

Les documents restent stockés dans l'entité propriétaire de l'objet, y compris lorsqu'il est consulté depuis une autre entité autorisée. Les réglages par entité, modèles et choix de partage sont conservés lors d'une désactivation puis réactivation du module.

==Prérequis et dépendances==

Le socle requis est Dolibarr 20 ou supérieur, PHP 8.0 ou supérieur et MySQL/MariaDB. Les dépendances supplémentaires varient selon les fonctions utilisées.

{| class="wikitable"
!Module ou extension!!Utilisation
|-
|Agenda||Échéances et événements ; recommandé pour le suivi automatique.
|-
|Travaux planifiés||Exécution périodique des recalculs et relances.
|-
|Banques et Caisses||Requis pour créer les opérations diverses des consommations.
|-
|Comptabilité||Facultative ; règles de compte adaptées au mode comptable actif.
|-
|Factures fournisseurs||Requis pour les liaisons de factures et les dossiers véhicule.
|-
|Extension PHP ZIP (<code>ZipArchive</code>)||Requise pour générer le dossier PDF/ZIP.
|-
|Multicompany||Facultatif ; partage et gestion de plusieurs entités.
|-
|Ressources||Facultatif ; liaison à une ressource Dolibarr.
|}

L'onglet '''Compatibilité''' des réglages indique les dépendances et fonctionnalités disponibles dans l'environnement courant.

==Installation==

#Récupérer une distribution du module correspondant à la version 1.0.0.
#Placer le répertoire <code>lmdbvehiclemanagement</code> dans le répertoire des modules externes de l'installation Dolibarr. Les fichiers du module doivent se trouver directement dans ce répertoire, sans second répertoire imbriqué du même nom.
#Se connecter à Dolibarr avec un compte administrateur.
#Ouvrir '''Accueil → Configuration → Modules/Applications'''.
#Rechercher et activer '''Gestion des véhicules et engins''', dans la famille '''Les Métiers du Bâtiment'''.
#Ouvrir les réglages avec la roue dentée du module et consulter l'onglet '''Compatibilité'''.
#Attribuer aux utilisateurs et groupes les permissions correspondant à leurs fonctions.

Si une archive de déploiement Dolibarr est fournie, elle peut être installée depuis l'écran natif de déploiement des modules externes.

==Configuration initiale==

#Vérifier les dictionnaires utiles au parc : énergies, consommables, types de matériel, profils, types et résultats de contrôles.
#Choisir les modèles de numérotation des objets.
#Configurer les options d'assurance, les référents et les modèles d'emails de relance.
#Vérifier les règles réglementaires et les options de blocage souhaitées.
#Dans les '''Travaux planifiés''' de Dolibarr, vérifier et activer les traitements nécessaires aux recalculs et aux rappels automatiques.
#Si les opérations diverses sont utilisées, configurer cette option et ses paramètres bancaires dans chaque entité concernée.
#Pour les dossiers véhicule, activer '''Dossier véhicule''' dans le bloc '''Modèles de document''' et, si souhaité, le choisir comme modèle par défaut.
#En environnement Multicompany, configurer les partages et les permissions d'accès aux entités.

Les onglets '''Compatibilité''' et '''À propos''' sont accessibles depuis les réglages du module.

===Choisir la numérotation et activer le dossier véhicule===

#Ouvrir l'onglet '''Paramètres''' des réglages.
#Dans '''Modèles de documents''', activer la ligne '''Dossier véhicule'''. La colonne '''Défaut''' permet de le proposer automatiquement lors de la génération.
#Dans '''Modèles de numérotation''', choisir le modèle de chaque objet.
#Pour les véhicules, choisir '''standard''' pour une référence séquentielle ou '''registration''' pour utiliser l'immatriculation normalisée. Un matériel sans immatriculation reçoit une référence de type MAT avec ce dernier modèle.

Les exemples de référence permettent de vérifier le résultat attendu. Sur un parc existant, un changement impliquant la reprise des références doit suivre la procédure de migration proposée par le module.

[[File:LMDBVehicleManagement-2026-09-15-modeles-anonymise.png|thumb|center|1100px|Réglages des modèles documentaires et de la numérotation. Le dossier est activé ; le choix du modèle par défaut est distinct.]]

===Configurer les dépenses des pleins et recharges===

Dans '''Paramètres''', le bloc '''Tickets et opérations diverses des pleins / recharges''' permet d'activer la création d'une dépense native.

#Choisir le compte bancaire de l'entité et le mode de règlement habituel.
#Renseigner les comptes comptables selon le mode de comptabilité utilisé. Le compte général est obligatoire en partie double ; le compte auxiliaire reste facultatif.
#Activer l'option souhaitée et cliquer sur '''Enregistrer'''.
#Vérifier ensuite la saisie d'un plein : les informations de règlement et le ticket sont demandés lorsque cette option est active.

Cette option concerne les nouvelles opérations. Elle ne transforme pas les anciennes consommations en dépenses et rend leur import CSV indisponible.

===Configurer les relances d'assurance===

#Ouvrir l'onglet '''Assurance''' des réglages.
#Choisir les utilisateurs et/ou groupes référents.
#Indiquer si les personnels affectés doivent être inclus, puis sélectionner les types d'affectation concernés.
#Sélectionner les seuils avant expiration et les délais de répétition après expiration ou absence de justificatif.
#Choisir les modèles d'emails de dépôt et de contrôle.
#Activer les relances et cliquer sur '''Enregistrer'''.
#Utiliser le lien '''Ouvrir les travaux planifiés''' pour vérifier l'état de la tâche et son dernier résultat.

Le bouton '''Envoyer un email de test''' déclenche un envoi réel : vérifier les destinataires avant de l'utiliser. Les délais visibles sur l'illustration sont ceux de l'environnement de démonstration.

[[File:LMDBVehicleManagement-1.0.0-16-relances-assurance.jpg|thumb|center|1100px|Choix des référents, seuils de relance, modèles d'emails et accès au travail planifié d'assurance.]]

===Configurer les rappels des contrôles===

Dans l'onglet '''Contrôles réglementaires''' des réglages :

#Choisir les horizons de rappel et le délai d'affichage « à échéance prochaine ».
#Sélectionner les utilisateurs ou groupes destinataires et préciser si le conducteur affecté doit être inclus.
#Choisir le modèle de rappel et, si nécessaire, activer les rappels journaliers après échéance.
#Enregistrer les réglages puis vérifier le travail planifié de recalcul et de rappel.

Le catalogue distingue les règles natives des adaptations propres à l'entité. Les surcharges et règles personnalisées doivent correspondre au matériel réellement exploité et conserver leur justification.

==Notice — premiers pas==

===Accéder au parc et retrouver une fiche===

Ouvrir le menu '''Gestion des véhicules et engins''' repéré par une icône de voiture. Le menu latéral regroupe le parc, les événements, les contrôles, la consommation et les contrats d'assurance.

#Cliquer sur '''Liste des véhicules et engins'''.
#Saisir un critère dans les filtres de référence, immatriculation, libellé, modèle ou état.
#Cliquer sur la loupe pour rechercher ; la croix réinitialise les filtres.
#Cliquer sur un en-tête de colonne pour trier, ou sur le sélecteur de colonnes pour adapter la liste.
#Ouvrir le véhicule en cliquant sur sa référence.

Le sélecteur de limite règle le nombre de lignes par page. Lorsqu'un partage multientité est actif, la colonne et le filtre '''Environnement''' permettent d'identifier l'entité d'origine.

[[File:LMDBVehicleManagement-2026-09-01-liste-anonymise.png|thumb|center|1100px|Accès aux rubriques du module et recherche dans le parc de démonstration.]]

===Créer un véhicule ou un engin===

#Cliquer sur '''Nouveau véhicule ou engin'''.
#Renseigner un '''Libellé''' explicite et l'immatriculation si le matériel en possède une.
#Choisir le '''Type principal de matériel''', puis compléter les caractéristiques connues : catégorie, genre, masses, nombre de places, territoire, numéro de série, marque et modèle.
#Choisir l'énergie et renseigner l'autonomie lorsqu'elle est connue.
#Compléter les dates de construction, première immatriculation et mise en service selon les informations disponibles.
#Choisir le mode de détention et le propriétaire. La liaison à une ressource Dolibarr est facultative.
#Compléter la description et cliquer sur '''Enregistrer''' en bas du formulaire.

La fiche est créée en brouillon. La référence suit le modèle de numérotation configuré ; il n'est pas nécessaire de fabriquer un identifiant manuellement. Compléter ensuite les capacités des consommables utiles au véhicule depuis sa fiche en modification.

[[File:LMDBVehicleManagement-1.0.0-03-creation.jpg|thumb|center|1100px|Partie supérieure du formulaire de création : identification, caractéristiques techniques et dates.]]

===Lire la fiche et son état===

La fiche présente la référence, le libellé et un badge d'état, puis les caractéristiques techniques et la couverture d'assurance disponible. Les onglets donnent accès aux notes, documents, événements, affectations, kilométrages, consommations, contrôles et historique selon les droits.

[[File:LMDBVehicleManagement-2026-09-02-fiche-anonymise.png|thumb|center|1100px|Extrait de la fiche d'un véhicule en service : caractéristiques, capacités et résumé d'assurance.]]

{| class="wikitable"
!État!!Utilisation
|-
|Brouillon||Préparer et vérifier la fiche avant validation.
|-
|Validé||Véhicule identifié et validé, avant sa mise en service.
|-
|En service||Matériel utilisé dans le parc.
|-
|Hors service||Matériel retiré de l'exploitation.
|-
|Cédé / vendu||Matériel sorti du parc à la suite d'une cession.
|}

Utiliser les actions proposées sur la fiche, notamment '''Valider''', '''Mettre en service''', '''Mettre hors service''' ou '''Céder / vendre''', selon l'état courant et les permissions. Les règles réglementaires peuvent empêcher une mise en service. Une sortie de parc doit être enregistrée par le changement d'état approprié afin de conserver son historique ; la suppression répond à un autre besoin.

==Notice — utilisation quotidienne==

===Affecter un conducteur===

#Ouvrir l'onglet '''Affectations''' du véhicule.
#Cliquer sur '''Ajouter une affectation'''.
#Sélectionner le conducteur et renseigner la date et l'heure de début.
#Renseigner une fin lorsqu'elle est connue, puis le type d'affectation.
#Préciser s'il s'agit de l'affectation principale, choisir son état et compléter le motif utile.
#Cliquer sur '''Enregistrer'''.

Plusieurs affectations peuvent coexister, mais une seule peut être principale sur une même période. Pour terminer une affectation, ouvrir sa modification avec le crayon et renseigner sa fin et son état. Vérifier le résultat dans le tableau.

[[File:LMDBVehicleManagement-2026-09-04-affectations-anonymise.png|thumb|center|1100px|Liste des affectations : conducteur, période, type, caractère principal et état.]]

===Ajouter ou corriger un relevé kilométrique===

#Ouvrir l'onglet '''Kilométrage''' et cliquer sur '''Ajouter un relevé'''.
#Renseigner la date du relevé et la valeur constatée au compteur.
#Choisir la nature du relevé. Pour une correction ou un remplacement de compteur, compléter le motif correspondant.
#Enregistrer, puis vérifier l'ordre chronologique et la différence avec les autres relevés.

'''Un relevé créé par un plein ou une recharge se corrige depuis la fiche de cette consommation.''' L'icône d'information de la ligne le rappelle. Éviter d'ajouter un second relevé manuel pour corriger la même opération.

[[File:LMDBVehicleManagement-2026-09-05-kilometrage-anonymise.png|thumb|center|1100px|Relevés kilométriques avec date, différence et source. Les lignes issues des consommations sont gérées depuis leur fiche d'origine.]]

===Enregistrer un plein, une recharge ou un additif===

#Cliquer sur '''Nouveau plein / recharge''' dans le menu latéral.
#Renseigner la date et l'heure, puis sélectionner le véhicule.
#Choisir la '''Nature''' et le carburant, la recharge ou l'additif correspondant. Compléter la référence d'huile lorsqu'elle est demandée.
#Vérifier le conducteur, saisir la quantité dans l'unité proposée et le kilométrage du compteur.
#Saisir le '''Total TTC'''. Pour un additif dont le prix est inconnu, laisser le montant vide ; zéro signifie un prix connu égal à zéro.
#Choisir le projet si nécessaire. Lorsque les opérations diverses sont actives, vérifier le règlement et joindre le ticket PDF, JPEG ou PNG.
#Conserver un relevé standard pour une saisie ordinaire ; justifier une correction ou un remplacement de compteur si c'est le cas.
#Cliquer sur '''Enregistrer''' et vérifier la fiche obtenue.

Un avertissement de dépassement de capacité invite à vérifier la quantité, l'unité, le véhicule et sa capacité configurée. Les champs financiers et le ticket ne sont plus librement modifiables après rapprochement bancaire ou transfert comptable.

[[File:LMDBVehicleManagement-1.0.0-06-plein.jpg|thumb|center|1100px|Formulaire de plein ou recharge avec ticket de caisse et règlement, lorsque les opérations diverses sont activées.]]

===Consulter les consommations et statistiques===

#Cliquer sur '''Consommation''' pour ouvrir la synthèse globale, ou sur l'onglet '''Consommation''' d'un véhicule pour son suivi individuel.
#Définir la période et, selon le besoin, filtrer par véhicule, conducteur, consommable ou nature.
#Lancer la recherche avec la loupe.
#Lire les passages, quantités, coûts, moyennes et pics par consommable et unité.
#Consulter les courbes puis ouvrir '''Liste des pleins / recharges''' pour retrouver les saisies à l'origine d'une valeur.

Les unités restent distinctes : litres, kWh et kilogrammes ne s'additionnent pas. La colonne '''Intervalles exclus''' aide à repérer les intervalles non retenus dans les calculs. Les données de démonstration peuvent produire des pics volontairement atypiques ; elles n'illustrent pas la consommation normale du véhicule.

[[File:LMDBVehicleManagement-2026-09-07-synthese-anonymise.png|thumb|center|1100px|Synthèse filtrable et premiers graphiques : les valeurs affichées proviennent d'un jeu de données de test.]]

===Enregistrer une intervention, une panne ou un incident===

#Depuis la fiche du véhicule, cliquer sur '''Nouvel événement véhicule'''.
#Renseigner le libellé, le type d'événement, sa date et les informations utiles sur le conducteur et le tiers intervenant.
#Préciser la gravité, le kilométrage et, si nécessaire, l'immobilisation et sa période.
#Décrire l'intervention puis enregistrer.
#Ajouter les justificatifs dans les fichiers joints de l'événement.

Le menu '''Événements véhicule''' permet de retrouver les interventions de l'ensemble du parc. L'historique du véhicule les regroupe avec ses autres opérations.

===Associer la facture d'une intervention===

Sur la fiche de l'événement ou du contrôle, deux parcours sont disponibles :

*'''Créer une facture fournisseur''' ouvre le formulaire natif. Vérifier le fournisseur, compléter la facture puis enregistrer : le brouillon est lié à l'intervention.
*'''Lier une facture fournisseur existante''' permet de sélectionner une facture puis de cliquer sur '''Lier'''.

Vérifier ensuite la ligne dans '''Objets liés'''. Le lien de référence ouvre la facture. L'action de déliaison retire seulement l'association ; elle ne supprime ni la facture ni l'intervention.

[[File:LMDBVehicleManagement-2026-09-13-intervention-facture-anonymise.png|thumb|center|1100px|Fiche d'entretien et actions de création ou de liaison d'une facture fournisseur ; la relation existante apparaît dans Objets liés.]]

==Notice — assurances et attestations==

===Créer un contrat et couvrir des véhicules===

#Cliquer sur '''Nouveau contrat''' dans la rubrique '''Contrats d'assurance'''.
#Sélectionner l'assureur, puis le contact ou courtier si nécessaire.
#Renseigner le numéro de police, le libellé, les garanties et la période du contrat.
#Préciser le renouvellement et la date de préavis connue. Ajouter les coordonnées d'assistance utiles.
#Sélectionner le ou les véhicules couverts, le type de couverture et sa période.
#Cliquer sur '''Enregistrer''', puis vérifier les véhicules rattachés dans la fiche du contrat.

Une couverture peut être principale ou complémentaire. Un contrat de flotte permet de regrouper plusieurs véhicules dans la même police.

[[File:LMDBVehicleManagement-1.0.0-18-creation-assurance.jpg|thumb|center|1100px|Extrait du formulaire de contrat : assureur, police, période et rattachement des véhicules.]]

[[File:LMDBVehicleManagement-2026-09-11-assurance-anonymise.png|thumb|center|1100px|Contrat d'assurance enregistré et véhicule couvert, avec type et période de couverture.]]

===Déposer et faire contrôler une attestation===

#Ouvrir le contrat depuis '''Liste des contrats'''.
#Choisir l'onglet '''Attestations d'assurance'''.
#Dans '''Nouvelle attestation d'assurance''', choisir la portée : flotte couverte ou véhicule concerné selon les choix proposés.
#Renseigner la période et sélectionner le justificatif.
#Cliquer sur '''Enregistrer le brouillon''' pour poursuivre la préparation, ou '''Soumettre au contrôle''' lorsque le dossier est prêt.
#L'utilisateur habilité vérifie le justificatif et sa période, puis valide l'attestation ou la rejette avec un motif.
#Lors d'un renouvellement, enregistrer la nouvelle attestation et utiliser l'archivage prévu pour conserver la traçabilité de l'ancienne.

Le tableau affiche la portée, les dates, le justificatif téléchargeable et l'état. Un brouillon ne remplace pas une attestation contrôlée et validée.

[[File:LMDBVehicleManagement-1.0.0-12-attestations.jpg|thumb|center|1100px|Attestation validée et formulaire de dépôt : enregistrement provisoire et soumission au contrôle sont deux actions distinctes.]]

==Notice — contrôles réglementaires==

===Qualifier le véhicule===

#Ouvrir l'onglet '''Contrôles réglementaires''' de la fiche véhicule.
#Lire chaque question de '''Qualification réglementaire''' et sélectionner la réponse correspondant à l'usage réel.
#Renseigner les dates d'applicabilité lorsqu'elles sont nécessaires.
#Cliquer sur '''Enregistrer la qualification'''.
#Examiner les '''Exigences réglementaires''' calculées : qualification, dernier contrôle, date calculée, date retenue et état.

Pour un équipement de levage, l'intervalle de VGP doit être choisi après qualification technique. Le formulaire ne doit pas servir à deviner une périodicité. Une information manquante doit être complétée à partir des documents du matériel.

[[File:LMDBVehicleManagement-2026-09-09-qualification-anonymise.png|thumb|center|1100px|Extrait du questionnaire de qualification, à compléter selon les caractéristiques et l'usage du matériel.]]

===Lire l'échéancier===

#Ouvrir '''Échéancier des contrôles''' dans le menu latéral.
#Filtrer la période, le véhicule, le type de matériel, le profil, le contrôle ou l'état.
#Trier les échéances par '''Date retenue''' pour préparer les interventions.
#Ouvrir le véhicule concerné pour retrouver le détail de l'exigence.

Les badges permettent de distinguer notamment une exigence '''À jour''' d'une exigence '''Échue'''. La date retenue est celle utilisée pour le suivi de l'exigence ; elle doit être lue avec la qualification et les documents correspondants.

[[File:LMDBVehicleManagement-2026-09-08-echeancier-anonymise.png|thumb|center|1100px|Échéancier du parc de démonstration, avec dates retenues et états des exigences.]]

===Enregistrer et valider un contrôle===

#Depuis l'exigence du véhicule, cliquer sur '''Enregistrer un contrôle''' pour reprendre le véhicule et l'exigence. Le menu '''Nouveau contrôle''' permet aussi une création directe.
#Vérifier le véhicule, l'exigence et la nature du contrôle.
#Renseigner la date, l'organisme, la référence du procès-verbal et le résultat.
#Saisir la date de validité officielle. Si une autre date effective est retenue, renseigner son motif.
#Compléter les observations et cliquer sur '''Enregistrer'''.
#Sur le contrôle en brouillon, joindre le justificatif obligatoire puis vérifier les informations avant validation.
#Après validation, consulter l'exigence et son échéance actualisée.

[[File:LMDBVehicleManagement-2026-09-10-controle-anonymise.png|thumb|center|1100px|Création d'un contrôle depuis une exigence : organisme, résultat, référence du procès-verbal et dates.]]

Un contrôle validé est immuable. Pour corriger une erreur, utiliser l'annulation motivée et le remplacement prévus par le module. Pour une contre-visite, conserver le lien avec le contrôle concerné. Une facture peut être liée ou déliée sans réécrire les données réglementaires validées.

==Notice — documents et historique==

===Conserver les pièces et les notes===

Utiliser l'onglet '''Notes''' pour les informations publiques ou privées selon les droits, et les fichiers joints de l'objet concerné pour ses pièces. Un rapport d'intervention appartient à l'événement ; un justificatif de contrôle appartient au contrôle. Ce rattachement permet de les retrouver ensuite dans le dossier du véhicule.

Les actions d'ajout, aperçu, téléchargement et suppression suivent les permissions de l'objet et les fonctionnalités disponibles dans la version de Dolibarr. Un droit de lecture n'autorise pas la modification des documents.

===Générer et lire le dossier véhicule===

#Ouvrir la '''fiche principale''' du véhicule et descendre au bloc '''Fichiers joints'''.
#Sélectionner '''Dossier véhicule''' dans '''Modèle de document'''.
#Cliquer sur '''Générer'''.
#Après génération, vérifier la présence du PDF et du ZIP dans le bloc.
#Cliquer sur la loupe du PDF pour l'aperçu, sur son nom pour le télécharger ou sur le ZIP pour récupérer l'archive documentaire.

[[File:LMDBVehicleManagement-1.0.0-14-dossier.jpg|thumb|center|754px|Bloc documentaire de la fiche : sélection du modèle, génération, aperçu du PDF et téléchargement de l'archive.]]

[[File:LMDBVehicleManagement-2026-09-19-apercu-pdf-anonymise.png|thumb|center|793px|Extrait de la première page d'un dossier PDF existant : identification et caractéristiques du véhicule.]]

Pour actualiser le dossier, relancer '''Générer'''. Les fichiers réservés au dossier ne doivent pas être remplacés manuellement. Les justificatifs des consommations et de leurs opérations diverses ne sont pas inclus dans l'archive. Les droits de lecture du véhicule et des factures fournisseurs restent requis pour consulter le dossier.

===Retrouver une opération dans l'historique===

#Ouvrir l'onglet '''Historique''' du véhicule.
#Filtrer par période, source, type, libellé ou état selon le besoin.
#Cliquer sur l'en-tête de la colonne Date pour trier ou sur le libellé d'une opération pour ouvrir sa fiche d'origine.
#Consulter l'indication documentaire lorsqu'une pièce est associée.

L'onglet '''Événements/Agenda''' présente les événements Agenda liés à l'objet. L'onglet '''Historique''' rassemble la chronologie métier disponible. Les deux vues répondent à des usages complémentaires.

[[File:LMDBVehicleManagement-2026-09-17-historique-anonymise.png|thumb|center|1100px|Chronologie consolidée : interventions, relevés, consommations, assurances et affectations.]]

===Importer ou exporter===

Utiliser les fonctions d'import/export natives de Dolibarr avec les jeux de données du module et les droits correspondants. Préparer le CSV à partir des champs attendus par l'import, vérifier les références et l'entité, puis contrôler le résultat après traitement. Les contrôles réglementaires importés sont créés en brouillon.

L'import des consommations est refusé lorsque la création d'opérations diverses est active. Un prix d'additif absent doit rester une cellule vide ; un zéro doit être conservé comme zéro.

== Intégration de l’API QUARTIX ==

L’intégration utilise '''QUARTIX QWS v2''' en lecture seule pour compléter le suivi du parc. Elle récupère les estimations kilométriques, la dernière position, les synthèses d’utilisation et le journal des trajets. Les tracés sont chargés à la demande. Elle ne modifie ni le compte QUARTIX, ni les affectations de conducteurs dans Dolibarr.

=== Prérequis et droits ===

* Disposer d’un accès QWS fourni par QUARTIX, avec le code client, le login, le mot de passe et le '''nom d’application (APPLICATION NAME)'''. Faire confirmer l’accès aux données souhaitées, notamment aux tracés.
* Utiliser une distribution du module contenant cette intégration. Le développement décrit au 7 septembre 2026 complète la version 1.0.0 ; le numéro 1.0.0 seul ne garantit pas sa présence dans une ancienne archive.
* Vérifier dans '''Compatibilité''' la disponibilité de cURL, OpenSSL et du chiffrement natif avec la clé d’instance Dolibarr. La carte utilise le composant Leaflet fourni par Dolibarr.
* Activer les '''Travaux planifiés''' et leur exécution effective sur le serveur pour automatiser les imports.
* Attribuer explicitement les droits nécessaires : lecture des véhicules, consultation des positions GPS et synchronisation QUARTIX sont distinctes. L’utilisateur interne qui exécute les travaux doit aussi pouvoir gérer les relevés kilométriques. Le droit de synchronisation ne donne pas accès au GPS.

Les réglages et associations sont administrés dans l’environnement propriétaire. Les utilisateurs externes n’accèdent pas aux fonctions QUARTIX. Un véhicule partagé reste synchronisé par son propriétaire ; la consultation depuis une autre entité respecte les partages et les droits.

=== Configurer la connexion ===

# Après déploiement, désactiver puis réactiver le module pour enregistrer les tables, droits et travaux nécessaires. Les réglages existants sont conservés.
# Ouvrir la roue dentée du module, puis l’onglet '''QUARTIX'''.
# Saisir le code client, le login, le mot de passe et recopier exactement l’'''APPLICATION NAME''' fourni par QUARTIX. Un mot de passe laissé vide conserve celui enregistré.
# Confirmer l’'''interprétation des horodatages'''. Le mode '''Convention QWS''' respecte le décalage horaire explicite lorsqu’il est fourni et utilise sinon l’heure locale du véhicule. Les autres modes ne doivent être utilisés qu’après confirmation de la convention du compte.
# Confirmer auprès de QUARTIX l’unité des durées. Tant qu’elle n’est pas confirmée dans les réglages, les durées restent indisponibles ; elles ne sont pas transformées en zéros.
# Définir la '''Conservation des trajets (jours)''' selon le besoin. La valeur initiale est de 30 jours lorsqu’aucun réglage n’existe.
# Cliquer sur '''Enregistrer''', puis sur '''Tester la connexion et charger les véhicules'''. Le catalogue reçu permet d’associer les véhicules.
# Activer '''Synchronisation QUARTIX''' après configuration et vérifier les quatre travaux planifiés décrits ci-dessous.

Les identifiants et jetons sont propres à chaque environnement. Le mot de passe enregistré n’est pas réaffiché. Une modification des identifiants renouvelle l’authentification de l’environnement concerné.

=== Associer un véhicule et gérer un boîtier ===

# Depuis les réglages QUARTIX, sélectionner le véhicule Dolibarr puis son véhicule dans le catalogue QUARTIX.
# Confirmer son '''fuseau IANA''' et la '''date et heure réelles d’installation du boîtier''' sur ce véhicule. Le début de journée est issu du paramétrage QUARTIX.
# Enregistrer l’association, puis contrôler les premières valeurs dans l’onglet '''Utilisation QUARTIX''' de la fiche véhicule.

La date d’installation borne les nouveaux imports : aucune position ni estimation antérieure n’est importée ; les synthèses commencent à la première journée QUARTIX complète après installation. Les anciennes associations migrées sans date restent sans date inventée. Après modification du fuseau ou du début de journée dans QUARTIX, revoir l’association avant de reprendre les imports.

L’interrupteur de la ligne permet de '''suspendre''' puis de réactiver une association. L’action '''Dissocier''' propose deux cas à distinguer :

* '''Réaffectation du boîtier''' : conserver les imports de l’ancien véhicule avant d’associer le boîtier à un autre véhicule. Les tracés déjà chargés restent consultables jusqu’à expiration ; les nouvelles demandes de l’ancienne association sont arrêtées.
* '''Association erronée''' : supprimer définitivement les trajets, synthèses et estimations QUARTIX du véhicule. Lire la confirmation avant de valider.

Dans les deux cas, la dernière position est effacée et le boîtier redevient disponible. Les relevés manuels et ceux des pleins/recharges sont conservés. Une nouvelle association ne doit pas chevaucher des journées dont l’historique a été conservé sur le même véhicule.

=== Activer les quatre travaux planifiés ===

Les tâches sont installées '''désactivées''', avec une fréquence initiale de quinze minutes. Ouvrir les '''Travaux planifiés QUARTIX''' depuis les réglages, vérifier l’utilisateur d’exécution, activer les tâches puis contrôler leur dernier résultat.

{| class="wikitable"
! Travail !! Rôle
|-
| QUARTIX — dernières positions || Actualiser la dernière position, par lots de véhicules.
|-
| QUARTIX — kilométrage quotidien || Importer les estimations kilométriques, avec traitement quotidien des véhicules.
|-
| QUARTIX — utilisation et reprise historique || Importer les journées terminées et reprendre progressivement l’historique d’utilisation.
|-
| QUARTIX — journal des trajets || Relire la journée courante et les journées ouvertes, compléter l’historique, traiter les demandes de tracés et purger les trajets expirés.
|}

La fréquence de réveil n’est pas une garantie de mise à jour de toute la flotte en quinze minutes. Les lots, la taille du parc, le temps de réponse et les quotas QUARTIX influencent le délai réel. Une limitation de quota ou une indisponibilité applique un délai de reprise commun à l’environnement. Éviter de multiplier les tests de connexion pendant ce délai.

=== Lire les données du véhicule et le tableau de bord ===

L’onglet '''Utilisation QUARTIX''' du véhicule regroupe l’état de l’association et les informations importées accessibles. Le menu '''Tableau de bord''' donne une synthèse du parc avec filtres, indicateurs et graphiques natifs Dolibarr.

* '''Kilométrage''' : les valeurs importées sont des estimations QUARTIX, identifiées comme telles. Elles ne remplacent pas les relevés réels ni ceux des consommations. Une contradiction avec les relevés réels est signalée ; elle ne bloque pas leur saisie ou correction.
* '''Dernière position''' : elle nécessite le droit GPS. Vérifier sa date ; une position ancienne ne prouve ni une panne ni une immobilisation.
* '''Utilisation''' : distances, nombre de trajets, journées actives et couverture des journées renseignées. Les synthèses quotidiennes sont conservées douze mois. La journée en cours n’entre pas dans les synthèses terminées.
* '''Données manquantes''' : une journée inconnue est distinguée d’une journée renseignée sans activité. Les totaux ne portent que sur les journées renseignées.
* '''Tableau de bord''' : la période initiale couvre les trente journées terminées précédentes. Les totaux et l’évolution portent sur toute la sélection ; la comparaison par véhicule présente les vingt distances les plus élevées. Les lieux et liens GPS sont absents sans le droit correspondant.

L’affichage des données déjà importées ne déclenche pas de nouvel appel QWS. Les consommations restent calculées à partir de leurs relevés réels.

[[File:LMDBVehicleManagement-2026-09-quartix-utilisation.png|thumb|center|1000px|Synthèse quotidienne QUARTIX : couverture des journées, distances et nombre de trajets. Les durées restent indisponibles tant que leur unité n’est pas confirmée.]]

=== Consulter le journal des trajets ===

# Ouvrir l’onglet '''Trajets''' du véhicule avec le droit GPS.
# Choisir la période, initialement les sept derniers jours, puis appliquer les filtres utiles et lancer la recherche.
# Lire les départs, arrivées, distances et états. Utiliser les tris, la pagination et le sélecteur de colonnes pour adapter l’affichage.
# Vérifier la couverture des journées et la dernière synchronisation avant de conclure à l’absence de trajet.

Les horaires affichés suivent le fuseau de la session Dolibarr ; la journée de rattachement conserve le découpage QUARTIX du véhicule. Une arrivée provisoire n’est pas présentée comme une arrivée définitive.

'''Les trajets privés sont protégés.''' Seuls le jour et les distances sont conservés dans leur résumé : pas d’adresse, de coordonnées, d’horaire précis, de durée ou de tracé. La même protection s’applique lorsque les indications nécessaires de confidentialité manquent.

[[File:LMDBVehicleManagement-2026-09-quartix-trajets-anonymise.png|thumb|center|1000px|Journal QUARTIX avec filtres de période et états des trajets. Les adresses sont floutées.]]

=== Afficher le tracé sur la carte ===

# Dans les réglages QUARTIX de l’environnement propriétaire, activer '''Consultation des tracés QUARTIX''' après vérification de l’accès QWS correspondant.
# Dans le journal, cliquer sur le pictogramme '''Voir le tracé''' d’un trajet non privé.
# Le dialogue affiche le tracé en cache ou déclenche son chargement si nécessaire. Le bouton '''Charger / actualiser le tracé''' permet une nouvelle demande lorsque le délai autorisé est écoulé.
# Pour un véhicule partagé, une demande non disponible attend le passage du travail '''Journal des trajets''' de l’environnement propriétaire.

La modale utilise le dialogue natif Dolibarr, sans historique de navigation ni barre de débogage intégrés. Les informations et avertissements restent affichés dans des blocs d’alerte ; ce ne sont pas des notifications éphémères.

La carte relie les points transmis par QUARTIX ; '''elle ne recalcule pas un itinéraire routier'''. Un trajet terminé dispose de marqueurs de départ et d’arrivée. La note '''Trajet en cours''' et l’absence d’arrivée définitive concernent uniquement les trajets encore ouverts. Un tracé absent ou comportant moins de deux points est signalé comme indisponible.

Un tracé terminé déjà en cache ne provoque pas de nouvel appel QUARTIX. Les nouvelles tentatives d’une même journée sont espacées d’au moins quinze minutes, sous réserve des quotas. La vérification périodique du dialogue relit le cache et les autorisations ; elle n’est pas un suivi GPS en direct.

Le fond de carte utilise OpenStreetMap par défaut, sans clé API, avec attribution visible. Un autre fournisseur peut être configuré par URL HTTPS et attribution. Le navigateur demande les tuiles de la zone affichée au fournisseur, sans lui envoyer les secrets QUARTIX. Une panne du fond de carte est signalée séparément d’une indisponibilité du tracé.

[[File:LMDBVehicleManagement-2026-09-quartix-route-anonymise.png|thumb|center|1000px|Tracé d’un trajet terminé dans la modale native, avec messages persistants. L’immatriculation et le fond de carte sont floutés pour protéger les lieux ; l’attribution cartographique est conservée.]]

=== Conservation et confidentialité ===

Les trajets et leurs tracés suivent la même durée de conservation. Réduire cette durée masque immédiatement les journées expirées ; le travail du journal supprime ensuite leurs données par lots. Augmenter la durée permet une reprise progressive des journées encore disponibles chez QUARTIX.

La purge du journal reste active lorsque seule la synchronisation est suspendue, à condition que le module et le travail '''Journal des trajets''' restent actifs. Désactiver le module ou ce travail arrête la purge. Les synthèses d’utilisation gardent leur conservation distincte de douze mois.

Les tracés en cache sont chiffrés. Un trajet reclassé privé ou devenu incompatible avec le journal ne doit plus afficher son ancien tracé. Les positions et parcours GPS ne sont pas exposés dans les documents, exports ou API du module. Aucun conducteur, score d’écoconduite ou détail de vitesse n’est importé par cette intégration.

=== Diagnostic QUARTIX ===

{| class="wikitable"
! Situation !! Vérification ou action
|-
| Le test de connexion échoue || Enregistrer tous les champs, notamment APPLICATION NAME. Relever l’étape et le statut HTTP affichés, sans diffuser les identifiants ni les réponses API brutes.
|-
| Les données n’arrivent pas || Vérifier l’association active, la synchronisation, la date d’installation, les droits du compte d’exécution et les quatre travaux planifiés. Une reprise historique demande plusieurs passages.
|-
| Les durées sont indisponibles || Faire confirmer leur unité auprès de QUARTIX puis la renseigner dans les réglages.
|-
| Le pictogramme de tracé manque || Vérifier le droit GPS, l’activation des tracés, la confidentialité du trajet et la durée de conservation.
|-
| La demande reste en attente || Vérifier le travail du journal et la synchronisation dans l’environnement propriétaire, ainsi que les délais de reprise.
|-
| La carte reste vide || Lire le message persistant : tracé absent/incomplet, session expirée, accès retiré ou fond de carte indisponible sont des situations différentes. Après mise à jour du module, recharger la page.
|-
| Les valeurs diffèrent de QUARTIX || Comparer le même véhicule, la même journée, le fuseau, le début de journée, la couverture et la date de synchronisation. Distinguer estimation kilométrique et relevé réel.
|}

==Questions fréquentes==

{| class="wikitable"
!Situation!!Vérification ou action
|-
|Un bouton n'apparaît pas||Vérifier les droits, l'état de l'objet et les dépendances dans Compatibilité.
|-
|Le dossier ne peut pas être généré||Vérifier l'activation du modèle, Factures fournisseurs, l'extension PHP ZIP et les droits sur le véhicule et les factures.
|-
|Le kilométrage d'une ligne ne peut pas être modifié||Si la source est une consommation, ouvrir et corriger le plein ou la recharge d'origine.
|-
|Une attestation n'est pas considérée comme validée||Vérifier son état, sa portée, sa période et son justificatif ; un brouillon doit encore être soumis au contrôle.
|-
|Une échéance manque||Vérifier les caractéristiques, les réponses de qualification et les dates nécessaires au calcul.
|-
|Les relances ne partent pas||Vérifier l'activation des rappels, les destinataires, les modèles d'emails, l'envoi d'emails Dolibarr et le dernier résultat des travaux planifiés.
|-
|Une dépense ne peut plus être corrigée||Vérifier son rapprochement bancaire ou son transfert comptable avant toute correction dans le parcours financier natif.
|-
|Des données d'une autre entité apparaissent||Vérifier la colonne Environnement et les partages autorisés dans Multicompany.
|}

==Mise à jour==

Avant toute mise à jour, sauvegarder la base de données et les documents de l'installation.

Après remplacement des fichiers du module, le désactiver puis le réactiver pour appliquer les migrations et enregistrer les déclarations natives nécessaires. Les réglages existants sont conservés.

Pour une mise à jour depuis une version de développement :

*consulter le fichier <code>ChangeLog.md</code> de la distribution ;
*vérifier les modèles documentaires et les travaux planifiés ;
*régénérer les dossiers existants pour bénéficier de leur présentation finale ;
*vérifier les paramètres bancaires avant d'activer la création d'opérations diverses ;
*pour QUARTIX, enregistrer les accès, confirmer unités et fuseaux, associer les véhicules et activer les quatre travaux décrits ci-dessus.

Les nouveaux libellés Agenda s'appliquent aux événements futurs. Les historiques et contrôles validés ne sont pas réécrits.

==Limites de la version 1.0.0==

*Les contrôles détaillés des extincteurs, appareils sous pression, accessoires de levage et fluides frigorigènes ne sont pas préconfigurés.
*La gestion dédiée des cartes grises, sinistres, primes, franchises et contraventions n'est pas couverte.
*La gestion commerciale des factures d'achat reste assurée par le module natif Factures fournisseurs.
*Les rappels périodiques nécessitent une configuration opérationnelle des travaux planifiés et de l'envoi d'emails Dolibarr.

*L’export des tracés QUARTIX, les scores d’écoconduite et la modification automatique des affectations ne sont pas proposés.

==Sources et liens utiles==

*[https://github.com/mapiolca/lmdbvehiclemanagement Code source du module]
*[https://github.com/mapiolca/lmdbvehiclemanagement/blob/094fc89/README.md Documentation initiale de la version 1.0.0]
*[https://github.com/mapiolca/lmdbvehiclemanagement/blob/094fc89/ChangeLog.md Historique de la version 1.0.0]
*[https://github.com/mapiolca Profil de l'auteur]

[[Category:Modules complémentaires]]
[[Category:DocUserFR]]

File:LMDBVehicleManagement-2026-09-quartix-utilisation.png

2026-09-07T09:11:36Z

Mapiolca: == Summary == Synthèse quotidienne QUARTIX : couverture des journées, distances et nombre de trajets. Les durées restent indisponibles tant que leur unité n’est pas confirmée. Capture réalisée le 7 septembre 2026 dans un environnement de démonstration Dolibarr 24, pour la notice QUARTIX du Module Gestion des véhicules. Auteur : Pierre Ardoin / Les Métiers du Bâtiment. Anonymisation locale sans modification de l’interface en dehors des zones floutées et du recadrage. Métadonnées supprim...

== Summary ==
Synthèse quotidienne QUARTIX : couverture des journées, distances et nombre de trajets. Les durées restent indisponibles tant que leur unité n’est pas confirmée.

Capture réalisée le 7 septembre 2026 dans un environnement de démonstration Dolibarr 24, pour la notice QUARTIX du [[Module Gestion des véhicules]].

Auteur : Pierre Ardoin / Les Métiers du Bâtiment.

Anonymisation locale sans modification de l’interface en dehors des zones floutées et du recadrage. Métadonnées supprimées.

File:LMDBVehicleManagement-2026-09-quartix-trajets-anonymise.png

2026-09-07T09:11:22Z

Mapiolca: == Summary == Journal QUARTIX avec filtres de période et états des trajets. Les adresses sont floutées. Capture réalisée le 7 septembre 2026 dans un environnement de démonstration Dolibarr 24, pour la notice QUARTIX du Module Gestion des véhicules. Auteur : Pierre Ardoin / Les Métiers du Bâtiment. Anonymisation locale sans modification de l’interface en dehors des zones floutées et du recadrage. Métadonnées supprimées.

== Summary ==
Journal QUARTIX avec filtres de période et états des trajets. Les adresses sont floutées.

Capture réalisée le 7 septembre 2026 dans un environnement de démonstration Dolibarr 24, pour la notice QUARTIX du [[Module Gestion des véhicules]].

Auteur : Pierre Ardoin / Les Métiers du Bâtiment.

Anonymisation locale sans modification de l’interface en dehors des zones floutées et du recadrage. Métadonnées supprimées.

File:LMDBVehicleManagement-2026-09-quartix-route-anonymise.png

2026-09-07T09:11:09Z

Mapiolca: == Summary == Tracé d’un trajet terminé dans la modale native, avec messages persistants. L’immatriculation et le fond de carte sont floutés pour protéger les lieux ; l’attribution cartographique est conservée. Capture réalisée le 7 septembre 2026 dans un environnement de démonstration Dolibarr 24, pour la notice QUARTIX du Module Gestion des véhicules. Auteur : Pierre Ardoin / Les Métiers du Bâtiment. Anonymisation locale sans modification de l’interface en dehors des zones floutées e...

== Summary ==
Tracé d’un trajet terminé dans la modale native, avec messages persistants. L’immatriculation et le fond de carte sont floutés pour protéger les lieux ; l’attribution cartographique est conservée.

Capture réalisée le 7 septembre 2026 dans un environnement de démonstration Dolibarr 24, pour la notice QUARTIX du [[Module Gestion des véhicules]].

Auteur : Pierre Ardoin / Les Métiers du Bâtiment.

Anonymisation locale sans modification de l’interface en dehors des zones floutées et du recadrage. Métadonnées supprimées.

File:LMDBVehicleManagement-2026-09-19-apercu-pdf-anonymise.png

2026-09-07T09:10:56Z

Mapiolca: == Summary == Aperçu du dossier véhicule PDF. Capture réalisée le 5 septembre 2026 dans un environnement de démonstration Dolibarr 24. Immatriculations floutées le 7 septembre 2026 pour la notice du Module Gestion des véhicules. Auteur : Pierre Ardoin / Les Métiers du Bâtiment. Anonymisation locale sans modification de l’interface en dehors des zones floutées et du recadrage. Métadonnées supprimées.

== Summary ==
Aperçu du dossier véhicule PDF.

Capture réalisée le 5 septembre 2026 dans un environnement de démonstration Dolibarr 24. Immatriculations floutées le 7 septembre 2026 pour la notice du [[Module Gestion des véhicules]].

Auteur : Pierre Ardoin / Les Métiers du Bâtiment.

Anonymisation locale sans modification de l’interface en dehors des zones floutées et du recadrage. Métadonnées supprimées.

File:LMDBVehicleManagement-2026-09-17-historique-anonymise.png

2026-09-07T09:10:44Z

Mapiolca: == Summary == Chronologie du véhicule. Capture réalisée le 5 septembre 2026 dans un environnement de démonstration Dolibarr 24. Immatriculations floutées le 7 septembre 2026 pour la notice du Module Gestion des véhicules. Auteur : Pierre Ardoin / Les Métiers du Bâtiment. Anonymisation locale sans modification de l’interface en dehors des zones floutées et du recadrage. Métadonnées supprimées.

== Summary ==
Chronologie du véhicule.

Capture réalisée le 5 septembre 2026 dans un environnement de démonstration Dolibarr 24. Immatriculations floutées le 7 septembre 2026 pour la notice du [[Module Gestion des véhicules]].

Auteur : Pierre Ardoin / Les Métiers du Bâtiment.

Anonymisation locale sans modification de l’interface en dehors des zones floutées et du recadrage. Métadonnées supprimées.

File:LMDBVehicleManagement-2026-09-15-modeles-anonymise.png

2026-09-07T09:10:32Z

Mapiolca: == Summary == Modèles de documents et de numérotation. Capture réalisée le 5 septembre 2026 dans un environnement de démonstration Dolibarr 24. Immatriculations floutées le 7 septembre 2026 pour la notice du Module Gestion des véhicules. Auteur : Pierre Ardoin / Les Métiers du Bâtiment. Anonymisation locale sans modification de l’interface en dehors des zones floutées et du recadrage. Métadonnées supprimées.

== Summary ==
Modèles de documents et de numérotation.

Capture réalisée le 5 septembre 2026 dans un environnement de démonstration Dolibarr 24. Immatriculations floutées le 7 septembre 2026 pour la notice du [[Module Gestion des véhicules]].

Auteur : Pierre Ardoin / Les Métiers du Bâtiment.

Anonymisation locale sans modification de l’interface en dehors des zones floutées et du recadrage. Métadonnées supprimées.

File:LMDBVehicleManagement-2026-09-13-intervention-facture-anonymise.png

2026-09-07T09:10:20Z

Mapiolca: == Summary == Intervention et facture fournisseur. Capture réalisée le 5 septembre 2026 dans un environnement de démonstration Dolibarr 24. Immatriculations floutées le 7 septembre 2026 pour la notice du Module Gestion des véhicules. Auteur : Pierre Ardoin / Les Métiers du Bâtiment. Anonymisation locale sans modification de l’interface en dehors des zones floutées et du recadrage. Métadonnées supprimées.

== Summary ==
Intervention et facture fournisseur.

Capture réalisée le 5 septembre 2026 dans un environnement de démonstration Dolibarr 24. Immatriculations floutées le 7 septembre 2026 pour la notice du [[Module Gestion des véhicules]].

Auteur : Pierre Ardoin / Les Métiers du Bâtiment.

Anonymisation locale sans modification de l’interface en dehors des zones floutées et du recadrage. Métadonnées supprimées.

File:LMDBVehicleManagement-2026-09-11-assurance-anonymise.png

2026-09-07T09:10:07Z

Mapiolca: == Summary == Contrat d’assurance. Capture réalisée le 5 septembre 2026 dans un environnement de démonstration Dolibarr 24. Immatriculations floutées le 7 septembre 2026 pour la notice du Module Gestion des véhicules. Auteur : Pierre Ardoin / Les Métiers du Bâtiment. Anonymisation locale sans modification de l’interface en dehors des zones floutées et du recadrage. Métadonnées supprimées.

== Summary ==
Contrat d’assurance.

Capture réalisée le 5 septembre 2026 dans un environnement de démonstration Dolibarr 24. Immatriculations floutées le 7 septembre 2026 pour la notice du [[Module Gestion des véhicules]].

Auteur : Pierre Ardoin / Les Métiers du Bâtiment.

Anonymisation locale sans modification de l’interface en dehors des zones floutées et du recadrage. Métadonnées supprimées.

File:LMDBVehicleManagement-2026-09-10-controle-anonymise.png

2026-09-07T09:09:57Z

Mapiolca: == Summary == Saisie d’un contrôle. Capture réalisée le 5 septembre 2026 dans un environnement de démonstration Dolibarr 24. Immatriculations floutées le 7 septembre 2026 pour la notice du Module Gestion des véhicules. Auteur : Pierre Ardoin / Les Métiers du Bâtiment. Anonymisation locale sans modification de l’interface en dehors des zones floutées et du recadrage. Métadonnées supprimées.

== Summary ==
Saisie d’un contrôle.

Capture réalisée le 5 septembre 2026 dans un environnement de démonstration Dolibarr 24. Immatriculations floutées le 7 septembre 2026 pour la notice du [[Module Gestion des véhicules]].

Auteur : Pierre Ardoin / Les Métiers du Bâtiment.

Anonymisation locale sans modification de l’interface en dehors des zones floutées et du recadrage. Métadonnées supprimées.

File:LMDBVehicleManagement-2026-09-09-qualification-anonymise.png

2026-09-07T09:09:41Z

Mapiolca: == Summary == Qualification réglementaire. Capture réalisée le 5 septembre 2026 dans un environnement de démonstration Dolibarr 24. Immatriculations floutées le 7 septembre 2026 pour la notice du Module Gestion des véhicules. Auteur : Pierre Ardoin / Les Métiers du Bâtiment. Anonymisation locale sans modification de l’interface en dehors des zones floutées et du recadrage. Métadonnées supprimées.

== Summary ==
Qualification réglementaire.

Capture réalisée le 5 septembre 2026 dans un environnement de démonstration Dolibarr 24. Immatriculations floutées le 7 septembre 2026 pour la notice du [[Module Gestion des véhicules]].

Auteur : Pierre Ardoin / Les Métiers du Bâtiment.

Anonymisation locale sans modification de l’interface en dehors des zones floutées et du recadrage. Métadonnées supprimées.

File:LMDBVehicleManagement-2026-09-08-echeancier-anonymise.png

2026-09-07T09:09:29Z

Mapiolca: == Summary == Échéancier des contrôles. Capture réalisée le 5 septembre 2026 dans un environnement de démonstration Dolibarr 24. Immatriculations floutées le 7 septembre 2026 pour la notice du Module Gestion des véhicules. Auteur : Pierre Ardoin / Les Métiers du Bâtiment. Anonymisation locale sans modification de l’interface en dehors des zones floutées et du recadrage. Métadonnées supprimées.

== Summary ==
Échéancier des contrôles.

Capture réalisée le 5 septembre 2026 dans un environnement de démonstration Dolibarr 24. Immatriculations floutées le 7 septembre 2026 pour la notice du [[Module Gestion des véhicules]].

Auteur : Pierre Ardoin / Les Métiers du Bâtiment.

Anonymisation locale sans modification de l’interface en dehors des zones floutées et du recadrage. Métadonnées supprimées.

File:LMDBVehicleManagement-2026-09-07-synthese-anonymise.png

2026-09-07T09:09:16Z

Mapiolca: == Summary == Synthèse des consommations. Capture réalisée le 5 septembre 2026 dans un environnement de démonstration Dolibarr 24. Immatriculations floutées le 7 septembre 2026 pour la notice du Module Gestion des véhicules. Auteur : Pierre Ardoin / Les Métiers du Bâtiment. Anonymisation locale sans modification de l’interface en dehors des zones floutées et du recadrage. Métadonnées supprimées.

== Summary ==
Synthèse des consommations.

Capture réalisée le 5 septembre 2026 dans un environnement de démonstration Dolibarr 24. Immatriculations floutées le 7 septembre 2026 pour la notice du [[Module Gestion des véhicules]].

Auteur : Pierre Ardoin / Les Métiers du Bâtiment.

Anonymisation locale sans modification de l’interface en dehors des zones floutées et du recadrage. Métadonnées supprimées.

File:LMDBVehicleManagement-2026-09-05-kilometrage-anonymise.png

2026-09-07T09:09:03Z

Mapiolca: == Summary == Relevés kilométriques. Capture réalisée le 5 septembre 2026 dans un environnement de démonstration Dolibarr 24. Immatriculations floutées le 7 septembre 2026 pour la notice du Module Gestion des véhicules. Auteur : Pierre Ardoin / Les Métiers du Bâtiment. Anonymisation locale sans modification de l’interface en dehors des zones floutées et du recadrage. Métadonnées supprimées.

== Summary ==
Relevés kilométriques.

Capture réalisée le 5 septembre 2026 dans un environnement de démonstration Dolibarr 24. Immatriculations floutées le 7 septembre 2026 pour la notice du [[Module Gestion des véhicules]].

Auteur : Pierre Ardoin / Les Métiers du Bâtiment.

Anonymisation locale sans modification de l’interface en dehors des zones floutées et du recadrage. Métadonnées supprimées.

File:LMDBVehicleManagement-2026-09-04-affectations-anonymise.png

2026-09-07T09:08:48Z

Mapiolca: == Summary == Affectations des conducteurs. Capture réalisée le 5 septembre 2026 dans un environnement de démonstration Dolibarr 24. Immatriculations floutées le 7 septembre 2026 pour la notice du Module Gestion des véhicules. Auteur : Pierre Ardoin / Les Métiers du Bâtiment. Anonymisation locale sans modification de l’interface en dehors des zones floutées et du recadrage. Métadonnées supprimées.

== Summary ==
Affectations des conducteurs.

Capture réalisée le 5 septembre 2026 dans un environnement de démonstration Dolibarr 24. Immatriculations floutées le 7 septembre 2026 pour la notice du [[Module Gestion des véhicules]].

Auteur : Pierre Ardoin / Les Métiers du Bâtiment.

Anonymisation locale sans modification de l’interface en dehors des zones floutées et du recadrage. Métadonnées supprimées.

File:LMDBVehicleManagement-2026-09-02-fiche-anonymise.png

2026-09-07T09:08:35Z

Mapiolca: == Summary == Fiche véhicule. Capture réalisée le 5 septembre 2026 dans un environnement de démonstration Dolibarr 24. Immatriculations floutées le 7 septembre 2026 pour la notice du Module Gestion des véhicules. Auteur : Pierre Ardoin / Les Métiers du Bâtiment. Anonymisation locale sans modification de l’interface en dehors des zones floutées et du recadrage. Métadonnées supprimées.

== Summary ==
Fiche véhicule.

Capture réalisée le 5 septembre 2026 dans un environnement de démonstration Dolibarr 24. Immatriculations floutées le 7 septembre 2026 pour la notice du [[Module Gestion des véhicules]].

Auteur : Pierre Ardoin / Les Métiers du Bâtiment.

Anonymisation locale sans modification de l’interface en dehors des zones floutées et du recadrage. Métadonnées supprimées.

File:LMDBVehicleManagement-2026-09-01-liste-anonymise.png

2026-09-07T09:07:29Z

Mapiolca: == Summary == Liste des véhicules. Capture réalisée le 5 septembre 2026 dans un environnement de démonstration Dolibarr 24. Immatriculations floutées le 7 septembre 2026 pour la notice du Module Gestion des véhicules. Auteur : Pierre Ardoin / Les Métiers du Bâtiment. Anonymisation locale sans modification de l’interface en dehors des zones floutées et du recadrage. Métadonnées supprimées.

== Summary ==
Liste des véhicules.

Capture réalisée le 5 septembre 2026 dans un environnement de démonstration Dolibarr 24. Immatriculations floutées le 7 septembre 2026 pour la notice du [[Module Gestion des véhicules]].

Auteur : Pierre Ardoin / Les Métiers du Bâtiment.

Anonymisation locale sans modification de l’interface en dehors des zones floutées et du recadrage. Métadonnées supprimées.

Module Gestion des véhicules

2026-09-05T11:20:11Z

Mapiolca: Présentation et guide d'utilisation du module Gestion des véhicules

'''Gestion des véhicules et engins''' est un module externe pour Dolibarr permettant de centraliser le suivi d'un parc de véhicules routiers, d'utilitaires et d'engins. Il regroupe les caractéristiques du matériel, les affectations des conducteurs, les kilométrages, les consommations, les interventions, les assurances et les contrôles réglementaires.

Le module permet également de relier les factures fournisseurs aux interventions et aux contrôles, puis de générer un dossier véhicule réunissant un récapitulatif PDF et une archive des documents associés.

Cette page comprend la présentation du module, son installation et sa '''notice d'utilisation illustrée'''. Les captures ont été réalisées le 5 septembre 2026 sur une instance de démonstration Dolibarr 24 avec Multicompany. Les valeurs affichées servent uniquement d'exemples ; elles ne constituent ni des réglages recommandés ni des références de consommation. Le thème et la version de Dolibarr peuvent faire varier la présentation.

__TOC__

==Informations==

{| class="wikitable"
!Information!!Valeur
|-
|Nom||Gestion des véhicules et engins
|-
|Identifiant technique||<code>lmdbvehiclemanagement</code>
|-
|Auteur||Pierre Ardoin
|-
|Famille||Les Métiers du Bâtiment
|-
|Version présentée||1.0.0 — première version stable du 4 septembre 2026
|-
|Dolibarr minimum||20.0
|-
|PHP minimum||8.0
|-
|Base de données||MySQL ou MariaDB
|-
|Langues fournies||Français et anglais
|-
|Multicompany||Compatible ; module Multicompany facultatif
|-
|Licence||GNU GPL version 3 ou ultérieure
|}

==Fonctionnalités==

===Gestion du parc===

*Fiches pour les véhicules routiers, utilitaires et engins, avec immatriculation facultative.
*Caractéristiques techniques, énergie, capacités et autonomie WLTP.
*Suivi du cycle de vie, du brouillon à la cession.
*Affectations des conducteurs, avec plusieurs affectations simultanées possibles et une seule affectation principale par période.
*Relevés kilométriques et prise en charge des corrections ou remplacements de compteur.
*Événements d'entretien, pannes et incidents.
*Chronologie regroupant événements, contrôles et consommations.
*Modèles de numérotation, dont un modèle fondé sur l'immatriculation.

Les listes proposent des filtres, le tri, la pagination et des colonnes personnalisables. Les fiches utilisent les notes, contacts, fichiers joints et objets liés de Dolibarr selon les fonctions concernées.

===Pleins, recharges et consommations===

Le module suit les carburants, les recharges électriques, l'hydrogène et les additifs. Les consommables sont associés à leurs unités et aux énergies compatibles. Les capacités du véhicule permettent de signaler un dépassement lors de la saisie.

*Synchronisation des consommations avec les relevés kilométriques.
*Synthèses par véhicule, consommable et unité.
*Statistiques de coûts, distances et consommations, avec graphiques Dolibarr.
*Import CSV et export natif.
*Prix facultatif pour les additifs : un montant absent est distingué d'un montant égal à zéro et n'entre pas dans les statistiques de prix.

Une option par entité permet de créer une '''opération diverse''' native pour un plein ou une recharge. Elle nécessite un compte bancaire, les informations de règlement et un justificatif PDF, JPEG ou PNG. Les métadonnées des images justificatives sont nettoyées.

La comptabilité reste facultative. En comptabilité en partie double, un compte général du plan actif est requis. Les données financières et le justificatif sont verrouillés après rapprochement bancaire ou transfert comptable.

'''Lorsque la création d'opérations diverses est activée, l'import CSV des consommations est indisponible.''' L'activation de cette option ne crée pas d'opérations pour les consommations historiques.

===Assurances===

*Contrats individuels ou contrats de flotte couvrant plusieurs véhicules.
*Couverture principale et couvertures complémentaires.
*Contacts de l'assureur et du courtier.
*Attestations communes ou propres à un véhicule, avec justificatifs, validation, rejet et archivage.
*Référents utilisateurs ou groupes et personnels affectés éligibles.
*Relances avant et après échéance, avec modèles d'emails et travaux planifiés natifs.

===Contrôles réglementaires===

Un questionnaire guidé permet de qualifier les véhicules et engins et de déterminer les exigences applicables à partir des informations enregistrées.

La version 1.0.0 fournit un catalogue français versionné couvrant notamment les contrôles routiers, la pollution, la catégorie L, les usages spécialisés, les vérifications générales périodiques (VGP), la mise ou remise en service, le tachygraphe, l'ADR et l'ATP. Des surcharges par entité et des règles personnalisées complètent le catalogue.

*Contrôles numérotés avec organisme, résultat, dates et justificatif obligatoire.
*Validation immuable, annulation motivée, remplacement, contre-visite et archivage encadré.
*Échéancier et registre de sécurité.
*Export et import de contrôles en brouillon.
*Blocage configurable des nouvelles affectations et mises en service.
*Recalcul quotidien et rappels par travail planifié, avec événement Agenda unique par exigence.

Lorsqu'une information indispensable manque, le module ne calcule pas d'échéance arbitraire. Il constitue une aide au suivi documentaire : il ne réalise pas les contrôles et ne délivre aucun rapport officiel.

===Factures fournisseurs liées===

Depuis un événement ou un contrôle, l'action '''Créer une facture fournisseur''' ouvre le formulaire natif Dolibarr. Le fournisseur de l'intervention est proposé lorsqu'il est renseigné et accessible ; il peut être modifié. La facture est créée en brouillon et liée à l'objet d'origine.

Il est également possible de sélectionner une facture existante ou d'utiliser l'action '''Lier à''' depuis une facture fournisseur. Les relations sont visibles dans les blocs '''Objets liés''' des deux fiches. Plusieurs factures peuvent être associées à une même intervention.

Une déliaison retire uniquement la relation. Elle ne supprime pas la facture et ne modifie pas les données réglementaires d'un contrôle validé. Les objets liés doivent appartenir à l'entité courante et les droits requis sur chacun d'eux restent nécessaires.

===Dossier véhicule PDF et ZIP===

Le modèle '''Dossier véhicule''' produit deux fichiers :

*un '''PDF''' regroupant les caractéristiques du véhicule, la chronologie disponible, les événements, les contrôles, les factures liées, une synthèse des pleins et recharges et l'inventaire documentaire ;
*un '''ZIP''' contenant ce PDF et les fichiers originaux du véhicule, des événements, des contrôles et des factures liées.

Les brouillons, annulations et archives sont inclus. Une facture liée à plusieurs interventions n'est embarquée qu'une fois. Les fichiers indexés mais absents sont signalés dans le PDF.

Les justificatifs des consommations et de leurs opérations diverses, les fichiers temporaires, les aperçus et les dossiers précédents sont exclus de l'archive. Le tableau de synthèse des consommations présente les dates, kilométrages, références, consommables, natures, unités et références d'huile ; il ne présente ni les quantités ni les montants.

La génération utilise les données et documents déjà disponibles : elle ne génère pas les documents commerciaux des factures et ne reconstitue pas un historique non enregistré.

La génération nécessite les droits de lecture et d'écriture du véhicule ainsi que la lecture des factures fournisseurs. La consultation du dossier nécessite les droits cumulés de lecture correspondants. Le dossier n'est pas accessible aux utilisateurs externes ni par lien public.

===Gestion multientité===

Avec Multicompany, les objets partageables sont configurables dans les réglages natifs de partage. Les listes concernées affichent un filtre et une colonne '''Environnement'''.

Les documents restent stockés dans l'entité propriétaire de l'objet, y compris lorsqu'il est consulté depuis une autre entité autorisée. Les réglages par entité, modèles et choix de partage sont conservés lors d'une désactivation puis réactivation du module.

==Prérequis et dépendances==

Le socle requis est Dolibarr 20 ou supérieur, PHP 8.0 ou supérieur et MySQL/MariaDB. Les dépendances supplémentaires varient selon les fonctions utilisées.

{| class="wikitable"
!Module ou extension!!Utilisation
|-
|Agenda||Échéances et événements ; recommandé pour le suivi automatique.
|-
|Travaux planifiés||Exécution périodique des recalculs et relances.
|-
|Banques et Caisses||Requis pour créer les opérations diverses des consommations.
|-
|Comptabilité||Facultative ; règles de compte adaptées au mode comptable actif.
|-
|Factures fournisseurs||Requis pour les liaisons de factures et les dossiers véhicule.
|-
|Extension PHP ZIP (<code>ZipArchive</code>)||Requise pour générer le dossier PDF/ZIP.
|-
|Multicompany||Facultatif ; partage et gestion de plusieurs entités.
|-
|Ressources||Facultatif ; liaison à une ressource Dolibarr.
|}

L'onglet '''Compatibilité''' des réglages indique les dépendances et fonctionnalités disponibles dans l'environnement courant.

==Installation==

#Récupérer une distribution du module correspondant à la version 1.0.0.
#Placer le répertoire <code>lmdbvehiclemanagement</code> dans le répertoire des modules externes de l'installation Dolibarr. Les fichiers du module doivent se trouver directement dans ce répertoire, sans second répertoire imbriqué du même nom.
#Se connecter à Dolibarr avec un compte administrateur.
#Ouvrir '''Accueil → Configuration → Modules/Applications'''.
#Rechercher et activer '''Gestion des véhicules et engins''', dans la famille '''Les Métiers du Bâtiment'''.
#Ouvrir les réglages avec la roue dentée du module et consulter l'onglet '''Compatibilité'''.
#Attribuer aux utilisateurs et groupes les permissions correspondant à leurs fonctions.

Si une archive de déploiement Dolibarr est fournie, elle peut être installée depuis l'écran natif de déploiement des modules externes.

==Configuration initiale==

#Vérifier les dictionnaires utiles au parc : énergies, consommables, types de matériel, profils, types et résultats de contrôles.
#Choisir les modèles de numérotation des objets.
#Configurer les options d'assurance, les référents et les modèles d'emails de relance.
#Vérifier les règles réglementaires et les options de blocage souhaitées.
#Dans les '''Travaux planifiés''' de Dolibarr, vérifier et activer les traitements nécessaires aux recalculs et aux rappels automatiques.
#Si les opérations diverses sont utilisées, configurer cette option et ses paramètres bancaires dans chaque entité concernée.
#Pour les dossiers véhicule, activer '''Dossier véhicule''' dans le bloc '''Modèles de document''' et, si souhaité, le choisir comme modèle par défaut.
#En environnement Multicompany, configurer les partages et les permissions d'accès aux entités.

Les onglets '''Compatibilité''' et '''À propos''' sont accessibles depuis les réglages du module.

===Choisir la numérotation et activer le dossier véhicule===

#Ouvrir l'onglet '''Paramètres''' des réglages.
#Dans '''Modèles de documents''', activer la ligne '''Dossier véhicule'''. La colonne '''Défaut''' permet de le proposer automatiquement lors de la génération.
#Dans '''Modèles de numérotation''', choisir le modèle de chaque objet.
#Pour les véhicules, choisir '''standard''' pour une référence séquentielle ou '''registration''' pour utiliser l'immatriculation normalisée. Un matériel sans immatriculation reçoit une référence de type MAT avec ce dernier modèle.

Les exemples de référence permettent de vérifier le résultat attendu. Sur un parc existant, un changement impliquant la reprise des références doit suivre la procédure de migration proposée par le module.

[[File:LMDBVehicleManagement-1.0.0-15-modeles.jpg|thumb|center|1100px|Réglages des modèles documentaires et de la numérotation. Le dossier est activé ; le choix du modèle par défaut est distinct.]]

===Configurer les dépenses des pleins et recharges===

Dans '''Paramètres''', le bloc '''Tickets et opérations diverses des pleins / recharges''' permet d'activer la création d'une dépense native.

#Choisir le compte bancaire de l'entité et le mode de règlement habituel.
#Renseigner les comptes comptables selon le mode de comptabilité utilisé. Le compte général est obligatoire en partie double ; le compte auxiliaire reste facultatif.
#Activer l'option souhaitée et cliquer sur '''Enregistrer'''.
#Vérifier ensuite la saisie d'un plein : les informations de règlement et le ticket sont demandés lorsque cette option est active.

Cette option concerne les nouvelles opérations. Elle ne transforme pas les anciennes consommations en dépenses et rend leur import CSV indisponible.

===Configurer les relances d'assurance===

#Ouvrir l'onglet '''Assurance''' des réglages.
#Choisir les utilisateurs et/ou groupes référents.
#Indiquer si les personnels affectés doivent être inclus, puis sélectionner les types d'affectation concernés.
#Sélectionner les seuils avant expiration et les délais de répétition après expiration ou absence de justificatif.
#Choisir les modèles d'emails de dépôt et de contrôle.
#Activer les relances et cliquer sur '''Enregistrer'''.
#Utiliser le lien '''Ouvrir les travaux planifiés''' pour vérifier l'état de la tâche et son dernier résultat.

Le bouton '''Envoyer un email de test''' déclenche un envoi réel : vérifier les destinataires avant de l'utiliser. Les délais visibles sur l'illustration sont ceux de l'environnement de démonstration.

[[File:LMDBVehicleManagement-1.0.0-16-relances-assurance.jpg|thumb|center|1100px|Choix des référents, seuils de relance, modèles d'emails et accès au travail planifié d'assurance.]]

===Configurer les rappels des contrôles===

Dans l'onglet '''Contrôles réglementaires''' des réglages :

#Choisir les horizons de rappel et le délai d'affichage « à échéance prochaine ».
#Sélectionner les utilisateurs ou groupes destinataires et préciser si le conducteur affecté doit être inclus.
#Choisir le modèle de rappel et, si nécessaire, activer les rappels journaliers après échéance.
#Enregistrer les réglages puis vérifier le travail planifié de recalcul et de rappel.

Le catalogue distingue les règles natives des adaptations propres à l'entité. Les surcharges et règles personnalisées doivent correspondre au matériel réellement exploité et conserver leur justification.

==Notice — premiers pas==

===Accéder au parc et retrouver une fiche===

Ouvrir le menu '''Gestion des véhicules et engins''' repéré par une icône de voiture. Le menu latéral regroupe le parc, les événements, les contrôles, la consommation et les contrats d'assurance.

#Cliquer sur '''Liste des véhicules et engins'''.
#Saisir un critère dans les filtres de référence, immatriculation, libellé, modèle ou état.
#Cliquer sur la loupe pour rechercher ; la croix réinitialise les filtres.
#Cliquer sur un en-tête de colonne pour trier, ou sur le sélecteur de colonnes pour adapter la liste.
#Ouvrir le véhicule en cliquant sur sa référence.

Le sélecteur de limite règle le nombre de lignes par page. Lorsqu'un partage multientité est actif, la colonne et le filtre '''Environnement''' permettent d'identifier l'entité d'origine.

[[File:LMDBVehicleManagement-1.0.0-01-liste.jpg|thumb|center|1100px|Accès aux rubriques du module et recherche dans le parc de démonstration.]]

===Créer un véhicule ou un engin===

#Cliquer sur '''Nouveau véhicule ou engin'''.
#Renseigner un '''Libellé''' explicite et l'immatriculation si le matériel en possède une.
#Choisir le '''Type principal de matériel''', puis compléter les caractéristiques connues : catégorie, genre, masses, nombre de places, territoire, numéro de série, marque et modèle.
#Choisir l'énergie et renseigner l'autonomie lorsqu'elle est connue.
#Compléter les dates de construction, première immatriculation et mise en service selon les informations disponibles.
#Choisir le mode de détention et le propriétaire. La liaison à une ressource Dolibarr est facultative.
#Compléter la description et cliquer sur '''Enregistrer''' en bas du formulaire.

La fiche est créée en brouillon. La référence suit le modèle de numérotation configuré ; il n'est pas nécessaire de fabriquer un identifiant manuellement. Compléter ensuite les capacités des consommables utiles au véhicule depuis sa fiche en modification.

[[File:LMDBVehicleManagement-1.0.0-03-creation.jpg|thumb|center|1100px|Partie supérieure du formulaire de création : identification, caractéristiques techniques et dates.]]

===Lire la fiche et son état===

La fiche présente la référence, le libellé et un badge d'état, puis les caractéristiques techniques et la couverture d'assurance disponible. Les onglets donnent accès aux notes, documents, événements, affectations, kilométrages, consommations, contrôles et historique selon les droits.

[[File:LMDBVehicleManagement-1.0.0-02-fiche.jpg|thumb|center|1100px|Extrait de la fiche d'un véhicule en service : caractéristiques, capacités et résumé d'assurance.]]

{| class="wikitable"
!État!!Utilisation
|-
|Brouillon||Préparer et vérifier la fiche avant validation.
|-
|Validé||Véhicule identifié et validé, avant sa mise en service.
|-
|En service||Matériel utilisé dans le parc.
|-
|Hors service||Matériel retiré de l'exploitation.
|-
|Cédé / vendu||Matériel sorti du parc à la suite d'une cession.
|}

Utiliser les actions proposées sur la fiche, notamment '''Valider''', '''Mettre en service''', '''Mettre hors service''' ou '''Céder / vendre''', selon l'état courant et les permissions. Les règles réglementaires peuvent empêcher une mise en service. Une sortie de parc doit être enregistrée par le changement d'état approprié afin de conserver son historique ; la suppression répond à un autre besoin.

==Notice — utilisation quotidienne==

===Affecter un conducteur===

#Ouvrir l'onglet '''Affectations''' du véhicule.
#Cliquer sur '''Ajouter une affectation'''.
#Sélectionner le conducteur et renseigner la date et l'heure de début.
#Renseigner une fin lorsqu'elle est connue, puis le type d'affectation.
#Préciser s'il s'agit de l'affectation principale, choisir son état et compléter le motif utile.
#Cliquer sur '''Enregistrer'''.

Plusieurs affectations peuvent coexister, mais une seule peut être principale sur une même période. Pour terminer une affectation, ouvrir sa modification avec le crayon et renseigner sa fin et son état. Vérifier le résultat dans le tableau.

[[File:LMDBVehicleManagement-1.0.0-04-affectations.jpg|thumb|center|1100px|Liste des affectations : conducteur, période, type, caractère principal et état.]]

===Ajouter ou corriger un relevé kilométrique===

#Ouvrir l'onglet '''Kilométrage''' et cliquer sur '''Ajouter un relevé'''.
#Renseigner la date du relevé et la valeur constatée au compteur.
#Choisir la nature du relevé. Pour une correction ou un remplacement de compteur, compléter le motif correspondant.
#Enregistrer, puis vérifier l'ordre chronologique et la différence avec les autres relevés.

'''Un relevé créé par un plein ou une recharge se corrige depuis la fiche de cette consommation.''' L'icône d'information de la ligne le rappelle. Éviter d'ajouter un second relevé manuel pour corriger la même opération.

[[File:LMDBVehicleManagement-1.0.0-05-kilometrage.jpg|thumb|center|1100px|Relevés kilométriques avec date, différence et source. Les lignes issues des consommations sont gérées depuis leur fiche d'origine.]]

===Enregistrer un plein, une recharge ou un additif===

#Cliquer sur '''Nouveau plein / recharge''' dans le menu latéral.
#Renseigner la date et l'heure, puis sélectionner le véhicule.
#Choisir la '''Nature''' et le carburant, la recharge ou l'additif correspondant. Compléter la référence d'huile lorsqu'elle est demandée.
#Vérifier le conducteur, saisir la quantité dans l'unité proposée et le kilométrage du compteur.
#Saisir le '''Total TTC'''. Pour un additif dont le prix est inconnu, laisser le montant vide ; zéro signifie un prix connu égal à zéro.
#Choisir le projet si nécessaire. Lorsque les opérations diverses sont actives, vérifier le règlement et joindre le ticket PDF, JPEG ou PNG.
#Conserver un relevé standard pour une saisie ordinaire ; justifier une correction ou un remplacement de compteur si c'est le cas.
#Cliquer sur '''Enregistrer''' et vérifier la fiche obtenue.

Un avertissement de dépassement de capacité invite à vérifier la quantité, l'unité, le véhicule et sa capacité configurée. Les champs financiers et le ticket ne sont plus librement modifiables après rapprochement bancaire ou transfert comptable.

[[File:LMDBVehicleManagement-1.0.0-06-plein.jpg|thumb|center|1100px|Formulaire de plein ou recharge avec ticket de caisse et règlement, lorsque les opérations diverses sont activées.]]

===Consulter les consommations et statistiques===

#Cliquer sur '''Consommation''' pour ouvrir la synthèse globale, ou sur l'onglet '''Consommation''' d'un véhicule pour son suivi individuel.
#Définir la période et, selon le besoin, filtrer par véhicule, conducteur, consommable ou nature.
#Lancer la recherche avec la loupe.
#Lire les passages, quantités, coûts, moyennes et pics par consommable et unité.
#Consulter les courbes puis ouvrir '''Liste des pleins / recharges''' pour retrouver les saisies à l'origine d'une valeur.

Les unités restent distinctes : litres, kWh et kilogrammes ne s'additionnent pas. La colonne '''Intervalles exclus''' aide à repérer les intervalles non retenus dans les calculs. Les données de démonstration peuvent produire des pics volontairement atypiques ; elles n'illustrent pas la consommation normale du véhicule.

[[File:LMDBVehicleManagement-1.0.0-07-synthese.jpg|thumb|center|1100px|Synthèse filtrable et premiers graphiques : les valeurs affichées proviennent d'un jeu de données de test.]]

===Enregistrer une intervention, une panne ou un incident===

#Depuis la fiche du véhicule, cliquer sur '''Nouvel événement véhicule'''.
#Renseigner le libellé, le type d'événement, sa date et les informations utiles sur le conducteur et le tiers intervenant.
#Préciser la gravité, le kilométrage et, si nécessaire, l'immobilisation et sa période.
#Décrire l'intervention puis enregistrer.
#Ajouter les justificatifs dans les fichiers joints de l'événement.

Le menu '''Événements véhicule''' permet de retrouver les interventions de l'ensemble du parc. L'historique du véhicule les regroupe avec ses autres opérations.

===Associer la facture d'une intervention===

Sur la fiche de l'événement ou du contrôle, deux parcours sont disponibles :

*'''Créer une facture fournisseur''' ouvre le formulaire natif. Vérifier le fournisseur, compléter la facture puis enregistrer : le brouillon est lié à l'intervention.
*'''Lier une facture fournisseur existante''' permet de sélectionner une facture puis de cliquer sur '''Lier'''.

Vérifier ensuite la ligne dans '''Objets liés'''. Le lien de référence ouvre la facture. L'action de déliaison retire seulement l'association ; elle ne supprime ni la facture ni l'intervention.

[[File:LMDBVehicleManagement-1.0.0-13-intervention-facture.jpg|thumb|center|1100px|Fiche d'entretien et actions de création ou de liaison d'une facture fournisseur ; la relation existante apparaît dans Objets liés.]]

==Notice — assurances et attestations==

===Créer un contrat et couvrir des véhicules===

#Cliquer sur '''Nouveau contrat''' dans la rubrique '''Contrats d'assurance'''.
#Sélectionner l'assureur, puis le contact ou courtier si nécessaire.
#Renseigner le numéro de police, le libellé, les garanties et la période du contrat.
#Préciser le renouvellement et la date de préavis connue. Ajouter les coordonnées d'assistance utiles.
#Sélectionner le ou les véhicules couverts, le type de couverture et sa période.
#Cliquer sur '''Enregistrer''', puis vérifier les véhicules rattachés dans la fiche du contrat.

Une couverture peut être principale ou complémentaire. Un contrat de flotte permet de regrouper plusieurs véhicules dans la même police.

[[File:LMDBVehicleManagement-1.0.0-18-creation-assurance.jpg|thumb|center|1100px|Extrait du formulaire de contrat : assureur, police, période et rattachement des véhicules.]]

[[File:LMDBVehicleManagement-1.0.0-11-assurance.jpg|thumb|center|1100px|Contrat d'assurance enregistré et véhicule couvert, avec type et période de couverture.]]

===Déposer et faire contrôler une attestation===

#Ouvrir le contrat depuis '''Liste des contrats'''.
#Choisir l'onglet '''Attestations d'assurance'''.
#Dans '''Nouvelle attestation d'assurance''', choisir la portée : flotte couverte ou véhicule concerné selon les choix proposés.
#Renseigner la période et sélectionner le justificatif.
#Cliquer sur '''Enregistrer le brouillon''' pour poursuivre la préparation, ou '''Soumettre au contrôle''' lorsque le dossier est prêt.
#L'utilisateur habilité vérifie le justificatif et sa période, puis valide l'attestation ou la rejette avec un motif.
#Lors d'un renouvellement, enregistrer la nouvelle attestation et utiliser l'archivage prévu pour conserver la traçabilité de l'ancienne.

Le tableau affiche la portée, les dates, le justificatif téléchargeable et l'état. Un brouillon ne remplace pas une attestation contrôlée et validée.

[[File:LMDBVehicleManagement-1.0.0-12-attestations.jpg|thumb|center|1100px|Attestation validée et formulaire de dépôt : enregistrement provisoire et soumission au contrôle sont deux actions distinctes.]]

==Notice — contrôles réglementaires==

===Qualifier le véhicule===

#Ouvrir l'onglet '''Contrôles réglementaires''' de la fiche véhicule.
#Lire chaque question de '''Qualification réglementaire''' et sélectionner la réponse correspondant à l'usage réel.
#Renseigner les dates d'applicabilité lorsqu'elles sont nécessaires.
#Cliquer sur '''Enregistrer la qualification'''.
#Examiner les '''Exigences réglementaires''' calculées : qualification, dernier contrôle, date calculée, date retenue et état.

Pour un équipement de levage, l'intervalle de VGP doit être choisi après qualification technique. Le formulaire ne doit pas servir à deviner une périodicité. Une information manquante doit être complétée à partir des documents du matériel.

[[File:LMDBVehicleManagement-1.0.0-09-qualification.jpg|thumb|center|1100px|Extrait du questionnaire de qualification, à compléter selon les caractéristiques et l'usage du matériel.]]

===Lire l'échéancier===

#Ouvrir '''Échéancier des contrôles''' dans le menu latéral.
#Filtrer la période, le véhicule, le type de matériel, le profil, le contrôle ou l'état.
#Trier les échéances par '''Date retenue''' pour préparer les interventions.
#Ouvrir le véhicule concerné pour retrouver le détail de l'exigence.

Les badges permettent de distinguer notamment une exigence '''À jour''' d'une exigence '''Échue'''. La date retenue est celle utilisée pour le suivi de l'exigence ; elle doit être lue avec la qualification et les documents correspondants.

[[File:LMDBVehicleManagement-1.0.0-08-echeancier.jpg|thumb|center|1100px|Échéancier du parc de démonstration, avec dates retenues et états des exigences.]]

===Enregistrer et valider un contrôle===

#Depuis l'exigence du véhicule, cliquer sur '''Enregistrer un contrôle''' pour reprendre le véhicule et l'exigence. Le menu '''Nouveau contrôle''' permet aussi une création directe.
#Vérifier le véhicule, l'exigence et la nature du contrôle.
#Renseigner la date, l'organisme, la référence du procès-verbal et le résultat.
#Saisir la date de validité officielle. Si une autre date effective est retenue, renseigner son motif.
#Compléter les observations et cliquer sur '''Enregistrer'''.
#Sur le contrôle en brouillon, joindre le justificatif obligatoire puis vérifier les informations avant validation.
#Après validation, consulter l'exigence et son échéance actualisée.

[[File:LMDBVehicleManagement-1.0.0-10-controle.jpg|thumb|center|1100px|Création d'un contrôle depuis une exigence : organisme, résultat, référence du procès-verbal et dates.]]

Un contrôle validé est immuable. Pour corriger une erreur, utiliser l'annulation motivée et le remplacement prévus par le module. Pour une contre-visite, conserver le lien avec le contrôle concerné. Une facture peut être liée ou déliée sans réécrire les données réglementaires validées.

==Notice — documents et historique==

===Conserver les pièces et les notes===

Utiliser l'onglet '''Notes''' pour les informations publiques ou privées selon les droits, et les fichiers joints de l'objet concerné pour ses pièces. Un rapport d'intervention appartient à l'événement ; un justificatif de contrôle appartient au contrôle. Ce rattachement permet de les retrouver ensuite dans le dossier du véhicule.

Les actions d'ajout, aperçu, téléchargement et suppression suivent les permissions de l'objet et les fonctionnalités disponibles dans la version de Dolibarr. Un droit de lecture n'autorise pas la modification des documents.

===Générer et lire le dossier véhicule===

#Ouvrir la '''fiche principale''' du véhicule et descendre au bloc '''Fichiers joints'''.
#Sélectionner '''Dossier véhicule''' dans '''Modèle de document'''.
#Cliquer sur '''Générer'''.
#Après génération, vérifier la présence du PDF et du ZIP dans le bloc.
#Cliquer sur la loupe du PDF pour l'aperçu, sur son nom pour le télécharger ou sur le ZIP pour récupérer l'archive documentaire.

[[File:LMDBVehicleManagement-1.0.0-14-dossier.jpg|thumb|center|754px|Bloc documentaire de la fiche : sélection du modèle, génération, aperçu du PDF et téléchargement de l'archive.]]

[[File:LMDBVehicleManagement-1.0.0-19-apercu-pdf.jpg|thumb|center|793px|Extrait de la première page d'un dossier PDF existant : identification et caractéristiques du véhicule.]]

Pour actualiser le dossier, relancer '''Générer'''. Les fichiers réservés au dossier ne doivent pas être remplacés manuellement. Les justificatifs des consommations et de leurs opérations diverses ne sont pas inclus dans l'archive. Les droits de lecture du véhicule et des factures fournisseurs restent requis pour consulter le dossier.

===Retrouver une opération dans l'historique===

#Ouvrir l'onglet '''Historique''' du véhicule.
#Filtrer par période, source, type, libellé ou état selon le besoin.
#Cliquer sur l'en-tête de la colonne Date pour trier ou sur le libellé d'une opération pour ouvrir sa fiche d'origine.
#Consulter l'indication documentaire lorsqu'une pièce est associée.

L'onglet '''Événements/Agenda''' présente les événements Agenda liés à l'objet. L'onglet '''Historique''' rassemble la chronologie métier disponible. Les deux vues répondent à des usages complémentaires.

[[File:LMDBVehicleManagement-1.0.0-17-historique.jpg|thumb|center|1100px|Chronologie consolidée : interventions, relevés, consommations, assurances et affectations.]]

===Importer ou exporter===

Utiliser les fonctions d'import/export natives de Dolibarr avec les jeux de données du module et les droits correspondants. Préparer le CSV à partir des champs attendus par l'import, vérifier les références et l'entité, puis contrôler le résultat après traitement. Les contrôles réglementaires importés sont créés en brouillon.

L'import des consommations est refusé lorsque la création d'opérations diverses est active. Un prix d'additif absent doit rester une cellule vide ; un zéro doit être conservé comme zéro.

==Questions fréquentes==

{| class="wikitable"
!Situation!!Vérification ou action
|-
|Un bouton n'apparaît pas||Vérifier les droits, l'état de l'objet et les dépendances dans Compatibilité.
|-
|Le dossier ne peut pas être généré||Vérifier l'activation du modèle, Factures fournisseurs, l'extension PHP ZIP et les droits sur le véhicule et les factures.
|-
|Le kilométrage d'une ligne ne peut pas être modifié||Si la source est une consommation, ouvrir et corriger le plein ou la recharge d'origine.
|-
|Une attestation n'est pas considérée comme validée||Vérifier son état, sa portée, sa période et son justificatif ; un brouillon doit encore être soumis au contrôle.
|-
|Une échéance manque||Vérifier les caractéristiques, les réponses de qualification et les dates nécessaires au calcul.
|-
|Les relances ne partent pas||Vérifier l'activation des rappels, les destinataires, les modèles d'emails, l'envoi d'emails Dolibarr et le dernier résultat des travaux planifiés.
|-
|Une dépense ne peut plus être corrigée||Vérifier son rapprochement bancaire ou son transfert comptable avant toute correction dans le parcours financier natif.
|-
|Des données d'une autre entité apparaissent||Vérifier la colonne Environnement et les partages autorisés dans Multicompany.
|}

==Mise à jour==

Avant toute mise à jour, sauvegarder la base de données et les documents de l'installation.

Après remplacement des fichiers du module, le désactiver puis le réactiver pour appliquer les migrations et enregistrer les déclarations natives nécessaires. Les réglages existants sont conservés.

Pour une mise à jour depuis une version de développement :

*consulter le fichier <code>ChangeLog.md</code> de la distribution ;
*vérifier les modèles documentaires et les travaux planifiés ;
*régénérer les dossiers existants pour bénéficier de leur présentation finale ;
*vérifier les paramètres bancaires avant d'activer la création d'opérations diverses.

Les nouveaux libellés Agenda s'appliquent aux événements futurs. Les historiques et contrôles validés ne sont pas réécrits.

==Limites de la version 1.0.0==

*Les contrôles détaillés des extincteurs, appareils sous pression, accessoires de levage et fluides frigorigènes ne sont pas préconfigurés.
*La gestion dédiée des cartes grises, sinistres, primes, franchises et contraventions n'est pas couverte.
*La gestion commerciale des factures d'achat reste assurée par le module natif Factures fournisseurs.
*Les rappels périodiques nécessitent une configuration opérationnelle des travaux planifiés et de l'envoi d'emails Dolibarr.

==Sources et liens utiles==

*[https://github.com/mapiolca/lmdbvehiclemanagement Code source du module]
*[https://github.com/mapiolca/lmdbvehiclemanagement/blob/094fc89/README.md Documentation de référence de la version présentée]
*[https://github.com/mapiolca/lmdbvehiclemanagement/blob/094fc89/ChangeLog.md Historique de la version 1.0.0]
*[https://github.com/mapiolca Profil de l'auteur]

[[Category:Modules complémentaires]]
[[Category:DocUserFR]]

File:LMDBVehicleManagement-1.0.0-17-historique.jpg

2026-09-05T11:15:07Z

Mapiolca: Chronologie consolidée : interventions, relevés, consommations, assurances et affectations. Capture réalisée le 5 septembre 2026 sur develop.lesmetiersdubatiment.fr (Dolibarr 24, environnement de démonstration), pour la notice 1.0.0 du Module Gestion des véhicules. Auteur : Pierre Ardoin / Les Métiers du Bâtiment.

== Summary ==
Chronologie consolidée : interventions, relevés, consommations, assurances et affectations.

Capture réalisée le 5 septembre 2026 sur develop.lesmetiersdubatiment.fr (Dolibarr 24, environnement de démonstration), pour la notice 1.0.0 du [[Module Gestion des véhicules]].

Auteur : Pierre Ardoin / Les Métiers du Bâtiment.

File:LMDBVehicleManagement-1.0.0-19-apercu-pdf.jpg

2026-09-05T11:15:05Z

Mapiolca: Extrait de la première page d'un dossier PDF existant : identification et caractéristiques du véhicule. Capture réalisée le 5 septembre 2026 sur develop.lesmetiersdubatiment.fr (Dolibarr 24, environnement de démonstration), pour la notice 1.0.0 du Module Gestion des véhicules. Auteur : Pierre Ardoin / Les Métiers du Bâtiment.

== Summary ==
Extrait de la première page d'un dossier PDF existant : identification et caractéristiques du véhicule.

Capture réalisée le 5 septembre 2026 sur develop.lesmetiersdubatiment.fr (Dolibarr 24, environnement de démonstration), pour la notice 1.0.0 du [[Module Gestion des véhicules]].

Auteur : Pierre Ardoin / Les Métiers du Bâtiment.

File:LMDBVehicleManagement-1.0.0-14-dossier.jpg

2026-09-05T11:15:04Z

Mapiolca: Bloc documentaire de la fiche : sélection du modèle, génération, aperçu du PDF et téléchargement de l'archive. Capture réalisée le 5 septembre 2026 sur develop.lesmetiersdubatiment.fr (Dolibarr 24, environnement de démonstration), pour la notice 1.0.0 du Module Gestion des véhicules. Auteur : Pierre Ardoin / Les Métiers du Bâtiment.

== Summary ==
Bloc documentaire de la fiche : sélection du modèle, génération, aperçu du PDF et téléchargement de l'archive.

Capture réalisée le 5 septembre 2026 sur develop.lesmetiersdubatiment.fr (Dolibarr 24, environnement de démonstration), pour la notice 1.0.0 du [[Module Gestion des véhicules]].

Auteur : Pierre Ardoin / Les Métiers du Bâtiment.

File:LMDBVehicleManagement-1.0.0-10-controle.jpg

2026-09-05T11:15:02Z

Mapiolca: Création d'un contrôle depuis une exigence : organisme, résultat, référence du procès-verbal et dates. Capture réalisée le 5 septembre 2026 sur develop.lesmetiersdubatiment.fr (Dolibarr 24, environnement de démonstration), pour la notice 1.0.0 du Module Gestion des véhicules. Auteur : Pierre Ardoin / Les Métiers du Bâtiment.

== Summary ==
Création d'un contrôle depuis une exigence : organisme, résultat, référence du procès-verbal et dates.

Capture réalisée le 5 septembre 2026 sur develop.lesmetiersdubatiment.fr (Dolibarr 24, environnement de démonstration), pour la notice 1.0.0 du [[Module Gestion des véhicules]].

Auteur : Pierre Ardoin / Les Métiers du Bâtiment.

File:LMDBVehicleManagement-1.0.0-08-echeancier.jpg

2026-09-05T11:15:00Z

Mapiolca: Échéancier du parc de démonstration, avec dates retenues et états des exigences. Capture réalisée le 5 septembre 2026 sur develop.lesmetiersdubatiment.fr (Dolibarr 24, environnement de démonstration), pour la notice 1.0.0 du Module Gestion des véhicules. Auteur : Pierre Ardoin / Les Métiers du Bâtiment.

== Summary ==
Échéancier du parc de démonstration, avec dates retenues et états des exigences.

Capture réalisée le 5 septembre 2026 sur develop.lesmetiersdubatiment.fr (Dolibarr 24, environnement de démonstration), pour la notice 1.0.0 du [[Module Gestion des véhicules]].

Auteur : Pierre Ardoin / Les Métiers du Bâtiment.

File:LMDBVehicleManagement-1.0.0-09-qualification.jpg

2026-09-05T11:14:53Z

Mapiolca: Extrait du questionnaire de qualification, à compléter selon les caractéristiques et l'usage du matériel. Capture réalisée le 5 septembre 2026 sur develop.lesmetiersdubatiment.fr (Dolibarr 24, environnement de démonstration), pour la notice 1.0.0 du Module Gestion des véhicules. Auteur : Pierre Ardoin / Les Métiers du Bâtiment.

== Summary ==
Extrait du questionnaire de qualification, à compléter selon les caractéristiques et l'usage du matériel.

Capture réalisée le 5 septembre 2026 sur develop.lesmetiersdubatiment.fr (Dolibarr 24, environnement de démonstration), pour la notice 1.0.0 du [[Module Gestion des véhicules]].

Auteur : Pierre Ardoin / Les Métiers du Bâtiment.

File:LMDBVehicleManagement-1.0.0-12-attestations.jpg

2026-09-05T11:14:51Z

Mapiolca: Attestation validée et formulaire de dépôt : enregistrement provisoire et soumission au contrôle sont deux actions distinctes. Capture réalisée le 5 septembre 2026 sur develop.lesmetiersdubatiment.fr (Dolibarr 24, environnement de démonstration), pour la notice 1.0.0 du Module Gestion des véhicules. Auteur : Pierre Ardoin / Les Métiers du Bâtiment.

== Summary ==
Attestation validée et formulaire de dépôt : enregistrement provisoire et soumission au contrôle sont deux actions distinctes.

Capture réalisée le 5 septembre 2026 sur develop.lesmetiersdubatiment.fr (Dolibarr 24, environnement de démonstration), pour la notice 1.0.0 du [[Module Gestion des véhicules]].

Auteur : Pierre Ardoin / Les Métiers du Bâtiment.

File:LMDBVehicleManagement-1.0.0-11-assurance.jpg

2026-09-05T11:14:49Z

Mapiolca: Contrat d'assurance enregistré et véhicule couvert, avec type et période de couverture. Capture réalisée le 5 septembre 2026 sur develop.lesmetiersdubatiment.fr (Dolibarr 24, environnement de démonstration), pour la notice 1.0.0 du Module Gestion des véhicules. Auteur : Pierre Ardoin / Les Métiers du Bâtiment.

== Summary ==
Contrat d'assurance enregistré et véhicule couvert, avec type et période de couverture.

Capture réalisée le 5 septembre 2026 sur develop.lesmetiersdubatiment.fr (Dolibarr 24, environnement de démonstration), pour la notice 1.0.0 du [[Module Gestion des véhicules]].

Auteur : Pierre Ardoin / Les Métiers du Bâtiment.

File:LMDBVehicleManagement-1.0.0-18-creation-assurance.jpg

2026-09-05T11:14:47Z

Mapiolca: Extrait du formulaire de contrat : assureur, police, période et rattachement des véhicules. Capture réalisée le 5 septembre 2026 sur develop.lesmetiersdubatiment.fr (Dolibarr 24, environnement de démonstration), pour la notice 1.0.0 du Module Gestion des véhicules. Auteur : Pierre Ardoin / Les Métiers du Bâtiment.

== Summary ==
Extrait du formulaire de contrat : assureur, police, période et rattachement des véhicules.

Capture réalisée le 5 septembre 2026 sur develop.lesmetiersdubatiment.fr (Dolibarr 24, environnement de démonstration), pour la notice 1.0.0 du [[Module Gestion des véhicules]].

Auteur : Pierre Ardoin / Les Métiers du Bâtiment.

File:LMDBVehicleManagement-1.0.0-13-intervention-facture.jpg

2026-09-05T11:14:45Z

Mapiolca: Fiche d'entretien et actions de création ou de liaison d'une facture fournisseur ; la relation existante apparaît dans Objets liés. Capture réalisée le 5 septembre 2026 sur develop.lesmetiersdubatiment.fr (Dolibarr 24, environnement de démonstration), pour la notice 1.0.0 du Module Gestion des véhicules. Auteur : Pierre Ardoin / Les Métiers du Bâtiment.

== Summary ==
Fiche d'entretien et actions de création ou de liaison d'une facture fournisseur ; la relation existante apparaît dans Objets liés.

Capture réalisée le 5 septembre 2026 sur develop.lesmetiersdubatiment.fr (Dolibarr 24, environnement de démonstration), pour la notice 1.0.0 du [[Module Gestion des véhicules]].

Auteur : Pierre Ardoin / Les Métiers du Bâtiment.

File:LMDBVehicleManagement-1.0.0-07-synthese.jpg

2026-09-05T11:14:33Z

Mapiolca: Synthèse filtrable et premiers graphiques : les valeurs affichées proviennent d'un jeu de données de test. Capture réalisée le 5 septembre 2026 sur develop.lesmetiersdubatiment.fr (Dolibarr 24, environnement de démonstration), pour la notice 1.0.0 du Module Gestion des véhicules. Auteur : Pierre Ardoin / Les Métiers du Bâtiment.

== Summary ==
Synthèse filtrable et premiers graphiques : les valeurs affichées proviennent d'un jeu de données de test.

Capture réalisée le 5 septembre 2026 sur develop.lesmetiersdubatiment.fr (Dolibarr 24, environnement de démonstration), pour la notice 1.0.0 du [[Module Gestion des véhicules]].

Auteur : Pierre Ardoin / Les Métiers du Bâtiment.

File:LMDBVehicleManagement-1.0.0-06-plein.jpg

2026-09-05T11:14:26Z

Mapiolca: Formulaire de plein ou recharge avec ticket de caisse et règlement, lorsque les opérations diverses sont activées. Capture réalisée le 5 septembre 2026 sur develop.lesmetiersdubatiment.fr (Dolibarr 24, environnement de démonstration), pour la notice 1.0.0 du Module Gestion des véhicules. Auteur : Pierre Ardoin / Les Métiers du Bâtiment.

== Summary ==
Formulaire de plein ou recharge avec ticket de caisse et règlement, lorsque les opérations diverses sont activées.

Capture réalisée le 5 septembre 2026 sur develop.lesmetiersdubatiment.fr (Dolibarr 24, environnement de démonstration), pour la notice 1.0.0 du [[Module Gestion des véhicules]].

Auteur : Pierre Ardoin / Les Métiers du Bâtiment.

File:LMDBVehicleManagement-1.0.0-05-kilometrage.jpg

2026-09-05T11:14:24Z

Mapiolca: Relevés kilométriques avec date, différence et source. Les lignes issues des consommations sont gérées depuis leur fiche d'origine. Capture réalisée le 5 septembre 2026 sur develop.lesmetiersdubatiment.fr (Dolibarr 24, environnement de démonstration), pour la notice 1.0.0 du Module Gestion des véhicules. Auteur : Pierre Ardoin / Les Métiers du Bâtiment.

== Summary ==
Relevés kilométriques avec date, différence et source. Les lignes issues des consommations sont gérées depuis leur fiche d'origine.

Capture réalisée le 5 septembre 2026 sur develop.lesmetiersdubatiment.fr (Dolibarr 24, environnement de démonstration), pour la notice 1.0.0 du [[Module Gestion des véhicules]].

Auteur : Pierre Ardoin / Les Métiers du Bâtiment.

File:LMDBVehicleManagement-1.0.0-04-affectations.jpg

2026-09-05T11:14:22Z

Mapiolca: Liste des affectations : conducteur, période, type, caractère principal et état. Capture réalisée le 5 septembre 2026 sur develop.lesmetiersdubatiment.fr (Dolibarr 24, environnement de démonstration), pour la notice 1.0.0 du Module Gestion des véhicules. Auteur : Pierre Ardoin / Les Métiers du Bâtiment.

== Summary ==
Liste des affectations : conducteur, période, type, caractère principal et état.

Capture réalisée le 5 septembre 2026 sur develop.lesmetiersdubatiment.fr (Dolibarr 24, environnement de démonstration), pour la notice 1.0.0 du [[Module Gestion des véhicules]].

Auteur : Pierre Ardoin / Les Métiers du Bâtiment.

File:LMDBVehicleManagement-1.0.0-02-fiche.jpg

2026-09-05T11:14:19Z

Mapiolca: Extrait de la fiche d'un véhicule en service : caractéristiques, capacités et résumé d'assurance. Capture réalisée le 5 septembre 2026 sur develop.lesmetiersdubatiment.fr (Dolibarr 24, environnement de démonstration), pour la notice 1.0.0 du Module Gestion des véhicules. Auteur : Pierre Ardoin / Les Métiers du Bâtiment.

== Summary ==
Extrait de la fiche d'un véhicule en service : caractéristiques, capacités et résumé d'assurance.

Capture réalisée le 5 septembre 2026 sur develop.lesmetiersdubatiment.fr (Dolibarr 24, environnement de démonstration), pour la notice 1.0.0 du [[Module Gestion des véhicules]].

Auteur : Pierre Ardoin / Les Métiers du Bâtiment.

File:LMDBVehicleManagement-1.0.0-03-creation.jpg

2026-09-05T11:14:17Z

Mapiolca: Partie supérieure du formulaire de création : identification, caractéristiques techniques et dates. Capture réalisée le 5 septembre 2026 sur develop.lesmetiersdubatiment.fr (Dolibarr 24, environnement de démonstration), pour la notice 1.0.0 du Module Gestion des véhicules. Auteur : Pierre Ardoin / Les Métiers du Bâtiment.

== Summary ==
Partie supérieure du formulaire de création : identification, caractéristiques techniques et dates.

Capture réalisée le 5 septembre 2026 sur develop.lesmetiersdubatiment.fr (Dolibarr 24, environnement de démonstration), pour la notice 1.0.0 du [[Module Gestion des véhicules]].

Auteur : Pierre Ardoin / Les Métiers du Bâtiment.

File:LMDBVehicleManagement-1.0.0-16-relances-assurance.jpg

2026-09-05T11:14:08Z

Mapiolca: Choix des référents, seuils de relance, modèles d'emails et accès au travail planifié d'assurance. Capture réalisée le 5 septembre 2026 sur develop.lesmetiersdubatiment.fr (Dolibarr 24, environnement de démonstration), pour la notice 1.0.0 du Module Gestion des véhicules. Auteur : Pierre Ardoin / Les Métiers du Bâtiment.

== Summary ==
Choix des référents, seuils de relance, modèles d'emails et accès au travail planifié d'assurance.

Capture réalisée le 5 septembre 2026 sur develop.lesmetiersdubatiment.fr (Dolibarr 24, environnement de démonstration), pour la notice 1.0.0 du [[Module Gestion des véhicules]].

Auteur : Pierre Ardoin / Les Métiers du Bâtiment.

File:LMDBVehicleManagement-1.0.0-15-modeles.jpg

2026-09-05T11:14:05Z

Mapiolca: Réglages des modèles documentaires et de la numérotation. Le dossier est activé ; le choix du modèle par défaut est distinct. Capture réalisée le 5 septembre 2026 sur develop.lesmetiersdubatiment.fr (Dolibarr 24, environnement de démonstration), pour la notice 1.0.0 du Module Gestion des véhicules. Auteur : Pierre Ardoin / Les Métiers du Bâtiment.

== Summary ==
Réglages des modèles documentaires et de la numérotation. Le dossier est activé ; le choix du modèle par défaut est distinct.

Capture réalisée le 5 septembre 2026 sur develop.lesmetiersdubatiment.fr (Dolibarr 24, environnement de démonstration), pour la notice 1.0.0 du [[Module Gestion des véhicules]].

Auteur : Pierre Ardoin / Les Métiers du Bâtiment.

File:LMDBVehicleManagement-1.0.0-01-liste.jpg

2026-09-05T11:13:21Z

Mapiolca: Accès aux rubriques du module et recherche dans le parc de démonstration. Capture réalisée le 5 septembre 2026 sur develop.lesmetiersdubatiment.fr (Dolibarr 24, environnement de démonstration), pour la notice 1.0.0 du Module Gestion des véhicules. Auteur : Pierre Ardoin / Les Métiers du Bâtiment.

== Summary ==
Accès aux rubriques du module et recherche dans le parc de démonstration.

Capture réalisée le 5 septembre 2026 sur develop.lesmetiersdubatiment.fr (Dolibarr 24, environnement de démonstration), pour la notice 1.0.0 du [[Module Gestion des véhicules]].

Auteur : Pierre Ardoin / Les Métiers du Bâtiment.

FAQ Facture

2026-09-03T11:21:44Z

Mapiolca:

[[en:FAQ_Facture_EN]]
[[es:FAQ_Facture_ES]]


[[Category:FAQ FR]]

__TOC__

==Comment supprimer « facilement » une facture client directement dans la base de données ?==

'''Attention :''' la suppression directe dans la base de données est déconseillée. Utilisez de préférence les fonctions proposées dans l'interface de Dolibarr et réalisez une sauvegarde complète de la base avant toute intervention manuelle.

Il faut supprimer en premier lieu les enregistrements qui se trouvent dans la [[Table llx_facturedet]] — un enregistrement existe pour chaque ligne de facture — puis supprimer la facture dans la [[Table llx_facture]].

Les étapes pour une base MySQL sont les suivantes :

*Récupérez l'identifiant de la facture. Celui-ci est visible dans l'adresse de la page de la facture. Par exemple, dans l'adresse suivante, l'identifiant est '''29''' :

<pre>
http://dolibarr.xxxxx.com/compta/facture.php?facid=29
</pre>

*Connectez-vous à la base de données, avec phpMyAdmin ou en ligne de commande.
*Exécutez les commandes suivantes en remplaçant <code>INVOICE_ID</code> par l'identifiant de la facture :

<syntaxhighlight lang="sql">
DELETE FROM llx_facturedet WHERE fk_facture = INVOICE_ID;
DELETE FROM llx_facture WHERE rowid = INVOICE_ID;
</syntaxhighlight>

La facture devrait alors être supprimée.

==Comment gérer une ligne de remise négative lors du passage d'un devis ou d'une commande en facture électronique ?==

Dans un devis ou une commande, il est possible d'ajouter une ligne avec un prix unitaire négatif afin de représenter une remise commerciale ou exceptionnelle.

Exemple :

<pre>
Libellé : Remise exceptionnelle
Quantité : 1
Prix unitaire HT : -100,00
TVA : même taux que les produits ou services concernés
</pre>

La ligne peut être une '''ligne libre''' ou provenir d'un '''produit ou service du catalogue'''.

Lors de la création d'une facture depuis le devis ou la commande, les versions récentes de Dolibarr — notamment la version 23.0.3 — peuvent automatiquement :

#détecter la ligne dont le prix unitaire est négatif ;
#créer une remise fixe pour le tiers ;
#appliquer cette remise à la facture ;
#marquer immédiatement la remise comme consommée par cette facture.

Cette transformation permet au module de facturation électronique de traiter le montant comme une remise globale de facture plutôt que comme une ligne de vente ayant un prix négatif.

'''Configuration nécessaire'''

La constante suivante doit être absente ou définie à <code>0</code> :

<pre>
INVOICE_KEEP_DISCOUNT_LINES_AS_IN_ORIGIN = 0
</pre>

Si cette constante vaut <code>1</code>, Dolibarr conserve la ligne négative telle qu'elle existait dans le devis ou la commande et ne la transforme pas en remise fixe.

Il est également recommandé de désactiver la saisie directe de lignes négatives dans les factures :

<pre>
FACTURE_ENABLE_NEGATIVE_LINES = 0
</pre>

Cette deuxième constante n'effectue pas la transformation. Elle empêche principalement l'ajout manuel d'une ligne négative directement dans une facture.

Les constantes peuvent être vérifiées depuis :

<pre>
Accueil → Configuration → Divers
</pre>

'''Utilisation d'un produit du catalogue'''

La transformation fonctionne également lorsque la ligne négative provient d'un produit ou service du catalogue. La détection repose sur le prix unitaire négatif et non sur le caractère libre ou catalogué de la ligne.

Toutefois, après transformation en remise fixe, la ligne de facture n'est plus associée au produit d'origine. Le libellé, le montant et le taux de TVA sont conservés, mais l'association avec le produit, son compte comptable et les statistiques liées à ce produit ne sont pas conservés.

'''Gestion de la TVA'''

La ligne négative doit utiliser le même taux de TVA que les produits ou services auxquels la remise s'applique.

Si le devis ou la commande contient plusieurs taux de TVA, il est recommandé de créer une ligne de remise distincte pour chaque taux afin d'obtenir une ventilation correcte dans la facture et dans le fichier électronique.

'''Voir aussi'''

*[[Setup Other|Liste des constantes et paramètres divers de Dolibarr]]
*[https://www.dolibarr.org/fr/Facturationelectronique2026toutcomprendre.php Facturation électronique 2026 : tout comprendre pour être prêt]
*[https://github.com/Dolibarr/dolibarr/blob/23.0.3/htdocs/compta/facture/card.php Code source du traitement dans Dolibarr 23.0.3]

FAQ Facture

2026-09-03T11:17:47Z

Mapiolca:

[[en:FAQ_Facture_EN]]
[[es:FAQ_Facture_ES]]


[[Category:FAQ FR]]

__TOC__

==Comment supprimer « facilement » une facture client directement dans la base de données ?==

'''Attention :''' la suppression directe dans la base de données est déconseillée. Utilisez de préférence les fonctions proposées dans l'interface de Dolibarr et réalisez une sauvegarde complète de la base avant toute intervention manuelle.

Il faut supprimer en premier lieu les enregistrements qui se trouvent dans la [[Table llx_facturedet]] — un enregistrement existe pour chaque ligne de facture — puis supprimer la facture dans la [[Table llx_facture]].

Les étapes pour une base MySQL sont les suivantes :

*Récupérez l'identifiant de la facture. Celui-ci est visible dans l'adresse de la page de la facture. Par exemple, dans l'adresse suivante, l'identifiant est '''29''' :

<pre>
http://dolibarr.xxxxx.com/compta/facture.php?facid=29
</pre>

*Connectez-vous à la base de données, avec phpMyAdmin ou en ligne de commande.
*Exécutez les commandes suivantes en remplaçant <code>INVOICE_ID</code> par l'identifiant de la facture :

<syntaxhighlight lang="sql">
DELETE FROM llx_facturedet WHERE fk_facture = INVOICE_ID;
DELETE FROM llx_facture WHERE rowid = INVOICE_ID;
</syntaxhighlight>

La facture devrait alors être supprimée.

==Comment gérer une ligne de remise négative lors du passage d'un devis ou d'une commande en facture électronique ?==

Dans un devis ou une commande, il est possible d'ajouter une ligne avec un prix unitaire négatif afin de représenter une remise commerciale ou exceptionnelle.

Exemple :

<pre>
Libellé : Remise exceptionnelle
Quantité : 1
Prix unitaire HT : -100,00
TVA : même taux que les produits ou services concernés
</pre>

La ligne peut être une '''ligne libre''' ou provenir d'un '''produit ou service du catalogue'''.

Lors de la création d'une facture depuis le devis ou la commande, les versions récentes de Dolibarr — notamment la version 23.0.3 — peuvent automatiquement :

#détecter la ligne dont le prix unitaire est négatif ;
#créer une remise fixe pour le tiers ;
#appliquer cette remise à la facture ;
#marquer immédiatement la remise comme consommée par cette facture.

Cette transformation permet au module de facturation électronique de traiter le montant comme une remise globale de facture plutôt que comme une ligne de vente ayant un prix négatif.

'''Configuration nécessaire'''

La constante suivante doit être absente ou définie à <code>0</code> :

<pre>
INVOICE_KEEP_DISCOUNT_LINES_AS_IN_ORIGIN = 0
</pre>

Si cette constante vaut <code>1</code>, Dolibarr conserve la ligne négative telle qu'elle existait dans le devis ou la commande et ne la transforme pas en remise fixe.

Il est également recommandé de désactiver la saisie directe de lignes négatives dans les factures :

<pre>
FACTURE_ENABLE_NEGATIVE_LINES = 0
</pre>

Cette deuxième constante n'effectue pas la transformation. Elle empêche principalement l'ajout manuel d'une ligne négative directement dans une facture.

Les constantes peuvent être vérifiées depuis :

<pre>
Accueil → Configuration → Divers
</pre>

'''Utilisation d'un produit du catalogue'''

La transformation fonctionne également lorsque la ligne négative provient d'un produit ou service du catalogue. La détection repose sur le prix unitaire négatif et non sur le caractère libre ou catalogué de la ligne.

Toutefois, après transformation en remise fixe, la ligne de facture n'est plus associée au produit d'origine. Le libellé, le montant et le taux de TVA sont conservés, mais la référence produit association avec le produit, son compte comptable et les statistiques liées à ce produit ne sont pas conservés.

'''Gestion de la TVA'''

La ligne négative doit utiliser le même taux de TVA que les produits ou services auxquels la remise s'applique.

Si le devis ou la commande contient plusieurs taux de TVA, il est recommandé de créer une ligne de remise distincte pour chaque taux afin d'obtenir une ventilation correcte dans la facture et dans le fichier électronique.

'''Voir aussi'''

*[[Setup Other|Liste des constantes et paramètres divers de Dolibarr]]
*[https://www.dolibarr.org/fr/Facturationelectronique2026toutcomprendre.php Facturation électronique 2026 : tout comprendre pour être prêt]
*[https://github.com/Dolibarr/dolibarr/blob/23.0.3/htdocs/compta/facture/card.php Code source du traitement dans Dolibarr 23.0.3]

Documentation utilisateur

2026-06-28T19:19:12Z

Mapiolca: Actualisation et complétion de la page

[[en:User_documentation]]
[[es:Documentación_usuarios]]
[[de:Benutzerdokumentation]]
[[zh:用户手册]]
[[ro:Documentaţie utilizator]]


[[Category:DocUserFR]]
{{#metamaster:keywords|utilisateur, documentation, guide, doc, tutoriel, utilisation, aide}}

Cette page regroupe les principaux articles destinés aux utilisateurs de Dolibarr ERP CRM.

Elle permet de retrouver rapidement les pages utiles pour découvrir Dolibarr, l’installer, le configurer, administrer l’application et utiliser les différents modules fonctionnels.

Pour la documentation destinée aux développeurs, voir [[Documentation Développeur]].

=Aperçu rapide des fonctionnalités=

Avant de commencer, il est conseillé de consulter les pages suivantes :

*[[Ce que fait Dolibarr]]
*[[Ce que ne fait pas Dolibarr]]

=Installation, mise à jour et paramétrage=

Les pages suivantes expliquent les prérequis techniques, l’installation, la mise à jour et les premiers réglages de Dolibarr :

*[[Prérequis]]
*[[Installation / Mise a jour|Installation / Mise à jour]]
*[[Premiers paramétrages|Configuration / Paramétrage]]

=Administration=

Cette section regroupe les opérations d’administration courantes.

*Migration des données :
**[[Imports_de_masse|Imports de données]]
**[[Exports]]
*Sauvegarde et restauration :
**[[Sauvegardes]]
**[[Restaurations]]

''Vidéo sur le sujet :''
<youtube width="200" height="120">lTriUeIdiNs</youtube>

=Tableau de bord=

Le tableau de bord est généralement le premier écran affiché après la connexion à Dolibarr.

Il peut être personnalisé afin d’afficher les informations utiles au suivi de l’activité : éléments à traiter, indicateurs, raccourcis ou informations issues des modules activés.

''Vidéo sur le sujet :''
<youtube width="200" height="120">VieSairH_ZQ</youtube>

=Outils=

L’onglet « Outils » donne accès à différentes fonctions transversales de Dolibarr.

Les fonctions disponibles peuvent varier selon les modules activés, la configuration de l’instance et les permissions de l’utilisateur connecté.

''Vidéo sur le sujet :''
<youtube width="200" height="120">gbfLLlp14FA</youtube>

=Statistiques intégrées aux objets de Dolibarr=

Certains objets de Dolibarr disposent de statistiques ou d’indicateurs intégrés.

Ces informations permettent d’obtenir une vue synthétique sur les données enregistrées, selon les modules activés et les droits de l’utilisateur connecté.

''Vidéo sur le sujet :''
<youtube width="200" height="120">L_3Qft8MLXA</youtube>

=Utilisation des modules et applications=

Les fonctionnalités de Dolibarr sont réparties en modules, également appelés applications.

Savoir utiliser Dolibarr consiste généralement à comprendre les menus, les écrans et les actions disponibles dans les modules activés sur l’instance.

On distingue notamment :

*les modules standards, fournis avec la version de base de Dolibarr ;
*les modules externes, non inclus par défaut, qui peuvent être installés séparément.

Les modules externes peuvent notamment être recherchés sur la place de marché DoliStore : https://www.dolistore.com

Pour commencer, consulter d’abord la page suivante :

*[[Utilisation générale de Dolibarr]]

Une fois les principes généraux maîtrisés, il est conseillé de consulter la documentation propre à chaque module.

==Modules standards par domaine fonctionnel==

Le tableau ci-dessous propose un classement des principaux modules standards par domaine fonctionnel.

''Note : lorsque la documentation française d’un module n’est pas encore disponible, le lien peut pointer vers la page anglaise existante. Ces liens sont signalés par la mention « EN ».''

{| class="wikitable"
|+
!Domaine
!Modules natifs concernés
|-
|Gestion des ressources humaines
|
*[[Module Utilisateurs]]
*[[Module Adhérents]]
*[[Module Congés]]
*[[Module Notes de frais]]
*[[Module Recruitment|Module Recrutement]] (EN)
*[[Module GRH]]
|-
|Gestion de la relation client
|
*[[Module Tiers|Module Tiers / Sociétés]]
*[[Module Propositions commerciales - Devis]]
*[[Module Commandes Clients]]
*[[Module Expéditions]]
*[[Module Contrat]]
*[[Module Fiches d'interventions]]
*[[Module Ticket FR|Module Ticket]]
*[[Module Knowledge Management|Module Gestion des connaissances]] (EN)
*[[Module Partenariat]]
|-
|Gestion de la relation fournisseur
|
*[[Module Tiers|Module Tiers / Fournisseurs]]
*[[Module Fournisseurs Commandes|Module Commandes fournisseurs]]
*[[Module Fournisseurs Factures|Module Factures fournisseurs]]
*Demandes de prix fournisseurs
*[[Module Reception|Module Réceptions fournisseurs]] (EN)
*Incoterms
|-
|Comptabilité et trésorerie
|
*[[Module Factures Clients]]
*[[Module Fournisseurs Factures]]
*[[Module Taxes et charges spéciales]]
*[[Module Salaires]]
*[[Module Emprunt]]
*[[Module Dons]]
*[[Module Banques et Caisses]]
*Virements bancaires / SEPA fournisseurs
*[[Module Prélèvements bancaires]]
*[[Module Marges]]
*[[Module Comptabilité Simplifiée]]
*[[Module Comptabilité en Partie Double]]
*Rapport Intracomm / DEB-DES (expérimental)
*[[Module Asset|Module Immobilisations]] (EN, en développement)
|-
|Produits et services
|
*[[Module Produits]]
*[[Module Services]]
*[[Module Stock]]
*[[Module Lot / Série]]
*[[Module Produits|Variantes de produits]]
*[[Module BOM FR|Module Nomenclatures / BOM]]
*[[Module Ordres de Fabrication]]
*[[Module Prix dynamiques]] (expérimental)
*[[Module Workstation|Module Postes de travail]] (EN)
*Transferts de stock avancés (en développement)
|-
|Projets et travail collaboratif
|
*[[Module Projets]]
*[[Module Agenda FR|Module Agenda]]
*[[Module Ressources]]
*[[Module Event Organization|Module Organisation d'événements]] (EN)
|-
|Gestion électronique de documents
|
*GED / ECM
|-
|Outils multi-modules
|
*[[Module Catégories]]
*[[Module Éditeur WYSIWYG]]
*[[Module Multi-devise]]
*[[Module Flux RSS]]
*[[Module Marque pages]]
*[[Module Codes Barre]]
*[[Module Workflow FR|Module Workflow]]
*[[Module Imports FR|Module Imports]]
*[[Module Exports]]
*Étiquettes / autocollants (en développement)
*[[Module Politique de Données (RGPD)]] (expérimental)
*[[Module ModuleBuilder|Module ModuleBuilder]] (EN)
*[[Module AI (Artificial Intelligence)|Module IA]] (EN, expérimental)
|-
|Sites web et applications frontales
|
*[[Module Sondage]]
*[[Module Sites web]]
*[[Module WebPortal]] (expérimental)
*[[Module Point de vente (TakePOS)]]
*[[Module Caisse enregistreuse (SimplePOS)]]
|-
|Interfaces avec des systèmes externes
|
*Réseaux sociaux
*[[Module Notification FR|Module Notification]]
*[[Module Mailing]]
*[[Module Collecteur de courrier électronique]]
*[[Module Web Services API REST (developer)|Module API REST]] (EN, documentation développeur)
*[[Module Services Web API SOAP (développeur)|Module API SOAP]] (documentation développeur, obsolète)
*[[Module Webhook FR|Module Webhook]]
*[[Module Zapier|Module Zapier]] (EN, en développement)
*[[Module LDAP]]
*[[Module OAuth FR|Module OAuth]]
*Site externe
*[[Module FTP]]
*GeoIPMaxmind
*PayBox
*[[Module PayPal FR|Module PayPal]]
*[[Module Stripe FR|Module Stripe]]
*[[Module ClickToDial]]
*Impression en un clic
*[[Module Imprimante Reçu|Module Imprimante de reçu]]
*Mailman / SPIP
*[[Module Gravatar]]
*[[Module DAV|Module DAV / WebDAV]] (EN)
|-
|Système
|
*[[Module Scheduled jobs|Module Tâches planifiées]] (EN)
*Journaux de debug
*Barre de debug
*[[Module Archives - Journaux Inaltérables]]
|}

==Modules externes==

Les modules externes sont des modules non inclus par défaut dans Dolibarr.

La liste des modules externes complémentaires est disponible sur la page [[:Category:Modules_complémentaires|Modules complémentaires]].

=Autres sources de documentation=

Des ressources complémentaires peuvent aider à approfondir l’utilisation de Dolibarr :

*Guide d’utilisation « Dolibarr the Book » :
**[https://www.dolistore.com/fr/recherche?controller=search&orderby=position&orderway=desc&search_query=dolibarr+book&submit_search= fiche DoliStore]
**[https://compta.atoo-net.com/document.php?hashp=Jzox96AT6hlLoLb2xcBU099N5CV7pXv2 sommaire téléchargeable]
*Livres ''Bien gérer son entreprise avec Dolibarr'', parus aux [http://www.d-booker.fr éditions D-Booker] :
**[https://www.d-booker.fr/dolibarrservices3e/657-dolibarr-pour-societes-de-services-et-consultants-3ed.html Société de services et consultants]
**[https://www.d-booker.fr/dolibarrcomm2e/658-dolibarr-pour-commerce-et-production-de-biens-2ed.html Commerce et production de biens]
*[http://doc.ubuntu-fr.org/dolibarr#dolibarr Documentation Ubuntu-fr sur Dolibarr]

=FAQ et glossaire=

Toutes les foires aux questions sont disponibles via la page d’index [[:Category:FAQ FR|FAQ FR]].

Le glossaire est disponible sur la page [[Glossaire]].

=Tutoriels vidéo=

L’association Dolibarr propose des tutoriels vidéo sur les principales fonctionnalités de Dolibarr :

*[[Tutoriels Vidéos]]

Documentation utilisateur

2026-06-28T19:17:15Z

Mapiolca: Actualisation et complétion de la page

[[en:User_documentation]]
[[es:Documentación_usuarios]]
[[de:Benutzerdokumentation]]
[[zh:用户手册]]
[[ro:Documentaţie utilizator]]


[[Category:DocUserFR]]
{{#metamaster:keywords|utilisateur, documentation, guide, doc, tutoriel, utilisation, aide}}

Cette page regroupe les principaux articles destinés aux utilisateurs de Dolibarr ERP CRM.

Elle permet de retrouver rapidement les pages utiles pour découvrir Dolibarr, l’installer, le configurer, administrer l’application et utiliser les différents modules fonctionnels.

Pour la documentation destinée aux développeurs, voir [[Documentation Développeur]].

=Aperçu rapide des fonctionnalités=

Avant de commencer, il est conseillé de consulter les pages suivantes :

*[[Ce que fait Dolibarr]]
*[[Ce que ne fait pas Dolibarr]]

=Installation, mise à jour et paramétrage=

Les pages suivantes expliquent les prérequis techniques, l’installation, la mise à jour et les premiers réglages de Dolibarr :

*[[Prérequis]]
*[[Installation / Mise a jour|Installation / Mise à jour]]
*[[Premiers paramétrages|Configuration / Paramétrage]]

=Administration=

Cette section regroupe les opérations d’administration courantes.

*Migration des données :
**[[Imports_de_masse|Imports de données]]
**[[Exports]]
*Sauvegarde et restauration :
**[[Sauvegardes]]
**[[Restaurations]]

''Vidéo sur le sujet :''
<youtube width="200" height="120">lTriUeIdiNs</youtube>

=Tableau de bord=

Le tableau de bord est généralement le premier écran affiché après la connexion à Dolibarr.

Il peut être personnalisé afin d’afficher les informations utiles au suivi de l’activité : éléments à traiter, indicateurs, raccourcis ou informations issues des modules activés.

''Vidéo sur le sujet :''
<youtube width="200" height="120">VieSairH_ZQ</youtube>

=Outils=

L’onglet « Outils » donne accès à différentes fonctions transversales de Dolibarr.

Les fonctions disponibles peuvent varier selon les modules activés, la configuration de l’instance et les permissions de l’utilisateur connecté.

''Vidéo sur le sujet :''
<youtube width="200" height="120">gbfLLlp14FA</youtube>

=Statistiques intégrées aux objets de Dolibarr=

Certains objets de Dolibarr disposent de statistiques ou d’indicateurs intégrés.

Ces informations permettent d’obtenir une vue synthétique sur les données enregistrées, selon les modules activés et les droits de l’utilisateur connecté.

''Vidéo sur le sujet :''
<youtube width="200" height="120">L_3Qft8MLXA</youtube>

=Utilisation des modules et applications=

Les fonctionnalités de Dolibarr sont réparties en modules, également appelés applications.

Savoir utiliser Dolibarr consiste généralement à comprendre les menus, les écrans et les actions disponibles dans les modules activés sur l’instance.

On distingue notamment :

*les modules standards, fournis avec la version de base de Dolibarr ;
*les modules externes, non inclus par défaut, qui peuvent être installés séparément.

Les modules externes peuvent notamment être recherchés sur la place de marché DoliStore : https://www.dolistore.com

Pour commencer, consulter d’abord la page suivante :

*[[Utilisation générale de Dolibarr]]

Une fois les principes généraux maîtrisés, il est conseillé de consulter la documentation propre à chaque module.

==Liste alphabétique des modules standards==

La liste alphabétique des modules standards est également disponible via la page [[:Category:Liste des Modules|Liste des Modules]].

{{#dpl:
|category=Liste_des_Modules
|ordermethod=title
|order=ascending
|format = <ul type="disc">,<li>[[%PAGE%]],</li>,</ul>
|columns=3
|rowcolformat=width=100%
}}

==Modules standards par domaine fonctionnel==

Le tableau ci-dessous propose un classement des principaux modules standards par domaine fonctionnel.

''Note : lorsque la documentation française d’un module n’est pas encore disponible, le lien peut pointer vers la page anglaise existante. Ces liens sont signalés par la mention « EN ».''

{| class="wikitable"
|+
!Domaine
!Modules natifs concernés
|-
|Gestion des ressources humaines
|
*[[Module Utilisateurs]]
*[[Module Adhérents]]
*[[Module Congés]]
*[[Module Notes de frais]]
*[[Module Recruitment|Module Recrutement]] (EN)
*[[Module GRH]]
|-
|Gestion de la relation client
|
*[[Module Tiers|Module Tiers / Sociétés]]
*[[Module Propositions commerciales - Devis]]
*[[Module Commandes Clients]]
*[[Module Expéditions]]
*[[Module Contrat]]
*[[Module Fiches d'interventions]]
*[[Module Ticket FR|Module Ticket]]
*[[Module Knowledge Management|Module Gestion des connaissances]] (EN)
*[[Module Partenariat]]
|-
|Gestion de la relation fournisseur
|
*[[Module Tiers|Module Tiers / Fournisseurs]]
*[[Module Fournisseurs Commandes|Module Commandes fournisseurs]]
*[[Module Fournisseurs Factures|Module Factures fournisseurs]]
*Demandes de prix fournisseurs
*[[Module Reception|Module Réceptions fournisseurs]] (EN)
*Incoterms
|-
|Comptabilité et trésorerie
|
*[[Module Factures Clients]]
*[[Module Fournisseurs Factures]]
*[[Module Taxes et charges spéciales]]
*[[Module Salaires]]
*[[Module Emprunt]]
*[[Module Dons]]
*[[Module Banques et Caisses]]
*Virements bancaires / SEPA fournisseurs
*[[Module Prélèvements bancaires]]
*[[Module Marges]]
*[[Module Comptabilité Simplifiée]]
*[[Module Comptabilité en Partie Double]]
*Rapport Intracomm / DEB-DES (expérimental)
*[[Module Asset|Module Immobilisations]] (EN, en développement)
|-
|Produits et services
|
*[[Module Produits]]
*[[Module Services]]
*[[Module Stock]]
*[[Module Lot / Série]]
*[[Module Produits|Variantes de produits]]
*[[Module BOM FR|Module Nomenclatures / BOM]]
*[[Module Ordres de Fabrication]]
*[[Module Prix dynamiques]] (expérimental)
*[[Module Workstation|Module Postes de travail]] (EN)
*Transferts de stock avancés (en développement)
|-
|Projets et travail collaboratif
|
*[[Module Projets]]
*[[Module Agenda FR|Module Agenda]]
*[[Module Ressources]]
*[[Module Event Organization|Module Organisation d'événements]] (EN)
|-
|Gestion électronique de documents
|
*GED / ECM
|-
|Outils multi-modules
|
*[[Module Catégories]]
*[[Module Éditeur WYSIWYG]]
*[[Module Multi-devise]]
*[[Module Flux RSS]]
*[[Module Marque pages]]
*[[Module Codes Barre]]
*[[Module Workflow FR|Module Workflow]]
*[[Module Imports FR|Module Imports]]
*[[Module Exports]]
*Étiquettes / autocollants (en développement)
*[[Module Politique de Données (RGPD)]] (expérimental)
*[[Module ModuleBuilder|Module ModuleBuilder]] (EN)
*[[Module AI (Artificial Intelligence)|Module IA]] (EN, expérimental)
|-
|Sites web et applications frontales
|
*[[Module Sondage]]
*[[Module Sites web]]
*[[Module WebPortal]] (expérimental)
*[[Module Point de vente (TakePOS)]]
*[[Module Caisse enregistreuse (SimplePOS)]]
|-
|Interfaces avec des systèmes externes
|
*Réseaux sociaux
*[[Module Notification FR|Module Notification]]
*[[Module Mailing]]
*[[Module Collecteur de courrier électronique]]
*[[Module Web Services API REST (developer)|Module API REST]] (EN, documentation développeur)
*[[Module Services Web API SOAP (développeur)|Module API SOAP]] (documentation développeur, obsolète)
*[[Module Webhook FR|Module Webhook]]
*[[Module Zapier|Module Zapier]] (EN, en développement)
*[[Module LDAP]]
*[[Module OAuth FR|Module OAuth]]
*Site externe
*[[Module FTP]]
*GeoIPMaxmind
*PayBox
*[[Module PayPal FR|Module PayPal]]
*[[Module Stripe FR|Module Stripe]]
*[[Module ClickToDial]]
*Impression en un clic
*[[Module Imprimante Reçu|Module Imprimante de reçu]]
*Mailman / SPIP
*[[Module Gravatar]]
*[[Module DAV|Module DAV / WebDAV]] (EN)
|-
|Système
|
*[[Module Scheduled jobs|Module Tâches planifiées]] (EN)
*Journaux de debug
*Barre de debug
*[[Module Archives - Journaux Inaltérables]]
|}

==Modules externes==

Les modules externes sont des modules non inclus par défaut dans Dolibarr.

La liste des modules externes complémentaires est disponible sur la page [[:Category:Modules_complémentaires|Modules complémentaires]].

=Autres sources de documentation=

Des ressources complémentaires peuvent aider à approfondir l’utilisation de Dolibarr :

*Guide d’utilisation « Dolibarr the Book » :
**[https://www.dolistore.com/fr/recherche?controller=search&orderby=position&orderway=desc&search_query=dolibarr+book&submit_search= fiche DoliStore]
**[https://compta.atoo-net.com/document.php?hashp=Jzox96AT6hlLoLb2xcBU099N5CV7pXv2 sommaire téléchargeable]
*Livres ''Bien gérer son entreprise avec Dolibarr'', parus aux [http://www.d-booker.fr éditions D-Booker] :
**[https://www.d-booker.fr/dolibarrservices3e/657-dolibarr-pour-societes-de-services-et-consultants-3ed.html Société de services et consultants]
**[https://www.d-booker.fr/dolibarrcomm2e/658-dolibarr-pour-commerce-et-production-de-biens-2ed.html Commerce et production de biens]
*[http://doc.ubuntu-fr.org/dolibarr#dolibarr Documentation Ubuntu-fr sur Dolibarr]

=FAQ et glossaire=

Toutes les foires aux questions sont disponibles via la page d’index [[:Category:FAQ FR|FAQ FR]].

Le glossaire est disponible sur la page [[Glossaire]].

=Tutoriels vidéo=

L’association Dolibarr propose des tutoriels vidéo sur les principales fonctionnalités de Dolibarr :

*[[Tutoriels Vidéos]]

Module DynamicPrices

2026-03-29T19:42:36Z

Mapiolca:

==DynamicPrices==

===Présentation===

'''DynamicPrices''' est un module externe pour Dolibarr permettant de mettre à jour dynamiquement les prix de vente à partir :

*des prix d'achat fournisseurs,
*des prix de revient,
*de règles de marge configurées dans des dictionnaires métier.

Le module permet d’automatiser une partie importante de la gestion tarifaire en s’appuyant sur :

*un dictionnaire de '''catégories commerciales''',
*un dictionnaire de '''taux de marge sur les prix de revient''',
*un dictionnaire de '''taux de marges sur les prix de vente''',
*des déclencheurs Dolibarr,
*une tâche planifiée de recalcul automatique,
*une proposition de mise à jour des prix d’achat fournisseur lors du passage de commande fournisseur.

Il est particulièrement adapté aux environnements dans lesquels les prix évoluent régulièrement en fonction des coûts fournisseurs, et où le recalcul manuel devient vite pénible. Ou franchement absurde, selon la taille du catalogue.

===Fonctionnalités principales===

Le module permet notamment de :

*calculer automatiquement les prix de revient à partir des prix d’achat,
*calculer automatiquement les prix de vente à partir de règles de marge,
*appliquer des règles selon une '''catégorie commerciale''',
*gérer plusieurs '''niveaux de prix''',
*recalculer les '''kits''' après leurs composants,
*exclure les '''services''' du recalcul automatique,
*proposer la mise à jour des prix d’achat lors de l’envoi ou du passage d’une commande fournisseur,
*historiser les anciens prix clients,
*automatiser les recalculs via les '''travaux planifiés'''.

===Illustration du module===
[[File:Illustration.png|alt=Illustration Dolistore|thumb|Illustration Dolistore]]
 

===Accès au module===

Une fois activé, le module s’utilise principalement depuis :

*'''Configuration > Modules/Applications''' pour l’activation et les réglages,
*'''Configuration > Dictionnaires''' pour les dictionnaires métier,
*les fiches '''Produits/Services''' pour l’affectation de la catégorie commerciale,
*les listes de produits pour l’affectation en masse,
*'''Accueil > Outils d'administration > Travaux planifiés''' pour l’automatisation.

===Public concerné===

Le module est utile pour :

*les entreprises ayant un catalogue produit important,
*les activités dont les prix dépendent fortement des tarifs fournisseurs,
*les structures utilisant plusieurs niveaux de prix,
*les catalogues avec kits ou nomenclatures,
*les organisations souhaitant homogénéiser leur logique tarifaire dans Dolibarr.

==Installation==

===Prérequis===

Le module doit être installé comme module externe Dolibarr dans le répertoire :

htdocs/custom/dynamicsprices

Modules/fonctionnalités Dolibarr recommandés :

*Produits/Services
*Fournisseurs
*Dictionnaires
*Travaux planifiés

===Installation du module===

#Copier le dossier `dynamicprices` dans `htdocs/custom/`
#Se connecter à Dolibarr avec un compte administrateur
#Aller dans '''Configuration > Modules/Applications'''
#Rechercher '''Prix de vente dynamiques'''
#Activer le module

[[File:Activation du module DynamicPrices.png|alt=Capture d’écran de la page Modules/Applications de Dolibarr avec le module Prix de vente dynamiques activé.|thumb|472x472px|Activation du module DynamicPrices dans la liste des modules Dolibarr.]]
 

===Vérifications après activation===

Après activation, il est recommandé de vérifier :

*l’accès à la page de configuration du module,
*la présence des dictionnaires créés par le module,
*la présence de l’extrafield '''Catégorie commerciale''',
*la disponibilité de la tâche planifiée du module.

==Configuration==

===Réglages du module===

Le module propose plusieurs options de paramétrage, parmi lesquelles :

*mise à jour des prix de vente uniquement sur la base des prix de revient,
*actualisation automatique des prix de vente lors des changements de prix d’achat,
*proposition d’ajout ou de mise à jour des prix d’achat depuis les commandes fournisseurs,
*calcul des prix des kits à partir de la vente des composants.

[[File:Réglages du module DynamicPrices.png|alt=Capture d’écran de la page de réglages du module DynamicPrices avec plusieurs interrupteurs d’activation.|thumb|Paramétrage des options de mise à jour des prix dans DynamicPrices.]]
 

===Dictionnaires du module===

Le module crée les dictionnaires suivants :

*'''Catégories commerciales'''
*'''Taux de marge sur les prix de revient'''
*'''Taux de marges sur les prix de vente'''

[[File:Dictionnaires créés par le module.png|alt=Capture d’écran de la liste des dictionnaires DynamicPrices dans Dolibarr avec trois entrées : marges de vente, marges de revient et catégories commerciales.|thumb|Dictionnaires métier ajoutés par le module DynamicPrices.]]
 

===Configuration des catégories commerciales===

Les catégories commerciales constituent le référentiel métier utilisé par le module pour appliquer les règles tarifaires.

Exemple :

*Code : `MOD`
*Libellé : `Modules Photovoltaïques`

[[File:Configuration des catégories commerciales.png|alt=Capture d’écran du dictionnaire Catégories commerciales avec une ligne de catégorie nommée Modules Photovoltaïques.|thumb|Exemple de catégorie commerciale utilisée par DynamicPrices.]]
 

===Configuration des taux de marge sur les prix de revient===

Ce dictionnaire permet de définir les taux de marge utilisés pour calculer les prix de revient selon la catégorie commerciale.
[[File:Configuration des taux de marge sur les prix de revient.png|alt=Capture d’écran du dictionnaire des taux de marge sur les prix de revient avec une catégorie commerciale et un taux associé.|thumb|Paramétrage des marges appliquées au calcul du prix de revient.]]
 

===Configuration des taux de marge sur les prix de vente===

Ce dictionnaire permet de définir, pour chaque catégorie commerciale et chaque niveau de prix :

*le taux de marge cible,
*le taux de marge minimum.

[[File:Configuration des taux de marge sur les prix de vente.png|alt=Capture d’écran du dictionnaire des taux de marge sur les prix de vente avec un niveau de prix, une marge cible et une marge minimum.|thumb|Paramétrage des marges de vente par catégorie commerciale et niveau de prix.]]
 

==Utilisation==

===Affectation de la catégorie commerciale sur les produits===

Une fois les dictionnaires configurés, la catégorie commerciale doit être affectée aux produits concernés via l’extrafield dédié.
[[File:Affectation de la catégorie commerciale sur la fiche produit.png|alt=Capture d’écran d’une fiche produit Dolibarr affichant l’extrafield Catégorie commerciale renseigné.|thumb|Affectation d’une catégorie commerciale directement sur une fiche produit.]]
 

===Affectation en masse===

L’affectation peut également être réalisée depuis la liste des produits grâce à une action de masse de modification d’extrafield.
[[File:Sélection de l’action de masse pour modifier la catégorie commerciale.png|alt=Capture d’écran de la liste des produits avec plusieurs lignes cochées et le menu d’actions de masse ouvert.|thumb|Lancement de l’action de masse de modification d’extrafield sur plusieurs produits.]]
[[File:Modification en masse de l’extrafield Catégorie commerciale.png|alt=Capture d’écran du formulaire de modification en masse avec sélection de l’extrafield Catégorie commerciale.|thumb|Affectation en masse de la catégorie commerciale sur plusieurs produits.]]
 

===Calcul du prix de revient===

Le module peut calculer automatiquement le prix de revient à partir :

*de la moyenne des prix d’achat,
*de la catégorie commerciale,
*du dictionnaire de marge sur les prix de revient.

Sur la fiche produit, cela permet notamment de consulter :

*le prix de revient,
*le meilleur prix d’achat,
*les prix fournisseurs.

[[File:Calcul et consultation du prix de revient.png|alt=Capture d’écran de l’onglet Prix d’achat d’un produit avec prix de revient, meilleur prix d’achat et liste des fournisseurs.|thumb|Visualisation du prix de revient et des prix fournisseurs sur une fiche produit.]]
 

===Calcul des prix de vente===

Le module peut recalculer automatiquement les prix de vente à partir :

*du prix d’achat moyen ou du prix de revient,
*de la catégorie commerciale,
*du niveau de prix,
*des taux de marge configurés.

Le module conserve également un historique des prix clients précédents.
[[File:Historique des prix de vente calculés.png|alt=Capture d’écran du tableau d’historique des prix clients précédents avec colonnes niveau de prix, base, prix HT, TTC et minimum.|thumb|Historique des prix de vente générés par DynamicPrices.]]
 

===Mise à jour des prix d'achat fournisseur lors du passage de commande fournisseur===

Lors du passage d'une commande fournisseur, le module peut détecter les différences entre le prix d'achat actuellement enregistré sur le produit et le prix présent sur la commande fournisseur.

Si des écarts sont détectés, une fenêtre de confirmation permet de :

*visualiser les lignes concernées,
*comparer le prix actuel et le prix proposé,
*identifier l'écart et son évolution,
*sélectionner les lignes à mettre à jour,
*enregistrer immédiatement les nouveaux prix d'achat fournisseur.

Cette fonctionnalité permet :

*de fiabiliser les prix d'achat enregistrés dans Dolibarr,
*de détecter rapidement les hausses et les baisses de tarifs fournisseurs,
*d'améliorer la cohérence des bases utilisées ensuite pour les calculs de prix de revient et de prix de vente.

[[File:Proposition de mise à jour des prix d’achat fournisseur depuis une commande fournisseur.png|alt=Capture d’écran d’une commande fournisseur avec une fenêtre modale comparant le prix d’achat actuel et le prix proposé pour mise à jour.|thumb|Fenêtre de contrôle des écarts de prix d’achat détectés sur une commande fournisseur.]]
 

==Automatisation==

===Travaux planifiés===

Le module fournit une tâche planifiée permettant de recalculer automatiquement les prix de vente.
[[File:Travaux planifiés du module DynamicPrices.png|alt=Capture d’écran de la liste des travaux planifiés avec une ligne de mise à jour automatique des prix de vente pour le module DynamicPrices.|thumb|Tâche planifiée DynamicPrices dans la liste des travaux planifiés Dolibarr.]]
[[File:Configuration de la tâche planifiée de mise à jour des prix.png|alt=Capture d’écran de la fiche d’un travail planifié DynamicPrices avec fréquence quotidienne et méthode updatePrices.|thumb|Détail de la tâche planifiée utilisée pour automatiser le recalcul des prix.]]

Cette tâche permet d’automatiser le recalcul périodique des prix en fonction :

*des prix d’achat,
*des prix de revient,
*des catégories commerciales,
*des dictionnaires de marge configurés.

==Logique générale==

===Référentiel métier===

Le module s’appuie sur un dictionnaire de '''catégories commerciales''' pour piloter les règles de calcul.

Cette approche permet de dissocier la logique tarifaire du simple type ou de la nature du produit, et offre un paramétrage plus souple.

===Recalcul des prix de revient===

Le prix de revient peut être recalculé automatiquement à partir de la moyenne des prix d’achat et des taux définis dans le dictionnaire correspondant.

===Recalcul des prix de vente===

Le prix de vente peut être recalculé automatiquement :

*lors de la création d’un prix d’achat,
*lors de la modification d’un prix d’achat,
*lors de la suppression d’un prix d’achat,
*lors du recalcul du prix de revient,
*via la tâche planifiée.

===Mise à jour des prix d'achat fournisseur===

Le module peut intervenir au moment du passage d'une commande fournisseur pour proposer la mise à jour des prix d'achat enregistrés sur les produits.

Lorsque le prix figurant sur la commande diffère du prix d'achat fournisseur déjà connu, le module affiche une interface de contrôle permettant à l'utilisateur de décider quelles lignes doivent être enregistrées.

Cette logique permet de conserver une base d’achat plus fidèle à la réalité fournisseur, ce qui améliore ensuite la pertinence :

*du calcul du prix de revient,
*du calcul du prix de vente,
*de l’analyse des évolutions tarifaires fournisseurs.

===Gestion des kits===

Les kits sont recalculés après leurs composants afin :

*d’éviter les doublons de calcul,
*de refléter correctement le coût cumulé,
*de garantir une meilleure cohérence tarifaire.

===Gestion des services===

Les services ne sont pas recalculés automatiquement par le module.

Le re-calcul automatique est réservé aux produits physiques afin d’éviter des mises à jour non souhaitées sur des articles qui suivent souvent une logique commerciale différente.

==Bonnes pratiques==

Pour un usage fiable du module, il est recommandé de :

*définir une nomenclature claire des catégories commerciales,
*renseigner les dictionnaires avant d’activer les automatismes,
*affecter correctement la catégorie commerciale à tous les produits concernés,
*tester les calculs sur un échantillon réduit avant généralisation,
*surveiller les résultats des travaux planifiés,
*vérifier régulièrement les prix fournisseurs,
*contrôler les kits après modification des composants.

==Voir aussi==

*[[Module Produits|Module Produits/Services]]
*[[Module Fournisseurs Commandes|Module Fournisseurs]]
*[[Paramétrage Dictionnaires|Paramétrage dictionnaires]]
*[[Travaux planifiés]]

File:Configuration de la tâche planifiée de mise à jour des prix.png

2026-03-29T19:35:07Z

Mapiolca:

Fiche détaillée de la tâche planifiée DynamicPrices indiquant la classe appelée, la méthode exécutée, la fréquence de lancement et le suivi des exécutions.

File:Travaux planifiés du module DynamicPrices.png

2026-03-29T19:34:28Z

Mapiolca:

Liste des travaux planifiés Dolibarr montrant la tâche de mise à jour automatique des prix de vente ajoutée par le module.

File:Proposition de mise à jour des prix d’achat fournisseur depuis une commande fournisseur.png

2026-03-29T19:33:15Z

Mapiolca:

Fenêtre de confirmation affichée lors du passage d’une commande fournisseur, permettant de comparer le prix d’achat actuel et le prix proposé, puis d’enregistrer les mises à jour sélectionnées.

File:Historique des prix de vente calculés.png

2026-03-29T19:32:16Z

Mapiolca:

Tableau d’historique des anciens prix clients montrant les valeurs calculées par le module pour un niveau de prix donné, avec prix HT, TTC et prix minimum.