Ir al contenido

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
idinteger

Identificador del gasto general.

quotation_idinteger

Cotización (Quotation) a la que pertenece. Si se indica un padre, se toma la del padre.

quotation_overhead_parent_idinteger

Título o gasto padre. Es nulo en los elementos de primer nivel.

namestring

Nombre del título o del gasto.

descriptionstring

Descripción. Es rellenable, pero los endpoints de crear y actualizar no la validan.

is_titleboolean

Indica si el registro es un título (agrupador) o un gasto.

typestring

Tipo del gasto (QuotationOverheadTypeEnum): fijo o variable.

measurement_unit_idinteger

Unidad de medida (MeasurementUnit). Es nula en los títulos.

costnumber

Costo unitario.

cost_utilitynumber

Utilidad unitaria sobre el costo.

cost_utility_percentagenumber

Porcentaje de utilidad. Lo calcula el servidor.

participation_percentagenumber

Porcentaje de participación, hasta 100.

resourcenumber

Recurso: multiplicador de la cantidad.

quantitynumber

Cantidad.

quantity_calculatednumber

Cantidad resultante de combinar cantidad, recurso y participación. Lo calcula el servidor.

amountnumber

Costo más utilidad. Lo calcula el servidor.

pricenumber

Precio unitario: costo más utilidad. Lo calcula el servidor.

total_costnumber

Costo total. Lo calcula el servidor.

totalnumber

Total a precio de venta. Lo calcula el servidor.

total_cost_utilitynumber

Utilidad total: total menos costo total. Lo calcula el servidor.

indexinteger

Posición del registro. Lo asigna el servidor al crear y lo reescriben los endpoints de ordenar y mover.

levelinteger

Nivel de anidación: 1 en primer nivel y el del padre más uno en los demás.

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.

restored_atdatetime

Fecha de la última restauración.

created_atdatetime

Fecha de creación.

updated_atdatetime

Fecha de la última modificación.

deleted_atdatetime

Fecha de eliminación lógica.

El objeto QuotationOverhead200
{
"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
}

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.

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.

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.