提交商品保修请求

对在新蛋商城销售的翻新和二手商品的保修服务做具体说明。

相关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 您的的商家编号
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