订单优惠前置咨询

本接口用于前置优惠咨询，包括本订单可享的优惠券列表，注意该列表并不等价于最终核销时使用的券列表，而是包含了咨询的那一刻该订单能用的所有券，且券满足叠加使用下的互斥等规则

curl --location --request POST 'http://dev-cn.your-api-server.com/v3/alipay/marketing/campaign/order/voucher/consult' \ --header 'Content-Type: application/json' \ --data-raw '{ "business_param": "{\"useBigAmountSkipOrderThold\":\"N\"}", "item_consult_list": [ { "item_id": "20210105003", "price": "20.29", "quantity": "3" } ], "order_amount": "120.87", "specified_app_id": "2021001159604390", "scene_code": "[\"DEFAULT\"]" }'

{ "optimal_total_promo_amount": "15.50", "voucher_consult_list": [ { "item_promo_info": { "item_consult_list": [ { "item_id": "20210105003", "promo_amount": "3.0", "promo_count": "2" } ], "item_cover_pic": "https://gw.alipayobjects.com/mdn/rms_9822d7/afts/img/A*1F4eSaaPHRQAAAAAAAAAAABkARQnAQ", "item_desc": "宝洁洗护用品促销", "item_name": "宝洁洗护用品", "item_detail_pic_list": "[\"https://gw.alipayobjects.com/mdn/rms_9822d7/afts/img/A*1F4eSaaPHRQAAAAAAAAAAABkARQnAQ\"]" }, "ceiling_amount": "4.0", "optimal": true, "promo_amount": "30.00", "promo_text": "大杯拿铁限时享受满10减1", "promo_type": "FIX", "reduction_amount": "2.0", "reduction_ratio": "0.7", "specified_amount": "32.0", "threshold_amount": "120.00", "voucher_id": "202010220007300232330005DGEE", "voucher_name": "商家全场5折优惠", "voucher_type": "ALL" } ] }

请求参数

Query 参数

auth_token

string

用户授权令牌

可选

Body 参数application/json

business_param

string

可选

业务参数大字段，优惠咨询的控制参数，json格式；目前支持传入useBigAmountSkipOrderThold为N来控制不使用大金额跳过优惠的订单门槛检查；默认不传；

示例值:

{"useBigAmountSkipOrderThold":"N"}

item_consult_list

array[object (ItemConsultRequest) {3}]

可选

商品咨询请求列表（当需要咨询单品券时必传，如果某商品不希望参与本次单品优惠咨询则不传递对应信息即可）

item_id

string

商品id

可选

示例值:

20210105003

price

string

可选

商品单价，单位为元，最多2位小数

示例值:

20.29

quantity

string

商品数量

可选

示例值:

order_amount

string

可选

订单金额（如同时享受商户自有优惠请先扣除后传入），单位为元，最多2位小数

示例值:

120.87

specified_app_id

string

可选

券指定的核销appid（如果配券时指定了核销范围为线上小程序及相应的appid则此处必传）

示例值:

2021001159604390

scene_code

array[string]

可选

场景码：默认(DEFAULT)

示例值:

["DEFAULT"]

示例

返回响应

🟢200common response

application/json

Body

optimal_total_promo_amount

string

可选

最优券叠加总优惠金额，单位为元

示例值:

15.50

voucher_consult_list

array[object (VoucherConsultInfo) {13}]

优惠券咨询结果列表

可选

item_promo_info

object (ItemPromoInfo)

可选

ceiling_amount

string

可选

封顶优惠金额，单位为元

示例值:

4.0

optimal

boolean

可选

是否为可使用的互斥券中最优的（目前返回的记录该值均为true，即可忽略该值判断）

示例值:

true

promo_amount

string

可选

优惠总金额，单位为元

示例值:

30.00

promo_text

string

优惠文案

可选

示例值:

大杯拿铁限时享受满10减1

promo_type

string

可选

优惠类型：代金(FIX),折扣(DISCOUNT),减至(SPECIAL，即特价券)

示例值:

FIX

reduction_amount

string

可选

满减金额，单位为元，仅针对代金券

示例值:

2.0

reduction_ratio

string

可选

优惠额度，如3折券，返回0.7，仅针对折扣券

示例值:

0.7

specified_amount

string

可选

减至金额，单位为元，仅针对减至券

示例值:

32.0

threshold_amount

string

可选

优惠门槛，单位为元（部分券没有门槛金额）

示例值:

120.00

voucher_id

string

券id

可选

示例值:

202010220007300232330005DGEE

voucher_name

string

券名称

可选

示例值:

商家全场5折优惠

voucher_type

string

可选

券类型： 1）全场券(ALL) 2）单品券(ITEM)

示例值:

ALL

🔴500请求失败