退款退貨場景


一、說明

        本文檔物件導向為存取退款退貨API開發天貓商家退款退貨管理功能的第三方開發者（下文簡稱：isv）或自主開發的商家。
        本文檔將涵蓋API呼叫場景及注意事項，天貓與市集的退款退貨API將統一為一大套介面對外開放；API權限透過證書中心進行申請，處理時間一般為5個工作天以內。
       對於原有已經接入tmall.eai.*介面進行天貓退款退貨處理的，在處理具體退款單時，務必先重新同步一次退款數據。
       問題交流群組請加入： 1408358214

二、 呼叫流程

TB1qcP3GFXXXXbXXFXXwu0bFXXX.png

三、退款狀態變更

##         退款單的狀態可以在Refund資料結構中的Status獲取，會根據退款操作的變更而變更。
        關於退款單狀態的變更情況請參考上文天貓退款退貨流程，以下清單僅作描述，現有的退款單狀態：

API

#描述

說明

#WAIT_SELLER_AGREE

##買家已經申請退款，等待賣家同意

#買家提交退款申請時的狀態

WAIT_BUYER_RETURN_GOODS

賣家已經同意退款，等待買家退貨

當退款申請包含退貨時，賣家同意退貨（後台或taobao.rp.returngoods.agree）後的狀態

########## WAIT_SELLER_CONFIRM_GOODS###################買家已經退貨，等待賣家確認收貨###################退款申請包含退貨，買家上傳退貨串流資訊後的狀態#########################SELLER_REFUSE_BUYER######

賣家拒絕退款

#賣家拒絕退貨或拒絕退款時

########## ################SUCCESS###################退款成功############ ######賣家批次同意退款作業後的狀態########################CLOSED########## ########退款關閉#######

退款申請逾時或未出貨的訂單申請退款時賣家強制出貨後的狀態

#

四、 FAQ

1. 批次同意退款（taobao.rp.refunds.agree）操作說明

        taobao.rp .refunds.agree介面僅允許子帳號授權呼叫,並且集市支援批量(20筆以內，總金額6000以內)，天貓支援30筆以內，總金額10000以內。此介面分兩個階段，第一次不帶Code參數，系統會發送驗證碼到目前授權所代表的子帳號使用者註冊的手機上，第二次帶Code參數（參數內容為驗證碼），執行同意退款打款操作，呼叫成功，則直接將支付寶打款給買家。
        目前呼叫 API所使用的子帳號必須在子帳號後台授權退款作業的權限，並設定特定的作業限額。
入參refund_infos說明
對於集市，包含資訊如下：RefundId（退款單ID）、Fee（退款金額）、Version（透過Refund資料結構取得）
對於天貓，包含的資料有退款ID|其對應的金額|對應版本號列表|退款階段（onsale\aftersale），其中金額以分為單位，ID與金額以「|」符號分隔，多筆訂單以「,」分隔
格式：
RefundId1|Fee1|Version1|Refund_phase,RefundId2|Fee2|Version2|Refund_phase ...
##範例：
192242532288979|6000|12312|onsale,192242532298979|6000|32112|onsale
#是否退款成功#cc#cc#ccess#ccess#ccess為true，全部成功，ISV需要取到results後逐一判斷是否成功
2. 如何知道是否有退貨？
     透過Refund. has_good_return判斷，true為既退款又退貨，false只退款
3. 如何取得退款單的refund_phase和refund_version
    可以透過查詢介面從Refund獲取
4. 買家修改退款申請後賣家操作退款單有何影響
     買家修改退款申請後，退款的refund_version會變化，退款操作時會校驗refund_version,操作中可透過taobao.refund.get介面查詢具體退款單的Refund資訊。
5. 天貓暫時不支援退款留言的操作；
6. 目前不支援同意退款介面只呼叫一次即完成退款操作，由於介面呼叫會直接打款至支付寶，基於安全必須透過獲取簡訊的方式完成退款。
7. 目前僅對同意退款操作要求僅允許子帳號授權操作退款，即使用子帳號授權取得到的SessionKey或AccessToken呼叫taobao.rp.refunds.agree。如何使用子帳號授權參考：
//open.taobao.com/doc/detail.htm?spm=a219a.7386797.0.0.dXrNao&id=101141
特別需要注意，需要保證此子帳號擁有客戶服務-售中售後管理-同意退款（集市需要交易管理-子帳號售中退款-同意子帳號退款）的權限點。
 
8. 沙箱不支援同意退款的調試
9. 同意退款介面回傳的error_code清單有：
1000010001#40001#作業失敗

編號

#發送二次驗證簡訊成功

#發送二次驗證簡訊失敗

###10002###################二次驗證碼前5分鐘內已發出#######

10003

#驗證簡訊碼失敗

#10004

#簡訊驗證碼逾時（15分鐘）

#10005

#沒有輸入簡訊驗證碼

################################ ##############10006###################請先取得驗證碼############ ############20000#######

申請退款筆數超過限制

#20001

申請退款金額超過限制

#30000

退款編號不合法

#30001

退款不存在

#30002

天貓訂單

#

40000

#作業成功

##作業失敗

##40002

#部分操作失敗

################################################################## ####40003##################作業失敗系統例外############################################## #50000######

非子帳號

#60000
#####退款單版本已經變更########################60001################################### ########申請金額與其實不合#########################99999###############################999999############ ######其它異常###################

五、涉及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

天貓商家回填退款物流單號

#

taobao.rp.refund.review

退款單標記

taobao.refund.refuse

拒絕退款

taobao.rp.refunds.agree

批次同意退款

FAQ

  • #關於此文件暫時還沒有FAQ
←
→