提交商品基本信息报告
请求获取卖家可用商品基本信息列表。
相关URL
Newegg.com: https://api.newegg.com/marketplace/reportmgmt/report/submitrequest?sellerid={sellerid}
Neweggbusiness.com: https://api.newegg.com/marketplace/b2b/reportmgmt/report/submitrequest?sellerid={sellerid}
Newegg.ca: https://api.newegg.com/marketplace/can/reportmgmt/report/submitrequest?sellerid={sellerid}
注:请确保您的请求URL全都是小写(除Seller ID)并且不能包含任何空格或者换行符。
参数
| 名称 | 是否必填? | 描述 |
| sellerid | 是 | 您在新蛋商城的商家编号 |
相关请求信息
| HTTP方式 | 是否需要认证? | 请求格式 | 回复格式 | 频率限制 |
| POST | 需要 | XML,Json | XML,Json | 100 请求/小时 |
请求文件主体
| 属性 | 是否必填? | 格式 | 描述 |
| OperationType | 是 | String | 固定值:ItemBasicInfoReportRequest |
| IssueUser | 否 | String | 请求发送者在Seller Portal上注册过的邮箱地址 。 系统只接受商家注册过的Seller Portal邮箱地址。如果为空,默认值为商家编号 |
| RequestType | 是 | String | 固定值:ITEM_BASIC_INFO_REPORT |
| Status | 否 | Integer | 有效值: 0: All (Default)(所有(默认)) 1: Active(已上架) 2: Inactive(已下架) |
| FileType | 否 | String | 可用文件格式: TXT: 默认 CSV XLS 如果为空,系统将使用默认文件格式,即TXT格式 |
Schema: ItemBasicInfoReportRequest.xsd
示例:XML,Request
POST https://api.newegg.com/marketplace/reportmgmt/report/submitrequest?sellerid={sellerid}
Authorization: 720ddc067f4d115bd544aff46bc75634
SecretKey: 21EC2020-3AEA-1069-A2DD-08002B30309D
Content-Type: application/xml
Accept: application/xml
<NeweggAPIRequest>
<OperationType>ItemBasicInfoReportRequest</OperationType>
<RequestBody>
<ItemBasicInfoReportCriteria>
<RequestType>ITEM_BASIC_INFO_REPORT</RequestType>
<Status>2</Status>
<FileType>XLS</FileType>
</ItemBasicInfoReportCriteria>
</RequestBody>
</NeweggAPIRequest>
示例:Json,Response
POST https://api.newegg.com/marketplace/reportmgmt/report/submitrequest?sellerid={sellerid}
Authorization: 720ddc067f4d115bd544aff46bc75634
SecretKey: 21EC2020-3AEA-1069-A2DD-08002B30309D
Content-Type: application/json
Accept: application/json
{
"OperationType": "ItemBasicInfoReportRequest",
"RequestBody": {
"ItemBasicInfoReportCriteria": {
"RequestType": "ITEM_BASIC_INFO_REPORT",
"Status": 2,
"FileType": "XLS"
}
}
}
回复文件主体
| 属性 | 格式 | 描述 |
| IsSuccess | String | 获取数据状态操作: True:成功 False:失败 |
| OperationType | String | 固定值:ItemBasicInfoReportResponse |
| SellerID | String | 您的商家编号 |
| RequestId | String | 新蛋为已提交的请求分配的编号 |
| RequestType | String | 固定值:ITEM_BASIC_INFO_REPORT |
| RequestDate | String | 数据提交的时间(太平洋标准时间) |
| RequestSatus | String | 提交状态:
SUBMITTED 已提交(默认) |
| Memo | String | 附加信息 |
Schema: SubmitReportResponse.xsd
示例:XML,Request
<NeweggAPIResponse>
<IsSuccess>true</IsSuccess>
<OperationType>ItemBasicInfoReportResponse</OperationType>
<SellerID>a001</SellerID>
<ResponseBody>
<ResponseList>
<ResponseInfo>
<RequestId>270Z8Y3SYIGQV</RequestId>
<RequestType>ITEM_BASIC_INFO_REPORT</RequestType>
<RequestDate>10/26/2021 11:02:35</RequestDate>
<RequestStatus>SUBMITTED</RequestStatus>
</ResponseInfo>
</ResponseList>
</ResponseBody>
</NeweggAPIResponse>
示例:Json,Response
{
"IsSuccess": true,
"OperationType": " ItemBasicInfoReportResponse ",
"SellerID": "a001",
"ResponseBody": {
"ResponseList": [
{
"RequestId": "270Z8Y3SYIGQV",
"RequestType": "ITEM_BASIC_INFO_REPORT",
"RequestDate": "10/26/2021 11:02:35",
"RequestStatus": "SUBMITTED"
}
]
}
}
请求失败错误信息
常规HTTP错误回复,请参考回复失败错误代码列表。
| 错误代码 | 描述 |
| RP010 | Invalid Order Number.
无效的订单编号 |
| RP018 | Invalid Settlement Date.
无效的 Settlement Date(结算时间) |
| RP019 | The requestID cannot be null or empty.
请求编号(requestID)不能为空 |
| RP020 | We are unable to process your request because one of the following search criteria is required: SettlementID, SettlementDate, or SettlementDateFrom and SettlementDateTo.
我们无法处理你的请求,因为你必须提供下列搜索条件中的一个:SettlementID,SettlementDate 或 SettlementDateFrom 和 SettlementDateTo |
| RP021 | Maximum item lookup cannot exceed 1000 for each request.
每个请求的商品检索数量最多不超过1000个。 |
| RP022 | Daily Inventory Report does not support multiple warehouse locations. For multiple warehouse locations, please use International Program – Daily Inventory Report.
每日库存报告不支持多个仓库所在地。若有多个仓库所在地,请使用新蛋全球化- 每日库存报告章节内容。 |
示例:XML,Request
<?xml version="1.0" encoding="utf-8"?>
<Errors>
<Error>
<Code>RP018</Code>
<Message>Invalid Settlement Date</Message>
</Error>
</Errors>
示例:Json,Request
[
{
"Code": "RP018",
"Message": "Invalid Settlement Date"
}
]
更新日期:10/28/2021