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 |
El objeto Product
Sección titulada «El objeto Product»Atributos
Sección titulada «Atributos»idintegerIdentificador del producto.
brand_idintegerMarca del producto.
measurement_unit_idintegerUnidad de medida base del producto.
unified_index_idintegerÍndice unificado del producto. Es opcional.
codestringCódigo correlativo del producto. Lo genera el servidor al crear.
part_numberstringNúmero de parte. Es único.
namestringNombre del producto.
descriptionstringDescripción del producto.
featuresstringCaracterísticas del producto. Es opcional.
search_keywordsstringPalabras clave para la búsqueda de texto completo. Las genera el servidor al guardar.
embeddingarrayVector que usa la búsqueda semántica. Lo gestiona el servidor; no se envía en las solicitudes.
buy_pricenumberPrecio de compra. Es opcional.
sale_pricenumberPrecio de venta. Es opcional.
stockintegerStock registrado en el producto. Es opcional.
imagestringRuta de la imagen del producto.
thumbnallstringRuta de la miniatura. El nombre de la columna se escribe así en la base de datos.
is_inventory_itembooleanIndica si el producto participa del kardex físico.
is_dropshipping_enabledbooleanIndica si el producto expone la disponibilidad del proveedor.
tracking_typestringTrazabilidad (TrackingTypeEnum): none, lot, serial o lot_serial.
picking_strategystringEstrategia de salida (PickingStrategyEnum): fefo, fifo o manual. Es obligatoria cuando la trazabilidad usa lotes.
statusstringEstado del registro (ModelStatusEnum). Se asigna al crear.
previous_statusstringEstado anterior. Lo llena el sistema al eliminar o restaurar.
status_update_commentstringComentario del último cambio de estado.
status_update_datedatetimeFecha del último cambio de estado.
status_update_user_idintegerUsuario que hizo el último cambio de estado.
create_user_idintegerUsuario que creó el registro. Se asigna automáticamente.
update_user_idintegerUsuario que hizo la última modificación.
delete_user_idintegerUsuario que eliminó el registro.
restore_user_idintegerUsuario que restauró el registro.
created_atdatetimeFecha de creación.
updated_atdatetimeFecha de la última modificación.
deleted_atdatetimeFecha de eliminación lógica.
{ "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}Relaciones
Sección titulada «Relaciones»| 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.
Filtros propios
Sección titulada «Filtros propios»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.
Búsqueda
Sección titulada «Búsqueda»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.
Estados
Sección titulada «Estados»El estado usa ModelStatusEnum. Un producto nuevo queda en activo; al eliminarlo pasa a eliminado.
Módulos relacionados fuera de Ventas
Sección titulada «Módulos relacionados fuera de Ventas»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.
