淘寶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元。 建議使用退款前的實付金額減去退款單中的實際退款金額計算。