QuotationMaterialBuy
Una compra de material enlaza un material de cotización con el ítem de la orden de compra con el que se compró.
| Modelo | App\Models\QuotationMaterialBuy |
| Tabla | quotation_material_buys |
El objeto QuotationMaterialBuy
Sección titulada «El objeto QuotationMaterialBuy»Atributos
Sección titulada «Atributos»idintegerIdentificador del registro de compra.
quotation_material_idintegerMaterial de cotización (QuotationMaterial) que se compró.
provider_product_idintegerProducto de proveedor (ProviderProduct) comprado.
purchase_order_item_idintegerÍtem de la orden de compra (PurchaseOrderItem) que originó la compra. Es opcional.
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": 3, "quotation_material_id": 8, "provider_product_id": 42, "purchase_order_item_id": 77, "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»Una compra de material enlaza un material de cotización con el ítem de orden de compra con el que se compró. Es el rastro de la compra: quotationMaterial lleva a la línea de la cotización (y desde ella a Quotation), providerProduct al producto de proveedor (y desde él a Provider y Product) y purchaseOrderItem al ítem de la orden de compra. La columna purchase_order_item_id quedó sin clave foránea en la fase 0 de Compras V2 y una migración posterior (2026_07_14_097000) la apunta a purchase_order_items con borrado a nulo.
Las solicitudes de crear y actualizar están bloqueadas por sus FormRequest (authorize devuelve falso), por lo que este modelo no se escribe por la API; se documentan en Crear y Actualizar con ese estado.
Relaciones
Sección titulada «Relaciones»| Relación | Tipo | Modelo |
|---|---|---|
quotationMaterial |
belongsTo | QuotationMaterial |
providerProduct |
belongsTo | ProviderProduct |
purchaseOrderItem |
belongsTo | PurchaseOrderItem |
El modelo no define $allowedRelations (está comentado), por lo que relations admite cualquier relación del modelo.
scopequotationId (con el nombre escrito así en el código) filtraría por la cotización del material, pero el controlador no lo invoca: el listado no tiene el parámetro quotation_id.
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 y eliminar. Crear y actualizar responden siempre 403. La ruta PUT /api/quotation-material-buy/restore está registrada sin identificador y después de la ruta de actualizar, por lo que esa ruta la atiende primero; no se documenta como endpoint de restaurar.
