Te Lo Llevo Te Lo Llevo Documentación
Manual del sistema
El TPV en detalle

El terminal de punto de venta, de principio a fin

El TPV de Te Lo Llevo es el sistema que usan los comercios para vender en mostrador: abre sesiones de turno, registra ventas con modificadores y descuentos, gestiona el cajón de efectivo, emite tickets con numeración fiscal y produce los informes de cierre del día. Este capítulo documenta todas sus funciones en detalle.

El mismo comercio que acepta pedidos online por la app del cliente también puede vender en tienda con el TPV. Ambos canales comparten catálogo, IVA y control de stock — de modo que cuando se vende en mostrador, el inventario online se actualiza de forma automática.

Terminales y sesiones

Cada caja física o puesto de cobro del comercio se registra como un terminal en el sistema. Un comercio puede tener varios terminales activos (por ejemplo, una caja principal y una caja de terraza). El terminal es la unidad de control de la sesión de turno.

Una sesión es el período de trabajo de un cajero en un terminal concreto. Al comenzar el día, el cajero abre la sesión declarando el fondo de caja inicial (el efectivo que ya hay en el cajón antes de cobrar la primera venta). Al terminar el turno, cierra la sesión contando físicamente el efectivo y comparándolo con el esperado por el sistema — esa comparación es la reconciliación.

🖥️

Abrir sesión

El cajero selecciona el terminal, introduce el fondo inicial de caja y confirma. La sesión queda abierta y lista para cobrar.

🔒

Cerrar sesión

Al terminar el turno, el cajero cuenta el efectivo físico, lo introduce en el TPV y el sistema calcula la diferencia (descuadre) frente a lo esperado. Se imprime el informe Z.

ℹ️
Una sesión por turno

Solo puede haber una sesión abierta por terminal a la vez. Si el cajero cierra la aplicación sin cerrar la sesión, la sesión sigue abierta y debe cerrarse formalmente antes de que otro cajero pueda comenzar su turno en ese mismo terminal.

Hacer una venta

El flujo de venta en mostrador sigue un proceso ordenado: se añaden los productos, se configuran los modificadores, se aplica cualquier descuento, se añade propina si el cliente lo desea, se elige la forma de pago y se finaliza el cobro. El sistema emite el ticket en cuanto la venta queda registrada.

  1. Añadir productos

    El cajero busca los productos por nombre, categoría o código de barras (con lector o tecleado). Cada artículo se añade al carrito de la venta activa con la cantidad deseada.

  2. Configurar modificadores

    Si un producto tiene grupos de modificadores — por ejemplo «Tamaño» (elección única: pequeño, mediano, grande) o «Extras» (elección múltiple: extra queso, sin gluten) — el TPV muestra el selector de opciones. Cada opción puede tener un incremento de precio sobre el artículo base.

  3. Aplicar descuento (si procede)

    Los descuentos están limitados por el rol del cajero. STAFF puede dar hasta el 10 % o 10 € (lo que resulte menor). MANAGER puede dar hasta el 50 %. Descuentos mayores o cortesías totales requieren OWNER. Se debe introducir un motivo en todos los casos.

  4. Añadir propina

    El cajero puede ofrecer al cliente añadir una propina al ticket. Las opciones predefinidas son 0 %, 3 %, 5 % y 10 %; también se puede introducir un importe libre. La propina se añade después del IVA y no forma parte de la base imponible.

  5. Elegir forma de cobro

    El cajero selecciona CASH (efectivo), CARD (tarjeta con datáfono) o SPLIT (cobro mixto: parte en efectivo, parte en tarjeta). En cobro en efectivo, el TPV calcula automáticamente el cambio.

  6. Confirmar y emitir el ticket

    El sistema registra la venta, decrementa el stock de cada artículo vendido y envía la orden de impresión a la impresora de tickets conectada. El cajón de efectivo se abre automáticamente si el pago es en efectivo o mixto.

Modificadores y combos

Los modificadores permiten personalizar un producto sin crear un artículo separado por cada variante. Un grupo de modificadores puede ser de selección única (el cliente elige exactamente una opción, como el tamaño) o de selección múltiple (puede elegir varias, como los ingredientes de una pizza). Cada opción del grupo lleva asociado un incremento de precio — que puede ser cero — que el sistema suma automáticamente al precio base del artículo.

Los combos son conjuntos de productos preconfigurados que se venden juntos a un precio único. Cuando se vende un combo, el stock de cada componente se descuenta por separado, garantizando que el inventario siempre refleja el consumo real.

El ticket

Cada venta genera un ticket (factura simplificada) que recoge toda la información fiscal y comercial de la transacción. El ticket es inmutable: una vez emitido no se puede editar. Si hay un error o una devolución, se genera una nueva operación que anula o corrige la original.

Contenido de un ticket

  • Cabecera personalizable: nombre del comercio, NIF/CIF, dirección, teléfono, logotipo y mensaje de bienvenida definidos por el OWNER.
  • Líneas de producto: artículo, cantidad, precio unitario, modificadores seleccionados y subtotal de línea.
  • Líneas de IVA: base imponible, tipo de IVA y cuota para cada código fiscal presente en la venta (IVA_SUPER_REDUCED 4 %, IVA_REDUCED 10 %, IVA_STANDARD 21 %, EXEMPT 0 %).
  • Descuentos aplicados: importe y motivo.
  • Propina: importe y porcentaje, si la hubiera.
  • Total: suma de subtotal + IVA + propina − descuento.
  • Forma de pago: efectivo entregado y cambio, o «Tarjeta», o desglose mixto.
  • Número de factura: secuencia correlativa sin saltos.
  • Pie personalizable: mensaje de despedida o información adicional del comercio.

Numeración correlativa de facturas

El sistema mantiene una secuencia de facturación sin huecos por jurisdicción, serie y año. Esto significa que el número de ticket 1, 2, 3 siempre es consecutivo — no hay saltos, no hay números repetidos. Esta propiedad es un requisito legal de la normativa fiscal española y es esencial para el cumplimiento con Veri*Factu (ver el capítulo de cumplimiento legal).

Factura completa

Cuando un cliente necesita una factura completa (en lugar del ticket simplificado), el cajero puede capturar el NIF y la dirección del cliente. La factura completa incluye todos los datos del receptor y es apta para deducciones fiscales empresariales.

Inventario

El TPV descuenta stock de forma automática en cada venta. Cuando las existencias de un artículo caen por debajo de su umbral de alerta, el sistema notifica al MANAGER o al OWNER. Además de los decrementos automáticos por venta, el equipo puede registrar ajustes manuales de inventario para reflejar pérdidas, entradas de mercancía o correcciones de recuento.

⚠️
Ajustes de inventario: solo MANAGER y OWNER

El rol STAFF no puede registrar ajustes manuales de inventario. Esta operación requiere al menos el rol MANAGER para garantizar que todo movimiento queda vinculado a un responsable.

Cada ajuste manual es de solo adición: el historial nunca se borra ni se edita. Esto garantiza una pista de auditoría completa de todos los movimientos de stock.

Códigos de motivo de ajuste

Código Nombre Cuándo se usa
BREAKAGE Rotura Artículo dañado o roto durante su manejo.
EXPIRY Caducidad Producto retirado por haber superado su fecha de consumo.
MERMA Merma Pérdida natural de peso o volumen durante el almacenamiento o preparación.
STAFF_MEAL Consumo de personal Artículo consumido por el equipo del comercio.
THEFT Hurto Artículo desaparecido por sustracción.
RECOUNT Recuento Corrección de existencias tras un recuento físico del almacén.
RETURN_TO_SUPPLIER Devolución a proveedor Mercancía devuelta al proveedor de origen.
RECEIVED Recepción de mercancía Nueva entrada de stock procedente de un pedido al proveedor.
TRANSFER_OUT Transferencia saliente Stock trasladado a otra sede o local del mismo comercio.
OTHER Otro Cualquier motivo no contemplado en los anteriores; requiere descripción libre.

Productos de venta restringida

El alcohol y el tabaco son productos cuya venta a menores de 18 años está prohibida en España por la Ley 28/2005. El TPV aplica un control automático: cuando el carrito contiene al menos un artículo marcado como restringido por edad, el sistema muestra una pantalla de verificación de edad antes de permitir que el cajero finalice la venta.

Verificación de edad obligatoria

El cajero debe confirmar activamente en la pantalla de verificación que el cliente tiene 18 años o más y que, si el cliente aparenta ser menor de 25 años, se le ha pedido y comprobado la identificación. El sistema registra únicamente la declaración del cajero — no almacena ningún dato personal del cliente (nombre, número de DNI ni copia del documento). Si el cajero no confirma, la venta no puede completarse.

Este diseño protege tanto al comercio (que queda cubierto por la declaración del cajero) como la privacidad del cliente (cuyos datos de identidad no son almacenados por el sistema). El control es de atestación, no de verificación biométrica ni de captura de datos.

Devoluciones en el TPV

Las devoluciones en mostrador se realizan a partir de un ticket existente. El cajero selecciona el ticket original y elige si la devolución es total o parcial. Solo los usuarios con rol OWNER pueden ejecutar devoluciones.

↩️

Devolución total

Se anula la venta completa. El sistema devuelve el importe íntegro al cliente, repone el stock de todos los artículos de la venta y ajusta el cajón de efectivo o genera el apunte de devolución en tarjeta.

↩️

Devolución parcial

Se devuelven únicamente algunos artículos o una cantidad menor. El IVA se recalcula de forma proporcional sobre las líneas devueltas. El stock y el cajón se ajustan en proporción a lo devuelto.

⚠️
Las devoluciones no borran el ticket original

Por integridad fiscal, el ticket original nunca se elimina. La devolución genera un nuevo documento de abono vinculado al ticket de origen. El historial completo queda preservado para la pista de auditoría y el cumplimiento fiscal.

El cajón de efectivo

El TPV registra todos los eventos del cajón de efectivo. Cada apertura queda vinculada a una causa: cobro en efectivo, pago de efectivo saliente (pay-out), entrada de efectivo sin venta (pay-in) o apertura sin venta (no sale).

Evento Descripción Rol mínimo
Apertura por venta en efectivo El cajón se abre automáticamente al confirmar un cobro en efectivo o mixto. STAFF
Pay-in (entrada de efectivo) Se añade efectivo al cajón sin vincular una venta (por ejemplo, cambio de moneda). MANAGER
Pay-out (salida de efectivo) Se retira efectivo del cajón sin vincular una devolución (por ejemplo, para pagar a un proveedor). MANAGER
No sale (apertura sin venta) El cajón se abre sin registrar ninguna operación. Requiere confirmación del motivo. MANAGER

Todos los eventos de apertura y cierre del cajón se guardan en la pista de auditoría, con la hora, el usuario que los ejecutó y el motivo. Esta trazabilidad es esencial para la reconciliación al cierre del turno.

Informes

El TPV genera cuatro tipos de informe para el control de la actividad comercial. Cada uno tiene una función distinta y un nivel de permanencia diferente.

Informe Cuándo ¿Se guarda? ¿Resetea los contadores? Para qué sirve
Informe X En cualquier momento durante el turno No — es solo una instantánea en pantalla No Ver el estado actual de la sesión sin cerrarla: ventas parciales, totales por método de pago, efectivo esperado en caja.
Informe Z Al cerrar la sesión (fin de turno) Sí — numerado y permanente Sí — reinicia los totales del terminal para el siguiente turno Cierre oficial del turno: totales definitivos, IVA desglosado, descuentos, propinas, formas de pago, discrepancia de caja.
Liquidación EOD de caja Al cierre del día No (es un consolidado) Resumen del efectivo del día: fondo inicial + cobros en efectivo + pay-ins − pay-outs − cambios entregados = efectivo esperado. Se compara con el recuento físico.
Ventas por producto Bajo demanda o por sesión No Ranking de artículos vendidos: unidades, importe y porcentaje del total. Útil para gestión de carta y reposición de stock.
El informe Z es inmutable

Una vez generado, el informe Z no puede modificarse. Su número de secuencia es correlativo (sin saltos) y el contenido queda bloqueado. Esta inmutabilidad es un requisito del marco fiscal español y de la futura integración con Veri*Factu.

Hardware

El TPV está diseñado para funcionar en modo software puro — puede usarse completamente desde una pantalla táctil sin ningún periférico conectado. La integración con hardware físico amplía la experiencia pero no es un requisito previo.

🖨️

Impresora de tickets

Compatible con el protocolo ESC/POS estándar. Imprime el ticket al confirmar la venta y el informe Z al cerrar la sesión. El diseño del ticket (cabecera y pie) lo configura el OWNER.

💰

Cajón de efectivo

Se conecta habitualmente a la impresora de tickets. Recibe la señal de apertura automáticamente en cobros en efectivo o mixtos, y también puede abrirse manualmente por un MANAGER.

📷

Lector de código de barras

Funciona como un teclado estándar (modo keyboard-wedge): el código escaneado se introduce directamente en el campo de búsqueda del TPV. No requiere configuración especial.

💳

Datáfono (terminal de tarjeta)

Hoy el importe se introduce manualmente en el datáfono tras seleccionar «Tarjeta» en el TPV. La integración automática entre el TPV y el datáfono es una funcionalidad planificada para fases futuras.

ℹ️
Estado actual del hardware

La impresora ESC/POS, el cajón de efectivo y el lector de códigos de barras son funcionales hoy. La integración automática con el datáfono (que evitaría la doble introducción del importe) está especificada y pendiente de implementación.

Multisede

Un comercio puede operar varias sedes o locales dentro de la misma cuenta. Cada sede tiene su propio catálogo (o comparte el catálogo padre), sus propios terminales y sus propias sesiones de turno. Los informes se pueden consultar por sede o de forma consolidada para el conjunto del negocio.

La gestión de sedes la realiza el OWNER desde el perfil del comercio. Un MANAGER puede tener acceso a una o varias sedes según lo que el OWNER haya configurado. Esta estructura es especialmente útil para cadenas de restauración, mercados con varios puestos o negocios con local y terraza separados.

¿Necesitas más información?

Para la perspectiva del cajero (apertura de sesión, ventas paso a paso, cierre), consulta el capítulo del cajero. Para las obligaciones fiscales ligadas al TPV (Veri*Factu, numeración de facturas, RGPD), lee el capítulo de cumplimiento legal.