到家侧接口开发规范
API功能描述
订单级促销活动提交接口
接口地址:https://openapi.jddj.com/djapi/orderdiscount/submitActivity
授权类型
是
应用场景
接口有幂等性限制,同一orgCode+outActivityId一分钟内只能提交一次。
所有金额单位统一为:分。
促销规则说明:
1、满减(1):
满减下限(lowerLimitAmount):大于0,大于优惠金额,不超过10000元
优惠金额(discountAmount):大于0
阶梯限售单量(ladderLimit):不小于0,不超过10万
2、每满减(2210):
满减下限(lowerLimitAmount):大于0,大于优惠金额,不超过10000元
优惠金额(discountAmount):大于0
最高优惠次数(upperLimitCount):大于0,不超过100次
3、满件减(1206):
满件下限(lowerLimitCount):大于0
优惠金额(discountAmount):大于0,不超过10000元
4、满件折(1207):
满件下限(lowerLimitCount):大于0
优惠折扣(discountRate):折扣范围(最小1折,最大9.99折),小数点两位
5、换购(1202):
换购下限(lowerLimitAmount):大于0,不超过10000元
可选换购品数(lowerLimitCount):大于0,不超过已选择数量
List:OpGiftRequest-->赠品sku(skuId):不能为空、赠品库存(stockCount):大于0
加价(addPrice):大于0
6、捆绑(1208):
X元(discountAmount):大于0,不超过10000元
Y件(lowerLimitCount):大于1
7、满赠(1203):
满赠下限(lowerLimitAmount):大于0,不超过10000元
可选赠品数(lowerLimitCount):大于0,不超过已选择数量
List:OpGiftRequest-->赠品sku(skuId):不能为空、赠品库存(stockCount):大于0
8、支持的最大阶梯数量:
满减(1):3
换购(1202):3
满赠(1203):3
满件减(1206):3
满件折(1207):3
捆绑(1208):1
每满减(2210):1
9、支持全场维度的促销类型:
满减(1)
换购(1202)
满赠(1203)
每满减(2210)
系统级别输入参数
字段 | 类型 | 是否必须 | 描述 |
token | String | 是 | 采用OAuth授权方式为必填参数 |
app_key | String | 是 | 应用的app_key |
sign | String | 是 | 签名 |
timestamp | String | 是 | 时间戳,格式为yyyy-MM-dd HH:mm:ss,例如:2011-06-16 13:23:30 |
format | String | 是 | 暂时只支持json |
v | String | 是 | API协议版本,可选值:1.0 |
应用级别输入参数
字段 | 类型 | 是否必须 | 示例值 | 描述 |
返回结果
字段 | 类型 | 示例值 | 描述 |
code | String | 0 | 0表示成功,其他均为失败。 详见:到家平台状态码说明 |
msg | String | 操作成功 | 结果描述 |
+data | String | ,该属性值为字符串型JSON数据,请先按照字符串取值,再解析转换成JSON对象。 |
返回示例值
JSON 数据格式