createInvoicesExport - Amazon Selling Partner API (SP-API)-中文

创建发票导出请求。

使用计划：

速率（每秒请求数）	峰值
0.167	1

x-amzn-RateLimit-Limit 响应头返回请求操作所应用的使用计划速率限制（如适用）。前面的表格表示该操作的默认速率和峰值值。业务需求要求更高吞吐量的销售合作伙伴，可能具有比此处显示的更高的速率和峰值值。有关更多信息，请参阅销售合作伙伴 API 中的使用计划和速率限制。

请求参数

Body 参数application/json

创建出口申请所需的信息。

dateEnd

string <date>

可选

您希望在响应中包含的发票的最新发票创建日期。日期采用ISO 8601日期时间格式。默认为请求时的时间。

dateStart

string <date>

可选

要包含在响应中的发票的最早发票创建日期。日期采用 ISO 8601 日期时间格式。默认值为请求时间的前24小时。

externalInvoiceId

string

可选

您希望包含在响应中的发票的外部 ID。

fileFormat

enum<string>

可选

支持的发票文件扩展名。

枚举值:

XML

invoiceType

string

可选

市场特定的发票类型分类。使用 getInvoicesAttributes 操作检查 invoiceType 选项。

marketplaceId

string

必需

您希望获取发票的市场 ID。

series

string

可选

您希望包含在回复中的发票系列号。

statuses

array[string]

可选

可用于筛选发票的状态列表。使用 getInvoicesAttributes 操作来检查发票状态选项。

最小计数：1

>= 1 items

transactionIdentifier

object (TransactionIdentifier)

交易的标识符。

可选

name

string

可选

交易标识符名称。使用 getInvoicesAttributes 操作检查 transactionIdentifierName 选项。

string

交易标识符。

可选

transactionType

string

可选

为创建发票的交易类型的市场特定分类。使用 getInvoicesAttributes 操作检查 transactionType 选项。

示例

{
  "dateEnd": "2024-07-30T23:59:59",
  "dateStart": "2024-07-01T00:00:00",
  "externalInvoiceId": "1283743",
  "fileFormat": "XML",
  "invoiceType": "SYMBOLIC_RETURN",
  "marketplaceId": "A2Q3Y263D00KWC",
  "series": "32",
  "statuses": [
    "AUTHORIZED"
  ],
  "transactionIdentifier": {
    "name": "BUSINESS_TRANSACTION_ID",
    "id": "94cd4e1a-5cc5-486d-b592-045a95a168e1"
  },
  "transactionType": "CUSTOMER_SALES"
}

示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

返回响应

🟢202成功。

application/json

Body

成功。

exportId

string

导出标识符。

可选

示例

{
  "exportId": "string"
}

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

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

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

🟠404指定的资源不存在。

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

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

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

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

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