Vehicle Specific Item Creation Feed

Creates vehicle items if it exists in WHI catalog.

Note:

  • If item does not exist in WHI catalog, the item creation will fail to create.
  • If item in WHI catalog does not have image, item will create but will not be applicable for activation.
  • If item in WHI catalog does not have item dimension (LxWxH), system will use item dimension inputted in the feed.
  • Click here to see list of supported WHI categories on Newegg Marketplace.
  • Marketplace Sellers are not allowed to maintain the content and images of items created by WHI.

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: VEHICLE_SPECIFIC_ITEM_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 and each file cannot exceed 15 MB

Limit: 100,000 records per hour

Request Body

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

An alphanumeric string, max 40 characters

Manufacturer Yes String The manufacturer name for an item.  This is pre-defined in Newegg system.

Request to add manufacturer(s) send to Newegg Content Team at mktp.content@newegg.com.

Note: Once an item is created, this information cannot be updated.

ManufacturerPartsNumber Yes, if UPC code is not provided String Manufacturer 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.

UPCOrISBN Yes, if Manufacturer Part
# / ISBN is not provided
String A unique Universal Product Code (UPC) (12 characters only) or European Article Number (EAN)(13 characters only) for an item.

A numeric string, max 40 characters.

NOTE: Once an item is created, this information cannot be updated.

NeweggItemNumber Yes, if UPC code AND Manufacturer Part
# / ISBN is not provided
String Newegg’s unique identifier for an item.
Currency No String The form of money for all price related fields.

Available values: USD

MAP No Decimal Dictates the “minimum advertised price” for item.

Format: 10 digits allowed to the left of the decimal point and 2 digits to the right of the decimal point. Please do not use commas or dollar signs.

If the Selling Price is below the defined MAP, the website will ask customer to add item to shopping cart to see the item’s price.

If you want to remove MAP, input “0.00” or “0”.

If null, no change to current setting.

CheckoutMAP No String When Checkout MAP is marked as “True” AND the selling price is lower than MAP price then the selling price will not be displayed until the checkout process.

Available values: “True” or “False”

SellingPrice Yes Decimal The actual price at which the item is offered for sale.

Format: 10 digits allowed to the left of the decimal point and 2 digits to the right of the decimal point. Please do not use commas or dollar signs.

Shipping Yes String The shipping charge setting for item.

Available values: “Default” or “Free”

Shipping charge for “Default” setting is determined by seller’s shipping rate setting at Newegg Seller Portal > Manage Account > Shipping Settings.

Inventory Yes Integer The inventory quantity available for default warehouse location.
ItemLength No Decimal Item’s shipping length in inches, value only, do not include the metric unit.

Format: Two digits after decimal point. Example: 1.00

ItemWidth No Decimal Item’s shipping width in inches, value only, do not include the metric unit.

Format: Two digits after decimal point. Example: 1.00

ItemHeight No Decimal Item’s shipping height in inches, value only, do not include the metric unit.

Format: Two digits after decimal point. Example: 1.00

ItemWeight Yes Decimal Item’s shipping weight in pounds, value only, do not include the metric unit.

Format: Two digits after decimal point. Example: 1.00

PacksOrSets Yes Integer Identify the package count of this product. All products in a pack or set will have matching item and condition.

Note: Once an item is created, this information cannot be updated.

Remanufactured No String Remanufacturing is “the rebuilding of a product to specifications of the original manufactured product using a combination of reused, repaired and new parts”. It requires the repair or replacement of worn out or obsolete components and modules. … One of the new product categories to be added was Rebuilt Vehicular Parts.

If left blank, the default is “No”

ActivationMark No String Available values:

True: Activate item, the product will be listed for sale at Newegg website.
False: Deactivate item, the product will be hidden/offline, not for sale at Newegg website.

If Null, system will do nothing, no change to current item active/deactivate status.

Note: If Newegg Seller account status is “Inactive”, all items will be offline.  To have option to “Active” item, the account status should be “Active”.  Please contact datafeeds@newegg.com for details.

LimitQuantity No Integer Limit quantity represents the maximum quantity this item can be purchased by a customer within a 48 hour time period.

Limit Quantity is an integer between 1 and 500. If leaves it blank means “Don’t Update it”.

If you want to delete the existing Limit Quantity of the item, please put 0 in Limit Quantity Field.

Schema: VehicleSpecificItemDataFeedRequest.xsd

Example: XML, Request

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


<NeweggEnvelope>
    <Header>
        <DocumentVersion>1.0</DocumentVersion>
    </Header>
    <MessageType>BatchVehicleSpecificItemCreation</MessageType>
    <Message>
        <Itemfeed>
            <Item>
                <BasicInfo>
                    <SellerPartNumber>test-item-01</SellerPartNumber>
                    <Manufacturer>newegg</Manufacturer>
                    <ManufacturerPartsNumber>newegg-test-item-01</ManufacturerPartsNumber>
                    <NeweggItemNumber>9SIA006123456</NeweggItemNumber>
                    <UPCOrISBN>012345678901</UPCOrISBN>
                    <Currency>USD</Currency>
                    <MAP>100</MAP>
                    <CheckoutMAP>True</CheckoutMAP>
                    <SellingPrice>100</SellingPrice>
                    <Shipping>Default</Shipping>
                    <Inventory>10</Inventory>
                    <ItemDimension>
                        <ItemLength>1</ItemLength>
                        <ItemWidth>2</ItemWidth>
                        <ItemHeight>3</ItemHeight>
                    </ItemDimension>
                    <ItemWeight>4</ItemWeight>
                    <PacksOrSets>1</PacksOrSets>
                    <Remanufactured>No</Remanufactured>
                    <ActivationMark>True</ActivationMark>
                    <LimitQuantity>10<LimitQuantity>
                </BasicInfo>
            </Item>
        </Itemfeed>
    </Message>
</NeweggEnvelope>

Example: Json, Request

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

{
    "NeweggEnvelope": {
        "Header": {
            "DocumentVersion": "1.0"
        },
        "MessageType": "BatchVehicleSpecificItemCreation",
        "Message": {
            "Itemfeed": {
                "Item": [
                    {
                        "BasicInfo": {
                            "SellerPartNumber": "test-item-01",
                            "Manufacturer": "newegg",
                            "ManufacturerPartsNumber": "newegg-test-item-01",
                            "NeweggItemNumber": "9SIA006123456",
                            "UPCOrISBN": "012345678901",
                            "Currency": "USD",
                            "MAP": 100,
                            "CheckoutMAP": "True",
                            "SellingPrice": 100,
                            "Shipping": "Free",
                            "Inventory": 10,
                            "ItemDimension": {
                                "ItemLength": 1,
                                "ItemWidth": 2,
                                "ItemHeight": 3
                            },
                            "ItemWeight": 4,
                            "PacksOrSets": 1,
                            "Remanufactured": "No",
                            "ActivationMark": "True",
                            "LimitQuantity": 10
                        }
                    }
                ]
            }
        }
    }
}

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: VEHICLE_SPECIFIC_ITEM_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>VEHICLE_SPECIFIC_ITEM_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": "VEHICLE_SPECIFIC_ITEM_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:  August 10, 2021