Ir al contenido

ProjectLiquidationItem

Una línea de liquidación registra una disposición de sobrante (venta, donación o transferencia) dentro de una liquidación de proyecto, enlazada al movimiento de kardex que la generó.

Modelo App\Models\ProjectLiquidationItem
Tabla project_liquidation_items
idinteger

Identificador de la línea.

project_liquidation_idinteger

Liquidación a la que pertenece la línea.

product_idinteger

Producto dispuesto.

disposal_typestring

Tipo de disposición (DisposalTypeEnum): sale, donation o transfer.

quantity_systemnumber

Stock del producto en el almacén temporal al momento de disponer.

quantity_liquidatednumber

Cantidad dispuesta.

unit_costnumber

Costo promedio vigente del producto al disponer.

total_costnumber

Cantidad dispuesta por costo unitario.

sale_pricenumber

Precio de venta. Solo se llena en disposiciones de tipo sale cuando se envía.

destination_warehouse_idinteger

Almacén de destino. Solo se llena en transferencias.

sale_reference_typestring

Tipo del documento de venta asociado. El código actual no lo llena.

sale_reference_idinteger

Identificador del documento de venta asociado. El código actual no lo llena.

movement_idinteger

Movimiento de kardex generado por la disposición.

notesstring

Nota de justificación. Es obligatoria en las donaciones.

statusstring

Estado del registro (ModelStatusEnum).

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 ProjectLiquidationItem200
{
"id": 1,
"project_liquidation_id": 2,
"product_id": 15,
"disposal_type": "donation",
"quantity_system": "10.00000000",
"quantity_liquidated": "4.00000000",
"unit_cost": "25.50000000",
"total_cost": "102.00000000",
"sale_price": null,
"destination_warehouse_id": null,
"sale_reference_type": null,
"sale_reference_id": null,
"movement_id": 310,
"notes": "Sobrante entregado a la comunidad",
"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
}

Este modelo no tiene controlador ni rutas propias: no hay endpoints para listarlo, crearlo, modificarlo ni eliminarlo. Las líneas se crean solo con Disponer un sobrante y se consultan con la relación items de la liquidación (GET /api/project-liquidations/{id}?relations=items).

Relación Tipo Modelo
liquidation belongsTo ProjectLiquidation (por project_liquidation_id)
product belongsTo Product
destinationWarehouse belongsTo Warehouse
movement belongsTo InventoryMovement
createUser, updateUser, deleteUser, restoreUser belongsTo User
Scope Qué hace
scopeWhenDisposalType Filtra por disposal_type
scopeWhenProjectLiquidationId Filtra por project_liquidation_id

DisposalTypeEnum:

Valor Movimiento de kardex
sale sale_out
donation gift_out
transfer transfer_out en el almacén temporal y transfer_in en el almacén de destino