Saltar a contenido

Clientes

¿Qué es?

El módulo de Clientes es el directorio de empresas y personas naturales que contratan los servicios de seguridad o recursos humanos. Los clientes (también llamados "partners" o "terceros" internamente) se asocian a Proyectos, que a su vez se asocian a Puestos de trabajo y Novedades. Es el primer eslabón de la cadena: Cliente → Proyecto → Puesto.


Vista principal

La tabla muestra todos los clientes con las siguientes columnas:

  • Nombre — Nombre del cliente con avatar de iniciales de colores y badge de tipo:
  • Badge Empresa (azul pequeño) — Si es persona jurídica.
  • Badge Persona (gris pequeño) — Si es persona natural. Ancho máximo 280 px, truncado.
  • NIT / ID — Número de NIT o documento de identidad del cliente, formateado. Fuente monoespaciada. Ancho 150 px.
  • Teléfono — Número de teléfono formateado. Ancho 140 px.
  • Correo — Correo electrónico de contacto. Ancho máximo 220 px, truncado.
  • Ciudad — Ciudad donde se ubica el cliente. Ancho 160 px, truncado.

Filtros

  • Buscar por nombre o NIT... — Campo de texto libre.
  • Tipo — Selector: Todos, Empresa, Persona.
  • Estado — Selector: Activos (por defecto), Inactivos, Todos.

Ordenación por defecto

Ordenada por nombre ascendente (A → Z).


Acciones disponibles

Botón "Nuevo cliente"

Visible con permiso clients: create. Abre el modal de creación.

Botón "Importar"

Visible con permiso clients: import. Navega a la importación masiva (#/clients-bulk).

Exportar

Botón de exportación en la barra de la tabla. Descarga un archivo clientes. Requiere permiso clients: export.

Acciones masivas

Al seleccionar uno o más clientes:

  • Inactivar — Visible cuando el filtro de Estado es Activos o Todos. Requiere permiso clients: delete. Requiere doble confirmación (segundo clic en "¿Confirmar?").
  • Activar — Visible cuando el filtro de Estado es Inactivos. Requiere permiso clients: edit.
  • Eliminar — Requiere permiso clients: delete. Pide un segundo clic en "¿Confirmar eliminación permanente?". Al eliminar un cliente, su usuario del portal de clientes queda apagado (ver Eliminar un cliente y su acceso al portal).
  • Cerrar selección — Botón X para deseleccionar todo.

Al hacer clic en una fila o en el botón "Nuevo cliente" se abre el modal.

Campos del formulario

  • Nombre — Nombre del cliente o empresa (obligatorio).
  • NIT / ID (vat) — Número de identificación tributaria o documento. Texto libre.
  • Teléfono (phone) — Teléfono fijo de la empresa. Texto libre.
  • Celular (mobile) — Número de celular. Texto libre.
  • Correo (email) — Dirección de correo electrónico.
  • Dirección (street) — Dirección física. Campo con autocompletado de Google Places: al escribir más de 3 caracteres, sugiere direcciones. Al seleccionar una sugerencia, se completa automáticamente el campo Ciudad.
  • Ciudad (city) — Ciudad del cliente. Se rellena automáticamente al seleccionar una dirección; también editable manualmente.
  • Sitio web (website) — URL del sitio web del cliente.
  • Comentario (comment) — Campo de texto libre para notas internas.
  • Tipo (is_company) — Toggle que indica si es Empresa (activado) o Persona natural (desactivado).
  • Portal de clientes — Toggle Con acceso / Sin acceso. Con acceso aparecen Usuario de acceso y Contraseña (al editar, dejar la contraseña en blanco la mantiene) y el botón Copiar enlace de acceso, para mandarle al cliente la dirección de entrada.
  • Activo — Toggle para activar/inactivar el cliente.

Validaciones

  • El campo Nombre es obligatorio. Sin él, el botón Guardar muestra el error "El nombre es obligatorio".

Importación masiva de clientes (clients-bulk)

En Clientes, la importación masiva (Portal › Personas → Clientes → Importar) permite crear muchos clientes a la vez desde una hoja tipo Excel o desde un archivo analizado con IA, y de paso crearles el acceso al portal de clientes.

Columnas de la hoja

# Columna Obligatorio Notas
1 Nombre Sí Nombre del cliente o empresa. Las filas sin nombre se ignoran
2 NIT / ID No Número de identificación. Si trae letras (pasaporte) se conservan
3 Teléfono No Teléfono fijo
4 Celular No Número móvil
5 Correo No Email de contacto (se valida el formato)
6 Ciudad No Ciudad del cliente
7 Dirección No Dirección física
8 Tipo No Empresa o Persona
9 Con acceso No Casilla: si el cliente tendrá usuario en el portal de clientes. Viene marcada por defecto
10 Usuario No Usuario para entrar al portal de clientes. Vacío = el NIT
11 Contraseña No Contraseña del portal de clientes (se ve enmascarada). Vacía = el NIT

Importar desde archivo (con IA)

  1. Clic en Importar en la barra superior.
  2. Seleccionar archivo .csv, .xlsx o .xls.
  3. La IA analiza el archivo, mapea columnas automáticamente y llena la hoja. Muestra un resumen de cuántas columnas logró mapear y las advertencias.
  4. Si el archivo no trae la columna de acceso, o la celda viene vacía, el cliente queda Con acceso. Un «No» explícito se respeta.

La lectura del Excel cuida los datos: un documento con letras (por ejemplo un pasaporte) no pierde las letras y un valor escrito como 1300000.0 no se convierte en 13 millones.

Guardar importación

Botón Guardar envía los datos en bloques, con el progreso en porcentaje. Si todo entra, vuelve a la lista de clientes. Si alguna fila falla, en la hoja quedan solo las filas con error (las que ya entraron no se repiten al reintentar) y arriba sale el resultado: «Importados: N clientes (M con acceso al portal)» y la lista de filas con su motivo.


Importar clientes con acceso al portal de clientes

En la importación de Clientes se puede crear, en el mismo paso, el usuario con el que cada cliente entra al portal de clientes:

  • Con acceso viene marcado en todas las filas; desmárcalo para quien no deba entrar al portal.
  • Usuario y Contraseña son opcionales: si vienen vacíos se usa el NIT del cliente para ambos. Si no hay usuario ni NIT, la fila se marca en rojo: «Con acceso necesita un usuario (o un NIT para usarlo de usuario)».
  • Cada usuario debe ser único. Si ya existe en la empresa, o se repite dentro del mismo archivo, la fila falla con «El usuario «…» ya está en uso»: la primera fila con ese usuario se crea con acceso y las siguientes no.
  • Cada cliente con acceso ocupa un usuario del plan. Antes de crear nada se revisa que el lote quepa en los usuarios contratados; si no cabe, no se importa y el mensaje sugiere importar los clientes sin acceso o ampliar el plan.
  • Si el cliente se creó pero su acceso no se pudo crear, la fila dice «El cliente se creó, pero SIN acceso al portal…»: dale el acceso desde Editar cliente.

Eliminar un cliente y su acceso al portal

En Clientes, al eliminar un cliente (seleccionar filas → Eliminar → confirmar), su usuario del portal de clientes queda apagado: ya no puede entrar a su portal y deja de ocupar un usuario del plan. El usuario no se borra, se apaga, así que conserva su historial.

Inactivar un cliente, en cambio, solo lo oculta de la lista por defecto; para quitarle el acceso sin eliminarlo, abre el cliente y cambia Portal de clientes a Sin acceso.


Permisos

Acción Permiso requerido
Ver clientes clients: view
Crear cliente clients: create
Editar cliente clients: edit
Inactivar clients: delete
Exportar clients: export
Importar clients: import

Páginas relacionadas

  • Proyectos — Cada proyecto pertenece a un cliente. Al crear un proyecto, se selecciona el cliente.
  • Novedades — Las novedades se vinculan al cliente a través del proyecto.
  • Puestos — Los puestos están bajo proyectos que pertenecen a clientes.
  • Portal de clientes — Lo que ve un cliente con acceso.

Preguntas frecuentes

¿Puedo tener clientes sin NIT? Sí. El campo NIT/ID es opcional. Se puede registrar un cliente con solo el nombre.

¿Inactivar un cliente afecta sus proyectos? No directamente. Los proyectos y puestos asociados permanecen activos. La inactivación del cliente solo lo oculta del listado por defecto (filtro Activos).

¿Cuál es la diferencia entre Teléfono y Celular? Teléfono (phone) es para el número fijo de la empresa; Celular (mobile) para el número móvil del contacto. Ambos son opcionales.

¿Cómo le doy acceso al portal de clientes a muchos clientes a la vez? Usa Importar en Clientes: deja marcada la columna Con acceso y escribe usuario y contraseña, o déjalos vacíos para que se use el NIT. Ver Importar clientes con acceso al portal de clientes.

¿Qué usuario y contraseña quedan si los dejo vacíos al importar? Los dos toman el NIT del cliente. Si el cliente tampoco tiene NIT, la fila no se puede importar con acceso.

¿Por qué la importación dice «El usuario ya está en uso»? Ese usuario ya lo tiene otra persona de la empresa, o se repite en otra fila del mismo archivo. Solo la primera fila con ese usuario se crea con acceso; cambia el usuario de las demás y vuelve a guardar. Ver Importar clientes con acceso al portal de clientes.

¿Un cliente eliminado puede seguir entrando al portal de clientes? No. Al eliminarlo, su usuario del portal queda apagado y deja de ocupar un usuario del plan. Ver Eliminar un cliente y su acceso al portal.

¿Los clientes con acceso cuentan en mi plan? Sí. Cada cliente con acceso al portal ocupa un usuario del plan; si la importación no cabe en los usuarios contratados, no se importa nada.