Item Warranty Feed

Batch add Warranty Services for refurbished and used items.

By submitting this request, seller’s will be able to specify certain time period, 90 days for example, for the warranties on Parts and Labor.

Note: For Newegg.com this is applicable for refurbished and used items.  However, for Neweggbusiness.com and Newegg.ca only refurbished items is applicable.

Resource URL

Newegg.com: https://api.newegg.com/marketplace/datafeedmgmt/feeds/submitfeed?sellerid={sellerid}&requesttype={RequestType}
Neweggbusiness.com: https://api.newegg.com/b2b/marketplace/datafeedmgmt/feeds/submitfeed?sellerid={sellerid}&requesttype={RequestType}
Newegg.ca: https://api.newegg.com/marketplace/can/datafeedmgmt/feeds/submitfeed?sellerid={sellerid}&requesttype={RequestType}

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
RequestType Yes Value: ITEM_WARRANTY_DATA

Resource Information

HTTP Method Authentication? Request Formats Response Formats Rate Limited?
POST Required XML, Json XML, Json 1000 request per hour

Request Body

Attribute Required? Format Description
DocumentVersion Yes Decimal Fixed value: 1.0
MessageType Yes String Fixed value: BatchThirdPartyWarrantyUpdate
SellerPartNumber Yes String The item’s seller part number. It will be used to identify the item for added warranty services.
NeweggItemNumber No String  Newegg’s assigned number to item.  It will be used to identify the item for added warranty services.
CountryCode No String ISO standard 3-digit codesAvailable values:

Newegg.com: USA (Default), for Newegg Global, refer to ISO country code in International Country Guide
Newegg.ca: CAN (Default)
Neweggbusiness.com: USB (Default)

WarrantyDayCountParts Yes Integer The period of day is available for the warranty coverage of parts.

Any existing value can be removed by using “0”.

WarrantyDayCountLabor Yes Integer The period of day is available for the warranty coverage of service labor.

Any existing value can be removed by using “0”.

WarrantyProvidedBy Yes String The name of warranty service provider.

Max characters: 200

SupportPhone Yes String Service phone # of warranty service provider.

Maximum characters: 40

SupportEmail Yes String Email address of warranty service provider.

Maximum characters: 100

SupportURL No String Support URL of warranty service provider if available.

Maximum characters: 250

Schema: ItemWarrantyResponse.xsd

Example: XML, Request

POST https://api.newegg.com/marketplace/datafeedmgmt/feeds/submitfeed?sellerid={sellerid}&requesttype=ITEM_WARRANTY_DATA
Authorization: 720ddc067f4d115bd544aff46bc75634
SecretKey: 21EC2020-3AEA-1069-A2DD-08002B30309D
Content-Type: application/xml
Accept: application/xml

<NeweggEnvelope>
    <Header>
        <DocumentVersion>1.0</DocumentVersion>
    </Header>
    <MessageType>BatchThirdPartyWarrantyUpdate</MessageType>
    <Message>
        <Item>
            <SellerPartNumber>321321654</SellerPartNumber>
            <NeweggItemNumber>SIA00F3427624</NeweggItemNumber>
            <CountryCode>USA</CountryCode>
            <WarrantyDayCountParts>30</WarrantyDayCountParts>
            <WarrantyDayCountLabor>30</WarrantyDayCountLabor>
            <WarrantyProvidedBy>Newegg</WarrantyProvidedBy>
            <SupportPhone>626-100-1000</SupportPhone>
            <SupportEmail>example@newegg.com</SupportEmail>
            <SupportURL>http://www.newegg.com</SupportURL>
        </Item>
        <Item>
            <SellerPartNumber>321321655</SellerPartNumber>
            <NeweggItemNumber>SIA00F3427625</NeweggItemNumber>
            <CountryCode>USA</CountryCode>
            <WarrantyDayCountParts>30</WarrantyDayCountParts>
            <WarrantyDayCountLabor>30</WarrantyDayCountLabor>
            <WarrantyProvidedBy>Newegg</WarrantyProvidedBy>
            <SupportPhone>626-100-1000</SupportPhone>
            <SupportEmail>example@newegg.com</SupportEmail>
            <SupportURL>http://www.newegg.com</SupportURL>
        </Item>
    </Message>
</NeweggEnvelope>

Example: Json, Request

POST https://api.newegg.com/marketplace/datafeedmgmt/feeds/submitfeed?sellerid={sellerid}&requesttype=ITEM_WARRANTY_DATA
Authorization: 720ddc067f4d115bd544aff46bc75634
SecretKey: 21EC2020-3AEA-1069-A2DD-08002B30309D
Content-Type: application/json
Accept: application/json

{
    "NeweggEnvelope": {
        "Header": {
            "DocumentVersion": "1.0"
        },
        "MessageType": "BatchThirdPartyWarrantyUpdate",
        "Message": {
            "Item": [
                {
                    "SellerPartNumber": "321321654",
                    "NeweggItemNumber": "SIA00F3427624",
                    "CountryCode": "USA",
                    "WarrantyDayCountParts": "30",
                    "WarrantyDayCountLabor": "30",
                    "WarrantyProvidedBy": "Newegg",
                    "SupportPhone": "626-100-1000",
                    "SupportEmail": "example@newegg.com",
                    "SupportURL": "http://www.newegg.com"
                },
                {
                    "SellerPartNumber": "321321655",
                    "NeweggItemNumber": "SIA00F3427625",
                    "CountryCode": "USA",
                    "WarrantyDayCountParts": "30",
                    "WarrantyDayCountLabor": "30",
                    "WarrantyProvidedBy": "Newegg",
                    "SupportPhone": "626-100-1000",
                    "SupportEmail": "example@newegg.com",
                    "SupportURL": "http://www.newegg.com"
                }
            ]
        }
    }
}

Response Body

Attribute Format Description
IsSuccess String Get feed status operation:

True: Successful
False: Not successful

OperationType String Fixed value: SubmitFeedResponse
SellerID String Your seller ID
RequestType String Value: ITEM_WARRANTY_DATA
RequestDate String The date when the feed was submitted. (Pacific Standard Time)
RequestStatus String The status of the feed submission:

SUBMITTED

Memo String Additional Information

Schema: SubmitFeedResponse.xsd

Example: XML, Response

<?xml version="1.0" encoding="utf-8"?>
<NeweggAPIResponse>
    <IsSuccess>true</IsSuccess>
    <OperationType>SubmitFeedResponse</OperationType>
    <SellerID>A006</SellerID>
    <ResponseBody>
        <ResponseList>
            <ResponseInfo>
                <RequestId>2291326430</RequestId>
                <RequestType>ITEM_WARRANTY_DATA</RequestType>
                <RequestDate>2/16/2012 12:29:19</RequestDate>
                <RequestStatus>SUBMITTED</RequestStatus>
            </ResponseInfo>
        </ResponseList>
    </ResponseBody>
    <Memo />
</NeweggAPIResponse>

Example: Json, Response

{
    "IsSuccess": true,
    "OperationType": "SubmitFeedResponse",
    "ResponseBody": {
        "ResponseList": [
            {
                "RequestDate": "2/22/2012 17:24:35",
                "RequestId": "2PQCX3CMQ82MK",
                "RequestStatus": "SUBMITTED",
                "RequestType": "ITEM_WARRANTY_DATA"
            }
        ]
    },
    "SellerID": "A006"
}

Request Failure Errors

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

Error Code Description
DF003 The MaxCount (maximum request records) CANNOT be over 30000.
DF004 Unfortunately, we are unable to process your request at this time. We apologize for the inconvenience. Please try again later.
DF011 Your data feed request will not be processed during the scheduled data feed processing restriction from [{begin timestamp: hh:mm:ss, MM/DD/YYYY}] to [{end timestamp: hh:mm:ss, MM/DD/YYYY}]). Please contact datafeeds@newegg.com if you have any question or concern. Thank you for your patience.

Example: XML, Response

<?xml version="1.0" encoding="utf-8"?>
<Errors>
    <Error>
        <Code>DF003</Code>
        <Message>The MaxCount (maximum request records) CANNOT be over 30000</Message>
    </Error>
</Errors>

Example: Json, Response

{
    "Code": "DF003",
    "Message": "The MaxCount (maximum request records) CANNOT be over 30000"
}

Last updated: October 15, 2018