ElVendedorDocs

Glosario

Términos de ElVendedor en orden alfabético: caja, inventario, sincronización, licencias, restaurante y piezas técnicas.

Para todos4 min de lecturaActualizado el 16 de noviembre de 2026

Los términos que aparecen en el producto y en esta documentación, con la definición corta que usa el equipo. Al final están las páginas de referencia relacionadas.

Activación (licencia). Alta de un equipo concreto en el servidor de licencias: se registra su device_id y se le entrega un token propio. Reinstalar no consume otra ranura.

Ajuste (inventario). Registro que corrige el stock de un producto en un almacén con un motivo declarado. No es venta ni compra: queda como evento auditable.

Almacén. Ubicación física donde se guarda el stock (tienda, depósito, cocina). Cada venta y cada movimiento descuentan de un almacén concreto.

APK. Paquete instalable de Android con el que se distribuye la app móvil. Se instala de forma manual o por adb, no por una tienda de aplicaciones.

Arqueo. Conteo del efectivo por moneda al cerrar la caja, comparado con el saldo esperado. La diferencia queda registrada en el cierre.

Bootstrap. Llamada GET /api/v1/sync/bootstrap, la primera de un equipo. Devuelve contrato, negocio actual, licencia, límites y entidades soportadas.

Catálogo (online). Escaparate público del negocio con sus productos, precios y portada, servido por el backend y administrado desde el móvil (catalog_storefront, catalog_products).

Comanda. Pedido abierto de una mesa de restaurante. No es una venta ni descuenta stock: la venta nace al cobrar y cerrar la mesa.

Compra. Entrada de mercancía al almacén con su costo. Actualiza stock y costo promedio ponderado; no genera factura de venta.

Conflicto. Cambio que el servidor no pudo aplicar sin ambigüedad. Se resuelve con keep_remote, discard_local o reviewed, y queda registrado.

Deuda y abono. La deuda es una venta a crédito pendiente de pago; el abono es el pago parcial o total que la reduce. Los abonos se aplican en orden FIFO.

Electron. Contenedor de aplicaciones de escritorio basado en Chromium y Node. Es el motor de ejecución de la app de escritorio.

Evento fallido. Cambio que el servidor no pudo aplicar en un push. Se consulta en /api/v1/sync/failed-events y se reintenta con reprocess-failed-events.

Factura. Documento de venta con numeración por serie, emisor y receptor congelados y huella SHA-256. Solo la emite el escritorio y es inmutable.

Gasto. Salida de dinero ajena a la compra de mercancía (servicios, transporte, renta). Afecta al balance, no al stock.

Hub (restaurante). Servidor local que levanta el escritorio en la red del restaurante. Arbitra mesas, comandas y cobros; el flujo vivo no pasa por internet.

IndexedDB. Base de datos del navegador. Es el almacenamiento que usa PouchDB en la app de escritorio.

Instalador. Paquete ejecutable de la app de escritorio para Windows o Linux (squirrel, deb, rpm, zip), generado con Electron Forge.

Laravel. Framework PHP del backend: rutas, validación, colas, migraciones y pruebas.

Licencia. Permiso de uso ligado a un negocio y a un número limitado de equipos. El backend es la autoridad de su estado y de su vencimiento.

Marketplace. Espacio donde los negocios publican productos y reciben pedidos de compradores. En el ecosistema, el móvil publica y el backend expone el catálogo público.

Moneda base. Moneda del negocio (default_currency), referencia de precios, vuelto y reportes. Las demás monedas se convierten con su tasa.

Negocio (tenant). Empresa cuyos datos están aislados del resto en el backend. Un usuario puede pertenecer a varios negocios y elige el actual; todo el sync va contra el negocio actual.

POS. Punto de venta: la caja concreta donde se cobra. Tiene código propio, caja asignada y serie de facturación.

PouchDB. Base de datos documental que corre dentro del cliente y guarda el negocio completo en local. En el móvil usa SQLite; en el escritorio, IndexedDB.

Protocolo de sync. Nivel más bajo de compatibilidad (hoy 1). Viaja en X-Sync-Version y cambia solo cuando se rompe la forma de hablar entre cliente y servidor.

Pull y push. Las dos direcciones de la sincronización: pull trae del servidor los cambios posteriores al cursor; push envía la cola local de eventos.

Redondeo. Ajuste a dos decimales de importes y totales con una regla fija por moneda, para que la suma de las líneas coincida con el total.

Rol. Perfil de permisos: dueño (owner), vendedor (seller), cajero (cashier) y cocina (kitchen). El dueño administra; los operativos venden y cobran según su alcance.

Sanctum. Sistema de tokens de Laravel. Emite el token de sync con alcance sync:owner o sync:seller y lo vincula al negocio actual.

Sesión de caja. Periodo entre la apertura y el cierre de una caja, con saldo inicial, ventas, movimientos y arqueo final. Un solo dispositivo la arbitra a la vez (lease master).

Snapshot. Copia congelada de un dato en un momento: los datos fiscales de la factura, el inventario final del cierre o el estado de la licencia.

Tasa. Tipo de cambio de una moneda contra la base. Se usa para convertir precios y para calcular el vuelto en moneda base.

Para seguir leyendo

↑↓ para navegar · Enter para abrir · Esc para cerrar