> ## Documentation Index
> Fetch the complete documentation index at: https://apidocs.returnhelper.com/llms.txt
> Use this file to discover all available pages before exploring further.
# 宛先ごとに Resend Shipping Fees を取得
このページはAIによって自動翻訳されています。API技術仕様は英語が正式です。不明点がある場合は[英語版](/api-reference/resend/get-resend-shipping-fees-by-destination)を参照してください。
指定した宛先（国 + 郵便番号）へ発送する 1 つ以上の返品在庫アイテムに対して、利用可能な **Resend**（出庫）サービスタイプとその**料金見積り**を返します。[Resend Order を作成](/ja/api-reference/resend/create-resend-order) を呼び出す前に Resend の料金をプレビューするために使用します。
本エンドポイントは **Resend**（出庫）の配送料金のみを見積ります。**Return**（入庫）の料金プレビューには、代わりに [発送元から Shipping Fees を取得](/ja/api-reference/shipment/get-shipping-fees-from-origin-location) を使用してください。
必須パラメータ
* **`returnInventoryIdList`** — 必須。まとめて再送する返品在庫 ID のカンマ区切りリスト（例：`10023,10024`）。**すべての ID が同一の Warehouse に属している必要があり**、かつ各 ID が存在している必要があります。そうでない場合、リクエストはバリデーションに失敗します。
* **`toCountryCode`** — 必須、**小文字 ISO3**（例：`usa`、`gbr`）。有効な値は [すべての国を取得](/ja/api-reference/country/get-all-countries) を参照してください。
* **`toPostalCode`** — 必須、空にはできません。
* **`limit`** — 任意。返されるサービスタイプ選択肢の数を制限します。省略すると、その宛先で利用可能なすべての選択肢が返されます。
レスポンスの注意
各項目は、利用可能な Resend サービスタイプ 1 件とその料金を表します：
* `serviceTypeCode` / `serviceTypeName` — サービス識別子とその表示名。
* `isEnableAutoCreateLabel` — このサービスで Resend Order を作成したときにラベルが自動生成されるかどうか。
* `postalCodePair` — 料率の算出に用いる `from` / `to` の郵便番号ゾーンのペア。
* `currencyCode` と `fee` — 見積り料金。
* `chargeableWeight` — 運送業者が実際に課金する重量。容積重量の丸めにより、パーセルの実重量を上回る場合があります。
リストが空の場合、その在庫の組み合わせと宛先に対して利用可能な Resend サービスがないことを意味します。料金は見積りであり、確定料金は Resend Order 作成時に適用されます。
* [Resend Order を作成](/ja/api-reference/resend/create-resend-order) — 選択した `serviceTypeCode` を使用します。
* [取得 再送オーダー 詳細](/ja/api-reference/resend/get-resend-order-details) — 作成後に Resend Order を確認します。
* [発送元から Shipping Fees を取得](/ja/api-reference/shipment/get-shipping-fees-from-origin-location) — Return（入庫）料金プレビューの対応エンドポイント。
## OpenAPI
````yaml get /api/Resend/getShippingFeeListByToShippingOption
openapi: 3.1.0
info:
title: Return Helper API
description: API documentation for Return Helper — covering User and Public endpoints.
version: 1.0.0
servers:
- url: https://api.returnshelper.com/uat/user
description: Sandbox — User API
- url: https://api.returnshelper.com/uat/public
description: Sandbox — Public API
- url: https://api.returnhelpercentre.com/v1/user
description: Production — User API
- url: https://api.returnhelpercentre.com/v1/public
description: Production — Public API
- url: https://api.returnhelperchina.com/user
description: Production — User API (China)
security:
- ApiKey: []
ApiToken: []
paths:
/api/Resend/getShippingFeeListByToShippingOption:
get:
tags:
- Resend
summary: Get resend shipping fees by destination
operationId: ReturnUserApi_GetShippingFeeListByToShippingOption
parameters:
- name: returnInventoryIdList
in: query
required: true
schema:
type: string
description: >-
Comma-separated list of return inventory IDs to price the resend
for. All IDs must belong to the same warehouse.
- name: toCountryCode
in: query
required: true
schema:
type: string
description: ISO3 destination country code
- name: toPostalCode
in: query
required: true
schema:
type: string
description: Destination postal code
- name: limit
in: query
required: false
schema:
type: integer
format: int32
minimum: 0
description: Maximum number of service-type fee options to return
responses:
'200':
description: Success
content:
application/json:
schema:
$ref: >-
#/components/schemas/GeneralList_ShipmentShippingFeeDetailReply
'401':
description: >-
Authentication failed. Returned when the `x-rr-apikey` or
`x-rr-apitoken` header is missing or invalid. The body uses the
standard `ApiResponse` envelope with `meta.error.message` describing
the auth failure.
content:
application/json:
schema:
$ref: '#/components/schemas/ApiResponse'
security:
- ApiKey: []
ApiToken: []
servers:
- url: https://api.returnshelper.com/uat/user
description: Sandbox — User API
components:
schemas:
GeneralList_ShipmentShippingFeeDetailReply:
type: object
properties:
data:
type: array
items:
$ref: '#/components/schemas/ShipmentShippingFeeDetailReply'
description: List of available resend service types with their shipping fee
ApiResponse:
type: object
description: >-
Universal response envelope. Successful responses include the business
payload as additional top-level fields alongside `correlationId` and
`meta`. Failed responses (auth errors, validation errors) only populate
`correlationId` and `meta`, with `meta.errorCode` and `meta.error`
describing the failure.
properties:
correlationId:
type:
- string
- 'null'
description: >-
Unique correlation ID for tracing the request through Return Helper
systems.
meta:
$ref: '#/components/schemas/ApiResponseMeta'
ShipmentShippingFeeDetailReply:
type: object
properties:
serviceTypeCode:
type:
- string
- 'null'
serviceTypeName:
type:
- string
- 'null'
isEnableAutoCreateLabel:
type: boolean
postalCodePair:
type: object
description: Postal-code zone pair used to derive the rate
properties:
from:
type:
- string
- 'null'
description: Origin postal-code zone
to:
type:
- string
- 'null'
description: Destination postal-code zone
currencyCode:
type:
- string
- 'null'
fee:
type: number
format: decimal
chargeableWeight:
type: number
format: decimal
ApiResponseMeta:
type: object
description: >-
Application-level metadata for every API response. Inspect `status` and
`errorCode` to detect soft-error responses (validation failures arrive
as HTTP 200 with `meta.status: 400`).
properties:
status:
type: integer
description: >-
Application-level status code. For successful operations this
mirrors the HTTP status (e.g. 200). For validation failures it
reports the logical status (e.g. 400) even though the wire HTTP
status is 200.
data:
type: object
additionalProperties:
type: string
description: Reserved free-form metadata key/value pairs. Usually empty.
errorCode:
type:
- string
- 'null'
description: >-
Machine-readable error code (e.g. `VALIDATION_FAILED`). Non-null
only when the operation failed.
error:
type: object
additionalProperties: true
description: >-
Field-level or message-level error detail keyed by request property
name. Empty object on success.
securitySchemes:
ApiKey:
type: apiKey
in: header
name: x-rr-apikey
description: Your API key
ApiToken:
type: apiKey
in: header
name: x-rr-apitoken
description: Your API token — keep this private
````