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 |
El objeto Subcontract
Sección titulada «El objeto Subcontract»Atributos
Sección titulada «Atributos»idintegerIdentificador del subcontrato.
namestringNombre del subcontrato.
descriptionstringDescripción. Es opcional.
pricenumberPrecio de referencia. La API no lo recibe al crear: el precio real está en cada proveedor del subcontrato.
codestringCódigo correlativo de cuatro dígitos. Lo genera el servidor al crear.
unified_index_idintegerÍndice unificado. Es opcional.
measurement_unit_idintegerUnidad de medida.
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.
created_atdatetimeFecha de creación.
updated_atdatetimeFecha de la última modificación.
deleted_atdatetimeFecha de eliminación lógica.
{ "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}Relaciones
Sección titulada «Relaciones»| 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.
Filtros propios
Sección titulada «Filtros propios»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.
Búsqueda
Sección titulada «Búsqueda»La búsqueda de texto (search) compara con las columnas name, code y price.
Estados
Sección titulada «Estados»El estado usa ModelStatusEnum. Un subcontrato nuevo queda en activo; al eliminarlo pasa a eliminado.
Proveedores del subcontrato
Sección titulada «Proveedores del subcontrato»Los proveedores se guardan en SubcontractProvider (ver SubcontractProvider). Al crear un subcontrato se envían en subcontract_providers.
