ご注文 API

ご注文の作成

テスト用エンドポイント:
https://transact.ti.com/v2/store/orders/test

正式運用エンドポイント:
https://transact.ti.com/v2/store/orders/

ご注文 API を使用すると、ご注文を作成することや、詳細なご注文情報を検索取得することができます。ご注文を作成する前に、在庫と価格設定 API を使用して個別の製品が入手可能かどうか確認する必要があります。   

ご注文 (テストまたは正式運用) を確定するには、API 対応のチェックアウト (購入手続き) プロファイルを貴社の法人アカウントに保存する必要があります。法人アカウントの作成とチェックアウト (購入手続き) プロファイルの詳細については、「はじめに」 (Getting Started) をご覧ください。ご注文の際に参照するチェックアウト (購入手続き) プロファイルを選択するには、チェックアウト (購入手続き) プロファイル API を使用します。応答の中で、API 対応のチェックアウト (購入手続き) プロファイルのみが返されます。チェックアウト プロファイルが見つからなかった場合、チェックアウト プロファイルが完成していること、および承認済みのお支払い方法が既に追加済みであることを確認してください。詳細については、お支払い情報をご覧ください。

テスト用エンドポイントから返されるデータは、正式運用のご注文を実施したときに返される情報を模倣したものです (データはデモのみを目的としており、実際に処理されたデータを表すものではありません)。正式運用の注文をする準備ができた時点で、要求ペイロードの一部として送信しようとするすべてのパラメータを確認し、正式運用エンドポイントを指定して HTTP の「post」 動詞 (コマンド) を使用します。


注:customerOrderComments (顧客のご注文に関する備考) と customerItemComments (顧客の製品に関する備考) の各フィールド は、ご注文の検索取得に対する応答の中で返される、一連のパススルー テキストで構成された配列です。このデータは顧客のみが使用することを意図しており、TI はその内容を検証しません。以下の例では、customerOrderComments 配列を使用して、複数の文字列を区切り記号パイプ (|) で区切った 1 個の配列を渡し、ジョブ番号と、ご注文を確定する人物の名前を指定します。

例:

    "customerOrderComments": [
      {
        "message": "jobNumber|54851-50"
      },
      {
        "message": "orderedBy|John Smith"
      } 
 ]    

 

ご注文の作成フロー

  1. 貴社への割り当て済み API キーとシークレットを使用して、認証を受けます。
  2. 製品の在庫状況や現在の価格設定を検索取得するために、在庫と価格設定 API を使用してクエリを送信します。
  3. この API は、「200OK」 ステータス コードと、要求した製品データを保持する JSON (JavaScript Object Notation:JavaScript オブジェクト記述) を作成して応答します。
  4. TI の在庫と価格設定 API を使用して在庫状況を確認した後、希望のペイロードを使用してご注文を作成し、ご注文 API に対して post (送信) を実行します。
  5. この API は、「201 OK」 ステータス コードと、ご注文への受信確認を保持する JSON を作成して応答します。
#!/bin/bash curl --request POST \ --url 'https://transact.ti.com/v2/store/orders/test' \ --header 'Authorization: Bearer {access_token}' \ --header 'Content-Type: application/json' \ --data-binary @- <<DATA { "Orders" : { "checkoutProfileId" : "COP_ID-1234","customerPurchaseOrderNumber" : "PGR - 04202021","purchaseOrderDate" : "2020-12-31T13:56:00Z","endCustomerCompanyName" : "TI Electronics Inc","expediteShipping" : true, "customerOrderComments" : [ { "message" : "PO: 234723" }, { "message" : "my Test order" } ], "lineItems" : [ { "customerLineItemNumber" : 1, "tiPartNumber" : "ISO1042","customerPartNumber" : "CUS-SN74LS00N","customReelIndicator" : false, "quantity" : 10000, "customerItemComments" : [ { "message" : "For BOM2 - aquired " } ] }, { "customerLineItemNumber" : 2, "tiPartNumber" : "OPA33AIDR","quantity" : 10000 } ] } }


応答の例:

{ "orderNumber": 0, "orderStatus": "string","customerPurchaseOrderNumber": "string","subTotal": 0, "totalPrice": 0, "lineItems": [ { "tiPartNumber": "string","tiPartDescription": "string","quantity": "string","status": "string","unitPrice": 0, "customReelIndicator": true } ], "shippingAddress": [ { "addressType": "string","firstName": "string","lastName": "string","company": "string","addressLine1": "string","addressLine2": "string","town": "string","state": "string","postalCode": "string","country": "string","email": "string","phoneNumber": "string","companyURL": "string" } ], "billingAddress": [ { "addressType": "string","firstName": "string","lastName": "string","company": "string","addressLine1": "string","addressLine2": "string","town": "string","state": "string","postalCode": "string","country": "string","email": "string","phoneNumber": "string","companyURL": "string" } ], "orderMessages": [ { "code": "string","type": "string","Message": "string" } ], "customerOrderComments": [ { "message": "string" } ], "orderPlacedTime": "string","paymentType": "string","currencyISO": "string","totalTax": 0, "checkoutProfileIdentifier": "string","totalDeliveryCost": 0, "totalDiscount": 0, "couponCodes": "string" }