Módulo de gestión de taller de reparaciones para Dolibarr 18+ (recomendado 20+). Gestiona el ciclo de vida completo de una reparación: recepción del equipo → diagnóstico → cotización → reparación → entrega → facturación, integrado con los módulos nativos de Dolibarr (Terceros, Productos, Presupuestos, Pedidos, Facturas, Stock y Agenda).
Sirve para talleres automotrices y también de cómputo, celulares, electrodomésticos, impresoras, audio/video y herramientas — los campos del equipo se adaptan al tipo.
Además del flujo de reparación, el módulo tiene un segundo tipo de orden — acondicionamiento de unidades — pensado específicamente para talleres vehiculares (preparación de un vehículo para entrega/venta, con su propio ciclo de aprobación, materiales, producción y control de calidad; ver sección 5).
1. Instalación y activación
- Copiar la carpeta
vivestallerahtdocs/custom/(odolibarr/custom/). - Ir a Inicio → Configuración → Módulos y buscar "VivesTaller".
- Pulsar el interruptor para activar. Esto crea las tablas, menús, permisos y diccionarios.
- Módulos requeridos: Terceros y Productos/Servicios. Recomendados: Presupuestos, Pedidos, Facturas, Stock, Agenda.
Configuración inicial
En la rueda dentada del módulo (o VivesTaller → Configuración):
- General: prefijos de numeración (equipos
EQ, órdenesREC). - Numeración: módulo de numeración activo para equipos y órdenes (
EQ-0001,REC-AAAA-0001). - Diccionarios: marcas, tipos de equipo, tipos de combustible, tipos de servicio, niveles de combustible.
- Plantillas PDF: plantilla por defecto de la orden (
standard_recepcion).
2. Permisos
En Usuarios y grupos → ficha del usuario/grupo → Permisos → VivesTaller:
| Permiso | Qué permite |
|---|---|
| Leer equipos / órdenes | Ver listas y fichas |
| Crear/Modificar | Alta y edición de equipos, órdenes, líneas, checklist, incidencias |
| Eliminar | Borrar registros |
| Validar órdenes | Pasar la orden de Borrador a Recibido |
| Cotizar | Generar cotización o pedido desde la orden |
| Facturar | Generar la factura desde la orden |
| Tiempos | Registrar/eliminar tiempos de operario |
| Ver todas las órdenes | Incluye las de otros usuarios |
Los administradores tienen todos los permisos automáticamente.
3. Equipos
Menú: VivesTaller → Equipos → Nuevo equipo
- Elegir el propietario (tercero) y el tipo de equipo.
- Si el tipo es Automotriz aparecen los campos placa, VIN, kilometraje, combustible, transmisión. Para los demás tipos: número de serie, marca, modelo y descripción del estado.
- Guardar — la referencia (
EQ-0001) se genera sola.
Cada equipo conserva su historial de órdenes, documentos y notas en sus pestañas.
4. Ciclo de vida de una orden de reparación
Esta sección describe el flujo de Reparación (el tipo de orden por defecto, disponible para cualquier tipo de equipo). Para el flujo de Acondicionamiento (exclusivo de talleres vehiculares) ver la sección 5.
Borrador → Recibido → En Diagnóstico → Esperando Aprobación → En Reparación → Listo → Entregado
(Cancelado en cualquier punto intermedio)
4.1 Recepción del equipo
VivesTaller → Órdenes → Nueva orden
- Seleccionar el equipo (buscador) y el cliente.
- Capturar falla manifestada, tipo de servicio, técnico asignado, kilometraje/combustible si aplica.
- Crear → la orden nace en Borrador con su referencia
REC-AAAA-NNNN. - Pulsar Validar → estado Recibido (se anota el evento en la Agenda).
4.2 Checklist fotográfico (evidencia)
Pestaña Checklist fotográfico:
- Automotriz: secciones Carrocería, Interior, Mecánico, Pertenencias (360°).
- Genérico: Estado general y Pertenencias.
- Por cada elemento: estado (bueno/rayado/golpeado/faltante/roto), severidad, observaciones y foto de evidencia (con miniatura).
- El checklist se imprime en el PDF de la orden — protección ante reclamos.
4.3 Diagnóstico y líneas de trabajo
- Botón Diagnosticar → estado En Diagnóstico; capturar el diagnóstico (Modificar).
- En la tabla de líneas (idéntica a una cotización de Dolibarr):
- Entrada libre tipo Servicio → mano de obra (precio, IVA, cantidad/horas).
- Productos/servicios predefinidos → refacciones del catálogo, con su precio e IVA; el selector muestra el stock disponible.
- En Avance de trabajos cada línea tiene su técnico y su estado: Iniciar → Terminar (con fechas reales).
4.4 Tiempos de operario
Pestaña Tiempos:
- Registrar fecha, operario, duración (h/m), nota y opcionalmente el servicio relacionado.
- La tarifa/h se toma del THM de la ficha del usuario (o se captura manual).
- Resumen automático: total de horas y costo de mano de obra por operario.
4.5 Cotización, pedido y factura — botón "Crear"
El botón Crear despliega (según módulos activos, estado y permisos):
| Opción | Cuándo | Efecto |
|---|---|---|
| Crear cotización | Recibido → Esperando aprobación | Presupuesto con las líneas copiadas; al enviarla la orden pasa a Esperando Aprobación |
| Crear pedido | Tras la aprobación | Pedido de cliente con las líneas |
| Crear factura | Listo / Entregado | Factura con las líneas |
Todos quedan vinculados (bloque Objetos relacionados, navegable en ambos sentidos).
Stock: las refacciones descuentan inventario por el ciclo natural de Dolibarr — al validar el envío del pedido o al validar la factura, según la configuración del módulo Stock (Incrementar/decrementar stock). El taller no hace movimientos de stock propios.
4.6 Incidencias
Pestaña Incidencias: bitácora cronológica de eventos durante la reparación (técnica, cliente, proveedor, refacción) con prioridad; edición en línea y cierre con solución.
4.7 Entrega
- Botones Reparar → Listo → Entregar según avance (cada cambio queda en la Agenda).
- Generar el PDF de la orden (bloque Archivos vinculados → Generar): incluye datos del taller y cliente, equipo y nº de serie, falla, trabajos realizados con importes, totales, estado del equipo al recibirlo y firmas de cliente/taller.
- Crear la factura si no se hizo desde el pedido.
5. Acondicionamiento de unidades (talleres vehiculares)
Además de reparar por una falla, muchos talleres vehiculares necesitan preparar una unidad para entrega o venta (limpieza, detallado, inspección de más de un punto, adecuaciones menores) sin que exista un desperfecto reportado. Para eso existe el segundo tipo de orden, Acondicionamiento, con su propia numeración, su propio ciclo de estados y una pestaña de Control de calidad.
5.1 Iniciar un acondicionamiento
VivesTaller → Acondicionamientos → Nuevo acondicionamiento
- Seleccionar el equipo (vehículo) y, si el vehículo ya tiene propietario registrado, el cliente se autocompleta y se bloquea automáticamente — no hay que volver a elegirlo (ver 5.6).
- Crear → nace en borrador con su propia referencia
ACO-AAAA-NNNN(independiente de la numeraciónREC-de reparaciones).
5.2 Ciclo de vida propio
Aprobada → Materiales → Producción → Control de calidad → Terminada → Entregada
(Cancelada en cualquier punto intermedio)
Cada avance de etapa puede requerir un permiso específico (Aprobar, Producción, Calidad) según cómo se configuren los permisos del grupo/usuario — si a alguien le falta el permiso o la transición no aplica para el estado actual, el sistema explica el motivo en pantalla en vez de fallar en silencio.
5.3 Contactos y roles del acondicionamiento
Pestaña Contactos: además de los contactos estándar de Dolibarr, este flujo trae roles propios para asignar responsables por unidad:
| Rol | Para qué |
|---|---|
| Gerente de producción | Supervisión general del acondicionamiento |
| Supervisor de área | Responsable de la etapa de producción |
| Control de calidad | Quién evalúa los criterios de calidad |
| Jefe de taller | Responsable operativo |
| Técnico responsable | Ejecuta el trabajo |
| Solicitante | Quién pidió el acondicionamiento |
| Contacto de entrega | Quién recibe la unidad terminada |
5.4 Control de calidad
Pestaña Control de calidad (solo visible en órdenes de acondicionamiento):
- Lista los criterios de calidad activos del diccionario del módulo (configurables en Configuración → Diccionarios).
- Por cada criterio se marca: Cumple / No cumple / N/A / Sin evaluar, con observación opcional.
- Muestra un resumen (cuántos cumplen, cuántos no, cuántos N/A, cuántos faltan por evaluar).
- Es informativa: no bloquea el avance de la orden de un estado a otro; sirve como checklist de salida de calidad, no como candado.
Si la orden tiene una plantilla aplicada (ver 5.5), esta pestaña muestra solo los criterios que la plantilla asignó, en vez de todos los criterios activos del diccionario — así cada tipo de vehículo se evalúa contra su propio checklist de calidad.
5.5 Plantillas de Acondicionamiento
Para no repetir la misma captura de líneas y criterios en cada unidad del mismo tipo, se pueden crear plantillas reutilizables por tipo de vehículo (automóvil, motocicleta, camión, camioneta, furgoneta o SUV).
Crear una plantilla — VivesTaller → Plantillas → Nueva plantilla:
- Darle un nombre y elegir el tipo de vehículo al que aplica.
- Agregar líneas — igual que en una cotización: entrada libre (mano de obra) o productos/servicios del catálogo (materiales).
- Marcar los criterios de calidad que esta plantilla debe evaluar (checkboxes).
- Guardar — queda con su propia referencia
PLAN-0001.
Solo puede haber una plantilla activa por tipo de vehículo; si intentas activar una segunda para el mismo tipo, el sistema te avisa (sin bloquear el guardado, por si de verdad quieres tener varias y decidir cuál dejar activa).
Aplicar una plantilla a una orden:
- Abrir un acondicionamiento (etapa Materiales o anterior) sobre un vehículo cuyo tipo tenga una plantilla activa.
- Aparece el botón Aplicar plantilla → al confirmar, se agregan automáticamente todas las líneas de la plantilla (los materiales toman el precio vigente del catálogo, no el precio guardado en la plantilla) y la pestaña de Control de calidad queda filtrada a los criterios de esa plantilla.
- Una plantilla solo se puede aplicar una vez por orden (el botón desaparece después).
Nota de alcance: las Plantillas de Acondicionamiento son exclusivas de talleres vehiculares — se clasifican por tipo de vehículo (carrocería), no por el tipo genérico de equipo que usa el resto del módulo (cómputo, celular, electrodoméstico, etc.), que sigue funcionando igual que antes para reparaciones.
5.6 Derivación automática del cliente
Al crear un acondicionamiento (o una reparación) desde cero eligiendo un equipo que ya tiene propietario registrado, el campo Cliente se rellena solo y queda bloqueado — evita capturarlo dos veces y evita inconsistencias entre el dueño real del vehículo y el cliente de la orden. Si el equipo no tiene propietario, el campo Cliente sigue siendo editable y obligatorio.
6. Listados y búsqueda
VivesTaller → Órdenes → Lista: listado estándar Dolibarr con columnas configurables (icono de columnas), filtros por columna, acciones masivas y vista kanban.
Para encontrar una orden, busca en el filtro Equipo por número de serie o placa (texto libre — también marca/modelo o referencia del equipo).
7. Dónde se ve cada cosa
| Información | Dónde |
|---|---|
| Cotización/pedido/factura de una orden | Card de la orden → Objetos relacionados |
| La orden desde la factura o el presupuesto | Card de la factura/presupuesto → Objetos relacionados |
| Historial de eventos (validación, cambios de estado, documentos creados) | Card → Últimos eventos y pestaña Eventos |
| PDF y archivos de la orden | Card → Archivos vinculados y pestaña Archivos |
| Fotos del checklist | Pestaña Checklist fotográfico (miniaturas) |
| Horas y costo de mano de obra | Pestaña Tiempos |
| Criterios de calidad de un acondicionamiento | Pestaña Control de calidad (solo en órdenes tipo Acondicionamiento) |
| Plantilla aplicada a un acondicionamiento | Card de la orden → botón Aplicar plantilla (desaparece una vez aplicada) |
| Líneas y criterios de una plantilla | VivesTaller → Plantillas → card de la plantilla |
8. Preguntas frecuentes
¿Puedo usarlo para un taller que no es de coches? Sí, para reparaciones. Crea el equipo con el tipo correspondiente (cómputo, celular, etc.); los campos automotrices se ocultan y el checklist pasa al modo simplificado. Las Plantillas de Acondicionamiento (sección 5.5) son exclusivas de talleres vehiculares.
¿Por qué no aparece "Crear factura" en el botón Crear? La factura solo se ofrece con la orden en estado Listo o Entregado, sin factura previa vinculada, con el módulo Facturas activo y el permiso Facturar.
¿Cómo descuento el stock de una refacción? No se descuenta desde el taller: crea el pedido y dale salida con su envío, o crea la factura — según cómo tengas configurado el módulo Stock.
¿Cuál es la diferencia entre una orden de Reparación y una de Acondicionamiento?
La Reparación atiende una falla reportada y sigue el ciclo Borrador→...→Entregado (sección 4). El Acondicionamiento prepara una unidad vehicular sin falla reportada, tiene su propia numeración (ACO-), su propio ciclo Aprobada→...→Entregada, contactos con roles propios y una pestaña de Control de calidad (sección 5).
¿Por qué no veo el botón "Aplicar plantilla" en mi acondicionamiento? Se necesitan tres cosas a la vez: la orden debe estar en la etapa Materiales o antes, el vehículo debe tener su tipo de vehículo capturado, y debe existir una plantilla activa para ese tipo. Si ya se aplicó una plantilla a esa orden, el botón no vuelve a aparecer.
¿Por qué en Control de calidad solo veo algunos criterios y no todos los del diccionario? Porque la orden tiene una plantilla aplicada y esa plantilla marcó solo esos criterios como aplicables a ese tipo de vehículo. Las órdenes sin plantilla aplicada siguen mostrando todos los criterios activos.
¿La tarifa por hora de un operario? Se define en la ficha del usuario (campo THM, pestaña RRHH). El registro de tiempos la toma automáticamente; puedes sobrescribirla por registro.
El cliente quiere comprobante de cómo dejó su equipo. Genera el PDF de la orden: incluye el checklist de recepción con el estado de cada elemento y las cajas de firma.