Documentación | BarraTouch

Sección 1

Qué es BarraTouch

BarraTouch es un sistema de punto de venta (POS) gastronómico híbrido offline/online diseñado para bares, restaurantes, boliches, eventos, food trucks, rotiserías, heladerías, cadenas y multi-locales. No es un SaaS común: se instala localmente en el hardware del comercio, funciona sin internet y sincroniza con la nube cuando hay conexión.

El sistema incluye

Punto de venta táctil completo (POS)
Módulo de cocina (monitor y ticket)
Mapas de mesas interactivos
Facturación electrónica (ARCA)
Control de stock
Gestión de gastos
Módulo de clientes
Reconocimiento facial para mozos
Pronóstico de ventas basado en datos históricos
Múltiples impresoras, cocinas y puntos de venta
Integración con MercadoPago (QR, tarjeta, transferencia)
Sincronización multi-local para cadenas

Además incluye un ecosistema de herramientas web gratuitas llamadas BarraTools: carta digital QR, reservas, ticketing, control de ingreso, calculadora de costos, planificador de menú y efemérides gastronómicas.

A quién está dirigido

Tipo de negocio	Plan recomendado
Bar de barrio, una caja, operación simple	Esencial
Restaurante mediano	Pro
Boliche o discoteca	Pro + ticketing
Organizador de eventos	Pro o Multi
Cadena o franquicia	Multi
Food truck, rotisería, heladería	Esencial

Filosofía del producto

Sin límites: mesas, impresoras, cocinas, mozos y espacios sin restricción.
Ecosistema completo: POS + web + herramientas gratuitas en un solo producto. No hay módulos separados que se pagan aparte.
Local-first: el sistema funciona primero localmente, después sincroniza. No depende de internet para operar.
Sin comisiones abusivas: en ticketing, los planes Pro y Multi no cobran comisión sobre las entradas vendidas.

Historia

BarraTouch nace hace 10 años como proyecto personal para gestionar un local propio de gastronomía y pub. A lo largo de los años evolucionó hasta convertirse en una plataforma completa para el sector gastronómico y de entretenimiento nocturno.

Diferenciales vs. competencia

Offline real: a diferencia de la mayoría de los sistemas del mercado que requieren conexión constante, BarraTouch funciona completo sin internet.
Sin módulos separados: no hay que pagar extra por cocina, stock, facturación, carta QR, etc.
BarraTools gratuitas: herramientas que otros cobran aparte vienen incluidas.
Ticketing sin comisión en planes Pro/Multi.
Pago de por vida: opción de pago único sin renovaciones.
Multi-local nativo: sincronización entre locales diseñada desde la arquitectura.

Sección 2 · Técnico

Modelo híbrido offline/online

BarraTouch se instala localmente en una PC del comercio usando un instalador Inno Setup que despliega Laragon WAMP (Apache + PHP + MySQL) local, la aplicación POS completa y la base de datos local.

Todo el sistema opera contra la base de datos local. Las ventas, productos, categorías, mesas, mozos, gastos, stock se guardan primero en MySQL local.

Qué datos se guardan localmente

Productos, categorías, precios
Ventas, detalle de ventas, medios de pago
Mesas, mapas de mesas, salones
Mozos y usuarios del POS
Aperturas y cierres de caja
Gastos, stock e inventario, clientes
Configuración del sistema
Estado de licencia (caché firmado)
Cola de sincronización (sync_outbox)
Estado de sincronización (sync_state)

Cómo funciona la sincronización con la nube

La sincronización usa una cola de eventos (sync_outbox):

Cada evento importante (venta, cambio de producto, etc.) se registra en sync_outbox con estado pending.
Un proceso background (SyncManager) intenta enviar los eventos cuando detecta internet.
Los eventos se envían al endpoint /api/sync/intake en la nube.
Cada evento tiene un UUID único para garantizar idempotencia.
Si falla, se reintenta automáticamente (estado failed con contador de intentos).
Si tiene éxito, pasa a estado sent.

Frecuencia: la sincronización de ventas se intenta cada vez que se cobra y hay internet. El catálogo usa un feed de cambios (sync_changes) que los POS consultan periódicamente.

Qué pasa con un corte prolongado de internet

El POS sigue funcionando sin ninguna limitación.
Las ventas quedan encoladas en sync_outbox local.
Cuando vuelve el internet, se sincronizan automáticamente.
La licencia tiene un período de validez offline (offline_valid_until) de 10 días desde la última validación exitosa.
Hay un código de desbloqueo de emergencia (emergency_unlock_code) que soporte puede generar para casos extremos.

Funciones offline vs. funciones que requieren conexión

Función	Offline
Venta en todas sus modalidades	✅
Cobro en efectivo, débito, transferencia	✅
Apertura y cierre de caja	✅
Impresión de tickets y comandas	✅
Módulo de cocina	✅
Gestión de mesas y mapas	✅
Control de stock, gastos, clientes	✅
Cobro con QR de MercadoPago	❌ requiere conexión
Sincronización de ventas a la nube	❌ requiere conexión
Facturación electrónica ARCA	❌ requiere conexión
BarraTools web (carta QR, reservas)	❌ son web
Reportes consolidados multi-local	❌ requiere conexión

Backup automático

Las ventas se suben a la nube automáticamente cuando hay internet, almacenadas en tablas bt_ventas, bt_venta_pagos y bt_venta_items. Esto permite reportes online, backup centralizado y reportes consolidados para dueños de múltiples locales.

Sección 3 · Técnico

Sincronización multi-local

Qué se sincroniza entre locales

Ventas: se suben a la nube para reportes consolidados.
Productos y categorías: el catálogo se sincroniza bidireccionalmente (cloud_master).
Precios: se sincronizan desde la nube hacia los POS.
Facturación: reportes consolidados visibles para el dueño.

Reportes consolidados

Desde perfil.html → Facturación Barratouch, el dueño puede ver ventas de todos sus locales con filtros por fecha, hora, local, medio de pago y turno (mañana/tarde/noche).

Gestión de precios centralizada

Las entidades categoria y producto están definidas como cloud_master. Los cambios hechos desde la web son autoritativos. Los POS reciben estos cambios a través del feed sync_changes, consultando el endpoint /api/sync/pull periódicamente. Cada cambio tiene un cursor incremental para llevar la cuenta de qué se sincronizó.

Resolución de conflictos

Si la misma entidad fue editada en dos locales simultáneamente, gana el cambio más reciente (por timestamp). El conflicto queda registrado para auditoría.

Tiempos de sincronización

Tipo	Frecuencia
Ventas	Segundos después de cobrar (si hay internet)
Catálogo (pull)	Pocos minutos (polling periódico)

Sección 4

Planes y precios

Plan Esencial

Aspecto	Detalle
Público	Un local, una caja
Precio mensual	$24.000/mes
Precio anual	$240.000/año
Precio de por vida	$650.000 pago único
POS incluidos	1 (una caja por local)

Incluye: sistema de ventas híbrido offline/online, carta QR sincronizada, cobros con MercadoPago, facturación ARCA, reportes básicos en la nube, todas las BarraTools gratuitas, ticketing con 5% de comisión BarraTouch.

No incluye: múltiples cajas en el mismo local, reservas sincronizadas, reportes avanzados, ticketing sin comisión.

Plan Pro

Aspecto	Detalle
Público	Locales con más operación
Precio mensual	$45.000/mes
Precio anual	$450.000/año
Precio de por vida	$1.200.000 pago único
POS incluidos	Múltiples cajas en el mismo local

Incluye: todo el plan Esencial más sync completo en la nube, múltiples cajas, reservas sincronizadas, reportes avanzados y ticketing sin comisión (token MercadoPago propio).

Plan Multi

Aspecto	Detalle
Público	Cadenas y multi-locales
Precio mensual	$42.000/licencia/mes
Precio anual	$420.000/licencia/año
Precio de por vida	$950.000/licencia pago único
Regla	Una licencia = un local

Incluye: todo el plan Pro en cada licencia, sync consolidado entre todos los locales, reportes unificados y gestión centralizada de productos y precios.

Comparativa de planes

Característica	Esencial	Pro	Multi
POS offline/online	✅	✅	✅
Carta QR sincronizada	✅	✅	✅
MercadoPago integrado	✅	✅	✅
Facturación ARCA	✅	✅	✅
BarraTools gratuitas	✅	✅	✅
Múltiples cajas mismo local	❌	✅	✅
Reservas sincronizadas con POS	❌	✅	✅
Reportes avanzados	❌	✅	✅
Ticketing sin comisión	❌ (5%)	✅	✅
Sync multi-local	❌	❌	✅
Gestión centralizada de precios	❌	❌	✅
Reportes consolidados	❌	❌	✅

Pago de por vida

El pago de por vida es un pago único que incluye todas las actualizaciones del sistema, soporte y el sistema sin renovaciones. El sistema queda para siempre en poder del cliente.

Upgrades entre planes

Se gestiona por email. BarraTouch envía un link de pago por la diferencia proporcional. El cambio se activa una vez confirmado el pago.

Promoción para comercios nuevos

3 meses gratis aplica únicamente al plan Esencial hosteado por BarraTouch, disponible para comercios abiertos hace menos de 6 meses. Contactar por WhatsApp para acceder.

Sección 5

MercadoPago integrado

Tipos de cobro disponibles

QR: genera un código QR que el cliente escanea para pagar.
Tarjeta: cobro con tarjeta de débito/crédito.
Transferencia: cobro por transferencia bancaria (registro manual).
Efectivo: cobro en efectivo (registro manual).
Bonificado: cargo bonificado (registro manual).

Cómo se configura

Hay dos niveles de integración:

MercadoPago del comercio (para cobrar ventas): el comercio carga su propio token en la configuración del POS. Se usa para generar QR de cobro. Las comisiones son de MercadoPago, no de BarraTouch.
MercadoPago de BarraTouch (para cobro de licencias): usa la cuenta de BarraTouch para cobrar suscripciones.

Comisiones

Las comisiones que cobra MercadoPago por cada transacción son exclusivamente de MercadoPago. BarraTouch no cobra comisión sobre las ventas del comercio.

Sección 6

Facturación electrónica (ARCA)

BarraTouch emite facturación electrónica directamente desde el POS, integrada con ARCA (ex AFIP) para cumplir con los requisitos fiscales argentinos. El uso de la facturación es opcional.

Cómo se activa

Desde la configuración del sistema, con los datos fiscales del comercio (CUIT, condición ante ARCA, punto de venta). El proceso es guiado y el soporte de BarraTouch acompaña la activación.

Comprobantes que emite

Factura A
Factura B
Factura C
Ticket Factura
Nota de Crédito

No se necesita software de facturación aparte ni impresora fiscal.

Sección 8

BarraTools gratis

BarraTools es el ecosistema de herramientas web gratuitas incluidas con tu cuenta BarraTouch. Algunas están disponibles incluso sin contratar el sistema de ventas.

Calculadora de Costos

Cargá ingredientes, gastos y margen deseado para calcular el precio ideal de platos y analizar rentabilidad. Gratuita, disponible sin contratar el sistema de ventas.

Planificador de Menú

Buscá recetas por nombre o ingredientes, generá propuestas aleatorias y planificá el menú descargándolo en PDF. Gratuito, disponible sin contratar el sistema de ventas.

Versión Pro (próximamente): agregará recetas directamente a la carta con un clic.

Carta Digital QR

Diseñá la carta con categorías y productos, generá un enlace único con QR para que los clientes escaneen desde la mesa. Gratuita, incluida en todos los planes. Los precios se sincronizan automáticamente desde el sistema de ventas.

Reserva de Mesas

Gestioná reservas desde un calendario interactivo con plano de mesas y confirmaciones automáticas por correo. Gratuita en todos los planes. En Esencial las reservas son independientes; en Pro y Multi se sincronizan con el sistema de ventas.

Efemérides Gastronómicas

Calendario de efemérides culinarias para crear promociones y campañas temáticas. Gratuita, disponible sin contratar el sistema de ventas.

Control de Ingreso

Controlá el acceso a eventos escaneando tickets digitales (QR) y obtené estadísticas de asistencia al instante. Gratuito, disponible sin contratar el sistema de ventas.

Entradas Anticipadas (Ticketing)

Creá y distribuí entradas anticipadas con códigos QR únicos integrados al control de ingreso. Disponible en todos los planes. Comisión BarraTouch: 5% en Esencial, 0% en Pro y Multi.

Sección 9

Sistema de ticketing

Cómo funciona de punta a punta

Creación del evento: el organizador crea un evento desde barratools/anticipadas.html, configurando nombre, fecha, lugar, precio, cupo y restricciones.
Venta: los compradores acceden a la página del evento, seleccionan cantidad y pagan por MercadoPago.
Emisión: se genera un PDF con código QR único por entrada.
Control de acceso: en la puerta, se escanea el QR desde barratools/control.html para validar la entrada.
Reportes: estadísticas de asistencia y ventas disponibles.

Restricciones configurables

Edad mínima
Precios diferenciales (anticipada, general, VIP)
Cupos por categoría
Fecha y hora del evento

Modelo de comisiones

Plan	Comisión BarraTouch
Esencial	5%
Pro	0%
Multi	0%

Token propio de MercadoPago

En planes Pro y Multi, el comercio carga su propio token de acceso. Cuando se vende una entrada, el pago va directamente a la cuenta del comercio. BarraTouch no retiene ninguna comisión.

Scanner de QR en la puerta

Desde barratools/control.html, el organizador escanea los QR usando la cámara del dispositivo. El sistema valida que el código sea válido, que la entrada no haya sido usada antes y que corresponda al evento correcto.

Sección 10

Implementación y soporte

Tiempo de implementación

La implementación típica toma menos de 24 horas desde la contratación hasta el sistema operativo.

Cómo se instala

El cliente descarga el instalador desde la web.
El instalador despliega Laragon WAMP (Apache + PHP + MySQL) local.
Configura la base de datos automáticamente.
El cliente ingresa su número de licencia.
El sistema se activa y queda listo para operar.

Hardware necesario

PC: cualquier PC con Windows.
Monitor táctil: recomendado para operación en barra/caja.
Impresora: cualquier impresora térmica compatible con Windows (no se necesita impresora fiscal).
Tablet: para mozos (app Camarero disponible).
Cámara: para reconocimiento facial (opcional).
Escáner de código de barras: opcional.
Conexión a internet: recomendada para sincronización, no necesaria para operar.

Soporte

Canal	Detalle
WhatsApp	+54 9 3572 585501
Email	Respuesta en menos de 24 horas
Horario	Atención 24 horas vía email y WhatsApp

Sección 11

Preguntas frecuentes

¿Qué pasa si BarraTouch cierra?

El sistema se instala localmente en tu PC. Si BarraTouch dejara de existir, el POS sigue funcionando porque no depende de nuestros servidores para operar. Perderías la sincronización en la nube y las herramientas web, pero el sistema de ventas local seguiría funcionando.

¿Puedo migrar mis datos desde otro sistema?

Por el momento BarraTouch no tiene herramienta de migración automática. Los productos y configuraciones se cargan manualmente.

¿Es seguro guardar mis datos en la nube?

Los datos se sincronizan usando conexiones HTTPS cifradas. Cada POS tiene su propia API key para autenticación. Las ventas se almacenan con identificación única para evitar duplicados.

¿Qué pasa si no renuevo el plan mensual?

Días 1–7 vencido: advertencia visible, podés seguir vendiendo.
Días 8–15 vencido: advertencia persistente, podés seguir vendiendo.
Días 16–30 vencido: se bloquean funciones no críticas, la venta local sigue.
Día 31+: bloqueo operativo configurable.

¿Puedo probar antes de comprar?

Sí, hay una demo disponible en demo-barratouch.html y también podés crear una cuenta gratuita para probar las BarraTools.

¿Tienen app móvil?

Sí, hay una app Camarero disponible como APK para Android que permite a los mozos tomar pedidos desde tablets.

¿Funciona en cualquier sistema operativo?

El POS se instala en Windows. Las BarraTools son web y funcionan en cualquier navegador. La app Camarero es para Android.

¿Puedo usar mi propia impresora?

Sí, cualquier impresora térmica compatible con Windows funciona. No se necesita impresora fiscal.

¿Necesito un técnico para instalar?

Se recomienda que la instalación inicial sea realizada por un técnico de BarraTouch para garantizar la correcta configuración del entorno local, la red y las impresoras. La instalación se coordina por WhatsApp.

¿Puedo tener el sistema en más de una PC?

Sí, desde el plan Pro podés tener múltiples puntos de venta en el mismo local. En el plan Multi, un POS por cada licencia en diferentes locales.

¿Cómo veo las ventas del día?

Desde el POS local o desde perfil.html → Facturación Barratouch con filtros por fecha.

¿Puedo tener varios precios para un mismo producto?

Por el momento el sistema no soporta múltiples listas de precios simultáneas. Todos los productos tienen un precio único activo.

¿Se puede dividir la cuenta?

Sí, el POS tiene modal de pago múltiple donde se puede dividir el total entre efectivo, transferencia, débito, QR y bonificado.

¿Cómo cancelo una venta?

Para ventas de mesa, desde Administración de Mesas. Para otros tipos de pedido, desde Administración de Pedidos.

Sección 13

Casos de uso por tipo de negocio

Bar de barrio — Plan Esencial

Una caja es suficiente, modo offline crítico, precio accesible, carta QR, MercadoPago integrado.

Restaurante mediano — Plan Pro

Múltiples puntos de venta, módulo de cocina con monitor, mapas de mesas, reservas sincronizadas, facturación ARCA.

Boliche o discoteca — Plan Pro + ticketing

Múltiples puntos de venta, ticketing con entradas anticipadas, control de ingreso con scanner QR, modo bajada.

Organizador de eventos — ticketing sin comisión

Ticketing sin comisión en Pro/Multi, cobro directo a cuenta MP, control de ingreso con scanner QR, reportes de asistencia.

Cadena o franquicia — Plan Multi

Una licencia por local, sincronización centralizada de productos y precios, reportes consolidados, cada local opera independientemente.

Food truck — Plan Esencial

Modo offline completo, una caja, precio accesible, MercadoPago integrado, carta QR.

Sección 14

Glosario

Híbrido offline/online

Modelo donde el sistema opera localmente sin depender de internet, pero sincroniza datos con la nube cuando hay conexión.

Sincronización multi-local

Mecanismo que permite que varios establecimientos compartan productos, precios y reportes a través de la nube.

Licencia

Contrato comercial que habilita el uso del sistema. Cada licencia tiene un tipo (Esencial, Pro, Multi) y un plan comercial.

Token de MercadoPago

Código de autenticación que permite a un comercio cobrar a través de MercadoPago usando su propia cuenta.

BarraTools

Conjunto de herramientas web gratuitas incluidas con la cuenta BarraTouch.

Plan de por vida

Modalidad de pago único donde el cliente paga una vez y usa el sistema para siempre, con actualizaciones incluidas.

POS (Point of Sale)

El sistema de ventas instalado localmente en el comercio. Interfaz táctil para gestionar ventas, mesas y cobros.

Período de gracia

Tiempo adicional después del vencimiento de una licencia durante el cual el sistema sigue funcionando (7 días).

Facturación ARCA

Módulo de facturación electrónica compatible con ARCA (ex AFIP). Emite facturas A, B, C, Ticket Factura y Nota de Crédito directamente desde el POS.

Ticketing sin comisión

Modelo donde BarraTouch no retiene comisión sobre las entradas vendidas; el comercio usa su propio token de MercadoPago y la plata va directo a su cuenta.

App Camarero

Aplicación Android para que los mozos tomen pedidos desde tablets, integrada al sistema de ventas local.

Laragon WAMP

Entorno de servidor web local que incluye Apache, PHP y MySQL. BarraTouch lo usa como servidor local para operar sin internet.