Ir al contenido

UnitCostEquipmentTool

Un ítem de equipo o herramienta de un costo unitario es un equipo o herramienta que se usa en un costo unitario, con su cantidad. Es uno de los cuatro componentes de un costo unitario. El equipo llamado herramientas manuales con unidad %mo es un caso especial: su costo se toma del total de mano de obra del costo unitario.

Modelo App\Models\UnitCostEquipmentTool
Tabla unit_cost_equipment_tools
idinteger

Identificador.

unit_cost_idinteger

Costo unitario al que pertenece.

equipment_tool_idinteger

Equipo o herramienta de origen.

measurement_unit_idinteger

Unidad de medida. Se toma del equipo o herramienta.

namestring

Nombre. Al crear se toma del equipo o herramienta; al actualizar se puede cambiar.

descriptionstring

Descripción.

original_pricenumber

Precio del equipo en el momento de agregarlo, en su moneda.

original_coin_idinteger

Moneda del precio original.

original_coin_valuenumber

Tipo de cambio de la moneda original en ese momento.

indexinteger

Posición dentro del costo unitario. Se cambia con la ruta de ordenar.

resourcenumber

Columna de la tabla; la API no la recibe al crear ni al actualizar.

costnumber

Costo por unidad, en 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.

is_percentage_workforceboolean

Columna de la tabla (por defecto falso); esta API no la modifica.

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 UnitCostEquipmentTool200
{
"id": 17,
"unit_cost_id": 12,
"equipment_tool_id": 9,
"measurement_unit_id": 7,
"name": "MEZCLADORA DE CONCRETO",
"description": null,
"original_price": "40.00000000",
"original_coin_id": 1,
"original_coin_value": "1.00000000",
"index": 1,
"resource": null,
"cost": 40.0,
"cost_utility": 4.0,
"cost_utility_percentage": 10.0,
"price": 44.0,
"quantity": 0.5,
"total_cost": 20.0,
"total_cost_utility": 2.0,
"total": 22.0,
"is_percentage_workforce": false,
"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
equipmentTool belongsTo EquipmentTool
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 ítem nuevo queda en activo; al eliminarlo pasa a eliminado.