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

qimen.alibaba.gdfc.points.buycalc (下单预计算可使用积分)

查询用户下单可用积分

公共参数

请求参数

名称 类型 是否必须 示例值 更多限制 描述
userId String 必须 123 用户id
traceId String 可选 123 123
dutyfreeType String 可选 11
  • 默认值:11
  • 11
    usePoints Number 可选 100 使用了多少积分
    outerUserId String 可选 789 三方系统用户id
    phone String 可选 13101239876 手机号
    items ItemDO [] 必须
  • 最大列表长度:99
  • 子单商品
    • └ gz
    • String
    • 可选
    • 10100602
    • 默认值:富基柜组
    • 柜组
    • └ id
    • String
    • 必须
    • 231024
    • 商品id
    • └ outerId
    • String
    • 可选
    • 12392
    • 三方系统商品id
    • └ qty
    • Number
    • 可选
    • 2
    • 件数
    • └ totalPrice
    • Number
    • 必须
    • 500
    • 总金额。无小数位,保留到分位。如500,等于5元
    • └ extraInfo
    • String
    • 可选
    • {"key":"jsonstring"}
    • 备注
    nonDeductiblePrice Number 可选 900
  • 默认值:0
  • 不可用积分抵扣的金额。无小数位,保留到分位。如500,等于5元
    extInfo String 可选 {"key":"jsonstring"} 备注

    响应参数

    名称 类型 示例值 描述
    data Data 返回对象
    • └ total
    • Number
    • 500
    • 积分余额
    • └ maxAvailable
    • Number
    • 200
    • 本单最大可用积分数
    • └ calcNo
    • String
    • abcde
    • 查询单据号
    • └ extraInfo
    • String
    • "json"
    • 备用字段
    success Boolean true 请求成功标识
    respMsg String succ 错误描述
    respCode String 200 错误码

    请求示例

    {"traceId":"123","dutyfreeType":"11","phone":"13101239876","outerUserId":"789","nonDeductiblePrice":900,"userId":"123","items":[{"gz":"10100602","totalPrice":500,"qty":2,"outerId":"12392","id":"231024","extraInfo":"{\"key\":\"jsonstring\"}"}],"usePoints":100,"extInfo":"{\"key\":\"jsonstring\"}"}

    响应示例

    {
        "data":{
            "total":500,
            "maxAvailable":200,
            "calcNo":"abcde",
            "extraInfo":"\"json\""
        },
        "success":true,
        "respMsg":"succ",
        "respCode":"200"
    }

    验签示例

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

    错误码解释

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

    API工具

    FAQ

    返回
    顶部