Ir al contenido

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
idinteger

Identificador.

unit_cost_idinteger

Costo unitario al que pertenece.

workforce_idinteger

Mano de obra de origen.

measurement_unit_idinteger

Unidad de medida. Se toma de la mano de obra.

namestring

Nombre. Al crear se toma de la mano de obra; al actualizar se puede cambiar.

descriptionstring

Descripción.

original_pricenumber

Precio de la mano de obra en el momento de agregarla, 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.

yieldnumber

Columna de la tabla; no la usa esta API.

resourcenumber

Recurso: cantidad de personas o cuadrillas que se asignan. Entra en el cálculo de quantity.

quantitynumber

Cantidad calculada: resource * workday / yield del costo unitario.

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.

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

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.