提交商品保固請求

對在新蛋商城銷售的翻新和二手商品的保固服務做具體說明。

相關URL

Newegg.com: https://api.newegg.com/marketplace/contentmgmt/item/warranty?sellerid={sellerid}
Neweggbusiness.com: https://api.newegg.com/marketplace/b2b/contentmgmt/item/warranty?sellerid={sellerid}
Newegg.ca: https://api.newegg.com/marketplace/can/contentmgmt/item/warranty?sellerid={sellerid}

註:請確保您的請求URL全都是小寫(除Seller ID)並且不能包含任何空格或者分行符號。

參數

名稱 是否必填? 描述
sellerid 您在新蛋商城的商家編號

相關請求資訊

HTTP方式 是否需要認證? 請求格式 回覆格式 頻率限制
POST 需要 XML,Json XML,Json 300 請求/分鐘/商家

請求文件主體

屬性 是否必填? 格式 描述
OperationType String 固定值:SubmitItemWarrantyRequest
ActionType Integer 有效值:

  • 0:Create Warranty 創建保固資訊
  • 1:Update Warranty 更新保固資訊
  • 2:Delete Warranty 刪除保固資訊
ItemManufacturerWarrantyID Integer 保固編號。在更新或刪除保固資訊 時,如果保固編號為 0,我們會使 用 Seller Part #和國家代碼查找保固資訊。
SellerPartNumber String 商家商品編號
PartsDay integer Parts Day,0-99999。你可以設置該欄位為 99999 表示終身保固
LaborDay Integer Labor Day,0-99999。你可以設置該欄位為 99999 表示終身保固
ServiceProvider String 服務提供者名稱
ProviderSupportEmail String 服務提供者客服郵箱地址
ProviderSupportURL String 服務提供者客服網站
ProviderCustomerServicePhone String 服務提供者客服電話。請使用 NANP 電話格式。
例如:234-235-5678
CountryCode String 運送目的地國家代碼。固定值:

  • Newegg.com:USA
  • Neweggbusiness.com:USB
  • Newegg.ca:CAN
ApplyToAllCountryCode Boolean 固定值:false

Schema: ItemWarrantyRequest.xsd

示例:XML, Request

POST https://api.newegg.com/marketplace/contentmgmt/item/warranty?sellerid={SellerID}
Authorization: 720ddc067f4d115bd544aff46bc75634
SecretKey: 21EC2020-3AEA-1069-A2DD-08002B30309D
Accept: application/xml
Content-Type: application/xml

<NeweggAPIRequest>
    <OperationType>SubmitItemWarrantyRequest</OperationType>
    <ActionType>0</ActionType>
    <RequestBody>
        <ItemWarrantyList>
            <ItemWarranty>
                <ItemManufacturerWarrantyID>0</ItemManufacturerWarrantyID>
                <SellerPartNumber>bg9h2016042003</SellerPartNumber>
                <PartsDay>10</PartsDay>
                <LaborDay>10</LaborDay>
                <ServiceProvider>Test</ServiceProvider>
                <ProviderSupportEmail>test@newegg.com</ProviderSupportEmail>
                <ProviderSupportURL>http://www.sohnen.com/CustomerSupport.aspx</ProviderSupportURL>
                <ProviderCustomerServicePhone>562-946-3531</ProviderCustomerServicePhone>
                <CountryCode>USA</CountryCode>
                <ApplyToAllCountryCode>false</ApplyToAllCountryCode>
            </ItemWarranty>
            <ItemWarranty>
                <ItemManufacturerWarrantyID>0</ItemManufacturerWarrantyID>
                <SellerPartNumber>bg9h2016042001</SellerPartNumber>
                <PartsDay>10</PartsDay>
                <LaborDay>10</LaborDay>
                <ServiceProvider>Test</ServiceProvider>
                <ProviderSupportEmail>test@newegg.com</ProviderSupportEmail>
                <ProviderSupportURL></ProviderSupportURL>
                <ProviderCustomerServicePhone>562-946-3531</ProviderCustomerServicePhone>
                <CountryCode>USA</CountryCode>
                <ApplyToAllCountryCode>false</ApplyToAllCountryCode>
            </ItemWarranty>
        </ItemWarrantyList>
    </RequestBody>
</NeweggAPIRequest>

示例:Json, Request

POST https://api.newegg.com/marketplace/contentmgmt/item/warranty?sellerid={SellerID}
Authorization: 720ddc067f4d115bd544aff46bc75634
SecretKey: 21EC2020-3AEA-1069-A2DD-08002B30309D
Accept: application/json
Content-Type: application/json

{
    "OperationType": "SubmitItemWarrantyRequest",
    "ActionType": 0,
    "RequestBody": {
        "ItemWarrantyList": [
            {
                "ItemWarranty": [
                    {
                        "ItemManufacturerWarrantyID": 0,
                        "SellerPartNumber": "bg9h2016042003",
                        "PartsDay": 10,
                        "LaborDay": 10,
                        "ServiceProvider": "Test",
                        "ProviderSupportEmail": "test@newegg.com",
                        "ProviderSupportURL": "http://www.sohnen.com/CustomerSupport.aspx",
                        "ProviderCustomerServicePhone": "562-946-3531",
                        "CountryCode": "USA",
                        "ApplyToAllCountryCode": "false"
                    },
                    {
                        "ItemManufacturerWarrantyID": 0,
                        "SellerPartNumber": "bg9h2016042001",
                        "PartsDay": 10,
                        "LaborDay": 10,
                        "ServiceProvider": "Test",
                        "ProviderSupportEmail": "test@newegg.com",
                        "ProviderSupportURL": null,
                        "ProviderCustomerServicePhone": "562-946-3531",
                        "CountryCode": "USA",
                        "ApplyToAllCountryCode": "false"
                    }
                ]
            }
        ]
    }
}

回覆文件主體

屬性 格式 描述
IsSuccess Boolean 用於確定該操作是否成功,始終返回True
OperationType String 固定值:SubmitItemWarrantyResponse
SellerID String 你的 Seller ID
IsSuccess Boolean 用於確認保固設置處理成功
ErrorCode String 錯誤代碼
ErrorMessage String 錯誤代碼描述
ResponseDate String 回覆時間
ResponseMessage String 如果所有保固設置都處理成功,然會固定值:“You have successfully submitted third-party warranty settings. It may take up to 10 minutes for your settings to propagate to all systems.”

Schema: ItemWarrantyResponse.xsd

示例:XML, Response

<?xml version="1.0" encoding="utf-8"?>
<NeweggAPIResponse>
    <IsSuccess>true</IsSuccess>
    <OperationType>SubmitItemWarrantyResponse</OperationType>
    <SellerID>BG9H</SellerID>
    <ResponseBody>
        <ItemWarrantyList>
            <ItemWarranty>
                <IsSuccess>true</IsSuccess>
            </ItemWarranty>
            <ItemWarranty>
                <IsSuccess>false</IsSuccess>
                <ErrorList>
                    <Error>
                        <ErrorCode>CT507</ErrorCode>
                        <ErrorMessage>'Provider Support URL' is not in the correct format.</ErrorMessage>
                    </Error>
                </ErrorList>
            </ItemWarranty>
        </ItemWarrantyList>
    </ResponseBody>
    <ResponseDate>04/28/2016 02:48:29</ResponseDate>
</NeweggAPIResponse>

示例:Json, Response

{
    "NeweggAPIResponse": {
        "IsSuccess": "true",
        "OperationType": "SubmitItemWarrantyResponse",
        "SellerID": "BG9H",
        "ResponseBody": {
            "ItemWarrantyList": {
                "ItemWarranty": [
                    {
                        "IsSuccess": "true"
                    },
                    {
                        "IsSuccess": "false",
                        "ErrorList": {
                            "Error": {
                                "ErrorCode": "CT508",
                                "ErrorMessage": "SellerPartNumber: bg9h2016042001 does not exist or it is not refurbished."
                            }
                        }
                    }
                ]
            }
        },
        "ResponseDate": "04/28/2016 02:48:29"
    }
}

請求失敗錯誤資訊

常規HTTP錯誤回應,請參考回覆失敗錯誤代碼清單

錯誤代碼 描述
CT001 Invalid ItemNumber

無效的商品編號

CT002 Invalid SellerPartNumber

無效的 Seller Part #

CT003 Invalid UPCCode

無效的UPC 編碼

CT005 Invalid Action Type. We only support:0 – NE Item#, 1 – Seller Parts#, 2 – UPC Code

無效的 Action 類型。我們只支持:0 – NE Item#, 1 — Seller Parts#, 2 — UPC Code

CT004 Item under review, you cannot activate.

商品正在審核,你無法啟動

CT006 Invalid MSRP. The range should be between 0-99999.99

無效的 MSRP。價格區間為 0 至 99999.99

CT007 Invalid Selling Price. The range should be between 0-99999.99

無效 Selling Price。價格區間為 0 至 99999.99

CT008 Invalid Shipping type. We only support:0 – default, 1 – free shipping

無效的 Shipping type。我們只支持 0 – default, 1 – free shipping

CT009 Cannot activate item by restricted manufacturer – {0}[({1}){2}].

無法啟動商品,製造廠商受限- {0}[({1}){2}].

CT010 Cannot find item with specified item condition.

找不到指定 condition 的商品

CT014 SellerItemNumber or SellerPartNumber does not exist

SellerItemNumber 或 SellerPartNumber 不存在

CT015 Item does not belong to this seller

該商品不屬於這個商家

CT016 The item:[SellerPart#] is locked for an on-going/upcoming promotion. CANNOT update the Shipping. Please note:the inventory or minimum purchase quantity update will NOT be affected.

該商品因促銷被新蛋鎖定,不能更改 Shipping(運送方式)。請註:庫存數量或最小訂購數量不會被影響。

CT028 Invalid Active Mark. We only support:0 – deactivate item, 1 – activate item

無效的 ActiveMark(啟動標誌),我們只支援:0 – deactivate item(商品下架), 1 – activate item(商品啟動)

CT029 The selling price {selling price} cannot be greater than MSRP {MSRP}.

實際售價{ selling price }不能高於廠家建議零售價{ MSRP }

CT030 MAP price should be decimal with 2 digitals. The range should be between 0-99999.99.

MAP 價格應帶有 2 位小數,價格區間為 0-99999.99

CT031 Invalid CheckoutMAP value. We only support:0 – False, 1 – True.

無效的 CheckoutMAP 值。我們只支持:0 – False, 1 -True

CT032 The selling price cannot be 0.

實際售價不能為 0

CT043 The item cannot be active because of one of the following reasons:1.Does not exist 2.Breaks the price rule 3.No image

由於下列原因該商品不能被啟動:1.商品不存在 2.違反價格規定 3.沒有圖片

CT044 The item cannot be deactivated because of an on-going/upcoming promotion that is locked by Newegg. Please note:the inventory or minimum purchase quantity update will NOT be affected.

由於連續的促銷,該商品被新蛋鎖定無法下架。請註:庫存數量或最小訂購數量的更新不會被影響。

CT045 Item was automatically deactivated due to 7 days out of stock and cannot be reactivated with 0 inventory.

商品因為 7 天 0 庫存而被自動下架,庫存仍為 0 無法被重新啟動。

CT050 Item Activation Failed. Strict MAP enforced:${0} – Selling Price must be greater than or equal to strict MAP. Please contact your account manager for more information.

商品啟動失敗。Strict MAP:${0} – Selling Price 必須大於或等於 Strict MAP。 詳細資訊請聯繫你的帳戶經理。

CT051 The update submitted for seller part #:{SellerPart#} cannot be processed because the item is currently deactivated.

為seller part#:{SellerPart#}提交的更新請求不能被執行,因為該產品已下架。

CT052 This item cannot be activate because of the subcategory had been disabled for your account.

該商品無法啟動因為類目當前對你的帳戶不可用。

CT053 This item now matches a restricted item and cannot be activated. All other updates will be processed.

該商品與一個被限制的商品相匹配,無法被啟動。所有其他更新請求都將會被處理。

CT055 This is a duplicated request for Seller Part #:[seller part #]. This item does not exist in Newegg so we are not able to process your request. We will resume the process of price and inventory update for this item 8 hours after [last failed timestamp].

此請求為 Seller Part #:[seller part #]的重複請求。此商品不存在於 Newegg,因此我們無法處理你的請求。 我們將會在[上一次失敗的時間]的 8 小時之後重新處理該商品的價格和庫存的更新請求。

CT065 Invalid Selling Price. The Selling Price should be greater than the existing 1st tier volume discount unit price:[{0}]

無效的銷售價格。銷售價格應該大於已設置的第一級總量折扣單價(1st tier volume discount unit price):[{0}]

CT067 The item:[SellerPart#] is regulated by a Newegg existing MAP (Minimum Advertised Pricing) setting:MAP = [amount], Checkout MAP = [status]. When MAP amount is great than 0 or Checkout MAP = True, the attempt to change either MAP or Checkout MAP is restricted. All other requests have been processed.

商品[Seller Part #]由新蛋已存在的 MAP(最小廣告價格)設置所控制,MAP=[amount], Checkout MAP = [status]。當 MAP 總額大於 0 或 Checkout MAP=True 時,試圖更改 MAP 或 CheckoutMAP 的操作都會被限 制。所有其他請求都已被處理。

CT071 The Inventory update for item:[SellerPart#] cannot be processed because of the warehouse:[warehouselocation] has not been created.

商品:[Seller Part #]的庫存更新不能被處理因為倉庫(warehouse)[warehouse]未被創建

CT075 Price update failed. Invalid currency code. The currency code received:[code] does not match the specified country:[code].

價格更新失敗。無效的貨幣代碼。接受的貨幣代碼[code]不匹配指定的國家:[code]

CT076 Item cannot be activated for specified country:[code]. Please activate the country, then submit your request again.

無法啟動指定國家:[code]的商品。請先啟動國家再重新提交請求。

CT501 ‘Seller Part Number’ is required.

‘Seller Part Number’是必填的。

CT502 ‘Service Provider’ is required.

‘Service Provider’是必填的。

CT504 ‘Parts Day’ and ‘Labor Day’ should not be equal to 0 at the same time.

‘Parts Day’ 和 ‘Labor Day’不能同時為 0。

CT505 ‘Provider Support Email’ is required.

‘Provider Support Email’是必填的。

CT506 ‘Provider Support Email’ is not in the correct format.

‘Provider Support Email’格式不正確。

CT507 ‘Provider Support URL’ is not in the correct format.

‘Provider Support URL’格式不正確。

CT508 SellerPartNumber:xxx does not exist.

指定的 SellerPartNumber 不存在。

CT509 “Warranty does not exist in CountryCode:xxx, SellerPartNumber:xxx.” Or “Warranty does not exist in CountryCode:xxx, SellerPartNumber:xxx, ItemManufacturerWarrantyID:xxx.”

CountryCode:xxx, SellerPartNumber:xxx.的保固資訊不存在;或 CountryCode:xxx, SellerPartNumber:xxx, ItemManufacturerWarrantyID:xxx.的保固資訊不存在。

CT511 ‘Provider Customer Service Phone’ is not in the correct format.

‘Provider Customer Service Phone’格式不正確

CT512 SellerPartNumber:xxx is not refurbished or used item.

SellerPartNumber:xxx 不是 refurbished 或 used 商品

CT513 ‘Provider Customer Service Phone’ is required.

‘Provider Customer Service Phone’是必填的

CT514 Warranty exists in CountryCode:xxx, SellerPartNumber:xxx.

CountryCode:xxx, SellerPartNumber:xxx 的保固資訊已存在

示例:XML, Response

<?xml version="1.0" encoding="utf-8"?>
<Errors>
    <Error>
        <Code>CE003</Code>
        <Message> The 'Type' element is invalid - The value 'a' is invalid according to its
datatype 'Int' - The string 'a' is not a valid Int32 value.</Message>
    </Error>
</Errors>

示例:Json, Response

[
    {
        "Code": "CT002",
        "Message": "Invalid SellerPartNumber"
    }
]

更新日期:10/15/2018