編輯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 如果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: 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 相關的運送訂單(SO)編號
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