Acuerdos marco
Acuerdo comercial vigente con un cliente en una empresa y moneda, ligado a una lista de precios de venta y fechas de vigencia.
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 | Sí | |
| Folio | uid | Texto | El folio es un identificador único y legible para el registro. | |
| Acuerdo marco anterior | salesagreementIdPrevious | Referencia | Acuerdo publicado anterior que sustituye esta renovación, cuando aplica. | |
| Cliente | customerId | Referencia | Sí | |
| Moneda de cotización | currency | Constante | Sí | Valor del catálogo de la tabla para este campo. |
| Lista de precios al renovar | priceRenewal | Constante | Valor del catálogo de la tabla para este campo. | |
| Importe objetivo | amountTarget | Moneda | Tope opcional antes de impuestos. Se compara con los pedidos aprobados de este acuerdo al aprobar un pedido. | |
| Vigente desde | dateFrom | Fecha | Primera fecha en que aplica este registro. | |
| Vigente hasta | dateTo | Fecha | Última fecha en que aplica este registro, si aplica. | |
| Lista de precios | salespricelistId | Referencia | Sí | |
| Tags | tagIds | Tags | ||
| Creado por | createdBy | Usuario | ||
| Creado el | createdAt | Fecha y Hora | Sí | |
| Actualizado por | updatedBy | Usuario | ||
| Actualizado el | updatedAt | Fecha y Hora | Sí | |
| Publicado por | publishedBy | Usuario | ||
| Publicado el | publishedAt | Fecha y Hora | ||
| Deshabilitado por | disabledBy | Usuario | ||
| Deshabilitado el | disabledAt | 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 |
|---|---|---|
Acuerdo marco anterior salesagreementIdPrevious | Acuerdos marco | referencia |
Cliente customerId | Clientes | referencia |
Lista de precios salespricelistId | Listas de precios de venta | referencia |
Tags tagIds | Tags | referencia |
Acciones
Lo que puedes hacer con un registro. Cada acción también envía el evento de webhook salesagreements.<acción>. Las lecturas (find, get, count) funcionan en toda tabla.
| Nombre | Nombre API | Descripción | Dónde |
|---|---|---|---|
| Crear | create | Crea un acuerdo. | App · WebMCP · API · MCP · CLI |
| Editar | update | Guarda los cambios del acuerdo. | App · WebMCP · API · MCP · CLI |
| Deshabilitar | disable | Desactiva el acuerdo para usos nuevos. Las referencias existentes se mantienen. Actívalo de nuevo para usarlo. | App · WebMCP · API · MCP · CLI |
| Habilitar | undisable | Vuelve a activar el acuerdo para usos nuevos. | App · WebMCP · API · MCP · CLI |
| Publicar | publish | Publica la disponibilidad para que pueda usarse. | App · WebMCP · API · MCP · CLI |
| Renovar | renew | Crea el siguiente periodo del acuerdo con las mismas condiciones. | App · API · MCP · CLI |
| Bloquear | block | Impide editar y eliminar el acuerdo. Sigue visible y puede seguir en documentos existentes. Desbloquéalo para volver a cambiarlo. | App · WebMCP · API · MCP · CLI |
| Desbloquear | unblock | Permite de nuevo editar y eliminar el acuerdo. | App · WebMCP · API · MCP · CLI |
| Archivar | archive | Retira el acuerdo 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 acuerdo a las listas y las acciones activas. | App · WebMCP · API · MCP · CLI |
| Eliminar | delete | Elimina el acuerdo y los datos que le pertenecen. No se puede deshacer. | App · WebMCP · API · MCP · CLI |
Estados
Cómo pasa un registro de un estado a otro. Archivar y bloquear pueden ocurrir en cualquier estado.