Visión general
El módulo de Reparaciones administra boletas de servicio técnico: recepción de equipos, cotización de repuestos, seguimiento del estado, facturación (contado/crédito) o rebaja como gasto.
| Módulo | Código | Función |
|---|---|---|
| Lista de Boletas | RE-001 | Consulta, búsqueda y gestión global |
| Edición de Boleta | RE-002 | Crear/editar cabecera, repuestos, bitácora y acciones |
| Wizard Nueva Boleta | MRE-005 | Modal rápido para crear boleta desde la lista |
| Rebajar como Gasto | MRE-004 | Modal para boletas INTERNAS o GARANTIA |
Lista de Boletas RE-001Permiso 473
Listado paginado de todas las boletas de reparación. Muestra estado, cliente, equipo, detalle y tipo.
Filtros
- Desde / Hasta — Rango de fechas (por defecto: mes actual)
- Estado — 1 al 8. Por defecto excluye ENTREGADO (7)
- Tipo — EXTERNA / INTERNA / GARANTIA
- Cliente, Equipo, Detalle, Observaciones — Búsqueda parcial (LIKE)
Columnas
- Dot de estado — Click abre popover para cambiar estado sin entrar a edición
- Boleta — Número consecutivo
- Fecha — Ingreso al taller
- Cliente — Nombre + Id
- Equipo / Detalle / Observaciones — Con tooltip al pasar el mouse
- Tipo Boleta
Acciones
- Nuevo — Abre el wizard de nueva boleta (MRE-005)
- Editar — Abre RE-002 con la boleta seleccionada (o doble-click en la fila)
- Estado — Cambia el estado de la boleta seleccionada
- Refrescar — Vuelve a ejecutar la búsqueda actual
- Imprimir — Genera HTML A4 landscape del listado
- Excel — Descarga el listado filtrado en XLSX
Atajos de teclado
- ↑ ↓ — Navegar filas
- Enter — Abrir edición
- F5 — Refrescar
Wizard Nueva Boleta MRE-005Permiso 471
Asistente que captura los datos esenciales antes de abrir la ficha completa. Se dispara desde:
- Botón "Nuevo" dentro del listado RE-001.
- Opción "Nueva Boleta" del menú principal (Reparaciones → Nueva Boleta) — abre el listado con el wizard ya desplegado.
Campos requeridos
- Cliente — Buscar existente o crear uno nuevo desde el mismo modal
- Equipo — Marca, modelo y serie (máx 100 caracteres)
- Detalle del problema — Descripción reportada por el cliente (máx 500)
- Tipo — EXTERNA (cobrable), INTERNA o GARANTIA (gasto)
Campo opcional
- Fecha de entrega estimada — Puede editarse después en RE-002
Al confirmar, la boleta se crea en estado 1 RECIBIDO, se refresca la lista y se abre RE-002 en una nueva pestaña para agregar repuestos y continuar el flujo.
Edición de Boleta RE-002Permiso 472
Ficha completa de la boleta. Layout de dos columnas: izquierda con datos + repuestos, derecha con bitácora.
Cabecera
- Boleta — Número (Enter = consultar; 0 o vacío = nueva con consecutivo automático)
- Fecha — Solo lectura (fecha de creación)
- Estado — Solo lectura; se cambia desde el stepper
- Tipo — Editable mientras la boleta no esté en estado 8 (GASTOS)
- Usuario / Entrega
- Proforma / Factura — Asociadas cuando la boleta se convierte
Cliente y equipo
- Buscar cliente — Reutiliza el modal global de clientes
- Editar cliente — Abre la ficha del cliente seleccionado
- Nuevo cliente — Crea uno y lo selecciona automáticamente
- Equipo — Marca/modelo/serie (100 chars)
Detalle y observaciones
- Detalle del problema — Lo reportado por el cliente (500 chars)
- Observaciones / Notas Taller — Notas internas del técnico (500 chars)
Estados y Stepper
El ciclo de vida de una boleta sigue 7 estados lineales más el 8 (gasto, rama alterna).
| Cod | Estado | Significado |
|---|---|---|
| 1 | RECIBIDO | Equipo ingresó al taller |
| 2 | PRESUPUESTO | Se preparó cotización (proforma) |
| 3 | REPARACION | Entró a área de reparación |
| 4 | TALLER | En proceso con el técnico |
| 5 | REPARADA | Listo para retirar/facturar |
| 6 | FACTURACION | Se está procesando la factura |
| 7 | ENTREGADO | Equipo entregado al cliente (final) |
| 8 | GASTOS | Rama alterna: INTERNA / GARANTIA |
Cambio de estado
En RE-002 se hace click sobre cualquier paso del stepper. En RE-001 se hace click en el dot de estado de la fila. En ambos casos se registra el cambio en bitácora y, por defecto, se envía un email al cliente.
Repuestos Permiso 474
Líneas de artículos o servicios que forman parte de la reparación.
Operaciones
- Agregar — Abre el buscador global de artículos (
articulos_buscar) - Editar inline — Cantidad, precio y descuento se editan en la misma fila
- Eliminar — Poner cantidad en 0
Totales
- Subtotal — Suma de (precio × cantidad)
- Descuento — Suma de descuentos aplicados
- Impuesto — IVA calculado sobre base descontada
- Total — Base + impuesto, redondeado a 2 decimales
Bitácora / Notas Permiso 474
Historial append-only de eventos de la boleta, visible en el panel derecho de RE-002.
Eventos automáticos
- Creación de la boleta
- Cambios de estado (antes → después)
- Modificaciones de cabecera
- Eliminación de proforma asociada
Notas manuales
Se escriben en el input superior del panel y se agregan con Enter o click en "Agregar Nota" (máx 300 chars).
Notificar al cliente
Checkbox "Notificar al cliente" envía la nota por email al EmailFactura del cliente. La preferencia se recuerda en localStorage.
Facturación (solo EXTERNAS)
Flujo comercial: boleta → proforma → factura contado o crédito.
Paso 1 — Convertir a Proforma
Botón "Convertir a Proforma" al pie de RE-002. Genera una ProformaMadre + ProformaHija con los repuestos de la boleta. Aparece un aviso azul con el número de proforma.
Paso 2 — Facturar
Desde el aviso de proforma se muestran tres botones:
- Abrir — Navega a la proforma en el módulo de cotizaciones
- Facturar Contado — Convierte directo a factura de contado
- Facturar Crédito — Convierte a factura de crédito
Ambos flujos usan los componentes estándar cotizacion_convertir_factura_contado y cotizacion_convertir_factura_credito, con modal de progreso y rastreo completo.
Rebajar como Gasto MRE-004
Flujo alterno para boletas INTERNAS o de GARANTIA: no se factura al cliente sino que se rebaja del inventario como gasto interno.
Datos del modal
- Cuenta de Gasto — Búsqueda por código o nombre (requerida)
- Cuenta de Inventario — Contra qué cuenta se rebaja (requerida)
- Comentario — Opcional, se registra en bitácora
Efecto contable
Se genera un asiento:
- DEBE Cuenta Gasto
- HABER Cuenta Inventario
Y se rebaja inventario con tipo de movimiento GAS. La boleta pasa a estado 8 GASTOS y se bloquea para edición.
Impresión Permiso 476
RE-002 ofrece dos opciones de impresión:
Imprimir Carta (HTML A4)
El botón "Imprimir Carta" abre un reporte HTML A4 optimizado para PDF o papel, con Paged.js para soporte de headers/footers recurrentes en páginas 2+.
- Portada con logo y datos de la empresa
- Info cards: Boleta, Estado, Tipo, Fecha recibido, Fecha entrega
- Cliente y equipo
- Detalle del problema y observaciones
- Tabla de costos/repuestos con totales
- Bitácora de eventos
- Términos y condiciones (parámetro 82)
- 3 firmas: Recibido, Cliente, Entregado
Imprimir POS (ticket)
El botón "Imprimir POS" envía la boleta a la impresora de comprobantes de la estación vía socket. No abre ventana de navegador — imprime directamente en la térmica configurada en Estaciones.ImpCompNum (formato MODCONF000/MODCONF100).
- Encabezado con nombre comercial, cédula y teléfono de la empresa
- Número de boleta (centrado)
- Recibido / Entrega / Estado / Tipo
- Cliente, equipo, detalle del problema y observaciones
- Repuestos con cantidad, descripción y total por línea + Subtotal / Descuento / Impuesto / TOTAL
- Términos y condiciones (parámetro 82)
- Línea para firma del cliente
- Footer con usuario y fecha de impresión
Impresión sin color (carta — ahorro de tinta)
Permisos
| Permiso | Alcance |
|---|---|
| 471 | Crear / editar cabecera de boleta (incluye wizard MRE-005) |
| 472 | Acceso al módulo de edición (RE-002) |
| 473 | Acceso al listado (RE-001) y cambios rápidos de estado |
| 474 | Agregar/editar repuestos y eventos (bitácora) |
| 475 | Cambiar estado de la boleta |
| 476 | Imprimir boleta |