Integración de ventas de TPV's a tspoonlab
tspoonlab no dispone de un módulo de TPV. Pero sí que puede integrar las ventas de estos sistemas con un doble fin.
Control de almacenes. A través de las ventas que nos llegan de la TPV descontamos en base a los escandallos los consumos teóricos de cada uno de los ingredientes o recetas. Eso nos permite tener un stock teórico que posteriormente cotejaremos con los inventarios. Definimos desviaciones de almacén como la diferencia entre el teórico y el real. Esas desviaciones son claves para la mejora de la gestión.
Menu engineering. Las cantidades vendidas de cada producto y los importes de esas ventas en combinación con los escandallos que ya tenemos en tspoonlab nos permiten hacer un análisis para detectar cuáles son nuestros mejores platos y cuáles tenemos que corregir.
Generación de ficheros CSV
Algunas TPV's generan ficheros CSV al cierre de caja. Otros sistemas centralizados generan esos ficheros en el servidor del restaurante. Ese fichero puede tener cualquier formato ya que después puede ser transformado/procesado en tspoonlab para importar la información. De todas formas vamos a definir un formato de ejemplo con la información que necesitamos para una importación tipo.
El separador de campo del fichero csv debe ser el punto y coma ;
Las descripciones alfanuméricas en el fichero nunca deben tener ; para evitar ser confundido con un separador.
No se utiliza ningún delimitador de campo como por ejemplo la doble comilla ".
Los campos del fichero pueden aparecer en cualquier orden, pero será necesario que la primera línea sea la cabecera.
Los campos recomendados son:
Fecha de la venta (la fecha en formato DD/MM/YYYY)
Hora de la venta (HH:MM:SS)
Código del artículo (sin ;)
Descripción del artículo (sin ;)
Cantidad vendida (si es con decimales, , como separador)
Precio unitario del artículo (sin IVA) (, como separador decimal)
Importe de la venta (sin IVA) (, como separador decimal)
Descuento de la venta (sin IVA) (, como separador decimal)
Tipo de IVA (en %)
Código del artículo padre (en caso que sea un modificador)
Opcional:
Número de ticket: identificador único de cada transacción.
Número de comensales / personas (Pax): cantidad de clientes asociados a cada ticket.
Disponer de esta información en el fichero de importación te permitirá obtener y analizar indicadores clave (KPIs) en tspoonlab, tales como:
Ticket medio: gasto promedio por transacción.
Número medio de comensales: promedio de clientes atendidos por ticket.
Gasto medio por comensal: importe medio que consume cada cliente cuando visita tu restaurante.
📢 Atención: En caso que el código del artículo no incluya el formato, debe añadirse al código. Por ejemplo, si tengo el artículo 100 que es "vino tinto" y un código de formato 4 para copa y 5 para botella, se deberían generar los códigos 100.4 y 100.5.
Ejemplo de fichero
Supongamos una venta de un filete de ternera con patatas y una hamburguesa con extra de queso en los dos primeros tickets, y una tercera venta con una ensalada y dos cañas de cerveza para 2 comensales.
Los campos mostrados en este ejemplo son: fecha, hora, código de artículo, descripción de artículo, cantidad, precio sin IVA, importe sin IVA, descuento sin IVA, tipo de IVA, código padre y los campos opcionales de número de ticket y número de pax.
fecha;hora;codigo_articulo;descr_articulo;cantidad;precio_siniva;importe_siniva;descuento_siniva;iva;codigo_articulo_padre;numero_ticket;pax
03/08/2026;14:30:00;FT001;FILETE DE TERNERA;1;18,09;18,09;0;10;;T001;1
03/08/2026;14:30:00;PAT001;ACOMPAÑAMIENTO PATATAS;1;0;0;0;10;FT001;T001;1
03/08/2026;15:00:00;HA001;HAMBURGUESA;1;18,09;16,36;1,73;10;;T002;1
03/08/2026;15:00:00;EQ001;EXTRA QUESO;1;0;0;0;10;HA001;T002;1
03/08/2026;21:15:00;ENS001;ENSALADA MIXTA;1;9,09;9,09;0;10;;T003;2
03/08/2026;21:15:00;CER001;CAÑA DE CERVEZA;2;2,73;5,46;0;10;;T003;2
En la venta de la hamburguesa (ticket T002) tenemos un descuento en base imponible de 1,73€ (equivalente a 1,90€ IVA incluido).
El campo codigo_articulo_padre indica el código del producto principal al que va asociado un modificador (como las patatas o el extra de queso). Para los productos principales este campo se deja vacío, representado con los dos punto y coma seguidos (;;).
Las columnas opcionales numero_ticket y pax se sitúan al final de la línea. Permiten agrupar los ítems de un mismo ticket y registrar el número de comensales (por ejemplo, en el ticket T003 se asignan 2 comensales).
Nombre del fichero
El nombre del fichero debe ser único, por ejemplo incluyendo la fecha y la hora en el nombre. Nunca debe enviarse una venta dos veces.
Envío del archivo CSV a tspoonlab
El archivo CSV debe enviarse a un servidor SFTP. Ponte en contacto con tu asesor para obtener los datos de conexión (usuario, contraseña y la carpeta de destino).
Si gestionas más de un restaurante bajo la misma cuenta, es imprescindible separar los ficheros de importación de ventas: cada local debe contar con su propia carpeta. Tu asesor te indicará la estructura que debes usar.
Información adicional
Si quieres ver cómo funciona el mapeo de productos de las TPV's a tspoonlab, consulta el artículo Vincula los artículos de venta (TPV).
¿Te ha resultado útil este artículo?
Si necesitas más ayuda, contacta con soporte haciendo clic en el Chat de Soporte Integrado en la esquina inferior derecha de tu pantalla.