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.”

Schema: ItemWarrantyResponse.xsd

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