注文・取引・入札

Trading API — 注文・取引・入札（Order, Transaction & Bidding）

注文・取引・入札カテゴリには、eBay 上での注文管理、取引情報の取得、入札・オファー処理を行う 12 のコールが含まれます。セラーの注文処理ワークフローと、バイヤーの入札・オファーフローの両方をカバーします。

RESTful 代替: 注文管理には Fulfillment API（Sell）、取引情報には Finances API（Sell）も利用可能です。新規開発ではこれらの RESTful API の使用を推奨します。

セラーの注文情報を取得する最も重要なコール。注文 ID、作成日、ステータス、バイヤー情報、配送先、支払い情報、商品明細などが含まれます。日時範囲やステータスでフィルタリング可能。注文管理システムとの同期に必須。

同一セラーから複数のアイテムを購入したバイヤーの取引を 1 つの注文にまとめます。送料の合算やまとめ割引の適用に使用。現在は eBay が自動的に注文をまとめるため、使用頻度は低下。

取引完了に必要な情報を設定します。主な用途：追跡番号と配送業者の設定（発送通知）、支払い受領の確認。複数の追跡番号の設定にも対応。

バイヤーに請求書を送信します。送料の調整、税金の変更、合算配送の適用後に使用。請求書はバイヤーのメッセージボックスに届きます。

特定のアイテムに関連する取引（販売）情報を取得します。マルチ数量リスティングでは複数の取引が返されます。バイヤー情報、支払い状況、配送先などが含まれます。

セラーの全取引を日時範囲で取得します。GetItemTransactions がアイテム単位なのに対し、こちらはセラー全体の取引を一括取得できます。売上レポートや会計処理に有用。

オークションアイテムに入札を行うか、固定価格アイテムの即時購入を実行します。バイヤー側のアプリケーションで使用。入札額、数量、アフィリエイト情報を指定可能。

オークション終了後、全入札者のリスト（ユーザー ID、入札額、入札時刻）を取得します。セカンドチャンスオファーの候補選定に使用。

特定のバイヤーが入札中のアイテム一覧を取得します。バイヤー自身のアクティブな入札状況の確認に使用。

セラーのリスティングに対する Best Offer（価格交渉）の一覧を取得します。ステータス（保留中、承認済み、拒否済みなど）でフィルタリング可能。

Best Offer に対して承認（Accept）、拒否（Decline）、カウンターオファー（Counter）のいずれかで応答します。最大 25 件のオファーに一括応答可能。

クラシファイド広告形式のリスティングから生成されたリード（見込み客情報）を取得します。バイヤーの連絡先、メッセージ、送信日時などが含まれます。主に自動車カテゴリで使用。