POS — Clientes
¿Qué es?
El módulo de Clientes es un directorio de los clientes del negocio con historial de órdenes y datos de contacto. Permite buscar clientes al hacer una venta y asociar la orden a su perfil.
Se accede desde "Clientes" en el sidebar (ícono de grupo), URL: .../customers. Solo visible si enableCustomers = true en la configuración.
Requiere permiso customers:read.
---
Lista de clientes (.../customers)
Encabezado
- Título "Clientes"
- Botón "Nuevo cliente" (requiere
customers:create) - Campo de búsqueda por nombre, teléfono o correo
Tabla de clientes
Para cada cliente:
- Nombre completo
- Teléfono
- Correo electrónico
- Número de órdenes realizadas
- Total gastado
- Fecha de último pedido
- Botones de ver detalle y editar
---
Crear / Editar cliente
Campos estándar más cualquier campo personalizado configurado en Campos de clientes (/customer-settings):
Campos estándar
- Nombre (requerido)
- Teléfono
- Correo electrónico
- Dirección(es) guardadas — múltiples direcciones de entrega
Campos personalizados
El administrador puede agregar campos adicionales como "RFC", "Empresa", "Notas internas", etc. Estos aparecen en el formulario de cliente según la configuración de /customer-settings.
---
Perfil de cliente (detalle)
Al ver el detalle de un cliente:
- Información de contacto completa
- Historial de órdenes (lista con número, fecha, total, estado)
- Direcciones guardadas
- Campos personalizados con sus valores
---
Uso en el checkout
Al crear una orden de domicilio, el cajero puede:
- Buscar un cliente existente por nombre o teléfono
- Seleccionarlo y sus datos de dirección se precargan automáticamente
- Seleccionar una dirección guardada del cliente
Si se vincula un cliente a la orden, el campo customerId se guarda en la orden y el historial del cliente se actualiza.
---
Campos de clientes personalizados (.../customer-settings)
Desde Configuración → Campos de clientes, el administrador puede:
- Agregar campos extra al formulario de cliente (texto, número, fecha, selección)
- Marcar campos como requeridos u opcionales
- Reordenar los campos
- Desactivar campos sin eliminarlos
Estos campos también aparecen en el app de clientes si está habilitado.
---
App de clientes
Los clientes finales pueden acceder a su historial de órdenes a través de la app móvil de clientes (Expo/React Native). Al crear una cuenta en la app, el perfil se vincula por correo electrónico al registro de cliente del POS.
La app de clientes muestra:
- Menú del negocio
- Historial de órdenes con estados en tiempo real
- Perfil del usuario