Artículos de producto
Un artículo vendible publicado de un producto o de un empaque, con códigos e imagen copiados de su origen.
- Nombre API:
productitems - Dominio: Catálogo
- Módulos: Ventas, Tiendas, Servicios, Finanzas, 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í | |
| Nombre | label | Texto I18n | Nombre calculado para mostrar. En artículos individuales: nombre del producto. En artículos empacados: nombre del producto más el nombre del empaque. Lo mantiene el sistema cuando cambia el producto o el empaque; no se edita en el artículo. | |
| SKU del artículo | sku | Texto | Código interno para identificar este artículo en la operación. | |
| Código de barras GTIN | gtin | Código de barras GTIN | ||
| Familia | productgroupId | Referencia | Familia heredada del producto. La mantiene el sistema. | |
| Cantidad | quantity | Decimal | Número de unidades base contenidas en un empaque. Solo en artículos empacados. | |
| Producto | productId | Referencia | Sí | Producto padre que materializa este artículo. Lo establece el sistema al crear el producto o el empaque. |
| Unidad base | baseunit | Constante | Sí | Unidad de medida principal. Todas las cantidades y valuaciones de inventario usan esta unidad. La unidad mide cantidad; no implica que las identidades físicas sean intercambiables. |
| Trazabilidad | tracking | Constante | Sí | Define cómo se rastrea el inventario: por cantidad, por lote o por número de serie. |
| Empaque | productpackageId | Referencia | Empaque que materializa este artículo. Solo en artículos empacados. | |
| Cantidad discreta | isDiscrete | Binario | Sí | Cuando está activo, las cantidades deben ser números enteros en la unidad base. Cuando está desactivado, se permiten cantidades fraccionarias. |
| Tipo de artículo | class | Constante | Sí | Indica si el artículo se vende o almacena por unidad o como empaque. |
| Control de vida útil | hasShelfLife | Binario | Sí | Requiere registrar una fecha de vencimiento o consumo preferente en la recepción. |
| Vida útil (días) | shelfLifeDays | Número Entero | Vida útil estándar en días desde la recepción o fabricación. | |
| Imagen | image | Imagen | Imagen copiada del producto, o del empaque cuando el empaque tiene imagen propia. | |
| Tags de familia | productgroupTagIds | Tags | Tags heredados de la familia de producto. | |
| Tags de producto | productTagIds | Tags | Tags heredados del producto. | |
| Tags de empaque | productpackageTagIds | Tags | Tags heredados del empaque. Solo presentes en artículos empacados. | |
| Descripción | description | Campo de Texto I18n | Descripción localizada copiada del producto padre. La mantiene el sistema; no se edita en el artículo. | |
| 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 |
|---|---|---|
Familia productgroupId | Familias de producto | referencia |
Producto productId | Productos | referencia |
Empaque productpackageId | Empaques de producto | referencia |