# Stocks

Managing stocks in the e-shop.

## List of stocks

 - [GET /api/stocks](https://api.docs.shoptet.com/shoptet-api/openapi/stocks/getlistofstocks.md): Returns the list of stocks. There are usually not many stocks, therefore the endpoint returns all of them without Paging.

## Stock detail

 - [GET /api/stocks/{stockId}](https://api.docs.shoptet.com/shoptet-api/openapi/stocks/getstockdetail.md): Returns detailed information about one stock.

## Stock movements

 - [GET /api/stocks/{stockId}/movements](https://api.docs.shoptet.com/shoptet-api/openapi/stocks/getstockmovements.md): It returns the list of changes in product quantity, which were done
within one stock. Supports the Paging .

This endpoint supports optional parts using the  parameter (see
Section on demand). Please note that there is some
performance penalty associated with the usage of "orderCode" 
and/or query .

## Update quantity in stock

 - [PATCH /api/stocks/{stockId}/movements](https://api.docs.shoptet.com/shoptet-api/openapi/stocks/updatequantityinstock.md): Endpoint enables the quantity of product in stock (relative and
absolute) to be changed. Within a call, the update

of multiple products at once can be requested (max. 300
products/variants).


In case an error occurs for one of the records, the correct records will
be updated, the response will be 

and there will be records in the  array for each failed record.
If all records are incorrect, the response

code will be  instead.


Item  is mandatory. Then one of the three items has to be
provided:


-  to increase or decrease amount available for
ordering/physically on stock (relative change)


-  to set amount available for ordering (absolute amount)


-  to set amount physically stored in a warehouse (absolute
amount)


The difference between  and  is amount of goods
requested by the pending orders (so called "claim").


 =  - 


The claim cannot be changed explicitly, it is updated when a new order
is submitted or an order is sent out. Please note,

that the stock amount cannot be changed for product sets, where the
amount is calculated dynamically from the individual

products in the set. Trying to change the amount of product set will
result in an error.

## Stock movements - Last move

 - [GET /api/stocks/{stockId}/movements/last](https://api.docs.shoptet.com/shoptet-api/openapi/stocks/getstockmovementslastmove.md): It returns informations about last stock move.

## Product supplies in stock

 - [GET /api/stocks/{stockId}/supplies](https://api.docs.shoptet.com/shoptet-api/openapi/stocks/getproductsuppliesinstock.md): Returns the product supplies in stock for all products in a specific stock, contains GUID, code and quantity 
in stock for a specific product variant. It is possible to filter the specific GUID of a product, possibly a variant code. The endpoint supports Paging, in case of filtering, the amount of items per page increases.
This endpoint supports optional parts using the  parameter (see Section on demand). The  item 
is always temporarily returned, however as of 16. 3. 2019 only upon using the  parameter.


If you defined the  parameter within the URL, the response will also contain the time
when the last quantity in stock was changed.