Skip to main content

Update Stock

This endpoint used for update product stock. You can update up to 100 products or SKUs in a single request to this endpoint.

Path

post

/inventory/v1/fs/:fs_id/stock/update?shop_id={{shop_id}}

Request Parameters

ParameterTypeRequiredLocationDescription
fs_id
Integer
Required
path
Fulfillment service unique identifier
shop_id
Integer
Required
query
Shop unique identifier
bypass_update_product_status
Boolean
Optional
query
Use to bypass update product status flow when overwrite stock to 0 (empty) or restock
warehouse_id
Integer
Optional
query
Warehouse unique identifer
sku
String
Required if product_id not inputted
body
Prioritized over product_id. SKU of products that will be updated. Maximum characters allowed is 50
product_id
Integer
Required if sku not inputted
body
Product ID to update
new_stock
Integer
Required
body
New stock to be set

Example Request

curl -X POST \
'https://fs.tokopedia.net/inventory/v1/fs/13004/stock/update?shop_id=479573' \
-H 'Authorization: Bearer avK2WV5pSda4HlxC5mLrFA' \
-H 'Content-Type: application/json' \
-d '[
{
"sku": "YS1234",
"new_stock": 20
},
{
"sku": "ABC1234",
"new_stock": 30
},
{
"product_id": 15123699,
"new_stock": 40
}
]'

Response Parameters

NameTypeDemo ValueDescription
failed_rows
Integer
2
Failed Row Count
failed_rows_data
Object Array
succeed_rows
Integer
0
Succeed Row Count

Success Response Examples

{
"header": {
"process_time": 0.045122173,
"messages": "Your request has been processed successfully"
},
"data": {
"failed_rows": 0,
"failed_rows_data": [],
"succeed_rows": 3
}
}

Error Response Examples

{
"header": {
"process_time": 0.045122173,
"messages": "Your request has been processed successfully"
},
"data": {
"failed_rows": 3,
"failed_rows_data": [
{
"product_id": 151231699,
"sku": "",
"product_url": "",
"new_stock": 40,
"message": "Invalid Product ID."
},
{
"sku": "ABC12314",
"product_url": "",
"new_stock": 30,
"message": "Invalid SKU."
},
{
"sku": "YS11234",
"product_url": "",
"new_stock": 20,
"message": "Invalid SKU."
}
],
"succeed_rows": 0
}
}

Error Codes

Error CodeError MessageDescription
PRD_GRPC_001
Failed Send GRPC Request
Failed sending request to upstream
PRD_GRPC_002
There Are Error From Ext Service
Failed getting response from upstream
PRD_API_007
Failed Marshalling JSON
Error on processing data
PRD_DB_001
Failed To Query DB Data
Failed getting data from database
PRD_DB_002
Failed To Scan DB Data
Failed getting data from database
PRD_DB_003
Data Not Found
Failed getting data from database
PRD_USC_009
Warehouse is not owned by toko cabang
PRD_USC_010
Warehouse is owned by toko cabang
PRD_USC_011
Partner ID not found
Failed to get Partner ID
PRD_USC_012
Shop ID Not Match
Shop ID did not match with warehouse data
PRD_USC_013
FS Type cannot use warehouse
Failed to precess data
PRD_USC_021
Warehouse Data Not Found
Warehouse ID not found
PRD_USC_029
Warehouse ID Information Not Found
Failed to get warehouse information
PRD_DLV_001
fs_id cannot be empty
fs_id field is empty, please check again
PRD_DLV_002
invalid fs_id format
fs_id is in the wrong format, please check again
PRD_DLV_003
invalid shop_id format
shop_id is in the wrong format, please check again
PRD_DLV_015
failed read body request
Failed reading the body request
PRD_DLV_016
shop_id cannot be empty
shop_id field is empty, please check agai
PRD_DLV_018
Max allowed products per-update are %d products
The request has exceed the max allowed product price edit per request
PRD_DLV_019
invalid warehouse_id format
warehouse_id is in the wrong format, please check again
PRD_DLV_042
Invalid field %s format, value %v should be %s
There is something wrong with the request body
PRD_DLV_052
warehouse_id cannot be empty
warehouse_id is empty, please check again
SHP_GRPC_001
Failed Send GRPC Request
Failed sending request to upstream
SHP_GRPC_003
Data Not Found
Failed finding data from upstream
  • Path
  • Request Parameters
  • Example Request
  • Response Parameters
  • Success Response Examples
  • Error Response Examples
  • Error Codes
  • Have a feedback?