商品庫存和價格更新

批量更新商品價格資訊，物流以及啟動商品。

註：一旦某商品被下架，所有有關價格和庫存的請求都將被忽略。只有當商品重新被啟動，您才可以再次更新價格和庫存資訊。

相關URL

該功能只適用於NeweggBusiness.com和Newegg.ca：

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 是 值：INVENTORY_AND_PRICE_DATA

相關請求資訊

HTTP方式 是否需要認證？ 請求格式 回覆格式 頻率限制
POST 需要 XML,Json XML,Json 10 請求/分鐘

註：每個文件最多可有10,000條請求記錄。每小時最多100,000條記錄。

請求文件主體

屬性 是否必填？ 格式 描述
DocumentVersion 是 Decimal 固定值：1.0
MessageType 是 String 固定值：Inventory
Overwrite 否 String 有效值：
Yes：將未列於該文件中的商品全部從網頁上下架。
No：如果您不願意未列於該文件的商品被下架，請一直保持Overwrite選項為NO
SellerPartNumber 是 String 商家為商品定義的唯一的識別字。包含字母和數位的字串，含空格最多 40個字元
註：一旦商品被創建，該資訊是不能修改。
NeweggItemNumber 否 String 新蛋為商品分配的唯一標示符
Currency 否 String 所有價格相關的欄位的貨幣形式。
有效值：
USD：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位。請不要使用逗號或美元符號。
Inventory 是 Integer 默認倉庫位置的有效庫存：

  • NeweggBusiness.com平台默認使用美國所在倉庫
  • Newegg.ca平台默認使用加拿大所在倉庫。
LimitQuantity 否 Integer 每個顧客在48小時內能購買商品的最大數量，最大值為500。
如果值為:
0：系統將刪除現有設置
null：無更新
FulfillmentOption 否 String 有效值：Newegg或Seller
Shipping 是 String 商品的運費設置。
有效值：Default或者Free
Default的運費設置是由賣家在新蛋Seller Portal > 帳戶訊息> 商品運送設定裡的物流費率決定的。
ActivationMark 否 String 有效值：
True：啟動商品，該商品會展示在新蛋網頁上進行售賣
False：下架商品，該商品會被隱藏/下線，不會在新蛋網頁上銷售。
如果不填，系統將不會對該商品目前的狀態做任何更改。
註：如果新蛋賣家帳戶狀態為“Inactive”，所有商品將會被下線。因此，如果要啟動商品，首先該賣家帳戶必須為“Active”。更多詳情，請聯繫datafeeds@newegg.com

Schema: Inventory.xsd

示例：XML, Request

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

<NeweggEnvelope>
    <Header>
        <DocumentVersion>1.0</DocumentVersion>
    </Header>
    <MessageType>Inventory</MessageType>
    <Overwrite>No</Overwrite>
    <Message>
        <Inventory>
            <Item>
                <SellerPartNumber>JACKETEST0921001004</SellerPartNumber>
                <SellingPrice>127.92</SellingPrice>
                <Inventory>159</Inventory>
                <LimitQuantity>5</LimitQuantity>
                <FulfillmentOption>Seller</FulfillmentOption>
                <Shipping>free</Shipping>
                <ActivationMark>False</ActivationMark>
                <Currency>USD</Currency>
                <NeweggItemNumber>9SIawes01X1339</NeweggItemNumber>
            </Item>
            <Item>
                <SellerPartNumber>JACKETEST0921001003</SellerPartNumber>
                <SellingPrice>119.22</SellingPrice>
                <Inventory>189</Inventory>
                <LimitQuantity>2</LimitQuantity>
                <FulfillmentOption>Seller</FulfillmentOption>
                <Shipping>free</Shipping>
                <ActivationMark>False</ActivationMark>
                <Currency>USD</Currency>
                <NeweggItemNumber>9SIawes01X1338</NeweggItemNumber>
            </Item>
        </Inventory>
    </Message>
</NeweggEnvelope>

示例：Json, Request

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

{
    "NeweggEnvelope": {
        "Header": {
            "DocumentVersion": "1.0"
        },
        "MessageType": "Inventory",
        "Overwrite": "No",
        "Message": {
            "Inventory": {
                "Item": [
                    {
                        "SellerPartNumber": "JACKETEST0921001004",
                        "SellingPrice": "127.92",
                        "Inventory": "159",
                        "LimitQuantity": "5",
                        "FulfillmentOption": "Seller",
                        "Shipping": "free",
                        "ActivationMark": "False",
                        "Currency": "USD",
                        "NeweggItemNumber": "9SIawes01X1339"
                    },
                    {
                        "SellerPartNumber": "JACKETEST0921001003",
                        "SellingPrice": "119.22",
                        "Inventory": "189",
                        "LimitQuantity": "2",
                        "FulfillmentOption": "Seller",
                        "Shipping": "free",
                        "ActivationMark": "False",
                        "Currency": "USD",
                        "NeweggItemNumber": "9SIawes01X1338"
                    }
                ]
            }
        }
    }
}

回覆文件主體

屬性 格式 描述
IsSuccess String 獲取文件狀態操作：
True：成功
False：失敗
OperationType String 固定值：SubmitFeedResponse
SellerID String 商家編號
RequestType String 值：INVENTORY_AND_PRICE_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>INVENTORY_AND_PRICE_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": "INVENTORY_AND_PRICE_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"
    }
]

更新日期：08/28/2020