Ir al contenido

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
idinteger

Identificador.

unit_cost_idinteger

Costo unitario al que pertenece.

provider_product_idinteger

Producto del proveedor del que sale el precio.

product_idinteger

Producto. Se toma del producto del proveedor.

measurement_unit_idinteger

Unidad de medida. Se toma del producto.

namestring

Nombre del material. Al crear se toma del producto; al actualizar se puede cambiar.

descriptionstring

Descripción.

indexinteger

Posición dentro del costo unitario. Al crear toma el mayor índice más uno.

original_pricenumber

Precio del producto del proveedor en el momento de agregarlo, en la moneda del proveedor.

original_coin_idinteger

Moneda del precio original.

original_coin_valuenumber

Tipo de cambio de la moneda original en ese momento.

costnumber

Costo unitario del material, ya convertido a la moneda del costo unitario.

cost_utilitynumber

Utilidad por unidad, en monto.

cost_utility_percentagenumber

Utilidad como porcentaje del costo.

pricenumber

Precio por unidad: costo más utilidad.

quantitynumber

Cantidad.

total_costnumber

Costo total: cost * quantity.

total_cost_utilitynumber

Utilidad total: total - total_cost.

totalnumber

Total: price * quantity.

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 UnitCostMaterial200
{
"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
}
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.

El modelo no configura columnas de búsqueda, así que search no filtra los resultados.

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