QuotationOverhead
Un gasto general de cotización es un costo indirecto de una cotización, organizado en un árbol de títulos y gastos.
| Modelo | App\Models\QuotationOverhead |
| Tabla | quotation_overheads |
El objeto QuotationOverhead
Sección titulada «El objeto QuotationOverhead»Atributos
Sección titulada «Atributos»idintegerIdentificador del gasto general.
quotation_idintegerCotización (Quotation) a la que pertenece. Si se indica un padre, se toma la del padre.
quotation_overhead_parent_idintegerTítulo o gasto padre. Es nulo en los elementos de primer nivel.
namestringNombre del título o del gasto.
descriptionstringDescripción. Es rellenable, pero los endpoints de crear y actualizar no la validan.
is_titlebooleanIndica si el registro es un título (agrupador) o un gasto.
typestringTipo del gasto (QuotationOverheadTypeEnum): fijo o variable.
measurement_unit_idintegerUnidad de medida (MeasurementUnit). Es nula en los títulos.
costnumberCosto unitario.
cost_utilitynumberUtilidad unitaria sobre el costo.
cost_utility_percentagenumberPorcentaje de utilidad. Lo calcula el servidor.
participation_percentagenumberPorcentaje de participación, hasta 100.
resourcenumberRecurso: multiplicador de la cantidad.
quantitynumberCantidad.
quantity_calculatednumberCantidad resultante de combinar cantidad, recurso y participación. Lo calcula el servidor.
amountnumberCosto más utilidad. Lo calcula el servidor.
pricenumberPrecio unitario: costo más utilidad. Lo calcula el servidor.
total_costnumberCosto total. Lo calcula el servidor.
totalnumberTotal a precio de venta. Lo calcula el servidor.
total_cost_utilitynumberUtilidad total: total menos costo total. Lo calcula el servidor.
indexintegerPosición del registro. Lo asigna el servidor al crear y lo reescriben los endpoints de ordenar y mover.
levelintegerNivel de anidación: 1 en primer nivel y el del padre más uno en los demás.
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.
restored_atdatetimeFecha de la última restauración.
created_atdatetimeFecha de creación.
updated_atdatetimeFecha de la última modificación.
deleted_atdatetimeFecha de eliminación lógica.
{ "id": 31, "quotation_id": 15, "quotation_overhead_parent_id": 30, "name": "Alquiler de oficina", "description": null, "is_title": false, "type": "fijo", "cost": 1500, "cost_utility": 300, "cost_utility_percentage": 20, "participation_percentage": 100, "measurement_unit_id": 5, "amount": 1800, "price": 1800, "quantity": 6, "resource": 1, "quantity_calculated": 6, "total_cost": 9000, "total_cost_utility": 1800, "total": 10800, "index": 1, "level": 2, "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, "restored_at": null, "created_at": "2026-11-19T10:40:15.000000Z", "updated_at": "2026-11-19T10:40:15.000000Z", "deleted_at": null}Papel dentro de la cotización
Sección titulada «Papel dentro de la cotización»Un gasto general de cotización es un costo indirecto de una cotización (alquileres, personal administrativo y similares). Los registros forman un árbol: los títulos (is_title verdadero) agrupan gastos y otros títulos mediante quotation_overhead_parent_id, y cada gasto lleva costo, utilidad, cantidad, recurso y participación. Pertenece a una Quotation y, opcionalmente, a una MeasurementUnit.
A diferencia de los demás modelos de esta sección, no se relaciona con QuotationItem, Product ni Provider, y no tiene tabla de compras asociada: el código no define ninguna clave hacia ellos.
El servidor calcula cost_utility_percentage, amount, price, quantity_calculated, total_cost, total y total_cost_utility al crear y al actualizar (clase QuotationOverheadUtils, con los decimales de la cotización). El observador QuotationOverheadObserver recalcula, al crear, actualizar, eliminar y restaurar un gasto que no sea título, los totales de gastos fijos y variables de la cotización (QuotationController::updateTotalOverheads2) y deja un registro en el historial de la cotización.
Relaciones
Sección titulada «Relaciones»| Relación | Tipo | Modelo |
|---|---|---|
quotation |
belongsTo | Quotation |
quotationOverheadParent |
belongsTo | QuotationOverhead |
measurementUnit |
belongsTo | MeasurementUnit |
children |
hasMany | QuotationOverhead (por quotation_overhead_parent_id) |
El modelo no define $allowedRelations (está comentado), por lo que relations admite cualquier relación del modelo.
| Scope | Parámetro de consulta | Efecto |
|---|---|---|
scopeQuotationId |
quotation_id |
Solo los registros de esa cotización. |
scopeIfType |
type |
Solo los registros de ese tipo (fijo o variable). |
type:QuotationOverheadTypeEnum(fijo,variable).status:ModelStatusEnum.
El modelo no define $orderFields: rige la lista por defecto (id, name, created_at, updated_at, status). Para el orden jerárquico se usa index, que se gestiona con el endpoint de ordenar.
Endpoints
Sección titulada «Endpoints»Hay rutas para listar, crear, obtener, actualizar, eliminar, restaurar, ordenar y mover. La ruta GET /api/quotation-overheads/{cotizationId}/all apunta a un método getAll que no existe en el controlador, por lo que no se documenta.
