Ir al contenido

Disponer un sobrante de la liquidación

POST/api/project-liquidations/{id}/dispose

Registra una disposición de sobrante en una liquidación en progreso. Valida que la cantidad no supere el stock del producto en el almacén temporal y genera el movimiento de kardex correspondiente: gift_out para donación, sale_out para venta y transfer_out más transfer_in en el almacén de destino para transferencia. Crea una línea de la liquidación con el costo promedio vigente y devuelve esa línea con 200.

idintegerobligatorio

Identificador de una liquidación.

product_idintegerobligatorio

Producto a disponer. Debe existir. Mensaje: El producto a disponer es obligatorio.

disposal_typestringobligatorio

Tipo de disposición: sale, donation o transfer. Mensaje: El tipo de disposición es obligatorio.

quantitynumberobligatorio

Cantidad a disponer. Debe ser mayor a 0 y no superar el stock del almacén. Mensajes: La cantidad a disponer debe ser mayor a cero. y, si excede el stock, La cantidad a disponer (…) supera el stock disponible (…) del producto #….

location_idinteger

Ubicación del almacén de la que sale el producto. Debe existir. Si no se envía, se toma el saldo sin ubicación.

notesstringcondicional

Nota de justificación. Obligatoria si disposal_type es donation. Mensaje: La nota de justificación es obligatoria para disponer por donación.

sale_pricenumber

Precio de venta. Mínimo 0. Solo se guarda si disposal_type es sale.

destination_warehouse_idintegercondicional

Almacén de destino. Obligatorio si disposal_type es transfer y distinto del almacén temporal. Mensaje: El almacén de destino es obligatorio para disponer por transferencia.

Depende del tipo de disposición, y se comprueba en el servicio (no con la política): inventory.liquidation.dispose-sale, inventory.liquidation.dispose-donation o inventory.liquidation.dispose-transfer. Si falta, responde 422 con No tiene permiso para esta disposición de liquidación.

La liquidación debe estar en in_progress; si no, responde 422 con Solo se pueden disponer sobrantes de una liquidación en progreso.

Ventana de terminal
curl -X POST \
"https://servererp.allendostmen.app/api/project-liquidations/2/dispose" \
-H "Authorization: Bearer $TOKEN" \
-H "Accept: application/json" \
-H "Content-Type: application/json" \
-d '{
"product_id": 15,
"disposal_type": "donation",
"quantity": 4,
"notes": "Sobrante entregado a la comunidad"
}'
Línea de disposición creada200
{
"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
}
No encontrado404
{
"message": "No query results for model [App\\Models\\ProjectLiquidation] 99"
}
Datos no válidos422
{
"message": "La nota de justificación es obligatoria para disponer por donación.",
"errors": {
"notes": [
"La nota de justificación es obligatoria para disponer por donación."
]
}
}