Ir al contenido

UnitCostSubcontract

Un subcontrato de costo unitario es un servicio contratado a un proveedor (por medio de un proveedor de subcontrato) que se consume en un costo unitario, con su cantidad. Es uno de los cuatro componentes de un costo unitario.

Modelo App\Models\UnitCostSubcontract
Tabla unit_cost_subcontracts
idinteger

Identificador.

unit_cost_idinteger

Costo unitario al que pertenece.

subcontract_provider_idinteger

Proveedor de subcontrato del que sale el precio.

subcontract_idinteger

Subcontrato. Se toma del proveedor de subcontrato.

measurement_unit_idinteger

Unidad de medida. Se toma del subcontrato.

namestring

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

descriptionstring

Descripción.

original_pricenumber

Precio del proveedor 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.

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.

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 UnitCostSubcontract200
{
"id": 8,
"unit_cost_id": 12,
"subcontract_provider_id": 15,
"measurement_unit_id": 8,
"subcontract_id": 6,
"name": "SERVICIO DE ENCOFRADO",
"description": null,
"original_price": "500.00000000",
"original_coin_id": 1,
"original_coin_value": "1.00000000",
"index": 1,
"cost": 500.0,
"cost_utility": 50.0,
"cost_utility_percentage": 10.0,
"price": 550.0,
"quantity": 2.0,
"total_cost": 1000.0,
"total_cost_utility": 100.0,
"total": 1100.0,
"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
unitCost belongsTo UnitCost
subcontract belongsTo Subcontract
subcontractProvider belongsTo SubcontractProvider
originalCoin belongsTo Coin (por original_coin_id)
measurementUnit belongsTo MeasurementUnit

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.

Este modelo declara sus propios campos de orden ($orderFields): id, name, price, created_at, index. Por defecto index|ASC.

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

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