提交RMA

为一个已完成的订单提交一个退款或者换货RMA。

相关URL

Newegg.com: https://api.newegg.com/marketplace/servicemgmt/rma/newrma?sellerid={sellerid}&version={version}
Neweggbusiness.com: https://api.newegg.com/marketplace/b2b/servicemgmt/rma/newrma?sellerid={sellerid}&version={version}
Newegg.ca: https://api.newegg.com/marketplace/can/servicemgmt/rma/newrma?sellerid={sellerid}&version={version}

注:请确保您的请求URL全都是小写(除Seller ID)并且不能包含任何空格或者换行符。

参数

名称 是否必填? 描述
sellerid 您在新蛋商城的商家编号
version Newegg.com:可用版本:307

Neweggbusiness.com和Newegg.ca:可用版本:305

相关请求信息

HTTP方式 是否需要认证? 请求格式 回复格式 频率限制
POST 需要 XML,Json XML,Json 100 请求/小时

请求文件主体

属性 是否必填? 格式 描述
IssueUser String 请求发送者在Seller Portal上注册过的邮箱地址。
系统只接受商家注册过的Seller Portal邮箱地址。如果为空,默认值为商家编号
OperationType String 固定值:IssueRMARequest
RMAType Integer 有效值:
1. Replacement(换货)
2. Refund(退款)
对于补偿性质退款,请参考提交补偿性质退款部分
SourceSONumber Integer 与当前的 RMA 相关联的订单编号
SellerRMANumber String 商家自定义的退换货请求编号

  • 有字母和数字的字符串,最多50个字符
  • Newegg.com可用版本:307
  • Neweggbusiness.com和Newegg.ca可用版本:305
DiffShippedByPartyAction 如果满足一下条件,为必填:

  • RMA类型为换货
  • 原始订单中,商品目前已分别通过SBS和SBN发货
Integer 你当前提交的 RMA 换货订单不仅有商家配送的商品,也有新蛋配送的商品。为了处理 RMA 换货请求,请在下列选项中选择一个:
1. 转换为带有退货手续费的Refund(退款)模式
2. 转换为不带有退货手续费的Refund(退款)模式
3. 拆分成两个独立的 RMA
AutoReceiveMark Integer 这个标记具有以下功能:

  • RMA 被成功创建后,自动标记为 “收到退货” 。商家就不需要另外提出 “收到退货” 的单独请求以进行退款。否则,卖家将需要另外提出“收到退货”的单独请求以确认收到退货并进行退款。
  • 如果存在未被处理的 RMA 能被应用于当前的请求,那么系统会自动匹配一个现存的 RMA

有效值:
0:不自动标记为收到退货(默认)。只有当RMA标记为已收到,才能退款。
1:在RMA创建后自动标记为收到退货并执行退款。

  • 限制:当前该标记功能只适用于由商家配送的订单并且RMA类型为退款(refund)
  • 如果RMA没有被成功创建,即使您指定标记为1,RMA也不会自动标记为收到退货。

注:如果您不确定如何使用该功能,请咨询datafeeds@newegg.com

RMANote String 该RMA的补充注释,最多4000字符
SellerPartNumber String 商家自定义的商品编码。用于标识商品。
ReturnQuantity Integer 该RMA中此项商品的退货数量。
ReturnUnitPrice 如果RMA类型为退款,此项必填 Decimal 在退款RMA中每个商品的退款单价,即该商品每件的退款额

  • Newegg.com和Newggbusiness.com,所有金额都设置使用美元(USD)
  • Newegg.ca,所有金额都设置使用加元(CAD)
RefundShippingPrice 如果RMA类型为退款,此项必填 Decimal 在该RMA中每个商品的运费退款总额。

  • Newegg.com 和 Newggbusiness.com,所有金额都设置使用美元(USD)
  • Newegg.ca,所有金额都设置使用加元(CAD)
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: SubmitRMARequest.xsd

示例:XML,Request

POST https://api.newegg.com/marketplace/servicemgmt/rma/newrma?sellerid={sellerid}&version={version}
Authorization: 720ddc067f4d115bd544aff46bc75634
SecretKey: 21EC2020-3AEA-1069-A2DD-08002B30309D
Content-Type: application/xml
Accept: application/xml

<NeweggAPIRequest>
    <OperationType>IssueRMARequest</OperationType>
    <RequestBody>
        <IssueRMA>
            <RMAType>2</RMAType>
            <SourceSONumber>123456789</SourceSONumber>
            <SellerRMANumber>E12345678</SellerRMANumber>
            <AutoReceiveMark>1</AutoReceiveMark>
            <RMANote>This is a test RMA</RMANote>
            <RMATransactionList>
                <RMATransaction>
                    <SellerPartNumber>test001</SellerPartNumber>
                    <ReturnQuantity>1</ReturnQuantity>
                    <ReturnUnitPrice>1.00</ReturnUnitPrice>
                    <RefundShippingPrice>1.00</RefundShippingPrice>
                    <RMAReason>2</RMAReason>
                </RMATransaction>
            </RMATransactionList>
        </IssueRMA>
    </RequestBody>
</NeweggAPIRequest>

示例:Json,Request

POST https://api.newegg.com/marketplace/servicemgmt/rma/newrma?sellerid={sellerid}&version={version}
Authorization: 720ddc067f4d115bd544aff46bc75634
SecretKey: 21EC2020-3AEA-1069-A2DD-08002B30309D
Content-Type: application/json
Accept: application/json

{
    "OperationType": "IssueRMARequest",
    "RequestBody": {
        "IssueRMA": {
            "RMAType": "2",
            "SourceSONumber": "123456789",
            "SellerRMANumber": "E12345678",
            "AutoReceiveMark": "1",
            "RMANote": "This is a test RMA",
            "RMATransactionList": {
                "RMATransaction": {
                    "SellerPartNumber": "test001",
                    "ReturnQuantity": "1",
                    "ReturnUnitPrice": "1.00",
                    "RefundShippingPrice": "1.00",
                    "RMAReason": "2"
                }
            }
        }
    }
}

回复文件主体

属性 格式 描述
IsSuccess String 获取数据状态的操作:
True: 成功
False: 失败
OperationType String 固定值:IssueRMAResponse
SellerID String 您的商家编号
RMANumber Integer 新蛋分配的RMA 编号
RMAType Integer 有效值:
1:Replacement(换货)
2:Refund(退款)
RMATypeDescription String 有效值:
Replacement 换货:RMAType 值为1
Refund 退款:RMAType 值为2
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),该字段为空
注:新蛋将使用与原始订单相同的运送方式
OrderNumber Integer 已发布 RMA 订单的订单编号
OrderDate String 订单时间(太平洋标准时间)
InvoiceNumber Integer 已发布 RMA 订单的发票号码
OrderAmount Decimal 订单总额

  • Newegg.com 和 Newggbusiness.com,所有金额都设置使用美元(USD)
  • Newegg.ca,所有金额都设置使用加元(CAD)
AvailableRefundAmount Decimal 有效退款额

  • Newegg.com 和 Newggbusiness.com,所有金额都设置使用美元(USD)
  • Newegg.ca,所有金额都设置使用加元(CAD)
RMAProcessedBy String 有效值:Newegg或者Seller
RMAReceiveDate String RMA 货物接收时间(太平洋标准时间)
RMANote String 该 RMA 的补充注解
PriorRefundAmount Decimal 同一订单之前的退款金额(如果有)

  • Newegg.com 和 Newggbusiness.com,所有金额都设置使用美元(USD)
  • Newegg.ca,所有金额都设置使用加元(CAD)
CustomerName String 顾客姓名
CustomerPhoneNumber String 顾客电话
CustomerEmailAddress String 被加密的顾客邮箱地址,你可以通过这个地址联系顾客
例如: gdv6l0viwo4l7j1d@marketplace.newegg.com
ShipToAddress1 String 订单收货地址 1
ShipToAddress2 String 订单收货地址 2
ShipToCityName String 收货地城市名
ShipToStateCode String 收货地所在州代码
ShipToZipCode String 收货地邮编
ShipToCountryCode String 收货地所在国家代码
ShipToLastName String 收货人名
ShipToFirstName String 收货人姓
ShipToCompany String 收货公司
SellerPartNumber String 商家自定义的商品编号
MfrPartNumber String 厂商商品型号
NeweggItemNumber String 新蛋分配的商品编号
Description String 商品的网页标题描述
UnitPrice Decimal 商品售价

  • Newegg.com 和 Newggbusiness.com,所有金额都设置使用美元(USD)
  • Newegg.ca,所有金额都设置使用加元(CAD)
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(换货),该字段为空

ShippedBy Integer 如果RMA类型为Replacement(换货),以下为有效值用于表示谁将配送换货:
0:Shipped by seller(商家配送SBS)
1:Shipped by Newegg(新蛋配送SBN)
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
Memo String 附加说明
ResponseDate String 回复时间(太平洋标准时间)

Schema: SubmitRMAResponse.xsd

示例:XML,Response

<?xml version="1.0" encoding="utf-8"?>
<NeweggAPIResponse>
    <IsSuccess>true</IsSuccess>
    <OperationType>IssueRMAResponse</OperationType>
    <SellerID>A006</SellerID>
    <ResponseDate>2012-02-22 20:59:50</ResponseDate>
    <Memo />
    <ResponseBody>
        <RMAInfo>
            <RMANumber>20103389</RMANumber>
            <RMAType>2</RMAType>
            <RMATypeDescription>Refund</RMATypeDescription>
            <IssueUser>A004</IssueUser>
            <RMADate>2012-02-22</RMADate>
            <RMAStatus>6</RMAStatus>
            <RMAStatusDescription>Processing</RMAStatusDescription>
            <RMAShipMethod />
            <RMAShipMethodDescription />
            <OrderNumber>41473422</OrderNumber>
            <OrderDate>2012-01-11</OrderDate>
            <InvoiceNumber>82868509</InvoiceNumber>
            <OrderAmount>15.00</OrderAmount>
            <AvailableRefundAmount>12000</AvailableRefundAmount>
            <RMAProcessedBy>newegg</RMAProcessedBy>
            <RMAReceiveDate />
            <RMANote>This is a test RMA</RMANote>
            <PriorRefundAmount>2.00</PriorRefundAmount>
            <CustomerName>abc Roosevelt</CustomerName>
            <CustomerPhoneNumber>626-271-9700</CustomerPhoneNumber>
            <CustomerEmailAddress>gdv6l0viwo4l7j1d@marketplace.newegg.com</CustomerEmailAddress>
            <ShipToAddress1>1941 E. Cedar Loop Drive</ShipToAddress1>
            <ShipToAddress2>9A</ShipToAddress2>
            <ShipToCityName>South Weber</ShipToCityName>
            <ShipToStateCode>UT</ShipToStateCode>
            <ShipToZipCode>884405</ShipToZipCode>
            <ShipToLastName>Roosevelt</ShipToLastName>
            <ShipToFirstName>abc</ShipToFirstName>
            <ShipToCompany />
            <RMATransactionList>
                <RMATransaction>
                    <SellerPartNumber>201112310900</SellerPartNumber>
                    <MfrPartNumber>201112310900</MfrPartNumber>
                    <NeweggItemNumber>9SIA0040286987</NeweggItemNumber>
                    <Description>ICYTEST201112310900</Description>
                    <UnitPrice>600.00</UnitPrice>
                    <ReturnQuantity>1</ReturnQuantity>
                    <ReturnUnitPrice>1.00</ReturnUnitPrice>
                    <RefundShippingPrice>1.00</RefundShippingPrice>
                    <RMAReason>2</RMAReason>
                    <RMAReasonDescription>Defective</RMAReasonDescription>
                </RMATransaction>
            </RMATransactionList>
        </RMAInfo>
    </ResponseBody>
</NeweggAPIResponse>

示例:Json,Response

{
    "IsSuccess": "true",
    "OperationType": "IssueRMAResponse",
    "SellerID": "A006",
    "ResponseDate": "2012-02-22 20:59:50",
    "ResponseBody": {
        "RMAInfo": {
            "RMANumber": "20103389",
            "RMAType": "2",
            "RMATypeDescription": "Refund",
            "IssueUser": "A004",
            "RMADate": "2012-02-22",
            "RMAStatus": "6",
            "RMAStatusDescription": "Processing",
            "OrderNumber": "41473422",
            "OrderDate": "2012-01-11",
            "InvoiceNumber": "82868509",
            "OrderAmount": "15.00",
            "AvailableRefundAmount": "12000",
            "RMANote": "This is a test RMA",
            "PriorRefundAmount": "2.00",
            "CustomerName": "abc Roosevelt",
            "CustomerPhoneNumber": "626-271-9700",
            "CustomerEmailAddress": "gdv6l0viwo4l7j1d@marketplace.newegg.com",
            "ShipToAddress1": "1941 E. Cedar Loop Drive",
            "ShipToAddress2": "9A",
            "ShipToCityName": "South Weber",
            "ShipToStateCode": "UT",
            "ShipToZipCode": "884405",
            "ShipToLastName": "Roosevelt",
            "ShipToFirstName": "abc",
            "RMATransactionList": {
                "RMATransaction": {
                    "SellerPartNumber": "201112310900",
                    "MfrPartNumber": "201112310900",
                    "NeweggItemNumber": "9SIA0040286987",
                    "Description": "ICYTEST201112310900",
                    "UnitPrice": "600.00",
                    "ReturnQuantity": "1",
                    "ReturnUnitPrice": "1.00",
                    "RefundShippingPrice": "1.00",
                    "RMAReason": "2",
                    "RMAReasonDescription": "Defective"
                }
            }
        }
    }
}

请求失败错误信息

常规HTTP错误回复,请参考回复失败错误代码列表

错误代码 描述
SE001 Invalid SellerPartNumber.

无效的 SellerPartNumber

SE003 OrderNumber is required.

订单编号 (OrderNumbr) 必填

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 事务必填

SE007 ReasonCode is required.

原因代码(ReasonCode)必填

SE008 Return Qty must be greater than zero.

退货数量必须大于 0

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 字段来解决这个问题

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.

商品不存在

SE025 Cannot issue RMA because the order type is invalid.

订单类型无效不能发布 RMA

SE026 Cannot issue RMA because the order is a replacement order.

此订单是换货订单不能发布 RMA

SE027 Cannot issue RMA because the order has been voided.

订单已被删除不能发布 RMA

SE031 Auto Receive is not available for order returns processed by Newegg.

对于由新蛋处理退货的订单,Auto Receive(自动接收)不可用

SE032 Cannot issue RMA as Auto Receive because the RMA type is not refund.

RMA 类型不是退货,不能将 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 里进行设置运送方式或选择 其他运送方式。

SE036 The item:{seller part #} unit product refund cannot be less than {minimum refund amount} per account restocking fee setting: {seller restocking fee rate}.

商品:{seller part #}的单位商品退款不能低于{最小退款数} 每个账户的退货费设置: {商家退货费比率 }

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  请 求帮助。

SE039 This item is not eligible for {refund |replacement}.

该商品不支持退货|换货。

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