Disponer un sobrante de la liquidación
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.
Parámetros de la ruta
Sección titulada «Parámetros de la ruta»idintegerobligatorioIdentificador de una liquidación.
Parámetros del cuerpo
Sección titulada «Parámetros del cuerpo»product_idintegerobligatorioProducto a disponer. Debe existir. Mensaje: El producto a disponer es obligatorio.
disposal_typestringobligatorioTipo de disposición: sale, donation o transfer. Mensaje: El tipo de disposición es obligatorio.
quantitynumberobligatorioCantidad 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_idintegerUbicación del almacén de la que sale el producto. Debe existir. Si no se envía, se toma el saldo sin ubicación.
notesstringcondicionalNota de justificación. Obligatoria si disposal_type es donation. Mensaje: La nota de justificación es obligatoria para disponer por donación.
sale_pricenumberPrecio de venta. Mínimo 0. Solo se guarda si disposal_type es sale.
destination_warehouse_idintegercondicionalAlmacé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.
Permiso
Sección titulada «Permiso»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.
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"}'const response = await fetch( "https://servererp.allendostmen.app/api/project-liquidations/2/dispose", { method: "POST", headers: { Authorization: `Bearer ${token}`, Accept: "application/json", "Content-Type": "application/json", }, body: JSON.stringify({ product_id: 15, disposal_type: "donation", quantity: 4, notes: "Sobrante entregado a la comunidad", }), },);const data = await response.json();use Illuminate\Support\Facades\Http;
$response = Http::withToken($token) ->acceptJson() ->post('https://servererp.allendostmen.app/api/project-liquidations/2/dispose', [ 'product_id' => 15, 'disposal_type' => 'donation', 'quantity' => 4, 'notes' => 'Sobrante entregado a la comunidad', ]);{ "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}{ "message": "No query results for model [App\\Models\\ProjectLiquidation] 99"}{ "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." ] }}