产品费用 v0 用例指南

亚马逊SPAPI

# 什么是产品费用API?

产品费用API检索多个产品的产品费用.您可以使用 "getMyFeesEstimates "操作来获取产品列表和市场的产品费用估算,然后根据这些费用估算来设置价格.您必须通过ASIN或SKU来指定您的产品(而不是UPC、ISBN等).

您必须在每个产品的费用请求中包括一个原始标识符.该标识符包括在费用估算中,以便您可以将费用估算与原始请求联系起来.

此操作允许在一个批次中最多有20个产品请求.

**重要的是:**该API返回的估计费用是不保证的.实际费用可能有所不同.

# Tutorial: 通过ASINs或SKU获取产品费用估算

本教程演示了如何检索一组SKU的产品费用.

# Prerequisites

要成功完成本教程,你必须具备以下条件

-来自你为之调用的销售伙伴的授权.更多信息请参考销售伙伴API开发者指南 (opens new window). -分配给你的开发者档案的定价和产品清单角色.

# 步骤1.调用getMyFeesEstimates操作

1.调用 "getMyFeesEstimate "操作,传递以下参数

主体参数

名称 描述 模式
FeesEstimateRequest 用于请求估计费用的产品、市场和建议价格. 类型FesEstimateRequest
  1. 传递一个最多包含20个FeesEstimateRequest对象的数组.

请求的例子

POST https://sellingpartnerapi-na.amazon.com/products/fees/v0/feesEstimate
[
  {
    "FeesEstimateRequest": {
      "MarketplaceId": "atvpdkikx0der"
      "IsAmazonFulfilled": false,
      "PriceToEstimateFees": {
        "ListingPrice": {
          "CurrencyCode": "USD",
          "金额": 12
        },
        "航运": {
          "CurrencyCode": "USD",
          "金额": 2
        }
      },
      "标识符": "SCSID1"
    },
    "IdType": "SellerSKU",
    "IdValue": "ZZZZZZ"
  }
]
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22

响应

响应属性

名称 说明
GetMyFeesEstimatesResponse 产品列表的估计费用.
类型: 数组

# GetMyFeesEstimateResponse

名称 说明 模式
状态 费用请求的状态. 可能的值成功, ClientError, ServiceError 字符串
FeesEstimateIdentifier 用于识别费用估算请求的信息. FeesEstimateIdentifier

响应的例子:

{
  "状态": "成功"
  "FuesEstimateIdentifier": {
    "MarketplaceId": "atvpdkikx0der",
    "IdType": "ASIN",
    "SellerId": "axxxxxxxxxxxxx",
    "SellerInputIdentifier": "SCSID1",
    "IsAmazonFulfilled": false,
    "IdValue": "asin123"
    "PriceToEstimateFees": {
      "ListingPrice": {
        "CurrencyCode": "USD",
        "金额": 10
      },
      "航运": {
        "CurrencyCode": "USD",
        "金额": 10
      },
      "点数": {
        "积分数": 0,
        "点数货币价值"{
          "CurrencyCode": "USD",
          "金额": 0
        }
      }
    }
  }

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28

# Step 2.调用feesEstimateRequest操作

调用feesEstimateRequest操作,传递以下参数

名称 描述 需要
MarketplaceId 一个市场的标识符.
类型:字符串
IsAmazonFulfilled 当为真时,该报价由亚马逊履行.
类型: 布尔值
PriceToEstimateFees 费用估算所依据的产品价格.
类型PriceToEstimateFees
Identifier 呼叫者提供的唯一标识符,用于跟踪此请求.
类型: string
Yes
IdType FeesEstimateByIdRequest中使用的产品标识符的类型.
类型:枚举(ASIN或卖方SKU)
IdValue 项目标识符.
类型:字符串

# PriceToEstimateFees

名称 说明 需要
ListingPrice 项目的价格.
类型:字符串
Shipping 运费.
类型: 布尔型
No
Points 购买商品时提供的亚马逊积分数量.
类型: 积分
Yes

# FeesEstimateIdentifier

名称 说明 需要
MarketplaceId 一个市场的标识符.
类型:字符串
IsAmazonFulfilled 当为真时,该报价由亚马逊履行.
类型: 布尔值
SellerId 卖家识别码.
类型:字符串
No
SellerInputIdentifier 呼叫者提供的唯一标识符,用于跟踪此请求.
类型: string
No
PriceToEstimateFees 费用估算所基于的产品价格.
类型: PriceToEstimateFees
Identifier 呼叫者提供的唯一标识符,用于跟踪此请求.
类型: string
Yes
IdType FeesEstimateByIdRequest中使用的产品标识符的类型.
类型:枚举(ASIN或卖方SKU)
IdValue 项目标识符.
类型:字符串

# Fees Estimate

名称 描述 需要
TimeOfFeesEstimation 估计费用的时间.这默认为提出申请的时间.
string (date-time)
Yes
TotalFeesEstimate 对于一个给定的项目、价格和履行渠道的估计费用总额.
类型金钱类型
FeeDetailList 构成给定费用的其他费用列表.
类型: FeeDetailList
没有

#

名称 模式 要求
PointsNumber Integer (int32) No
PointsMonetaryValue MoneyType No

# MoneyType

名称 模式 需要
CurrencyCode Integer (int32) No
Amount MoneyType No
Last Updated: 2022/10/20 下午11:58:42