listFinancialEventsByGroupId

北美(North America）

https://sellingpartnerapi-na.amazon.com

GET

/finances/v0/financialEventGroups/{eventGroupId}/financialEvents

返回指定财务事件组的所有财务事件。订单可能需要最多48小时才能出现在您的财务事件中。

注意： 此操作仅检索过去两年的组数据。如果提交的数据请求跨越超过两年的时间范围，将返回空响应。

使用计划：

速率（每秒请求数）	突发
0.5	30

x-amzn-RateLimit-Limit 响应头返回适用于请求操作的使用计划速率限制（如果可用）。上表指示此操作的默认速率和突发值。业务需求需要更高吞吐量的销售合作伙伴可能会看到比这里显示的更高的速率和突发值。有关更多信息，请参阅销售合作伙伴API中的使用计划和速率限制。

请求参数

Path 参数

eventGroupId

string

必需

事件所属的财务事件组的标识符。

Query 参数

MaxResultsPerPage

integer <int32>

可选

每页返回的最大结果数。如果响应超过最大事务数或10 MB，API将返回“无效输入”。

>= 1<= 100

默认值:

100

PostedAfter

string <date-time>

可选

用于选择在指定时间之后（或在指定时间）发布的财务事件的日期。日期时间必须在请求时间之前超过两分钟，采用ISO 8601 日期时间格式。

PostedBefore

string <date-time>

可选

用于选择在指定时间之前（但不包括该时间）发布的财务事件的日期。日期和时间必须晚于 PostedAfter，并且不得晚于请求提交前两分钟的时间，格式为 ISO 8601 日期时间格式。如果 PostedAfter 和 PostedBefore 相差超过 180 天，则不会返回任何财务事件。如果你指定了 PostedBefore 参数，则必须指定 PostedAfter 参数。默认值：当前时间减去两分钟。

NextToken

string

可选

在您之前请求的响应中返回的字符串令牌。

示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location --request GET 'https://sellingpartnerapi-na.amazon.com/finances/v0/financialEventGroups//financialEvents'

返回响应

🟢200成功

application/json

成功。

Body

listFinancialEvents操作的响应架构。

payload

object (ListFinancialEventsPayload)

可选

listFinancialEvents操作的有效载荷。

NextToken

string

可选

在存在且不为空时，请在下一个请求中传递此字符串标记，以返回下一个响应页面。

FinancialEvents

object (FinancialEvents)

可选

包含与金融事件相关的所有信息。

errors

array[object (Error) {3}]

可选

请求失败时返回的错误响应列表。

code

string

必需

一个标识发生错误类型的错误代码。

message

string

必需

一种以人类可读的形式描述错误状态的消息。

details

string

可选

可以帮助拨打者理解或解决问题的附加细节。

示例

🟠400请求有误

🟠403禁止访问

🟠404记录不存在

🟠429429

🔴500服务器错误

🔴503服务器故障

listFinancialEventGroups

listFinancialEventsByOrderId