UnitCostWorkforce
Un ítem de mano de obra de un costo unitario es un recurso de mano de obra (oficial, peón, operario…) que se consume en un costo unitario. A diferencia de los materiales, su cantidad no se envía: se calcula con el recurso, la jornada y el rendimiento del costo unitario. Es uno de los cuatro componentes de un costo unitario.
| Modelo | App\Models\UnitCostWorkforce |
| Tabla | unit_cost_workforces |
El objeto UnitCostWorkforce
Sección titulada «El objeto UnitCostWorkforce»Atributos
Sección titulada «Atributos»idintegerIdentificador.
unit_cost_idintegerCosto unitario al que pertenece.
workforce_idintegerMano de obra de origen.
measurement_unit_idintegerUnidad de medida. Se toma de la mano de obra.
namestringNombre. Al crear se toma de la mano de obra; al actualizar se puede cambiar.
descriptionstringDescripción.
original_pricenumberPrecio de la mano de obra en el momento de agregarla, en su moneda.
original_coin_idintegerMoneda del precio original.
original_coin_valuenumberTipo de cambio de la moneda original en ese momento.
indexintegerPosición dentro del costo unitario. Se cambia con la ruta de ordenar.
yieldnumberColumna de la tabla; no la usa esta API.
resourcenumberRecurso: cantidad de personas o cuadrillas que se asignan. Entra en el cálculo de quantity.
quantitynumberCantidad calculada: resource * workday / yield del costo unitario.
costnumberCosto por unidad, en 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.
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": 21, "unit_cost_id": 12, "workforce_id": 4, "measurement_unit_id": 6, "name": "OFICIAL ALBAÑIL", "description": null, "original_price": "18.50000000", "original_coin_id": 1, "original_coin_value": "1.00000000", "index": 1, "yield": null, "cost": 18.5, "cost_utility": 1.85, "cost_utility_percentage": 10.0, "price": 20.35, "resource": 1.0, "quantity": 0.6667, "total_cost": 12.3333, "total_cost_utility": 1.2333, "total": 13.5667, "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 |
workforce |
belongsTo | Workforce |
originalCoin |
belongsTo | Coin (por original_coin_id) |
unitCostWorkforces |
hasMany | UnitCostWorkforce |
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 ítem nuevo queda en activo; al eliminarlo pasa a eliminado.
