Skip to content


Use this API to create item.

POST /openapi/fulfillment/item/v1/create

Request Body

Parameter Type Required Length Description
itemSku string true 512 Identifiers of Item SKU (Case-sensitive)
itemSource int true / Please refer to Item Source for details
itemName string true 512 Item's 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


curl -X POST  \
-H "X-Advai-Country: ID" \
-H "Authorization: {Your Access Key} + ':' + signature" \
-H "Content-Type: application/json" \
-d '{
        "itemName":"test data",
    }' \
"{Ginee Host}/openapi/fulfillment/item/v1/create"


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


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