Imprime el ticket de cualquier presupuesto aparcado directamente desde el modal del TPV y enriquece cada ticket con el teléfono del cliente y las observaciones del documento. TPVneoPrintPark extiende el plugin TPVneo sin tocar el código base, perfecto para entornos de aparcamiento y servicios donde el ticket impreso debe llevar información adicional visible (matrícula, plaza asignada, instrucciones especiales…).
Funcionalidades principales:
- Botón de impresión en aparcados: imprime el ticket de un presupuesto aparcado sin cargarlo antes en el TPV.
- Teléfono del cliente en el ticket: añade automáticamente el teléfono (principal o secundario) en la cabecera.
- Observaciones en el ticket: imprime las notas del documento al final del cuerpo del ticket.
- Columna de observaciones en el modal: identifica cada aparcado de un vistazo sin abrirlo.
¿Qué hace TPVneoPrintPark?
TPVneoPrintPark es un plugin para El EquipoIA que añade funcionalidad de impresión de tickets para presupuestos aparcados (parks) en el Terminal Punto de Venta (TPV). Además, enriquece los tickets impresos con información adicional del cliente (teléfono) y las observaciones del documento.
Se integra de forma transparente con el sistema de extensiones de El EquipoIA y con el plugin TPVneo, extendiendo tanto la vista del modal de aparcados como la generación de tickets sin modificar el código base de ninguna de las dos aplicaciones.
Requiere: plugin TPVneo · Versión: 1.0
Funcionalidades principales
Botón de impresión en el modal de aparcados
Se añade un nuevo botón de impresión (icono de impresora) en cada fila del modal de presupuestos aparcados del TPV. Permite imprimir directamente el ticket de un presupuesto aparcado sin necesidad de cargarlo previamente en el TPV.
Teléfono del cliente en el ticket
Cuando se imprime un ticket (de documentos normales o de aparcados), el plugin añade automáticamente el teléfono del cliente en la cabecera:
- Si el cliente tiene teléfono principal (telefono1), se muestra este.
- Si no tiene principal pero sí secundario (telefono2), se muestra el secundario.
- Si no tiene ningún teléfono registrado, no se imprime nada adicional.
Observaciones del documento en el ticket
Tras el cuerpo del ticket (líneas de producto), el plugin imprime las observaciones del documento si existen. Especialmente útil en entornos de aparcamiento o servicios donde se necesitan notas visibles en el ticket impreso (número de matrícula, plaza asignada, instrucciones especiales, etc.).
Columna de observaciones en el modal de aparcados
El modal se extiende para mostrar una columna adicional con las observaciones de cada presupuesto, facilitando la identificación rápida del contenido de cada aparcado sin necesidad de abrirlo.
Arquitectura técnica
El plugin sigue el patrón de extensiones de El EquipoIA y la arquitectura de TPVneo, lo que permite añadir funcionalidad sin modificar el código fuente original.
Componentes principales
- Archivo de metadatos del plugin — Define el nombre, la versión, la descripción y las dependencias.
- Punto de entrada — Se ejecuta al cargar el plugin y registra las extensiones.
- Extensión de tickets — Amplía la generación de tickets para añadir el teléfono del cliente y las observaciones.
- Formulario de aparcados — Sobreescribe el formulario de aparcados de TPVneo para incluir el botón de impresión.
Cómo funciona cada componente
La extensión de tickets añade dos puntos de inserción: setHeaderAfter() imprime el teléfono del cliente tras la cabecera y setBodyAfter() añade las observaciones tras el cuerpo. Todos los textos se sanitizan para la impresora ESC/POS.
El formulario de aparcados extiende por herencia la clase ParkForm de TPVneo y sobreescribe renderModalPark() (reconstruye cada fila añadiendo la columna de observaciones y el botón de impresión) e inyecta un script con getInlineScript() que añade la cabecera de columna y define la función JavaScript printParkTicket(), que delega en modalPrintTicket() de TPVneo.
Flujo de funcionamiento
Al abrir el modal de aparcados
- El usuario pulsa el botón de aparcados en el TPV.
- TPVneo solicita la lista de presupuestos aparcados del terminal.
- El formulario de aparcados genera el HTML de cada fila: código, cliente, total, fecha/hora, observaciones y los botones de acción (ver, imprimir, eliminar).
- El script inline añade la cabecera de la columna de impresión y registra printParkTicket().
- El modal se muestra con la tabla completa.
Al imprimir un presupuesto aparcado
- El usuario pulsa el botón de imprimir (icono azul) en la fila deseada.
- Se invoca printParkTicket(idpresupuesto), que delega en modalPrintTicket() de TPVneo con el tipo «PresupuestoCliente».
- TPVneo genera el ticket.
- La extensión añade el teléfono del cliente en la cabecera y las observaciones al final del cuerpo.
- El ticket se envía a la impresora ESC/POS configurada en el terminal.
