### 使用描述 根據[批量查詢商品售后權益](批量查詢商品售后權益.md)接口返回的結果來創建售后單,[售后單初始狀態](查詢售后訂單詳情.md)為`待審核` ### [](https://duobaoyu.com.cn/documentcenter?onlyFlag=ddb99c0b0e143e98737ffc2dd794e33e#%E6%96%B9%E6%B3%95%E5%90%8D)方法名 dby.scm.aftersale.apply ### [](https://duobaoyu.com.cn/documentcenter?onlyFlag=ddb99c0b0e143e98737ffc2dd794e33e#%E7%BD%91%E5%85%B3%E5%9C%B0%E5%9D%80)網關地址 | 環境 | 地址 | 請求方式 | | --- | --- | --- | | 生產環境 | `https://openapi.duobaoyu.com.cn/open/api` | post+json | | 測試環境 | `https://openapi.duobaoyu88.cn/open/api` | post+json | ### [](https://duobaoyu.com.cn/documentcenter?onlyFlag=ddb99c0b0e143e98737ffc2dd794e33e#%E5%85%AC%E5%85%B1query%E5%8F%82%E6%95%B0)公共Query參數 * * * | 名稱 | 類型 | 必填 | 描述 | | --- | --- | --- | --- | | method | String | 是 | 方法名稱 | | sign | String | 是 | [簽名](簽名規則.md) | | timestamp | String | 是 | 時間戳,格式為13位,例如:1670223623000 | | version | String | 是 | 版本號,現固定為v1 | | appKey | String | 是 | 申請的應用appKey | ### [](https://duobaoyu.com.cn/documentcenter?onlyFlag=ddb99c0b0e143e98737ffc2dd794e33e#%E4%B8%9A%E5%8A%A1body%E5%8F%82%E6%95%B0applicationjson)業務Body參數(application/json) * * * | 名稱 | 類型 | 必填 | 示例值 | 描述 | | --- | --- | --- | --- | --- | | orderItemId | java.lang.String | 是 | 1595302620191391744 | 子訂單號 | | afterSaleType | java.lang.Integer | 是 | 3 | 售后類型：(1:退貨退款；2:換貨 3:維修 4:僅退款) 從[查詢商品售后權益中獲取](批量查詢商品售后權益.md)接口中獲取 | | buyerReceived | java.lang.String | 否 | true | 買家是否收到貨(true：已收到貨 false：未收到貨),從[查詢商品售后權益中獲取](批量查詢商品售后權益.md)接口中獲取,默認是false | | skuCode | java.lang.String | 是 | 50106182257 | 商品編號 | | skuNum | java.lang.Integer | 是 | 2 | 商品數量 ?? 注:如果售后類型為僅退款，則商品數量為非必填,如果是退貨退款，換貨，維修等，商品數量為必填項 | | reasonCode | java.lang.String | 是 | | 售后原因編碼 從[查詢商品售后權益中獲取](批量查詢商品售后權益.md)接口中獲取 | | reasonName | java.lang.String | 是 | | 售后原因說明 從[查詢商品售后權益中獲取](批量查詢商品售后權益.md)接口中獲取 | | remark | java.lang.String | 否 | | 售后描述（限100字符） | | refundFreightAmount | java.lang.Long | 是 | 800 | 期望退款運費 單位:分 僅做參考作用，具體以[查詢售后訂單詳情](查詢售后訂單詳情.md)的實際退款運費為準 | | vouchers | java.util.List | 否 | | 憑證圖片列表 從[查詢商品售后權益](批量查詢商品售后權益.md)接口中返回的needVoucher字段判斷是否必傳 | | pickUpWare | java.lang.Object | 否 | | 預約取件 如果售后類型為僅退款, 則預約取件為空,其他類型不能為空 | | ??├─pickupWare | java.lang.String | 否 | | 取件方式 從[查詢商品售后權益中獲取](批量查詢商品售后權益.md)接口中獲取 ?? 注:售后類型如果為僅退款，則取件方式為非必填，如果是退貨退款，換貨，維修等方式，則取件方式為必填項 | | ??├─consigneeProvinceCode | java.lang.String | 否 | | 取件省ID | | ??├─consigneeCityCode | java.lang.String | 否 | | 取件市ID | | ??├─consigneeCountyCode | java.lang.String | 否 | | 取件縣ID | | ??├─consigneeTownCode | java.lang.String | 否 | | 取件鄉鎮ID | | ??├─consigneeAddress | java.lang.String | 否 | | 收貨詳細地址 | | ??├─reserveDateBegin | java.lang.Long | 否 | | 預約取件開始時間(13位時間戳 例：1669305374031) | | ??├─reserveDateEnd | java.lang.Long | 否 | | 預約取件結束時間 (13位時間戳 例：1669305375031) | ### [](https://duobaoyu.com.cn/documentcenter?onlyFlag=ddb99c0b0e143e98737ffc2dd794e33e#%E5%93%8D%E5%BA%94%E5%8F%82%E6%95%B0)響應參數 * * * | 名稱 | 類型 | 示例值 | 描述 | | --- | --- | --- | --- | | code | java.lang.String | 0 | 業務編碼處理結果編碼 | | msg | java.lang.String | 請求成功 | 業務處理結果結果說明 | | data | java.lang.Object | | 響應結果 | | ??├─afterSaleOrderId | java.lang.String | 1597771590437830656 | 售后訂單號 | | ??├─result | java.lang.Boolean | true | 處理結果 | | msgId | java.lang.String | efd7f07011124adf | 消息id | ### [](https://duobaoyu.com.cn/documentcenter?onlyFlag=ddb99c0b0e143e98737ffc2dd794e33e#%E8%AF%B7%E6%B1%82%E7%A4%BA%E4%BE%8B)請求示例 curljavaphp ~~~json curl -XPOST -H "Content-type: application/json" -d '{ "afterSaleType":"1", "reasonCode":"11060778541", "reasonName":"包裝損壞", "vouchers":["https://xxxxxx/d36a88f001fa4cefb07b461f1b133561.png "], "skuCode":"50106182257", "skuNum":"1", "orderItemId":"1598946719310151680", "buyerReceived":true, "refundFreightAmount": 234, "pickUpWare":{ "pickupWare":"3", "consigneeProvinceCode":"31", "consigneeCityCode":"3101", "consigneeCountyCode":"310101", "consigneeTownCode":"310101002", "consigneeAddress":"和平大廈", "reserveDateBegin": 1669305374031, "reserveDateEnd": 1669305375031 } }' 'http://xxxxx/open/api?method=dby.scm.aftersale.apply&version=v1&appKey=your appKey&timestamp=1670057525000&sign=123' ~~~ ### [](https://duobaoyu.com.cn/documentcenter?onlyFlag=ddb99c0b0e143e98737ffc2dd794e33e#%E5%93%8D%E5%BA%94%E7%A4%BA%E4%BE%8B)響應示例 ~~~json { "code": "0", "msg": "請求成功", "data": { "afterSaleOrderId": "1597771590437830656", "result": true }, "msgId": "c83409365d724a94" } ~~~ ### [](https://duobaoyu.com.cn/documentcenter?onlyFlag=ddb99c0b0e143e98737ffc2dd794e33e#%E5%BC%82%E5%B8%B8%E7%A4%BA%E4%BE%8B)異常示例 ~~~json { "code": "1", "msg": "請求失敗", "data": null, "msgId": "efd7f07011124adf" } ~~~