跳转到主要内容
GET
/
api
/
Shipment
/
getShippingFeeListByFromShippingOption
Get shipping fees from origin location
curl --request GET \
  --url https://api.returnshelper.com/uat/user/api/Shipment/getShippingFeeListByFromShippingOption \
  --header 'x-rr-apikey: <api-key>' \
  --header 'x-rr-apitoken: <api-key>'
{
  "data": {
    "shippingFeeDetailList": [
      {}
    ]
  }
}
此页面由 AI 自动翻译。API 技术规格以英文呈现为标准。如有任何疑问，请参阅英文版本。
针对指定的起始位置（国家 + 邮编）与包裹尺寸／重量，返回可用的 Return Service Types 并附带费用估算。可作为其他 /api/ServiceType/* 查询的「含费用」对应，在 创建 Return Shipment 之前预览费用。预览阶段不保证最终费率，但相同输入通常会在创建 Shipment 时产生相同费用。 此端点公开的是 Return 目录加上费用。Resend 出库服务不适用此端点 — 请从 获取 Warehouse 可用的 Shipment Service Types 开始。Resend 费用在创建订单时决定，无法通过本端点预览。

​
何时调用

  • 为已知尺寸与重量的包裹挑选最便宜的退货价格。
  • 集成测试时，确认账户在指定国家下已开通的退件服务。

​
必要参数

  • fromCountryCode — 必填，小写 ISO3（例如 usa、gbr）。可用值见 获取所有起始国家。
  • fromPostalCode — 必填，非空。
  • weight、dimension1、dimension2、dimension3 — 全部必填且必须 > 0。
  • limit — 选填，上限 50。省略时不限制（响应会受可用服务数量限制）。

​
响应说明

  • 每条记录包含 serviceTypeCode、serviceType（显示名称）、warehouseId（接收退件的 Warehouse）、currencyCode 与 fee。
  • 列表会过滤为该起始位置下您账户已授权的退件服务。空响应表示该起始位置下没有符合该尺寸／重量的服务。
  • chargeableWeight 是承运商实际计费的重量，可能因体积重量进位而高于实际 weight。

授权

​
x-rr-apikey
string
header
必填

Your API key

​
x-rr-apitoken
string
header
必填

Your API token — keep this private

查询参数

​
fromCountryCode
string
必填

ISO3 origin country code

​
fromPostalCode
string
必填

Origin postal code

​
weight
number<decimal>
必填

Parcel weight

​
dimension1
number<decimal>
必填

Length (longest dimension)

​
dimension2
number<decimal>
必填

Width (second longest dimension)

​
dimension3
number<decimal>
必填

Height (shortest dimension)

​
limit
integer<int32>

Maximum number of results

必填范围: 0 <= x <= 50

响应

Success

​
data
object

Shipping fee summary