获取报告处理状态
获取指定报告请求的状态。
相关URL
Newegg.com: https://api.newegg.com/marketplace/reportmgmt/report/status?sellerid={sellerid}
Neweggbusiness.com: https://api.newegg.com/marketplace/b2b/reportmgmt/report/status?sellerid={sellerid}
Newegg.ca: https://api.newegg.com/marketplace/can/reportmgmt/report/status?sellerid={sellerid}
注:请确保您的请求URL全都是小写(除Seller ID)并且不能包含任何空格或者换行符。
参数
| 名称 | 是否必填? | 描述 |
| sellerid | 是 | 您在新蛋商城的商家编号 |
相关请求信息
| HTTP方式 | 是否需要认证? | 请求格式 | 回复格式 | 频率限制 |
| PUT | 需要 | XML,Json | XML,Json | 500 请求/小时 |
请求文件主体
| 属性 | 是否必填? | 格式 | 描述 |
| IssueUser | 否 | String | 请求发送者在Seller Portal上注册过的邮箱地址 。 系统只接受商家注册过的Seller Portal邮箱地址。如果为空,默认值为商家编号 |
| OperationType | 是 | String | 固定值:GetReportStatusRequest |
| RequestID | 否 | String | 一个由新蛋为每个数据请求生成请求ID的列表,如果指定请求ID,RequestType,MaxCount,RequestStatus,RequestDateFrom 和 RequestDateTo都可以忽略。 |
| RequestType | 是 | String | 任务类型列表,可用值: ALL(默认) ORDER_LIST_REPORT SETTLEMENT_SUMMARY_REPORT SETTLEMENT_TRASACTION_ REPORT DAILY_INVENTORY_ REPORT RMA_LIST_REPORT ITEM_LOOKUP INTERNATIONAL_INVENTORY_REPORT INTERNATIONAL_PRICE_REPORT CAPROP65 _REPORT ITEM_BASIC_INFO_REPORT |
| MaxCount | 否 | Integer | 返回记录数最大值。默认值最大值均为100。如果你的值超过100,系统仍只返回100条记录 |
| RequestStatus | 否 | String | 数据提交状态, 有效值: SUBMITTED(已提交) IN_PROGRESS(处理中) FINISHED(已完成) CANCELLED(已取消) ALL(所有) |
| RequestDateFrom | 否 | String | 根据时间范围查找(太平洋标准时间)。请参考可接受时间格式 |
| RequestDateTo | 否 | String | 根据时间范围查找(太平洋标准时间)。请参考可接受时间格式 |
Schema: GetReportStatusRequest.xsd
示例:XML,Request
PUT https://api.newegg.com/marketplace/reportmgmt/report/status?sellerid={sellerid}
Authorization: 720ddc067f4d115bd544aff46bc75634
SecretKey: 21EC2020-3AEA-1069-A2DD-08002B30309D
Content-Type: application/xml
Accept: application/xml
<NeweggAPIRequest>
<OperationType>GetReportStatusRequest</OperationType>
<RequestBody>
<GetRequestStatus>
<RequestIDList>
<RequestID>2PQBYWH4V68ZP</RequestID>
</RequestIDList>
<MaxCount>10</MaxCount>
</GetRequestStatus>
</RequestBody>
</NeweggAPIRequest>
示例:Json,Request
PUT https://api.newegg.com/marketplace/reportmgmt/report/status?sellerid={sellerid}
Authorization: 720ddc067f4d115bd544aff46bc75634
SecretKey: 21EC2020-3AEA-1069-A2DD-08002B30309D
Content-Type: application/json
Accept: application/json
{
"OperationType": "GetReportStatusRequest",
"RequestBody": {
"GetRequestStatus": {
"RequestIDList": {
"RequestID": "2PQBYWH4V68ZP"
},
"MaxCount": "10"
}
}
}
回复文件主体
| 属性 | 格式 | 描述 |
| IsSuccess | String | 获取数据状态操作: True:成功 False:失败 |
| OperationType | String | 固定值:GetReportStatusResponse |
| RequestId | String | 新蛋为已提交的请求分配的编号 |
| RequestType | String | 有效值: ORDER_LIST_REPORT SETTLEMENT_SUMMARY_REPORT SETTLEMENT_TRASACTION_REPORT DAILY_INVENTORY_ REPORT RMA_LIST_REPORT ITEM_LOOKUP INTERNATIONAL_INVENTORY_REPORT INTERNATIONAL_PRICE_REPORT PREMIER_ITEM_REPORT CAPROP65 _REPORT ITEM_BASIC_INFO_REPORT |
| RequestDate | String | 数据提交的时间(太平洋标准时间) |
| RequestSatus | String | 提交状态: SUBMITTED 已提交 IN_PROGRESS 处理中 FINISHED 已完成 CANCELLED 已取消 |
| TotalCount | Integer | 记录总数 |
| Memo | String | 附加信息 |
Schema: GetReportStatusResponse.xsd
示例:XML,Response
<?xml version="1.0" encoding="utf-8"?>
<NeweggAPIResponse>
<IsSuccess>true</IsSuccess>
<OperationType>GetReportStatusResponse</OperationType>
<SellerID>A006</SellerID>
<ResponseBody>
<ResponseList>
<ResponseInfo>
<RequestId>2PQBYWH4V68ZP</RequestId>
<RequestType>ORDER_LIST_REPORT</RequestType>
<RequestDate>2/21/2012 14:38:17</RequestDate>
<RequestStatus>FINISHED</RequestStatus>
<TotalCount>4</TotalCount>
</ResponseInfo>
</ResponseList>
</ResponseBody>
</NeweggAPIResponse>
示例:Json,Response
{
"IsSuccess": true,
"OperationType": "GetReportStatusResponse",
"ResponseBody": {
"ResponseList": [
{
"RequestDate": "2/21/2012 14:38:17",
"RequestId": "2PQBYWH4V68ZP",
"RequestStatus": "IN_PROGRESS",
"RequestType": "ORDER_LIST_REPORT",
"TotalCount": 4
}
]
},
"SellerID": "A006"
}
请求失败错误信息
常规HTTP错误回复,请参考回复失败错误代码列表。
| 错误代码 | 描述 |
| RP004 | Date From is required.
起始时间(Date From)必填 |
| RP005 | Date To is required.
结束时间(Date To)必填 |
| RP006 | Invalid Date From.
无效的起始时间(Date From) |
| RP007 | Invalid Date To.
无效的结束时间(Date To) |
示例:XML,Response
<?xml version="1.0" encoding="utf-8"?>
<Errors>
<Error>
<Code>RP004</Code>
<Message>Date From is required</Message>
</Error>
</Errors>
示例:Json,Response
[
{
"Code": "RP004",
"Message": "Date From is required"
}
]
更新日期:10/28/2021