商品库存和价格更新
批量更新商品价格信息,物流以及激活商品。
注:一旦某商品被下架,所有有关价格和库存的请求都将被忽略。只有当商品重新被激活,您才可以再次更新价格和库存信息。
相关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 | 默认仓库位置的有效库存:
|
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