基础技术
一、名词解释
名词名称 |
名词解释 |
| 主订单和子订单 | 一个主订单（trade）可以包涵多个子订单（order）， 产生的场景：通过购物车对多个商品下单，会变成一个主订单，这些不同的商品就是多个子订单。 |
商品级优惠 |
对单个商品的，常见如 商品原价的8折；商品原价的减50元。 |
订单级优惠 |
对主订单的优惠，常见的，店铺优惠券10元；订单满200元减10元；订单满80包邮。 |
大促优惠 |
特殊类型，透出方式不定。如双11购物券；购物津贴，跨店满减，品类券，双11红包，充值红包，满返红包，战队红包等；涉及平台出资的需要给平台开发票。 |
二、订单金额说明
以一个订单为例，主要使用的金额字段：
字段 |
解释 |
payment |
主订单实付金额 |
discount_fee |
主订单优惠 |
post_fee |
订单邮费 |
promotion_details |
订单优惠信息明细，商品和订单级优惠一般都在里面 |
order.payment |
子订单实付金额，不算主订单分摊金额 |
order.discount_fee |
子订单商品优惠 |
order.price |
商品原价 |
order.num |
商品数量 |
part_mjz_discount |
子订单分摊金额 |
divide_order_fee |
分摊后子订单实付金额 |
不常用金额字段：
字段 |
解释 |
trade.adjust_fee/order.adjust_fee |
调整金额，如：卖家手动修改订单价格，官方数据修复等等 |
trade.total_fee |
主订单应付金额，参考使用 |
order.total_fee |
子订单应付金额，参考使用 |
要看买家订单付款金额，只看主订单payment就好了；看子订单的实付金额可以参考 divide_order_fee 分摊主订单优惠以后的子订单实付金额。
要看主订单优惠，查看promotion_details 里面的优惠明细即可，其中的信息就是 trade.discount_fee 和 order.discount_fee的详细说明。
子订单分摊优惠基础逻辑：一般正常优惠券和满减优惠按照子订单的金额进行分摊，特殊情况如果优惠券是指定商品使用的，只会分摊到对应商品子订单上不分摊。
一般的金额计算规则：
trade.payment = order1.payment+order2.payment - trade.discount_fee + trade.post_fee + X 。
order.payment = order.price*order.num - order.discount_fee 。
其中X表示其它不常用优惠字段的说明，因为对不同类目，不同活动订单上金额透出都有区别，比如：天猫国际订单有 关税税费；预售订单分定金和尾款；货到付款订单有 服务费；家装电器有服务子订单服务费。 需要开发者通过生成不同的订单去做验证和计算，原则上看主订单payment就好了。
涉及开发票使用的字段，比如2016年双十一大促使用的字段：
1）platform_subsidy_fee：该字段纪录了主订单中涉及天猫出资的购物券金额，包括：购物津贴中天猫的出资金额部分，天猫购物券-品类券中天猫的出资金额部分，天猫出资的天猫购物券金额，天猫出资的天猫购物券-行业券金额。以上四种涉及金本位的购物券互斥，一个订单中只会使用一种，该部分金额需要您开票给天猫。如果需要获取订单中使用的购物券中的天猫出资金额，可通过API接口taobao.trade.fullinfo.get的platform_subsidy_fee字段查询。
2）recharge_fee：本次双十一全民充红包玩法中，部分红包是用户个人红包，是买家个人资金的一种体现形式，针对这部分红包，商家应向消费者开具合规发票。如果要获取本次订单中使用了多少个人红包，可通过taobao.trade.fullinfo.get中字段recharge_fee查询。
三、示例说明
下面的主订单有两个子订单。
订单实付： trade.payment=198.00 ；订单邮费：5元 ；
商品级优惠 圣诞价:省29.00元 和 圣诞价:省150.00元； 订单级优惠，圣诞2:省5.00元；
商品1：原价108元，优惠 29元，子订单实付79元 ，分摊主订单优惠 1.99元；
商品2：原价269 ，优惠150元，子订单实付119元，分摊主订单优惠 3.01元；
<trade_fullinfo_get_response> <trade> <orders> <order> <adjust_fee>0.00</adjust_fee> <num>1</num> <oid>99397929493403805</oid> <discount_fee>29.00</discount_fee> //OD1 <part_mjz_discount>1.99</part_mjz_discount> <payment>79.00</payment> //OP1 <price>108.00</price> <title>乐高积木lego 40125圣诞老人派礼物儿童男孩女孩玩具</title> <total_fee>79.00</total_fee> </order> <order> <adjust_fee>0.00</adjust_fee> <num>1</num> <oid>99397929494403805</oid> <discount_fee>150.00</discount_fee> //OD2 <part_mjz_discount>3.01</part_mjz_discount> <payment>119.00</payment> //OP2 <price>269.00</price> <title>乐高创意闹钟儿童学生蝙蝠侠超人幻影忍者未来骑士团人仔玩偶摆件</title> <total_fee>119.00</total_fee> </order> </orders> <coupon_fee>0</coupon_fee> <discount_fee>5.00</discount_fee> //TD1 <payment>198.00</payment> //TP1 <post_fee>5.00</post_fee> <total_fee>377.00</total_fee> <pcc_af>0</pcc_af> <point_fee>0</point_fee> <promotion_details> <promotion_detail> <discount_fee>150.00</discount_fee> <id>99397929494403805</id> <promotion_desc>圣诞价:省150.00元</promotion_desc> <promotion_id>ATA1$150429101209-5444145498_29397263708</promotion_id> <promotion_name>圣诞价</promotion_name> </promotion_detail> <promotion_detail> <discount_fee>5.00</discount_fee> <id>99397929492403805</id> <promotion_desc>圣诞2:省5.00元</promotion_desc> <promotion_id>shopbonus-5448912639_29203594338-385932890549</promotion_id> <promotion_name>圣诞2</promotion_name> </promotion_detail> <promotion_detail> <discount_fee>29.00</discount_fee> <id>99397929493403805</id> <promotion_desc>圣诞价:省29.00元</promotion_desc> <promotion_id>ATA1$150429101209-5444145498_29481970127</promotion_id> <promotion_name>圣诞价</promotion_name> </promotion_detail> </promotion_details> </trade> </trade_fullinfo_get_response>