Saltar al contenido
Facturador

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.
  • 200 con success: false y message: 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.