Contactos de cliente
Persona asociada a una organización cliente o a una sucursal de cliente.
- Nombre API:
customercontacts - Dominio: Terceros
- Módulos: Ventas, Tiendas, Servicios, Finanzas, Logística, Directorio
Campos
El nombre API es el que usan la API, MCP y la CLI.
| Nombre | Nombre API | Tipo | Obligatorio | Descripción |
|---|---|---|---|---|
| ID | id | ID de registro | Sí | |
| Cliente | customerId | Referencia | Sí | |
| Nombre | firstName | Texto | Sí | |
| Segundo nombre | middleName | Texto | ||
| Apellido paterno | paternalLastName | Texto | Sí | |
| Apellido materno | maternalLastName | Texto | ||
| Nombre completo | fullName | Texto | Sí | |
| Puesto | title | Texto | ||
| Sucursal | customerbranchId | Referencia | ||
| Principal | isPrimary | Binario | Sí | Si está activo, esta fila es el vínculo principal entre pares del mismo tipo. |
| Rol | role | Constante | Función del contacto para esta cuenta. Déjelo vacío si aún no lo conoce, o elija General. | |
| Correos electrónicos | emails | Correo electrónico | Correos electrónicos | ||
| Teléfonos | phones | Teléfono | Teléfonos | ||
| Enlaces | links | Enlace | Enlaces | ||
| Imagen | image | Imagen | ||
| Tags | tagIds | Tags | ||
| Descripción | description | Campo de Texto | ||
| Datos | data | Datos | ||
| Identificadores externos | identifiers | Identificador externo | Identificadores externos | Claves de sistemas remotos y tipos de id opcionales. Un valor por par de sistema y tipo en este registro. | |
| Creado por | createdBy | Usuario | ||
| Creado el | createdAt | Fecha y Hora | Sí | |
| Actualizado por | updatedBy | Usuario | ||
| Actualizado el | updatedAt | Fecha y Hora | Sí | |
| Bloqueado por | blockedBy | Usuario | ||
| Bloqueado el | blockedAt | Fecha y Hora | ||
| Archivado por | archivedBy | Usuario | ||
| Archivado el | archivedAt | Fecha y Hora |
Relaciones
Los registros poseídos (línea sólida) se eliminan con su dueño. Los registros agrupados (línea punteada) pueden existir solos.
| Campo | Apunta a | Tipo |
|---|---|---|
Cliente customerId | Clientes | agrupado por |
Sucursal customerbranchId | Sucursales de cliente | referencia |
Tags tagIds | Tags | referencia |
Acciones
Lo que puedes hacer con un registro. Cada acción también envía el evento de webhook customercontacts.<acción>. Las lecturas (find, get, count) funcionan en toda tabla.
| Nombre | Nombre API | Descripción | Dónde |
|---|---|---|---|
| Crear | create | Crea un contacto. | App · WebMCP · API · MCP · CLI |
| Editar | update | Guarda los cambios del contacto. | App · WebMCP · API · MCP · CLI |
| Bloquear | block | Impide editar y eliminar el contacto. Sigue visible y puede seguir en documentos existentes. Desbloquéalo para volver a cambiarlo. | App · API · CLI |
| Desbloquear | unblock | Permite de nuevo editar y eliminar el contacto. | App · API · CLI |
| Archivar | archive | Retira el contacto del uso diario. Sale de las listas y los selectores activos, y la mayoría de las acciones se detienen. Desarchívalo para restaurarlo. | App · WebMCP · API · MCP · CLI |
| Restaurar | unarchive | Devuelve el contacto a las listas y las acciones activas. | App · WebMCP · API · MCP · CLI |
| Eliminar | delete | Elimina el contacto y los datos que le pertenecen. No se puede deshacer. | App · WebMCP · API · MCP · CLI |