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 |
El objeto ProjectLiquidationItem
Sección titulada «El objeto ProjectLiquidationItem»Atributos
Sección titulada «Atributos»idintegerIdentificador de la línea.
project_liquidation_idintegerLiquidación a la que pertenece la línea.
product_idintegerProducto dispuesto.
disposal_typestringTipo de disposición (DisposalTypeEnum): sale, donation o transfer.
quantity_systemnumberStock del producto en el almacén temporal al momento de disponer.
quantity_liquidatednumberCantidad dispuesta.
unit_costnumberCosto promedio vigente del producto al disponer.
total_costnumberCantidad dispuesta por costo unitario.
sale_pricenumberPrecio de venta. Solo se llena en disposiciones de tipo sale cuando se envía.
destination_warehouse_idintegerAlmacén de destino. Solo se llena en transferencias.
sale_reference_typestringTipo del documento de venta asociado. El código actual no lo llena.
sale_reference_idintegerIdentificador del documento de venta asociado. El código actual no lo llena.
movement_idintegerMovimiento de kardex generado por la disposición.
notesstringNota de justificación. Es obligatoria en las donaciones.
statusstringEstado del registro (ModelStatusEnum).
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, "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}Cómo se crea
Sección titulada «Cómo se crea»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).
Relaciones
Sección titulada «Relaciones»| 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 |
