注意:以下文档只适用于TOP接口,请谨慎使用!

文档中心 > 基础技术

taobao.trade.fullinfo.get 中常用订单金额说明

更新时间:2018/04/13 访问次数:3717

名词解释

主订单和子订单:一个主订单(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(商品数量)。

不常用金额字段:order.part_mjz_discount(子订单分摊金额,把主订单优惠根据子订单payment比例分摊,商家参考用),trade.adjust_fee/order.adjust_fee(调整金额,如:卖家手动修改订单价格,官方数据修复等等),trade.total_fee(主订单应付金额,参考使用),order.total_fee(子订单应付金额,参考使用)

如果只是要看总订单买家付款金额,只看主订单payment就好了 ;如果是计算优惠,一般查看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就好了。

 

涉及开发票使用的字段,比如双十一大促使用的字段:

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>

FAQ

关于此文档暂时还没有FAQ
返回
顶部