Logistics API

Logistics API 概要 (Logistics API Overview)

注: これは限定リリース (Limited Release) APIであり、ビジネスユニットによって承認された一部の開発者のみが利用可能です。

Logistics API は、eBayが交渉した配送料金ですべて価格設定された一連の配送サービスの配送ラベルを提供することにより、セラーがeコマース注文の配送プロセスを合理化するのを支援します。

Logistics APIを使用すると、価格比較のために利用可能な配送サービスの範囲をコンパイルするプロセスを自動化でき、選択したサービスの配送ラベルを購入して印刷できます。このサービスは、eBayの注文専用に機能するように設計されています。

競争力のある配送料金と配送ラベルを簡単にダウンロードできる機能により、このAPIは荷物の発送にかかる時間と労力を削減できます。参加している配送業者からの利用可能なすべての料金を確認するために送料見積もり（shipping quote）を取得することから、このAPIの使用を開始してください。次に、送料、配達および集荷のニーズ、および荷物の発送に必要なその他のオプションに基づいて最適な料金を選択します。そして、選択した料金の配送ラベルを生成し、それを使用して荷物を発送します！

技術概要 (Technical overview)

Logistics APIには、以下のリソースのメソッドが含まれています：

  • shipment
  • shipping_quote

これらのリソースのメソッドを使用すると、送料見積もり（配送業者からのライブ見積もりのリストを含む）を取得し、「出荷（shipment）」を作成できます。このアクションにより、URL経由でダウンロードするか、APIリクエストを使用して取得できる配送ラベルが作成されます。

配送料金

createShippingQuote を呼び出して、配送料金のセットを取得します。リクエストは「送料見積もり（shipping quote）」を返します。これには、単一のパッケージを発送するために使用できる料金のリストが含まれます。発送用のパッケージは、発送元、配送先、およびサイズ（パッケージの重量と寸法）によって定義され、パッケージには注文の全部または一部、あるいは同じ配送先に発送される複数の注文の全部または一部を含めることができます。

送料「レート（rate）」は、基本サービス価格で配送業者からの配送サービスを提供します。レートには、受領時の署名や特別な集荷手配など、パッケージの発送に必要なオプションサービスを含めることができます。すべてのレートはeBayが交渉した価格を提供し、すべてのレートはレートで見積もられた時間枠で利用可能です。

出荷 (Shipments)

createShippingQuote から返された配送料金のいずれかを使用して、「出荷（shipment）」を作成できます。出荷を作成すると、eBayは配送ラベルを生成し、ダウンロードしてパッケージの発送に使用できます。

createFromShippingQuote を呼び出して、選択したレートの出荷を作成します。リクエストを行う際、基本サービスレートで提供される利用可能な配送オプションを追加できます。追加サービスのコストはサービスの基本コストに追加され、totalShippingCost はユーザーのeBay請求契約によって設定されたアカウントに対して請求されます。

ビジネスユースケース (Business use cases)

Logistics APIは、以下に概説するユースケースをサポートしています。

送料見積もりの作成と取得

送料見積もり (shipping quote) は、発送元、配送先、およびサイズによって定義される特定のパッケージを発送するためのライブ見積もりです。

送料見積もりは複数のレート (rates) を提供します。各レートは、特定の配送業者およびサービスを介してパッケージを発送するための「基本レート」と、関連するサービスで利用可能な追加の配送オプションを指定します。各レートには、配送業者が指定した、パッケージの配達が予想される時間枠と集荷の詳細も含まれます。

出荷の作成と取得

送料見積もりを取得した後、返されたレートのいずれかを選択し、選択したレートの詳細に基づいて出荷 (shipment) を作成できます。

出荷を作成すると、eBayは配送ラベルを生成し、ラベルの費用はユーザーのeBayアカウントまたは確立された請求契約に対して請求されます。

配送ラベルの印刷

出荷を作成した後、createFromShippingQuote 呼び出しから返されたURLを使用して関連するラベルを印刷するか、downloadLabelFile メソッドへの呼び出しを介してラベルをダウンロードできます。

出荷のキャンセル

出荷に関連付けられた配送ラベルを使用していない限り、出荷をキャンセルして、送料全額の払い戻しを受けることができます。

Logistics APIの要件と制限 (Logistics API requirements and restrictions)

重要！ Logistics APIの使用は現在、APIの使用をホワイトリストに登録されたパートナーのみに制限されています。Logistics APIへのアクセスをリクエストするには、以下にアクセスしてください：
Application Growth Check

さらに、セラーはこのAPIのメソッドを使用して出荷と関連する配送ラベルを作成する前に、eBayアカウントを介して支払い方法を設定する必要があります。

Logistics APIには、以下に詳述する追加の制限があります。

サポートされている配送場所

Logistics APIは、米国から発送されるパッケージのみに制限されています。参加している配送業者によってサポートされている場合、米国から海外へ発送するためにサービスを使用できます。

サポートされている配送業者

Logistics APIメソッドは、USPSの配送料金とラベルのみをサポートしています。他のキャリアサービスに関連する情報は、これらのメソッドを通じて返されません。

トップに戻る