Ir al contenido

QuotationSubcontract

Un subcontrato de cotización es una línea de servicios subcontratados de una cotización, ligada a un subcontrato del catálogo.

Modelo App\Models\QuotationSubcontract
Tabla quotation_subcontracts
idinteger

Identificador del subcontrato de la cotización.

quotation_idinteger

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

subcontract_idinteger

Subcontrato del catálogo (Subcontract) que se cotiza.

parent_idinteger

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

pricenumber

Precio unitario. Al crear una línea no proyectada se toma del subcontrato del catálogo.

coinstring

Moneda (CoinEnum): soles o dólares. Por defecto soles.

quantitynumber

Cantidad total del subcontrato. La columna es de texto y el modelo la convierte a número.

buy_quantitynumber

Cantidad ya comprada. Por defecto 0. La columna es de texto y el modelo la convierte a número.

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 subcontrato 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 QuotationSubcontract200
{
"id": 6,
"quotation_id": 15,
"subcontract_id": 9,
"parent_id": null,
"price": 2500,
"coin": "soles",
"quantity": 2,
"buy_quantity": 0,
"is_not_projected": false,
"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 subcontrato de cotización es una línea de servicios subcontratados de una cotización: indica qué subcontrato del catálogo (Subcontract) se contrata, en qué cantidad y a qué precio. Pertenece a una Quotation. No apunta a Product: el subcontrato es un servicio, no un producto. El proveedor sale de subcontract.provider_id y de las asignaciones de QuotationSubcontractProvider; la compra se registra en QuotationSubcontractBuy.

Las líneas se crean con Crear o como no proyectadas con Crear subcontrato no proyectado. El método generateSubcontractsFromQuotation que menciona un comentario de QuotationWorkflowController no existe en el controlador actual.

Relación Tipo Modelo
quotation belongsTo Quotation
subcontract belongsTo Subcontract
children hasMany QuotationSubcontract (por parent_id)
quotationSubcontractProviders hasMany QuotationSubcontractProvider

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 Está escrito sobre una relación quotation_provider que el modelo no define.
  • 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, crear, obtener, actualizar, eliminar, crear no proyectado y actualizar la cantidad no proyectada. La ruta de restaurar no existe como tal: el controlador tiene un método restore, pero no hay ruta que lo exponga.