商品批量創建和更新

批量創建或者更新指定類別下的商品。

每個子類目都必須遵從類目的結構模式(類別不同,必須填入的商品屬性也不同)。您可以通過以下途徑下載這些類目範本:

  • 下載範本
  • 兩個選項可用於下載不同子類目
    • 新蛋Seller Portal範本下載路徑,登入新蛋Seller Portal > 刊登物品 > 批量創建/更新商品  > 下載範本> 操作:批量創建商品> 選擇範本格式:XML文件> 選擇行業別>下載範本
    • 或下載完整架構http://images10.newegg.com/Marketplace/Taxonomy/XSD.zip

相關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 固定值:1.0
MessageType String 固定值:BatchItemCreation
SubCategoryID String 用於識別類目的參數。對於任意單個商品只能使用一個類目。
註:一旦商品在新蛋系統中已創建或存在,此資訊將無法修改。
Action String 指定操作類型:
Create Item:創建當前不在你的商品列表中的新商品
Update Item:更新已存在商品的商品資訊 (不包括價格欄位更新:Currency,MSRP,MAP,Selling Price,Shipping, Inventory and Activation Mark)
Update/Append Image:為商品上傳更多的商品圖片或覆蓋已存在的商品圖片
Replace Image:用此文件中提供的圖片 URL 替換所有已存在的圖片。若選擇此類型,系統只會處理 Item Images 和Activation Mark 兩個欄位。其他欄位,包括 Selling Price 都將被忽略。
重要:如果沒有選擇任何操作,系統會預設選擇Create Item,創建新產品。
SellerPartNumber String 商家為商品定義的唯一的識別字。包含字母和數位的字串,含空格最多 40個字元
註:一旦商品被創建,該資訊是不能修改。
Manufacturer String 商品製造商名稱。商家必須使用在我們的系統中預定義的廠商名稱。請求添加一個新的廠商名稱,請聯繫 Content Team
註:一旦商品被創建,該資訊是不能修改。
ManufacturerPartNumber 如果沒有提供UPC,則該項為必填 String 製造商給商品定義的唯一的識別字。包含數位和字母的字串,含空格最多 40個字元
註:一旦商品被創建,該資訊是不能修改。
UPCOrISBN 如果沒有提供Manufacturer Part #/ISBN ,該項為必填 String 商品唯一的通用商品編碼 UPC(只有 12個字元)或歐洲商品編號EAN(只有 13 個字元)。數值型字串, 最多 40個字元。
註:一旦商品被創建,該資訊是不能修改。
RelatedSellerPartNumber String 如果該商品是另一個相關聯商品的變體,且這個相關聯的商品有自己的 seller part #,那麼在這裡列出相關聯商品的 seller part #。若想讓變體商品顯示在同一個頁面中,該欄位必填。包含字母和數位的字串,含空格最多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> and <img>
ItemLength Decimal 商品包裝長度,單位為英寸。
格式:小數點後保留兩位數,如:1.00
ItemWidth Decimal 商品包裝寬度,單位為英寸。
格式:小數點後保留兩位數,如:1.00
ItemHeight Decimal 商品包裝高度,單位為英寸。
格式:小數點後保留兩位數,如:1.00
ItemWeight Decimal 單個商品包裝重量,單位為磅。
格式:小數點後保留兩位數,如:1.00
ItemCondition String 有效值:
New:商品會以製造商收到的、密封的、帶有所有原裝元件以及製造商保固的狀態發貨。
Refurbished:商品已根據需要進行了測試和修理,以符合翻新廠商的標準,翻新廠商可能是也可能不是原製造商。應在清單中提供製造商資訊之外的物品狀況的任何例外情況,直至並包括保固細節。
以下類型只適用於Newegg.com平台:
UsedLikeNew:商品已開封或使用過,但還保有完美的出廠狀態,沒有外觀或功能缺陷。商品包含原始商品的保固和配件。商品可能沒有原始包裝。有外包裝損壞的退回物品屬於此類別。
UsedVeryGood:商品已開封,可能有輕微使用痕跡和表面瑕疵,以及丟失少量配件,但仍處於非常好的狀態。除非在商品描述中有聲明,否則此類商品不會帶有保固。
UsedGood:商品已開封,可能帶有明顯使用痕跡,以及丟失少量配件,但仍處於良好狀態。除非在商品描述中有聲明,否則此類商品不會帶有保固。
UsedAcceptable:商品已開封,可能有明顯使用痕跡和表面損壞,以及丟失少量配件和說明書,但仍可正常使用。除非在商品描述中有 聲明,否則此類商品不會帶有保固。使用痕跡之外的功能性問題需要在商品描述中進行說明。
註:商品一旦創建,該資訊無法修改。
PacksOrSets Integer 定義該商品的封裝數量
註:所有封裝和集合形式的商品都會有匹配的商品和狀態
註:商品一旦創建,該資訊無法修改。
ItemPackage String 商品包裝是Retail還是OEM。如果該值沒有指定,則會默認為“Retail”。
ShippingRestriction String 某些商品有運輸限制,不能使用空運。
如果您創建的產品有此類限制,請設置值為“YES”。如果沒有,設置為“NO”。如果不填,則默認為“NO”
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,多倉庫或者新蛋全球專案,請提交商品庫存更新來管理庫存。

LimitQuantity Integer 顧客在48小時內可購買商品的最大數量。

  • 值為1到500間的整數。
  • 如果不填,則表示“不更新”
  • 如果您想刪除現有商品的限制數量,請在該欄位中輸入0。
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 狀態的商品,可用于説明顧客瞭解商品狀態。
註:該資訊僅適用於新蛋美國商城
ImageUrl String 二手商品的圖片連結。
要求:

  • 所有的 URL 必須直接連結到真實的圖片
  • 圖片類型必須 為.jpg 、 .jpeg或者.GIF
  • 圖片的最小尺寸為:寬640圖元,高480圖元
  • 圖片大小不能超過10MB,如果超過10MB,則會上傳失敗。

註:該資訊僅適用於Newegg.com平台。

IsPrimary String 如果多張圖片上傳,該欄位可用於指定該二手商品顯示的第一張圖片。
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)瞭解詳細資訊。
如果不填,該值為空。
SubCategoryProperty Vary 該部分包含指定類目的資訊例如屬性。
參考下列 XSDs 來完成商品資料部分。
1.    下載範本
2.    新蛋seller portal範本下載,登入新蛋Seller Portal > 刊登物品 > 批量創建/更新商品  > 下載範本> 操作:批量創建商品> 選擇範本格式:XML文件> 選擇行業別>下載範本。註:

  • 一個商品只能使用一個類目
  • 如果指定的類目下必填的屬性值沒有提供,該文件則會處理失敗。

Schema: Itemfeed.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>1.0</DocumentVersion>
    </Header>
    <MessageType>BatchItemCreation</MessageType>
    <Message>
        <Itemfeed>
            <SummaryInfo>
                <SubCategoryID>13905</SubCategoryID>
            </SummaryInfo>
            <Item>
                <Action>Create Item</Action>
                <BasicInfo>
                    <SellerPartNumber>JACKETEST0921001002</SellerPartNumber>
                    <Manufacturer>AMD</Manufacturer>
                    <ManufacturerPartsNumber>JACKETEST0921001002</ManufacturerPartsNumber>
                    <UPCOrISBN></UPCOrISBN>
                    <ManufacturerItemURL></ManufacturerItemURL>
                    <RelatedSellerPartNumber></RelatedSellerPartNumber>
                    <WebsiteShortTitle>Sick1111111</WebsiteShortTitle>
                    <BulletDescription>This is first bullet^^This is second bullet</BulletDescription>
                    <ProductDescription>hello222222</ProductDescription>
                    <ItemDimension>
                        <ItemLength>4</ItemLength>
                        <ItemWidth>5</ItemWidth>
                        <ItemHeight>6</ItemHeight>
                    </ItemDimension>
                    <ItemWeight>3</ItemWeight>
                    <PacksOrSets>1</PacksOrSets>
                    <ItemCondition>New</ItemCondition>
                    <ItemPackage>OEM</ItemPackage>
                    <ShippingRestriction>Yes</ShippingRestriction>
                    <Currency>USD</Currency>
                    <SellingPrice>100</SellingPrice>
                    <Shipping>Free</Shipping>
                    <Inventory>100</Inventory>
                    <LimitQuantity>1</LimitQuantity>
                    <ActivationMark>True</ActivationMark>
                    <ItemImages>
                        <Image>
                            <ImageUrl>http://10.1.24.143:4567/images/20.gif</ImageUrl>
                        </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>
                    <Warning>
                        <Prop65>No</Prop65>
                        <Prop65Motherboard>Yes</Prop65Motherboard>
                        <OverAge18Verification>Yes</OverAge18Verification>
                        <ChokingHazard>
                            <SmallParts>Yes</SmallParts>
                            <SmallBall>Is a small ball</SmallBall>
                            <Balloons>Yes</Balloons>
                            <Marble>Is a marble</Marble>
                        </ChokingHazard>
                    </Warning>
                </BasicInfo>
                <SubCategoryProperty>
                    <CostumeAccessories>
                        <CostumeAccBrand>String</CostumeAccBrand>
                        <CostumeAccModel>String</CostumeAccModel>
                        <CostumeAccGender>Male</CostumeAccGender>
                        <CostumeAccAge>Adult</CostumeAccAge>
                        <CostumeAccType>Blood &amp; Gore</CostumeAccType>
                        <CostumeAccTheme>Animals &amp; Insects</CostumeAccTheme>
                        <CostumeAccOccasion>1st Birthday</CostumeAccOccasion>
                        <CostumeAccSize>#10</CostumeAccSize>
                        <CostumeAccColor>String</CostumeAccColor>
                        <CostumeAccMaterial>String</CostumeAccMaterial>
                        <CostumeAccCareInstructions>String</CostumeAccCareInstructions>
                    </CostumeAccessories>
                </SubCategoryProperty>
            </Item>
            <Item>
                <Action>Create Item</Action>
                <BasicInfo>
                    <SellerPartNumber>JACKETEST0921001003</SellerPartNumber>
                    <Manufacturer>AMD</Manufacturer>
                    <ManufacturerPartsNumber>JACKETEST0921001003</ManufacturerPartsNumber>
                    <UPCOrISBN></UPCOrISBN>
                    <ManufacturerItemURL></ManufacturerItemURL>
                    <RelatedSellerPartNumber></RelatedSellerPartNumber>
                    <WebsiteShortTitle>Sick1111111</WebsiteShortTitle>
                    <BulletDescription>This is first bullet^^This is second bullet</BulletDescription>
                    <ProductDescription>hello222222</ProductDescription>
                    <ItemDimension>
                        <ItemLength>4</ItemLength>
                        <ItemWidth>5</ItemWidth>
                        <ItemHeight>6</ItemHeight>
                    </ItemDimension>
                    <ItemWeight>5</ItemWeight>
                    <PacksOrSets>1</PacksOrSets>
                    <ItemCondition>UsedGood</ItemCondition>
                    <ItemPackage>OEM</ItemPackage>
                    <ShippingRestriction>Yes</ShippingRestriction>
                    <Currency>USD</Currency>
                    <SellingPrice>100</SellingPrice>
                    <Shipping>Free</Shipping>
                    <Inventory>100</Inventory>
                    <LimitQuantity>1</LimitQuantity>
                    <ActivationMark>True</ActivationMark>
                    <ItemImages>
                        <Image>
                            <ImageUrl>http://10.1.24.143:4567/images/20.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>
                        <OverAge18Verification>Yes</OverAge18Verification>
                        <ChokingHazard>
                            <SmallParts>Yes</SmallParts>
                            <SmallBall>Is a small ball</SmallBall>
                            <Balloons>Yes</Balloons>
                            <Marble>Is a marble</Marble>
                        </ChokingHazard>
                    </Warning>
                </BasicInfo>
                <SubCategoryProperty>
                    <CostumeAccessories>
                        <CostumeAccBrand>String</CostumeAccBrand>
                        <CostumeAccModel>String</CostumeAccModel>
                        <CostumeAccGender>Male</CostumeAccGender>
                        <CostumeAccAge>Adult</CostumeAccAge>
                        <CostumeAccType>Blood &amp; Gore</CostumeAccType>
                        <CostumeAccTheme>Animals &amp; Insects</CostumeAccTheme>
                        <CostumeAccOccasion>1st Birthday</CostumeAccOccasion>
                        <CostumeAccSize>#10</CostumeAccSize>
                        <CostumeAccColor>String</CostumeAccColor>
                        <CostumeAccMaterial>String</CostumeAccMaterial>
                        <CostumeAccCareInstructions>String</CostumeAccCareInstructions>
                    </CostumeAccessories>
                </SubCategoryProperty>
            </Item>
            <Item>
                <Action>Create Item</Action>
                <BasicInfo>
                    <SellerPartNumber>JACKETEST0921001004</SellerPartNumber>
                    <Manufacturer>AMD</Manufacturer>
                    <ManufacturerPartsNumber>JACKETEST0921001004</ManufacturerPartsNumber>
                    <UPCOrISBN></UPCOrISBN>
                    <ManufacturerItemURL></ManufacturerItemURL>
                    <RelatedSellerPartNumber></RelatedSellerPartNumber>
                    <WebsiteShortTitle>Sick1111111</WebsiteShortTitle>
                    <ProductDescription>hello222222</ProductDescription>
                    <ItemDimension>
                        <ItemLength>4</ItemLength>
                        <ItemWidth>5</ItemWidth>
                        <ItemHeight>6</ItemHeight>
                    </ItemDimension>
                    <ItemWeight>3</ItemWeight>
                    <PacksOrSets>1</PacksOrSets>
                    <ItemCondition>New</ItemCondition>
                    <ItemPackage>OEM</ItemPackage>
                    <ShippingRestriction>Yes</ShippingRestriction>
                    <Currency>USD</Currency>
                    <SellingPrice>100</SellingPrice>
                    <Shipping>Free</Shipping>
                    <Inventory>100</Inventory>
                    <LimitQuantity>1</LimitQuantity>
                    <ActivationMark>True</ActivationMark>
                    <ItemImages>
                        <Image>
                            <ImageUrl>http://10.1.24.143:4567/images/20.gif</ImageUrl>
                        </Image>
                    </ItemImages>
                    <Warning>
                        <Prop65>No</Prop65>
                        <Prop65Motherboard>Yes</Prop65Motherboard>
                        <CountryOfOrigin>USA</CountryOfOrigin>
                        <OverAge18Verification>Yes</OverAge18Verification>
                        <ChokingHazard>
                            <SmallParts>Yes</SmallParts>
                            <SmallBall>Is a small ball</SmallBall>
                            <Balloons>Yes</Balloons>
                            <Marble>Is a marble</Marble>
                        </ChokingHazard>
                    </Warning>
                </BasicInfo>
                <SubCategoryProperty>
                    <CostumeAccessories>
                        <CostumeAccBrand>String</CostumeAccBrand>
                        <CostumeAccModel>String</CostumeAccModel>
                        <CostumeAccGender>Male</CostumeAccGender>
                        <CostumeAccAge>Adult</CostumeAccAge>
                        <CostumeAccType>Blood &amp; Gore</CostumeAccType>
                        <CostumeAccTheme>Animals &amp; Insects</CostumeAccTheme>
                        <CostumeAccOccasion>1st Birthday</CostumeAccOccasion>
                        <CostumeAccSize>#10</CostumeAccSize>
                        <CostumeAccColor>String</CostumeAccColor>
                        <CostumeAccMaterial>String</CostumeAccMaterial>
                        <CostumeAccCareInstructions>String</CostumeAccCareInstructions>
                    </CostumeAccessories>
                </SubCategoryProperty>
            </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": "1.0" },
    "MessageType": "BatchItemCreation",
    "Message": {
      "Itemfeed": {
        "SummaryInfo": { "SubCategoryID": "13905" },
        "Item": [
          {
            "Action": "Create Item",
            "BasicInfo": {
              "SellerPartNumber": "JACKETEST0921001002",
              "Manufacturer": "AMD",
              "ManufacturerPartsNumber": "JACKETEST0921001002",
              "WebsiteShortTitle": "Sick1111111",
              "BulletDescription":"This is first bullet^^This is second bullet",
              "ProductDescription": "hello222222",
              "ItemDimension": {
                "ItemLength": "4",
                "ItemWidth": "5",
                "ItemHeight": "6"
              },
              "ItemWeight": "3",
              "PacksOrSets": "1",
              "ItemCondition": "New",
              "ItemPackage": "OEM",
              "ShippingRestriction": "Yes",
              "Currency": "USD",
              "SellingPrice": "100",
              "Shipping": "Free",
              "Inventory": "100",
              "LimitQuantity": "1",
              "ActivationMark": "True",
              "ItemImages": {
                "Image": [
                     { "ImageUrl": "http://10.1.24.143:4567/images/20.gif" },
                     { "ImageUrl": "http://10.1.24.143:4567/images/21.gif" },
                     { "ImageUrl": "http://10.1.24.143:4567/images/22.gif" }
                ]
              },
              "Warning": {
                "Prop65": "No",
                "Prop65Motherboard": "Yes",
                "OverAge18Verification": "Yes",
                "ChokingHazard": {
                  "SmallParts": "Yes",
                  "SmallBall": "Is a small ball",
                  "Balloons": "Yes",
                  "Marble": "Is a marble"
                }
              }
            },
            "SubCategoryProperty": {
              "CostumeAccessories": {
                "CostumeAccBrand": "String",
                "CostumeAccModel": "String",
                "CostumeAccGender": "Male",
                "CostumeAccAge": "Adult",
                "CostumeAccType": "Blood & Gore",
                "CostumeAccTheme": "Animals & Insects",
                "CostumeAccOccasion": "1st Birthday",
                "CostumeAccSize": "#10",
                "CostumeAccColor": "String",
                "CostumeAccMaterial": "String",
                "CostumeAccCareInstructions": "String"
              }
            }
          },
          {
            "Action": "Create Item",
            "BasicInfo": {
              "SellerPartNumber": "JACKETEST0921001003",
              "Manufacturer": "AMD",
              "ManufacturerPartsNumber": "JACKETEST0921001003",
              "WebsiteShortTitle": "Sick1111111",
              "BulletDescription":"This is first bullet^^This is second bullet",
              "ProductDescription": "hello222222",
              "ItemDimension": {
                "ItemLength": "4",
                "ItemWidth": "5",
                "ItemHeight": "6"
              },
              "ItemWeight": "5",
              "PacksOrSets": "1",
              "ItemCondition": "UsedGood",
              "ItemPackage": "OEM",
              "ShippingRestriction": "Yes",
              "Currency": "USD",
              "SellingPrice": "100",
              "Shipping": "Free",
              "Inventory": "100",
              "LimitQuantity": "1",
              "ActivationMark": "True",
              "ItemImages": {
                "Image": { "ImageUrl": "http://10.1.24.143:4567/images/20.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",
                "OverAge18Verification": "Yes",
                "ChokingHazard": {
                  "SmallParts": "Yes",
                  "SmallBall": "Is a small ball",
                  "Balloons": "Yes",
                  "Marble": "Is a marble"
                }
              }
            },
            "SubCategoryProperty": {
              "CostumeAccessories": {
                "CostumeAccBrand": "String",
                "CostumeAccModel": "String",
                "CostumeAccGender": "Male",
                "CostumeAccAge": "Adult",
                "CostumeAccType": "Blood & Gore",
                "CostumeAccTheme": "Animals & Insects",
                "CostumeAccOccasion": "1st Birthday",
                "CostumeAccSize": "#10",
                "CostumeAccColor": "String",
                "CostumeAccMaterial": "String",
                "CostumeAccCareInstructions": "String"
              }
            }
          },
          {
            "Action": "Create Item",
            "BasicInfo": {
              "SellerPartNumber": "JACKETEST0921001004",
              "Manufacturer": "AMD",
              "ManufacturerPartsNumber": "JACKETEST0921001004",
              "WebsiteShortTitle": "Sick1111111",
              "ProductDescription": "hello222222",
              "ItemDimension": {
                "ItemLength": "4",
                "ItemWidth": "5",
                "ItemHeight": "6"
              },
              "ItemWeight": "3",
              "PacksOrSets": "1",
              "ItemCondition": "New",
              "ItemPackage": "OEM",
              "ShippingRestriction": "Yes",
              "Currency": "USD",
              "SellingPrice": "100",
              "Shipping": "Free",
              "Inventory": "100",
              "LimitQuantity": "1",
              "ActivationMark": "True",
              "ItemImages": {
                "Image": { "ImageUrl": "http://10.1.24.143:4567/images/20.gif" }
              },
              "Warning": {
                "Prop65": "No",
                "Prop65Motherboard": "Yes",
                "CountryOfOrigin": "USA",
                "OverAge18Verification": "Yes",
                "ChokingHazard": {
                  "SmallParts": "Yes",
                  "SmallBall": "Is a small ball",
                  "Balloons": "Yes",
                  "Marble": "Is a marble"
                }
              }
            },
            "SubCategoryProperty": {
              "CostumeAccessories": {
                "CostumeAccBrand": "String",
                "CostumeAccModel": "String",
                "CostumeAccGender": "Male",
                "CostumeAccAge": "Adult",
                "CostumeAccType": "Blood & Gore",
                "CostumeAccTheme": "Animals & Insects",
                "CostumeAccOccasion": "1st Birthday",
                "CostumeAccSize": "#10",
                "CostumeAccColor": "String",
                "CostumeAccMaterial": "String",
                "CostumeAccCareInstructions": "String"
              }
            }
          }
        ]
      }
    }
  }
}

回覆文件主體

屬性 格式 描述
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