Cotizaciones de venta
Oferta comercial con los productos, precios y condiciones que se proponen a un cliente.
- Nombre API:
salesquotes - Dominio: Ventas
- Módulos: Análisis de ventas, Ventas, Tiendas
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. | |
| Fecha | date | Fecha | Sí | Fecha de precios. Se usa para resolver listas de precios vigentes. |
| Proyecto | projectId | Referencia | ||
| Cotización original | salesquoteIdRoot | Referencia | ||
| Cotización anterior | salesquoteIdPrevious | Referencia | ||
| Negocio | salesdealId | Referencia | ||
| Acuerdo marco | salesagreementId | Referencia | ||
| Cliente | customerId | Referencia | Sí | |
| Sucursal | customerbranchId | Referencia | ||
| Contacto | customercontactId | Referencia | ||
| Vendedor | userId | Usuario | ||
| Dirección de entrega | addressDelivery | Dirección | ||
| Revisión de producto | productrevisionId | Referencia | ||
| Moneda de cotización | currency | Constante | Sí | Valor del catálogo de la tabla para este campo. |
| Revisión | revision | Número Entero | Sí | Número entero sin parte fraccionaria. |
| Referencia del cliente | customerReference | Texto | La referencia propia del cliente para este documento, como su número de orden de compra. | |
| Tasa de concesión | concessionRate | Porcentaje | Sí | Proporción del importe de lista concedida en descuentos de partida y encabezado (0–1). |
| Piso de precio incumplido | isFloorBreached | Binario | Sí | Se fija al aprobar. Verdadero si algún precio unitario está bajo el piso de la lista de precios. |
| Sitio de cumplimiento | siteIdFulfillment | Referencia | ||
| Entrega | delivery | Constante | Método y condiciones de entrega de la mercancía. | |
| Incoterm | incoterm | Constante | Opción fija del conjunto permitido para este campo. | |
| Lugar Incoterm | incotermPlace | Texto | ||
| Fecha solicitada | dateRequested | Fecha | Fecha de calendario sin hora. | |
| Vigencia | dateTo | Fecha | Última fecha en que aplica este registro, si aplica. | |
| Condición de pago | financespaymenttermId | Referencia | ||
| Condiciones de venta | salestermsconditionId | Referencia | ||
| Base del precio | priceBasis | Constante | Sí | Si el precio unitario incluye el impuesto (bruto) o lo excluye (neto). |
| Importe de lista | amountList | Moneda | Sí | Suma de extensiones de partida a precio de lista antes de descuentos. |
| Descuento de partida | amountLineDiscount | Moneda | Sí | Suma de descuentos de partida antes de aplicar el descuento del encabezado. |
| Descuento del encabezado | amountHeaderDiscount | Moneda | Sí | Importe total del descuento de encabezado repartido en partidas. |
| Importe neto | amountNet | Moneda | Sí | Totales de partida después de descuentos de partida y antes del descuento de encabezado. |
| Subtotal | subtotal | Moneda | Sí | Suma de importes de partida antes de impuestos y retenciones en este documento. |
| Impuesto | tax | Moneda | Sí | Importe de impuesto para este ámbito, en moneda del documento, según el motor fiscal configurado. |
| Retención | withholding | Moneda | Sí | Importe de retención fiscal retenido en este ámbito, en moneda del documento. |
| Total | total | Moneda | Sí | Total del documento tras descuentos, impuestos y retenciones en moneda del documento. |
| Motivo de declinación | declineReason | Constante | Valor del catálogo de la tabla para este campo. | |
| Nota de declinación | declineNote | Campo de Texto | ||
| Motivo de cierre | forceCloseReason | Constante | Explicación obligatoria al cerrar con documentos abiertos. | |
| Tags | tagIds | Tags | ||
| Comentarios | comments | Campo de Texto | Se imprime en el documento. Use este campo para la cláusula de tipo de cambio DOF u otras condiciones comerciales. | |
| 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í | |
| Enviado por | sentBy | Usuario | ||
| Enviado el | sentAt | Fecha y Hora | ||
| Confirmado por | confirmedBy | Usuario | ||
| Confirmado el | confirmedAt | Fecha y Hora | ||
| Rechazado por | rejectedBy | Usuario | ||
| Rechazado el | rejectedAt | Fecha y Hora | ||
| 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 |
|---|---|---|
Proyecto projectId | Proyectos | referencia |
Cotización original salesquoteIdRoot | Cotizaciones de venta | referencia |
Cotización anterior salesquoteIdPrevious | Cotizaciones de venta | referencia |
Negocio salesdealId | Negocios de venta | referencia |
Acuerdo marco salesagreementId | Acuerdos marco | referencia |
Cliente customerId | Clientes | referencia |
Sucursal customerbranchId | Sucursales de cliente | referencia |
Contacto customercontactId | Contactos de cliente | referencia |
Vendedor userId | Usuarios | referencia |
Revisión de producto productrevisionId | Revisiones de producto | referencia |
Sitio de cumplimiento siteIdFulfillment | Sitios | referencia |
Condición de pago financespaymenttermId | Condiciones de pago | referencia |
Condiciones de venta salestermsconditionId | Términos y condiciones 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 salesquotes.<acción>. Las lecturas (find, get, count) funcionan en toda tabla.
| Nombre | Nombre API | Descripción | Dónde |
|---|---|---|---|
| Crear | create | Crea una cotización. | App · API · MCP · CLI |
| Editar | update | Guarda los cambios de la cotización. | App · API · MCP · CLI |
| Declinar | reject | El cliente declina esta revisión de la cotización. Elige el motivo. | App · API · MCP · CLI |
| Enviar | send | Envía la cotización al cliente. Si una partida incumple el piso de precio, se pide aprobación antes del envío. | App · API · MCP · CLI |
| Cerrar | close | Impide nuevas referencias a la cotización. Permanece, y los documentos existentes permanecen. Reabre para permitir referencias nuevas. | App · API · MCP · CLI |
| Reabrir | unclose | Permite de nuevo referencias nuevas a el cierre. | App · API · MCP · CLI |
| Revisar | revise | Abre una revisión nueva de esta cotización. | App · API · MCP · CLI |
| Revocar enlaces externos | revoke | Revocar los enlaces externos activos de la cotización. | App · API · MCP · CLI |
| Crear pedido | createOrder | Crear un pedido desde esta cotización. | App · API · MCP · CLI |
| Aceptar | confirm | El cliente acepta esta revisión de la cotización. | App · API · MCP · CLI |
| Compartir externamente | share | Publicar y enviar un enlace externo a este documento. | App · API · MCP · CLI |
| Bloquear | block | Impide editar y eliminar la cotización. 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 cotización. | App · API · MCP · CLI |
| Archivar | archive | Retira la cotización 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 cotización a las listas y las acciones activas. | App · API · MCP · CLI |
| Eliminar | delete | Elimina la cotización 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.