Ir al contenido

QuotationMaterial

Un material de cotización es una línea consolidada de materiales de una cotización, ligada a un producto de proveedor.

Modelo App\Models\QuotationMaterial
Tabla quotation_materials
idinteger

Identificador del material de la cotización.

quotation_idinteger

Cotización (Quotation) a la que pertenece la línea.

provider_product_idinteger

Producto de proveedor (ProviderProduct) del que sale el precio. Es el vínculo con el proveedor.

product_idinteger

Producto (Product) del catálogo. Se copia del producto de proveedor al crear la línea.

parent_idinteger

Material padre, si la línea cuelga de otra (relación consigo misma).

pricenumber

Precio unitario, tomado del producto de proveedor al crear la línea.

coinstring

Moneda (CoinEnum): soles o dólares. Las líneas se crean en dólares.

quantitynumber

Cantidad total proyectada del material.

buy_quantitynumber

Cantidad ya comprada. Por defecto 0.

is_not_projectedboolean

Indica que la línea se añadió después, fuera de lo proyectado en la cotización.

quantity_not_projectedinteger

Cantidad adicional no proyectada. Por defecto 0.

justification_not_projectedstring

Justificación de por qué el material no se proyectó.

justification_quantity_not_projectedstring

Justificación de por qué la cantidad no se proyectó.

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 QuotationMaterial200
{
"id": 8,
"parent_id": null,
"quotation_id": 15,
"provider_product_id": 42,
"product_id": 30,
"quantity": 12.5,
"price": 18.9,
"coin": "dólares",
"is_not_projected": false,
"buy_quantity": 0,
"quantity_not_projected": 0,
"justification_not_projected": null,
"justification_quantity_not_projected": null,
"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 material de cotización es una línea consolidada de materiales de una cotización: indica qué producto de proveedor hay que comprar para el proyecto, en qué cantidad total (quantity), a qué precio y cuánto se lleva comprado (buy_quantity). Pertenece a una Quotation; el producto de proveedor (ProviderProduct) aporta el precio y, a través de providerProduct.provider, el proveedor; product_id apunta al Product del catálogo.

Las líneas nacen de dos maneras: el método estático QuotationMaterialController::generateMaterialsFromQuotation crea las filas a partir de los materiales de los ítems de la cotización (la llamada desde QuotationWorkflowController está comentada en el código actual), o se añade una línea no proyectada con Crear material no proyectado. La ruta POST /api/quotation-material y la de actualizar no están registradas: el recurso excluye store y update.

El avance de compra se registra en QuotationMaterialProvider (cantidad asignada a cada proveedor) y QuotationMaterialBuy (vínculo con el ítem de la orden de compra).

Relación Tipo Modelo
quotation belongsTo Quotation
providerProduct belongsTo ProviderProduct
product belongsTo Product
children hasMany QuotationMaterial (por parent_id)
quotationMaterialProviders hasMany QuotationMaterialProvider

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 las líneas de esa cotización.
scopeProjectId project_id Solo las líneas cuya cotización pertenece a ese proyecto.
scopeIsNotProjected is_not_projected true o false filtra por la columna is_not_projected.
scopeWithoutChildren without_children Con un valor verdadero, solo las líneas sin padre (parent_id nulo).
scopeProviderId No se usa en el controlador Filtraría por el proveedor del producto de proveedor.
  • coin: CoinEnum (soles, dólares).
  • status: ModelStatusEnum.

El modelo no define $orderFields: rige la lista por defecto (id, name, created_at, updated_at, status). La tabla no tiene name.

Hay rutas para listar, obtener, eliminar, crear no proyectado y actualizar la cantidad no proyectada. No existe ruta de restaurar.