---
title: "Stock Adjustment"
method: POST
path: "/v2/stocks"
tags: ["stock"]
---

# Stock Adjustment

`POST /v2/stocks`

Adjust the stock of a specific item. Depending from the item and warehouse many more details must be given (f.e. storage location, batch,...).

## Query parameters

- `disableAutomaticWorkflows` boolean

## Headers

- `x-tenant-id` string, uuid, required
- `x-runas` string
- `x-companyid` string

## Request body

- JTLWawiRestContractsModelsV1StockCreateStock — Model Class: CreateStock
  - `warehouseId` string, uuid
  - `storageLocationId` string, uuid
  - `itemId` string, uuid
  - `shelfLifeExpirationDate` string, date-time — Shelf life expiration date of the item, if applicable.
  - `batchNumber` string — Batch number of the item if, the item is a batch item.
  - `quantity` number — The quantity that should be added to this storage location.
  - `purchasePriceNet` number — The purchase price of the item.
  - `serialNumbers` string[] — Serial numbers of the item. The amount of serial numbers must match the quantity and no serial numbers that are already in stock are allowed.
  - `comment` string — Comment for this stock change.

## Response `201`

The created stock.

- JTLWawiRestContractsModelsV1StockStock — Model Class: Stock
  - `warehouseId` string, uuid
  - `storageLocationId` string, uuid
  - `storageLocationName` string — Name of the storage location.
  - `itemId` string, uuid
  - `shelfLifeExpirationDate` string, date-time — Shelf life expiration date of the item, if applicable.
  - `batchNumber` string — Batch number of the item if, the item is a batch item.
  - `quantityTotal` number — Total quantity of this item at this storage location.
  - `quantityLockedForShipment` number — Quantity at this storage location that is locked for shipment, f.e. because the storage location or warehouse is locked for shipment.
  - `quantityLockedForAvailability` number — Quantity at this storage location that is locked for availability, f.e. because the storage location or warehouse is locked for availability.
  - `quantityInPickingLists` number — Quantity at this storage location that is on picking lists.

## Other responses

- `400` — The sent data is invalid.
- `401`
- `402` — No licence available or the app has not been authorised by JTL.
- `404` — No category with the given ID exists.

---

[API](https://skmtc.net/jtl-software/apis/scx-authentication-api.md) · [All operations](https://skmtc.net/jtl-software/apis/scx-authentication-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/jtl-software/scx-authentication-api/revisions/f979b1ea6951/schema)