UnitCostMaterial
Un material de costo unitario es un producto de un proveedor que se consume en un costo unitario, con su cantidad. Es uno de los cuatro componentes de un costo unitario.
| Modelo | App\Models\UnitCostMaterial |
| Tabla | unit_cost_materials |
El objeto UnitCostMaterial
Sección titulada «El objeto UnitCostMaterial»Atributos
Sección titulada «Atributos»idintegerIdentificador.
unit_cost_idintegerCosto unitario al que pertenece.
provider_product_idintegerProducto del proveedor del que sale el precio.
product_idintegerProducto. Se toma del producto del proveedor.
measurement_unit_idintegerUnidad de medida. Se toma del producto.
namestringNombre del material. Al crear se toma del producto; al actualizar se puede cambiar.
descriptionstringDescripción.
indexintegerPosición dentro del costo unitario. Al crear toma el mayor índice más uno.
original_pricenumberPrecio del producto del proveedor en el momento de agregarlo, en la moneda del proveedor.
original_coin_idintegerMoneda del precio original.
original_coin_valuenumberTipo de cambio de la moneda original en ese momento.
costnumberCosto unitario del material, ya convertido a la moneda del costo unitario.
cost_utilitynumberUtilidad por unidad, en monto.
cost_utility_percentagenumberUtilidad como porcentaje del costo.
pricenumberPrecio por unidad: costo más utilidad.
quantitynumberCantidad.
total_costnumberCosto total: cost * quantity.
total_cost_utilitynumberUtilidad total: total - total_cost.
totalnumberTotal: price * quantity.
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": 31, "unit_cost_id": 12, "provider_product_id": 88, "product_id": 40, "measurement_unit_id": 5, "name": "CEMENTO PORTLAND TIPO I 42.5 KG", "description": null, "index": 1, "original_price": "25.50000000", "original_coin_id": 1, "original_coin_value": "1.00000000", "cost": 25.5, "cost_utility": 2.55, "cost_utility_percentage": 10.0, "price": 28.05, "quantity": 10.0, "total_cost": 255.0, "total_cost_utility": 25.5, "total": 280.5, "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 |
|---|---|---|
measurementUnit |
belongsTo | MeasurementUnit |
unitCost |
belongsTo | UnitCost |
providerProduct |
belongsTo | ProviderProduct |
product |
belongsTo | Product |
originalCoin |
belongsTo | Coin (por original_coin_id) |
El modelo no define $allowedRelations (la lista está comentada), así que relations acepta cualquier relación, salvo las bloqueadas de forma global.
| Scope | Parámetro de consulta | Efecto |
|---|---|---|
unitCostId |
unit_cost_id |
Filtra por costo unitario. |
Campos permitidos para ordenar: id, name, created_at, updated_at, status. Por defecto id|DESC.
Búsqueda
Sección titulada «Búsqueda»El modelo no configura columnas de búsqueda, así que search no filtra los resultados.
Estados
Sección titulada «Estados»El estado usa ModelStatusEnum. Un material nuevo queda en activo; al eliminarlo pasa a eliminado.
