Sidebar - Backlog-V1

概要

TI 注残 API スイートを使用して開発を開始するには、以下の手順に従います。 

  1. アクセスと開発の前提条件を満たします 
  2. 顧客識別コードを受け取ります 
  3. 注残 API スイートを使用する場合の標準的な注文フローを確認します
  4. 認証を受け、アクセス・トークンを受け取ります
  5. TI 製品の見積もりを作成して取得する方法を確認します
  6. テスト用のご注文を作成する方法を確認します
  7. 貴社の注文情報にアクセスする方法を確認します
  8. 1 件のご注文に変更を加える方法を確認します 
  9. 配送状況の追跡情報を取得する方法を確認します
  10. 各財務資料を検索取得する方法を確認します 
  11. 送金通知の作成方法を確認します
  12. サポートを利用

 

手順 1：オンボーディング (研修と登録) プロセスのセットアップと再検討に関する前提条件

注残 API スイートを使用してアプリケーションを開発することができるのは、承認を受けた顧客のみです。承認を取得する方法：

  1. myTI アカウントを作成するか、既存の myTI アカウントにログインします。
  2. 貴殿の myTIアカウントを法人アカウントに関連付けます  
  3. API ポータルにログインします
  4. 顧客のオンボーディング (研修と登録) プロセスを確認します
  5. 顧客のオンボーディング (研修と登録) フォームを送信し、確認します
  6. 貴社の社内システムで TI をベンダとしてセットアップします
  7. 業務とプロセスに関する知識については、API 業務ガイドブックをご覧ください

 

ステップ 2：顧客識別コードを受け取ります

  1. 顧客のオンボーディング (研修と登録) フォームへの入力と送信が完了した後、TI は貴社サイトの顧客識別コードを提供します。これらのコードの用途は、注文、注文の変更、見積もり、送金通知に関して、注残 API のコネクティビティ (相互連絡) を確立することです。これらのコードは、顧客宛に送信されるさまざまな発信文書にも記載されます。
    1. sold-to code (販売先コード) は、購入組織に対応します
    2. bill-to code (請求先コード) は、TI の請求書の送信先です
    3. payer code (支払い担当者コード) は、請求書の支払い元に対応します
    4. ship-to code (出荷先コード) は、TI の製品出荷先の場所に対応します
    5. end customer identification code (最終顧客識別コード) は、承認済みの委託製造業者 (CM)、または他の顧客の代理で購入を行う顧客のみを対象としています
  2. 銀行の詳細を記載した TI のベンダ情報は、E メール通知の一部として、customer identifications code (顧客識別コード) とともに提示されます
    1. 顧客は、付属の PDF を使用して、TI のベンダ情報と財務情報にアクセスすることができます。貴社のシステム内でベンダのセットアップを容易に実行できるように、これらの情報を提供しています。この PDF は、TI の郵送先住所、NAICS コード (北米産業分類の業種別コード)、米連邦納税登録番号、年間売上高、標準的なお支払い情報を記載しています。この PDF は、TI の年次報告書、シティズンシップ・レポート、品質認証へのリンクも掲載しています。初回の顧客のオンボーディング (研修と登録) に対する応答によっては、貴社がベンダをセットアップする際に使用できるように、TI はこの E メール通知の中で TI の取引銀行が属する国や地域を記載しています。

 

手順 3：ご注文フローの概要

  1. TI 標準の API 形式は、検索取得型です。プッシュ型 API をご希望の場合、API 業務ガイドブックをご覧ください。
  2. 貴社への割り当て済み API キーとシークレットを使用して、認証を受けます。   
  3. 見積もり要求を作成できない場合、貴社がご注文を予定しているパーツが、貴社と TI の価格設定契約に掲載されていることを確認します
  4. 希望するペイロードを使用してご注文を作成し、注残向け注文 API に送信 (post) します 
  5. この API は、「201 Created」 (201 作成しました) ステータス・コードと、注文への受信確認を保持する JSON を作成して応答します 
  6. 注残向け注文 API を使用して、ご注文の状況と注文に関する追加の詳細を問い合わせます  
  7. ご注文の処理が完了した後、高度配送通知 (ASN) 検索取得型 API を使用して配送状況の追跡を取得します。また、財務資料検索取得型 API を使用して、請求書を取得します   
  8. 送金通知 API は必須です。送金情報を TI 宛に送信するには、送金通知 API を呼び出します   
  9. これらのステップを実行するためのサンプル・コードに関心をお持ちですか？ TI のサンプル・コードをダウンロードします  

 

手順 4：認証

TI は、OAuth 2.0 を使用して TI API スイートのセキュリティを確保しています。貴社の API キーとシークレットを使用して認証を受けます。 承認後、OAuth2 はアクセス・トークンを返します。貴社は API スイートを有効にした後、スイート内の API でこのトークンを使用することになります。詳細については、認証ページをご覧ください。    

curl --request POST \   
       --url https://transact.ti.com/v1/oauth/accesstoken \   
       --header 'Content-Type: application/x-www-form-urlencoded' \   
       --data grant_type=client_credentials \   
       --data client_id=<<INSERT YOUR CLIENT KEY>> \   
       --data client_secret=<<INSERT YOUR SECRET>>

手順 5：TI 製品の見積もりを作成し、検索取得する

見積もり API を使用すると、認証済みの顧客は TI のエンタープライズ・システム内で見積書を作成できます。1 通の見積もりに複数の部品と数量を記述して送信することができます。顧客は参照用の見積もり番号を受け取ります。通常、見積もりの応答は 24 時間以内に生成されます。 詳細については、注残の見積もり API ページをご覧ください。

見積もり作成を要求する例：

curl --request POST \
--url 'https://transact.ti.com/v1/quotes' \
--header 'Authorization: Bearer {access_token}' \
--header 'Content-Type: application/json' \
--data-binary @- <<DATA
{
	"Quote": {
		"CustomerQuoteIdentifier": "TEST-AW-20200224-G115",
		"CustomerSoldToIdentifier": 2425,
		"SupplierSoldToIdentifier": 2425,
		"CustomerQuoteReason": "CD",
		"CustomerContactName": "John Smith",
		"CustomerContactEmailAddress": "john-smith@test-customer123.com",
		"CustomerContactPhoneNumber": "888-888-8888",
		"CustomerEndCustomerIdentifier": "John Smith",
		"CustomerEndCustomerName": "Company XYZ",
		"CustomerEndCustomerCity": "Dallas",
		"CustomerEndCustomerCountry": "US",
		"CustomerEndCustomerPostalCode": "75208",
		"CustomerIntermediateCustomerName": "Company ABC",
		"CustomerIntermediateCustomerCity": "",
		"CustomerIntermediateCustomerCountry": "",
		"CustomerIntermediateCustomerPostalCode": "",
		"CustomerEndCustomerWebsite": "https://www.companyxyz.com",
		"LineItems": [
			{
				"CustomerQuoteLineItemNumber": 1,
				"SupplierProductIdentifier": "SN74LS00N",
				"CustomerProductIdentifier": "SN74LS00N",
				"CustomerQuoteItemQuantity": 2500,
				"CustomerTargetUnitPrice": 1.2,
				"CustomerCompetingSupplierName": "Competitor N",
				"CustomerItemComments": "Costdown Quote",
				"CustomerCompetingSupplierMaterial": "SNKLLPO23",
				"CustomerCompetingSupplierUnitPrice": 1.43,
				"CustomerCompetingSupplierCurrency": "USD"
			}
		]
	}
}
DATA

見積もり作成に対する応答の例：

{
	"Quote": {
		"CustomerQuoteIdentifier": "TEST-AW-20200224-G115",
		"CustomerSoldToIdentifier": 2425,
		"CustomerQuoteReason": "CD",
		"CustomerContactName": "John Smith",
		"SupplierEndCustomerName": "Company XYZ",
		"SupplierEndCustomerWebSite": "https://companyxyz.com",
		"SupplierQuoteStatus": "Accept",
		"SupplierSoldToIdentifier": 114207,
		"SupplierQuoteValidFromDate": "2021-09-15T00:00:00Z",
		"SupplierQuoteValidToDate": "2022-03-14T00:00:00Z",
		"LineItems": [
			{
				"CustomerQuoteLineItemNumber": 1,
				"SupplierQuoteItemStatus": "Pending",
				"SupplierProductIdentifier": "SN74LS00N",
				"CustomerProductIdentifier": "SN74LS00N",
				"CustomerQuoteItemQuantity": 2500,
				"CustomerTargetUnitPrice": 1.2,
				"CustomerCompetingSupplierName": "Competitor N",
				"SupplierQuoteItemComments": "Costdown Quote",
				"Description": "Quote created with number: 26679695"
			}
		]
	}
}

見積もりの要求を送信した後、見積もりの応答は通常、30 分 ～ 24 時間以内に生成されます。「SupplierQuoteStatus」 (サプライヤからの見積書のステータス) は、見積もり依頼が Accepted (承認)、Rejected (却下)、Changed (変更済み) のどれになったかを示します。「SupplierQuoteItemStatus」 (サプライヤからの見積もり品目のステータス) は、行項目が Pending (保留)、Bid (入札中)、No Bid (入札なし) のどれであるかを示します。

検索取得型の見積もり要求の例：

curl --request GET \   
--url 'https://transact.ti.com/v1/quotes/{customerQuoteNumber}' \
--header 'Authorization: Bearer {access_token}' \

検索取得型の見積もり応答の例：

{
	"Quote": {
		"CustomerQuoteIdentifier": "TEST-AW-20200224-G115",
		"CustomerSoldToIdentifier": 2425,
		"CustomerQuoteReason": "CD",
		"CustomerContactName": "John Smith",
		"CustomerEndCustomerName": "Company XYZ",
		"CustomerEndCustomerWebsite": "https://companyxyz.com",
		"SupplierEndCustomerName": "XYZ CORPORATION",
		"SupplierEndCustomerWebSite": "https://companyxyz.com",
		"SupplierQuoteStatus": "Accept",
		"SupplierSoldToIdentifier": "114207",
		"SupplierSoldToName": "YOUR COMPANY NAME",
		"SupplierQuoteValidFromDate": "2021-09-15T00:00:00Z",
		"SupplierQuoteValidToDate": "2022-03-14T00:00:00Z",
		"LineItems": [
			{
				"SupplierQuoteLineItemNumber": 10,
				"SupplierQuoteItemStatus": "Pending",
				"SupplierProductIdentifier": "SN74LS00N",
				"CustomerProductIdentifier": "SN74LS00N",
				"CustomerQuoteItemQuantity": 2500,
				"CustomerTargetUnitPrice": 1.2,
				"SupplierUnitPrice": 0,
				"SupplierUnitPriceCurrency": "USD",
				"CustomerCompetingSupplierName": "Competitor N",
				"SupplierQuoteItemComments": "Costdown Quote",
				"SupplierProductLeadTime": 35,
				"SupplierProductMinimumQuantity": 90,
				"SupplierProductNextQuantityIncrement": 90,
				"SupplierProductPackageType": "JEDEC TRAY (5+1)",
				"SupplierProductRestrictionOfHazardousSubstancesCompliant": "Y",
				"SupplierProductCancellationWindowWeeks": 5,
				"SupplierProductRescheduleWindowWeeks": 5,
				"SupplierNonCancellableNonReturnableProduct": false,
				"SupplierProductType": "STD",
				"SupplierProductMoistureLevel": "3",
				"SupplierProductExportControlClassificationNumber": "EAR99",
				"SupplierPaymentTerms": "Per Negotiated Terms"
			}
		]
	}
}

ステップ 6：テスト用のご注文を作成

テスト用の注残向け注文は、正式運用開始前のテスト環境内でシミュレートされるもので、貴社のアプリケーション開発を支援することを特に意図しています。     返される情報は、デモを目的とするシミュレーションによるテスト・データであり、実際に処理された情報を表しているわけではありません。  

テスト用注残向け注文の作成 URL：https://transact-pre.ti.com/v1/orders/create (正式運用開始前)  

  1. (テストまたは正式運用の) ご注文を確定できるのは、顧客が承認済みであり、セットアップをすでに構成済みで、オンボーディング (研修と登録) プロセスを完了した場合です
  2. 顧客が注文の入力と変更両方のテストを正常に完了した後、API 業務ガイドブックのユーザー承認テストのシナリオに従ってテスト・フェーズを完了します

注残向けテスト注文の作成を要求する例： 

curl --request POST \
--url 'https://transact-pre.ti.com/v1/orders/create' \
--header 'Authorization: Bearer {access_token}' \
--header 'Content-Type: application/json' \
--data-binary @- <<DATA
{
  "Order": {
    "CustomerPurchaseOrderIdentifier": "TEST-AW-20200224-G115",
    "CustomerPurchaseOrderDate": "YYYY-MM-DD",
    "CustomerSoldToIdentifier": "111111",
    "CustomerShipToIdentifier": "111111",
    "CustomerEndCustomerIdentifier": "",
    "
    "LineItems": [
      {
        "CustomerPurchaseOrderLineItemNumber": "1",
        "SupplierProductIdentifier": "SN74LS00N",
        "CustomerProductIdentifier": "CPN-XXX",
        "CustomerExpectedUnitPrice": "0.987",
        "Schedules": [
          {
            "CustomerRequestedQuantity": "2000",
            "CustomerRequestedDate": "2023-06-15"
          },
          {
            "CustomerRequestedQuantity": "3000",
            "CustomerRequestedDate": "2023-07-15"
          }
        ]
      },
      {
        "CustomerPurchaseOrderLineItemNumber": "2",
        "SupplierProductIdentifier": "SN74LS00N",
        "CustomerProductIdentifier": "",
        "CustomerExpectedUnitPrice": "1",
        "Schedules": [
          {
            "CustomerRequestedQuantity": "4000",
            "CustomerRequestedDate": "2023-08-01"
          }
        ]
      }
    ]
  }
}

注残向けテスト注文の作成に対する応答の例： 

{
  "Orders": [
    {
      "AsOfDateTime": "2023-02-24 17:02:11",
      "SupplierOrderStatus": "ACCEPT",
      "CustomerPurchaseOrderIdentifier": "TEST-AW-20200224-G115",
      "CustomerSoldToIdentifier": "111111",
      "CustomerShipToIdentifier": "111111",
      "LineItems": [
        {
          "CustomerPurchaseOrderLineItemNumber": "1",
          "SupplierProductIdentifier": "SN74LS00N",
          "CustomerExpectedUnitPrice": "0.987",
          "Schedules": [
            {
              "CustomerRequestedQuantity": 2000,
              "CustomerRequestedDate": "2023-06-15"
            },
            {
              "CustomerRequestedQuantity": 3000,
              "CustomerRequestedDate": "2023-07-15"
            }
          ]
        },
        {
          "CustomerPurchaseOrderLineItemNumber": "2",
          "SupplierProductIdentifier": "SN74LS00N",
          "CustomerExpectedUnitPrice": 1,
          "Schedules": [
            {
              "CustomerRequestedQuantity": 4000,
              "CustomerRequestedDate": "2023-08-01"
            }
          ]
        }
      ]
    }
  ]
}

正式運用の注残向け注文を行う準備ができた時点で、要求ペイロードの一部として送信しようとするすべてのパラメータを確認し、正式運用バージョンの認証に対応する URL と、注残向け注文の create API に対応するURL を使用します。https://transact.ti.com/v1/oauth、および https://transact.ti.com/v1/orders/create。 

テストと正式運用の各注文の詳細については、注残向け注文 API の資料ページをご覧ください。

 

ステップ 7： ご注文の詳細を照会

注残向け注文の取得検索型 API を使用すると、顧客の注文書番号またはサプライヤの注文番号を使用して、注文の詳細にアクセスすることができます。

顧客の注文書番号を使用して注文の詳細を検索取得する例：

curl --request POST \
--url 'https://transact-pre.ti.com/v1/orders/retrieve' \
--header 'Authorization: Bearer {access_token}' \
--header 'Content-Type: application/json' \
--data-binary @- <<DATA

{
  "CustomerPurchaseOrderIdentifier": "TEST-AW-20200224-G115"
  }​

サプライヤの注文番号を使用して注文の詳細を検索取得する例： 

​
curl --request POST \
--url 'https://transact-pre.ti.com/v1/orders/retrieve' \
--header 'Authorization: Bearer {access_token}' \
--header 'Content-Type: application/json' \
--data-binary @- <<DATA

{
    "SupplierOrderIdentifier": "1000004607"
}

​

応答の例：

{
  "CustomerPurchaseOrderIdentifier": "TEST-AW-20200224-G115",
  "SupplierOrderIdentifier": "1000004607",
  "Orders": [
    {
      "AsOfDateTime": "2023-03-27 20:57:06",
      "SupplierOrderIdentifier": "1000000000",
      "SupplierOrderStatus": "OPEN",
      "CustomerPurchaseOrderIdentifier": "TEST-AW-20200224-G115",
      "CustomerSoldToIdentifier": "111111",
      "CustomerShipToIdentifier": "111111",
      "LineItems": [
        {
          "SupplierOrderLineItemNumber": "000010",
          "CustomerPurchaseOrderLineItemNumber": "1",
          "SupplierOrderItemStatus": "Not Delivered",
          "SupplierChangeOrderWindow": "NON",
          "SupplierProductIdentifier": "SN74LS00N",
          "SupplierTotalOrderItemQuantity": 5000,
          "CustomerExpectedUnitPrice": "0.152",
          "SupplierUnitPrice": 1,
          "CustomerCertificateOfConformance": "YES",
          "LineItemMessages": [
            {
              "Code": "TI-TXT-051",
              "Type": "INFO",
              "Message": "Customer expected price mismatch with TI price"
            },
            {
              "Code": "TI-TXT-089",
              "Type": "INFO",
              "Message": "Item quantity does not match rated quantity; Rating has not been applied"
            }
          ],
           "Schedules": [
            {
              "CustomerRequestedQuantity": 2000,
              "CustomerRequestedDate": "2023-06-15",
              "Confirmations": [
                {
                  "SupplierScheduleLineNumber": "0005",
                  "SupplierConfirmedQuantity": 2000,
                  "CustomerRequestedShipDate": "2023-06-12",
                  "SupplierEstimatedShipDate": "2023-06-12",
                  "SupplierEstimatedDeliveryDate": "2023-06-15",
                  "SupplierDeliveredQuantity": 0
                }
              ]
            },
            {
              "CustomerRequestedQuantity": 3000,
              "CustomerRequestedDate": "2020-07-15",
              "Confirmations": [
                {
                  "SupplierScheduleLineNumber": "0006",
                  "SupplierConfirmedQuantity": 3000,
                  "CustomerRequestedShipDate": "2023-07-10",
                  "SupplierEstimatedShipDate": "2023-07-10",
                  "SupplierEstimatedDeliveryDate": "2023-07-15",
                  "SupplierDeliveredQuantity": 0
                }
              ]
            }
          ]
        },
        {
          "SupplierOrderLineItemNumber": "000020",
          "CustomerPurchaseOrderLineItemNumber": "2",
          "SupplierOrderItemStatus": "Not Delivered",
          "SupplierChangeOrderWindow": "NON",
          "SupplierProductIdentifier": "SN74LS00N",
          "SupplierTotalOrderItemQuantity": 4000,
          "CustomerExpectedUnitPrice": "1.00",
          "SupplierUnitPrice": 1,
          "Schedules": [
            {
              "CustomerRequestedQuantity": 4000,
              "CustomerRequestedDate": "2023-08-01",
              "Confirmations": [
                {
                  "SupplierScheduleLineNumber": "0002",
                  "SupplierConfirmedQuantity": 4000,
                  "CustomerRequestedShipDate": "2023-07-29",
                  "SupplierEstimatedShipDate": "2023-07-29",
                  "SupplierEstimatedDeliveryDate": "2023-08-01",
                  "SupplierDeliveredQuantity": 0
                }
              ]
            }
          ]
        }
      ]
    }
  ]
}

注文と、利用可能な注文の詳細については、注残向け注文 API の資料ページをご覧ください。 

 

ステップ 8：1 件のご注文に変更を加える方法を確認します 

注文の変更を要求するための最初のステップは、テスト用の注文を作成できたかどうか確認することです。

以下に示すデータ・パラメータは、注文の作成要求のペイロードから取得したものであり、作成されたテスト用の注文の番号、注文の作成日、注文のステータス、その注文を特定する顧客側 PO 番号を表します。

  •  AsOfDateTime "2023-01-30 18:11:04"
  •  SupplierOrderIdentifier "1111111111"
  •  SupplierOrderStatus "OPEN"
  •  CustomerPurchaseOrderIdentifier "PO-Order1"

注文の変更要求のペイロードで使用する注文のデータ・フィールドは、元の注文要求と完全に一致している必要があります。

テスト用の注文要求の例：

  {
	"Order": {
		"CustomerPurchaseOrderIdentifier": "PO-Order1",
		"CustomerPurchaseOrderDate": "2022-12-01",
		"CustomerSoldToIdentifier": "111111",
		"CustomerShipToIdentifier": "111111",
		"LineItems": [
			{
				"CustomerPurchaseOrderLineItemNumber": "1",
				"SupplierProductIdentifier": "SN74LVC139ADR",
				"CustomerProductIdentifier": "SN74LVC139ADR",
				"CustomerExpectedUnitPrice": 2.15,
				"Schedules": [
					{
						"CustomerRequestedQuantity": 10000,
						"CustomerRequestedDate": "2023-06-05"
					}
				]
			}
		]
	}
}

テスト用の注残向け注文の変更 URL を使用して、注文の変更に関する以下のシナリオのいずれかをテストします。https://transact-pre.ti.com/v1/orders/change (正式運用前)  

  1. 顧客要求日の変更 - CustomerItemChangeIndicator を「U」に設定し、必要に応じて CustomerRequestedDate を変更します。     
  2. 顧客要求数量の変更 - CustomerItemChangeIndicator を「U」に設定し、必要に応じて CustomerRequestedQuanity を変更します。    
  3. 顧客が期待する単価 (+/-)：CustomerItemChangeIndicator を「U」に設定し、必要に応じて CustomerExpectedUnitPrice を変更します。     


注文の変更要求の例に変更を加えたもの：

"Order": {
		"CustomerPurchaseOrderIdentifier": "PO-Order1",
		"CustomerPurchaseOrderDate": "2022-12-01",
		"CustomerSoldToIdentifier": "167435",
		"CustomerShipToIdentifier": "167435",
		"LineItems": [
			{
				"CustomerPurchaseOrderLineItemNumber": "1",
				"CustomerItemChangeIndicator": "U",
				"SupplierProductIdentifier": "SN74LVC139ADR",
				"CustomerProductIdentifier": "SN74LVC139ADR",
				"CustomerExpectedUnitPrice": 2.15,
				"Schedules": [
					{
						"CustomerRequestedQuantity": 10000,
						"CustomerRequestedDate": "2023-06-05"
					}
				]
			}
		]
	}
}

テスト用の注残向け注文の変更 URL を使用し、各行項目に対し以下のパラメータ・インジケータを指定して注文をキャンセルする方法。https://transact-pre.ti.com/v1/orders/change (正式運用前)。 

 4. テスト用のご注文をキャンセルするシナリオ - 注文全体をキャンセルするには、その注文内にあるすべての項目 (1 ～ n) に対して CustomerItemChangeIndicator を「X」に設定する必要があります。 個別の項目をキャンセルするには、キャンセルしようとする項目のみを列挙し、CustomerItemChangeIndicator を「X」に設定します。ご注文に残そうとする他のすべての項目は、列挙から除外します。

 

キャンセルを目的とするご注文の変更の例に変更を加えたもの：

{
	"Order": {
		"CustomerPurchaseOrderIdentifier": "PO-Order2",
		"CustomerPurchaseOrderDate": "2023-01-01",
		"CustomerSoldToIdentifier": "111111",
		"CustomerShipToIdentifier": "111111",
		"LineItems": [
			{
				"CustomerPurchaseOrderLineItemNumber": "1",
				"CustomerItemChangeIndicator": "X",
				"SupplierProductIdentifier": "SN74LVC139",
				"CustomerProductIdentifier": "SN74LVC139",
				"CustomerExpectedUnitPrice": 1.15,
				"Schedules": [
					{
						"CustomerRequestedQuantity": 10000,
						"CustomerRequestedDate": "2023-06-05"
		      		
       "LineItems": [
			{
				"CustomerPurchaseOrderLineItemNumber": "2",
				"CustomerItemChangeIndicator": "X",
				"SupplierProductIdentifier": "SN74LVC139ADR",
				"CustomerProductIdentifier": "SN74LVC139ADR",
				"CustomerExpectedUnitPrice": 2.15,
				"Schedules": [
					{
						"CustomerRequestedQuantity": 10000,
						"CustomerRequestedDate": "2023-06-05"
					}
				]
			}
		]
	}
}

貴社の API テスト・コードを使用して変更注文 API をテストする方法については、API support (英語) にお問い合わせください。

 

ステップ 9：配送状況の追跡情報を取得する方法を確認します。

ご注文の梱包後、TI は出荷の準備ができた時点で、高度配送通知 (ASN) API を通じてアクセス可能な配送追跡情報を生成します。この応答は、配送追跡番号、配送業者情報、商用請求書など、顧客宛ての配送に関する詳細情報を格納しています。この API は、プッシュ型、または検索取得型どちらかの実装が可能です。  

検索取得に対応する要求の例：

curl --request POST \
--url 'https://transact-pre.ti.com/v1/advance-ship-notices/retrieve/?SupplierOrderIdentifier=123456789&
CustomerSoldToIdentifier=ABC123456&RequestCommercialInvoicePDF=X&RequestWaybillPDF=X' \
--header 'Authorization: Bearer {access_token}'

応答の例：

{
  "CustomerSoldToIdentifier": "ABCDEF",
  "SupplierOrderIdentifier": "1234567890",
  "CustomerPurchaseOrderIdentifier": "T1234567",
  "SupplierWayBillIdentifier": "5678901234",
  "RequestCommercialInvoicePDF": "X",
  "RequestWaybillPDF": "X",
  "Data": {
    "ConsolidatedInformation": [
      {
        "ShipmentEstimatedDateOfArrival": {},
        "ShipmentGoodsIssueDate": {},
        "ShipmentNumberOfPallet": "1",
        "ShipmentGrossWeight": "2.450",
        "ShipmentGrossWeightUnitOfMeasure": "KG",
        "ShipmentNumberOfPieces": "2",
        "ShipmentNetWeight": "0.264",
        "ShipmentNetWeightUnitOfMeasure": "KG",
        "ShipmentServiceLevelCode": "ABC",
        "ShipmentProductDescription": "ABC DEF GHI",
        "CarrierShipmentMasterTrackingNumber": "123456",
        "CarrierShipmentBoxTrackingNumber": "CUSTOMER XLR8",
        "SupplierShippingDate": {},
        "SupplierShippingPoint": "1808",
        "SupplierShippingCondition": "EG",
        "CustomerSoldToIdentifier": "0000123456",
        "SpecialProcessingIndicator": "string",
        "ModeOfTransport": "05",
        "CustomerBuyerCode": "12345",
        "CustomerShipperVendorCode": "ABCDEFG",
        "SupplierShipTrackReference": "123456789012",
        "SupplierSoldToPartyName": "CUSTOMER CORPORATION",
        "ShipmentInternalTransactionNumberList": [
          {
            "ShipmentInternalTransactionNumber": "1234"
          }
        ],
        "ForwardingAgentDetails": {
          "ForwarderCompanyName": "XYZ",
          "ForwarderStandardCarrierAccessCode": "ABCD",
          "SupplierCarrierIdentifier": "12345",
          "SupplierCarrierTrackingWebSite": "https://www.carrierxyz.com"
        },
        "SupplierWayBillNumberList": [
          {
            "SupplierWayBillIdentifier": "5678901234",
            "SupplierWayBillCreationDate": {},
            "SupplierWayBillCreationTime": "09:15:08",
            "SupplierWaybillPDF": "string"
          }
        ],
        "SupplierCommercialInvoicelist": [
          {
            "SupplierCommercialInvoiceIdentifier": "987654321",
            "SupplierCommercialInvoiceDate": {},
            "SupplierCommercialInvoiceTime": "22:32:40",
            "SupplierIncotermCode": "DDP",
            "SupplierIncotermDescription": "Buyers Dock",
            "SupplierCommercialInvoiceValue": "100.100",
            "SupplierCommercialInvoiceCurrency": "USD",
            "SupplierCommercialInvoicePDF": "string"
          }
        ],
        "ShipToDetails": {
          "CustomerShipToPlantIdentifier": "00001234",
          "CustomerShipToCompanyName": "XYZ",
          "CustomerShipToContactName": "010-234-2010",
          "CustomerShipToAddress1": "123 Main St",
          "CustomerShipToAddress2": "ABC",
          "CustomerShipToCity": "Fort Worth",
          "CustomerShipToState": "TX",
          "CustomerShipToZipCode": "12345-1234",
          "CustomerShipToCountry": "US",
          "CustomerShipToCompanyNameAdditionalDetail": "ABCD"
        },
        "ShipFromDetails": {
          "SupplierShipFromPlantIdentifier": "00001234",
          "SupplierShipFromCompanyName": "Texas Instruments",
          "SupplierShipFromContactName": "010-234-2010",
          "SupplierShipFromAddress1": "13601 Independence Parkway",
          "SupplierShipFromAddress2": "ABC",
          "SupplierShipFromCity": "Fort Worth",
          "SupplierShipFromState": "TX",
          "SupplierShipFromZipCode": "12345-1234",
          "SupplierShipFromCountry": "US",
          "SupplierShipFromEmailAddress": "test@test.com",
          "SupplierShipFromPhoneNumber": "010-101-2031"
        },
        "SupplierCrossDockDetails": {
          "SupplierCrossDockPlantIdentifier": "00001234",
          "SupplierCrossDockCompanyName": "XYZ",
          "SupplierCrossDockContactName": "010-234-2010",
          "SupplierCrossDockAddress1": "123 Main St",
          "SupplierCrossDockAddress2": "ABC",
          "SupplierCrossDockCity": "Fort Worth",
          "SupplierCrossDockState": "TX",
          "SupplierCrossDockZipCode": "12345-1234",
          "SupplierCrossDockCountry": "US"
        },
        "ImporterDetails": {
          "ImporterCompanyName": "XYZ",
          "ImporterContactName": "010-234-2010",
          "ImporterAddress1": "13601 Independence Parkway",
          "ImporterAddress2": "ABC",
          "ImporterCity": "Fort Worth",
          "ImporterState": "TX",
          "ImporterZipCode": "12345-1234",
          "ImporterCountry": "US"
        },
        "SupplierManifestIdentifierList": {
          "SupplierManifestIdentifier": "7890123456"
        },
        "BookingOrderDetails": [
          {
            "CustomerPurchaseOrderIdentifier": "T1234567",
            "CustomerPurchaseOrderDate": {},
            "PassThrus": [
              {
                "SupplierOrderIdentifier": "1234567890",
                "CustomerPassthru1": "ZREF*00001*URL=www.test.com",
                "CustomerPassthru2": "ZREF*00002*URL=www.test.com",
                "CustomerPassthru3": "ZREF*00003*URL=www.test.com",
                "CustomerPassthru4": "ZREF*00004*URL=www.test.com",
                "CustomerPassthru5": "ZREF*00005*URL=www.test.com",
                "CustomerPassthru6": "ZREF*00006*URL=www.test.com",
                "CustomerPassthru7": "ZREF*00007*URL=www.test.com",
                "CustomerPassthru8": "ZREF*00008*EML=test@test.com",
                "CustomerPassthru9": "ZREF*00009*URL=www.test.com",
                "CustomerPassthru10": "ZREF*00010*URL=www.test.com",
                "CustomerPassthru11": "ZREF*00011*URL=www.test.com",
                "CustomerPassthru12": "ZREF*00012*EML=test@test.com",
                "CustomerPassthru13": "ZREF*00013*URL=www.test.com",
                "CustomerPassthru14": "ZREF*00014*URL=www.test.com",
                "CustomerPassthru15": "ZREF*00015*URL=www.test.com"
              }
            ],
            "PackageDetails": [
              {
                "PackageHandlingUnitIdentifier": "1234567890",
                "PackageContainerVolume": "0.000",
                "PackageContainerVolumeUnitOfMeasure": "CDM",
                "PackageLength": "0.000",
                "PackageWidth": "0.000",
                "PackageHeight": "0.000",
                "PackageLWHUnitOfMeasure": "MM",
                "PackageTrackingNumber": "123456789012",
                "PackageNumberOfLineItems": "0",
                "PackageAlternateHandlingUnitIdentifier": "ABCDEFGH",
                "PackageNetWeight": "0.000",
                "PackageGrossWeight": "0.000",
                "PackageWeightUnitOfMeasure": "KG",
                "ItemDetails": [
                  {
                    "SupplierProductIdentifier": "TPS12345",
                    "CustomerProductIdentifier": "ABCDEFG",
                    "SupplierProductDescription": "TPS12345 description",
                    "SupplierDeliveryLineItemNumber": "000010",
                    "SupplierDeliveryIdentifier": "0123456789",
                    "SupplierOrderIdentifier": "1234567890",
                    "SupplierOrderLineItemNumber": "000010",
                    "CustomerPurchaseOrderIdentifier": "T1234567",
                    "CustomerPurchaseOrderItemNumber": "2",
                    "CustomerPurchaseOrderDate": {},
                    "SupplierItemNumberOfUnitsShipped": "000000000001",
                    "SupplierItemBaseUnitOfMeasure": "EA",
                    "SupplierItemGrossWeight": "1.450",
                    "SupplierItemNetWeight": "0.165",
                    "SupplierItemWeightUnitOfMeasure": "KG",
                    "SupplierCommercialInvoiceIdentifier": "987654321",
                    "SupplierCommercialInvoiceItem": "000001",
                    "SupplierCommercialInvoiceUnitprice": "123.000000",
                    "SupplierCommercialInvoiceValue": "123.000000",
                    "SupplierCommercialInvoiceCurrency": "USD",
                    "SupplierCountryOfOriginCode": "PH",
                    "SupplierCountryOfOriginDescription": "Philippines",
                    "SupplierAssemblyCountryOfOriginCode3Character": "PHL",
                    "SupplierAssemblyCountryOfOriginCode2Character": "PH",
                    "SupplierAssemblyCountryOfOriginDescription": "Philippines",
                    "SupplierItemHarmonizedTariffScheduleExportCode": "8901234567",
                    "SupplierItemHarmonizedTariffScheduleExportDescription": "Electronic Integrated Circuits, Other",
                    "SupplierItemHarmonizedTariffScheduleImportCode": "8901234567",
                    "SupplierItemHarmonizedTariffScheduleImportDescription": "Electronic Integrated Circuits, Other",
                    "SupplierItemConfirmDate": {},
                    "SupplierOrderType": "ZJR",
                    "SupplierDeliveryLineItemTotalQuantity": "24000.000",
                    "SupplierDeliveryLineItemTotalQuantityUnitOfMeasure": "EA",
                    "SupplierItemGoodsIssueDate": {},
                    "SupplierItemGoodsIssueTime": "05:23:19",
                    "CustomerItemPassThru1": "ZOI6*00001*GUID=DE14935C47D74658E10000000AB490BB/010/20191008130206",
                    "CustomerItemPassThru2": "ZOI6*00002*GUID=DE14935C47D74658E10000000AB490BB/010/20191008130206",
                    "CustomerItemPassThru3": "ZOI6*00003*GUID=DE14935C47D74658E10000000AB490BB/010/20191008130206",
                    "CustomerItemPassThru4": "ZOI6*00004*GUID=DE14935C47D74658E10000000AB490BB/010/20191008130206",
                    "CustomerItemPassThru5": "ZOI6*00005*GUID=DE14935C47D74658E10000000AB490BB/010/20191008130206",
                    "CustomerItemPassThru6": "ZOI6*00006*GUID=DE14935C47D74658E10000000AB490BB/010/20191008130206",
                    "CustomerItemPassThru7": "ZOI6*00007*GUID=DE14935C47D74658E10000000AB490BB/010/20191008130206",
                    "CustomerItemPassThru8": "ZOI6*00008*GUID=DE14935C47D74658E10000000AB490BB/010/20191008130206",
                    "CustomerItemPassThru9": "ZOI6*00009*GUID=DE14935C47D74658E10000000AB490BB/010/20191008130206",
                    "CustomerItemPassThru10": "ZOI6*00010*GUID=DE14935C47D74658E10000000AB490BB/010/20191008130206",
                    "CustomerItemPassThru11": "ZOI6*00011*GUID=DE14935C47D74658E10000000AB490BB/010/20191008130206",
                    "CustomerItemPassThru12": "ZOI6*00012*GUID=DE14935C47D74658E10000000AB490BB/010/20191008130206",
                    "CustomerItemPassThru13": "ZOI6*00013*GUID=DE14935C47D74658E10000000AB490BB/010/20191008130206",
                    "CustomerItemPassThru14": "ZOI6*00014*GUID=DE14935C47D74658E10000000AB490BB/010/20191008130206",
                    "CustomerItemPassThru15": "ZOI6*00015*GUID=DE14935C47D74658E10000000AB490BB/010/20191008130206",
                    "SupplierShipTrackCodeList": [
                      {
                        "SupplierShipTrackCode": "012345ABC",
                        "SupplierAlternateShipTrackCode": "HIJKLM",
                        "SupplierChipCountryOfOriginCode3Character": "USA",
                        "SupplierChipCountryOfOriginCode2Character": "US",
                        "SupplierChipCountryOfOriginDescription": "USA",
                        "SupplierItemShipTrackCodeQuantity": "3000",
                        "SupplierBatchNumber": "1234567PHI",
                        "SupplierShipDate": {},
                        "SupplierDateCode": "2110",
                        "SupplierAlternateTrackingIdentifier": "ABCDEFGHIJK"
                      }
                    ]
                  }
                ]
              }
            ]
          }
        ]
      }
    ]
  }
}

貴社の API テスト・コードを使用して ANS (高度配送通知) をテストする方法の詳細については、API support (英語) にお問い合わせください。 code.

 

手順 10：各財務資料を検索取得する方法を確認します

財務文書 API は、お支払いに関する請求書情報を提供します。財務資料 API を使用して請求書を検索取得するには、検索取得向け JSON ペイロードの一部として注文書 (PO) 番号を指定する必要があります。財務資料は、TI が出荷を処理した後に入手可能になります。

PDF を検索取得するには、構成オプションに関する資料をご覧ください。

例：

curl --request POST \
--url 'https://transact-pre.ti.com/v1/financial-documents/retrieve' \
--header 'Authorization: Bearer {access_token}' \
--header 'Content-Type: application/json' \
--data-binary @- <<DATA
{
  "CustomerSoldToIdentifier": "123",
  "SupplierFinancialDocumentIdentifier": "1234567890",
  "CustomerReferenceIdentifier": "",
  "SupplierDeliveryIdentifier": "",
  "CustomerPurchaseOrderIdentifier": "",
  "SupplierDocumentStatus": "",
  "SupplierDocumentCreatedFromDate": "",
  "SupplierDocumentCreatedToDate": "",
  "RequestPDF": ""
}

応答の例：

{
  "CustomerSoldToIdentifier": "123",
  "SupplierFinancialDocumentIdentifier": "1234567890",
  "TotalNumberOfDocuments": "1",
  "Documents": [
    {
      "SupplierDocumentType": "INVOICE",
      "SupplierFinancialDocumentIdentifier": "1234567890",
      "SupplierDocumentCreatedDate": "2020-05-11",
      "SupplierDocumentStatus": "CLEARED",
      "SupplierDocumentCurrency": "USD",
      "CustomerPurchaseOrderIdentifier": "PO1234",
      "CustomerReferenceIdentifier": "0100000200",
      "SupplierGrossWeight": "100.000",
      "SupplierNetWeight": "100.000",
      "SupplierWeightUnit": "GRM",
      "SupplierCarrier": "FEDEX EXPRESS",
      "DocumentValue": {
        "SupplierTotalAmount": "15,000.00"
      },
      "SalesOrder": {
        "SupplierOrderIdentifier": "1000001234",
        "SupplierOrderLineItemNumber": "000000",
        "CustomerPurchaseOrderIdentifier": "PO1234",
        "CustomerPurchaseOrderDate": "2020-01-01"
      },
      "PaymentTerms": {
        "SupplierIncoterms1": "TERMS1",
        "SupplierIncoterms2": "TERMS2",
        "SupplierTermsOfDelivery": "SHIPPING TERMS",
        "SupplierTermsOfPayment": "Net XX Days from Invoice Date",
        "PaymentTermsText": [
          {
            "SupplierPaymentTermsText": "Up to XX.XX.2020 without deduction"
          }
        ]
      },
      "CreditManager": {
        "SupplierCreditManagerName": "Bill Johnson",
        "SupplierCreditManagerTelephone": "1234567890",
        "SupplierCreditManagerEmail": "bj-noreply@ti.com"
      },
      "Delivery": {
        "SupplierDeliveryIdentifier": "0200000300",
        "SupplierDeliveryLineItemNumber": "000000",
        "SupplierDeliveryDate": "2020-04-13",
        "SupplierGoodsMovementDate": "2020-05-11"
      },
      "Waybill": {
        "SupplierWaybillNumber": "123456",
        "SupplierNumberOfBoxes": "1"
      },
      "Partners": [
        {
          "PartnerTypeDescription": "Sender",
          "Name1": "Texas Instruments Incorporated",
          "Name2": "Semiconductor",
          "StreetAddress": "12500 TI Boulevard",
          "City": "Dallas",
          "Region": "TX",
          "PostalCode": "75243",
          "Country": "US"
        },
        {
          "PartnerTypeDescription": "Remit To",
          "Name1": "For ACH Transfer send to:",
          "Name2": "Texas Instruments ",
          "Name3": "Bank Acct 1234567890, ABA 123456789",
          "Name4": "SWIFT 12345678",
          "City": "DALLAS",
          "Region": "TX",
          "PostalCode": "75202",
          "Country": "US"
        },
        {
          "PartnerTypeDescription": "Sold-to Party",
          "CustomerNumber": "123",
          "Name1": "TEST CUSTOMER",
          "Name2": " TEST CUSTOMER Line 2",
          "StreetAddress": "123 MAIN BLVD",
          "City": "SAN FRANCISCO",
          "Region": "CA",
          "PostalCode": "94102",
          "Country": "US"
        },
        {
          "PartnerTypeDescription": "Bill-to Party",
          "Name1": "TEST CUSTOMER",
          "Name2": "ATTN: ACCOUNTS PAYABLE DEPT",
          "StreetAddress": "123 MAIN BLVD",
          "City": "SAN FRANCISCO",
          "Region": "CA",
          "PostalCode": "94102",
          "Country": "US"
        },
        {
          "PartnerTypeDescription": "Ship-to Party",
          "CustomerNumber": "123",
          "Name1": "TEST CUSTOMER",
          "Name2": "TEST CUSTOMER Line 2",
          "StreetAddress": "123 MAIN BLVD",
          "City": "SAN FRANCISCO",
          "Region": "CA",
          "PostalCode": "94102",
          "Country": "US"
        }
      ],
      "Items": [
        {
          "SupplierOrderLineItemNumber": "000010",
          "SupplierProductIdentifier": "SM1234",
          "CustomerPartNumber": "CPN5678",
          "SupplierProductDescription": "SM1234 description",
          "SupplierItemQuantity": "300.000",
          "SupplierUnitPrice": "50.00",
          "SupplierItemValue": "15,000.00",
          "SupplierGrossWeight": "100.000",
          "SupplierNetWeight": "100.000",
          "SupplierCommercialInvoiceNumber": "1234567890",
          "SalesOrder": {
            "SupplierOrderIdentifier": "1000001234",
            "SupplierOrderLineItemNumber": "000010",
            "CustomerPurchaseOrderIdentifier": "PO1234",
            "CustomerPurchaseOrderLineItemNumber": "1",
            "CustomerPurchaseOrderDate": "2020-01-01"
          },
          "Delivery": {
            "SupplierDeliveryIdentifier": "0200000300",
            "SupplierDeliveryLineItemNumber": "000010",
            "SupplierDeliveryDate": "2020-04-13",
            "SupplierGoodsMovementDate": "2020-05-11",
            "SupplierGrossWeight": "100.000",
            "SupplierNetWeight": "100.000"
          },
          "ItemVAT": [
            {
              "SupplierTaxIndicator": "O1",
              "SupplierTaxRate": "6.250",
              "SupplierTaxAmount": "0.00",
              "SupplierTaxJurisdiction": "USTX0000000000"
            },
            {
              "SupplierTaxIndicator": "O1",
              "SupplierTaxRate": "0.500",
              "SupplierTaxAmount": "0.00",
              "SupplierTaxJurisdiction": "USTX7804500000"
            },
            {
              "SupplierTaxIndicator": "O1",
              "SupplierTaxRate": "1.250",
              "SupplierTaxAmount": "0.00",
              "SupplierTaxJurisdiction": "USTX7804518860"
            },
            {
              "SupplierTaxIndicator": "O1",
              "SupplierTaxRate": "0.000",
              "SupplierTaxAmount": "0.00",
              "SupplierTaxJurisdiction": "USTX7804518860"
            },
            {
              "SupplierTaxIndicator": "O1",
              "SupplierTaxRate": "0.250",
              "SupplierTaxAmount": "0.00",
              "SupplierTaxJurisdiction": "USTX7804518860"
            },
            {
              "SupplierTaxIndicator": "O1",
              "SupplierTaxRate": "0.000",
              "SupplierTaxAmount": "0.00",
              "SupplierTaxJurisdiction": "USTX7804518860"
            }
          ]
        }
      ]
    }
  ]
}

貴社の API テスト・コードを使用して財務資料 API による検索取得をテストする方法の詳細については、API support (英語) にお問い合わせください。 

 

手順 11：送金通知を作成

顧客のシステムは、送金通知 API を呼び出し、送金情報を送信して、TI のエンタープライズ・システム内に送金通知記録を作成することができます。

各要求に、ヘッダーと品目の両方のセクションを記述する必要があります。 ヘッダー・セクションに、顧客の送金通知、支払担当者のアカウント、合計支払い金額情報を記述します。 品目セクションには、具体的な支払い情報とそれに関連する財務資料情報を含め、1 つまたは任意の数の詳細なレコードを記述することができます。詳細については、注残送金通知 API ページをご覧ください。

要求の例：

curl --request POST \
--url 'https://transact.ti.com/v1/remittance-advice' \
--header 'Authorization: Bearer {access_token}' \
--header 'Content-Type: application/json' \
--data-binary @- <<DATA
{
	"CustomerRemittanceAdviceIdentifier": "CustomerRemit100",
	"CustomerPayerIdentifier": "CustomerPayer1",
	"CustomerPaymentAmount": "100000",
	"CustomerCurrency": "USD",
	"Items": [
		{
			"CustomerNetPaymentAmount": "20000",
			"SupplierFinancialDocumentIdentifier": "1234567890",
			"CustomerFinancialDocumentIdentifier": "CustomerDoc123"
		},
		{
			"CustomerNetPaymentAmount": "30000",
			"SupplierFinancialDocumentIdentifier": "1234567891",
			"CustomerFinancialDocumentIdentifier": "CustomerDoc124"
		},
		{
			"CustomerNetPaymentAmount": "50000",
			"SupplierFinancialDocumentIdentifier": "1234567892",
			"CustomerFinancialDocumentIdentifier": ""
		}
	]
}
DATA

応答の例：

{
	"SupplierRemittanceAdviceIdentifier": "0620062214281851",
	"CustomerRemittanceAdviceIdentifier": "CustomerRemit100",
	"CustomerPayerIdentifier": "CustomerPayer1",
	"CustomerPaymentAmount": "100000",
	"CustomerCurrency": "USD",
	"Messages": [
		{
			"Code": "TI-TXT-012013",
			"Type": "INFO",
			"Message": "Remittance Advice 0620062214281851 posted"
		}
	],
	"Items": [
		{
			"CustomerNetPaymentAmount": "20000",
			"SupplierFinancialDocumentIdentifier": "1234567890",
			"CustomerFinancialDocumentIdentifier": "CustomerDoc123"
		},
		{
			"CustomerNetPaymentAmount": "30000",
			"SupplierFinancialDocumentIdentifier": "1234567891",
			"CustomerFinancialDocumentIdentifier": "CustomerDoc124"
		},
		{
			"CustomerNetPaymentAmount": "50000",
			"SupplierFinancialDocumentIdentifier": "1234567892",
			"CustomerFinancialDocumentIdentifier": ""
		}
	]
}

手順 12：技術サポートの検索場所

技術サポートの詳細については、TI E2E™ 設計サポート・フォーラム (一部は英語) を参照するか、質問を投稿してください。