Ir al contenido

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
idinteger

Identificador del registro de compra.

quotation_material_idinteger

Material de cotización (QuotationMaterial) que se compró.

provider_product_idinteger

Producto de proveedor (ProviderProduct) comprado.

purchase_order_item_idinteger

Ítem de la orden de compra (PurchaseOrderItem) que originó la compra. Es opcional.

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 QuotationMaterialBuy200
{
"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
}

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.

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.

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.