Ir al contenido

QuotationItem

Un ítem de cotización es un nodo del árbol de la cotización: puede ser un título (simple), una partida con costo unitario o una partida sin costo unitario. Los títulos agrupan a sus hijos con parent_quotation_item_id.

Modelo App\Models\QuotationItem
Tabla quotation_items
idinteger

Identificador del ítem.

quotation_idinteger

Cotización a la que pertenece.

parent_quotation_item_idinteger

Ítem padre (un título). Es nulo en el primer nivel.

unit_cost_idinteger

Costo unitario del ítem. Solo lo tienen los ítems de tipo costo unitario.

provider_product_idinteger

Producto de proveedor, para un ítem sin costo unitario.

measurement_unit_idinteger

Unidad de medida.

coin_idinteger

Moneda del ítem.

coin_valuenumber

Valor de la moneda del ítem.

typestring

Tipo del ítem (QuotationItemType): simple, costo unitario o sin costo unitario.

namestring

Nombre del ítem.

descriptionstring

Descripción del ítem.

costnumber

Costo unitario.

cost_utilitynumber

Utilidad unitaria.

cost_utility_percentagenumber

Porcentaje de utilidad sobre el costo.

pricenumber

Precio unitario: costo más utilidad.

quantitynumber

Cantidad.

total_costnumber

Costo total: costo por cantidad.

total_cost_utilitynumber

Utilidad total del ítem.

totalnumber

Total del ítem: precio por cantidad.

indexinteger

Posición entre sus hermanos. No es único dentro de la cotización.

levelinteger

Nivel en el árbol. El primer nivel es 1.

statusstring

Estado del registro (ModelStatusEnum).

previous_statusstring

Estado anterior. Lo llena el sistema al cambiar el 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 QuotationItem200
{
"id": 302,
"quotation_id": 1520,
"parent_quotation_item_id": 301,
"unit_cost_id": 88,
"measurement_unit_id": 4,
"type": "costo unitario",
"name": "Tendido de cable",
"description": null,
"cost": 4.2,
"cost_utility": 0.3,
"cost_utility_percentage": 7.1429,
"price": 4.5,
"quantity": 120,
"total_cost": 504,
"total_cost_utility": 36,
"total": 540,
"index": 1,
"level": 2,
"status": "activo",
"create_user_id": 5,
"created_at": "2026-11-19T10:40:15.000000Z",
"updated_at": "2026-11-19T10:40:15.000000Z",
"deleted_at": null
}
Relación Tipo Modelo
quotation belongsTo Quotation
children hasMany QuotationItem
providerProduct belongsTo ProviderProduct
measurementUnit belongsTo MeasurementUnit
unitCost belongsTo UnitCost
Scope Qué filtra
quotationId Por cotización.
projectId Por el proyecto de la cotización.
ifType Por tipo de ítem.

Campos permitidos para ordenar: id, name, created_at, updated_at, status. La búsqueda de texto (search) compara con name y description.

Valor Significado
simple Título o subtítulo. No tiene costo; su total suma el de sus hijos.
costo unitario Partida enlazada a un costo unitario.
sin costo unitario Partida directa.