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

deliveryOffers

北美(North America）

https://sellingpartnerapi-na.amazon.com

POST

/fba/outbound/2020-07-01/deliveryOffers

Fulfillment Outbound

返回包括估计交货日期和优惠到期的交付选项，基于您指定的标准。

使用计划：

速率（每秒请求）	突发
5	30

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

请求参数

Body 参数application/json

getDeliveryOffers 操作的请求体模式。

product

object (GetDeliveryOffersProduct)

必需

交付优惠的产品详情。

productIdentifier

object (ProductIdentifier)

必需

产品标识符输入，用于定位MCF的产品。

amount

object (Amount)

可选

基于计量单位的数量。

terms

object (GetDeliveryOffersTerms)

必需

交货报价的交货条款。

origin

object (Origin)

交付报价的来源。

必需

destination

object (Destination)

交付报价的目的地。

必需

示例

{
    "product": {
        "productIdentifier": {
            "merchantSku": "string"
        },
        "amount": {
            "unitOfMeasure": "Eaches",
            "value": "string"
        }
    },
    "terms": {
        "origin": {
            "countryCode": "st"
        },
        "destination": {
            "deliveryAddress": {
                "addressLine1": "string",
                "addressLine2": "string",
                "addressLine3": "string",
                "city": "string",
                "districtOrCounty": "string",
                "stateOrRegion": "string",
                "postalCode": "string",
                "countryCode": "st"
            },
            "ipAddress": "string"
        }
    }
}

示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location --request POST 'https://sellingpartnerapi-na.amazon.com/fba/outbound/2020-07-01/deliveryOffers' \
--header 'Content-Type: application/json' \
--data-raw '{
    "product": {
        "productIdentifier": {
            "merchantSku": "string"
        },
        "amount": {
            "unitOfMeasure": "Eaches",
            "value": "string"
        }
    },
    "terms": {
        "origin": {
            "countryCode": "st"
        },
        "destination": {
            "deliveryAddress": {
                "addressLine1": "string",
                "addressLine2": "string",
                "addressLine3": "string",
                "city": "string",
                "districtOrCounty": "string",
                "stateOrRegion": "string",
                "postalCode": "string",
                "countryCode": "st"
            },
            "ipAddress": "string"
        }
    }
}'

返回响应

🟢200成功

application/json

成功。

Headers

x-amzn-RateLimit-Limit

string

可选

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

x-amzn-RequestId

string

可选

唯一请求参考标识符。

Body

getDeliveryOffers 操作的响应模式。

payload

object (GetDeliveryOffersResult)

可选

delivery offers 的列表，包括优惠到期、最早和最晚日期及时间范围，以及配送优惠政策。

deliveryOffers

array[object (DeliveryOffer) {3}]

可选

一系列交付报价信息。

errors

array[object (Error) {3}]

可选

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

code

string

必需

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

message

string

必需

描述错误状态的消息。

details

string

可选

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

示例

{
    "payload": {
        "deliveryOffers": [
            {
                "expiresAt": "2019-08-24T14:15:22Z",
                "dateRange": {
                    "earliest": "2019-08-24T14:15:22Z",
                    "latest": "2019-08-24T14:15:22Z"
                },
                "policy": {
                    "message": {
                        "text": "string",
                        "locale": "string"
                    }
                }
            }
        ]
    },
    "errors": [
        {
            "code": "string",
            "message": "string",
            "details": "string"
        }
    ]
}

🟠400请求有误

🟠401没有权限

🟠403禁止访问

🟠404记录不存在

🟠429429

🔴500服务器错误

🔴503服务器故障

getFulfillmentPreview

listAllFulfillmentOrders