Stock history
There are 2 different endpoints about stock history:
- Stock history (this page): only contains changes of the stock levels of a product. This gives you every product coming in or going out of your warehouse. Mentioned stock levels are on a product-warehouse basis.
- Location stock history: gives stock changes on a per location basis. Which means that it also tracks stock movements inside the same warehouse. Mentioned stock levels are on a product-location basis.
Get full stock history
GET
https://example.picqer.com/api/v1/stockhistory
HTTP/1.1 200 OK
[
{
"idproduct_stock_history": 7328372,
"idproduct": 1107613,
"idwarehouse": 1124,
"iduser": 424,
"old_stock": 21,
"stock_change": 3,
"new_stock": 24,
"reason": "No reason given",
"change_type": "manual",
"changed_at": "2016-08-01 10:43:43"
},
{
"idproduct_stock_history": 7328371,
"idproduct": 1106133,
"idwarehouse": 13,
"iduser": null,
"old_stock": 0,
"stock_change": 21,
"new_stock": 21,
"reason": "External",
"change_type": "api",
"changed_at": "2016-07-27 14:33:59"
}
]
This endpoint uses pagination.
Filters
You can filter the history with the following parameters. Add these filters as querystring parameters to the URL.
| Attribute | Description | Example |
|---|---|---|
| sincedate | Get the history that is added after this date and time. | 2016-01-01 12:00:00 |
| untildate | Get the history that is added before this date and time. | 2024-01-01 00:00:00 |
| idproduct | Get the history for this product. | 1106133 |
| idwarehouse | Get the history in this warehouse. | 13 |
| iduser | Get the history made by this user. | 424 |
Get single history item
GET
https://example.picqer.com/api/v1/stockhistory/{idproduct_stock_history}
HTTP/1.1 200 OK
{
"idproduct_stock_history": 7328372,
"idproduct": 1107613,
"idwarehouse": 1124,
"iduser": 424,
"old_stock": 21,
"stock_change": 3,
"new_stock": 24,
"reason": "No reason given",
"change_type": "manual",
"changed_at": "2016-08-01 10:43:43"
}
Changing history
Of course it is not possible to change history. Therefor you cannot POST, PUT or DELETE history items.
But you can change the stock. See the products endpoint for information about changing current stock levels.
Read more VAT groups
