编辑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 商家定义的退换货请求编号

  • 含有字母和数字的字符串,最多50个字符
  • Newegg.com可用版本:307
  • Neweggbusiness.com 和Newegg.ca可用版本:305
RMANote String 该RMA的补充注释,最多4000字符
SellerPartNumber String 商家自定义的商品编码。用于标识商品。
ReturnQuantity Integer 该RMA中此项商品的退货数量。
ReturnUnitPrice 如果RMAType为退款,此项必填 Decimal 在退款RMA中每个商品的退款单价,即该商品每件的退款额

  • Newegg.com 和 Newggbusiness.com,所有金额都设置使用美元(USD)
  • Newegg.ca,所有金额都设置使用加元(CAD)
RefundShippingPrice 如果RMAType为退款,此项必填 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: 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编号

  • 字母和数字组成的字符串,最多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>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