淘宝api交易和订单关于价格的研究

先来看一笔典型的淘宝交易

这里我约定几个淘宝api的概念名词以便后续的研究

 

名词

区域字母

解释

交易

 

平常我们更多的是说订单，但是按照淘宝api的数据字典。其实严格意义上来说是交易。

子订单

A

子订单就是一笔交易里面的子订单，因为买家可能买了几款宝贝，像上图就是3个子订单

商品价格

B

B字母的红框区域，就是宝贝的吊牌价，就是一口价，没有经过打折计算的

子订单优惠

C

看上图的优惠两个字，它是对着的是商品的优惠角度来说的。

系统优惠

D

针对整比交易的优惠，包括（使用优惠券，满就减，VIP）

手动调整价格

 

上图没有体现出来。就是卖家手动修改的价格，比如退换的

邮费

E

E红框区域

订单应付

F

实收款就是支付宝金额。这个实收款不代表最后卖家能支配的金额 ，后面会解释     

 

下面是整理的价格流程图

从流程图可以看到F区域的实收是针对于买家来说的。如果针对卖家的实收，应该是把退款和佣金包括在内，最后才是我们能支配拿出来用的钱。

 

 

 

 

以下是笔者根据api文档整理的关于价格的字段

 

 

trade

 

order

 

 

卖家手工调整金额，
精确到2位小数，
单位：元。如：200.07，表示：200元7分。
来源于订单价格修改，如果有多笔子订单的时候，
这个为0，单笔的话则跟[order].adjust_fee一样

手工调整金额

adjust_fee

 

adjust_fee

手工调整金额

手工调整金额.格式为:1.01;
单位:元;精确到小数点后两位

系统优惠金额（如打折，VIP，满就送，店铺优惠券等），
精确到2位小数，
单位：元。如：200.07，表示：200元7分

系统优惠金额

discount_fee

 

discount_fee

订单优惠金额

订单优惠金额。精确到2位小数;
单位:元。如:200.07，表示:200元7分

商品标准价格。精确到2位小数；单位：元。
如：200.07，表示：200元7分
当有一笔子订单api才会返回改字段

单个商品价格（标准单价）

price

 

price

商品价格（标准单价）

商品价格。精确到2位小数;
单位:元。如:200.07，表示:200元7分

商品购买数量。取值范围：大于零的整数
当有一笔子订单api才会返回改字段

商品购买数量

num

 

num

购买数量

购买数量。取值范围:大于零的整数

商品金额（商品标准价格乘以数量的总金额）。
精确到2位小数;单位:元。如:200.07，表示:200元7分

商品金额

total_fee

 

total_fee

应付金额(不包含交易的优惠金额)

应付金额（商品价格*商品数量+手工调整金额-订单优惠金额）
。精确到2位小数;单位:元。如:200.07，表示:200元7分

邮费。精确到2位小数;
单位:元。如:200.07，表示:200元7分

邮费

post_fee

 

 

 

 

实付金额。精确到2位小数;
单位:元。如:200.07，表示:200元7分

实付金额

payment

 

payment

实付金额

子订单实付金额。精确到2位小数，
单位:元。如:200.07，表示:200元7分。
计算公式如下：payment = price * num + adjust_fee - discount_fee + post_fee
(单笔子订单时子订单实付金额包含邮费和交易级别系统优惠金额，多笔子订单时不包含邮费，也不包含交易级别的系统优惠金额)；
对于退款成功的子订单，由于主订单的优惠分摊金额，
会造成该字段可能不为0.00元。
建议使用退款前的实付金额减去退款单中的实际退款金额计算。