提交商品保固請求
對在新蛋商城銷售的翻新和二手商品的保固服務做具體說明。
相關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 | 有效值:
|
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 | 運送目的地國家代碼。固定值:
|
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