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 |
El objeto UnitCost
Sección titulada «El objeto UnitCost»Atributos
Sección titulada «Atributos»idintegerIdentificador.
namestringNombre del costo unitario.
quotation_idintegerCotización a la que pertenece. Se toma de la cotización del ítem padre al crear.
codestringCódigo correlativo de 4 dígitos. Lo genera el servidor al crear.
descriptionstringDescripción.
measurement_unit_idintegerUnidad de medida del costo unitario.
yieldnumberRendimiento: 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.
workdayintegerHoras de la jornada. Se fija en 8 al crear.
coin_idintegerMoneda del costo unitario. Se toma de la cotización al crear.
coin_valuenumberTipo de cambio de la moneda en el momento de crear (se copia de la cotización).
limit_decimalsintegerDecimales con los que se redondean los montos. Se copia de la cotización (4 si no tiene).
items_utility_individualbooleanSi es verdadero, cada ítem lleva su propia utilidad. Si es falso, la utilidad de todos los ítems sale de cost_utility_percentage.
cost_materialsnumberSuma del costo (total_cost) de los materiales.
cost_workforcesnumberSuma del costo de la mano de obra.
cost_subcontractsnumberSuma del costo de los subcontratos.
cost_equipment_toolsnumberSuma del costo de los equipos y herramientas.
cost_utility_materialsnumberSuma de la utilidad (total_cost_utility) de los materiales.
cost_utility_workforcesnumberSuma de la utilidad de la mano de obra.
cost_utility_subcontractsnumberSuma de la utilidad de los subcontratos.
cost_utility_equipment_toolsnumberSuma de la utilidad de los equipos y herramientas.
total_materialsnumberSuma del total (total, costo más utilidad) de los materiales.
total_workforcesnumberSuma del total de la mano de obra.
total_subcontractsnumberSuma del total de los subcontratos.
total_equipment_toolsnumberSuma del total de los equipos y herramientas.
costnumberCosto del costo unitario: suma de los cuatro costos por tipo.
cost_utilitynumberUtilidad: suma de las cuatro utilidades por tipo.
cost_utility_percentagenumberUtilidad como porcentaje del costo. Si items_utility_individual es falso, es el porcentaje que se aplica a cada ítem.
pricenumberPrecio del costo unitario: suma de los cuatro totales por tipo.
period_amountnumberColumna de la tabla; el modelo no la lista en $fillable y esta API no la usa.
total_budgetnumberColumna de la tabla; el modelo no la lista en $fillable y esta API no la usa.
search_keywordsstringTexto en minúsculas con nombre, código, descripción, unidad e ítems, para la búsqueda de texto completo. Lo genera el sistema.
embeddingarrayVector para búsqueda semántica. Lo llena el sistema; no se devuelve en los ejemplos.
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": 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}Cómo se compone un costo unitario
Sección titulada «Cómo se compone un costo unitario»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.
Cómo se calcula el total
Sección titulada «Cómo se calcula el total»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:
cost: precio del recurso convertido a la moneda del costo unitario concost = precio * valor de la moneda del recurso / coin_value.cost_utility: utilidad por unidad, en monto. La envía el cliente; siitems_utility_individualdel costo unitario es falso, se ignora y se calcula comocost * cost_utility_percentage / 100con el porcentaje del costo unitario.cost_utility_percentage = cost_utility / cost * 100(0 si el costo es 0).price = cost + cost_utility.total_cost = cost * quantity,total = price * quantityytotal_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.
Relaciones
Sección titulada «Relaciones»| 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.
Búsqueda
Sección titulada «Búsqueda»La búsqueda de texto (search) combina búsqueda de texto completo sobre search_keywords con coincidencia parcial en name y code.
Estados
Sección titulada «Estados»El estado usa ModelStatusEnum. Un costo unitario nuevo queda en activo; al eliminarlo pasa a eliminado.
