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