Clientes

Lista de clientes

Accede a Ventas → Clientes para ver el listado completo de clientes registrados.

Buscar clientes

Utiliza la barra de búsqueda en la parte superior para filtrar por:

• Nombre o razón social
• RIF / NIF / Cédula
• Código interno

La búsqueda es instantánea y filtra mientras escribes.

Crear un cliente

1. Haz clic en el botón + Nuevo (esquina superior derecha)
2. Completa el formulario con los datos del cliente
3. Haz clic en Guardar

Campos del formulario

Pestaña General

Campo	Obligatorio	Descripción
Nombre	Sí	Nombre o razón social del cliente
Tipo documento	Sí	V, E, J, G, P (Venezuela) o NIF, CIF (España)
Número documento	Sí	RIF, cédula o NIF sin guiones
Teléfono	No	Número de contacto principal
Email	No	Correo electrónico
Dirección	No	Dirección fiscal completa
Zona	No	Zona geográfica asignada
Vendedor	No	Vendedor responsable de la cuenta

Pestaña Fiscal

Campo	Descripción
Contribuyente especial	Marca si el cliente es agente de retención
Porcentaje retención IVA	Porcentaje de retención de IVA aplicable
Porcentaje retención ISLR	Porcentaje de retención de ISLR aplicable
Exento de impuesto	Marca si el cliente está exento de IVA

Pestaña Contacto

Campo	Descripción
Persona de contacto	Nombre del contacto principal
Teléfono contacto	Teléfono directo del contacto
Email contacto	Email del contacto
Notas	Observaciones internas

Editar un cliente

1. En la lista de clientes, haz clic en la fila del cliente
2. Se abrirá el formulario de edición con los datos actuales
3. Modifica los campos necesarios
4. Haz clic en Guardar

Condiciones de pago

Asigna condiciones de pago al cliente desde la pestaña general:

Condición	Descripción
Contado	Pago inmediato al facturar
Crédito 15 días	Pago a 15 días de la fecha de factura
Crédito 30 días	Pago a 30 días de la fecha de factura
Crédito 60 días	Pago a 60 días de la fecha de factura

La condición de pago asignada se aplicará automáticamente al crear facturas para ese cliente.

Estado del cliente

Cada cliente puede estar en uno de estos estados:

• Activo — Disponible para facturación
• Inactivo — No aparece en selectores de documentos

Para desactivar un cliente, edítalo y cambia su estado a Inactivo.

Flujo del usuario

Vista no técnica del proceso. Pensada para personal de operación, contabilidad, ventas o administración.

Editable en draw.io: descarga el SVG → en draw.io: File → Import from → Device → selecciona el SVG. Cada nodo queda editable.

Flujo técnico

Vista técnica para desarrolladores: endpoints, stored procedures/funciones, tablas y servicios involucrados.

Componente	Tipo	Ubicación
/v1/sales/customers	Route Express	web/api/src/routes/sales/customers.ts
usp_sls_Customer_List	Stored procedure (SQL Server + función PG)	web/api/sqlweb*/includes/sp/
usp_sls_Customer_Insert	Stored procedure (SQL Server + función PG)	web/api/sqlweb*/includes/sp/
usp_sls_Customer_Update	Stored procedure (SQL Server + función PG)	web/api/sqlweb*/includes/sp/
usp_sls_Customer_GetById	Stored procedure (SQL Server + función PG)	web/api/sqlweb*/includes/sp/
sls.Customer	Tabla operativa	web/api/migrations/postgres/
sls.CustomerFiscal	Tabla de datos fiscales	web/api/migrations/postgres/
sls.CustomerContact	Tabla de contactos	web/api/migrations/postgres/
CustomerListPage.tsx	Componente Frontend	web/modular-frontend/packages/module-ventas/src/

Editable en draw.io: descarga el SVG → File → Import from → Device.