文档中心 > API类目 > 海南离岛免税api

qimen.alibaba.gdfc.points.buyapply (下单积分申请)

下单时使用积分，进行积分扣减，并返回积分分摊情况

公共参数

请求地址：

环境	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输入参数签名结果，签名算法介绍请点击这里。

请求参数

名称	类型	是否必须	示例值	描述
userId	String	必须	123	用户id
traceId	String	可选	123	123
dutyfreeType	String	可选	11	业务dutyfreeType
outerUserId	String	可选	345	三方系统用户id
usePoint	Number	必须	100	下单使用的积分数量
orderInfo	OrderDO	必须		订单对象
└ orderTime String 可选 2021-04-01 下单时间yyyy-MM-dd hh:mm:ss └ orderId String 必须 123abc 订单编号 items ItemDO [] 必须子单商品 └ gz String 可选 10100620 柜组 └ id String 可选 123 商品id └ outerId String 可选 234 三方系统商品id └ qty Number 可选 2 购买件数 └ totalPrice Number 可选 500 总金额。无小数位，保留到分位。如500，等于5元 └ extraInfo String 可选 {"key":"jsonstring"} 备注
nonDeductiblePrice	Number	必须	900	不可用积分抵扣的金额。无小数位，保留到分位。如500，等于5元
extInfo	String	可选	{"key":"jsonstring"}	备注

响应参数

名称	类型	示例值	描述
data	Data		返回对象
pointUseShareList PointShare [] 积分使用分摊 └ itemId String 123 商品id └ outerItemId String 234 外部商品id └ points Number 50 积分分摊数，2位小数，放大100倍 pointGiftShareList PointShare [] 积分赠送分摊 └ itemId String 123 商品id └ outerItemId String 234 外部商品id └ points Number 50 积分分摊数，2位小数，放大100倍 └ pointGiftTotal Number 12300 赠送积分总数，2位小数，放大100倍
success	Boolean	true	请求成功标识
respMsg	String	succ	错误描述
respCode	String	200	错误码

请求示例

{"traceId":"123","usePoint":100,"dutyfreeType":"11","outerUserId":"345","orderInfo":{"orderTime":"2021-04-01","orderId":"123abc","items":[{"gz":"10100620","totalPrice":500,"qty":2,"outerId":"234","id":"123","extraInfo":"{\"key\":\"jsonstring\"}"}]},"nonDeductiblePrice":900,"userId":"123","extInfo":"{\"key\":\"jsonstring\"}"}

响应示例

{
    "data":{
        "pointUseShareList":[
            {
                    "itemId":"123",
                    "outerItemId":"234",
                    "points":50
            }
        ],
        "pointGiftShareList":[
            {
                    "itemId":"123",
                    "outerItemId":"234",
                    "points":50
            }
        ],
        "pointGiftTotal":12300
    },
    "success":true,
    "respMsg":"succ",
    "respCode":"200"
}

验签示例

{"success":"false","respMsg":"Illegal request","respCode":"sign-check-failure"}

错误码解释

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

API工具

错误码查询工具 SDK下载

FAQ

有用( 0 ) 我要提问

海南离岛免税api

qimen.alibaba.gdfc.points.buyapply (下单积分申请)

公共参数

请求参数

响应参数

请求示例

响应示例

验签示例

错误码解释

API工具

FAQ

用户导航

用户反馈

用户反馈

用户反馈