拒绝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