Consultas de ventas
Una consulta comercial no calificada que llega por web, portal, correo electrónico u otro canal antes de convertirse en oportunidad calificada.
- Nombre API:
salesinquiries - Dominio: Ventas
- Módulos: Análisis de ventas, Ventas
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í | |
| Asunto | label | Texto | ||
| Folio | uid | Texto | El folio es un identificador único y legible para el registro. | |
| Nombre | name | Texto | Persona que envió la consulta. Obligatorio cuando el tipo es cuenta nueva. | |
| Cliente | customerId | Referencia | Cliente específico de la consulta. Los clientes genéricos no son válidos. | |
| Sucursal | customerbranchId | Referencia | Sucursal del cliente cuando la consulta ya está ligada a una cuenta. Se copia al negocio al aprobar cuando está definida. | |
| Contacto | customercontactId | Referencia | Contacto del cliente cuando la consulta ya está ligada a una cuenta. | |
| Campaña | salescampaignId | Referencia | Atribución opcional de campaña de marketing. Se copia al nuevo negocio al aprobar cuando está definida. | |
| Categoría | class | Constante | Sí | Cuenta nueva usa nombre y empresa en texto libre. Cliente existente enlaza un cliente específico y, opcionalmente, contacto y sucursal. |
| Empresa | company | Texto | Nombre de la empresa o cuenta. Obligatorio cuando el tipo es cuenta nueva. Se usa como etiqueta del negocio al aprobar cuando está presente. | |
| Origen | source | Opción (Selección) | Sí | Canal de captura de esta consulta (sitio web, portal, correo electrónico, API, referido u otro). |
| Correo electrónico | email | Correo electrónico | ||
| Teléfono | phone | Teléfono | ||
| Enlaces | links | Enlace | Enlaces | ||
| Tags | tagIds | Tags | ||
| Descripción | description | Campo de Texto | Cuerpo en texto libre de la solicitud entrante. Se copia a la descripción del nuevo negocio al aprobar cuando está presente. | |
| Datos | data | Datos | Extensión de la organización para esta consulta. No se copia al negocio. | |
| Identificadores externos | identifiers | Identificador externo | Identificadores externos | Referencias externas de esta consulta (id del lead, referencia del canal). No se copian al negocio. | |
| Creado por | createdBy | Usuario | ||
| Creado el | createdAt | Fecha y Hora | Sí | |
| Actualizado por | updatedBy | Usuario | ||
| Actualizado el | updatedAt | Fecha y Hora | Sí | |
| Finalizado por | endedBy | Usuario | ||
| Finalizado el | endedAt | Fecha y Hora | ||
| Aprobado por | approvedBy | Usuario | ||
| Aprobado el | approvedAt | Fecha y Hora | ||
| Rechazado por | rejectedBy | Usuario | ||
| Rechazado el | rejectedAt | Fecha y Hora | ||
| Bloqueado por | blockedBy | Usuario | ||
| Bloqueado el | blockedAt | Fecha y Hora | ||
| Archivado por | archivedBy | Usuario | ||
| Archivado el | archivedAt | Fecha y Hora |
Relaciones
| Campo | Apunta a | Tipo |
|---|---|---|
Cliente customerId | Clientes | referencia |
Sucursal customerbranchId | Sucursales de cliente | referencia |
Contacto customercontactId | Contactos de cliente | referencia |
Campaña salescampaignId | Campañas de ventas | referencia |
Tags tagIds | Tags | referencia |
Acciones
Lo que puedes hacer con un registro. Cada acción también envía el evento de webhook salesinquiries.<acción>. Las lecturas (find, get, count) funcionan en toda tabla.
| Nombre | Nombre API | Descripción | Dónde |
|---|---|---|---|
| Crear | create | Crea una consulta. | App · API · MCP · CLI |
| Editar | update | Guarda los cambios de la consulta. | App · API · MCP · CLI |
| Aprobar | approve | Aprueba el documento para que el siguiente paso pueda continuar. | App · API · MCP · CLI |
| Rechazar | reject | Rechaza el documento. | App · API · MCP · CLI |
| Convertir en cliente | end | Crea un cliente a partir de la consulta aprobada cuando el tipo es cuenta nueva y aún no hay cliente vinculado. | App · API · MCP · CLI |
| Bloquear | block | Impide editar y eliminar la consulta. Sigue visible y puede seguir en documentos existentes. Desbloquéala para volver a cambiarla. | App · API · MCP · CLI |
| Desbloquear | unblock | Permite de nuevo editar y eliminar la consulta. | App · API · MCP · CLI |
| Archivar | archive | Retira la consulta del uso diario. Sale de las listas y los selectores activos, y la mayoría de las acciones se detienen. Desarchívala para restaurarla. | App · API · MCP · CLI |
| Restaurar | unarchive | Devuelve la consulta a las listas y las acciones activas. | App · API · MCP · CLI |
| Eliminar | delete | Elimina la consulta y los datos que le pertenecen. No se puede deshacer. | App · API · MCP · CLI |
Estados
Cómo pasa un registro de un estado a otro. Archivar y bloquear pueden ocurrir en cualquier estado.