营销查询算价二合一

​使用限制​

​接口说明​

​基本信息​

​请求头​

​请求参数​

​msg 字段​

1.​need_default_marketing=true，开发者需返回默认最优的营销组合和算价结果​

2.​need_default_marketing=false，且用户选中具体的优惠信息时(商品/订单的selected_marketing不为空)，开发者需返回用户选中优惠的算价结果​

3.​goods_marketing_info和order_marketing_info结构体中selected_marketing的区别是优惠适用的维度不同：​

◦​goods_marketing_info下的优惠是作用于具体商品的，比如星冰乐单品优惠立减5元​

◦​order_marketing_info下的优惠是作用于整个订单的，比如订单满200-20​

◦​对于一个具体的优惠券，不能同时出现在goods_marketing_info和order_marketing_info中，它适用的优惠维度是明确的​

​goods_marketing_info 元素结构说明​

​order_marketing_info 结构说明​

​membership_info 元素结构说明​

​coupon_info 元素结构说明​

​activity_info 元素结构说明​

​score_info 元素结构说明​

​请求示例​

•​这个请求表达的含义是：用户(M3arp6xWNPyvKnHf)准备购买1份商品(7116845279713691692)，订单原始金额100分，请返回这笔订单可用的优惠信息以及默认最佳优惠的算价结果​

​响应参数​

​data 字段​

1.​如果响应中无data字段，系统认为无可用营销信息​

2.​如果请求中用户所选的营销不可用（包含1中情况），即用户之前的选择失效，此时外部服务应该报错（err_no不为0）并给出有效的说明信息（err_tips）​

3.​如果data中无calculation_result字段，系统认为无算价信息，会用商品原价作为算价结果参与后续校验​

4.​goods_marketing_result和order_marketing_result下都有available_marketing和unavailable_marketing字段，它们的区别是优惠适用的维度不同：​

◦​goods_marketing_result下的available和unavailable优惠是针对商品的。举个例子，对于商品星冰乐，星冰乐单品优惠券属于available，蛋糕单品优惠券属于unavailable​

◦​order_marketing_result下的available和unavailable优惠是针对订单的。举个例子，总价150的订单，满100-5的优惠券属于available，满200-20优惠券属于unavailable​

◦​对于一个具体的优惠券，不能同时出现在goods_marketing_result和order_marketing_result中，它适用的优惠维度是明确的​

5.​order_marketing_result.total_amount = sum(goods_marketing_result.total_amount)​

​goods_marketing_result 元素结构说明​

​order_marketing_result 元素结构说明​

​calculation_result 元素结构说明​

1.​订单原价total_amount，订单总优惠total_discount_amount = goods层的优惠聚合 = item层的优惠聚合​

◦​total_amount = sum(goods_calculation_result_info.total_amount) = sum(item_calculation_result_info.total_amount)​

◦​total_discount_amount=sum(goods_calculation_result_info.total_discount_amount)=sum(item_calculation_result_info.total_discount_amount)​

◦​goods_calculation_result_info，item_calculation_result_info表达的是优惠分摊逻辑。例如，订单有N个goods，每个goods有M个item，item表示单份商品。​

2.​calculation_type表示优惠分摊的类型，开发者可选择将优惠分摊到商品(goods层)或者每一份商品(item层)​

◦​calculation_type=1，开发者将优惠分摊到goods层，需返回goods_calculation_result_info，交易系统会按均摊逻辑帮开发者计算到item层​

◦​calculation_type=2，开发者将优惠分摊到item层，需返回item_calculation_result_info​

3.​举个例子，一笔订单购买2杯奶茶，总价100元，使用80-10活动和星冰乐单品立减5元优惠券，实付金额85元，表达分摊的逻辑如下​

◦​订单总优惠金额 total_discount_amount =1500，单位[分]​

◦​goods层，goods_calculation_result_info数组长度为1，goods[0].total_discount_amount=1500​

◦​item层，item_calculation_result_info数组长度为2，items[0].total_discount_amount=750，items[1].total_discount_amount=750​

​​

​goods_calculation_result_info 元素结构说明​

•​是列表，列表的每一项表示一种商品​

•​商品 total_discount_amount 和营销明细聚合结果必须一致。​

◦​total_discount_amount = sum(marketing_detail.discount_amount)​

​item_calculation_result_info 元素结构说明​

•​是列表，列表的每一项，表示单份商品​

•​item total_discount_amount 和营销明细聚合结果必须一致。​

◦​total_discount_amount = sum(marketing_detail.discount_amount)​

​MarketingDetail 结构说明​

•​当 value 不为 0 的时候，discount_amount 不能为 0（即不允许消耗积分却没有折扣）。​

•​discount_range，表示优惠的维度，举个例子​

◦​星冰乐单品5折券属于商品维度优惠，discount_range=2​

◦​订单满200-20属于订单维度优惠，discount_range=1​

​响应示例​

​正常示例​

​异常示例​

​错误码​