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

  • 字母和数字组成的字符串,最多50个字符
  • Newegg.com适用版本:307
  • Neweggbusiness.com 和 Newegg.ca适用版本:305
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中每个商品的退款单价,即该商品每件的退款额
  • Newegg.com 和 Newggbusiness.com,所有金额都设置使用美元(USD)
  • Newegg.ca,所有金额都设置使用加元(CAD)

如果RMA类型为replacement(换货),该字段为空

RefundShippingPrice Decimal 如果RMA类型为Refund:

  • 在该RMA中每个商品的运费退款总额。
  • Newegg.com 和 Newggbusiness.com,所有金额都设置使用美元(USD)
  • Newegg.ca,所有金额都设置使用加元(CAD)

如果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