Skip to content

UpdateItem

Use this API to update item. the update is identified by itemSku.

POST /openapi/fulfillment/item/v1/update

Request Body

Parameter Type Required Length Description
itemSku string true 512 Identifiers of Item SKU (Case-sensitive)
itemName string true 512 name
itemLength double true / length.(Unit:cm)
itemWidth double true / width.(Unit:cm)
itemHeight double true / height.(Unit:cm)
itemWeight double true / length.(Unit:g)
warehouseCode string true 20 The warehouse code from Ginee WMS
imageUrls string[] false / Image Link
itemSpec string false 255 Item specifications
itemMark int false / Merchandise markings (1 = fragile)
remark string false 255 Item remark

Response Body

Name Type Description
code string SUCCESS | ERROR
message string The status code detailed explanation.
data object No data returned will be null.
extra string An exception message (should be empty most of the time).
transactionId string An unique string identifier for each request.
pricingStrategy string Shows you whether this api call will be charged by Ginee, currently all APIs are FREE even though this tag is PAY.

Request Example

Example

curl -X POST  \
-H "X-Advai-Country: ID" \
-H "Authorization: {Your Access Key} + ':' + signature" \
-H "Content-Type: application/json" \
-d '{
        "itemSku":2,
        "itemSource":2,
        "itemName":"test data",
        "itemLength":"22.33",
        "itemWidth":3.2,
        "itemHeight":4.5,
        "itemWeight":399.2,
        "imageUrls":[
            "https://cf.shopee.ph/file/1792dcd00dff2d2c15024f04c8d48bf4",
            "https://cf.shopee.ph/file/1792dcd00dff2d2c15024f04c8d48bf4",
        ],
        "remark":"",
        "itemSpec":"",
        "warehouseCode":"WH0007",
        "itemMark":""
    }' \
"{Ginee Host}/openapi/fulfillment/item/v1/update"

Success

{
    "code": "SUCCESS",
    "message": "operation successful",
    "data": null,
    "extra": null,
    "transactionId": "19d607ea5d78852a"
}

Failure

{
    "code": "ERROR",
    "message": "{item.length.too.long example(1~999)}",
    "data": null,
    "extra": null
}