编辑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 | 固定值:EditRMARequest |
| RMANumber | 是 | Integer | 新蛋分配的RMA 编号 |
| RMAType | 是 | Integer | 有效值: 1. Replacement (换货) 2. Refund (退款) |
| SellerRMANumber | 否 | String | 商家定义的退换货请求编号
|
| RMANote | 是 | String | 该RMA的补充注释,最多4000字符 |
| SellerPartNumber | 是 | String | 商家自定义的商品编码。用于标识商品。 |
| ReturnQuantity | 是 | Integer | 该RMA中此项商品的退货数量。 |
| ReturnUnitPrice | 如果RMAType为退款,此项必填 | Decimal | 在退款RMA中每个商品的退款单价,即该商品每件的退款额
|
| RefundShippingPrice | 如果RMAType为退款,此项必填 | Decimal | 在该RMA中每个商品的运费退款总额
|
| 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(不满意) |
Schema: UpdateRMARequest.xsd AND RMAEdit.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>EditRMARequest</OperationType>
<RequestBody>
<EditRMAInfo>
<RMANumber>38875640</RMANumber>
<RMAType>2</RMAType>
<SellerRMANumberE12345678
</SellerRMANumber>
<RMANote>your note here</RMANote>
<RMATransactionList>
<RMATransaction>
<SellerPartNumber>Ben_item_12</SellerPartNumber>
<ReturnQuantity>1</ReturnQuantity>
<ReturnUnitPrice>200</ReturnUnitPrice>
<RefundShippingPrice>10</RefundShippingPrice>
<RMAReason>5</RMAReason>
</RMATransaction>
</RMATransactionList>
</EditRMAInfo>
</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": "EditRMARequest",
"RequestBody": {
"EditRMAInfo": {
"RMANumber": "38875640",
"RMAType": "2",
"SellerRMANumber": "E12345678",
"RMANote": "your note here",
"RMATransactionList": {
"RMATransaction": {
"SellerPartNumber": "Ben_item_12",
"ReturnQuantity": "1",
"ReturnUnitPrice": "200",
"RefundShippingPrice": "10",
"RMAReason": "5"
}
}
}
}
}
回复文件主体
| 属性 | 格式 | 描述 |
| IsSuccess | String | 获取数据状态的操作: True: 成功 False: 失败 |
| OperationType | String | 固定值:EditRMAResponse |
| 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>EditRMAResponse</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": "EditRMAResponse",
"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错误回复,请参考回复失败错误代码列表。
| 错误代码 | 描述 |
| SE001 | Invalid SellerPartNumber.
无效的 SellerPartNumber |
| SE004 | Cannot issue RMA because the order has not been invoiced.
此订单交易未完成不能发布 RMA |
| SE005 | ShipMethodCode is required when RMAType is replacement.
当 RMA 类型为换货时,运送方式代码(ShipMethodCode)必填。 |
| SE006 | RMATransaction is required in RMATransactionList.
在 RMA 事务列表里 RMA 事务必填 |
| SE009 | [Seller Part #] Return Qty has to be equal to or less than Max Return Qty – Prior Returned Qty, currently the available return qty = {0}. [Seller Part #]退货数量必须等于或小于最大退货数-优先退货数,当前有效的退货数量= {0}。 |
| SE010 | Refund per Qty must be greater than zero.
每单位数量的退款必须大于 0 |
| SE011 | {Seller Part #} refund price per Qty cannot be greater than item unit price, which = {0.00}.
{Seller Part #}商品每单位数量的退款额不能大于商品单价{0.00} |
| SE012 | Order Shipping Refund cannot be greater than Order Shipping Charge, which = {0.00}.
订单运费退款不能大于订单运费{0.00} |
| SE013 | Replacement RMA Order Qty cannot be greater than item available inventory.
换货 RMA 订购数不能大于商品可用库存数 |
| SE014 | Item(s) has two fulfillment channels. Please use DiffShippedByPartyAction field to resolve this issue.
商品有两条完成渠道。请使用 DiffShippedByPartyAction 字段来解决这个问题 |
| SE017 | RMANumber is required.
RMA编号必填。 |
| SE020 | The following item(s) must return with the current item(s) since they are in a same Combo or Auto Add to Cart promotion :{ Seller Part # List}.
由于以下商品和当前商品都属于相同的 Combo 或自动添加到购物车的促销,它们必须一起被退回:{ Seller Part # List}. |
| SE021 | The following item(s) must return with the current item(s) since they are in a same Combo or Auto Add to Cart promotion :{ Seller Part # List}.
商品的退款单价(ReturnUnitPrice)不能大于商品在订单中的单价(UnitPrice){0.00}。 |
| SE023 | Total refund amount cannot exceed total order amount, which = {0.00}.
总退货数不能超过总订单数{0.00} |
| SE024 | Item does not exist.
商品不存在 |
| 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,请联系新蛋商城技术组。 |
| SE034 | Refund cannot exceed order total minus previous refunded amount[{0}].
退货数不能超过订单总数-已退货数[{0}] |
| SE035 | This seller account currently does not support the selected shipping method {0}. Please setup this shipping setting in Seller Portal or select another shipping method.
该商家账户当前不支持选择运送方式{0}.请在 Seller Portal 的 shipping setting 里进行设置运送方式或选择其他运送方式。 |
| SE038 | International seller covered by Newegg Buy-out policy cannot request return or refund directly. Please contact MarketplaceSupport@newegg.com for assistance.
国际商家受新蛋 Buy-out 政策限制无法直接申请退货或退款。 请联系MarketplaceSupport@newegg.com请求帮助。 |
| SE040 | This seller RMA number must be a text of number and/or letters.
Seller 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