v2.product.update_stock

Use this API to update one item_id for each call, but still can support updating multiple model_ids stock of the same item_id (If you need batch modification, please call multiple times)This API will update only "seller_stock".Whenever there is a promotion ongoing or upcoming, the total stock must be larger than or equal to real-time “reserved_stock” promotion stock (Please check v2.get_item_promotion API for more details). Items that are deleted will not be allowed to modify stock.

Overview

Request parameters

Response parameters

Common parameters

Request samples

Payload

{
	"item_id": 1000,
	"stock_list": [
		{
			"model_id": 0,
		
			"seller_stock": [
				{
					"location_id": "-",
					"stock": 0
				}
			]
		}
	]
}

Java

Unirest.setTimeouts(0, 0);
HttpResponse<String> response = Unirest.post("https://partner.shopeemobile.com/api/v2/product/update_stock?sign=sign&access_token=access_token&timestamp=timestamp&shop_id=shop_id&partner_id=partner_id")
.header("Content-Type","application/json")
.body("{
   \"item_id\": 1000,
   \"stock_list\": [
      {
         \"model_id\": 0,

         \"seller_stock\": [
            {
               \"location_id\": \"-\",
               \"stock\": 0
            }
         ]
      }
   ]
}")
.asString();

PHP

<?php

$curl = curl_init();

curl_setopt_array($curl, array(
  CURLOPT_URL => 'https://partner.shopeemobile.com/api/v2/product/update_stock?access_token=access_token&partner_id=partner_id&shop_id=shop_id&sign=sign&timestamp=timestamp',
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => '',
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 0,
  CURLOPT_FOLLOWLOCATION => true,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => 'POST',
  CURLOPT_POSTFIELDS => '{
    "item_id": 1000,
    "stock_list": [
        {
            "model_id": 0,
     
            "seller_stock": [
                {
                    "location_id": "-",
                    "stock": 0
                }
            ]
        }
    ]
}',
  CURLOPT_HTTPHEADER => array(
    'Content-Type: application/json'
  ),
));

$response = curl_exec($curl);

curl_close($curl);
echo $response;

cURL

curl --location --request POST 'https://partner.shopeemobile.com/api/v2/product/update_stock?timestamp=timestamp&shop_id=shop_id&partner_id=partner_id&sign=sign&access_token=access_token' \
--header 'Content-Type: application/json' \
--data-raw '{
   "item_id": 1000,
   "stock_list": [
      {
         "model_id": 0,

         "seller_stock": [
            {
               "location_id": "-",
               "stock": 0
            }
         ]
      }
   ]
}'

Python

import requests
import json

url = "https://partner.shopeemobile.com/api/v2/product/update_stock?access_token=access_token&partner_id=partner_id&shop_id=shop_id&sign=sign&timestamp=timestamp"

payload=json.dumps({
  "item_id": 1000,
  "stock_list": [
    {
      "model_id": 0,

      "seller_stock": [
        {
          "location_id": "-",
          "stock": 0
        }
      ]
    }
  ]
})
headers = {
  'Content-Type': 'application/json'
}
response = requests.request("POST",url,headers=headers, data=payload, allow_redirects=False)

print(response.text)

Response sample

JSON

{
	"error": "-",
	"message": "-",
	"warning": "-",
	"request_id": "-",
	"response": {
		"failure_list": [
			{
				"model_id": 0,
				"failed_reason": "-"
			}
		],
		"success_list": [
			{
				"model_id": 0,
				"location_id": "-",
				"stock": 0
			}
		]
	}
}

Error example

JSON

{
    "error": "product.error_param",
    "message": "invalid field ItemId: value must  Not Null",
    "request_id": "11484dd6d9e203edd5d332551249de57"
}

Errors

Common errors

Update log