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 |
El objeto QuotationItem
Sección titulada «El objeto QuotationItem»Atributos
Sección titulada «Atributos»idintegerIdentificador del ítem.
quotation_idintegerCotización a la que pertenece.
parent_quotation_item_idintegerÍtem padre (un título). Es nulo en el primer nivel.
unit_cost_idintegerCosto unitario del ítem. Solo lo tienen los ítems de tipo costo unitario.
provider_product_idintegerProducto de proveedor, para un ítem sin costo unitario.
measurement_unit_idintegerUnidad de medida.
coin_idintegerMoneda del ítem.
coin_valuenumberValor de la moneda del ítem.
typestringTipo del ítem (QuotationItemType): simple, costo unitario o sin costo unitario.
namestringNombre del ítem.
descriptionstringDescripción del ítem.
costnumberCosto unitario.
cost_utilitynumberUtilidad unitaria.
cost_utility_percentagenumberPorcentaje de utilidad sobre el costo.
pricenumberPrecio unitario: costo más utilidad.
quantitynumberCantidad.
total_costnumberCosto total: costo por cantidad.
total_cost_utilitynumberUtilidad total del ítem.
totalnumberTotal del ítem: precio por cantidad.
indexintegerPosición entre sus hermanos. No es único dentro de la cotización.
levelintegerNivel en el árbol. El primer nivel es 1.
statusstringEstado del registro (ModelStatusEnum).
previous_statusstringEstado anterior. Lo llena el sistema al cambiar el 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": 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}Relaciones
Sección titulada «Relaciones»| 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. |
Orden y búsqueda
Sección titulada «Orden y búsqueda»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. |
