Ir al contenido

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
idinteger

Identificador de la liquidación.

codestring

Código correlativo (LIQ-0001, LIQ-0002…). Lo genera el sistema al iniciar.

project_idinteger

Proyecto liquidado. Sale del almacén temporal.

warehouse_idinteger

Almacén temporal de proyecto que se liquida.

liquidation_statusstring

Estado del flujo: in_progress, completed o cancelled.

started_atdatetime

Fecha de inicio de la liquidación.

completed_atdatetime

Fecha de cierre. Se llena al completar.

total_itemsnumber

Cantidad de líneas de disposición. Se llena al completar.

total_quantitynumber

Suma de las cantidades dispuestas. Se llena al completar.

total_valuenumber

Suma de los costos totales de las líneas. Se llena al completar.

approved_atdatetime

Fecha de aprobación. Ningún endpoint la llena.

approved_by_user_idinteger

Usuario que aprobó. Ningún endpoint lo llena.

notesstring

Notas de la liquidación. Ningún endpoint las recibe.

statusstring

Estado genérico del registro (ModelStatusEnum). Es independiente de liquidation_status.

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

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.

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.

search compara con las columnas code y notes.

El modelo no define allowedCountRelations: count_relations no tiene efecto.