批量折扣商品管理
批量添加/更新/删除参加批量折扣活动的商品。
相关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 | 是 | 值:VOLUME_DISCOUNT_DATA |
相关请求信息
HTTP方式 | 是否需要认证? | 请求格式 | 回复格式 | 频率限制 |
POST | 需要 | XML,Json | XML,Json | 1000 请求/小时 |
请求文件主体
属性 | 是否必填? | 格式 | 描述 |
DocumentVersion | 是 | Decimal | 固定值:1.0 |
MessageType | 是 | String | 固定值:VolumeDiscount |
SellerPartNumber | 是 | String | 商品的seller part#。它将用于标识该商品加入/退出该项目。 |
NeweggItemNumber | 否 | String | 新蛋分配给每个商品的唯一标识符 |
VolumeActivation | 是 | String | 有效值: True:添加批量折扣项目的商品或者更新项目中已存在的商品。 False:从批量折扣项目中移除商品 |
Priority | 是 | Integer | 为批量折扣设置阶梯 |
Quantity | 是 | Integer | 为当前阶梯的批量折扣设置商品订购数量 |
SellingPrice | 是 | Decimal | 为当前阶梯的批量折扣设置商品单价 |
EnableFreeShipping | 是 | Integer | 为当前阶梯的批量折扣设置运输方式。 有效值: 0:Default shipping 默认运费 1:Free shipping 免运费 |
Schema: VolumeDiscount.xsd
示例:XML,Request
POST https://api.newegg.com/marketplace/datafeedmgmt/feeds/submitfeed?sellerid={sellerid}&requesttype=VOLUME_DISCOUNT_DATA Authorization: 720ddc067f4d115bd544aff46bc75634 SecretKey: 21EC2020-3AEA-1069-A2DD-08002B30309D Content-Type: application/xml Accept: application/xml <NeweggEnvelope> <Header> <DocumentVersion>1.0</DocumentVersion> </Header> <MessageType>VolumeDiscount</MessageType> <Message> <VolumeDiscountList> <ItemVolumeDiscountInfo> <SellerPartNumber>Lisa123</SellerPartNumber> <NeweggItemNumber>9SIA0060004762</NeweggItemNumber> <VolumeActivation>True</VolumeActivation> <DiscountSetting> <Tier> <Priority>1</Priority> <Quantity>10</Quantity> <SellingPrice>9999.99</SellingPrice> <EnableFreeShipping>0</EnableFreeShipping> </Tier> <Tier> <Priority>2</Priority> <Quantity>20</Quantity> <SellingPrice>8888.99</SellingPrice> <EnableFreeShipping>0</EnableFreeShipping> </Tier> <Tier> <Priority>3</Priority> <Quantity>30</Quantity> <SellingPrice>7777.99</SellingPrice> <EnableFreeShipping>0</EnableFreeShipping> </Tier> </DiscountSetting> </ItemVolumeDiscountInfo> <ItemVolumeDiscountInfo> <SellerPartNumber>789</SellerPartNumber> <NeweggItemNumber>012</NeweggItemNumber> <VolumeActivation>True</VolumeActivation> <DiscountSetting> <Tier> <Priority>1</Priority> <Quantity>10</Quantity> <SellingPrice>9999.99</SellingPrice> <EnableFreeShipping>0</EnableFreeShipping> </Tier> </DiscountSetting> </ItemVolumeDiscountInfo> <ItemVolumeDiscountInfo> <SellerPartNumber>123</SellerPartNumber> <VolumeActivation>True</VolumeActivation> <DiscountSetting> <Tier> <Priority>1</Priority> <Quantity>10</Quantity> <SellingPrice>9999.99</SellingPrice> <EnableFreeShipping>1</EnableFreeShipping> </Tier> </DiscountSetting> </ItemVolumeDiscountInfo> <ItemVolumeDiscountInfo> <NeweggItemNumber>456</NeweggItemNumber> <VolumeActivation>True</VolumeActivation> <DiscountSetting> <Tier> <Priority>1</Priority> <Quantity>10</Quantity> <SellingPrice>9999.99</SellingPrice> <EnableFreeShipping>0</EnableFreeShipping> </Tier> </DiscountSetting> </ItemVolumeDiscountInfo> <ItemVolumeDiscountInfo> <SellerPartNumber>B0369008</SellerPartNumber> <NeweggItemNumber>9SIA0060002417</NeweggItemNumber> <VolumeActivation>False</VolumeActivation> </ItemVolumeDiscountInfo> <ItemVolumeDiscountInfo> <SellerPartNumber>B0369008</SellerPartNumber> <VolumeActivation>False</VolumeActivation> </ItemVolumeDiscountInfo> <ItemVolumeDiscountInfo> <NeweggItemNumber>9SIA0060002417</NeweggItemNumber> <VolumeActivation>False</VolumeActivation> </ItemVolumeDiscountInfo> <ItemVolumeDiscountInfo> <SellerPartNumber>345</SellerPartNumber> <VolumeActivation>False</VolumeActivation> </ItemVolumeDiscountInfo> <ItemVolumeDiscountInfo> <NeweggItemNumber>678</NeweggItemNumber> <VolumeActivation>False</VolumeActivation> </ItemVolumeDiscountInfo> </VolumeDiscountList> </Message> </NeweggEnvelope>
示例:Json,Request
POST https://api.newegg.com/marketplace/datafeedmgmt/feeds/submitfeed?sellerid={sellerid}&requesttype=VOLUME_DISCOUNT_DATA Authorization: 720ddc067f4d115bd544aff46bc75634 SecretKey: 21EC2020-3AEA-1069-A2DD-08002B30309D Content-Type: application { "NeweggEnvelope": { "Header": { "DocumentVersion": "1.0" }, "MessageType": "VolumeDiscount", "Message": { "VolumeDiscountList": { "ItemVolumeDiscountInfo": [ { "SellerPartNumber": "Lisa123", "NeweggItemNumber": "9SIA0060004762", "VolumeActivation": "True", "DiscountSetting": { "Tier": [ { "Priority": "1", "Quantity": "10", "SellingPrice": "9999.99", "EnableFreeShipping": "0" }, { "Priority": "2", "Quantity": "20", "SellingPrice": "8888.99", "EnableFreeShipping": "0" }, { "Priority": "3", "Quantity": "30", "SellingPrice": "7777.99", "EnableFreeShipping": "0" } ] } }, { "SellerPartNumber": "789", "NeweggItemNumber": "012", "VolumeActivation": "True", "DiscountSetting": { "Tier": { "Priority": "1", "Quantity": "10", "SellingPrice": "9999.99", "EnableFreeShipping": "0" } } }, { "SellerPartNumber": "123", "VolumeActivation": "True", "DiscountSetting": { "Tier": { "Priority": "1", "Quantity": "10", "SellingPrice": "9999.99", "EnableFreeShipping": "1" } } }, { "NeweggItemNumber": "456", "VolumeActivation": "True", "DiscountSetting": { "Tier": { "Priority": "1", "Quantity": "10", "SellingPrice": "9999.99", "EnableFreeShipping": "0" } } }, { "SellerPartNumber": "B0369008", "NeweggItemNumber": "9SIA0060002417", "VolumeActivation": "False" }, { "SellerPartNumber": "B0369008", "VolumeActivation": "False" }, { "NeweggItemNumber": "9SIA0060002417", "VolumeActivation": "False" }, { "SellerPartNumber": "345", "VolumeActivation": "False" }, { "NeweggItemNumber": "678", "VolumeActivation": "False" } ] } } } }
回复文件主体
属性 | 格式 | 描述 |
IsSuccess | String | 获取文件状态操作: True: 成功 False: 失败 |
OperationType | String | 固定值:SubmitFeedResponse |
SellerID | String | 商家编号 |
RequestType | String | 值:VOLUME_DISCOUNT_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>VOLUME_DISCOUNT_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": "VOLUME_DISCOUNT_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" } ]
更新日期:10/15/2018