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

返回指定卖家SKU在请求正文中指定的市场中标识的商品的估计费用。

注意： 与此操作相关的参数可能包含需要进行URL编码的特殊字符以调用API。为避免在编码URL时出现SKU错误，请参考URL编码。

您可以代表销售合作伙伴在销售合作伙伴设定商品价格之前调用getMyFeesEstimateForSKU来获取商品的费用估算。然后，销售合作伙伴可以将任何估算费用考虑在内。每个费用估算请求必须包含一个原始标识符。此标识符包含在费用估算中，以便您可以将费用估算与原始请求相关联。

注意： 该标识符值用于识别估算。实际费用可能有所不同。在卖家中心搜索“费用”，并咨询特定商店的费用时间表以获取最新信息。

注意： 当卖家使用带有其SellerSKU的getMyFeesEstimateForSKU操作时，他们会得到基于实际商品测量的准确费用，但仅在将商品发送到亚马逊之后。

使用计划：

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

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

请求参数

Path 参数

SellerSKU

string

必需

用于识别指定市场中的商品。SellerSKU 通过卖家的 SellerId 进行确认，该 SellerId 包含在您提交的每个操作中。

Body 参数application/json

请求模式。

FeesEstimateRequest

object (FeesEstimateRequest)

可选

一个用于请求估算费用的产品、市场和建议价格。

MarketplaceId

string

市场标识符。

必需

IsAmazonFulfilled

boolean

可选

当为真时，优惠由亚马逊履行。

PriceToEstimateFees

object (PriceToEstimateFees)

必需

用于估算费用的物品价格信息。

Identifier

string

必需

由呼叫者提供的唯一标识符，用于跟踪此请求。

OptionalFulfillmentProgram

enum<string>

可选

一个可选的注册程序，在亚马逊履行订单时退还预计费用（IsAmazonFulfilled 设置为 true）。

枚举值:

FBA_COREFBA_SNLFBA_EFN

示例

{
    "FeesEstimateRequest": {
        "MarketplaceId": "string",
        "IsAmazonFulfilled": true,
        "PriceToEstimateFees": {
            "ListingPrice": {
                "CurrencyCode": "string",
                "Amount": 0
            },
            "Shipping": {
                "CurrencyCode": "string",
                "Amount": 0
            },
            "Points": {
                "PointsNumber": 0,
                "PointsMonetaryValue": {
                    "CurrencyCode": "string",
                    "Amount": 0
                }
            }
        },
        "Identifier": "string",
        "OptionalFulfillmentProgram": "FBA_CORE"
    }
}

示例代码

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

payload

object (GetMyFeesEstimateResult)

响应模式。

可选

FeesEstimateResult

object (FeesEstimateResult)

可选

物品标识符及该物品的预计费用。

errors

array[object (Error) {3}]

可选

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

code

string

必需

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

message

string

必需

描述错误状态的消息。

details

string

可选

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

示例

{
    "payload": {
        "FeesEstimateResult": {
            "Status": "string",
            "FeesEstimateIdentifier": {
                "MarketplaceId": "string",
                "SellerId": "string",
                "IdType": "ASIN",
                "IdValue": "string",
                "IsAmazonFulfilled": true,
                "PriceToEstimateFees": {
                    "ListingPrice": {
                        "CurrencyCode": "string",
                        "Amount": 0
                    },
                    "Shipping": {
                        "CurrencyCode": "string",
                        "Amount": 0
                    },
                    "Points": {
                        "PointsNumber": 0,
                        "PointsMonetaryValue": {
                            "CurrencyCode": "string",
                            "Amount": 0
                        }
                    }
                },
                "SellerInputIdentifier": "string",
                "OptionalFulfillmentProgram": "FBA_CORE"
            },
            "FeesEstimate": {
                "TimeOfFeesEstimation": "2019-08-24T14:15:22Z",
                "TotalFeesEstimate": {
                    "CurrencyCode": "string",
                    "Amount": 0
                },
                "FeeDetailList": [
                    {
                        "FeeType": "string",
                        "FeeAmount": {
                            "CurrencyCode": "string",
                            "Amount": 0
                        },
                        "FeePromotion": {
                            "CurrencyCode": "string",
                            "Amount": 0
                        },
                        "TaxAmount": {
                            "CurrencyCode": "string",
                            "Amount": 0
                        },
                        "FinalFee": {
                            "CurrencyCode": "string",
                            "Amount": 0
                        },
                        "IncludedFeeDetailList": [
                            {
                                "FeeType": "string",
                                "FeeAmount": {
                                    "CurrencyCode": "string",
                                    "Amount": 0
                                },
                                "FeePromotion": {
                                    "CurrencyCode": "string",
                                    "Amount": 0
                                },
                                "TaxAmount": {
                                    "CurrencyCode": "string",
                                    "Amount": 0
                                },
                                "FinalFee": {
                                    "CurrencyCode": "string",
                                    "Amount": 0
                                }
                            }
                        ]
                    }
                ]
            },
            "Error": {
                "Type": "string",
                "Code": "string",
                "Message": "string",
                "Detail": [
                    {}
                ]
            }
        }
    },
    "errors": [
        {
            "code": "string",
            "message": "string",
            "details": "string"
        }
    ]
}

🟠400请求有误

🟠401没有权限

🟠403禁止访问

🟠404记录不存在

🟠429429

🔴500服务器错误

🔴503服务器故障