编辑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