基于新蛋已存在的商品创建新商品

基于新蛋已存在的商品批量创建新商品。

此种方法主要是为了让卖家能够通过使用ISBN、UPC、生产厂商编号,或者是新蛋商品编码来创建新商品,而并不需要指定子类目相关信息。这可以使卖家更快地创建商品。

相关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 固定值:2.0
MessageType String 固定值:BatchItemCreation
SellerPartNumber String 商家为商品定义的唯一标识符。
包含字母和数字的字符串,含空格最多 40个字符。
注:一旦商品创建成功,该信息不能更改。
Manufacturer String 商品的制造商名称。
商家必须使用在我们的系统中预定义的厂商名称。请求添加一个新的厂商名称,请联系新蛋内容部门
注:一旦商品创建成功,该信息不能更改。
ManufacturerPartNumber 如果未提提供UPC,此字段必填 String 制造商给商品定义的唯一的标识符。
包含数字和字母的字符串,含空格最多 40个字符。
注:一旦商品创建成功,该信息不能更改。
UPCOrISBN 如果未提供 Manufact urer Part # / ISBN,此字段必填 String 商品唯一的通用商品编码UPC(只有12个字符)或欧洲商品编号EAN(只有13个字符)。数值型字符串,最多40个字符。
注:一旦商品创建成功,该信息不能更改。
NeweggItemNumber 如果未提供 UPC,Manufacturer Part #/ ISBN,此字段必填 String 新蛋为商品分配的唯一标示符
Currency String 所有价格相关的字段的货币形式。
有效值:
USD:Newegg.com和NeweggBusiness.com平台
CAD:Newegg.ca平台
如果没有指定有效值,系统则默认在Newegg.ca使用CAD,在Newegg.com和NeweggBusiness.com使用USD。
MAP Decimal 规定商品的“最低广告价格”。
格式:小数点左边允许最多有10位数,小数点后允许保留2位。请不要使用逗号或美元符号。
如果实际售价低于 MAP, 系统则会要求顾客把这个商品添加到购物车中查看最后价格。
输入“0.00”或者“0”可移除MAP。
如果为空,不会改当前设置。
CheckoutMAP String 不管实际售价和输入的MAP是多少,如果CheckoutMAP被标记为True,那么系统会要求顾客将商品添加到购物车并进入支付页面后才能查看最后价格。
有效值:True或者False
SellingPrice Decimal 商品的实际售价
格式:小数点左边允许最多有10位数,小数点后允许保留2位。
请不要使用逗号或美元符号。
Shipping String 商品的运费设置。
有效值:Default或者Free
Default的运费设置是由卖家在新蛋Seller Portal > 账户信息 > 配送设置里的物流费率决定的。
Inventory Integer 默认仓库位置的有效库存:

  • Newegg.com和NeweggBusiness.com平台默认使用美国所在仓库
  • Newegg.ca平台默认使用加拿大所在仓库。

注:只针对Newegg.com,多仓库或者新蛋全球项目,请提交商品库存更新来管理库存。

ItemCondition String 有效值:
New:商品会以制造商收到的、密封的、带有所有原装组件以及制造商保修的状态发货。
Refurbished:商品已根据需要进行了测试和修理,以符合翻新厂商的标准,翻新厂商可能是也可能不是原制造商。应在清单中提供制造商信息之外的物品状况的任何例外情况,直至并包括保修细节。
以下类型只适用于Newegg.com平台:
UsedLikeNew:商品已开封或使用过,但还保有完美的出厂状态,没有外观或功能缺陷。商品包含原始商品的保修和配件。商品可能没有原始包装。有外包装损伤的退回物品属于此类别。
UsedVeryGood:商品已开封,可能有轻微使用痕迹和表面瑕疵,以及丢失少量配件,但仍处于非常好的状态。除非在商品描述中有声明,否则此类商品不会带有保修。
UsedGood:商品已开封, 可能带有明显使用痕迹,以及丢失少量配件,但仍处于良好状态。除非在商品描述中有声明,否则此类商品不会带有保修。
UsedAcceptable:商品已开封,可能有明显使用痕迹和表面损伤,以及丢失少量配件和说明书,但仍可正常使用。除非在商品描述中有声明,否则此类商品不会带有保修。使用痕迹之外的功能性问题需要在商品描述中进行说明。
注意:商品一旦创建,该信息无法修改。
PacksOrSets Integer 定义该商品的封装数量
注:所有封装和集合形式的商品都会有匹配的商品和状态
注意:商品一旦创建,该信息无法修改。
ActivationMark String 有效值:
True:激活商品,该商品会展示在新蛋网页上进行售卖
False:下架商品,该商品会被隐藏/下线,不会在新蛋网页上销售。
如果不填,系统将不会对该商品目前的状态做任何更改。
注:
如果新蛋卖家账户状态为“Inactive”,所有商品将会被下线。因此,如果要激活商品,首先该卖家账户必须为“Active”。更多详情,请联系datafeeds@newegg.com
ConditionDetails String 商品状态相关的信息,不包括 New和 Refurbished 状态的商品,可用于帮助顾客了解商品状态。
注意:该信息仅适用于Newegg.com平台
ImageUrl String 二手商品的图片链接。
要求:

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

注:该信息仅适用于Newegg.com平台。

IsPrimary Boolean 如果多张图片上传,该字段可用于指定该二手商品显示的第一张图片。

Schema: ExistingFeed.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>2.0</DocumentVersion>
    </Header>
    <MessageType>BatchItemCreation</MessageType>
    <Message>
        <Itemfeed>
            <SummaryInfo/>
            <Item>
                <BasicInfo>
                    <SellerPartNumber>a006-test-008</SellerPartNumber>
                    <Manufacturer>Newegg</Manufacturer>
                    <ManufacturerPartsNumber>manu-008</ManufacturerPartsNumber>
                    <UPCOrISBN>123456789012</UPCOrISBN>
                    <NeweggItemNumber>9SIAWE50389435</NeweggItemNumber>
                    <Currency>USD</Currency>
                    <MAP>5.00</MAP>
                    <CheckoutMAP>True</CheckoutMAP>
                    <SellingPrice>9.99</SellingPrice>
                    <Shipping>Default</Shipping>
                    <Inventory>99</Inventory>
                    <ItemCondition>UsedGood</ItemCondition>
                    <PacksOrSets>1</PacksOrSets>
                    <ActivationMark>True</ActivationMark>
                    <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>
                </BasicInfo>
            </Item>
            <Item>
                <BasicInfo>
                    <SellerPartNumber>a006-test-009</SellerPartNumber>
                    <Manufacturer>Newegg</Manufacturer>
                    <ManufacturerPartsNumber>manu-009</ManufacturerPartsNumberOrISBN>
                    <UPCOrISBN>123456789012</UPCOrISBN>
                    <NeweggItemNumber>9SIAWE50389434</NeweggItemNumber>
                    <Currency>USD</Currency>
                    <MAP>5.00</MAP>
                    <SellingPrice>9.99</SellingPrice>
                    <Shipping>Default</Shipping>
                    <Inventory>99</Inventory>
                    <ItemCondition>New</ItemCondition>
                    <PacksOrSets>1</PacksOrSets>
                    <ActivationMark>True</ActivationMark>
                </BasicInfo>
            </Item>
        </Itemfeed>
        <Itemfeed>
            <SummaryInfo/>
            <Item>
                <BasicInfo>
                    <SellerPartNumber>a006-test-010</SellerPartNumber>
                    <Manufacturer>Newegg</Manufacturer>
                    <ManufacturerPartsNumber>manu-010</ManufacturerPartsNumber>
                    <UPCOrISBN>123456789012</UPCOrISBN>
                    <NeweggItemNumber>9SIAWE50389432</NeweggItemNumber>
                    <Currency>USD</Currency>
                    <MAP>5.00</MAP>
                    <SellingPrice>9.99</SellingPrice>
                    <Shipping>Default</Shipping>
                    <Inventory>99</Inventory>
                    <ItemCondition>New</ItemCondition>
                    <ActivationMark>True</ActivationMark>
                    <PacksOrSets>1</PacksOrSets>
                </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": "2.0"
        },
        "MessageType": "BatchItemCreation",
        "Message": {
            "Itemfeed": [
                {
                    "Item": [
                        {
                            "BasicInfo": {
                                "SellerPartNumber": "a006-test-008",
                                "Manufacturer": "Newegg",
                                "ManufacturerPartsNumber": "manu-008",
                                "UPCOrISBN": "123456789012",
                                "NeweggItemNumber": "9SIAWE50389435",
                                "Currency": "USD",
                                "MAP": "5.00",
                                "CheckoutMAP": "True",
                                "SellingPrice": "9.99",
                                "Shipping": "Default",
                                "Inventory": "99",
                                "ItemCondition": "UsedGood",
                                "PacksOrSets": "1",
                                "ActivationMark": "True",
                                "ConditionDetails": " Works fine, almost like new, missing original plastics cover",
                                "UsedItemImages": {
                                    "Image": {
                                        "ImageUrl": "http://10.1.24.143:4567/images/Used.gif"
                                    }
                                }
                            }
                        },
                        {
                            "BasicInfo": {
                                "SellerPartNumber": "a006-test-009",
                                "Manufacturer": "Newegg",
                                "ManufacturerPartsNumber": "manu-009",
                                "UPCOrISBN": "123456789012",
                                "NeweggItemNumber": "9SIAWE50389434",
                                "Currency": "USD",
                                "MAP": "5.00",
                                "SellingPrice": "9.99",
                                "Shipping": "Default",
                                "Inventory": "99",
                                "ItemCondition": "New",
                                "PacksOrSets": "1",
                                "ActivationMark": "True"
                            }
                        }
                    ]
                },
                {
                    "Item": {
                        "BasicInfo": {
                            "SellerPartNumber": "a006-test-010",
                            "Manufacturer": "Newegg",
                            "ManufacturerPartsNumber": "manu-010",
                            "UPCOrISBN": "123456789012",
                            "NeweggItemNumber": "9SIAWE50389432",
                            "Currency": "USD",
                            "MAP": "5.00",
                            "SellingPrice": "9.99",
                            "Shipping": "Default",
                            "Inventory": "99",
                            "ItemCondition": "New",
                            "ActivationMark": "True",
                            "PacksOrSets": "1"
                        }
                    }
                }
            ]
        }
    }
}

回复文件主体

属性 格式 描述
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"
    }
]

更新日期:03/09/2021