Detalle de cliente

Al hacer clic en cualquier cliente desde la lista, se abre su ficha completa en /contacts/:id. Desde aquí gestionas la relación comercial, el seguimiento de próxima acción, el estado de cobro y el contexto de equipo de ese cliente.

Cabecera y resumen comercial

La parte superior muestra los datos principales del cliente y señales de estado en tiempo real:

Nombre (empresa o particular) e icono de tipo de contacto
NIF/CIF, email, teléfono, web y dirección fiscal
Insignia de atención: indica si el cliente está Al día o requiere seguimiento (Factura vencida, Tarea vencida, Tarea para hoy, Relación sin avance, Sin siguiente paso o Alto cobro pendiente). Al pulsar una insignia accionable, la ficha salta directamente al panel o pestaña que la resuelve.
Última interacción: muestra el tipo (Llamada, Reunión, Email o Email enviado) y el tiempo transcurrido desde el último contacto registrado.
Origen de integración: cuando el cliente proviene de una importación o sincronización externa (hubspot, pipedrive, intercom o mailchimp), se muestra su etiqueta de origen junto al nombre.

Debajo de la cabecera aparecen cuatro tarjetas de métricas y el bloque Venta y cobro:

Tarjeta	Qué muestra
Facturado	Importe total facturado al cliente
Pendiente	Saldo pendiente de cobro
Facturas	Número total de facturas emitidas
Desde	Fecha de la primera factura (antigüedad)

El bloque Venta y cobro resume en tres columnas los Presupuestos abiertos o aceptados listos para convertir, el importe Por cobrar (con aviso de facturas vencidas) y el total Cobrado, con enlaces directos a Ver documentos y Ver extracto.

Próxima acción y franja de foco

Encima de las pestañas se encuentran dos bloques diseñados para que ninguna relación comercial quede sin siguiente paso:

Panel de próxima acción

Define el único compromiso inmediato pendiente con el cliente (nextAction):

Si no hay tarea abierta (Sin próxima acción), pulsa Añadir tarea.
En Crear próxima acción, escribe una frase concreta (por ejemplo, "Llamar para validar presupuesto") y, opcionalmente, una Fecha límite (YYYY-MM-DD). Pulsa Guardar tarea (o Enter).
Cuando la tarea está abierta, el panel muestra su estado temporal (Próxima acción, Hoy si vence en la fecha actual o Vencida si la fecha límite ya pasó) y dos acciones rápidas:
- Cambiar: reemplaza el título o la fecha límite de la próxima acción.
- Hecho: marca la próxima acción como completada (status: "done", completedAt) y registra automáticamente una entrada Hecho: {título} en el timeline de Notas y actividades.

Franja de foco

Evalúa el estado del cliente y sugiere la acción prioritaria del momento:

Estado detectado	Título en Foco	Acción directa
Empresa sin personas de contacto	Falta una persona responsable	Abrir personas
Saldo pendiente de cobro	Hay saldo pendiente	Ver extracto
Sin próxima acción definida	Falta próxima acción	Crear próxima acción
Próxima acción abierta pendiente	Próxima acción abierta	Ver próxima acción
Contacto y actividad recientes sin avanzar	Listo para revisar etapa	Revisar actividad
Contacto, actividad y cobros en orden	Seguimiento al día	Ver salud

Pipeline (estado del cliente)

Cada cliente tiene una etapa dentro de tu pipeline comercial. Haz clic en cualquier etapa del selector para actualizarla; el cambio de etapa anterior a nueva queda registrado automáticamente en el timeline de actividad (stage_changed).

Estado	Descripción
Lead	Contacto nuevo, aún no cualificado
Contactado	Has iniciado conversación
Propuesta	Has enviado presupuesto o propuesta
Activo	Cliente con relación comercial activa
Inactivo	Cliente sin actividad reciente
Perdido	Oportunidad cerrada sin éxito

Pestañas de la ficha

Pestaña Actividad

Muestra el timeline cronológico de eventos automáticos (facturas, presupuestos, gastos vinculados, cambios de etapa) y actividades manuales. Cuando el cliente tiene una próxima acción abierta, aparece fijada en la parte superior como Próximo. Desde los botones inferiores puedes Registrar llamada, Registrar reunión o Añadir tarea. Consulta el detalle en Notas y actividades.

Pestaña Salud

Calcula una puntuación determinística de Salud del cliente (0–100) basada exclusivamente en los datos de tu cuenta (sin llamadas a modelos de IA):

Nivel de riesgo: Sano, En riesgo o Crítico, acompañado de la tendencia de los últimos 12 meses (Mejorando, Estable o Empeorando).
Cuatro subpuntuaciones: Pagos (puntualidad de cobro), Volumen (facturación acumulada), Actividad (frecuencia de interacción) y Lealtad (antigüedad y recurrencia).
Observaciones y recomendaciones: factores de riesgo detectados y acciones sugeridas priorizadas (Alta, Media, Baja).

Pestaña Notas

Notas internas sobre el cliente visibles únicamente para tu equipo:

Escribe en el área Escribe una nota... y pulsa Guardar o Cmd+Enter (Ctrl+Enter en Windows/Linux).
Cada nota muestra su fecha relativa y la etiqueta (editada) cuando ha sido modificada.

Pestaña Personas

Lista las personas de contacto asociadas a la empresa con su contador en la cabecera de la pestaña. Pulsa Añadir persona para registrar nombre, cargo, email y teléfono. Más detalles en Personas de contacto.

Pestaña Documentos

Lista las Facturas y Presupuestos vinculados al cliente con su estado actual y acceso directo a cada documento.

Pestaña Extracto

Abre el Extracto de cuenta del cliente con el desglose de facturas emitidas, importes cobrados y saldo pendiente por periodo.

Pestaña Proyectos

Muestra los proyectos y tareas activos asignados al cliente dentro del espacio de trabajo.

Paridad con API REST y servidor MCP

El objeto nextAction y el campo integrationSource de la ficha del cliente forman parte del mismo contrato en la API REST (/v1/clients y /v1/clients/{clientId}) y en el servidor MCP (get_client, create_client, update_client):

curl -X PATCH "https://api.frihet.io/v1/clients/cli_01J8X9K2M4" \
  -H "X-API-Key: fri_tu_clave_aqui" \
  -H "Content-Type: application/json" \
  -d '{
    "integrationSource": "hubspot",
    "nextAction": {
      "title": "Llamar para validar el presupuesto aceptado",
      "dueDate": "2026-11-05",
      "status": "open",
      "source": "api"
    }
  }'

Límites y alcance del contrato

nextAction.title (obligatorio dentro de nextAction): cadena de hasta 500 caracteres.
nextAction.status (obligatorio dentro de nextAction): admite "open" o "done".
nextAction.dueDate (opcional): fecha ISO en formato YYYY-MM-DD.
nextAction.source (opcional): admite "manual", "api", "integration" o "system".
integrationSource (opcional): admite "hubspot", "pipedrive", "intercom" o "mailchimp".
Campos calculados en la app: las métricas de Salud del cliente (0–100) y la insignia de atención se calculan de forma determinística a partir de tus facturas, presupuestos y actividades; no son campos editables directamente por API.

Atajos de teclado

Navega por la ficha del cliente sin usar el ratón (mientras no tengas el foco en un campo de texto):

Atajo	Acción
Esc	Volver a la lista de clientes
a	Ir a pestaña Actividad
h	Ir a pestaña Salud
n	Ir a pestaña Notas
p	Ir a pestaña Personas
d	Ir a pestaña Documentos
e	Volver al listado para editar

Relacionado: Personas de contacto · Notas y actividades · Kanban CRM · Portal de cliente

Cabecera y resumen comercial​

Próxima acción y franja de foco​

Panel de próxima acción​

Franja de foco​

Pipeline (estado del cliente)​

Pestañas de la ficha​

Pestaña Actividad​

Pestaña Salud​

Pestaña Notas​

Pestaña Personas​

Pestaña Documentos​

Pestaña Extracto​

Pestaña Proyectos​

Paridad con API REST y servidor MCP​

Límites y alcance del contrato​

Atajos de teclado​