ElVendedorDocs

Qué es ElVendedor

Qué problema resuelve ElVendedor, a quién sirve, qué piezas forman el ecosistema, qué comparten entre sí y qué requisitos pide antes de instalar.

Para todos4 min de lecturaActualizado el 16 de noviembre de 2026

ElVendedor es el sistema de gestión y punto de venta de MiraloAki SURL para comercios que venden cara a cara. Responde tres preguntas: qué problema resuelve, qué piezas lo forman y qué comparten entre sí. Sirve tanto si vas a usar la app como si vas a instalarla en el negocio de otra persona.

Qué problema resuelve

Problema típico en el mostrador Qué hace ElVendedor
«No sé qué vendí hoy ni cuánto entró en efectivo» Cierre de caja con arqueo y resumen del día por sesión
«El inventario nunca cuadra» Movimientos trazados, ajustes con motivo y snapshots por sesión
«Mis empleados venden por su cuenta» Roles de dueño y vendedor, sesiones por cajero y reportes por empleado
«Cuando no hay internet, no puedo trabajar» Operación completa sin conexión y sincronización al recuperarla
«Los clientes me deben y no llevo cuenta» Módulo de deudas con histórico, abonos parciales y estado de cuenta
«Imprimir tickets es un problema» Impresión Bluetooth en térmicas de 58 mm y PDF de respaldo

A quién sirve

  • Comercios minoristas que venden en persona: tiendas de barrio, kioscos, ferreterías, perfumerías, cafeterías.
  • Negocios con uno o varios puntos de venta, con empleados o sin ellos.
  • Dueños de MIPYMES que necesitan saber cuánto venden, cuánto les deben y cuánto stock tienen sin depender de un tercero para cada consulta.
  • Operaciones con conectividad inestable, donde estar en línea es la excepción y no la norma.

Las piezas del ecosistema

Pieza Dónde corre Qué hace
App móvil Android 8.0 o superior POS, caja, inventario, compras, deudas, catálogo en línea, marketplace y restaurante
App de escritorio Windows 10/11 y Linux POS y caja de mostrador, facturación fiscal, reportes en PDF y Excel, hub de restaurante
Backend Laravel 12 con Sanctum Autoridad del negocio: sync, licencias, catálogo/marketplace y caja
Catálogo y marketplace Servicios web sobre ese backend Catálogo público por negocio y pedidos multi-vendedor

El hub de restaurante no es un programa aparte: lo levanta la app de escritorio en la red local y los móviles se conectan por WebSocket. Ese tráfico no pasa por el backend.

Diagrama de la arquitectura: la app móvil y la app de escritorio guardan datos locales y sincronizan por HTTPS con la API del backend Laravel; el hub LAN de restaurante conecta los móviles con el escritorio en la red local.
Las dos apps trabajan sin conexión y sincronizan con el backend; el hub de restaurante vive solo en la red local.

Qué comparten las piezas

  • La misma cuenta y el mismo negocio. Todo dato sincronizado pertenece a un negocio y se identifica con un external_id estable entre el dispositivo y el servidor.
  • La misma versión de producto. Móvil y escritorio están en 2.1.6 (package.json de ambos repos). El backend no publica número de versión de producto: su referencia es APP_VERSION en el entorno.
  • El mismo protocolo de sincronización (sync v1). Protocolo 1 y contrato 1 en los tres repos, con las cabeceras Authorization, X-Sync-Version y X-Client-App-Version, y la matriz de entidades en X-Client-Entities.
  • La moneda base del negocio. Costos, utilidad, inventario y reportes se llevan en la moneda base; las demás son monedas extranjeras con su tasa.
  • La licencia del negocio, validada contra el backend.

Versión de producto y compatibilidad

Esta documentación cubre la versión de producto 2.1.6. Para saber qué versión de backend corresponde a tu instalación, consulta la matriz de compatibilidad.

Qué no es ElVendedor

  • No es una hoja de cálculo. Tiene caja, sesiones, roles, almacenes y trazabilidad de cada movimiento.
  • No requiere internet permanente. Opera completa sin conexión y sincroniza cuando puede.
  • No es un ERP contable. No genera asientos contables ni integra directamente con la administración tributaria, pero exporta lo que un contador necesita.
  • No es un e-commerce con reparto. Publica productos en el marketplace y en el catálogo en línea; el reparto y el cobro en línea no forman parte del alcance actual.
  • No sustituye la facturación electrónica donde la regulación la exija: complementa el proceso.
  • No es un sistema de gestión en el navegador. Los dos clientes del negocio son aplicaciones instaladas; la web del marketplace y el catálogo en línea son canales de venta, no el sistema de gestión.

Requisitos generales

Pieza Requisito
Móvil Android 8.0 o superior, 2 GB de RAM y 200 MB libres
Periféricos (opcional) Impresora térmica Bluetooth de 58 mm y lectora Bluetooth
Escritorio Windows 10/11 o Linux de escritorio; Node.js 22 o superior solo para compilar
Backend PHP 8.2 o superior (probado con 8.4.5), Laravel 12, base de datos relacional y tareas programadas activas
Red Wi-Fi o datos móviles para sincronizar; el hub de restaurante necesita LAN

Necesito… → pieza que lo resuelve

Necesito… Dónde está
Cobrar rápido en el mostrador y emitir ticket Punto de venta
Saber cuánto hay en la caja al cerrar Caja
Controlar stock entre almacenes Inventario
Llevar la cuenta de los clientes que deben Clientes y deudas
Cobrar en dos monedas con vuelto Multimoneda
Poner mi catálogo público con pedidos por WhatsApp Catálogo en línea y marketplace
Instalar la app en un negocio Requisitos
Desplegar el backend o actualizar versiones Despliegue del backend

Por dónde seguir

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