淘宝开放平台优惠规则变更及相关TOP接口影响【商家及ISV重点关注】

尊敬的开发者：

      您好，平台针对天猫、淘宝市场的主业务，将于5月下旬更新优惠规则计算逻辑。更新前和更新后的逻辑如下：

      1、对于现货订单：

      更新前：子订单的优惠分摊计算后，若剩余应付金额为负为0时，则剔除该层优惠。如子订单金额是10元，分摊至该子订单的优惠金额是15元，导致子订单剩余应付金额为-5元，则剔除15元的优惠，用户不可享受该层优惠。

      更新后：子订单的优惠分摊计算后，若剩余应付金额(字段：orders.payment)为负为0时，优惠仍可用，直接将子订单剩余应付金额抵扣为0元。如子订单金额是10元，分摊至该子订单的优惠金额是15元，导致子订单剩余应付金额为-5元，则将优惠按照10元面值使用，直接将子订单剩余应付金额抵扣为0元。

      2、对于预售订单：

      更新前：在预售订单支付尾款的阶段，优惠分摊计算后，若尾款剩余应付金额为负为0时，则尾款支付阻断，用户无法支付尾款。如预售订单，尾款阶段的金额是100元，分摊至尾款优惠金额是110元，导致尾款剩余应付金额为-10元，则用户无法支付尾款。

      更新后：在预售订单支付尾款的阶段，优惠分摊计算后，若尾款剩余应付金额为负为0时，优惠仍可用，直接将尾款剩余应付金额抵扣为0元，用户按照0元可正常支付尾款。如预售订单，尾款阶段的金额是100元，分摊至尾款的优惠金额是110元，则将优惠按照100元面值使用，直接将尾款剩余应付金额抵扣为0元，用户可正常支付尾款0元。

      在优惠规则更新后，对于现货订单，若主订单的每个子订单都被抵扣为0元，则主订单总应付金额为0元，0元主订单将不会在支付宝落单；对于预售订单，若尾款支付为0元，则将删除支付宝单据的尾款阶段。

      优惠规则的更新，对于TOP接口而言，将带来以下数据变化点：

      1、影响的TOP接口：

      taobao.trades.sold.get（查询卖家已卖出的交易数据（根据创建时间））

      taobao.trades.sold.increment.get（查询卖家已卖出的增量交易数据（根据修改时间））

      taobao.trade.get（获取单笔交易的部分信息(性能高)）

      taobao.trade.fullinfo.get （获取单笔详情）

      2、对应接口的返回字段的变化：

      TOP接口中的payment（实付金额）：在现货订单每个子订单均优惠到0元的场景下，子订单的payment字段值为0.00，主订单的payment字段值为0.00；在现货订单部分子订单优惠到0元的场景下，子订单的payment字段值为0.00，主订单的payment字段值非0。

      TOP接口中的alipay_no（支付宝账号）：在现货订单的主订单应付金额为0时（即主订单维度payment值为0.00时），不返回alipay_no字段。

      为便于商户和erp能够识别发生过优惠重新计算的子订单（即当优惠分摊为负为0时，重新按照原剩余应付金额分摊优惠的子订单，如子订单金额是10元，分摊至该子订单的优惠金额是15元，导致子订单剩余应付金额为-5元，则将优惠重新计算，按照10元面值使用，直接将子订单剩余应付金额抵扣为0元，该类子订单则发生过优惠重新计算），在以下接口中，将透出可识别该类子订单的标识（标识透出于2020年5月24日发布上线）：

      1、taobao.trade.fullinfo.get（获取单笔交易的详细信息）

      响应参数发生变更

      名称 ：is_devalue_fee

      含义： 子订单是否优惠标志，true表示子订单有优惠重新计算，否则不返回该字段

      路径：trade.orders

      类型：Boolean

      示例值：true

      2、taobao.trades.sold.increment.get（查询卖家已卖出的增量交易数据（根据修改时间））

      响应参数发生变更

      名称 ：is_devalue_fee

      含义： 子订单是否优惠标志，true表示子订单有优惠重新计算，否则不返回该字段

      路径：trade.orders

      类型：Boolean

      示例值：true

      3、taobao.trade.get（获取单笔交易的部分信息(性能高)）

      响应参数发生变更

      名称 ：is_devalue_fee

      含义： 子订单是否优惠标志，true表示子订单有优惠重新计算，否则不返回该字段

      路径：trade.orders

      类型：Boolean

      示例值：true

      4、taobao.trades.sold.get（查询卖家已卖出的交易数据（根据创建时间））

      响应参数发生变更

      名称 ：is_devalue_fee

      含义： 子订单是否优惠标志，true表示子订单有优惠重新计算，否则不返回该字段

      路径：trade.orders

      类型：Boolean

      示例值：true

      对于以上数据变化，请商家及erp服务商重点关注，看是否需要更新相关配置逻辑，以防影响正常履约、数据处理等相关服务。

      如您对以上内容有任何疑问，请开放平台支持中心提交工单咨询，感谢您的理解、支持与配合！

阿里巴巴.开放平台

2020年5月19日