> ## 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.
# 用語集
> Return Helper のビジネス用語と、それに対応する API オブジェクト、Webhook イベント、エンドポイント。
このページはAIによって自動翻訳されています。不明点や相違がある場合は、英語版を正式版として参照してください。
非エンジニアの読者（プロジェクトマネージャー、オペレーション、カスタマーサクセス）向けの簡潔なリファレンスで、「倉庫での呼び方」と「API・Webhook での呼び方」を橋渡しします。項目はライフサイクルの段階別にグルーピングしてあります。各用語について、1 行の定義、対応する API オブジェクトまたは Webhook イベント、最も関連性の高いエンドポイントまたはページへのリンクを示します。
ドメイン用語は有用な箇所では実際のワイヤフォーマット（例：`returnInventoryId`、`labelGenerated`）でコードスパンに記載しています。本用語集で挙げる Webhook イベント名や schema フィールド名は、API が実際に発行・受理する名称と完全に一致します。
## 倉庫到着前
### Return Shipment
API で作成する到着前オブジェクトで、ある荷物が Return Helper の倉庫に向かっていることを宣言します。service type、出荷元住所、parcel の寸法、items リスト、申告総額を保持します。`shipmentId` で識別されます。
* **作成**：[Create Return Shipment](/ja/api-reference/returnshipment/create-return-shipment)
* **リスト（履歴バックフィル用）**：[List Shipments](/ja/api-reference/shipment/list-shipments-with-pagination)
* **Schema**：`CreateReturnShipmentRequest`
### Label
Return Shipment に対して生成される配送ラベル。生成は**非同期**です — 配送作成 API 呼び出しはラベル要求をキューに積み、`labelRequestStatusCode: queued` を返します。実際のラベル URL は後で Webhook 経由で届きます。
* **Webhook**：[Label result](/ja/webhooks#label-result)（`category: labelGenerated` / `action: labelGenerated`）
* **主なフィールド**：`labelUrl`、`trackingNumber`、`shipmentId`（突合には必ず `shipmentId` を使い、`labelId` は使わないでください）
### RMA（Return Merchandise Authorization）
荷物が到着した時点で倉庫が割り当てるグローバル一意な識別子。tracking number はキャリア間または同一キャリア内で衝突しうるうえ、VAS によって 1 つの荷物が複数の RMA に分割されることもあるため、Return Helper は tracking number ではなく RMA を主要な連絡識別子としています。
* **フォーマット**：`<倉庫プレフィックス>-<倉庫 ID>--<環境文字><連番>-<チェック桁>`（分割荷物には 2 桁の分割連番が追加）
* **Webhook**：[RMA updated](/ja/webhooks#rma-updated)（`category: notifyUserRmaSwapped`）
* **詳細**：[Getting Started → RMA](/ja/getting-started#rma-return-merchandise-authorization)
### Custom Field Map
Return Shipment に付与できる任意のキー・バリュー metadata。Return Helper はそのまま保持し、関連する Webhook イベントで返却します。1 つの return につき最大 24 件。
* **フィールド**：Return Shipment、parcel item、複数の Webhook payload 上の `customFieldMap`
## 倉庫到着
### Return Inventory
荷物が受領・処理された後に倉庫が作成する到着後オブジェクト。`returnInventoryId` で識別されます。1 件の Return Shipment が複数の Return Inventory レコードを生むことがあります（荷物単位または line item 単位、状況による）。
* **取得**：[Get Return Inventory Details](/ja/api-reference/returninventory/get-return-inventory-details)
* **リスト（履歴バックフィル用）**：[List Return Inventories](/ja/api-reference/returninventory/list-return-inventories-with-pagination)
* **Webhook**：[Inventory created](/ja/webhooks#inventory-created)（`category: newInventoryCreated`）
### Unknown Shipment
セラーが作成した Return Shipment と紐付かない状態で倉庫に到着し、後にあるセラーのものと識別された荷物。割当が完了すると Return Inventory としてアカウントに流れ込みます。
* **Webhook**：[Unknown shipment assigned](/ja/webhooks#unknown-shipment-assigned)（`category: rsl` / `action: assignUnknown`）
* **Payload に含まれるもの**：`returnInventoryId`、`shipmentId`、`returnRequestId`、および割当前に撮影された在庫画像
### Inventory Image
倉庫で撮影された、荷物の内容と状態を示す写真。倉庫が画像を追加・差替え・削除するたびに、URL リストが Webhook で配信されます。
* **Webhook**：[Image updated](/ja/webhooks#image-updated)（`category: rrli` / `action: changeLineItemImage`）
### Warehouse Arrival Event
倉庫が荷物を受領済みとしてマークした瞬間。Webhook で配信され、これが「荷物が到着した」ことを示す正式なシグナルです。
* **Webhook**：[Warehouse shipment arrived (v2)](/ja/webhooks#warehouse-shipment-arrived-v2)（`category: rsl` / `action: markShipmentArrive`）
## 到着後の処理
### Handling Instruction
到着後の Return Inventory をどう扱うか倉庫に伝える指示。利用可能な handling type は Dispose、On-hold、Resend、Recall、VAS（以下定義）。
* **更新**：[Update Return Inventory Handling](/ja/api-reference/returninventory/update-return-inventory-handling)
* **キャンセル**：[Cancel Return Inventory Handling](/ja/api-reference/returninventory/cancel-return-inventory-handling)
* **Webhook**：[Inventory handling complete](/ja/webhooks#inventory-handling-complete)（`category: rinv` / `action: completeInventoryHandling`）
### Dispose
倉庫が在庫を破棄／廃棄します。標準の handling instruction で dispose handling code を指定して発行します。
### On-hold
倉庫が在庫を一時的に保管し、処理を進めません。判断に時間が必要なときに使用します。標準の handling instruction で on-hold handling code を指定して発行します。
### Resend
倉庫が在庫を新しい宛先（通常は別の購入者）に再発送します。1 つ以上の `returnInventoryId` を参照する独立したオブジェクトとして作成されます。
* **作成**：[Create Resend Order](/ja/api-reference/resend/create-resend-order)
* **キャンセル**：[Cancel Resend Order](/ja/api-reference/resend/cancel-resend-order)
* **Webhook**：[Resend status update](/ja/webhooks#resend-status-update)（`category: resend` / `action: updateResendStatus`）
### Recall
倉庫が在庫を Return Helper の香港集約倉庫に送り、集中処理します。1 回の呼び出しで最大 100 件の `returnInventoryId` を指定できます。指定の宛先に在庫を一括で送りたい場合は、代わりに [Consolidate Shipping Order](#consolidate-shipping-order) を使用してください。
* **作成**：[Create Recall by Return Inventory IDs](/ja/api-reference/recall/create-recall-by-return-inventory-ids)
* **Webhook**：[Recall status update](/ja/webhooks#recall-status-update)（`category: recall` / `action: recallUpdateStatus`）
### VAS（Value-Added Services）
倉庫が在庫に対して行う一連の作業群 — 例えば 1 件の在庫を複数のアイテムに分割する、再梱包する、商品検品を行うなど。VAS が在庫を分割した場合、分割後の各ピースはそれぞれ自分の RMA を持ちます。
* **作成**：[Create VAS by Return Inventory ID](/ja/api-reference/vas/create-vas-by-return-inventory-id)
* **Webhook（完了）**：[VAS update](/ja/webhooks#vas-update)（`category: rrliv` / `action: vasUpdated`）
* **Webhook（分割）**：[Split line item](/ja/webhooks#split-line-item)（`category: lineItemVasReturnInventoryLineItem` / `action: splitLineItem`）
## FBA（Fulfilled by Amazon）
### FBA Shipment
FBA 対応商品の後続処理（restock、replenish、recall、dispose 等）のために Return Helper 倉庫へ送る配送。`fbaShipmentId` で識別されます。
* **作成**：[Create FBA Shipment](/ja/api-reference/fbashipment/create-fba-shipment)
* **リスト（履歴バックフィル用）**：[List FBA Shipments](/ja/api-reference/fbashipment/list-fba-shipments-with-pagination)
### FBA Instruction
倉庫にある FBA 在庫に対する指示 — restock、replenish、recall、dispose、または "others"。`returnInventoryId` ではなく FNSKU + 数量で発行します。
* **作成**：[Create FBA Instructions](/ja/api-reference/fbainstruction/create-fba-instructions)
* **リスト（履歴バックフィル用）**：[List FBA Instructions](/ja/api-reference/fbainstruction/list-fba-instructions-with-pagination)
### FNSKU
Amazon の商品別 fulfillment SKU。FBA 在庫を扱うあらゆる場所で `returnInventoryId` の代わりに使用します。
* **現在の在庫数を照会**：[Get FBA Warehouse Inventory List by FNSKU](/ja/api-reference/fbawarehouseinventory/get-fba-warehouse-inventory-list-by-fnsku)
## Consolidate Shipping
### Consolidate Shipping Order
複数の Return Inventory レコードをまとめて 1 セットの外向け荷物として発送する集約配送。在庫をセラーへ送り返す際の配送コスト削減に使います。
* **作成**：[Create Consolidate Shipping Order](/ja/api-reference/consolidateshippingorder/create-consolidate-shipping-order)
* **確定**：[Confirm Consolidate Shipping Order](/ja/api-reference/consolidateshippingorder/confirm-consolidate-shipping-order)
* **Webhook（コスト）**：[Consolidate shipping cost updated](/ja/webhooks#consolidate-shipping-cost-updated)
* **Webhook（完了）**：[Consolidate order completed](/ja/webhooks#consolidate-order-completed)
## 認証と連携基盤
### API Key と API Token
サーバーが認証を要する各リクエストで `x-rr-apikey` および `x-rr-apitoken` ヘッダーとして送信する 2 つの認証情報。User Portal の **Settings → Signing Key and API Token** で発行されます。
* **詳細**：[Introduction → Authentication](/ja/introduction#authentication)
### Signing Key
Return Helper が Webhook リクエストの署名に使用する Base64 エンコードされた共有秘密鍵。受信側はこれを使って生 body に対して `returnhelper-signature` ヘッダーを検証します。User Portal で API key と同じ画面で発行されます。
* **詳細**：[Webhooks → Signature Verification](/ja/webhooks#signature-verification)
### Webhook / Notification
Return Helper が非同期イベント（ラベル結果、倉庫イベント、handling 完了など）をお客様のサーバーへ配信する仕組み。署名付き body の HTTPS POST として配信されます。Webhook が標準のデータ交換チャネルで、list エンドポイントは一度限りのバックフィル用です。
* **詳細**：[Webhooks](/ja/webhooks)
### Idempotency Key
状態を変更する各リクエストに対して生成する一意の値で、`x-returnhelper-idempotency-key` ヘッダーで送信します。Return Helper は同一 key のリトライを重複排除し、ネットワークリトライによる重複した shipment / resend / recall / VAS / FBA shipment の発生を防ぎます。
* **詳細**：[Introduction → Idempotency](/ja/introduction#idempotency)
### `correlationId`
API レスポンスの envelope ごとに返るリクエスト識別子。お客様側でログに残してください。Return Helper のサポートが特定のリクエストを追跡する際に使用します。
* **詳細**：[Introduction → Error Handling](/ja/introduction#error-handling)
### `notificationId`
Webhook イベントごとの一意な識別子。Webhook 受信側でこれを冪等 key として使用し、再配信されたイベントを重複排除してください。
* **詳細**：[Webhooks → Event Delivery](/ja/webhooks#event-delivery)