Documentación - CitySales

Primeros pasos

Introducción a CitySales

CitySales es un sistema integral de gestión comercial desarrollado para optimizar y controlar el proceso de venta a clientes mayoristas en tiempo real. Está diseñado para empresas comercializadoras que necesitan monitorear su operación de campo, mejorar la precisión en el control de inventarios y garantizar la trazabilidad de cada transacción.

El sistema se compone de tres pilares tecnológicos principales:

App Móvil

Para promotores y supervisores en campo: ruteo, ventas, cobranza, inventario y geolocalización.

App de Escritorio

Para roles administrativos y gerenciales: supervisión, estadísticas, gestión de productos y finanzas.

Backend Web

Motor central que gestiona sincronización, seguridad, almacenamiento y lógica del negocio.

Roles disponibles en el sistema

Rol	Descripción
Promotor	Realiza visitas a clientes, registra ventas, cobranzas y efectúa el corte diario.
Supervisor	Monitorea promotores en tiempo real, valida rutas y genera reportes de supervisión.
Administrador	Configura productos, rutas, precios, clientes y parámetros del sistema.
Gerencia	Acceso completo a estadísticas, cortes, configuración y análisis estratégico.

💡 Consejo: Si es tu primera vez, sigue esta documentación en orden para configurar correctamente tu cuenta antes de comenzar a operar.

Primeros pasos

Instalación y requisitos

CitySales está disponible en dos plataformas: aplicación de escritorio para Windows, orientada a la administración y control, y aplicación móvil para Android, diseñada para la operación diaria de promotores y supervisores en campo.

Versión de escritorio (Windows)

Descarga el archivo CitySales_Setup.exe, ejecútalo y sigue los pasos del instalador. Al finalizar se creará un acceso directo en tu escritorio.

App Móvil (Android)

Recibe el archivo CitySales.apk por correo o WhatsApp. Si tu dispositivo bloquea instalaciones externas, ve a Ajustes → Seguridad → Permitir apps de fuentes desconocidas.

Requisitos del sistema

Plataforma	Requisito
Windows (escritorio)	Windows 10 u 11, 8 GB de RAM mínimo, 500 MB de espacio en disco, conexión a internet
Android (móvil)	Android 10.0 o superior, 4 GB de RAM mínimo, GPS activado, Bluetooth (para impresora de tickets)
Permisos requeridos (móvil)	Ubicación, cámara, micrófono y almacenamiento
Conexión	Internet para sincronización (funciona offline con sincronización posterior)
iOS	Sin soporte para sistemas operativos iOS

Primeros pasos

Primer inicio de sesión

La gerencia de tu empresa te proporcionará las credenciales de acceso (usuario corporativo y contraseña). El proceso de inicio es el mismo tanto en la app móvil como en la aplicación de escritorio.

Pasos para acceder

1
Abre CitySales
En móvil, toca el ícono de City Sales. En escritorio, abre el acceso directo del escritorio. Verás una animación de carga con el logotipo.
2
Ingresa tu usuario corporativo y contraseña
Estos datos son proporcionados por tu empresa al momento de la contratación del servicio.
3
Presiona "Acceder"
Si es tu primer ingreso, el sistema te solicitará cambiar tu contraseña de inmediato.
4
Lee y acepta el aviso de privacidad
Al iniciar por primera vez, deberás leer y aceptar el Aviso de Privacidad para continuar.
5
Acepta los permisos de la app (móvil)
La app solicitará permisos de ubicación, cámara, micrófono y almacenamiento. Acéptalos todos para garantizar el correcto funcionamiento del sistema.

Primeros pasos

Permisos y privacidad

La app móvil de CitySales solicita ciertos permisos del dispositivo para funcionar correctamente. A continuación se explica para qué se utiliza cada uno:

Permiso	¿Para qué se usa?
Ubicación	Valida que el promotor esté en el lugar correcto al realizar ventas (radio de 25 metros del cliente).
Cámara	Para tomar fotografías en visitas de revisión como evidencia del estado del producto en punto de venta.
Micrófono	Para grabaciones de monitoreo de calidad entre promotor y cliente.
Almacenamiento	Para guardar tickets, datos de ventas y registros localmente cuando no hay conexión.

💡 Consejo: Acepta todos los permisos para que la app funcione correctamente. Sin ellos, algunas funciones como ventas geovalidadas o revisiones con foto quedarán inhabilitadas.

Módulos

Ventas en ruta

El módulo de ventas permite al promotor registrar pedidos directamente desde el punto de venta. El sistema valida automáticamente la ubicación geográfica del promotor antes de procesar cualquier venta: debes estar a menos de 25 metros del cliente.

⚡ Modo offline: CitySales guarda las ventas localmente y las sincroniza automáticamente con la nube en el siguiente ciclo de conexión disponible.

Cómo registrar una venta

1
Selecciona al cliente desde tu lista de visitas del día y toca "Visitar cliente".
2
Elige "Realicé una venta" en el menú de acciones del cliente.
3
Agrega productos desde el catálogo buscando por nombre, código de barras o grupo. Ajusta la cantidad con los botones + / – o ingresándola manualmente.
4
Agrega devoluciones o promociones si aplican según la configuración de la empresa.
5
Elige el tipo de venta: contado (el cliente paga al momento), crédito (genera pagaré con firma digital) o cancelar (requiere comentario justificado).
6
Imprime y entrega el ticket al cliente mediante tu impresora térmica Bluetooth.

Tipos de venta disponibles

Tipo	Descripción
Venta de contado	El cliente paga de inmediato. El sistema calcula el cambio automáticamente y genera ticket.
Venta a crédito	El cliente paga después. Se genera un pagaré integrado en el ticket que debe ser firmado por el cliente.
Cliente eventual	Venta a un cliente no registrado en la ruta, con precio de menudeo configurado al promotor.

⚠️ Restricción de ubicación: Solo puedes registrar ventas si estás a menos de 25 metros del cliente. El sistema valida esto automáticamente mediante GPS.

Módulos

Gestión de clientes

Administra toda la información de tus clientes desde la app móvil o la aplicación de escritorio. Cada cliente cuenta con un perfil completo que incluye historial de compras, créditos pendientes, calificaciones de visitas anteriores y datos de geolocalización.

Agregar o editar un cliente

Tanto promotores como supervisores pueden registrar nuevos clientes desde la app móvil tocando el botón de acción y seleccionando "Nuevo cliente". Los administradores disponen de un formulario más completo en la aplicación de escritorio con soporte geoespacial avanzado, múltiples días de visita y configuración de tipo de precio por cliente.

💡 Consejo: Usa el botón "Calcular dirección" si estás dentro de la mancha urbana. El sistema obtendrá automáticamente los datos de la dirección a partir de tu ubicación GPS, consultando los registros del Servicio Postal Mexicano (SEPOMEX).

Módulos

Rutas y mapas

El módulo de rutas organiza la lista de clientes que cada promotor debe visitar durante el día, en un orden predefinido. CitySales registra la geolocalización de cada visita y permite a los supervisores y administradores monitorear el avance en tiempo real desde el panel de escritorio.

Validación geográfica en cada visita

Historial de recorridos con mapa interactivo

Seguimiento en tiempo real cada 30 segundos

Marcadores en el mapa (vista administrador)

Marcador	Significado
Punto rojo (grande)	Ubicación actual del promotor en campo.
Líneas azules	Recorrido completo de la ruta del promotor.
Punto verde	Inicio del recorrido del día.
Punto rojo (fin)	Fin del recorrido registrado.
Puntos azules pequeños	Puntos GPS intermedios del trayecto.
Colores variables	Estado de la visita: cancelada, revisión, venta de contado, venta a crédito.

Módulos

Corte diario

El corte es el proceso de cierre de jornada mediante el cual el promotor verifica y concilia la información física y monetaria con los registros del sistema. Debe realizarse al final del día, una vez completadas todas las visitas, y requiere que el inventario inicial haya sido registrado correctamente al inicio de la jornada.

⚠️ Importante: Solo puedes realizar el corte si registraste el inventario inicial del mismo día. Sin este dato, el sistema no puede calcular las diferencias de inventario.

Etapas del corte

1
Inventario final
Registra la mercancía restante de cada producto, las devoluciones que llevas de regreso y la carga que solicitas para el día siguiente.
2
Conteo de efectivo
Ingresa cuántos billetes y monedas tienes de cada denominación. El sistema suma automáticamente el total y lo compara con lo esperado.
3
Revisión y cierre
Revisa el resumen con ventas del día, diferencias de inventario y dinero a liquidar. Si todo está correcto, toca "Aceptar y cerrar". El sistema generará automáticamente el inventario inicial para el día siguiente.

💡 Nota: La conciliación final es un acuerdo entre el promotor y la empresa. Ambas partes deben resolver cualquier discrepancia entre los datos teóricos y los valores reales antes de cerrar el corte. Una vez cerrado, no se permiten modificaciones.

Módulos

Reportes y estadísticas

CitySales genera reportes automáticos de ventas, visitas, clientes y desempeño por promotor. Los administradores pueden acceder a estadísticas detalladas por período, ruta, usuario y producto directamente desde la aplicación de escritorio. Los reportes pueden exportarse.

Tipos de reportes disponibles

• Ventas por período (día, semana, mes) con desglose por contado y crédito
• Desempeño por promotor: visitas realizadas vs. programadas, porcentaje de éxito
• Análisis de productos: top 10 más vendidos, grupos con menor rotación
• Cobertura geográfica y cumplimiento de rutas por territorio
• Estado de cuentas por cobrar y cobros pendientes por cliente
• Movimientos de dinero: ventas, cobranzas y gastos por ruta
• Reportes de supervisión con calificación de promotores por jornada
• Cortes diarios en PDF con firma para respaldo físico

Estadísticas en tiempo real (panel de seguimiento)

El panel de seguimiento del administrador muestra estadísticas actualizadas automáticamente cada 30 segundos, incluyendo visitas del día, desglose económico por ruta, circulante (ingresos, cobranzas y gastos) y resultados de ventas por territorio.

Soporte

Preguntas frecuentes

Sí. La app móvil guarda las ventas, cobranzas y registros de visita localmente y los sincroniza automáticamente con la nube en el siguiente ciclo cuando se recupera la conexión. Esto garantiza continuidad operativa en zonas con señal limitada.

Verifica que tengas el GPS activado y que estés físicamente a menos de 25 metros del cliente. El sistema valida la ubicación automáticamente antes de permitir cualquier venta. Si el problema persiste, reinicia la app, confirma que el permiso de ubicación esté activo y confirma que estas dentro de los 25 metros del punto donde esta registrado el cliente, de lo contrario, actualiza los datos.

Desde la sección Configuración de la app, accede a "Configuración de impresora". El sistema te guiará paso a paso para vincular tu impresora térmica Bluetooth: activa el Bluetooth de tu dispositivo, sincroniza la impresora, obtén su dirección MAC e ingrésala en la app. La validación se realiza imprimiendo un código de 12 caracteres que debes confirmar. Tienes hasta tres intentos.

CitySales soporta hasta diez precios por producto: mayoreo, menudeo, precios especiales y precios para rutas foráneas. Esto te permite atender clientes con distintas condiciones comerciales sin configuraciones adicionales por venta.

En la ficha del cliente, toca la cantidad resaltada en amarillo y selecciona "Ver más…". Elige el folio a cobrar y toca "Realizar cobranza". Ingresa el monto recibido: si cubre el total, el sistema lo marca como pagado; si es menor, lo registra como abono. También puedes registrar cobranzas a distancia (pagos electrónicos) desde la sección Caja de tu pantalla principal.

Sí. Toda la información se almacena en servidores seguros con autenticación basada en JWT y cifrado de datos sensibles. Las operaciones offline se respaldan localmente y se sincronizan con validación al recuperar la conexión.

Soporte

Contactar soporte

¿No encontraste lo que buscabas? Descarga los manuales completos de nuestras aplicaciones para consultar guías detalladas por rol: promotor, supervisor y administrador.

Descargas

Si aún necesitas ayuda adicional, nuestro equipo de soporte está listo para asistirte de forma personalizada.

Chat de soporte