AddRollingStockTake

post https://eu-ext.linnworks.net/api/Stock/AddRollingStockTake

Add rolling stock take/count. Rolling stock count will create a stock count header for every day (UTC based). Every request will create a session, adds all entries into the stock count
recounts all totals and discrepancies. WMS location or batched items requires BatchInventoryId to be specified. If you are submitting stock level for item that doesn't have batch inventory you must create it first, get its id and submit in the count
The method validates all entries, if any errors encountered the whole request will be rejected.
Permissions Required: GlobalPermissions.Inventory.StockTake.RollingStockCountNode
Rate limit: 150 / minute

Response

Response body

object

ErroredItems

array of objects

List of items that have failed validation, if any items are returned then the stock take won't be submitted.

ErroredItems

object

BinRack

string

(optional) Only applicable to non-batched and non-WMS locations. Singular BinRack will be updated for the given item for a given location. Will be ignored for a batched or WMS item.

PickingWaveItems

array of objects

(optional) Pickwave items associated with the batch. This data will be used for concurrency check and validation of data.
Super important stuff when you are submitting batch inventory stock count in WMS location.
Order items will automatically be allocated to a specific batch when the order is placed/printed/added to pickwave. This will normally block stock count,
however it is possible to get the state of pickwave items, and if all items are picked from the location the user can still count them. When stock count is submitted
we need to also submit the state of the pickwave at the point of count, so we can compare state was and the state is, discount any stock from the count that was processed/shipped
If this parameter is not supplied and the batch is allocated to orders, the stock count for this item will be blocked and will not be submitted

PickingWaveItems

object

PickingWaveItemsRowId

int32

Pickwave Row Id

PickingWaveId

int32

Pickwave Id

UserName

string

User name to whom the pickwave was/is allocated. If unallocated this will be null

ToPickQuantity

int32

Total Quantity to pick

PickedQuantity

int32

Picked quantity

StockItemId

uuid

Stock Item Id

OrderId

int32

Order Id

UserId

int32

User Id to whom the pickwave was/is allocated. If unallocated this will be null

Errors

array of strings

List of errors for specific stock take item

Errors

StockItemId

uuid

Stock Item Id

Quantity

int32

Current stock level

OriginalQuantity

int32

(Optional) Original quantity, used to validate if the original has changed since the items have been counted. If supplied and different to expected then an error will be returned.

StockValue

double

(optional) Stock value (unit cost * quantity). If not provided it will be calculated from current stock value

BatchInventoryId

int32

(conditional) If item is batched or in WMS location, you must provide BatchInventoryId which is being updated.
If its newly discovered item, use BookInStockBatch call in Stock controller to create a new batch inventory

Language

Credentials

Header


xxxxxxxxxx
1
curl --request POST \
2
     --url https://eu-ext.linnworks.net/api/Stock/AddRollingStockTake \
3
     --header 'accept: application/json' \
4
     --header 'content-type: application/json'


xxxxxxxxxx
27
}
1
{
2
  "ErroredItems": [
3
    {
4
      "BinRack": "string",
5
      "PickingWaveItems": [
6
        {
7
          "PickingWaveItemsRowId": 0,
8
          "PickingWaveId": 0,
9
          "UserName": "string",
10
          "ToPickQuantity": 0,
11
          "PickedQuantity": 0,
12
          "StockItemId": "00000000-0000-0000-0000-000000000000",
13
          "OrderId": 0,
14
          "UserId": 0
15
        }
16
      ],
17
      "Errors": [
18
        "string"
19
      ],
20
      "StockItemId": "00000000-0000-0000-0000-000000000000",
21
      "Quantity": 0,
22
      "OriginalQuantity": 0,
23
      "StockValue": 0,
24
      "BatchInventoryId": 0
25
    }

200OK