Ir al contenido

Subcontract

Un subcontrato es un servicio que se contrata a terceros y se usa en el análisis de costos unitarios. Cada subcontrato tiene uno o más proveedores con su precio. Es el catálogo de la pantalla Subcontratos de la configuración de Ventas.

Modelo App\Models\Subcontract
Tabla subcontracts
idinteger

Identificador del subcontrato.

namestring

Nombre del subcontrato.

descriptionstring

Descripción. Es opcional.

pricenumber

Precio de referencia. La API no lo recibe al crear: el precio real está en cada proveedor del subcontrato.

codestring

Código correlativo de cuatro dígitos. Lo genera el servidor al crear.

unified_index_idinteger

Índice unificado. Es opcional.

measurement_unit_idinteger

Unidad de medida.

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.

created_atdatetime

Fecha de creación.

updated_atdatetime

Fecha de la última modificación.

deleted_atdatetime

Fecha de eliminación lógica.

El objeto Subcontract200
{
"id": 1,
"name": "Instalación de tablero eléctrico",
"description": null,
"price": null,
"code": "0001",
"unified_index_id": null,
"measurement_unit_id": 4,
"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,
"created_at": "2026-11-19T10:40:15.000000Z",
"updated_at": "2026-11-19T10:40:15.000000Z",
"deleted_at": null
}
Relación Tipo Modelo
measurementUnit belongsTo MeasurementUnit
unifiedIndex belongsTo UnifiedIndex
subcontractProviders hasMany SubcontractProvider
subcontractUnitCostCategories hasMany SubcontractUnitCostCategory
unitCostSubcontracts hasMany UnitCostSubcontract
unitCostCategory belongsTo UnitCostCategory

Además, BaseModelTrait agrega createUser, updateUser, deleteUser y restoreUser (belongsTo User).

La relación unitCostCategory existe en el modelo, pero la tabla subcontracts no tiene la columna unit_cost_category_id. Las categorías de costo unitario se guardan en la tabla subcontract_unit_cost_categories y se envían con subcontract_unit_cost_categories.

SubcontractController::index agrega los filtros not_in_unit_cost_id y unit_cost_category_id. Los detalla la página Listar subcontratos.

Campos permitidos para ordenar: id, name, price, status, created_at, updated_at.

La búsqueda de texto (search) compara con las columnas name, code y price.

El estado usa ModelStatusEnum. Un subcontrato nuevo queda en activo; al eliminarlo pasa a eliminado.

Los proveedores se guardan en SubcontractProvider (ver SubcontractProvider). Al crear un subcontrato se envían en subcontract_providers.