Empaques de producto
Una configuración de empaque y comercialización de un producto, con su cantidad contenida y unidad operativa.
- Nombre API:
productpackages - Dominio: Catálogo
- Módulos: Ventas, Servicios, 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í | Producto padre que define unidades base, trazabilidad y capacidades predeterminadas. Se establece al crear el registro y no puede cambiar después. |
| Nombre | label | Texto I18n | Nombre comercial de este empaque. Se muestra en documentos y se combina con el nombre del producto en el artículo materializado. | |
| SKU | sku | Texto | El SKU (del inglés Stock Keeping Unit) es un código alfanumérico único definido por la empresa para identificar, clasificar y gestionar un producto dentro de sus operaciones. A diferencia del UPC o EAN, el SKU es un identificador interno y su formato puede adaptarse a las necesidades del negocio. | |
| Código de barras GTIN | gtin | Código de barras GTIN | ||
| Cantidad | quantity | Decimal | Sí | Número de unidades base del producto contenidas en un empaque (por ejemplo, 12 para una caja de 12 botellas). |
| Cantidad discreta | isDiscrete | Binario | Sí | Cuando está activo, la cantidad contenida debe ser un número entero de unidades base y las transacciones posteriores usan empaques enteros. Cuando está desactivado, se permiten cantidades fraccionarias del empaque. |
| Peso | weight | Decimal | Masa física de un empaque (no es un factor de conversión de cantidad). | |
| Unidad de peso | weightunit | Constante | Unidad de la medición de peso del empaque (p. ej. kg, g, lb). | |
| Dimensiones | dimensions | Dimensiones | Envolvente geométrica nominal — extensión física paramétrica del producto. | |
| Enlaces | links | Enlace | Enlaces | ||
| Imagen | image | Imagen | ||
| Tags | tagIds | Tags | ||
| Descripción | description | Campo de Texto I18n | Descripción comercial localizada de este empaque. Se muestra en documentos cuando aplica. | |
| 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.
Acciones
Lo que puedes hacer con un registro. Cada acción también envía el evento de webhook productpackages.<acción>. Las lecturas (find, get, count) funcionan en toda tabla.
| Nombre | Nombre API | Descripción | Dónde |
|---|---|---|---|
| Crear | create | Crea un empaque. | App · API · MCP · CLI |
| Editar | update | Guarda los cambios del empaque. | App · API · MCP · CLI |
| Deshabilitar | disable | Desactiva el empaque para usos nuevos. Las referencias existentes se mantienen. Actívalo de nuevo para usarlo. | App · API · MCP · CLI |
| Habilitar | undisable | Vuelve a activar el empaque 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 el empaque. Sigue visible y puede seguir en documentos existentes. Desbloquéalo para volver a cambiarlo. | App · API · CLI |
| Desbloquear | unblock | Permite de nuevo editar y eliminar el empaque. | App · API · CLI |
| Archivar | archive | Retira el empaque 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 empaque a las listas y las acciones activas. | App · API · MCP · CLI |
| Eliminar | delete | Elimina el empaque 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.