Ir al contenido principal
Todas las coleccionesRest API - Integraciones
Integración de ventas a través de TPV's
Integración de ventas a través de TPV's

Especificaciones técnicas para la importación de ventas de TPV's a tspoonlab

Rafel Tugues avatar
Escrito por Rafel Tugues
Actualizado hace más de 10 meses

Integración de ventas de TPV's a tspoonlab

tspoonlab no dispone de un módulo de TPV. Pero si que puede integrar la ventas de estos sistemas con un doble fin.

  1. 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

  2. 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 que nos permite detectar cuales son nuestros mejores platos y cuales 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.

  1. El separador de campo del fichero csv debe ser el punto y coma ;

  2. Las descripciones alfanuméricas en el fichero nunca deben tener ; para evitar ser confundido con un separador

  3. No se utiliza ningún delimitador de campo como por ejemplo la doble comilla "

Los campos del fichero pueden aparecer en cualquier orden pero sera necesario que la primera linea sea la cabecera.

Los campos recomendados son:

  1. Fecha de la venta (La fecha en formato DD/MM/YYYY)

  2. Hora de la venta (HH:MM:SS)

  3. Código del artículo (Sin ;)

  4. Descripción del artículo (Sin ;)

  5. Cantidad vendida (Si es con decimales , como separador)

  6. Precio unitario del articulo (Sin IVA) (, como separador decimal)

  7. Importe de la venta (Sin IVA) (, como separador decimal)

  8. Descuento de la venta (Sin IVA) (, como separador decimal)

  9. Tipo de IVA (En %)

  10. Código del artículo padre (En caso que sea un modificador)

Ejemplo de fichero

Supongamos una venta de un filete de ternera con patatas y una hamburguesa con extra de queso

Los campos mostrados en este ejemplo son fecha, hora, código, descripción, canitdad, precio, importe sin IVA, descuento sin IVA, tipo de IVA, codigo padre

fecha;hora;codigo_articulo;descr_articulo;cantidad;precio;importe_siniva;descuento_siniva;iva;codigo_articulo_padre
03/07/2020;14:30:00;FT001;FILETE DE TERNERA;1;19,90;19,90;0;10;
03/07/2020;14:30:00;PAT001;ACOMPAÑAMIENTO PATATAS;1;0;0;0;10;FT001
03/07/2020;15:00:00;HA001;HAMBURGUESA;1;19,90;18,00;1,90;10;
03/07/2020;15:00:00;EQ001;EXTRA QUESO;1;0;0;0;10;HA001

En la venta de la hamburguesa tenemos un descuento de 1,90€.

Los modificadores tienen un último campo que indica el código del producto padre

Nombre del fichero

El nombre del fichero debe ser único por ejemplo incluyendo la fecha y 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. Para conseguir unas credenciales de integración poneros en contacto con nosotros.

Información adicional

Si estáis interesados en ver como funciona el mapeo de productos de las TPV's a tspoonlab consultad la documentación online

¿Ha quedado contestada tu pregunta?