拒绝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 固定值：RejectRMARequest
RMANumber 是 Integer 新蛋分配的RMA 编号
RejectReason 是 Integer 拒绝该RMA的原因
有效值：
1: Remove/Missing Serial Number/Graffiti（删除/丢失序列号/有涂鸦）
2: Warranty Expired（保修到期）
3: Physical Damage（物理性损坏）
4: Item Missing/Parts Missing（商品缺失或部分缺失）
5: Wrong Item Returned（退回有误商品）
ShipCarrier 是 Integer 您想使用的物流公司：
有效值：
1. UPS
2. FedEx
3. DHL
4. USPS
5. Other
OtherShipCarrier 当ShipCarrier为Other时，该字段必填 String 如果ShipCarrier类型指定为其他，则请填入实际使用的物流公司名称。最多10个字符。只适用于ShipCarrier为Other时。更多物流公司信息，请参考新蛋已对接物流商列表。
ShipService 是 String 物流服务类型，例如空运、陆运等。请直接向您使用的物流公司查询。最多50字符。
TrackingNumber 是 String 包裹的追踪号码（物流单号）

Schema: UpdateRMARequest.xsd AND _RMAReject.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>RejectRMARequest</OperationType>
    <RequestBody>
        <RejectRMAInfo>
            <RMANumber>38863380</RMANumber>
            <RejectReason>3</RejectReason>
            <ShipCarrier>5</ShipCarrier>
            <OtherShipCarrier>other</OtherShipCarrier>
            <ShipService>Ground</ShipService>
            <TrackingNumberList>
                <TrackingNumber>123123123123</TrackingNumber>
            </TrackingNumberList>
        </RejectRMAInfo>
    </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": "RejectRMARequest",
    "RequestBody": {
        "RejectRMAInfo": {
            "RMANumber": "38863380",
            "RejectReason": "3",
            "ShipCarrier": "5",
            "OtherShipCarrier": "other",
            "ShipService": "Ground",
            "TrackingNumberList": {
                "TrackingNumber": "123123123123"
            }
        }
    }
}

回复文件主体

属性 格式 描述
IsSuccess String 获取数据状态的操作：
True: 成功
False: 失败
OperationType String 固定值：RejectRMAResponse
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>RejectRMAResponse</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": "RejectRMAResponse",
    "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
SE015 TrackingNumber is required.

TrackingNumber 必填
SE016 TrackingNumber already exists.

TrackingNumber 已存在
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