Campos del Cliente
Referencia completa de los campos de cliente
Documentación de todos los campos disponibles en el registro de cliente.
| Campo | Tipo | Requerido | Descripción |
|---|
| Nombre | Texto | ✅ Sí | Nombre completo (individual) o razón social (empresa) |
| Código | Texto | Auto | Código interno único. Se genera automáticamente si no se ingresa. |
| NIT | Texto | No | Número de Identificación Tributaria. Formato: XXXXXXXX-X |
| Tipo | Selector | ✅ Sí | individual (persona natural) o business (empresa) |
| Estado | Selector | ✅ Sí | active, inactive, suspended, vip |
| Campo | Tipo | Requerido | Descripción |
|---|
| Teléfono | Texto | No | Número principal de contacto |
| Email | Email | No | Correo electrónico. Se usa para facturas digitales. |
| Teléfono secundario | Texto | No | Número alternativo |
| Campo | Tipo | Requerido | Descripción |
|---|
| Contacto | Texto | No | Nombre de la persona de contacto |
| Cargo del contacto | Texto | No | Puesto del contacto |
| Giro del negocio | Texto | No | A qué se dedica la empresa |
| Campo | Tipo | Requerido | Descripción |
|---|
| Fecha de nacimiento | Fecha | No | Para promociones de cumpleaños |
| Género | Selector | No | Masculino / Femenino / Otro |
Los clientes pueden tener múltiples direcciones:
| Campo | Tipo | Requerido | Descripción |
|---|
| Tipo | Selector | ✅ Sí | billing, shipping, both, other |
| Dirección | Texto | ✅ Sí | Calle, número, edificio |
| Zona | Texto | No | Zona o barrio |
| Ciudad | Texto | No | Ciudad |
| Departamento | Texto | No | Departamento o estado |
| País | Selector | No | País (default: Guatemala) |
| Código Postal | Texto | No | Código postal |
| Predeterminada | Boolean | No | Usar como default para este tipo |
| Notas | Texto | No | Instrucciones de entrega |
| Tipo | Código | Uso |
|---|
| Facturación | billing | Dirección fiscal para facturas |
| Envío | shipping | Dirección de entrega |
| Ambas | both | Misma dirección para todo |
| Otra | other | Dirección adicional |
| Campo | Tipo | Descripción |
|---|
| Crédito disponible | Moneda | Saldo a favor del cliente |
| Límite de crédito | Moneda | Máximo de crédito permitido |
| Días de crédito | Número | Plazo de pago |
| Saldo pendiente | Moneda | Lo que debe el cliente |
| Campo | Tipo | Descripción |
|---|
| Lista de precios | Referencia | Lista de precios asignada |
| Descuento automático | Porcentaje | Descuento que se aplica en sus compras |
| Método de pago preferido | Selector | Cómo suele pagar |
| Vendedor asignado | Referencia | Empleado responsable |
| Campo | Tipo | Descripción |
|---|
| Notas | Texto largo | Comentarios internos |
| Etiquetas | Multi-selector | Para segmentación (VIP, Mayorista, etc.) |
| Campo | Descripción |
|---|
| ID | Identificador único |
| Organización | A qué organización pertenece |
| Creado | Fecha de registro |
| Actualizado | Última modificación |
| Creado por | Usuario que lo registró |
| Campo | Descripción |
|---|
| Total compras | Monto histórico |
| Cantidad de compras | Número de transacciones |
| Ticket promedio | Promedio por compra |
| Última compra | Fecha de última transacción |
| Primera compra | Fecha de registro como cliente |
| Estado | Código | Descripción |
|---|
| Activo | active | Puede comprar normalmente |
| Inactivo | inactive | No aparece en búsquedas |
| Suspendido | suspended | Bloqueado (por deuda, etc.) |
| VIP | vip | Cliente preferencial |
| Entidad | Relación | Descripción |
|---|
| Ventas | Uno a muchos | Historial de compras |
| Pagos | Uno a muchos | Pagos realizados |
| Direcciones | Uno a muchos | Direcciones registradas |
| Créditos | Uno a muchos | Movimientos de crédito |
| Ubicación | Referencia | Ubicación donde se registró |