発注API
説明
発注APIでは、お客様のアプリケーション上でマウザーの商品がご注文いただけます。発注時にマウザー部品番号が必要になるため、マウザー検索APIを使って注文リストを作成しておくことをお勧めします。発注APIの利用方法と関連資料は以下でご確認いただけます。
APIキーを取得する
My Mouserアカウントに「API」という新しいセクションを設けました。こちらでサインアップと、APIキーの閲覧ができます。
キーを取得する発注APIを利用する
発注APIでは、商品の注文、注文内容の確認、対応国/地域・対応通貨リストの取得などが行えます。
カートAPI同様、価格および発注ルールはお客様のアカウントのご請求先住所と初期設定の発送先住所、またはAPIリクエスト時にいただく発送先住所に基づいて定められています。
Mouser APIの利用方法は以下の通りです。
My Mouserアカウントがない場合は、アカウントを作成する。
APIキーがない場合は、キーを取得する。My MouserアカウントのAPI管理ページで取得できます。
APIガイドを読んで、Mouser APIの利用方法の詳細を確認し、サンプルコードを取得する。
ガイドを読むAPIエクスプローラー・ページにアクセスし、すべてのAPI、各APIのエンドポイント、APIリクエスト作成用のテストエリアを確認する。
APIエクスプローラーにアクセスするリクエストを作成する
発注する。
エンドポイント
発注APIのエンドポイントは以下の通りです。
請求先および発送先住所、通貨コード、発送方法一覧と配送料、支払い方法、発送アカウント、課税証明書、VATアカウント、お客様のアカウントに保存済みのクレジットカード情報を返します。
このエンドポイントを利用するには、請求先および発送先住所が必要です。
お客様のアカウントに保存済みのクレジットカードがない場合、発注APIはクレジットカードに対応しません。保存済みのクレジットカードの管理はこちらで行えます。
請求先/発送先住所に基づき、利用可能なすべての通貨を返します。このエンドポイントを利用するには、請求先および発送先住所が必要です。
発送先の国名コードを入力すると、アカウントの初期設定の発送先住所より国名コードが優先されます。
発注には、その注文の通貨コードが必要です。以下の画像のように、USドルでの注文を選択すると、USドルの3桁のISOコードが表示されます。
対応可能なすべての国名・州名・県名などを返します。国名コードで国をフィルターすることができます。このエンドポイントで返される情報は、発注時にアカウントの初期設定の発送先住所より優先したい発送先がある場合に利用できます。
例えばアリゾナ州に発送したい場合は、ISO国名コードは「US」、ISO州名コードは「AZ」を選択して注文を送信します。
新しい注文を行う時に利用します。前述の通り、ここで作成する注文はお客様のアカウントでの注文となり、発注前にカートを作成する必要があります。
請求先/発送先住所/発送方法/決済方法/国・貨幣/予定された発送などの情報に誤りがあった場合、発注はできません。情報に誤りがあるかどうか不明な場合は、「フォールト・トレランス」の項をご参照ください。
カート内のアイテムに誤りがあった場合は、発注前にその誤りを修正するか、カートからそのアイテムを削除する必要があります。
発注完了後、注文番号が返されます。
「SubmitOrder」プロパティがtrueに設定されている場合は、古い注文を基に新しい注文を行います。「SubmitOrder」プロパティがfalseに設定されている場合は、注文の概要が返されます。
作成した注文の詳細を表示します。クエリを使うには、注文番号が必要です。注文番号は、発注時に使うエンドポイント「/api/v{version}/order」のレスポンスボディで返されます。
日本
