Submit Item Warranty Request

Specifying warranty services for refurbished and used items selling on Newegg Marketplace.

Resource 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}

Note: Please make sure your request URL is all in lower case (except for Seller ID) and cannot contain any blank spaces or line breaks.

Parameters

Name Required? Description
sellerid Yes Your seller ID on Newegg Marketplace

Resource Information

HTTP Method Authentication? Request Formats Response Formats Rate Limited?
POST Required XML, Json XML, Json 300 per min per client

Request Body

Attribute Required? Format Description
OperationType Yes String Fixed value: SubmitItemWarrantyRequest
ActionType Yes Integer Available values:

0: Create Warranty
1: Update Warranty
2: Delete Warranty

ItemManufacturerWarrantyID No Integer Warranty ID, when updating and deleting warranty, if warranty id is 0, we will find the warranty by SellerPartNumber and CountryCode.
SellerPartNumber Yes String Seller Part#
PartsDay No integer Parts Day, 0-99999, you can set Parts Days as “99999” to indicate a lifetime warranty.
LaborDay No Integer Labor Day, 0-99999, you can set Labor Days as “99999” to indicate a lifetime warranty.
ServiceProvider Yes String Service Provider Name
ProviderSupportEmail Yes String Warranty support email address
ProviderSupportURL No String Warranty support URL
ProviderCustomerServicePhone Yes String Warranty Customer Service phone number. Please use NANP phone number format.

Example: 234-235-5678.

CountryCode Yes String Ship to Country Fixed Value:

Newegg.com: USA
Neweggbusiness.com: USB
Newegg.ca: CAN

ApplyToAllCountryCode Yes Boolean Fixed value: false

Schema: ItemWarrantyRequest.xsd

Example: 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>

Example: 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"
                    }
                ]
            }
        ]
    }
}

Response Body

Attribute Format Description
IsSuccess Boolean Used to identify the operation is successful, always returns true.
OperationType String Fixed value: SubmitItemWarrantyResponse
SellerID String Your seller ID
IsSuccess Boolean Used to identify the warranty is processed successful.
ErrorCode String Error Code
ErrorMessage String The description of the error code.
ResponseDate String The response time
ResponseMessage String If all warranty settings processed successfully, return fixed value:

“You have successfully submitted third-party warranty settings. It may take up to 10 minutes for your settings to
propagate to all systems.”

Example: 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>

Example: 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"
    }
}

Request Failure Errors

For common HTTP error responses, please refer to Failed Response Error Code List.

Error Code Description
CT001 Invalid ItemNumber
CT002 Invalid SellerPartNumber
CT003 Invalid UPCCode
CT005 Invalid Action Type. We only support: 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
CT007 Invalid Selling Price. The range should be between 0-99999.99
CT008 Invalid Shipping type. We only support: 0 – default, 1 – free shipping
CT009 Cannot activate item by restricted manufacturer – {0}[({1}){2}].
CT010 Cannot find item with specified item condition.
CT014 SellerItemNumber or SellerPartNumber does not exist
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.
CT028 Invalid Active Mark. We only support: 0 – deactivate item, 1 – activate item
CT029 The selling price {selling price} cannot be greater than MSRP {MSRP}.
CT030 MAP price should be decimal with 2 digitals. The range should be between 0-99999.99.
CT031 Invalid CheckoutMAP value. We only support: 0 – False, 1 – True.
CT032 The selling price cannot be 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
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.
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.
CT051 The update submitted for seller part #: {SellerPart#} cannot be processed because the item is currently deactivated.
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].
CT065 Invalid Selling Price. The Selling Price should be greater than the existing 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.
CT071 The Inventory update for item: [SellerPart#] cannot be processed because of the warehouse: [warehouselocation] has not been created.
CT075 Price update failed. Invalid currency code. The currency code received: [code] does not match the specified country: [code].
CT076 Item cannot be activated for specified country: [code]. Please activate the country, then submit your request again.
CT501 ‘Seller Part Number’ is required.
CT502 ‘Service Provider’ is required.
CT504 ‘Parts Day’ and ‘Labor Day’ should not be equal to 0 at the same time.
CT505 ‘Provider Support Email’ is required.
CT506 ‘Provider Support Email’ is not in the correct format.
CT507 ‘Provider Support URL’ is not in the correct format.
CT508 SellerPartNumber: xxx does not exist.
CT509 “Warranty does not exist in CountryCode: xxx, SellerPartNumber: xxx.” Or “Warranty does not exist in CountryCode: xxx, SellerPartNumber: xxx, ItemManufacturerWarrantyID: xxx.”
CT511 ‘Provider Customer Service Phone’ is not in the correct format.
CT512 SellerPartNumber: xxx is not refurbished or used item.
CT513 ‘Provider Customer Service Phone’ is required.
CT514 Warranty exists in CountryCode: xxx, SellerPartNumber: xxx.

Example: 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>

Example: Json, Response

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

Last updated: October 15, 2018