フルフィルメント API（Fulfillment API）

Fulfillment API を使用すると、チェックアウト時に指定された支払い方法とタイミングに従って、販売者に代わって各注文の梱包、宛先指定、処理、発送のプロセスを完了できます。注文の取得・管理、配送フルフィルメントの作成、払い戻しの発行、支払い紛争の管理をサポートします。

重要: EU/UK の販売者に対する issueRefund 呼び出しにはデジタル署名による追加のセキュリティ検証が必要です。

バージョン: v1.20.7

ベースURL: https://api.ebay.com/sell/fulfillment/v1

認証（OAuth スコープ）

この API は 認可コード（Authorization Code） フローを使用します。

リソース一覧

Fulfillment API は以下の 3 リソース、合計 15 エンドポイント（7 GET + 7 POST + 1 GET）で構成されています。

order — 注文管理（6 エンドポイント）

GET /order

getOrders — 作成日、最終変更日、フルフィルメントステータスに基づいて注文を検索・取得します。最大 2 年前まで取得可能。デフォルトでは過去 90 日以内の注文を返します。

レスポンス: 200 / 400 / 500

GET /order/{orderId}

getOrder — 指定された注文 ID の詳細を取得します。キャンセルリクエスト情報を含みます。

レスポンス: 200 / 400 / 404 / 500

GET /order/{orderId}/shipping_fulfillment

getShippingFulfillments — 指定された注文のすべての配送フルフィルメントを取得します。

レスポンス: 200 / 400 / 500

POST /order/{orderId}/shipping_fulfillment

createShippingFulfillment — パッケージの配送フルフィルメントを作成します。パッケージごとに 1 回呼び出します。

レスポンス: 201 / 400 / 409 / 500

GET /order/{orderId}/shipping_fulfillment/{fulfillmentId}

getShippingFulfillment — 特定の配送フルフィルメントの詳細を取得します。

レスポンス: 200 / 400 / 404 / 500

POST /order/{order_id}/issue_refund

issueRefund — 購入者に全額または一部の払い戻しを発行します。注文レベルまたは明細レベルで可能。非同期処理のため、後続の getOrder でステータスを確認してください。

レスポンス: 200 / 400 / 403 / 404 / 409 / 500

payment_dispute — 支払い紛争管理（8 エンドポイント）

GET /payment_dispute/{payment_dispute_id}

getPaymentDispute — 支払い紛争の詳細情報（ステータス、金額、理由、関連注文、対応オプション、結果、証拠）を取得します。

レスポンス: 200 / 400 / 404 / 500

POST /payment_dispute/{payment_dispute_id}/accept

acceptPaymentDispute — 支払い紛争を承認します。revision フィールド必須。返品が必要な場合は returnAddress を指定。

レスポンス: 204 / 400 / 404 / 409 / 500

GET /payment_dispute/{payment_dispute_id}/activity

getActivities — 支払い紛争のアクティビティログ（作成から解決までの全ステップ）を取得します。

レスポンス: 200 / 400 / 404 / 500

POST /payment_dispute/{payment_dispute_id}/add_evidence

addEvidence — 支払い紛争に証拠ファイルを追加します。contestPaymentDispute の前に全証拠をアップロードする必要があります。

レスポンス: 200 / 400 / 404 / 409 / 500

POST /payment_dispute/{payment_dispute_id}/contest

contestPaymentDispute — 支払い紛争に異議を申し立てます。事前に全サポートファイルのアップロードが必要です。

レスポンス: 204 / 400 / 404 / 409 / 500

GET /payment_dispute/{payment_dispute_id}/fetch_evidence_content

fetchEvidenceContent — 支払い紛争の特定の証拠ファイルを取得します。

レスポンス: 200 / 400 / 404 / 500

POST /payment_dispute/{payment_dispute_id}/update_evidence

updateEvidence — 既存の証拠セットに証拠ファイルを追加・更新します。

レスポンス: 204 / 400 / 404 / 409 / 500

POST /payment_dispute/{payment_dispute_id}/upload_evidence_file

uploadEvidenceFile — 証拠ファイルをアップロードします。multipart/form-data 形式。サポート: .JPEG、.JPG、.PNG。キー名は「file」。

レスポンス: 200 / 400 / 404 / 409 / 500

payment_dispute_summary — 紛争検索（1 エンドポイント）

GET /payment_dispute_summary

getPaymentDisputeSummaries — フィルターで支払い紛争を検索します。フィルターなしの場合は全ての未解決・最近解決済みの紛争を返します。

レスポンス: 200 / 400 / 500

エンドポイント一覧（全 15 エンドポイント）

スキーマ数: 76（詳細は OpenAPI 仕様を参照）