Ir al contenido

UnitCost

Un costo unitario es el análisis de precios de una partida: cuánto cuesta producir una unidad de medida (por ejemplo, un metro cuadrado de muro) sumando los recursos que se consumen. Pertenece a una cotización y se crea colgando de un ítem de esa cotización; al crearlo se genera además un ítem de cotización de tipo costo unitario.

Modelo App\Models\UnitCost
Tabla unit_costs
idinteger

Identificador.

namestring

Nombre del costo unitario.

quotation_idinteger

Cotización a la que pertenece. Se toma de la cotización del ítem padre al crear.

codestring

Código correlativo de 4 dígitos. Lo genera el servidor al crear.

descriptionstring

Descripción.

measurement_unit_idinteger

Unidad de medida del costo unitario.

yieldnumber

Rendimiento: cantidad de unidades de medida que se producen en una jornada. Divide el consumo de mano de obra y de equipos por hora o por día.

workdayinteger

Horas de la jornada. Se fija en 8 al crear.

coin_idinteger

Moneda del costo unitario. Se toma de la cotización al crear.

coin_valuenumber

Tipo de cambio de la moneda en el momento de crear (se copia de la cotización).

limit_decimalsinteger

Decimales con los que se redondean los montos. Se copia de la cotización (4 si no tiene).

items_utility_individualboolean

Si es verdadero, cada ítem lleva su propia utilidad. Si es falso, la utilidad de todos los ítems sale de cost_utility_percentage.

cost_materialsnumber

Suma del costo (total_cost) de los materiales.

cost_workforcesnumber

Suma del costo de la mano de obra.

cost_subcontractsnumber

Suma del costo de los subcontratos.

cost_equipment_toolsnumber

Suma del costo de los equipos y herramientas.

cost_utility_materialsnumber

Suma de la utilidad (total_cost_utility) de los materiales.

cost_utility_workforcesnumber

Suma de la utilidad de la mano de obra.

cost_utility_subcontractsnumber

Suma de la utilidad de los subcontratos.

cost_utility_equipment_toolsnumber

Suma de la utilidad de los equipos y herramientas.

total_materialsnumber

Suma del total (total, costo más utilidad) de los materiales.

total_workforcesnumber

Suma del total de la mano de obra.

total_subcontractsnumber

Suma del total de los subcontratos.

total_equipment_toolsnumber

Suma del total de los equipos y herramientas.

costnumber

Costo del costo unitario: suma de los cuatro costos por tipo.

cost_utilitynumber

Utilidad: suma de las cuatro utilidades por tipo.

cost_utility_percentagenumber

Utilidad como porcentaje del costo. Si items_utility_individual es falso, es el porcentaje que se aplica a cada ítem.

pricenumber

Precio del costo unitario: suma de los cuatro totales por tipo.

period_amountnumber

Columna de la tabla; el modelo no la lista en $fillable y esta API no la usa.

total_budgetnumber

Columna de la tabla; el modelo no la lista en $fillable y esta API no la usa.

search_keywordsstring

Texto en minúsculas con nombre, código, descripción, unidad e ítems, para la búsqueda de texto completo. Lo genera el sistema.

embeddingarray

Vector para búsqueda semántica. Lo llena el sistema; no se devuelve en los ejemplos.

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 UnitCost200
{
"id": 12,
"name": "MURO DE LADRILLO KING KONG",
"quotation_id": 7,
"code": "0012",
"description": "Muro de soga, asentado con mortero 1:5",
"measurement_unit_id": 3,
"yield": 12.0,
"workday": 8,
"coin_id": 1,
"coin_value": "1.00000000",
"limit_decimals": 4,
"cost_materials": "35.20000000",
"cost_workforces": "28.00000000",
"cost_subcontracts": "0.00000000",
"cost_equipment_tools": "1.40000000",
"cost_utility_materials": "3.52000000",
"cost_utility_workforces": "2.80000000",
"cost_utility_subcontracts": "0.00000000",
"cost_utility_equipment_tools": "0.14000000",
"total_materials": "38.72000000",
"total_workforces": "30.80000000",
"total_subcontracts": "0.00000000",
"total_equipment_tools": "1.54000000",
"cost": "64.60000000",
"cost_utility": "6.46000000",
"cost_utility_percentage": "10.00000000",
"price": "71.06000000",
"period_amount": null,
"total_budget": null,
"items_utility_individual": true,
"search_keywords": "muro de ladrillo king kong 0012",
"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
}

Un costo unitario no tiene un precio propio: se arma con cuatro tipos de ítems, cada uno con su recurso y su endpoint.

Componente Recurso Qué representa
Materiales unit-cost-material Productos de un proveedor, con cantidad.
Mano de obra unit-cost-workforce Cuadrillas o personal, con el recurso (cantidad de personas) que se consume.
Equipos y herramientas unit-cost-equipment-tool Equipos y herramientas, con cantidad.
Subcontratos unit-cost-subcontract Servicios de un proveedor de subcontrato, con cantidad.

Cada ítem guarda, además del recurso de origen, una copia del precio y de la moneda (original_price, original_coin_id, original_coin_value). Los ítems se ordenan por index.

Los cálculos viven en App\Utils\UnitCostUtils (con NumberUtils, que hace la aritmética con decimales exactos) y en los controladores de cada tipo de ítem. Todo se redondea a limit_decimals decimales.

Por cada ítem:

  1. cost: precio del recurso convertido a la moneda del costo unitario con cost = precio * valor de la moneda del recurso / coin_value.
  2. cost_utility: utilidad por unidad, en monto. La envía el cliente; si items_utility_individual del costo unitario es falso, se ignora y se calcula como cost * cost_utility_percentage / 100 con el porcentaje del costo unitario.
  3. cost_utility_percentage = cost_utility / cost * 100 (0 si el costo es 0).
  4. price = cost + cost_utility.
  5. total_cost = cost * quantity, total = price * quantity y total_cost_utility = total - total_cost.

Cantidad de la mano de obra: la cantidad no la envía el cliente. Se calcula como quantity = resource * workday / yield del costo unitario; por eso, al cambiar yield, se recalculan todos los ítems de mano de obra.

Equipos y herramientas especiales: el equipo llamado herramientas manuales con unidad %mo no tiene un precio propio: su costo es el total_workforces del costo unitario y su cantidad se expresa como porcentaje de la mano de obra.

Del costo unitario: después de cada alta, cambio o baja de ítems, UnitCostController::updateTotalAmounts (y sus variantes por tipo) suma en SQL los ítems no eliminados:

Campo del costo unitario Cómo se calcula
cost_materials, cost_workforces, cost_subcontracts, cost_equipment_tools Suma de total_cost de los ítems de cada tipo.
cost_utility_materials, cost_utility_workforces, cost_utility_subcontracts, cost_utility_equipment_tools Suma de total_cost_utility de cada tipo.
total_materials, total_workforces, total_subcontracts, total_equipment_tools Suma de total de cada tipo.
cost cost_materials + cost_workforces + cost_subcontracts + cost_equipment_tools.
cost_utility Suma de los cuatro cost_utility_*.
price Suma de los cuatro total_*.
cost_utility_percentage cost_utility / cost * 100, redondeado a limit_decimals (0 si cost es 0).

Luego se propagan los importes al ítem de cotización del costo unitario (QuotationItemController::updateAmountsFromUnitCostId) y a los totales de la cotización (QuotationController::updateTotalAmounts).

Cuando un recurso (producto, mano de obra, equipo o subcontrato) aparece en varios costos unitarios de las cotizaciones de una misma oportunidad, los cambios de precio o de utilidad se sincronizan entre ellos mientras esas cotizaciones estén en cotizando. Las páginas de crear y actualizar de cada ítem describen ese comportamiento.

Relación Tipo Modelo
measurementUnit belongsTo MeasurementUnit
unitCostMaterials hasMany (ordenada por index) UnitCostMaterial
unitCostEquipmentTools hasMany (ordenada por index) UnitCostEquipmentTool
unitCostWorkforces hasMany (ordenada por index) UnitCostWorkforce
unitCostSubcontracts hasMany (ordenada por index) UnitCostSubcontract
quotationItem hasOne QuotationItem
quotation belongsTo Quotation
coin belongsTo Coin

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
whenMeasurementUnitId measurement_unit_id Filtra por unidad de medida.
whenQuotationId quotation_id Filtra por cotización.
whenCoinId coin_id Filtra por moneda.

Campos permitidos para ordenar: id, name, created_at, updated_at, status. Por defecto id|DESC.

La búsqueda de texto (search) combina búsqueda de texto completo sobre search_keywords con coincidencia parcial en name y code.

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