處理RMA
在提交退換貨請求並且完成RMA後,提交此請求。請註意,如果商品已經退回賣家,請及时處理此請求。
相關URL
Newegg.com: https://api.newegg.com/marketplace/servicemgmt/rma/updaterma?sellerid={sellerid}&version={version}
Neweggbusiness.com: https://api.newegg.com/marketplace/b2b/servicemgmt/rma/updaterma?sellerid={sellerid}&version={version}
Newegg.ca: https://api.newegg.com/marketplace/can/servicemgmt/rma/updaterma?sellerid={sellerid}&version={version}
註:請確保您的請求URL全都是小寫(除Seller ID)並且不能包含任何空格或者分行符號。
參數
| 名稱 | 是否必填? | 描述 |
| sellerid | 是 | 您在新蛋商城的商家編號 |
| version | 是 | Newegg.com:可用版本:307
Neweggbusiness.com 和 Newegg.ca:可用版本:305 |
相關請求資訊
| HTTP方式 | 是否需要認證? | 請求格式 | 回覆格式 | 頻率限制 |
| POST | 需要 | XML,Json | XML,Json | 1000 求/小時 |
請求文件主體
| 屬性 | 是否必填? | 格式 | 描述 |
| IssueUser | 否 | String | 請求發送者在Seller Portal上註冊過的郵箱位址。
系統只接受商家註冊過的Seller Portal郵箱位址。如果為空,預設值為商家編號 |
| OperationType | 是 | String | 固定值:ReceiveRMARequest |
| RMANumber | 是 | Integer | 新蛋分配的RMA 編號 |
Schema: UpdateRMARequest.xsd AND _RMAReceive.xsd
示例:XML, Request
POST https://api.newegg.com/marketplace/servicemgmt/rma/updaterma?sellerid={sellerid}&version={version}
Authorization: 720ddc067f4d115bd544aff46bc75634
SecretKey: 21EC2020-3AEA-1069-A2DD-08002B30309D
Content-Type: application/xml
Accept: application/xml
<NeweggAPIRequest>
<OperationType>ReceiveRMARequest</OperationType>
<RequestBody>
<ReceiveRMAInfo>
<RMANumber>38873480</RMANumber>
</ReceiveRMAInfo>
</RequestBody>
</NeweggAPIRequest>
示例:Json, Request
POST https://api.newegg.com/marketplace/servicemgmt/rma/updaterma?sellerid={sellerid}&version={version}
Authorization: 720ddc067f4d115bd544aff46bc75634
SecretKey: 21EC2020-3AEA-1069-A2DD-08002B30309D
Content-Type: application/json
Accept: application/json
{
"OperationType": "ReceiveRMARequest",
"RequestBody": {
"ReceiveRMAInfo": {
"RMANumber": "38873480"
}
}
}
回覆文件主體
| 屬性 | 格式 | 描述 |
| IsSuccess | String | 獲取資料狀態的操作: True: 成功 False: 失敗 |
| OperationType | String | 固定值:ReceiveRMAResponse |
| SellerID | String | 您的商家編號 |
| Memo | String | 附加說明 |
| ResponseDate | String | 回覆時間(太平洋標準時間) |
| RMANumber | Integer | 新蛋分配的RMA 編號 |
| RMAType | Integer | 有效值: 1:Replacement(換貨) 2:Refund(退款) |
| RMATypeDescription | String | 有效值: Replacement(換貨):RMAType 值為1 Refund(退款):RMAType 值為2 |
| SourceSONumber | Integer | RMA 相關的運送訂單編號 |
| SellerRMANumber | String | 商家定義的RMA編號
|
| IssueUser | String | RMA發佈者或者商家編號(在創建RMA時,沒有指定RMA發佈者) |
| RMADate | String | RMA 的發佈時間(太平洋標準時間) |
| RMAStatus | Integer | 有效值:
6:Processing(處理中) |
| RMAStatusDescription | String | 有效值:Processing(default)處理中(默認) |
| RMAShipMethod | Integer | 如果RMA類型為換貨(Replacement)時的運送方式: 1: Super Saver(7-14 business days) 2: Standard Shipping(5-7 business days) 3: Expedited Shipping(3-5 business days) 4: Two-Day Shipping(2 business days) 5: One-Day Shipping(Next day) 6: International Economy Shipping(8-15 business days) 7: International Standard Shipping(5-7 business days) 8: International Expedited Shipping(3-5 business days) 9: International Two-Day Shipping(2 business days) 10: APO/FPO – Military ONLY 11: Newegg Premier 3 Days 12: Newegg Premier 2 Days 13: Newegg Premier Next Day 如果RMA類型為退款(Refund),該欄位為空 註:新蛋將使用與原始訂單相同的運送方式 |
| RMAShipMethodDescription | String | 如果RMA類型為換貨(Replacement)時的運送方式: Super Saver(7-14 business days):如果RMAShipMethod值為1 Standard Shipping(5-7 business days) :如果RMAShipMethod值為2 Expedited Shipping(3-5 business days) :如果RMAShipMethod值為3 Two-Day Shipping(2 business days) :如果RMAShipMethod值為4 One-Day Shipping(Next day) :如果RMAShipMethod值為5 International Economy Shipping(8-15 business days) :如果RMAShipMethod值為6 International Standard Shipping(5-7 business days) :如果RMAShipMethod值為7 International Expedited Shipping (3-5 business days) :如果RMAShipMethod值為8 International Two-Day Shipping(2 business days) :如果RMAShipMethod值為9 APO/FPO – Military:如果RMAShipMethod值為10 Newegg Premier 3 Days:如果RMAShipMethod值為11 Newegg Premier 2 Days:如果RMAShipMethod值為12 Newegg Premier Next Day:如果RMAShipMethod值為13 如果RMA類型為退款(Refund),該欄位為空 註:新蛋將使用與原始訂單相同的運送方式 |
| RMANote | String | 該 RMA 的補充註解 |
| SellerPartNumber | String | 商家自訂的商品編號 |
| ReturnQuantity | Integer | 在此 RMA中此項商品的退貨數 |
| ReturnUnitPrice | Decimal | 如果RMA類型為Refund:
如果RMA類型為replacement(換貨),該欄位為空 |
| RefundShippingPrice | Decimal | 如果RMA類型為Refund:
如果RMA類型為replacement(換貨),該欄位為空 |
| RMAReason | Integer | 在該RMA中,每個商品退/換貨的原因。 有效值: 1:Carrier damage(運輸損傷) 2:Defective(有瑕疵) 3:Incompatible(商品不相容) 4:No longer needed(不再需要) 5:Not match what we show(與頁面中描述的不相符) 6:Ordered wrong item(訂錯商品) 7:Sent wrong item(寄錯商品) 8:Unsatisfied(不滿意) 9:其他原因{0} |
| RMAReasonDescription | String | 在該RMA中,每個商品退/換貨的原因。 有效值: Carrier damage(運輸損傷):如果RMAReason值為1 Defective(有瑕疵):如果RMAReason值為2 Incompatible(商品不相容):如果RMAReason值為3 No longer needed(不再需要):如果RMAReason值為4 Not match what we show(與頁面中描述的不相符):如果RMAReason值為5 Ordered wrong item(訂錯商品):如果RMAReason值為6 Sent wrong item(寄錯商品):如果RMAReason值為7 Unsatisfied(不滿意):如果RMAReason值為8 其他原因{0}:如果RMAReason值為9 |
Schema: UpdateRMAResponse.xsd
示例: XML, Response
<?xml version=”1.0” encoding=”utf-8”?>
<NeweggAPIResponse>
<IsSuccess>true</IsSuccess>
<OperationType>ReceiveRMAResponse</OperationType>
<SellerID>A006</SellerID>
<Memo />
<ResponseDate>2011-09-28 09:02:00</ResponseDate>
<ResponseBody>
<RMAInfo>
<RMANumber>38875640</RMANumber>
<RMAType>2</RMAType>
<RMATypeDescription>Refund</RMATypeDescription>
<SourceSONumber>88219202</SourceSONumber>
<SellerRMANumber>E12345678</SellerRMANumber>
<RMAShipMethod />
<RMAShipMethodDescription />
<RMANote>your note here</RMANote>
<IssueUser>test@newegg.com</IssueUser>
<RMATransactionList>
<RMATransaction>
<SellerPartNumber>Ben_item_12</SellerPartNumber>
<ReturnQuantity>1</ReturnQuantity>
<ReturnUnitPrice>200.00</ReturnUnitPrice>
<RefundShippingPrice>10.00</RefundShippingPrice>
<RMAReason>1</RMAReason>
<RMAReasonDescription>Carrier damage</RMAReasonDescription>
</RMATransaction>
</RMATransactionList>
</RMAInfo>
</ResponseBody>
</NeweggAPIResponse>
示例: Json, Response
{
"IsSuccess": "true",
"OperationType": "ReceiveRMAResponse",
"SellerID": "A006",
"ResponseDate": "2011-09-28 09:02:00",
"ResponseBody": {
"RMAInfo": {
"RMANumber": "38875640",
"RMAType": "2",
"RMATypeDescription": "Refund",
"SourceSONumber": "88219202",
"SellerRMANumber": "E12345678",
"RMANote": "your note here",
"IssueUser": "test@newegg.com",
"RMATransactionList": {
"RMATransaction": {
"SellerPartNumber": "Ben_item_12",
"ReturnQuantity": "1",
"ReturnUnitPrice": "200.00",
"RefundShippingPrice": "10.00",
"RMAReason": "1",
"RMAReasonDescription": "Carrier damage"
}
}
}
}
}
請求失敗錯誤資訊
常規HTTP錯誤回應,請參考回覆失敗錯誤代碼清單。
| 錯誤代碼 | 描述 |
| SE014 | Item(s) has two fulfillment channels. Please use DiffShippedByPartyAction field to resolve this issue.
如果此項有兩個管道,請使用DiffShippedByPartyAction欄位來解決此問題。 |
| SE017 | RMANumber is required.
RMA編號必填。 |
| SE028 | Can’t update because RMA was not open.
RMA 沒有開放不能修改。 |
| SE029 | Can’t update because RMA type = advanced. Please contact Newegg Marketplace Support.
無法更新類型為 Advanced 的 RMA,請聯繫新蛋商城技術組。 |
| SE030 | Can’t update because international seller processing by Newegg.
國際商家的 RMA 由新蛋處理,不能修改。 |
示例: XML, Response
<?xml version="1.0" encoding="utf-8"?>
<Errors>
<Error>
<Code>SE004</Code>
<Message>Cannot issue RMA because the order has not been invoiced</Message>
</Error>
</Errors>
示例: Json, Response
[
{
"Code": "SE004",
"Message": "Cannot issue RMA because the order has not been invoiced"
}
]
更新日期:10/15/2018