Clientes (Personas)
Los clientes son representados por el modelo Persona (Person) con diferentes tipos según el contexto.
Tipos de Persona
| Tipo | Descripción |
|---|---|
organization | Tenant/organización que usa la plataforma |
customer | Cliente de una organización |
contact | Contacto secundario |
Campos del Cliente
| Campo | Descripción |
|---|---|
| Nombre | Nombre o razón social |
| Apodo | Nombre comercial |
| Nombre legal | Razón social completa |
| Tipo de documento | CPF o CNPJ |
| Número del documento | Normalizado (solo dígitos) |
| Naturaleza | natural (persona física) o juridical (persona jurídica) |
| Fecha de nacimiento | Opcional |
| Direcciones | Lista de direcciones (JSON) |
| Teléfonos | Lista de teléfonos (JSON) |
| E-mails | Lista de e-mails (JSON) |
| Sitios web | Lista de websites (JSON) |
| Tags | Lista de tags para categorización |
| Notas | Observaciones internas |
| Datos personalizados | Campos customizados (JSON) |
Jerarquía
Los clientes pertenecen a una organización vía el campo parentId:
Organización (type=organization, parentId=null)
├── Cliente A (type=customer, parentId=org_id)
├── Cliente B (type=customer, parentId=org_id)
└── Contacto (type=contact, parentId=org_id)
Validaciones
- Número de documento único dentro de la organización
- Código externo (
externalCode) único por organización - Restricciones en el formato del documento: CPF (11 dígitos) o CNPJ (14 dígitos)