listOrders

检索与您指定条件相匹配的履行订单列表。

用量计划：

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

x-amzn-RateLimit-Limit 响应头会在可用时返回应用于所请求操作的用量计划速率限制。上表列出了此操作的默认速率和突发值。业务需求较高、需要更高吞吐量的销售合作伙伴，其速率和突发值可能高于此处显示的值。有关更多信息，请参阅销售合作伙伴API中的用量计划和速率限制。

请求示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

返回响应

🟢200成功

application/json

成功。

Headers

Bodyapplication/json

示例

{
    "orders": [
        {
            "orderId": "ABC123XYZ",
            "channel": "SHOPIFY",
            "receiveTime": "2025-04-21T10:30:00Z",
            "status": "PROCESSING",
            "statusUpdateTime": "2025-04-21T11:45:00Z",
            "fulfillmentConfiguration": {
                "serviceLevel": {
                    "serviceTiers": [
                        "STANDARD"
                    ]
                },
                "action": "HOLD",
                "services": {
                    "packaging": {
                        "packingSlip": {
                            "templateName": "templateName",
                            "templateAttributes": {
                                "orderId": "MyOrder-123",
                                "orderTime": "2026-07-01T10:00:00Z",
                                "orderText": "Thank you for your purchase!"
                            }
                        }
                    }
                }
            },
            "origin": {
                "countryCode": "US"
            },
            "destination": {
                "deliveryAddress": {
                    "name": "Shopper Name",
                    "addressLine1": "1000 Winthrop Ave N",
                    "city": "Seattle",
                    "countryCode": "US",
                    "postalCode": "98103",
                    "stateOrRegion": "WA",
                    "phone": "123-456-7890",
                    "email": "shopper@email.com"
                }
            },
            "lineItems": [
                {
                    "lineItemId": "someLineItemId",
                    "product": {
                        "productIdentifier": {
                            "amazonSku": "BOOK-123-HC"
                        },
                        "perUnitDeclaredValue": {
                            "currencyCode": "USD",
                            "amount": "14.99"
                        }
                    },
                    "amount": {
                        "unit": "EACHES",
                        "value": "1.0"
                    },
                    "fulfillmentConfiguration": {
                        "services": {
                            "packaging": {
                                "packingSlip": {
                                    "templateName": "templateName",
                                    "templateAttributes": {
                                        "giftMessage": "Happy Birthday!",
                                        "lineItemText": "Item 1 of 2"
                                    }
                                }
                            },
                            "delivery": {
                                "paymentOnDelivery": {
                                    "perUnitServicePrice": {
                                        "currencyCode": "USD",
                                        "amount": "14.99"
                                    }
                                }
                            }
                        }
                    }
                }
            ]
        },
        {
            "orderId": "DEF456UVW",
            "channel": "SHOPIFY",
            "receiveTime": "2025-04-20T15:30:00Z",
            "status": "COMPLETE",
            "statusUpdateTime": "2025-04-20T18:45:00Z",
            "fulfillmentConfiguration": {
                "serviceLevel": {
                    "serviceTiers": [
                        "EXPEDITED"
                    ]
                },
                "action": "SHIP",
                "services": {
                    "packaging": {
                        "packingSlip": {
                            "templateName": "templateName",
                            "templateAttributes": {
                                "orderId": "MyOrder-123",
                                "orderTime": "2026-07-01T10:00:00Z",
                                "orderText": "Thank you for your purchase!"
                            }
                        }
                    }
                }
            },
            "origin": {
                "countryCode": "US"
            },
            "destination": {
                "deliveryAddress": {
                    "name": "Another Shopper",
                    "addressLine1": "500 Pine Street",
                    "city": "San Francisco",
                    "countryCode": "US",
                    "postalCode": "94103",
                    "stateOrRegion": "CA",
                    "phone": "987-654-3210"
                }
            },
            "lineItems": [
                {
                    "lineItemId": "anotherLineItemId",
                    "product": {
                        "productIdentifier": {
                            "amazonSku": "BOOK-123-HC"
                        },
                        "perUnitDeclaredValue": {
                            "currencyCode": "USD",
                            "amount": "14.99"
                        }
                    },
                    "amount": {
                        "unit": "EACHES",
                        "value": "2.0"
                    },
                    "cancelledAmount": {
                        "unit": "EACHES",
                        "value": "0.0"
                    },
                    "unfulfillableAmount": {
                        "unit": "EACHES",
                        "value": "0.0"
                    },
                    "fulfillmentConfiguration": {
                        "services": {
                            "packaging": {
                                "packingSlip": {
                                    "templateName": "templateName",
                                    "templateAttributes": {
                                        "giftMessage": "Happy Birthday!",
                                        "lineItemText": "Item 1 of 2"
                                    }
                                }
                            },
                            "delivery": {
                                "paymentOnDelivery": {
                                    "perUnitServicePrice": {
                                        "currencyCode": "USD",
                                        "amount": "14.99"
                                    }
                                }
                            }
                        }
                    }
                }
            ]
        }
    ],
    "pagination": {
        "nextToken": "token123"
    }
}

🟠400请求有误

🟠401没有权限

🟠403禁止访问

🟠404记录不存在

🟠413

🟠415

🟠429

🔴500服务器错误

🔴503服务器故障

请求参数

请求示例代码

返回响应