---
title: "UpdatePickedItemDelta"
method: POST
path: "/api/Picking/UpdatePickedItemDelta"
tags: ["Picking"]
---

# UpdatePickedItemDelta

`POST /api/Picking/UpdatePickedItemDelta`

## Request

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

Updates the batch/binrack for allocated pickwave item. Only applicable to pickwave items with batch information
<b>Permissions Required: </b> GlobalPermissions.OrderBook.OpenOrders.PickingWavesNode
<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

- UpdatePickedItemDeltaRequest
  - `Deltas` UpdatePickedItemDeltaRequestItem[]
    - `PickingWaveItemsRowId` integer: Picking wave row id
    - `ToteId` integer: Tote id
    - `TrayTag` string: Tray tag (optional)
    - `PickedQuantityDelta` integer: Picked quantity delta

## Response `200`

OK

- GetPickingWavesResponse
  - `PickingWaves` PickingWaveDetailed[]: Pickwaves
    - `LocationId` string, uuid: Location Id
    - `UserId` integer: Allocated user id
    - `EmailAddress` string: Allocated user EmailAddress
    - `CreatedDate` string, date-time: Creation date
    - `OrderCount` integer: Order Count - Number of orders in pickwave.
    - `ItemCount` integer: Item Count - Number of items in pickwave.
    - `ItemsPicked` integer: Items Picked - Number of items picked in pickwave.
    - `OrdersPicked` integer: Orders Picked - Number of orders picked in pickwave.
    - `AccumulatedInProgressSeconds` integer: Time taken in pickwave
    - `StartTime` string, date-time: Start date time of pickwave
    - `EndTime` string, date-time: End date time of pickwave
    - `GroupType` 'Items' | 'Orders': Pickwave group type
    - `SortingType` 'BinPriority' | 'OrderView'
    - `Orders` PickingWaveOrderDetailed[]: Orders in pickwave.
      - `PickingWaveOrdersRowId` integer: Pickwave order id
      - `PickingWaveId` integer: Pickwave id
      - `OrderId` integer: Order Id
      - `PickState` 'Unpicked' | 'PartialPicked' | 'Picked' | 'Processed' | 'LockedOrParked' | 'Cancelled' | 'Deleted': Pick state
      - `SortOrder` integer: Sort order
      - `ItemCount` integer: Items count
      - `PickedItemsCount` integer: Picked items count
      - `Items` PickingWaveItemDetailed[]: Pickwave order items.
        - `SortOrder` integer: Sort order
        - `ToPickQuantity` integer: Quantity to pick
        - `TOTId` integer: ToT Id
        - `TrayTag` string: Tray tag
        - `PickingTag` string: Picking tag
        - `PickingWaveItemsRowId` integer: Pickwave item row id
        - `PickingWaveId` integer: Pickwave id
        - `PickedQuantity` integer: Quatity picked
        - `ItemState` 'Normal' | 'OrderStateInvalid' | 'Abandonned' | 'DeletedFromOrder': Pickwave item state
        - `Totes` PickingWaveItemTote[]: Collection of pickwave item totes.
          - `RowId` integer
          - `PickingWaveItemsRowId` integer
          - `ToteId` integer
          - `TrayTag` string
          - `PickedQuantity` integer
        - `BatchInventoryId` integer: Batch Inventory Id
        - `OrderId` integer: Linnworks Order Id
        - `OrderItemRowId` string, uuid: Unique order item row identifier
        - `StockItemId` string, uuid: StockItemId
        - `OrderSortOrder` integer: Sort order of Order
      - `Composition` PickingWaveItemComposition[]: Relationship between pickwave items and composite parent rows.
        - `StockItemId` string, uuid: Stock item id
        - `OrderItemRowId` string, uuid: Composite parent order item row id
        - `Quantity` integer: Quantity of composite.
        - `Children` PickingWaveItemComposition[]: Child row relationships to parent
      - `OrderId_Guid` string, uuid: Internal guid orderid
      - `IsProcessed` boolean: Is order processed
      - `IsCancelled` boolean: Is order hold or cancelled
      - `IsOnHold` boolean: Is order on hold status
      - `IsLocked` boolean: Is order locked.
      - `IsPaid` boolean: Is order paid
    - `Options` PickingWaveOptions
      - `ItemScanType` 'Any' | 'IndividualItem' | 'AggregateItem': Item scan type, dictates if the user must scan all items or can provide aggregate count
      - `TrayScanRequired` boolean: If the user must scan the tray the item went into.
      - `TotScanRequired` boolean: If the user must scan the tot before scanning items.
      - `BinRackScanRequired` boolean: If the user must scan the binrack before picking an item.
    - `PickingWaveId` integer: Pickwave id
    - `State` 'Unallocated' | 'Allocated' | 'InProgress' | 'Paused' | 'Complete' | 'Abandoned' | 'Packing' | 'Shipped': Current state of pickwave
  - `Skus` StockItemInfo[]: List of SKUs.
    - `SKU` string: Item SKU
    - `StockItemId` string, uuid: Item unique id
    - `ItemTitle` string: Item Title
    - `Barcode` string: Barcode number on the item header
    - `PrimaryImageURL` string: Image URL
    - `Identifiers` StockItemIdentifier[]: Product identifiers
      - `StockItemId` string, uuid: Stock item id
      - `Type` 'EAN' | 'MPN' | 'GTIN' | 'UPC' | 'ASIN' | 'ISBN' | 'Google' | 'CustomID' | 'PZN' | 'GCID' | 'ePID' | 'AMZNTRANS' | 'SERIAL' | 'IMEI': Product identifier type
      - `Value` string: Product identifier
  - `Bins` BinRackStockItem[]: List of bins and batches of items in the bins.
    - `BinRackId` integer: Unique id for the binrack
    - `StandardType` integer: Bin Rack type name
    - `BatchId` integer: Batch id
    - `BatchInventoryId` integer: Batch inventory id
    - `PrioritySequence` integer: Consume priority sequence
    - `BatchStatus` string: Batch status, "Available", "Restricted", "Damaged", "Expired"
    - `BinRack` string: BinRack name
    - `CurrentFullPercentage` number, double: Maximum volumetric capacity of the location WxDxH = volumetric
    - `Quantity` integer: Quantity available in the location
    - `InTransit` integer: Quantity of items currently in transit
    - `PickedQuantity` integer: Indicate how many units are now allocated in open orders
    - `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
    - `BinrackTypeName` string
    - `LocationId` string, uuid

---

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