淘宝开放平台 - 文档中心

请求地址：

环境	HTTP请求地址
正式环境	http://qimen.api.taobao.com/router/qm
测试环境	http://qimen.api.taobao.com/router/qmtest

公共请求参数：

名称	类型	是否必须	描述
method	String	是	API接口名称。
app_key	String	是	TOP分配给应用的AppKey。
session	String	否	用户登录授权成功后，TOP颁发给应用的授权信息，详细介绍请点击这里。当此API的标签上注明：“需要授权”，则此参数必传；“不需要授权”，则此参数不需要传；“可选授权”，则此参数为可选。
timestamp	String	是	时间戳，格式为yyyy-MM-dd HH:mm:ss，时区为GMT+8，例如：2015-01-01 12:00:00。淘宝API服务端允许客户端请求最大时间误差为10分钟。
format	String	否	响应格式。默认为xml格式，可选值：xml，json。
v	String	是	API协议版本，可选值：2.0。
customerId	String	是	WMS颁发给用户的ID
sign_method	String	是	签名的摘要算法，md5。
sign	String	是	API输入参数签名结果，签名算法介绍请点击这里。

名称	类型	是否必须	示例值	更多限制	描述
sales_type	String	可选	new_sign		1
sku_property_value_dtos	SkuPropertyValueDtos []	可选		最大列表长度：999999	1
└ property_key String 可选 product 1 └ value String 可选 21 1 └ property_name String 可选 smart 1
commodity_code	String	可选	be485		1
valid_from	String	可选	demo		1
promotion_id	String	可选	promotion12321		1
okki_order_product_id	String	可选	demo		1
client_id	String	可选	14350		1
ali_order_product_id	String	可选	demo		1
proposal_commodities	ProposalCommodities []	可选		最大列表长度：999999	1
sku_property_value_dtos SkuPropertyValueDtos [] 可选 1 └ property_key String 可选 product 1 └ value String 可选 2021lite 1 └ property_name String 可选产品 1 └ sales_type String 可选 new_sign 1 └ commodity_code String 可选 be606 1 └ source_promotion_id String 可选 promotion12321 1 └ total_price String 可选 3000 1 └ count String 可选 1 1 └ name String 可选橱窗 1 └ currency String 可选 CNY 1 └ type String 可选 BUY 1 └ reduction String 可选 0 1 └ sku_code String 可选 12321312321 1 └ source_promotion_name String 可选测试促销123 1
ali_cgs	String	可选	test_4116458941		1
promotion_name	String	可选	测试促销123		1
valid_to	String	可选	demo		1
currency	String	可选	CNY		1
expand_key	ExpandKey []	可选		最大列表长度：999999	1
└ value String 可选 value1示例 1 └ key String 可选 key1示例 1

名称	类型	示例值	描述
data	Data []		1
dynamic Dynamic 1 sku_property_value_dtos SkuPropertyValueDtos [] 1 └ property_key String product 1 └ value String 21 11 └ property_name String smart 1 └ ali_cgs String test_4116458941 1 └ amount String 32400 1 └ commodity_code String be485 1 └ valid_from String demo 1 └ discount_information String OMS合计原价：12000，合计优惠金额：6000 11 └ original_amount String 48000 1 └ valid_to String demo 1 └ okki_order_product_id String demo 1 └ client_id String 14350 1 └ ali_order_product_id String demo 1 └ sales_type String new_sign 1 order Order 1 └ amount String 32400 1 └ discount_information String OMS合计原价：12000，合计优惠金额：6000 1 └ ali_company_name String 阿里巴巴 1 └ okki_order_no String 213123 1 └ okki_create_time String 2022-10-08 11:55:40 1 └ ali_cgs String test_4116458941 1 └ ali_order_no String 321312 1 └ ali_paid_time String demo 1 └ okki_client_id String 14350 1 order_product_list OrderProductList [] 1 └ amount String 32400 1 └ okki_valid_from String 2032-03-19 00:00:00 1 extras Extras [] 1 └ name String account 1 └ count String 1 1 └ type String 1 1 └ okki_order_product_id String 21321 1 └ product_name String OKKI SMART管理软件V1.0 1 └ ali_order_product_id String P232131213 1 standards Standards [] 1 └ name String account 1 └ count String 10 1 └ duration String 12 1 └ okki_execute_time String demo 1 └ is_free String 0 1 └ product_id String 19 1 └ okki_valid_to String 2033-03-18 23:59:59 1 └ original_amount String 38400 1 └ available_modules String [] 1 └ business_id String 112233 1 └ extend_fields String [{\"extend_fields_key\":\"orderPromoteId\",\"extend_fields_value\":\"1,2,3\"},{\" extend_fields_key\":\"b\",\"extend_fields_value\":\"b_1\"}] 拓展信息 └ original_amount String 48000 1 └ resp_code String 0 1 └ action String 0 1 └ trade_no String okki_0000000293_20221008_test_4116458941_0_0 1 └ ali_create_time String demo 1
error_desc	String	error	1
success	Boolean	true	1
resp_code	Number	0	1
status	Number	0	1

{"sku_property_value_dtos":[{"property_key":"product","value":"21","property_name":"smart"}],"commodity_code":"be485","sales_type":"new_sign","valid_from":"demo","promotion_id":"promotion12321","expand_key":[{"value":"value1示例","key":"key1示例"}],"okki_order_product_id":"demo","client_id":"14350","ali_order_product_id":"demo","proposal_commodities":[{"sku_property_value_dtos":[{"property_key":"product","value":"2021lite","property_name":"产品"}],"commodity_code":"be606","source_promotion_id":"promotion12321","sales_type":"new_sign","total_price":"3000","count":"1","name":"橱窗","currency":"CNY","type":"BUY","reduction":"0","sku_code":"12321312321","source_promotion_name":"测试促销123"}],"ali_cgs":"test_4116458941","promotion_name":"测试促销123","valid_to":"demo","currency":"CNY"}

{
    "data":[
        {
                "dynamic":{
                    "sku_property_value_dtos":[
                        {
                                "property_key":"product",
                                "value":"21",
                                "property_name":"smart"
                        }
                    ],
                    "ali_cgs":"test_4116458941",
                    "amount":"32400",
                    "commodity_code":"be485",
                    "valid_from":"demo",
                    "discount_information":"OMS合计原价：12000，合计优惠金额：6000",
                    "original_amount":"48000",
                    "valid_to":"demo",
                    "okki_order_product_id":"demo",
                    "client_id":"14350",
                    "ali_order_product_id":"demo",
                    "sales_type":"new_sign"
                },
                "order":{
                    "amount":"32400",
                    "discount_information":"OMS合计原价：12000，合计优惠金额：6000",
                    "ali_company_name":"阿里巴巴",
                    "okki_order_no":"213123",
                    "okki_create_time":"2022-10-08 11:55:40",
                    "ali_cgs":"test_4116458941",
                    "ali_order_no":"321312",
                    "ali_paid_time":"demo",
                    "okki_client_id":"14350",
                    "order_product_list":[
                        {
                                "amount":"32400",
                                "okki_valid_from":"2032-03-19 00:00:00",
                                "extras":[
                                    {
                                            "name":"account",
                                            "count":"1"
                                    }
                                ],
                                "type":"1",
                                "okki_order_product_id":"21321",
                                "product_name":"OKKI SMART管理软件V1.0",
                                "ali_order_product_id":"P232131213",
                                "standards":[
                                    {
                                            "name":"account",
                                            "count":"10"
                                    }
                                ],
                                "duration":"12",
                                "okki_execute_time":"demo",
                                "is_free":"0",
                                "product_id":"19",
                                "okki_valid_to":"2033-03-18 23:59:59",
                                "original_amount":"38400",
                                "business_id":"112233",
                                "extend_fields":"[{\\\"extend_fields_key\\\":\\\"orderPromoteId\\\",\\\"extend_fields_value\\\":\\\"1,2,3\\\"},{\\\" extend_fields_key\\\":\\\"b\\\",\\\"extend_fields_value\\\":\\\"b_1\\\"}]"
                        }
                    ],
                    "original_amount":"48000",
                    "resp_code":"0",
                    "action":"0",
                    "trade_no":"okki_0000000293_20221008_test_4116458941_0_0",
                    "ali_create_time":"demo"
                }
        }
    ],
    "error_desc":"error",
    "success":true,
    "resp_code":0,
    "status":0
}

{"success":"不等于true","error_desc":"Illegal request","resp_code":"sign-check-failure"}

错误码	错误描述	解决方案
isp.http-read-timeout

错误码查询工具 SDK下载

开放平台

CRM猎户座前台

qimen.alibaba.saas.dynamic.quota.get (奇门SAAS动态报价查询)

公共参数

请求参数

响应参数

请求示例

响应示例

验签示例

错误码解释

API工具

FAQ