处理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