CreateItem

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

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/create"

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
}