一、 說明
本文檔面向?qū)ο鬄榻尤胪丝钔素汚PI開發(fā)天貓商家退款退貨管理功能的第三方開發(fā)者（下文簡稱：isv）或自主開發(fā)的商家。
本文檔將涵蓋API調(diào)用場景及注意事項(xiàng)，天貓與集市的退款退貨API將統(tǒng)一為一大套接口對(duì)外開放；API權(quán)限通過證書中心進(jìn)行申請(qǐng)，處理時(shí)間一般為5個(gè)工作日以內(nèi)。
對(duì)于原有已經(jīng)接入tmall.eai.*接口進(jìn)行天貓退款退貨處理的，在處理具體退款單時(shí)，務(wù)必先重新同步一次退款數(shù)據(jù)。
問題交流群請(qǐng)加入：
1408358214
二、 調(diào)用流程
三、 退款狀態(tài)變化
退款單的狀態(tài)可以在Refund數(shù)據(jù)結(jié)構(gòu)中的Status獲取，會(huì)根據(jù)退款操作的變化而變化。
關(guān)于退款單狀態(tài)的變化情況請(qǐng)參考上文天貓退款退貨流程，以下列表僅做描述，現(xiàn)有的退款單狀態(tài)：
API | 描述 | 說明 |
WAIT_SELLER_AGREE | 買家已經(jīng)申請(qǐng)退款，等待賣家同意 | 買家提交退款申請(qǐng)時(shí)的狀態(tài) |
WAIT_BUYER_RETURN_GOODS | 賣家已經(jīng)同意退款，等待買家退貨 | 退款申請(qǐng)包含退貨時(shí)，賣家同意退貨（后臺(tái)或者taobao.rp.returngoods.agree）后的狀態(tài) |
WAIT_SELLER_CONFIRM_GOODS | 買家已經(jīng)退貨，等待賣家確認(rèn)收貨 | 退款申請(qǐng)包含退貨，買家上傳退貨物流信息后的狀態(tài) |
SELLER_REFUSE_BUYER | 賣家拒絕退款 | 賣家拒絕退貨或者拒絕退款時(shí) |
SUCCESS | 退款成功 | 賣家批量同意退款操作后的狀態(tài) |
CLOSED | 退款關(guān)閉 | 退款申請(qǐng)超時(shí)或者未發(fā)貨的訂單申請(qǐng)退款時(shí)賣家強(qiáng)制發(fā)貨后的狀態(tài) |
四、 FAQ
1. 批量同意退款（taobao.rp.refunds.agree）操作說明
taobao.rp.refunds.agree接口僅允許子賬號(hào)授權(quán)調(diào)用,并且集市支持批量(20筆以內(nèi)，總金額6000以內(nèi))，天貓支持30筆以內(nèi)，總金額10000以內(nèi)。 該接口分兩個(gè)階段，第一次不帶Code參數(shù)，系統(tǒng)會(huì)發(fā)送驗(yàn)證碼到當(dāng)前授權(quán)所代表的子賬號(hào)用戶注冊(cè)的手機(jī)上，第二次帶Code參數(shù)（參數(shù)內(nèi)容為驗(yàn)證碼），執(zhí)行同意退款打款操作，調(diào)用成功，則直接將支付寶打款給買家。
當(dāng)前調(diào)用 API所用的子賬號(hào)必須在子賬號(hào)后臺(tái)授權(quán)退款操作的權(quán)限，并設(shè)定具體的操作限額。
入?yún)efund_infos說明
對(duì)于集市，包含信息如下：RefundId（退款單ID）、Fee（退款金額）、Version（通過Refund數(shù)據(jù)結(jié)構(gòu)獲取）
對(duì)于天貓，包含的數(shù)據(jù)有退款I(lǐng)D|其對(duì)應(yīng)的金額|對(duì)應(yīng)版本號(hào)列表|退款階段（onsale\aftersale），其中金額以分為單位，ID與金額以“|”符號(hào)分隔，多筆訂單以“,”分隔
格式：
RefundId1|Fee1|Version1|Refund_phase,RefundId2|Fee2|Version2|Refund_phase ...
示例：
192242532288979|6000|12312|onsale,192242532298979|6000|32112|onsale
判斷是否退款成功
success為true時(shí)，不一定全部成功，ISV需要取到results后逐個(gè)判斷是否成功
2. 如何知道是否有退貨？
通過Refund. has_good_return判斷，true為既退款又退貨，false僅退款
3. 如何獲取退款單的refund_phase和refund_version
可以通過查詢接口從Refund中獲取
4. 買家修改退款申請(qǐng)后賣家操作退款單有什么影響
買家修改退款申請(qǐng)后，退款的refund_version會(huì)變化，退款操作時(shí)會(huì)校驗(yàn)refund_version,在操作中可以通過taobao.refund.get接口查詢具體退款單的Refund信息。
5. 天貓暫時(shí)不支持退款留言的操作；
6. 目前不支持同意退款接口只調(diào)用一次即完成退款操作，由于接口調(diào)用會(huì)直接打款至支付寶，基于安全必須通過獲取短信的方式完成退款。
7. 目前僅對(duì)同意退款操作要求僅允許子賬號(hào)授權(quán)操作退款，即使用子賬號(hào)授權(quán)獲取到的SessionKey或者AccessToken調(diào)用taobao.rp.refunds.agree。如何使用子賬號(hào)授權(quán)參考：
//open.taobao.com/doc/detail.htm?spm=a219a.7386797.0.0.dXrNao&id=101141
特別需要注意，需要保證該子賬號(hào)擁有客戶服務(wù)-售中售后管理-同意退款（集市需要交易管理-子賬號(hào)售中退款-同意子賬號(hào)退款）的權(quán)限點(diǎn)。
8. 沙箱不支持同意退款的調(diào)試
9. 同意退款接口返回的error_code列表有：
編號(hào) | 含義 |
10000 | 發(fā)送二次驗(yàn)證短信成功 |
10001 | 發(fā)送二次驗(yàn)證短信失敗 |
10002 | 二次驗(yàn)證碼前5分鐘內(nèi)已發(fā)出 |
10003 | 驗(yàn)證短信碼失敗 |
10004 | 短信驗(yàn)證碼超時(shí)（15分鐘） |
10005 | 沒有輸入短信驗(yàn)證碼 |
10006 | 請(qǐng)先獲取驗(yàn)證碼 |
20000 | 申請(qǐng)退款筆數(shù)超過限制 |
20001 | 申請(qǐng)退款金額超過限制 |
30000 | 退款編號(hào)不合法 |
30001 | 退款不存在 |
30002 | 天貓訂單 |
40000 | 操作成功 |
40001 | 操作失敗 |
40002 | 部分操作失敗 |
40003 | 操作失敗 系統(tǒng)異常 |
50000 | 非子帳號(hào) |
60000 | 退款單版本已經(jīng)發(fā)生變化 |
60001 | 申請(qǐng)金額與其實(shí)不合 |
99999 | 其它異常 |
五、 涉及API
API文檔鏈接：
//open.taobao.com/doc/api_cat_detail.htm?scope_id=11527&category_id=102
API | 功能描述 |
taobao.user.seller.get | 查詢商家信息 |
taobao.refunds.receive.get | 查詢退款列表 |
taobao.refund.get | 查詢單筆退款 |
taobao.rp.returngoods.refuse | 拒絕退貨 |
taobao.rp.returngoods.agree | 同意退貨 |
taobao.rp.returngoods.refill | 天貓商家回填退款物流單號(hào) |
taobao.rp.refund.review | 退款單標(biāo)記 |
taobao.refund.refuse | 拒絕退款 |
taobao.rp.refunds.agree | 批量同意退款 |
FAQ
