# Movement

## Moves product stock between locations within a store.

**post** `/api/v2/public/stores/{store_number}/storeproductlocation/movement`

Deprecated. Moves product stock between two locations within a single store.

### Path Parameters

- `store_number: string`

### Query Parameters

- `AppUserName: optional string`

  The app user performing the movement.

### Body Parameters

- `body: optional array of object { quantity, allow_overage, from_location, 5 more }`

  - `quantity: number`

    The quantity to move.

  - `allow_overage: optional boolean`

    Whether to allow moving more than available stock.

  - `from_location: optional object { customer_order_line_number, customer_order_number, customer_order_shipment_line_number, 3 more }`

    The source location for the product movement.

    - `customer_order_line_number: optional number`

      The customer order line number at the source.

    - `customer_order_number: optional string`

      The customer order number at the source.

    - `customer_order_shipment_line_number: optional number`

      The customer order shipment line number at the source.

    - `customer_order_shipment_number: optional string`

      The customer order shipment number at the source.

    - `location_code: optional string`

      The source location code.

    - `stock_pool: optional number`

      The stock pool at the source location.

  - `product_number: optional string`

    The product number to move.

  - `reason_code: optional string`

    The reason code for the movement.

  - `reference: optional string`

    A reference identifier for the movement.

  - `source: optional string`

    The source system initiating the movement.

  - `to_location: optional object { customer_order_line_number, customer_order_number, customer_order_shipment_line_number, 3 more }`

    The destination location for the product movement.

    - `customer_order_line_number: optional number`

      The customer order line number at the destination.

    - `customer_order_number: optional string`

      The customer order number at the destination.

    - `customer_order_shipment_line_number: optional number`

      The customer order shipment line number at the destination.

    - `customer_order_shipment_number: optional string`

      The customer order shipment number at the destination.

    - `location_code: optional string`

      The destination location code.

    - `stock_pool: optional number`

      The stock pool at the destination location.

### Returns

- `success: boolean`

  Indicates whether the operation completed successfully.

- `data: optional string`

  Optional data payload returned by the operation.

- `message: optional string`

  Human-readable message describing the result.

### Example

```http
curl https://api.colleqtive.net/api/v2/public/stores/$STORE_NUMBER/storeproductlocation/movement \
    -X POST \
    -H "Authorization: $COLLEQTIVE_BEARER_TOKEN"
```

#### Response

```json
{
  "success": true,
  "data": "data",
  "message": "message"
}
```

## Domain Types

### Movement Create Movement Response

- `MovementCreateMovementResponse object { success, data, message }`

  Standard success response returned by mutation endpoints.

  - `success: boolean`

    Indicates whether the operation completed successfully.

  - `data: optional string`

    Optional data payload returned by the operation.

  - `message: optional string`

    Human-readable message describing the result.