商品價格更新
批量更新商品價格資訊,物流以及啟動目標國家的商品。
註:如果沒有啟動新蛋全球項目(即添加配送國家),則默認為美國。添加不同的配送國家,您可在以下路徑進行管理,登入新蛋Seller Portal > 帳戶訊息> 商品運送設定,詳情請參照我們的新蛋全球專案。
相關URL
Newegg.com: https://api.newegg.com/marketplace/datafeedmgmt/feeds/submitfeed?sellerid={sellerid}&requesttype={RequestType}
註:請確保您的請求URL全都是小寫(除Seller ID)並且不能包含任何空格或者分行符號。
參數
| 名稱 | 是否必填? | 描述 |
| sellerid | 是 | 您在新蛋商城的商家編號 |
| RequestType | 是 | 值:PRICE_DATA |
相關請求資訊
| HTTP方式 | 是否需要認證? | 請求格式 | 回覆格式 | 頻率限制 |
| POST | 需要 | XML,Json | XML,Json | 10請求/分鐘 |
註:每個文件最多可有10,000條請求記錄。每小時最多100,000條記錄。
請求文件主體
| 屬性 | 是否必填 | 格式 | 描述 |
| DocumentVersion | 是 | Decimal | 固定值:2.0 |
| MessageType | 是 | String | 固定值:Price |
| SellerPartNumber | 是 | String | 商家為商品定義的唯一識別碼。 包含字母和數位的字串,含空格最多 40個字元。 註:一旦商品創建成功,該資訊不能更改。 |
| NeweggItemNumber | 否 | String | 新蛋為商品分配的唯一標示符 |
| CountryCode | 是 | String | 您的商品將要銷往的國家。只能使用國際標準三位國家代碼。 完整國家代碼清單,請通過以下連結下載:International Country Guide。 註:在提交請求時,商品價格的貨幣代碼必須要與商品銷往國家的國家代碼相匹配。 否則,系統會報錯。 |
| Currency | 是 | String | 你的商品將要銷往的國家的 Selling Price,MSRP,MAP 欄位的貨幣單位,只能使用國際標準三位國家代碼。如果不填,系統預設為USD。 完整國家代碼清單,請通過以下連結下載:International Country Guide。 註:在提交請求時,商品價格的貨幣代碼必須要與商品銷往國家的國家代碼相匹配。 否則,系統會報錯。 |
| 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 > 帳戶訊息> 商品運送設定裡的物流費率決定的。 |
| LimitQuantity | 否 | Integer | 每個顧客在48小時內可購買商品的最大數量,最大值為500。如果值為: 0:系統將刪除現有設置 null:無更新 |
| ActivationMark | 否 | String | 有效值: True:啟動商品,該商品會展示在新蛋網頁上進行售賣 False:下架商品,該商品會被隱藏/下線,不會在新蛋網頁上銷售。 如果不填,系統將不會對該商品目前的狀態做任何更改。 註: 如果新蛋賣家帳戶狀態為“Inactive”,所有商品將會被下線。因此,如果要啟動商品,首先該賣家帳戶必須為“Active”。更多詳情,請聯繫datafeeds@newegg.com |
Schema: PriceUpdate.xsd
示例:XML, Request
POST https://api.newegg.com/marketplace/datafeedmgmt/feeds/submitfeed?sellerid={sellerid}&requesttype=PRICE_DATA
Authorization: 720ddc067f4d115bd544aff46bc75634
SecretKey: 21EC2020-3AEA-1069-A2DD-08002B30309D
Content-Type: application/xml
Accept: application/xml
<?xml version="1.0" encoding="UTF-8"?>
<NeweggEnvelope>
<Header>
<DocumentVersion>2.0</DocumentVersion>
<!--The identifier for the very of current feed; assigned by Newegg-->
</Header>
<MessageType>Price</MessageType>
<Message>
<Price>
<Item>
<SellerPartNumber>a006-test-001</SellerPartNumber>
<!--A seller-defined unique identifier for an item. An alphanumeric string, max 40 characters including space-->
<NeweggItemNumber>9SIAWE50008504</NeweggItemNumber>
<!--Newegg’s unique identifier for an item-->
<CountryCode>USA</CountryCode>
<Currency>USD</Currency>
<!--The form of money for all price related elements. -->
<MAP>9.99</MAP>
<CheckoutMAP>True</CheckoutMAP>
<SellingPrice>100.00</SellingPrice>
<Shipping>default</Shipping>
<!--The shipping charge setting for this item. -->
<LimitQuantity>1</LimitQuantity>
<ActivationMark>True</ActivationMark>
<!--True will send request to activate listing so it will be visible on Newegg websites, False will offline the listing.] -->
</Item>
</Price>
</Message>
</NeweggEnvelope>
示例:Json, Request
POST https://api.newegg.com/marketplace/datafeedmgmt/feeds/submitfeed?sellerid={sellerid}&requesttype=PRICE_DATA
Authorization: 720ddc067f4d115bd544aff46bc75634
SecretKey: 21EC2020-3AEA-1069-A2DD-08002B30309D
Content-Type: application/json
Accept: application/json
{
"NeweggEnvelope": {
"Header": {
"DocumentVersion": "2.0"
},
"MessageType": "Price",
"Message": {
"Price": [{
"Item": {
"SellerPartNumber": "a006-test-001",
"NeweggItemNumber": "9SIAWE50008504",
"CountryCode": "USA",
"Currency": "USD",
"MAP": "9.99",
"CheckoutMAP": "True",
"SellingPrice": "100.00",
"Shipping": "default",
"LimitQuantity": "1",
"ActivationMark": "True"
},
"Item": {
"SellerPartNumber": "a006-test-002",
"NeweggItemNumber": "9SIAWE50008505",
"CountryCode": "USA",
"Currency": "USD",
"MAP": "9.99",
"CheckoutMAP": "True",
"SellingPrice": "100.00",
"Shipping": "default",
"LimitQuantity": "1",
"ActivationMark": "True"
}
}]
}
}
}
回覆文件主體
| 屬性 | 格式 | 描述 |
| IsSuccess | String | 獲取文件狀態操作: True:成功 False:失敗 |
| OperationType | String | 固定值:SubmitFeedResponse |
| SellerID | String | 商家編號 |
| RequestType | String | 值: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>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": "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