Negocios de venta
Oportunidad de venta con un cliente, que avanza por las etapas de un embudo de ventas con su valor, probabilidad y antigüedad en la etapa.
- Nombre API:
salesdeals - 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í | |
| Nombre | label | Texto | ||
| Folio | uid | Texto | El folio es un identificador único y legible para el registro. | |
| Día | date | Fecha | Fecha calendario de este valor. | |
| Consulta | salesinquiryId | Referencia | ||
| Cliente | customerId | Referencia | Sí | |
| Sucursal | customerbranchId | Referencia | ||
| Contacto principal | customercontactId | Referencia | ||
| Vendedor | userId | Usuario | ||
| Embudo | salespipelineId | Referencia | Sí | |
| Etapa | salespipelinestageId | Referencia | Sí | |
| Campaña | salescampaignId | Referencia | ||
| Cierre esperado | dateExpectedClose | Fecha | Fecha de calendario en que se espera cerrar el negocio. | |
| Cadencia | cadence | Constante | Recurrencia comercial del negocio (única vez o ingresos o servicios recurrentes). | |
| Prioridad | priority | Constante | Sí | Número entero sin parte fraccionaria. |
| Importe | amount | Moneda | Valor económico o ingresos estimados del negocio. | |
| Moneda de cotización | currency | Constante | Sí | Valor del catálogo de la tabla para este campo. |
| Probabilidad de cierre (%) | probability | Porcentaje | Sí | Estimación de éxito heredada de la etapa (0 a 1). Se puede ajustar manualmente. |
| Motivo de cancelación | cancelReason | Opción (Selección) | Por qué se canceló el negocio. Obligatorio cuando el estado es cancelado; referencia una opción definida por la organización. | |
| Tags | tagIds | Tags | ||
| Descripción | description | Campo de Texto | ||
| Datos | data | Datos | ||
| Creado por | createdBy | Usuario | ||
| Creado el | createdAt | Fecha y Hora | Sí | |
| Actualizado por | updatedBy | Usuario | ||
| Actualizado el | updatedAt | Fecha y Hora | Sí | |
| Cerrado por | closedBy | Usuario | ||
| Cerrado el | closedAt | Fecha y Hora | ||
| 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 |
|---|---|---|
Consulta salesinquiryId | Consultas de ventas | referencia |
Cliente customerId | Clientes | referencia |
Sucursal customerbranchId | Sucursales de cliente | referencia |
Contacto principal customercontactId | Contactos de cliente | referencia |
Vendedor userId | Usuarios | referencia |
Embudo salespipelineId | Embudos de ventas | referencia |
Etapa salespipelinestageId | Etapas de embudo de ventas | 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 salesdeals.<acción>. Las lecturas (find, get, count) funcionan en toda tabla.
| Nombre | Nombre API | Descripción | Dónde |
|---|---|---|---|
| Crear | create | Crea un negocio. | App · API · MCP · CLI |
| Editar | update | Guarda los cambios del negocio. | App · API · MCP · CLI |
| Crear cotización | createQuote | Crea una cotización a partir de este negocio. | App · API · MCP · CLI |
| Bloquear | block | Impide editar y eliminar el negocio. Sigue visible y puede seguir en documentos existentes. Desbloquéalo para volver a cambiarlo. | App · API · MCP · CLI |
| Desbloquear | unblock | Permite de nuevo editar y eliminar el negocio. | App · API · MCP · CLI |
| Archivar | archive | Retira el negocio 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 · API · MCP · CLI |
| Restaurar | unarchive | Devuelve el negocio a las listas y las acciones activas. | App · API · MCP · CLI |
| Eliminar | delete | Elimina el negocio 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.
Eventos
Momentos a los que el registro llega por sí solo. Suscríbete a ellos con un webhook.
| Nombre | Evento de webhook | Descripción |
|---|---|---|
| Etapa vencida | salesdeals.stageOverdue | El negocio permaneció en su etapa más tiempo del permitido. |