getOrderPreview

北美(North America）

https://sellingpartnerapi-na.amazon.com

POST

/fulfillment/outbound/2026-07-04/previews

根据您指定的配送条件，检索履行订单预览列表。

用量计划：

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

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

请求参数

Header 参数

Body 参数application/json必填

示例

{
    "channel": "SHOPIFY",
    "fulfillmentConfiguration": {
        "serviceLevel": {
            "serviceTiers": [
                "STANDARD"
            ]
        },
        "services": {
            "packaging": {
                "packagingOption": "UNBRANDED"
            },
            "additional": {}
        }
    },
    "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": [
        {
            "product": {
                "productIdentifier": {
                    "amazonSku": "someSku"
                },
                "perUnitDeclaredValue": {
                    "currencyCode": "USD",
                    "amount": "3.00"
                }
            },
            "amount": {
                "unit": "EACHES",
                "value": "1.0"
            }
        }
    ],
    "excludeEstimatedFees": true
}

请求示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location 'https://sellingpartnerapi-na.amazon.com/fulfillment/outbound/2026-07-04/previews' \
--header 'x-amzn-fulfillment-service-id: FS01-o8vlfw8b1tiu1' \
--header 'Content-Type: application/json' \
--data-raw '{
    "channel": "SHOPIFY",
    "fulfillmentConfiguration": {
        "serviceLevel": {
            "serviceTiers": [
                "STANDARD"
            ]
        },
        "services": {
            "packaging": {
                "packagingOption": "UNBRANDED"
            },
            "additional": {}
        }
    },
    "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": [
        {
            "product": {
                "productIdentifier": {
                    "amazonSku": "someSku"
                },
                "perUnitDeclaredValue": {
                    "currencyCode": "USD",
                    "amount": "3.00"
                }
            },
            "amount": {
                "unit": "EACHES",
                "value": "1.0"
            }
        }
    ],
    "excludeEstimatedFees": true
}'

返回响应

🟢200成功

application/json

成功。

Headers

Bodyapplication/json

示例

{
    "plannedShipments": [
        {
            "estimatedShippingWeight": {
                "unit": "KG",
                "value": "2.0"
            },
            "items": [
                {
                    "productIdentifier": {
                        "amazonSku": "someSku"
                    },
                    "amount": {
                        "unit": "EACHES",
                        "value": "1.0"
                    }
                }
            ],
            "offers": [
                {
                    "fulfillmentConfiguration": {
                        "serviceLevel": {
                            "serviceTier": "STANDARD",
                            "deliveryInterval": {
                                "startTime": "2025-04-21T12:34:56Z",
                                "endTime": "2025-04-22T12:34:56Z"
                            },
                            "shipInterval": {
                                "startTime": "2025-04-21T10:00:00Z",
                                "endTime": "2025-04-21T14:00:00Z"
                            }
                        },
                        "services": {
                            "packaging": {
                                "packagingOption": "UNBRANDED"
                            },
                            "delivery": {
                                "paymentOnDelivery": "ENABLED"
                            },
                            "additional": {}
                        }
                    },
                    "estimatedPrice": {
                        "rollupPrices": [
                            {
                                "type": "MCFTransportationFee",
                                "value": {
                                    "currencyCode": "USD",
                                    "amount": "4.25"
                                }
                            }
                        ],
                        "totalPrice": {
                            "currencyCode": "USD",
                            "amount": "4.25"
                        }
                    }
                }
            ]
        }
    ],
    "constraints": [
        {
            "message": "There is not enough quantity of item xyz.",
            "type": "ValidationError",
            "code": "ItemQuantityNotAvailable",
            "details": [
                {
                    "type": "someType",
                    "value": "someValue"
                }
            ]
        }
    ]
}

🟠400请求有误

🟠401没有权限

🟠403禁止访问

🟠404记录不存在

🟠413

🟠415

🟠429

🔴500服务器错误

🔴503服务器故障

修改于 2026-08-27 14:14:01

setPrepDetails

getOffers