Skip to content

Update quantity in stock

Request

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 200 OK

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

code will be 400 BAD REQUEST instead.

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

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

  • quantity to set amount available for ordering (absolute amount)

  • realStock to set amount physically stored in a warehouse (absolute amount)

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

amount for ordering = realStock - 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.

Security
shoptetAccessToken or shoptetPrivateApiToken
Path
stockIdintegerrequired

ID of the stock for which we would like the movements.

Example:1
Headers
Content-Typestringrequired
Default:"application/json"
Bodyapplication/json
dataArray of objectsrequired
curl -i -X PATCH \
  https://api.docs.shoptet.com/_mock/shoptet-api/openapi/api/stocks/1/movements \
  -H 'Content-Type: application/json' \
  -H 'Shoptet-Access-Token: YOUR_API_KEY_HERE' \
  -d '{
    "data": [
      {
        "productCode": "43/BIL",
        "amountChange": 10
      }
    ]
  }'

Responses

OK

Bodyapplication/json
dataobject or null
errorsArray of objects or null(Errors)
metadataobject(Metadata)
Response
{
  "errors": [
    { … },
    { … }
  ]
}