Taobao/Tmall Pre-create Order Interface

POST

/rest/taobao-global/purchase/order/render

Before placing an order, you need to call this interface first. The interface will return which products can be purchased, which products cannot be purchased, and the accurate price and Chinese shipping costs.

Request

Authorization

Bearer Token

Provide your bearer token in the

Authorization

header when making requests to protected resources.

Example:

Authorization: Bearer ********************

Body Params application/json

Example

{
    "need_supplychain_service": true,
    "render_item_List": "[{\"itemId\":600120680003951077,\"quantity\":\"1\",\"skuId\":4951323355633,\"chooseSupplychainServices\":[{\"optionId\":354,\"serviceCategory\":\"LOGISTICS\"},{\"optionId\":356,\"serviceCategory\":\"QUALITY_INSPECTION\"},{\"optionId\":357,\"serviceCategory\":\"ADVANCED_QUALITY_INSPECTION\"}]}]",
    "warehouse_address": {
        "zip": "11111",
        "country": "中国",
        "address": "小王新村",
        "phone": "",
        "city": "杭州市",
        "mobile_phone": "15432456575",
        "district": "余杭区",
        "name": "a测试aa",
        "state": "浙江省"
    },
    "receiver_address": {
        "zip": "11111",
        "country": "United States",
        "address": "The State University of New York College at Buffalo",
        "phone": "",
        "city": "Buffalo",
        "mobile_phone": "150",
        "district": "",
        "name": "a测试aa",
        "tax_id": "1231233",
        "state": "New York"
    }
}

Request Code Samples

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location 'https://ecommerce-api.shanjing-inc.com/rest/taobao-global/purchase/order/render' \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '{
    "need_supplychain_service": true,
    "render_item_List": "[{\"itemId\":600120680003951077,\"quantity\":\"1\",\"skuId\":4951323355633,\"chooseSupplychainServices\":[{\"optionId\":354,\"serviceCategory\":\"LOGISTICS\"},{\"optionId\":356,\"serviceCategory\":\"QUALITY_INSPECTION\"},{\"optionId\":357,\"serviceCategory\":\"ADVANCED_QUALITY_INSPECTION\"}]}]",
    "warehouse_address": {
        "zip": "11111",
        "country": "中国",
        "address": "小王新村",
        "phone": "",
        "city": "杭州市",
        "mobile_phone": "15432456575",
        "district": "余杭区",
        "name": "a测试aa",
        "state": "浙江省"
    },
    "receiver_address": {
        "zip": "11111",
        "country": "United States",
        "address": "The State University of New York College at Buffalo",
        "phone": "",
        "city": "Buffalo",
        "mobile_phone": "150",
        "district": "",
        "name": "a测试aa",
        "tax_id": "1231233",
        "state": "New York"
    }
}'

Responses

🟢200Success

application/json

Bodyapplication/json

Example

{
    "result": {
        "innerErrorMsg": "string",
        "data": {
            "renderItemList": [
                {
                    "nick": "string",
                    "itemPriceInfos": [
                        {
                            "itemId": 0,
                            "originPrice": {
                                "amount": 0,
                                "currency": "string"
                            },
                            "skuId": 0,
                            "quantity": 0,
                            "discountPrice": {
                                "amount": 0,
                                "currency": "string"
                            },
                            "dispatchPlace": "string",
                            "estimatedDeliveryTime": "string",
                            "currencyCode": "string",
                            "deliveryFee": "string"
                        }
                    ],
                    "sellerId": 0,
                    "mainlandShippingFee": {
                        "amount": 0,
                        "currency": "string"
                    },
                    "orderFee": {
                        "amount": 0,
                        "currency": "string"
                    },
                    "chooseSupplyChainServices": [
                        {
                            "shippingFee": {
                                "amount": 0,
                                "currency": "string"
                            },
                            "name": "string",
                            "description": "string",
                            "optionId": 0,
                            "isMustSelect": true,
                            "shippingTime": {
                                "mode": 0,
                                "min": 0,
                                "max": 0
                            },
                            "serviceCategory": "string"
                        }
                    ]
                }
            ],
            "unavailableSkuList": [
                {
                    "itemId": 0,
                    "skuId": 0,
                    "reason": "string",
                    "errorCode": "string",
                    "errorMsg": "string"
                }
            ],
            "totalRealPayPrice": {
                "amount": 0,
                "currency": "string"
            }
        },
        "success": true,
        "failItems": "string",
        "errorCode": "string",
        "errorMsg": "string"
    }
}

🟢200Failed

Modified at 2026-03-14 06:46:03

Taobao/Tmall Collision Database Interface

Taobao/Tmall Order Cancellation Interface