淘宝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元。 建议使用退款前的实付金额减去退款单中的实际退款金额计算。