mseller docs

¿Qué es mseller?

Qué es mseller, a quién sirve, de dónde viene y hacia dónde va — la visión general del producto antes de meterse al código.

mseller es una plataforma de gestión comercial y distribución pensada para pequeñas y medianas empresas. Cubre el día a día de la operación: toma de pedidos en ruta, facturación, inventario, cuentas por cobrar y por pagar, y la integración con los sistemas que ya usan los clientes (SAP y otros ERPs).

Misión

Darle a la PyME las mismas capacidades operativas que históricamente solo tenían las grandes empresas — sin obligarla a montar un ERP gigante ni a contratar un equipo de TI. La regla es simple: si una herramienta no ayuda a la operación real (vender, facturar, cobrar, despachar), no entra al producto.

Foco operativo

mseller no es un CRM ni una suite de productividad: es un sistema operativo para vender y distribuir. Las decisiones de producto se toman desde el punto de vista de quien está en la calle haciendo la operación —vendedor, despachador, administrador— y no desde reportes o dashboards corporativos.

Soluciones móviles

Las apps móviles son el corazón del producto. La operación de campo manda — los pedidos, los cobros y el inventario se capturan donde ocurren, no en una oficina:

  • mobile-seller (iOS, Swift) — la app de los vendedores en ruta: toma de pedidos, cobros, facturación e inventario.
  • mseller-lite (React Native / Expo) — la app de almacén: picking de pedidos y carga de camión.

Ambas se conectan al backend con autenticación Firebase y consumen la misma Consumo.Api.

Inventario y logística

El inventario es multi-almacén y se mueve en sincronía con la operación: cada pedido tomado desde la app móvil descuenta stock, cada carga de camión genera movimientos, cada devolución se refleja en el mismo lugar. La parte logística cubre el flujo Order to Delivery (O2D): preparación, carga y entrega, con trazabilidad por chofer y por ruta.

Productos complementarios

Más allá del core de ventas y distribución, mseller tiene productos satélite que resuelven necesidades específicas del mercado donde opera:

ecf.mseller.app — Comprobantes Fiscales Electrónicos (RD)

Solución para e-CF (factura electrónica) en República Dominicana, alineada al estándar de la DGII. Funciona como módulo integrado al stack mseller y también como servicio independiente para clientes que solo necesitan emitir e-CF sin migrar todo su ERP. Vive en ecf.mseller.app.

La compañía

mseller está registrada en Estados Unidos como empresa, y opera en República Dominicana a través de una alianza estratégica con itsoluclick, que aporta presencia local, soporte y operación comercial en el mercado dominicano. Esta estructura permite mantener la base corporativa en EE.UU. mientras se sostiene una operación cercana al cliente en RD —donde está la mayor parte de la base instalada hoy— y soporta la integración con la DGII (e-CF) sin fricción.

Un poco de historia

mseller empezó en 2008 como una app móvil para vendedores —el "mobile seller"— en una época donde los vendedores en ruta seguían tomando pedidos en libreta y digitando todo a mano al volver a la oficina. La idea original fue resolver eso: un dispositivo en la mano del vendedor que capturara el pedido en el momento y lo sincronizara con el sistema central.

De ahí en adelante el producto fue creciendo conforme los clientes pedían más cosas: facturación, inventario, cuentas por cobrar (CxC), cuentas por pagar (CxP), reportes, integraciones. Lo que empezó como una app de toma de pedidos hoy se está convirtiendo en un ERP autónomo con su propio portal web (cloud.mseller.app), su backend multi-tenant, y un ecosistema de apps que cubren toda la cadena operativa.

Implementación legacy: mobile-seller.com

La versión original del producto sigue viva en mobile-seller.com — el sitio y el sistema heredado del 2008 en adelante. Hay clientes que todavía operan ahí y seguirá funcionando hasta que termine la migración al stack actual (mseller.app). Cuando veas referencias a "el sistema viejo" o "la versión legacy" en código o conversaciones, es esto.

Sobre el backend en español (y el Spanglish)

Una nota honesta para quien llega nuevo al código: el backend está escrito en español. Los nombres de tablas, columnas, entidades y muchos endpoints están en español (Cliente, Factura, Pedido, CuentaPorCobrar, etc.). Esto fue una mala decisión temprana que arrastramos desde el inicio del producto, cuando no había la disciplina de mantener el dominio técnico en inglés.

El resultado hoy es un Spanglish mezclado: nombres de dominio en español, nombres técnicos (frameworks, librerías, infraestructura) en inglés, y la documentación en español. No es ideal y queremos mejorarlo a futuro — probablemente como parte de una refactorización mayor del backend — pero por ahora respeta la convención existente: si tocas una entidad en español, los nombres nuevos siguen en español para mantener la coherencia. Cambiarlo a medias deja el código peor de como estaba.

Siguientes pasos