ProjectLiquidation
Una liquidación de proyecto es la cabecera del cierre del almacén temporal de un proyecto: registra cómo se disponen los sobrantes (venta, donación o transferencia) hasta dejar el almacén en cero. Pertenece al módulo de inventario.
| Modelo | App\Models\ProjectLiquidation |
| Tabla | project_liquidations |
El objeto ProjectLiquidation
Sección titulada «El objeto ProjectLiquidation»Atributos
Sección titulada «Atributos»idintegerIdentificador de la liquidación.
codestringCódigo correlativo (LIQ-0001, LIQ-0002…). Lo genera el sistema al iniciar.
project_idintegerProyecto liquidado. Sale del almacén temporal.
warehouse_idintegerAlmacén temporal de proyecto que se liquida.
liquidation_statusstringEstado del flujo: in_progress, completed o cancelled.
started_atdatetimeFecha de inicio de la liquidación.
completed_atdatetimeFecha de cierre. Se llena al completar.
total_itemsnumberCantidad de líneas de disposición. Se llena al completar.
total_quantitynumberSuma de las cantidades dispuestas. Se llena al completar.
total_valuenumberSuma de los costos totales de las líneas. Se llena al completar.
approved_atdatetimeFecha de aprobación. Ningún endpoint la llena.
approved_by_user_idintegerUsuario que aprobó. Ningún endpoint lo llena.
notesstringNotas de la liquidación. Ningún endpoint las recibe.
statusstringEstado genérico del registro (ModelStatusEnum). Es independiente de liquidation_status.
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": 2, "code": "LIQ-0002", "project_id": 1, "warehouse_id": 6, "liquidation_status": "in_progress", "started_at": "2026-11-19T10:40:15.000000Z", "completed_at": null, "total_items": null, "total_quantity": null, "total_value": null, "approved_at": null, "approved_by_user_id": null, "notes": 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, "created_at": "2026-11-19T10:40:15.000000Z", "updated_at": "2026-11-19T10:40:15.000000Z", "deleted_at": null}Flujo de estados
Sección titulada «Flujo de estados»liquidation_status usa ProjectLiquidationStatusEnum:
| Valor | Significado |
|---|---|
in_progress |
La liquidación está abierta y acepta disposiciones. Es el estado inicial. |
completed |
La liquidación se cerró con todo el stock dispuesto. |
cancelled |
La liquidación se canceló antes de registrar disposiciones. |
Solo se sale de in_progress: no hay transiciones desde completed ni cancelled. Las liquidaciones no se crean con un POST genérico, sino con Iniciar liquidación. Los tipos de disposición de cada línea (DisposalTypeEnum) son sale, donation y transfer; ver ProjectLiquidationItem.
Relaciones
Sección titulada «Relaciones»El modelo no define allowedRelations: se admite cualquier relación pública, salvo tokens y notifications.
| Relación | Tipo | Modelo |
|---|---|---|
project |
belongsTo | Project |
warehouse |
belongsTo | Warehouse |
items |
hasMany | ProjectLiquidationItem |
approvedBy |
belongsTo | User |
createUser, updateUser, deleteUser, restoreUser |
belongsTo | User |
| Scope | Qué hace |
|---|---|
scopeWhenLiquidationStatus |
Filtra por liquidation_status |
scopeWhenProjectId |
Filtra por project_id |
scopeWhenWarehouseId |
Filtra por warehouse_id |
El modelo no define orderFields, así que rigen los campos por defecto: id, name, created_at, updated_at, status. La tabla no tiene la columna name, así que no uses ese campo. El orden por defecto es id|DESC.
Búsqueda
Sección titulada «Búsqueda»search compara con las columnas code y notes.
Conteos
Sección titulada «Conteos»El modelo no define allowedCountRelations: count_relations no tiene efecto.
