Detalle de cliente

Ruta: /clientes/[id] Quién la usa: dueño (y cualquier rol al que se le otorgue client.view) Permiso requerido: client.view para abrirla; client.edit para guardar el Perfil; settings.manage para mover «Exento de ITBMS» Capturas: docs/manual/screenshots/clientes/

Qué es

La ficha de un cliente. En el encabezado van el nombre, el contacto (teléfono · correo, o «Sin contacto»), las etiquetas y —si tiene— la alerta de cuenta en una franja roja. Debajo hay tres pestañas en la versión de restaurante: Resumen (cuatro tarjetas de cifras), Perfil (los datos editables, incluida la identidad fiscal) y Compras (el historial de pedidos, cada uno desplegable línea por línea), más Tarjetas y créditos. La pestaña «Citas» no existe en restaurante.

Cuándo se usa

Cuando hay que resolver algo de una persona concreta: confirmar qué pidió, cuánto ha gastado, corregirle el teléfono, cargarle el RUC para una factura con datos fiscales, o marcarla como inactiva. También se llega aquí desde el buscador del encabezado: escribir un nombre abre la ficha, y escribir el número de un pedido abre directamente la pestaña Compras con esa compra desplegada y resaltada.

Paso a paso

Abra la ficha desde el listado de Clientes o desde el buscador del encabezado. Entra en Resumen.
Lea las cuatro tarjetas: Pedidos, Total gastado, Último pedido y Saldo en tarjetas. En frankies-sim, «Consumidor Final» cerró el día con 15 pedidos y $357.56; «Ana Web», con 1 pedido y $19.26.
Abra Compras para ver el historial. Arriba va Total histórico: y debajo una fila por pedido con el número (#18), la fecha y hora, cuántos artículos y el total.
Presione una fila para desplegar sus líneas con el precio de cada una.
Si llegó buscando un número de pedido en el encabezado, esa compra ya viene abierta y con el borde resaltado.
Abra Perfil para corregir datos. Modifique lo que haga falta y presione Guardar.
Abra Tarjetas y créditos para ver las tarjetas de regalo compradas por este cliente y los créditos de paquetes. En frankies-sim las dos listas dicen «Ninguna.» y «Ninguno.».

Campos y botones

Campo/Botón	Qué hace	Notas
← Clientes	Vuelve al listado	—
Resumen / Perfil / Compras / Tarjetas y créditos	Cambian de pestaña	La pestaña queda en la dirección (`?tab=perfil`)
Pedidos	Cuenta los pedidos no cancelados del cliente	Cuenta tanto los ligados al cliente como los ligados por factura (los de mostrador)
Total gastado	Suma de las facturas pagadas	—
Último pedido	Fecha del pedido más reciente	«—» si no hay ninguno
Saldo en tarjetas	Saldo vigente de sus tarjetas de regalo activas	—
Total histórico (Compras)	Suma de los pedidos listados	—
Fila de compra	Despliega las líneas del pedido con su precio	Muestra `2× Pepperoni 14"` cuando la cantidad es mayor que 1
Nombre · Apellido · Correo · Teléfono · Género · Fecha de nacimiento	Datos de contacto	El teléfono trae selector de país
Alerta de cuenta	Texto que se muestra en franja roja en la ficha y como ⚠ en el listado	Déjelo vacío para quitarla
Etiquetas (separadas por coma)	Marcas del cliente	Solo las editables; la de sistema («consumidor final», el cliente de mostrador) sale aparte como chip fijo bajo «Etiquetas del sistema» y no se edita
Notas	Texto libre interno	—
Tipo receptor	Consumidor final / Con RUC / Extranjero	Bloque «Identidad fiscal (eFactura) — opcional»
RUC · DV · Pasaporte	Datos fiscales del receptor	Solo se usan si el tipo receptor lo requiere
Exento de ITBMS — sus pedidos se facturan con tasa 0%	Marca al cliente como exento	Solo lo mueve `settings.manage`; para los demás sale deshabilitado y con el texto «(solo administración)»
Activo	Da de baja o de alta al cliente	Al desmarcarlo el encabezado muestra la etiqueta «Inactivo»
Guardar	Guarda el Perfil	Sin `client.edit` no aparece el botón

Mensajes y errores

"Sin contacto" — el cliente no tiene teléfono ni correo cargados.

"Sin compras." — la pestaña Compras sin pedidos.

"Ninguna." / "Ninguno." — sin tarjetas de regalo y sin créditos de paquetes.

"Sin permiso para editar (client.edit)." — reemplaza al botón Guardar en la pestaña Perfil.

"No tienes permiso para esta acción." NG_FORBIDDEN — respuesta del servidor a una operación sin permiso.

"404 — This page could not be found." — lo que devuelve la ruta si el cliente no existe o si el rol no tiene client.view. Verificado con el Gerente de la simulación: la ficha del cliente de mostrador le responde 404.