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

返回销售合作伙伴补货计划报价的详细信息。

使用计划：

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

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

请求参数

Body 参数application/json

`listOffers` 操作的请求主体。

pagination

object (ListOffersRequestPagination)

必需

使用这些参数来分页响应。

limit

integer <int64>

必需

响应中返回的最大结果数量。

>= 1<= 100

offset

integer <int64>

必需

检索由 limit 值指定的结果数量的偏移量。第一个结果位于偏移量 0。

>= 0<= 9000

filters

object (ListOffersRequestFilters)

必需

使用这些参数来过滤结果。任何结果都必须符合所有提供的参数。对于任何数组类型的参数，结果必须至少匹配提供的数组中的一个元素。

marketplaceId

string

必需

市场标识符。卖家和供应商支持的市场包括美国、加拿大、西班牙、英国、法国、意大利、印度、德国和日本。仅供应商支持的市场包括巴西、澳大利亚、墨西哥、阿联酋和荷兰。请参阅市场ID 查找市场的标识符。

skus

array[string]

可选

过滤的SKU列表。此过滤器仅支持卖家，不支持供应商。

>= 1 items<= 20 items

asins

array[string]

可选

亚马逊标准识别号码（ASIN）列表。

>= 1 items<= 20 items

eligibilities

array[string]

可选

与优惠相关的资格列表。

>= 1 items

枚举值:

ELIGIBLEINELIGIBLESUSPENDEDREPLENISHMENT_ONLY_ORDERING

preferences

object (Preference)

可选

提供您可以包含在结果过滤条件中的偏好选项。

promotions

object (Promotion)

可选

提供促销以纳入结果筛选标准。

programTypes

array[string]

补货计划类型列表。

必需

>= 1 items

枚举值:

SUBSCRIBE_AND_SAVE

sort

object (ListOffersRequestSort)

可选

使用这些参数对响应进行排序。

order

enum<string>

排序顺序。

必需

枚举值:

ASCDESC

key

enum<string>

必需

用于排序结果的属性。

枚举值:

ASINSELLING_PARTNER_FUNDED_BASE_DISCOUNT_PERCENTAGESELLING_PARTNER_FUNDED_TIERED_DISCOUNT_PERCENTAGEAMAZON_FUNDED_BASE_DISCOUNT_PERCENTAGEAMAZON_FUNDED_TIERED_DISCOUNT_PERCENTAGE

示例

{
    "pagination": {
        "limit": 1,
        "offset": 0
    },
    "filters": {
        "marketplaceId": "string",
        "skus": [
            "string"
        ],
        "asins": [
            "string"
        ],
        "eligibilities": [
            "ELIGIBLE"
        ],
        "preferences": {
            "autoEnrollment": [
                "OPTED_IN"
            ]
        },
        "promotions": {
            "sellingPartnerFundedBaseDiscount": {
                "percentage": [
                    0
                ]
            },
            "sellingPartnerFundedTieredDiscount": {
                "percentage": [
                    0
                ]
            },
            "amazonFundedBaseDiscount": {
                "percentage": [
                    0
                ]
            },
            "amazonFundedTieredDiscount": {
                "percentage": [
                    0
                ]
            }
        },
        "programTypes": [
            "SUBSCRIBE_AND_SAVE"
        ]
    },
    "sort": {
        "order": "ASC",
        "key": "ASIN"
    }
}

示例代码

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

`listOffers` 操作的响应模式。

offers

array[object (ListOffersResponseOffer) {7}]

优惠列表。

可选

sku

string

可选

SKU。此属性仅支持卖家，不支持供应商。

asin

string

可选

亚马逊标准识别号码（ASIN）

marketplaceId

string

可选

eligibility

enum<string>

可选

当前优惠的资格状态。

枚举值:

ELIGIBLEINELIGIBLESUSPENDEDREPLENISHMENT_ONLY_ORDERING

offerProgramConfiguration

object (OfferProgramConfiguration)

可选

优惠方案配置包含一组与优惠相关的方案属性。

programType

enum<string>

补货计划类型。

可选

枚举值:

SUBSCRIBE_AND_SAVE

vendorCodes

array[string]

可选

与该优惠相关的供应商代码列表。

pagination

object (PaginationResponse)

可选

使用这些参数来分页响应。

totalResults

integer <int64>

可选

与给定筛选条件匹配的结果总数。

>= 0

示例

{
    "offers": [
        {
            "marketplaceId": "ATVPDKIKX0DER",
            "offerProgramConfiguration": {
                "preferences": {
                    "autoEnrollment": "OPTED_IN"
                },
                "promotions": {
                    "sellingPartnerFundedBaseDiscount": {
                        "percentage": 5
                    },
                    "sellingPartnerFundedTieredDiscount": {
                        "percentage": 0
                    },
                    "amazonFundedBaseDiscount": {
                        "percentage": 5
                    },
                    "amazonFundedTieredDiscount": {
                        "percentage": 10
                    }
                },
                "enrollmentMethod": "AUTOMATIC"
            },
            "programType": "SUBSCRIBE_AND_SAVE",
            "eligibility": "ELIGIBLE",
            "asin": "B09KR5B7FH",
            "sku": "SKU_OPTED_IN"
        }
    ],
    "pagination": {
        "totalResults": 1
    }
}

🟠400请求有误

🟠401没有权限

🟠403禁止访问

🟠404记录不存在

🟠413413

🟠415415

🟠429429

🔴500服务器错误

🔴503服务器故障