Inventory Update Feed

Batch update items inventory where warehouse(s) is located locally or different region, only one warehouse per region.

Note: Setup of seller’s warehouse(s) is managed at Newegg Seller Portal > Manage Account > Shipping Settings.

Resource URL

Newegg.com: https://api.newegg.com/marketplace/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: INVENTORY_DATA

Resource Information

HTTP Method Authentication? Request Formats Response Formats Rate Limited? Maximum Size of Request
POST Required XML, Json XML, Json 10 request per minute Max: 10,000 records per file

Limit: 100,000 records per hour

Request Body

Attribute Required? Format Description
DocumentVersion Yes Decimal Fixed value: 2.0
MessageType Yes String Fixed value: Inventory
SellerPartNumber Yes String A seller-defined unique identifier for an item.

An alphanumeric string, max 40 characters including space.

Note: Once an item is created, this information cannot be updated.
NeweggItemNumber No String Newegg’s unique identifier for an item.
WarehouseLocation Yes String The ISO standard 3-digit codes of the country where your warehouse is located. Please download the following to review details: International Country Guide

Note: Submissions with incorrect values will error-out.
FulfillmentOption No String Available value:

Seller
Inventory Yes Integer Item inventory quantity in seller’s warehouse for specified location.

Schema: InventoryUpdate.xsd

Example: XML, Request

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

<?xml version="1.0" encoding="UTF-8"?>
<NeweggEnvelope>
    <Header>
        <DocumentVersion>2.0</DocumentVersion>
        <!--The identifier for the very of current feed; assigned by Newegg-->
    </Header>
    <MessageType>Inventory</MessageType>
    <Message>
        <Inventory>
            <Item>
                <SellerPartNumber>a006-test-001</SellerPartNumber>
                <!--A seller-defined unique identifier for an item. An alphanumeric string, max 40 characters including space-->
                <NeweggItemNumber>9SIAWE50008504</NeweggItemNumber>
                <!—Newegg’s unique identifier for an item-->
                <WarehouseLocation>USA</WarehouseLocation>
                <!--The ISO standard 3-digit codes of the country where your warehouse is located. If left blank, default value will be All. -->
                <FulfillmentOption>Seller</FulfillmentOption>
                <!--The shipped by seller inventory in your [xxx] warehouse. -->
                <Inventory>200</Inventory>
                <!--The inventory in seller’s warehouse. -->
            </Item>
        </Inventory>
    </Message>
</NeweggEnvelope>

Example: Json, Request

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

{
    "NeweggEnvelope": {
        "Header": {
            "DocumentVersion": "2.0"
        },
        "MessageType": "Inventory",
        "Message": {
            "Inventory": {
                "Item": {
                    "SellerPartNumber": "a006-test-001",
                    "NeweggItemNumber": "9SIAWE50008504",
                    "WarehouseLocation": "USA",
                    "FulfillmentOption": "Seller",
                    "Inventory": "200"
                }
            }
        }
    }
}

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: INVENTORY_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>INVENTORY_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": "INVENTORY_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