> ## 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. # FBA Shipment を作成 このページはAIによって自動翻訳されています。API技術仕様は英語が正式です。不明点がある場合は[英語版](/api-reference/fbashipment/create-fba-shipment)を参照してください。 1 件以上の受入 FBA シップメントを登録します——つまり Return Helper に「Amazon がこの追跡番号で Removal Order をこの倉庫宛に発送したので、到着を待ってほしい」と伝えます。これはメタデータ登録のみで、ラベルを発行したり物理アクションを起こしたりはしません。倉庫がパーセル到着時に Removal Order と紐付けられるようにするためのものです。 ## 呼び出すタイミング * Amazon Seller Central（または SP-API）で Removal Order を作成した後、Amazon が割り当てたキャリアの追跡番号を取得した時点で。 * Removal Order 内の各シップメントごとに——Amazon は単一の Removal Order を異なる追跡番号の複数パーセルに分割することがしばしばあります。追跡番号 1 つにつき FBA シップメント 1 件を作成してください。 ## 必須フィールド `createFbaShipmentPayloadList` 内の各エントリ： * **`trackingNumber`** — 非空、単一行、認識される追跡番号フォーマットに一致する必要があります。**グローバルに一意** — 期限切れでない FBA シップメント レコードで使われている追跡番号は再利用できません。 * **`removalOrderId`** — Amazon の Removal Order ID（例：`WS-1234567`）。単一行で有効なフォーマット。 * **`warehouseId`** — FBA パーセルが届く倉庫。アカウントが認可されている倉庫である必要があります。[ユーザーがアクセスできるすべての倉庫を取得](/ja/api-reference/warehouse/get-all-warehouses-accessible-to-user) で取得してください。 ## ペイロード横断ルール * **同一バッチ内で `trackingNumber` の重複は不可。** * **同一 `removalOrderId` はバッチ内で常に同じ `warehouseId` にマッピングされる必要があります** — 同じ呼び出しで「Removal Order WS-1 → 倉庫 5」と「Removal Order WS-1 → 倉庫 7」と矛盾させることはできません。 ## 副作用 * ペイロードごとに `FbaShipment` レコードが作成され、追跡番号、Removal Order、宛先倉庫が紐付けられます。 * パーセルが物理的に到着すると、倉庫はこれらのレコードを照合して `fbaShipmentArrived` webhook をトリガーします。 * ラベルは生成されません——発送するのは Amazon であり、あなたではありません。 ## 関連 * [FBA シップメント詳細を取得](/ja/api-reference/fbashipment/get-fba-shipment-details) — webhook がキャッシュされていない `fbaShipmentId` を参照した場合に、ID で 1 件取得。 * [FBA 指示を作成](/ja/api-reference/fbainstruction/create-fba-instructions) — パーセルが到着したら（webhook で通知）、倉庫に在庫の取り扱い（廃棄・リコール・補充など）を指示します。 * [Webhooks](/ja/webhooks) — FBA シップメントのライフサイクル（到着、指示完了など）はすべて webhook 経由で配信されます。 ## OpenAPI ````yaml post /api/Fba/FbaShipment/create 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/Fba/FbaShipment/create: post: tags: - FbaShipment summary: Create FBA shipment operationId: ReturnUserApi_FbaShipment_Create requestBody: required: true content: application/json: schema: $ref: '#/components/schemas/UserCreateFbaShipmentRequest' responses: '200': description: Success content: application/json: schema: $ref: '#/components/schemas/GeneralList_UserCreateFbaShipmentReply' '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: UserCreateFbaShipmentRequest: type: object properties: createFbaShipmentPayloadList: type: array items: $ref: '#/components/schemas/CreateFbaShipmentPayload' description: List of FBA shipment creation payloads required: - createFbaShipmentPayloadList GeneralList_UserCreateFbaShipmentReply: type: object properties: data: type: array items: $ref: '#/components/schemas/UserCreateFbaShipmentReply' description: List of created FBA shipments 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' CreateFbaShipmentPayload: type: object properties: removalOrderId: type: string description: Amazon removal order ID trackingNumber: type: string description: Shipment tracking number (converted to uppercase) warehouseId: type: integer description: Warehouse where the FBA shipment will be received required: - trackingNumber - warehouseId UserCreateFbaShipmentReply: type: object properties: fbaShipmentId: type: string format: uuid apiId: type: integer format: int32 warehouseId: type: integer format: int32 fbaShipmentStatusCode: type: - string - 'null' removalOrderId: type: - string - 'null' trackingNumber: type: - string - 'null' arrivalOn: type: - string - 'null' format: date-time createOn: type: string format: date-time 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 ````