Reparaciones AY-035

Boletas de reparación: recepción, cotización, facturación e impresión

Menú Ayuda

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óduloCódigoFunción
Lista de BoletasRE-001Consulta, búsqueda y gestión global
Edición de BoletaRE-002Crear/editar cabecera, repuestos, bitácora y acciones
Wizard Nueva BoletaMRE-005Modal rápido para crear boleta desde la lista
Rebajar como GastoMRE-004Modal 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

  1. Cliente — Buscar existente o crear uno nuevo desde el mismo modal
  2. Equipo — Marca, modelo y serie (máx 100 caracteres)
  3. Detalle del problema — Descripción reportada por el cliente (máx 500)
  4. 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.

Escape cierra el wizard sin crear la boleta.

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)
Solo el estado 8 GASTOS bloquea la edición (es inmutable). Las boletas en estado 7 ENTREGADO permiten editar detalles y cambiar de estado, pero ya no se pueden facturar.

Estados y Stepper

El ciclo de vida de una boleta sigue 7 estados lineales más el 8 (gasto, rama alterna).

CodEstadoSignificado
1RECIBIDOEquipo ingresó al taller
2PRESUPUESTOSe preparó cotización (proforma)
3REPARACIONEntró a área de reparación
4TALLEREn proceso con el técnico
5REPARADAListo para retirar/facturar
6FACTURACIONSe está procesando la factura
7ENTREGADOEquipo entregado al cliente (final)
8GASTOSRama 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.

El correo al cliente incluye el nuevo estado con un mensaje humano predefinido. Se puede desactivar desmarcando "Notificar 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
Si ya existe una proforma asociada y se modifican los repuestos, la proforma se elimina automáticamente para evitar inconsistencias. Se vuelve a generar al convertir.

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.

Si la boleta ya fue facturada, la proforma queda bloqueada para evitar cambios retroactivos.

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
El ancho del tiquete se toma de ImpCompAncho de la estación (típicamente 32 para 58mm o 48 para 80mm). Si falla la conexión al socket, se muestra un toast con el error.

Impresión sin color (carta — ahorro de tinta)

Actualización 2026-04-19: El reporte carta se imprime con fondos blancos y bordes/textos negros en lugar de los azules corporativos originales. Esto reduce el consumo de tinta de color. El logo de la empresa conserva sus colores originales.

Permisos

PermisoAlcance
471Crear / editar cabecera de boleta (incluye wizard MRE-005)
472Acceso al módulo de edición (RE-002)
473Acceso al listado (RE-001) y cambios rápidos de estado
474Agregar/editar repuestos y eventos (bitácora)
475Cambiar estado de la boleta
476Imprimir boleta