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 |
El objeto QuotationMaterial
Sección titulada «El objeto QuotationMaterial»Atributos
Sección titulada «Atributos»idintegerIdentificador del material de la cotización.
quotation_idintegerCotización (Quotation) a la que pertenece la línea.
provider_product_idintegerProducto de proveedor (ProviderProduct) del que sale el precio. Es el vínculo con el proveedor.
product_idintegerProducto (Product) del catálogo. Se copia del producto de proveedor al crear la línea.
parent_idintegerMaterial padre, si la línea cuelga de otra (relación consigo misma).
pricenumberPrecio unitario, tomado del producto de proveedor al crear la línea.
coinstringMoneda (CoinEnum): soles o dólares. Las líneas se crean en dólares.
quantitynumberCantidad total proyectada del material.
buy_quantitynumberCantidad ya comprada. Por defecto 0.
is_not_projectedbooleanIndica que la línea se añadió después, fuera de lo proyectado en la cotización.
quantity_not_projectedintegerCantidad adicional no proyectada. Por defecto 0.
justification_not_projectedstringJustificación de por qué el material no se proyectó.
justification_quantity_not_projectedstringJustificación de por qué la cantidad no se proyectó.
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": 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}Papel dentro de la cotización
Sección titulada «Papel dentro de la cotización»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).
Relaciones
Sección titulada «Relaciones»| 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.
Endpoints
Sección titulada «Endpoints»Hay rutas para listar, obtener, eliminar, crear no proyectado y actualizar la cantidad no proyectada. No existe ruta de restaurar.
