Transformaciones de producto
Una transformación comercial con nombre que se ofrece sobre un producto del catálogo.
- Nombre API:
producttransformations - Dominio: Catálogo
- Módulos: Ventas, Inventario, Manufactura, Compras, Logística, Datos maestros
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í | |
| Producto | productId | Referencia | Sí | |
| Posición | rank | Orden | Sí | |
| Nombre | label | Texto I18n | ||
| Código | code | Texto | Sí | Identificador comercial estable de esta oferta en este producto. Único dentro de la organización por producto — se usa en importaciones, integraciones y reglas comerciales. |
| Artículo | serviceitemId | Referencia | ||
| Categoría | class | Constante | Sí | Familia de transformación de esta oferta. Nombra el tipo de modificación que el cliente puede solicitar — no cómo la manufactura la ejecutará. Corte, maquinado y formado requieren que el producto tenga identificadores en inventario (lotes o números de serie); con números de serie cada pieza resultante recibe un nuevo número de serie ligado a su origen. |
| Eje de operación | dimensionAxis | Constante | Dimensión física que esta transformación consume o modifica. Debe existir en la envolvente dimensional del producto. No aplica a acabado. | |
| Precio | pricing | Constante | Sí | Indicador comercial de cómo se cotiza esta oferta. No almacena un importe — las listas de precios siguen sembrando el precio unitario de la partida de venta. |
| Base del cargo | chargeBasis | Constante | Cómo se calcula el cargo de la transformación: por corte, por pieza, por longitud o una vez por partida. | |
| Permitir exceder existencias | allowExceedStock | Binario | Sí | Permite que una operación futura solicite más cantidad que las existencias disponibles en la posición elegida. No hace elegible un identificador con existencias en cero solo por existir. |
| Base de consumo | consumptionBasis | Constante | Cómo esta oferta consume existencias. Dejar vacío cuando la oferta no consume existencias. Prohibido para acabado. | |
| Ancho de corte | kerf | Decimal | Desperdicio por corte, en la unidad de dimensiones del producto (longitud principal). | |
| Remanente | remnant | Constante | Política de disposición de sobrantes, no un estado de identidad. nonNominalReason = remnant solo cuando una operación futura reingresa existencias. | |
| Longitud mínima de remanente | minRemnantLength | Decimal | Longitud mínima de remanente para reingresar a inventario, en la unidad de dimensiones del producto. Obligatoria cuando se permiten remanentes. | |
| Tags | tagIds | Tags | Tags opcionales para clasificar y filtrar esta transformación. | |
| Descripción | description | Campo de Texto I18n | Descripción comercial localizada de esta oferta de transformación. | |
| 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í | |
| 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 |
|---|---|---|
Producto productId | Productos | agrupado por |
Artículo serviceitemId | Artículos de servicio | referencia |
Tags tagIds | Tags | referencia |
Acciones
Lo que puedes hacer con un registro. Cada acción también envía el evento de webhook producttransformations.<acción>. Las lecturas (find, get, count) funcionan en toda tabla.
| Nombre | Nombre API | Descripción | Dónde |
|---|---|---|---|
| Crear | create | Crea una transformación. | App · API · MCP · CLI |
| Editar | update | Guarda los cambios de la transformación. | App · API · MCP · CLI |
| Deshabilitar | disable | Desactiva la transformación para usos nuevos. Las referencias existentes se mantienen. Actívala de nuevo para usarla. | App · API · MCP · CLI |
| Habilitar | undisable | Vuelve a activar la transformación para usos nuevos. | App · API · MCP · CLI |
| Publicar | publish | Publica la disponibilidad para que pueda usarse. | App · API · MCP · CLI |
| Bloquear | block | Impide editar y eliminar la transformación. Sigue visible y puede seguir en documentos existentes. Desbloquéala para volver a cambiarla. | App · API · CLI |
| Desbloquear | unblock | Permite de nuevo editar y eliminar la transformación. | App · API · CLI |
| Archivar | archive | Retira la transformació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 transformación a las listas y las acciones activas. | App · API · MCP · CLI |
| Eliminar | delete | Elimina la transformació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.