Trasladar productos entre almacenes
POST /api/inventory/transfer
Autenticación: Bearer del usuario del tenant (Authorization: Bearer <api_token>).
Traslada uno o varios productos de un almacén a otro. Todo el traslado se hace en una sola operación: si un producto falla, no se mueve ninguno.
Quién puede usarlo: cualquier usuario autenticado (administrador o vendedor).
Formato de respuesta: heredado {success, message?, data?} sin paginación. Ante reglas de negocio puede responder HTTP 200 con success: false: revisa siempre success. En el éxito data.items trae el stock resultante en origen y destino de cada producto.
Cuerpo (JSON):
| Campo | Tipo | Obligatorio | Descripción / valores permitidos |
|---|---|---|---|
warehouse_id |
integer | Sí | Almacén de origen. |
warehouse_destination_id |
integer | Sí | Almacén de destino, distinto del origen. |
description |
string | No | Motivo o detalle del traslado (máx. 500). |
items |
array | Sí | [{item_id, quantity}]; quantity > 0. Al menos un producto. |
Reglas:
- La cantidad no puede superar el stock del almacén de origen.
Errores:
422{success: false, message: {campo: [errores]}}si falla la validación de campos.200consuccess: falseymessage: stock insuficiente o producto con lotes/series.
Cuerpo
Content-Type: application/json
{
"warehouse_id": "1",
"warehouse_destination_id": 2,
"description": "Reposición sucursal norte",
"items": [
{
"item_id": "1",
"quantity": 5
}
]
}
Respuestas
200 — Trasladado
{
"success": true,
"data": {
"items": [
{
"item_id": 15,
"quantity": 5.0,
"origin_stock": 20.0,
"destination_stock": 8.0
}
]
},
"message": "Producto trasladado con éxito"
}
200 — Stock insuficiente
{
"success": false,
"message": "Stock insuficiente para GASEOSA 500 ML (disponible: 3)."
}
422 — Mismo almacén
{
"success": false,
"message": {
"warehouse_destination_id": [
"El almacén de destino debe ser distinto al de origen."
]
}
}
Pruébalo
Prueba este endpoint con tu empresa y tu token: elige la URL en Servers, pega el token en Authorize y haz clic en Try it out.