Clientes

Para qué sirve

El catálogo de Clientes guarda a las personas y empresas a las que les vendes: el taxista que pide boleta con su DNI, la empresa de transportes que exige factura con su RUC, el colectivo que siempre carga con la misma placa. Con un cliente bien registrado:

• Emites boletas y facturas con el nombre, documento y dirección fiscal correctos (sin rechazos de SUNAT).
• En la isla el playero lo encuentra por la placa del vehículo o por su documento, sin escribir todo de nuevo.
• Puedes aplicarle precios por segmento o precios pactados (en el módulo de Precios), darle una línea de crédito, controlar sus percepciones y que acumule puntos del programa de fidelización.

Todo se hace en una sola pantalla: el listado, la ventana Nuevo cliente / Editar cliente y la ventana Placas del cliente. Cómo se elige o registra al cliente durante una venta está en Clientes en el POS.

Dónde está

Menú:Configuración›Clientes/clientes

La opción solo aparece si el plan de tu empresa incluye el módulo de clientes y tu rol tiene el permiso de ver clientes. El catálogo es de la empresa: es el mismo para todas tus estaciones (un cliente registrado en una estación lo ven las demás).

Quién puede

Acción	Permiso
Ver el listado, buscar, consultar DNI/RUC y ver las placas	Permisoclientes.ver
Registrar clientes (en el panel o con el alta rápida del POS)	Permisoclientes.crear
Editar clientes, agregar y quitar placas	Permisoclientes.editar
Dar de baja (eliminar) clientes	Permisoclientes.eliminar

Permisos que traen los roles base al crear la empresa (luego el administrador puede cambiarlos en Roles y permisos):

Rol	Ver	Crear	Editar	Eliminar
Administrador	Sí	Sí	Sí	Sí
Administrador de Estación	Sí	Sí	Sí	Sí
Créditos y Cobranzas	Sí	Sí	Sí	Sí
Jefe de Playa	Sí	Sí	Sí	No
Playero	Sí	Sí	No	No
Vendedor de Market	Sí	Sí	No	No
Solo lectura	Sí	No	No	No

:::info Solo ves los botones que puedes usar El botón Nuevo cliente aparece solo con Permisoclientes.crear, la acción Editar solo con Permisoclientes.editar y Eliminar solo con Permisoclientes.eliminar. Placas se ve siempre (salvo en CLIENTES VARIOS), pero agregar o quitar placas exige Permisoclientes.editar: sin él, la lista de placas es de solo lectura. :::

Conceptos

Tipos de documento

Cada cliente se identifica por su tipo y número de documento. No puede haber dos clientes activos con el mismo tipo y número en tu empresa.

Tipo (como aparece en la lista)	Formato del número	Datos obligatorios
DNI	Exactamente 8 dígitos	Nombres y apellido paterno
RUC	11 dígitos con dígito verificador válido	Razón social y dirección (fiscal)
Carné de extranjería (CE)	9 a 12 letras o números	Nombres
Pasaporte	6 a 15 letras o números	Nombres
PTP (Permiso Temporal de Permanencia)	6 a 15 letras o números	Nombres

El RUC se valida con su dígito verificador: un RUC mal digitado se rechaza con "RUC inválido (revisa el dígito verificador)."

Consulta automática a RENIEC y SUNAT

En el formulario, junto al número de documento, está la lupa (Consultar documento (RENIEC/SUNAT)):

• DNI → nombres, apellido paterno y apellido materno (RENIEC).
• RUC → razón social y dirección fiscal (SUNAT).

La consulta nunca bloquea el registro: si el servicio externo no responde o no encuentra el documento, verás un aviso y podrás escribir los datos a mano. Para Carné de extranjería, Pasaporte y PTP no hay consulta automática. Lo que se guarda es lo que está en el formulario al pulsar guardar.

Cliente genérico "CLIENTES VARIOS"

Cada empresa tiene un cliente especial llamado CLIENTES VARIOS (documento DNI 00000000). Es el que se usa para las boletas sin identificar al comprador, típicas de las ventas pequeñas en la isla.

• Aparece siempre primero en el listado, con la marca (Genérico).
• No se puede editar, dar de baja ni asignarle placas: su fila no muestra acciones.
• El documento DNI 00000000 está reservado: nadie más puede registrarse con él.
• No acumula puntos de fidelización.
• Si por alguna razón faltara, el sistema lo vuelve a crear automáticamente cuando el POS lo necesita.

Segmento

El segmento clasifica al cliente según su actividad y sirve para las reglas de precio por segmento (por ejemplo, un precio especial para mototaxis). Es opcional. Los valores posibles son:

Particular, Taxi, Mototaxi, Colectivo, Transporte de pasajeros, Transporte de carga, Flota de empresa, Agrícola / pesquero y Gobierno (o Sin segmento).

Las reglas de precio en sí se configuran en

Menú:Configuración›Precios/precios

(pestañas Reglas y Precios pactados). Ver Configuración.

Datos tributarios (solo clientes con RUC)

Cuando el tipo de documento es RUC aparecen cuatro interruptores que el sistema usa para el cálculo de percepciones y en las cobranzas:

Interruptor	Qué significa	Para qué lo usa el sistema
Agente de percepción	El cliente está designado por SUNAT como agente de percepción.	Un agente de percepción no está sujeto a que le cobres percepción.
Agente de retención	El cliente está designado por SUNAT como agente de retención.	Solo a un agente de retención se le puede registrar una retención al cobrarle una deuda (en Cobranzas).
Consumidor directo	Usa el combustible para su propio consumo (no lo revende).	Un consumidor directo no está sujeto a percepción.
Revende combustible	Compra combustible para revenderlo.	Es la condición para que, si tu empresa es agente de percepción, se le cobre percepción.

En resumen: a un cliente se le aplica percepción solo si revende combustible, no es agente de percepción y no es consumidor directo (y tu empresa es agente de percepción con designación vigente). Ver Comprobantes.

Solo un cliente con RUC puede ser agente de percepción o de retención; si cambias el tipo de documento a otro distinto de RUC, los cuatro interruptores se ocultan y se guardan apagados.

Activo y baja

• Activo = No: el cliente sigue en el catálogo y en sus comprobantes, pero no aparece en las búsquedas del POS (ni por placa ni por documento). Úsalo para "pausar" a un cliente sin darlo de baja.
• Eliminar es una baja lógica: el cliente desaparece del listado, pero sus ventas, comprobantes, deudas y puntos se conservan. No hay "restaurar": si lo vuelves a registrar con el mismo documento, será un registro nuevo.

Placas frecuentes

Cada cliente puede tener una lista de placas frecuentes: así el playero escribe ABC-123 en el POS y el sistema le muestra a quién pertenece, sin pedir el DNI o el RUC cada vez.

El sistema acepta las placas peruanas en dos formas y siempre las guarda en mayúsculas y con guion:

Tipo	Formato	Ejemplo	Cómo puedes escribirla
Auto, camioneta, camión	3 + 3 caracteres (letras o números)	ABC-123, B4F-912	abc123, ABC 123, ABC-123
Moto / mototaxi	4 dígitos + 2 caracteres	1234-AB	1234ab, 1234-AB

• Se aprenden solas: cada vez que se emite una venta a un cliente identificado con una placa (en el POS, al canjear una boleta por factura o al reemplazar un comprobante anulado), el sistema agrega la placa a la lista del cliente o actualiza su Último uso. Esto nunca bloquea la venta: si la placa no es válida o el cliente es CLIENTES VARIOS, simplemente no se guarda.
• Límite: hasta 50 placas por cliente.
• Una misma placa puede pertenecer a varios clientes (por ejemplo, un auto que factura a la empresa y a veces a su dueño); en el POS aparecerán todos.
• Las placas frecuentes son distintas de los vehículos de flota con crédito, que se gestionan en Créditos y flotas.

La pantalla de Clientes

Al entrar verás:

• El título Clientes y el botón Nuevo cliente.
• Un campo Filtrar por placa (ABC-123).
• La tabla de clientes con su buscador Buscar por documento o nombre.

Columna	Qué muestra
Documento	Tipo y número, por ejemplo DNI 45871236 o RUC 20512345671.
Nombre / Razón social	Para RUC, la razón social; para personas, nombres y apellidos. El genérico lleva (Genérico). Si filtras por placa, a la derecha se ve la placa que coincidió (· ABC-123).
Contacto	Celular y correo separados por un punto (987654321 · ventas@empresa.pe), o — si no tiene.

Cada fila (salvo la del genérico) tiene las acciones Editar, Placas y Eliminar, según tus permisos.

Debajo de la tabla verás Página X de Y · N registros y los botones Anterior y Siguiente. Se muestran 20 clientes por página, del más reciente al más antiguo (el genérico siempre arriba). Si aún no hay clientes verás "Aún no hay clientes. Crea el primero."

Buscar por documento o nombre

Escribe en el buscador de la tabla parte del número de documento, de los nombres, de los apellidos o de la razón social. La búsqueda se hace en el servidor y no distingue mayúsculas. Ejemplos: 4587, QUISPE, TRANSPORTES.

Filtrar por placa

Escribe la placa en Filtrar por placa (ABC-123). Puedes escribirla sin guion y en minúsculas: abc123 se convierte en ABC-123.

• Con la placa completa (6 caracteres, o 4 dígitos + 2 para motos como 1234-AB) busca la placa exacta.
• Con 3 a 5 caracteres busca las placas que empiezan así (ABC → ABC-123, ABC-456...).
• Con menos de 3 caracteres no muestra resultados.
• Solo muestra clientes activos, ordenados por el uso más reciente de la placa, hasta 20 resultados (sin paginar).
• Mientras haya algo escrito en el filtro de placa, el buscador por documento o nombre se ignora. Borra el filtro de placa para volver al listado normal.

Paso a paso

Registrar un cliente

1. Abre el formulario

   Pulsa Nuevo cliente. Se abre la ventana Nuevo cliente.

2. Elige el tipo de documento

   En Tipo de documento elige DNI, RUC, Carné de extranjería, Pasaporte o PTP. Si eliges RUC aparecen además los interruptores tributarios.

3. Escribe el número y consulta (DNI o RUC)

   Escribe el Número de documento y pulsa la lupa pegada al campo.

   • Con datos: verás "Datos del documento cargados." y se completan los nombres y apellidos (DNI) o la razón social y la dirección (RUC).
   • Sin datos: "No se encontraron datos del documento; captúralos a mano."
   • Si el servicio falla: "No se pudo consultar el documento."
   • Si el número está vacío: "Ingresa el número de documento."
4. Completa o revisa los datos

   Revisa lo que trajo la consulta y completa lo que falte: celular, correo, dirección, segmento, etc. Para RUC la Dirección es obligatoria (es la dirección fiscal que sale en la factura).

5. Marca los datos tributarios (solo RUC)

   Activa Agente de percepción, Agente de retención, Consumidor directo o Revende combustible según corresponda. Si no estás seguro, revisa la ficha RUC del cliente o consulta a tu contador.

6. Guarda

   Pulsa Crear cliente. Si todo está bien verás "Cliente creado.", la ventana se cierra y el cliente aparece en el listado. Si algún dato está mal, el error aparece debajo del campo y la ventana sigue abierta. Con Cerrar sales sin guardar.

:::tip Consejo La consulta a RENIEC/SUNAT ahorra errores de tipeo en nombres y razones sociales. Úsala siempre que el cliente tenga DNI o RUC, sobre todo antes de emitir una factura. :::

Editar un cliente

1. Busca al cliente

   Usa el buscador Buscar por documento o nombre o el filtro por placa.

2. Pulsa «Editar»

   En la fila del cliente pulsa Editar. Se abre la ventana Editar cliente con sus datos cargados.

3. Cambia lo necesario

   Puedes cambiar cualquier dato, incluso el tipo y el número de documento (siempre que no choque con otro cliente activo). También puedes volver a usar la lupa para refrescar los datos desde RENIEC/SUNAT.

4. Guarda

   Pulsa Guardar cambios. Verás "Cliente actualizado."

Para dejar a un cliente sin segmento elige Sin segmento y guarda. Para "pausarlo" sin borrarlo, cambia Activo a No.

Dar de baja un cliente

1. Pulsa «Eliminar»

   En la fila del cliente pulsa Eliminar. Se abre la ventana Confirmar baja con el mensaje "Se dará de baja al cliente "...". Podrás volver a registrarlo más tarde. ¿Continuar?" (para RUC muestra la razón social; para personas, el número de documento).

2. Confirma

   Pulsa Dar de baja (o Cancelar). Esta ventana no se cierra tocando fuera de ella: tienes que elegir una opción. Al confirmar verás "Cliente dado de baja."

:::warning Atención La baja saca al cliente del listado y de las búsquedas, pero no borra sus ventas, comprobantes, deudas ni puntos. Si lo vuelves a registrar con el mismo documento, será un registro nuevo. :::

Ver, agregar y quitar placas

1. Abre la ventana de placas

   En la fila del cliente pulsa Placas. Se abre Placas del cliente.

2. Revisa la lista

   La tabla muestra Placa y Último uso (fecha y hora de la última venta con esa placa, o Sin uso si se registró a mano y aún no se usó). Las de uso más reciente aparecen primero. Si no tiene ninguna verás "El cliente aún no tiene placas registradas."

3. Agrega una placa

   En Nueva placa (ayuda: ABC-123 o 1234-AB (moto).) escribe la placa y pulsa Agregar placa. Verás "Placa agregada.", el campo se limpia y la placa aparece en la lista.

4. Quita una placa (si hace falta)

   En la fila de la placa pulsa Quitar. Se elimina de inmediato (sin confirmación) y verás "Placa ABC-123 quitada." Si el cliente vuelve a facturar con esa placa, el sistema la aprenderá de nuevo.

5. Cierra

   Pulsa Cerrar. El listado de clientes se actualiza solo.

Sin Permisoclientes.editar la ventana solo muestra la lista: no aparecen Nueva placa, Agregar placa ni Quitar.

Campos

Formulario de cliente

Campo	¿Obligatorio?	Descripción
Tipo de documentoLista	Sí	DNI, RUC, Carné de extranjería, Pasaporte o PTP. Define qué otros datos son obligatorios y si se muestran los interruptores tributarios.
Número de documentoTexto	Sí	DNI: 8 dígitos. RUC: 11 dígitos con dígito verificador válido. Carné de extranjería: 9 a 12 letras o números. Pasaporte y PTP: 6 a 15 letras o números. Junto al campo está la lupa para consultar RENIEC/SUNAT (solo DNI y RUC).
NombresTexto	No	Obligatorio para DNI, Carné de extranjería, Pasaporte y PTP. Hasta 100 caracteres.
Apellido paternoTexto	No	Obligatorio para DNI. Hasta 60 caracteres.
Apellido maternoTexto	No	Opcional. Hasta 60 caracteres.
Razón socialTexto	No	Obligatoria para RUC. Hasta 150 caracteres. Es el nombre que sale en la factura.
CelularTexto	No	Opcional. Celular peruano de 9 dígitos que empieza en 9 (por ejemplo 987654321). Sirve para identificar al cliente en Fidelización y para avisarle por WhatsApp que sus puntos van a vencer.
CorreoTexto	No	Opcional. Correo válido, hasta 120 caracteres.
Fecha de nacimientoFecha	No	Opcional.
SexoLista	No	Opcional: —, Masculino o Femenino.
NacionalidadTexto	No	Opcional. Hasta 60 caracteres.
DirecciónTexto	No	Obligatoria para RUC: es la dirección fiscal que va en la factura. Hasta 200 caracteres.
SegmentoLista	No	Opcional: Sin segmento, Particular, Taxi, Mototaxi, Colectivo, Transporte de pasajeros, Transporte de carga, Flota de empresa, Agrícola / pesquero o Gobierno.
ActivoLista	No	Sí (por defecto) o No. Con No, el cliente no aparece en las búsquedas del POS.
Agente de percepciónInterruptor	No	Solo visible con RUC. Por defecto apagado.
Agente de retenciónInterruptor	No	Solo visible con RUC. Por defecto apagado. Permite registrar retenciones al cobrarle deudas.
Consumidor directoInterruptor	No	Solo visible con RUC. Por defecto apagado.
Revende combustibleInterruptor	No	Solo visible con RUC. Por defecto apagado. Junto con los anteriores decide si se le cobra percepción.

Los campos opcionales que dejes vacíos no se guardan.

Ventana de placas

Campo	¿Obligatorio?	Descripción
Nueva placaTexto	Sí	Placa en formato ABC-123 o 1234-AB. Puedes escribirla sin guion o en minúsculas; se guarda normalizada.

Estados y reglas

• Activo: Sí — aparece en el panel y en las búsquedas del POS.
• Activo: No — aparece en el panel, pero no en las búsquedas del POS.
• Dado de baja — ya no aparece en el listado; su historial se conserva y su documento queda libre para un nuevo registro.

Reglas principales:

• Un solo cliente activo (no dado de baja) por tipo + número de documento en la empresa.
• El DNI 00000000 está reservado para CLIENTES VARIOS.
• CLIENTES VARIOS no se edita, no se da de baja y no tiene placas.
• Agente de percepción / retención solo con RUC.
• RUC exige razón social y dirección fiscal; DNI exige nombres y apellido paterno.
• Hasta 50 placas por cliente; una placa no se repite dentro del mismo cliente.

Mensajes de error frecuentes y qué hacer

Mensaje	Por qué pasa	Qué hacer
"Ingresa el número de documento."	Pulsaste la lupa sin escribir el número.	Escribe el número y vuelve a pulsar la lupa.
"No se encontraron datos del documento; captúralos a mano."	RENIEC/SUNAT no devolvió datos.	Escribe los datos manualmente; el registro no se bloquea.
"No se pudo consultar el documento."	Falló la comunicación con el servidor.	Reintenta o escribe los datos a mano.
"Ya existe un cliente con ese documento."	Hay otro cliente activo con el mismo tipo y número.	Búscalo en el listado y edítalo en lugar de crear otro.
"El DNI debe tener exactamente 8 dígitos."	El DNI tiene más o menos de 8 números o lleva letras.	Corrige el número.
"RUC inválido (revisa el dígito verificador)."	El RUC no tiene 11 dígitos o el último dígito no cuadra.	Revisa el RUC en la ficha RUC del cliente.
"El CE debe tener 9-12 caracteres alfanuméricos."	Carné de extranjería con formato incorrecto.	Revisa el número del carné.
"Documento de 6-15 caracteres alfanuméricos."	Pasaporte o PTP con formato incorrecto.	Revisa el documento.
"Los nombres son obligatorios para DNI." / "Los nombres son obligatorios."	Falta el nombre de la persona.	Pulsa la lupa (DNI) o escríbelo.
"El apellido paterno es obligatorio para DNI."	Falta el apellido paterno.	Complétalo.
"La razón social es obligatoria para RUC." / "La dirección fiscal es obligatoria para RUC."	Faltan datos que la factura necesita.	Pulsa la lupa para traerlos de SUNAT o escríbelos.
"Ese documento está reservado para el cliente genérico."	Intentaste registrar el DNI 00000000.	Usa CLIENTES VARIOS para ventas sin identificar.
"El cliente genérico no puede modificarse."	Intentaste cambiar CLIENTES VARIOS o agregarle una placa.	No es posible; registra un cliente real.
"Solo un cliente con RUC puede ser agente de percepción o retención."	Interruptores tributarios en un cliente sin RUC.	Cambia el tipo a RUC o apaga los interruptores.
"Segmento no válido."	Segmento fuera de la lista.	Elige uno de la lista.
"Celular inválido: 9 dígitos y empieza con 9."	El celular no es un número móvil peruano.	Escribe los 9 dígitos, por ejemplo 987654321.
"Correo electrónico inválido." / "El correo admite hasta 120 caracteres."	Correo mal escrito o muy largo.	Corrígelo.
"No se pudo dar de baja al cliente."	Error al dar de baja (conexión o permiso).	Reintenta; si persiste, revisa tu permiso de eliminar clientes.
"La placa debe tener el formato ABC-123 o 1234-AB."	La placa no tiene 6 caracteres válidos ni el formato de moto.	Revisa la placa.
"El cliente ya tiene registrada esa placa."	La placa ya está en la lista de ese cliente.	No hace falta agregarla de nuevo.
"El cliente ya tiene 50 placas registradas."	Llegó al límite de placas.	Quita placas que ya no use.
"Placa no encontrada."	La placa ya fue quitada (por ejemplo, desde otra computadora).	Cierra y vuelve a abrir la ventana de placas.
"No se pudo quitar la placa." / "No se pudo agregar la placa."	Error de conexión o de permiso.	Reintenta; revisa que tengas el permiso de editar clientes.
"No tienes permiso para esta acción."	Tu rol no tiene el permiso de esa acción.	Pide a tu administrador el permiso correspondiente.

Relación con otros módulos

• POS de isla: busca, elige o registra al cliente durante la venta → Clientes en el POS y POS de isla.
• Facturación: los datos del cliente salen en la boleta o factura; un cliente con RUC hace que el POS proponga factura → Pantalla de comprobantes.
• Precios: reglas por segmento y precios pactados por cliente → Configuración.
• Créditos y flotas: líneas de crédito, vehículos y choferes de un cliente → Créditos y flotas.
• Cobranzas y anticipos: deudas, pagos, retenciones y anticipos del cliente → Cobranzas y anticipos.
• Fidelización: los puntos se acumulan a nombre del cliente; se le identifica por DNI, celular o placa → Fidelización.

Ejemplo

La empresa Transportes Huallaga S.A.C. (RUC 20512345671) carga petróleo para sus camiones B4F-912 y C7K-305:

1. En Configuración › Clientes pulsas Nuevo cliente, eliges RUC, escribes el número y pulsas la lupa: se completan la razón social y la dirección fiscal.
2. Eliges el segmento Transporte de carga y, como compra para sus camiones, marcas Consumidor directo.
3. Guardas con Crear cliente y luego, en Placas, agregas B4F-912 y C7K-305.
4. En la isla, el playero escribe B4F912, elige a Transportes Huallaga y el POS propone factura. Si despacha 35.000 gal de Diésel B5 a S/ 16.49 por galón, la factura sale por S/ 577.15 a nombre de la empresa.

Otro caso: registras a María Quispe Huamán, DNI 45871236, taxista. Nuevo cliente → DNI → 45871236 → lupa (se cargan "MARIA", "QUISPE", "HUAMAN") → celular 987654321, segmento Taxi → Crear cliente. Si luego carga 4.500 gal de Gasohol 90 a S/ 15.20 por galón, su boleta sale por S/ 68.40 a su nombre y, si el programa de puntos está activo, acumula puntos con su DNI.