商品基础信息更新

在不需要指定商品类别时批量更新商品的基础信息。

该模板只能用于更新商品的基础字段，例如网站标题，商品描述，商品图片等。

相关URL

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

注：请确保您的请求URL全都是小写（除Seller ID）并且不能包含任何空格或者换行符。

参数

名称 是否必填？ 描述
sellerid 是 您在新蛋商城的商家编号
RequestType 是 值：ITEM_DATA

相关请求信息

HTTP方式 是否需要认证？ 请求格式 回复格式 频率限制
POST 需要 XML,Json XML,Json 10 请求/分钟

注：每个文件最多可有3000条请求记录并且每个文件不能超过15MB。每小时最多30,000条请求。

请求文件主体

属性 是否必填？ 格式 描述
DocumentVersion 是 Decimal 固定值：3.0
MessageType 是 String 固定值：BatchItemCreation
Action 是 String 指定操作类型：
Create Item：创建当前不在你的商品列表中的新商品
Update Item：更新已存在商品的商品信息 (不包括价格字段更新：Currency，MSRP，MAP，Selling Price，Shipping，Inventory和Activation Mark)
Update/Append Image：为商品上传更多的商品图片或覆盖已存在的商品图片
Replace Image：用此文件中提供的图片URL替换所有已存在的图片。若选择此类型，系统只会处理Item Images和 Activation Mark两个字段；其他字段，包括 Selling Price 都将被忽略。
重要：如果没有选择任何操作，系统会默认选择Create Item，创建新产品。
SellerPartNumber 是 String 商家为商品定义的唯一的标识符。包含字母和数字的字符串，含空格最多40个字符
注：一旦商品被创建，该信息是不能修改。
WebsiteShortTitle 否 String 简短且易于辨识的商品名称。它将在所有的店铺页面、销售订单以及收据中被用作为你的商品的主要名称。
最大字符数： 200
BulletDescription 否 String 输入被选择商品关于特点或功能等简短的描述，这部分内容将会以列表形式显示在商品页面商品标题的下方。 使用分隔符“^^”来区分不用 的功能点。最大字符数为1000个字符，包括空格和分隔符。不能使用 HTML。
ProductDescription 否 String 详细的商品描述，在商品页 面中起重要作用。这个描述应该详细陈述商品的特点和功能。在系列商品中商品描述应一致。
最大字符数： 4000
商品描述(Product Description)字段仅可接受以下基本HTML标签： <ol>、<ul>、<li>、<br>、<p>、<b>、<i>、<u>、 <em>、<strong>、<sub>、<sup>和<img>
ItemLength 否 Decimal 商品包装长度，单位为英寸。不包括公制单位。
格式：小数点后保留两位数，如：1.00
ItemWidth 否 Decimal 商品包装宽度，单位为英寸。不包括公制单位。
格式：小数点后保留两位数，如：1.00
ItemHeight 否 Decimal 商品包装高度，单位为英寸。不包括公制单位。
格式：小数点后保留两位数，如：1.00
ItemWeight 否 Decimal 单个商品包装重量，单位为磅。不包括公制单位。
格式：小数点后保留两位数，如：1.00
ActivationMark 否 String 有效值：
True：激活商品，该商品会展示在新蛋网页上进行售卖
False：下架商品，该商品会被隐藏/下线，不会在新蛋网页上销售。
如果不填，系统将不会对该商品目前的状态做任何更改。
注：

  • 如果新蛋卖家账户状态为“Inactive”，所有商品将会被下线。因此，如果要激活商品，首先该卖家账户必须为“Active”。更多详情，请联系datafeeds@newegg.com
  • Newegg.com平台上的新蛋全球商品，请提交批量更新价格文件来激活全球商品。
ImageUrl 否 String 商品的图片链接。
要求：

  • 所有的 URL 必须直接链接到真实的图片
  • 图片类型必须为.jpg 、 .jpeg或者.GIF
  • 图片的最小尺寸为：宽640像素，高480像素
  • 图片大小不能超过10MB，如果超过10MB，则会上传失败。
IsPrimary 否 Boolean 如果多张图片上传，该字段可用于指定商品显示的第一张图片。
ConditionDetails 否 String 商品状态相关的信息，不包括New和 Refurbished 状态的商品，可用于帮助顾客了解商品状态。
注意：该信息仅适用于Newegg.com平台
ImageUrl 否 String 二手商品的图片链接。
要求：

  • 所有的 URL 必须直接链接到真实的图片
  • 图片类型必须为.jpg 、 .jpeg或者.GIF
  • 图片的最小尺寸为：宽640像素，高480像素
  • 图片大小不能超过10MB，如果超过10MB，则会上传失败。

注：该信息仅适用于Newegg.com平台。
IsPrimary 否 Boolean 如果多张图片上传，该字段可用于指定该二手商品显示的第一张图片。
Prop65 否 String Newegg.com和NeweggBusiness.com：当该商品涉及加州 65号提案的规定时使用此字段。
一旦商品已经创建成功，要根据加州的法规更新prop65，请参考ITEM_CAPROP65_DATA文件。
Newegg.ca平台不要求。
Prop65Motherboard 否 String
CountryOfOrigin 否 String 该字段是表示你的商品的原产地或者出口国。 新蛋仅接受国际标准的三位国家代码。
完整的代码列表，请从以下链接下载，International Country Guide
OverAge18Verification 否 String 当商品包含不宜十八岁以下人群的图像或其他不恰当信息时使用此字段。如果不填，默认为“NO”
有效值：YES或者NO
ChokingHazard 否 String 对于儿童玩具和游戏所要求的窒息性危险警告。
你可以挑选 6 个警告中的 4 个，且不需要选择四个以上的警告。不应同时选择商品“包含”小型球体或大理石和与之相关的商品“是”小型球体或大理石这两种警告。
请参考消费品安全改进法案(CPSIA)了解详细信息
如果不填，该值为空。
ShippingRestriction 否 String 某些商品有运输限制，不能使用空运。
如果您创建的产品有此类限制，请设置值为“YES”。如果没有，设置为“NO”。如果不填，则默认为“NO”。

Schema: ItemUpdate.xsd

示例：XML，Request

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

<NeweggEnvelope>
    <Header>
        <DocumentVersion>3.0</DocumentVersion>
    </Header>
    <MessageType>BatchItemCreation</MessageType>
    <Message>
        <Itemfeed>
            <Item>
                <Action>Update Item</Action>
                <BasicInfo>
                    <SellerPartNumber>A006Leon_Test_001</SellerPartNumber>
                    <WebsiteShortTitle>Test for Leon</WebsiteShortTitle>
                    <WebsiteLongTitle/>
                    <BulletDescription>This is first bullet^^This is second bullet</BulletDescription>
                    <ProductDescription>Test for Leon</ProductDescription>
                    <ItemDimension>
                        <ItemLength>2.0</ItemLength>
                        <ItemWidth>2.0</ItemWidth>
                        <ItemHeight>2.0</ItemHeight>
                    </ItemDimension>
                    <ItemWeight>2.0</ItemWeight>
                    <ActivationMark>False</ActivationMark>
                    <ItemImages>
                        <Image>
                            <ImageUrl>http://10.1.24.143:4567/images/20.gif</ImageUrl>
                            <IsPrimary>True</IsPrimary>
                        </Image>
                        <Image>
                            <ImageUrl>http://10.1.24.143:4567/images/21.gif</ImageUrl>
                        </Image>
                        <Image>
                            <ImageUrl>http://10.1.24.143:4567/images/22.gif</ImageUrl>
                        </Image>
                    </ItemImages>
                    <ConditionDetails>Works fine, almost like new, missing original plastics cover</ConditionDetails>
                    <UsedItemImages>
                        <Image>
                            <ImageUrl>http://10.1.24.143:4567/images/Used.gif</ImageUrl>
                        </Image>
                    </UsedItemImages>
                    <Warning>
                        <Prop65>No</Prop65>
                        <Prop65Motherboard>Yes</Prop65Motherboard>
                        <CountryOfOrigin>USA</CountryOfOrigin>
                        <OverAge18Verification>No</OverAge18Verification>
                        <ChokingHazard>
                            <SmallParts>Yes</SmallParts>
                            <SmallBall>Is a small ball</SmallBall>
                            <Balloons>Yes</Balloons>
                            <Marble>Contains a marble</Marble>
                        </ChokingHazard>
                    </Warning>
                </BasicInfo>
            </Item>
            <Item>
                <Action>Update Item</Action>
                <BasicInfo>
                    <SellerPartNumber>A006Leon_Test_002</SellerPartNumber>
                    <WebsiteShortTitle>Test for Leon</WebsiteShortTitle>
                    <WebsiteLongTitle/>
                    <BulletDescription>This is first bullet^^This is second bullet</BulletDescription>
                    <ProductDescription>Test for Leon</ProductDescription>
                    <ItemDimension>
                        <ItemLength>2.0</ItemLength>
                        <ItemWidth>2.0</ItemWidth>
                        <ItemHeight>2.0</ItemHeight>
                    </ItemDimension>
                    <ItemWeight>2.0</ItemWeight>
                    <ActivationMark>False</ActivationMark>
                    <ItemImages>
                        <Image>
                            <ImageUrl>http://10.1.24.143:4567/images/20.gif</ImageUrl>
                            <IsPrimary>True</IsPrimary>
                        </Image>
                    </ItemImages>
                    <Warning>
                        <Prop65>No</Prop65>
                        <Prop65Motherboard>Yes</Prop65Motherboard>
                        <OverAge18Verification>No</OverAge18Verification>
                        <ChokingHazard>
                            <SmallParts>Yes</SmallParts>
                            <SmallBall>Is a small ball</SmallBall>
                            <Balloons>Yes</Balloons>
                            <Marble>Contains a marble</Marble>
                        </ChokingHazard>
                    </Warning>
                </BasicInfo>
            </Item>
            <Item>
                <Action>Update Item</Action>
                <BasicInfo>
                    <SellerPartNumber>A006Leon_Test_003</SellerPartNumber>
                    <WebsiteShortTitle>Test for Leon</WebsiteShortTitle>
                    <WebsiteLongTitle/>
                    <BulletDescription>This is first bullet^^This is second bullet</BulletDescription>
                    <ProductDescription>Test for Leon</ProductDescription>
                    <ItemDimension>
                        <ItemLength>2.0</ItemLength>
                        <ItemWidth>2.0</ItemWidth>
                        <ItemHeight>2.0</ItemHeight>
                    </ItemDimension>
                    <ItemWeight>2.0</ItemWeight>
                    <ActivationMark>False</ActivationMark>
                    <ItemImages>
                        <Image>
                            <ImageUrl>http://10.1.24.143:4567/images/20.gif</ImageUrl>
                            <IsPrimary>True</IsPrimary>
                        </Image>
                    </ItemImages>
                    <Warning>
                        <Prop65>No</Prop65>
                        <Prop65Motherboard>Yes</Prop65Motherboard>
                        <OverAge18Verification>No</OverAge18Verification>
                        <ChokingHazard>
                            <SmallParts>Yes</SmallParts>
                            <SmallBall>Is a small ball</SmallBall>
                            <Balloons>Yes</Balloons>
                            <Marble>Contains a marble</Marble>
                        </ChokingHazard>
                    </Warning>
                </BasicInfo>
            </Item>
        </Itemfeed>
    </Message>
</NeweggEnvelope>

示例：Json，Request

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

{
    "NeweggEnvelope": {
        "Header": {
            "DocumentVersion": "3.0"
        },
        "MessageType": "BatchItemCreation",
        "Message": {
            "Itemfeed": {
                "Item": [
                    {
                        "Action": "Update Item",
                        "BasicInfo": {
                            "SellerPartNumber": "A006Leon_Test_001",
                            "WebsiteShortTitle": "Test for Leon",
                            "BulletDescription":"This is first bullet^^This is second bullet",
                            "ProductDescription": "Test for Leon",
                            "ItemDimension": {
                                "ItemLength": "2.0",
                                "ItemWidth": "2.0",
                                "ItemHeight": "2.0"
                            },
                            "ItemWeight": "2.0",
                            "ActivationMark": "False",
                            "ItemImages": {
                                "Image": [
                                      { "ImageUrl": "http://10.1.24.143:4567/images/20.gif",
                                        "IsPrimary": "True"},
                                      { "ImageUrl": "http://10.1.24.143:4567/images/21.gif"},
                                      { "ImageUrl": "http://10.1.24.143:4567/images/22.gif"}
                                ]
                            },
                            "ConditionDetails": "Works fine, almost like new, missing original plastics cover ",
                            "UsedItemImages": {
                                "Image": {
                                    "ImageUrl": "http://10.1.24.143:4567/images/Used.gif"
                                }
                            },
                            "Warning": {
                                "Prop65": "No",
                                "Prop65Motherboard": "Yes",
                                "CountryOfOrigin": "USA",
                                "OverAge18Verification": "No",
                                "ChokingHazard": {
                                    "SmallParts": "Yes",
                                    "SmallBall": "Is a small ball",
                                    "Balloons": "Yes",
                                    "Marble": "Contains a marble"
                                }
                            }
                        }
                    },
                    {
                        "Action": "Update Item",
                        "BasicInfo": {
                            "SellerPartNumber": "A006Leon_Test_002",
                            "WebsiteShortTitle": "Test for Leon",
                            "BulletDescription":"This is first bullet^^This is second bullet",
                            "ProductDescription": "Test for Leon",
                            "ItemDimension": {
                                "ItemLength": "2.0",
                                "ItemWidth": "2.0",
                                "ItemHeight": "2.0"
                            },
                            "ItemWeight": "2.0",
                            "ActivationMark": "False",
                            "ItemImages": {
                                "Image": {
                                    "ImageUrl": "http://10.1.24.143:4567/images/20.gif",
                                    "IsPrimary": "True"
                                }
                            },
                            "Warning": {
                                "Prop65": "No",
                                "Prop65Motherboard": "Yes",
                                "OverAge18Verification": "No",
                                "ChokingHazard": {
                                    "SmallParts": "Yes",
                                    "SmallBall": "Is a small ball",
                                    "Balloons": "Yes",
                                    "Marble": "Contains a marble"
                                }
                            }
                        }
                    },
                    {
                        "Action": "Update Item",
                        "BasicInfo": {
                            "SellerPartNumber": "A006Leon_Test_003",
                            "WebsiteShortTitle": "Test for Leon",
                            "ProductDescription": "Test for Leon",
                            "ItemDimension": {
                                "ItemLength": "2.0",
                                "ItemWidth": "2.0",
                                "ItemHeight": "2.0"
                            },
                            "ItemWeight": "2.0",
                            "ActivationMark": "False",
                            "ItemImages": {
                                "Image": {
                                    "ImageUrl": "http://10.1.24.143:4567/images/20.gif",
                                    "IsPrimary": "True"
                                }
                            },
                            "Warning": {
                                "Prop65": "No",
                                "Prop65Motherboard": "Yes",
                                "OverAge18Verification": "No",
                                "ChokingHazard": {
                                    "SmallParts": "Yes",
                                    "SmallBall": "Is a small ball",
                                    "Balloons": "Yes",
                                    "Marble": "Contains a marble"
                                }
                            }
                        }
                    }
                ]
            }
        }
    }
}

回复文件主体

属性 格式 描述
IsSuccess String 获取文件状态操作：
True: 成功
False: 失败
OperationType String 固定值：SubmitFeedResponse
SellerID String 商家编号
RequestType String 值：ITEM_DATA
RequestDate String 文件提交的时间。（太平洋标准时间）
RequestStatus String 文件提交的状态：

SUBMITTED 已提交
Memo String 附加信息

Schema: SubmitFeedResponse.xsd

示例：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_DATA</RequestType>
                <RequestDate>2/16/2012 12:29:19</RequestDate>
                <RequestStatus>SUBMITTED</RequestStatus>
            </ResponseInfo>
        </ResponseList>
    </ResponseBody>
    <Memo />
</NeweggAPIResponse>

示例：Json，Response

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

请求失败错误信息

常规HTTP错误回复，请参考回复失败错误代码列表。

错误代码 描述
DF003 The MaxCount (maximum request records) CANNOT be over 30000.

最大请求数记录不能超过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.

在已定的数据文件处理限制期内，从[{begin timestamp: hh:mm:ss, MM/DD/YYYY}] 到 [{end timestamp: hh:mm:ss, MM/DD/YYYY}]，您的数据请求将无法被处理。如您有任何问题或者疑问，请联系datafeeds@newegg.com。 感谢您的耐心等待。

示例：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>

示例：Json，Response

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

更新日期：05/14/2021