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

返回在您指定的时间范围内创建的客户发票列表。您可以使用 createdAfter 和 createdBefore 参数定义时间范围。必须同时使用这两个参数。搜索的日期范围不得超过 7 天。

使用计划：

速率（每秒请求）	爆发
10	10

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

请求参数

Query 参数

shipFromPartyId

string

可选

订单履行的供应商 warehouseId。如果未指定，结果将包含所有仓库的订单。

limit

integer

返回的记录数量限制

可选

>= 1<= 100

createdAfter

string <date-time>

必需

在此日期和时间之后可用的订单将包含在结果中。必须采用ISO 8601日期/时间格式。

createdBefore

string <date-time>

必需

在此日期和时间之前可用的订单将包含在结果中。必须采用ISO 8601日期/时间格式。

sortOrder

enum<string>

可选

按订单创建日期升序或降序排序。

枚举值:

ASCDESC

nextToken

string

可选

用于分页，当订单数量超过指定结果大小限制时。令牌值在上一个 API 调用中返回。

示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

返回响应

🟢200成功

application/json

成功。

Headers

x-amzn-RateLimit-Limit

string

可选

您对此操作的速率限制（每秒请求数量）。

x-amzn-RequestId

string

可选

唯一请求参考标识符。

Body

`getCustomerInvoices` 操作的响应架构。

payload

object (CustomerInvoiceList)

可选

表示客户发票的列表，可能是分页的。

pagination

object (Pagination)

可选

检索剩余数据所需的分页元素。

customerInvoices

array[object (CustomerInvoice) {2}]

可选

表示CustomerInvoiceList中的客户发票。

errors

array[object (Error) {3}]

可选

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

code

string

必需

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

message

string

必需

描述错误状态的消息。

details

string

可选

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

示例

{
    "payload": {
        "pagination": {
            "nextToken": "string"
        },
        "customerInvoices": [
            {
                "purchaseOrderNumber": "string",
                "content": "string"
            }
        ]
    },
    "errors": [
        {
            "code": "string",
            "message": "string",
            "details": "string"
        }
    ]
}

🟠400请求有误

🟠403禁止访问

🟠404记录不存在

🟠415415

🟠429429

🔴500服务器错误

🔴503服务器故障