---
title: "BookInStockBatch"
method: POST
path: "/api/Stock/BookInStockBatch"
tags: ["Stock"]
---

# BookInStockBatch

`POST /api/Stock/BookInStockBatch`

## Request

- Base URL: `https://eu-ext.linnworks.net`
- URL: `https://eu-ext.linnworks.net/api/Stock/BookInStockBatch`
- Auth: API key in header `Authorization`

Increases the stock level and current stock value of a batched stock item by the specified quantity
<b>Rate limit: </b><span style="background-color:#0272d9;color:white;padding:4px 8px;text-align:center;border-radius:5px; font-size: small;"><b>150</b></span> / minute

## Request body

- StockBookInStockBatchRequest
  - `stockItem` BatchedBookIn
    - `SKU` string: Product SKU
    - `BatchNumber` string: Batch number
    - `LocationId` string, uuid: Location ID
    - `BinRack` string: Bin rack
    - `Quantity` integer: Quantity booked in
    - `StockValue` number, double: Stock value
    - `BatchStatus` string: Batch status
    - `PrioritySequence` integer
    - `ExpiresOn` string, date-time: Batch expiry date
    - `SellBy` string, date-time: Batch sell by date

## Response `200`

OK

- StockItemBatch
  - `BatchId` integer: Batch ID
  - `SKU` string: Product SKU
  - `InventoryTrackingType` integer: 0 - None, 1 - Order by sell by date, 2 - Ordered by priority sequence
  - `StockItemId` string, uuid: Product ID
  - `BatchNumber` string: Batch number
  - `ExpiresOn` string, date-time: Batch expiry date
  - `SellBy` string, date-time: Batch sell by date
  - `Inventory` StockItemBatchInventory[]: Batch records
    - `BatchInventoryId` integer: Stock item batch record ID
    - `BatchId` integer: Batch ID
    - `StockLocationId` string, uuid: Location ID
    - `BinRack` string: BinRack
    - `PrioritySequence` integer: Pick order
    - `Quantity` integer: Quantity
    - `StockValue` number, double: Current stock value
    - `StartQuantity` integer: Quantity originally booked in
    - `PickedQuantity` integer: Indicate how many units are now allocated in open orders
    - `BatchStatus` string: Batch Status
    - `IsDeleted` boolean: Is BatchInventory deleted
    - `WarehouseBinrackStandardType` integer: Warehouse binrack standard type
    - `WarehouseBinrackTypeName` string: Warehouse binrack type friendly name
    - `InTransfer` integer: Number of items in Transfer phase.
    - `BinRackId` integer: Binrack Id (Use for WMS)
    - `WarehouseBinrackTypeId` integer: Warehouse binrack type unique id.
  - `IsDeleted` boolean: Is the batch deleted

---

[API](https://skmtc.dev/linnworks/apis/stock-api.md) - [All operations](https://skmtc.dev/linnworks/apis/stock-api/llms.txt) - [OpenAPI document](https://skmtc.dev/linnworks/apis/stock-api/revisions/8b0b8312b9c4?raw)