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.
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.
Qué comparten las piezas
- La misma cuenta y el mismo negocio. Todo dato sincronizado pertenece a un
negocio y se identifica con un
external_idestable entre el dispositivo y el servidor. - La misma versión de producto. Móvil y escritorio están en 2.1.6
(
package.jsonde ambos repos). El backend no publica número de versión de producto: su referencia esAPP_VERSIONen el entorno. - El mismo protocolo de sincronización (
sync v1). Protocolo1y contrato1en los tres repos, con las cabecerasAuthorization,X-Sync-VersionyX-Client-App-Version, y la matriz de entidades enX-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
- ¿Usas la app en tu negocio? Empieza en la guía del cliente por Primeros pasos.
- ¿La instalas en un cliente? Ve a Guía del implementador.
- ¿Necesitas saber qué cambió? Consulta el Historial de versiones y la matriz de compatibilidad.
¿Falta algo o encontraste un error?
Ayúdanos a mejorar esta documentación con tu experiencia real.
Escribir a soporte