listTransactions

返回给定参数的交易。交易出现在您的交易事件中可能需要最长 48 小时。

使用计划：

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

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

请求参数

Query 参数

postedAfter

string <date-time>

必需

用于选择在指定时间之后（或等于该时间）发布的交易的日期。日期时间必须在请求提交前不晚于两分钟，采用ISO 8601日期时间格式。

示例值:

2023-01-12

postedBefore

string <date-time>

可选

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

示例值:

2023-02-12

marketplaceId

string

可选

用于选择市场 ID 的字符串令牌。

示例值:

ATIV93840DER

nextToken

string

可选

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

示例值:

jehgri34yo7jr9e8f984tr9i4o

返回响应

🟢200成功。

application/json

Body

响应模式。

nextToken

string

可选

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

transactions

array[object (Transaction) {12}]

可选

包含在特定时间段内的交易。

sellingPartnerMetadata

object (SellingPartnerMetadata)

描述卖方的元数据。

可选

relatedIdentifiers

array[object (RelatedIdentifier) {2}]

可选

与交易相关的商业标识符。

transactionType

string

可选

交易类型。

可选值：

发货

transactionId

string

可选

在generateOrderScenarios请求的响应中返回的唯一标识符。

transactionStatus

string

可选

交易状态。

可能的值：

延迟 * 已释放

description

string

可选

描述交易原因。

示例：'订单支付'，'退款订单'

postedDate

string <date-time>

可选

具有日期模式类型的字段采用 ISO 8601 日期时间格式（例如 GroupBeginDate）。

totalAmount

object (Currency)

可选

一种货币类型和金额。

marketplaceDetails

object (MarketplaceDetails)

可选

有关交易发生的市场的信息。

示例值:

{"marketplaceId":"ATVPDKIKX0DER","marketplaceName":"Amazon.com"}

items

array[object (Item) {5}]

可选

包裹中包含的物品清单。

contexts

array[object (Context) {17}]

可选

有关该项目的附加信息清单。

breakdowns

array[object (Breakdown) {3}]

可选

财务交易中总金额计算细节的明细清单。

示例

{
  "nextToken": "string",
  "transactions": [
    {
      "sellingPartnerMetadata": {
        "sellingPartnerId": "XXXXXXXXXXXXXX",
        "accountType": "PAYABLE",
        "marketplaceId": "ATVPDKIKX0DER"
      },
      "relatedIdentifiers": [
        {
          "relatedIdentifierName": "ORDER_ID",
          "relatedIdentifierValue": "8129762527551"
        }
      ],
      "transactionType": "Shipment",
      "transactionId": "b1qD0oAliFkLiqRyGbmeT0DoS2Z2kHzi7TZ92z-vARI",
      "transactionStatus": "Released",
      "description": "订单付款",
      "postedDate": "2020-07-14T03:35:13.214Z",
      "totalAmount": {
        "currencyAmount": 10,
        "currencyCode": "USD"
      },
      "marketplaceDetails": {
        "marketplaceId": "ATVPDKIKX0DER",
        "marketplaceName": "Amazon.com"
      },
      "items": [
        {
          "description": "物品标题",
          "totalAmount": {
            "currencyAmount": 10,
            "currencyCode": "USD"
          },
          "relatedIdentifiers": [
            {
              "itemRelatedIdentifierName": "ORDER_ADJUSTMENT_ITEM_ID",
              "itemRelatedIdentifierValue": "81297625-121-27551"
            }
          ],
          "breakdowns": [
            {
              "breakdownType": "Product Charges",
              "breakdownAmount": {
                "currencyAmount": 10,
                "currencyCode": "USD"
              },
              "breakdowns": [
                {
                  "breakdownType": "Principle",
                  "breakdownAmount": {
                    "currencyAmount": 10,
                    "currencyCode": "USD"
                  },
                  "breakdowns": []
                }
              ]
            }
          ],
          "contexts": [
            {
              "contextType": "ProductContext",
              "asin": "B07FGXZQZ1",
              "sku": "sku-12",
              "quantityShipped": 1,
              "fulfillmentNetwork": "MFN"
            }
          ]
        }
      ],
      "breakdowns": {
        "breakdowns": [
          {
            "breakdownType": "Sales",
            "breakdownAmount": {
              "currencyAmount": 10,
              "currencyCode": "USD"
            },
            "breakdowns": [
              {
                "breakdownType": "Product Charges",
                "breakdownAmount": {
                  "currencyAmount": 10,
                  "currencyCode": "USD"
                },
                "breakdowns": []
              }
            ]
          }
        ]
      },
      "contexts": [
        {
          "contextType": "AmazonPayContext",
          "storeName": "Store 1",
          "orderType": "Order Type",
          "channel": "MFN"
        }
      ]
    }
  ]
}

🟠400请求缺少或无效的参数，无法解析。

🟠403表示禁止访问该资源。可能的原因包括访问被拒绝、未经授权、令牌过期或签名无效。

🟠404指定的资源不存在。

🟠413请求大小超过了最大接受大小。

🟠415请求负载格式不受支持。

🟠429请求的频率超过了允许的范围。

🔴500发生了意外情况，导致服务器无法完成请求。

🔴503服务器的临时超载或维护。

请求参数

示例代码

返回响应