Ir al contenido

Product

Un producto es un artículo del catálogo que se cotiza y, si está marcado como artículo de inventario, se controla en almacén. Es el catálogo de la pantalla Productos de la configuración de Ventas. Un producto agrupa sus categorías, sus precios por proveedor, sus presentaciones (unidades) y sus códigos de barras.

Modelo App\Models\Product
Tabla products
idinteger

Identificador del producto.

brand_idinteger

Marca del producto.

measurement_unit_idinteger

Unidad de medida base del producto.

unified_index_idinteger

Índice unificado del producto. Es opcional.

codestring

Código correlativo del producto. Lo genera el servidor al crear.

part_numberstring

Número de parte. Es único.

namestring

Nombre del producto.

descriptionstring

Descripción del producto.

featuresstring

Características del producto. Es opcional.

search_keywordsstring

Palabras clave para la búsqueda de texto completo. Las genera el servidor al guardar.

embeddingarray

Vector que usa la búsqueda semántica. Lo gestiona el servidor; no se envía en las solicitudes.

buy_pricenumber

Precio de compra. Es opcional.

sale_pricenumber

Precio de venta. Es opcional.

stockinteger

Stock registrado en el producto. Es opcional.

imagestring

Ruta de la imagen del producto.

thumbnallstring

Ruta de la miniatura. El nombre de la columna se escribe así en la base de datos.

is_inventory_itemboolean

Indica si el producto participa del kardex físico.

is_dropshipping_enabledboolean

Indica si el producto expone la disponibilidad del proveedor.

tracking_typestring

Trazabilidad (TrackingTypeEnum): none, lot, serial o lot_serial.

picking_strategystring

Estrategia de salida (PickingStrategyEnum): fefo, fifo o manual. Es obligatoria cuando la trazabilidad usa lotes.

statusstring

Estado del registro (ModelStatusEnum). Se asigna al crear.

previous_statusstring

Estado anterior. Lo llena el sistema al eliminar o restaurar.

status_update_commentstring

Comentario del último cambio de estado.

status_update_datedatetime

Fecha del último cambio de estado.

status_update_user_idinteger

Usuario que hizo el último cambio de estado.

create_user_idinteger

Usuario que creó el registro. Se asigna automáticamente.

update_user_idinteger

Usuario que hizo la última modificación.

delete_user_idinteger

Usuario que eliminó el registro.

restore_user_idinteger

Usuario que restauró el registro.

created_atdatetime

Fecha de creación.

updated_atdatetime

Fecha de la última modificación.

deleted_atdatetime

Fecha de eliminación lógica.

El objeto Product200
{
"id": 1,
"brand_id": 1,
"measurement_unit_id": 2,
"unified_index_id": null,
"code": "0000001",
"part_number": "NSX100F",
"name": "Interruptor termomagnético 3x100A",
"description": "Interruptor termomagnético tripolar de 100 A",
"features": null,
"search_keywords": "interruptor termomagnetico 3x100a nsx100f 0000001 schneider",
"buy_price": "120.00000000",
"sale_price": "150.00000000",
"stock": null,
"image": null,
"thumbnall": null,
"is_inventory_item": true,
"is_dropshipping_enabled": false,
"tracking_type": "none",
"picking_strategy": null,
"status": "activo",
"previous_status": null,
"status_update_comment": null,
"status_update_date": null,
"status_update_user_id": null,
"create_user_id": 1,
"update_user_id": null,
"delete_user_id": null,
"restore_user_id": null,
"created_at": "2026-11-19T10:40:15.000000Z",
"updated_at": "2026-11-19T10:40:15.000000Z",
"deleted_at": null
}
Relación Tipo Modelo
brand belongsTo Brand
measurementUnit belongsTo MeasurementUnit
unifiedIndex belongsTo UnifiedIndex
productCategories hasMany ProductCategory
productCategory hasOne ProductCategory
providerProducts hasMany ProviderProduct
productUnits hasMany ProductUnit
productBarcodes hasMany ProductBarcode
productUnitCostCategories hasMany ProductUnitCostCategory
quotationMaterials hasMany QuotationMaterial
unitCostMaterials hasMany UnitCostMaterial
inventoryLots hasMany InventoryLot
inventorySerials hasMany InventorySerial
productWarehouseSettings hasMany ProductWarehouseSetting

Además, BaseModelTrait agrega createUser, updateUser, deleteUser y restoreUser (belongsTo User).

El modelo no define $allowedRelations, así que relations acepta cualquiera de estas relaciones. No define $allowedCountRelations, por lo que count_relations no devuelve conteos.

ProductController::index agrega estos filtros al listado: brand_id, measurement_unit_id, category_id, provider_id, tracking_type, is_inventory_item, is_dropshipping_enabled, warehouse_id y with_aggregates. Los detalla la página Listar productos.

Campos permitidos para ordenar: id, name, code, part_number, created_at, updated_at, status.

La búsqueda de texto (search) compara con las columnas name, code y part_number, y con el campo barcode de la relación productBarcodes.

El estado usa ModelStatusEnum. Un producto nuevo queda en activo; al eliminarlo pasa a eliminado.

Estos controladores trabajan con datos del producto, pero no pertenecen a esta sección: ProductBarcodeController (códigos de barras) y ProductWarehouseSettingController (configuración por almacén) son de Inventario, y ProviderProductController y ProviderProductPriceController (precios por proveedor) son de Compras. Los códigos de barras y los precios por proveedor también se pueden enviar anidados al crear o actualizar un producto.

Las presentaciones del producto (ProductUnit) y sus categorías (ProductCategory) no tienen endpoints propios: se crean dentro de Crear un producto. Ver ProductUnit y ProductCategory.