商品价格更新
批量更新商品价格信息,物流以及激活目标国家的商品。
注:如果没有激活新蛋全球项目(即添加配送国家),则默认为美国。添加不同的配送国家,您可在以下路径进行管理,登录新蛋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