概要
TI 注残 API スイートを使用して開発を開始するには、以下の手順に従います。
- アクセスと開発の前提条件を満たします
- 顧客識別コードを受け取ります
- 注残 API スイートを使用する場合の標準的な注文フローを確認します
- 認証を受け、アクセス・トークンを受け取ります
- TI 製品の見積もりを作成して取得する方法を確認します
- テスト用のご注文を作成する方法を確認します
- 貴社の注文情報にアクセスする方法を確認します
- 1 件のご注文に変更を加える方法を確認します
- 配送状況の追跡情報を取得する方法を確認します
- 各財務資料を検索取得する方法を確認します
- 送金通知の作成方法を確認します
- サポートを利用
手順 1：オンボーディング (研修と登録) プロセスのセットアップと再検討に関する前提条件
注残 API スイートを使用してアプリケーションを開発することができるのは、承認を受けた顧客のみです。承認を取得する方法：
- myTI アカウントを作成するか、既存の myTI アカウントにログインします
- 貴殿の myTIアカウントを法人アカウントに関連付けます
- API ポータルにログインします
- 顧客のオンボーディング (研修と登録) プロセスを確認します
- 顧客のオンボーディング (研修と登録) フォームを送信し、確認します
- 貴社の社内システムで TI をベンダとしてセットアップします
- 業務とプロセスに関する知識については、API 業務ガイドブックをご覧ください
ステップ 2：顧客識別コードを受け取ります
- 顧客のオンボーディング (研修と登録) フォームへの入力と送信が完了した後、TI は貴社サイトの顧客識別コードを提供します。これらのコードの用途は、注文、注文の変更、見積もりに関して、注残 API のコネクティビティ (相互連絡) を確立することです。これらのコードは、顧客宛に送信されるさまざまな発信文書にも記載されます。
- ship-to code (出荷先コード) は、TI の製品出荷先の場所に対応します
- end customer identification code (最終顧客識別コード) は、承認済みの委託製造業者 (CM)、または他の顧客の代理で購入を行う顧客のみを対象としています
- 銀行の詳細を記載した TI のベンダ情報は、E メール通知の一部として、customer identification code (顧客識別コード) とともに提示されます
- 顧客は、付属の PDF を使用して、TI のベンダ情報と財務情報にアクセスすることができます。貴社のシステム内でベンダのセットアップを容易に実行できるように、これらの情報を提供しています。この PDF は、TI の郵送先住所、NAICS コード (北米産業分類の業種別コード)、米連邦納税登録番号、年間売上高、標準的なお支払い情報を記載しています。この PDF は、TI の年次報告書、シティズンシップ・レポート、品質認証へのリンクも掲載しています。顧客のオンボーディング (研修と登録) フォームに対する応答によっては、貴社がベンダをセットアップする際に使用できるように、TI はこの E メール通知の中で TI の取引銀行が属する国や地域を記載しています。
手順 3：ご注文フローの概要
- TI 標準の API 形式は、検索取得型です。プッシュ型 API をご希望の場合、 API 業務ガイドブックをご覧ください。
- 貴社への割り当て済み API キーとシークレットを使用して、認証を受けます
- 見積もり要求を作成できない場合、貴社がご注文を予定しているパーツが、貴社と TI の価格設定契約に掲載されていることを確認します
- 希望するペイロードを使用してご注文を作成し、注残向け注文 API に送信 (post) します
- この API は、「201 Created」 (201 作成しました) ステータス・コードと、注文への受信確認を保持する JSON を作成して応答します
- 注残向け注文 API を使用して、ご注文の状況と注文に関する追加の詳細を問い合わせます
- ご注文の出荷が完了した後、高度配送通知 (ASN) 検索取得型 API を使用して配送状況の追跡を取得します。また、財務資料検索取得型 API を使用して、請求書を取得します
- 送金通知 API は必須です。送金情報を TI 宛に送信するには、送金通知 API を呼び出します
- これらのステップを実行するためのサンプル・コードに関心をお持ちですか？ TI のサンプル・コードをダウンロードします
手順 4：認証
TI API スイートのセキュリティを確保するために、OAuth 2.0 を使用しています。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 つの見積もり依頼を送信することができます。貴社は参照用の見積もり番号を受信します。 見積もりの要求を送信した後、見積もりの応答は通常、30 分 ～ 24 時間以内に生成されます。「quoteStatus」 (見積もりの状態) は、見積もり依頼が Accepted (受け付けられた)、Rejected (拒否された)、Changed (変更された) のどれであるかを示します。「status」 (ステータス) は、行項目が Pending (保留中)、Bid (入札中)、No Bid (入札なし) どれであるかを示します。 詳細については、注残の見積もり API ページをご覧ください。
見積もり作成を要求する例：
curl --request POST \
--url 'https://transact-pre.ti.com/v2/backlog/quotes' \
--header 'Authorization: Bearer {access_token}' \
--header 'Content-Type: application/json' \
--data-binary @- <<DATA
{
"quote": {
"customerQuoteNumber": "TEST-AW-20200224-G115",
"quoteReason": "CD",
"contactName": "John Smith",
"contactEmailAddress": "john-smith@test-customer123.com",
"contactPhoneNumber": "888-888-8888",
"endCustomerCompanyName": "Company XYZ",
"endCustomerNumber": "",
"endCustomerWebsite": "https://www.companyxyz.com",
"lineItems": [
{
"tiPartNumber": "SN74LS00N",
"quantity": 2500,
"requestedUnitPrice": 1.2,
"requestedUnitPriceCurrencyCode": "USD",
"competitorName": "Competitor N",
"competitorPartNumber": "SNKLLPO23",
"competitorUnitPrice": 1.43,
"competitorCurrencyCode": "USD"
}
]
}
}
DATA
見積もり作成に対する応答の例：
{
"customerQuoteNumber": "TEST-AW-20200224-G115",
"quoteNumber": "26645389",
"quoteReason": "CD",
"endCustomerCompanyName": "Company XYZ",
"quoteStatus": "Accept",
"quoteStartDate": "2023-03-28T00:00:00Z",
"quoteEndDate": "2023-09-24T00:00:00Z",
"lineItems": [
{
"tiLineItemNumber": 10,
"tiPartNumber": "SN74LS00N",
"quantity": 2500,
"requestedUnitPrice": 1.2,
"status": "Pending"
}
]
}
検索取得型の見積もり要求の例：
curl --request GET \
--url 'https://transact-pre.ti.com/v2/backlog/quotes/?quoteNumber={quoteNumber}' \
--header 'Authorization: Bearer {access_token}' \
検索取得型の見積もり応答の例：
{
"customerQuoteNumber": "TEST-AW-20200224-G115",
"quoteNumber": "26645389",
"quoteReason": "CD",
"endCustomerCompanyName": "Company XYZ",
"quoteStatus": "Accept",
"quoteStartDate": "2023-03-28T00:00:00Z",
"quoteEndDate": "2023-09-24T00:00:00Z",
"lineItems": [
{
"tiLineItemNumber": 10,
"tiPartNumber": "SN74LS00N",
"quantity": 2500,
"requestedUnitPrice": 1.2,
"status": "Pending"
}
]
}
ステップ 6：テスト用のご注文を作成
テスト用の注残向け注文は、正式運用開始前のテスト環境内でシミュレートされるもので、貴社のアプリケーション開発を支援することを特に意図しています。 返される情報は、デモを目的とするシミュレーションによるテスト・データであり、実際に処理された情報を表しているわけではありません。
テスト用の注残向け注文の作成 URL： https://transact-pre.ti.com/v2/backlog/orders (正式運用開始前)
- (テストまたは正式運用の) ご注文を確定できるのは、顧客が承認済みであり、セットアップをすでに構成済みで、オンボーディング (研修と登録) プロセスを完了した場合です。
- 顧客が注文の作成と変更両方のテストを正常に完了した後、API 業務ガイドブックのユーザー承認テストのシナリオに従ってテスト・フェーズを完了します。
正式運用の注残向け注文を行う準備ができた時点で、要求ペイロードの一部として送信しようとするすべてのパラメータを確認し、正式運用バージョンの認証に対応する URL と、注残向け注文の create API (URL：https://transact.ti.com/v1/oauth、および https://transact.ti.com/v2/backlog/orders) を使用します。 接続タイムアウトが発生している場合、特に注文の行項目が 30 個を上回っている場合、タイムアウト・エラーを避けるために接続タイムアウトを 5 分に設定することを推奨します。
テストと正式運用の各注文の詳細については、注残向け注文 API の資料ページをご覧ください。
注残向けテスト注文の作成を要求する例：
curl --request POST \
--url 'https://transact-pre.ti.com/v2/backlog/orders' \
--header 'Authorization: Bearer {access_token}' \
--header 'Content-Type: application/json' \
--data-binary @- <<DATA
{
"order": {
"customerPurchaseOrderNumber": "TestPO-230405-01",
"shipToAccountNumber": "12354978",
"endCustomerCompanyName": "Company B",
"lineItems": [
{
"customerLineItemNumber": "1",
"tiPartNumber": "SN7407N",
"customerPartNumber": "TILMNOP",
"customerAnticipatedUnitPrice": 0.30,
"customerCurrencyCode": "USD",
"schedules": [
{
"requestedQuantity": 2000,
"requestedDeliveryDate": "2023-05-01"
}
]
},
{
"customerLineItemNumber": "2",
"tiPartNumber": "DRV8304SRHAR",
"customerPartNumber": "TIABCDEF",
"customerAnticipatedUnitPrice": 1.00,
"customerCurrencyCode": "USD",
"schedules": [
{
"requestedQuantity": 5000,
"requestedDeliveryDate": "2023-06-01"
}
]
},
{
"customerLineItemNumber": "3",
"tiPartNumber": "SN7407DR",
"customerPartNumber": "TIABCDEF",
"customerAnticipatedUnitPrice": 0.22,
"customerCurrencyCode": "USD",
"schedules": [
{
"requestedQuantity": 7500,
"requestedDeliveryDate": "2023-06-01"
}
]
}
]
}
}
注残向けテスト注文の作成に対する応答の例：
{
"orders": [
{
"orderNumber": "1019621260",
"orderDate": "2023-04-05 14:31:16",
"customerPurchaseOrderNumber": "TestPO-230405-01",
"orderStatus": "OPEN",
"lineItems": [
{
"tiLineItemNumber": "000010",
"tiPartNumber": "SN7407N",
"customerLineItemNumber": "1",
"customerPartNumber": "TILMNOP",
"status": "Not Delivered",
"changeRequestWindow": "STD",
"tiTotalOrderItemQuantity": 2000,
"customerAnticipatedUnitPrice": "0.30",
"customerCurrencyCode": "USD",
"tiUnitPrice": 0.339,
"tiCurrencyCode": "USD",
"messages": [
{
"code": "TI-TXT-051",
"type": "INFO",
"message": "Customer expected price mismatch to TI customer direct price. To fix send PO change with correct price. For help: support.ti.com/csm"
},
{
"code": "TI-TXT-077",
"type": "INFO",
"message": "Customer Request Date is not the same as Estimated Delivery Date"
}
],
"schedules": [
{
"requestedQuantity": "2000",
"requestedDeliveryDate": "2023-05-01",
"confirmations": [
{
"tiScheduleLineNumber": "0002",
"scheduledQuantity": 2000,
"estimatedShipDate": "2024-07-24",
"estimatedDeliveryDate": "2024-07-29",
"shippedQuantity": 0
}
]
}
]
},
{
"tiLineItemNumber": "000020",
"tiPartNumber": "DRV8304SRHAR",
"customerLineItemNumber": "2",
"customerPartNumber": "TIABCDEF",
"status": "Not Delivered",
"changeRequestWindow": "STD",
"tiTotalOrderItemQuantity": 5000,
"customerAnticipatedUnitPrice": "1.00",
"customerCurrencyCode": "USD",
"tiUnitPrice": 1.08,
"tiCurrencyCode": "USD",
"messages": [
{
"code": "TI-TXT-051",
"type": "INFO",
"message": "Customer expected price mismatch to TI customer direct price. To fix send PO change with correct price. For help: support.ti.com/csm"
},
{
"code": "TI-TXT-077",
"type": "INFO",
"message": "Customer Request Date is not the same as Estimated Delivery Date"
}
],
"schedules": [
{
"requestedQuantity": "5000",
"requestedDeliveryDate": "2023-06-01",
"confirmations": [
{
"tiScheduleLineNumber": "0002",
"scheduledQuantity": 5000,
"estimatedShipDate": "2024-07-24",
"estimatedDeliveryDate": "2024-07-29",
"shippedQuantity": 0
}
]
}
]
},
{
"tiLineItemNumber": "000030",
"tiPartNumber": "SN7407DR",
"customerLineItemNumber": "3",
"customerPartNumber": "TIABCDEF",
"status": "Not Delivered",
"changeRequestWindow": "STD",
"tiTotalOrderItemQuantity": 7500,
"customerAnticipatedUnitPrice": "0.22",
"customerCurrencyCode": "USD",
"tiUnitPrice": 0.266,
"tiCurrencyCode": "USD",
"messages": [
{
"code": "TI-TXT-051",
"type": "INFO",
"message": "Customer expected price mismatch to TI customer direct price. To fix send PO change with correct price. For help: support.ti.com/csm"
},
{
"code": "TI-TXT-077",
"type": "INFO",
"message": "Customer Request Date is not the same as Estimated Delivery Date"
}
],
"schedules": [
{
"requestedQuantity": "7500",
"requestedDeliveryDate": "2023-06-01",
"confirmations": [
{
"tiScheduleLineNumber": "0002",
"scheduledQuantity": 7500,
"estimatedShipDate": "2024-07-24",
"estimatedDeliveryDate": "2024-07-29",
"shippedQuantity": 0
}
]
}
]
}
]
}
]
}
ステップ 7：ご注文の詳細を照会
注残向け注文の取得検索型 API を使用すると、顧客の注文書番号または TI の注文番号を使用して、注文の詳細にアクセスすることができます。 注文と、利用可能な注文の詳細については、注残向け注文 API の資料ページをご覧ください。
顧客の注文書番号を使用して注文の詳細を検索取得する例：
curl --request GET \
--url https://transact-pre.ti.com/v2/backlog/orders?customerPurchaseOrderNumber=TestPO-001' \
--header 'Authorization: Bearer {access_token}' \
--header 'Content-Type: application/json' \
--data-binary @- <<DATA
サプライヤの注文番号を使用して注文の詳細を検索取得する例：
curl --request GET \
--url ' https://transact-pre.ti.com/v2/backlog/orders?orderNumber=1019611092' \
--header 'Authorization: Bearer {access_token}' \
--header 'Content-Type: application/json' \
--data-binary @- <<DATA
応答の例：
{
"orders": [
{
"orderNumber": "1019610866",
"orderDate": "2023-04-03 13:44:58",
"customerPurchaseOrderNumber": "TestPO-001",
"orderStatus": "OPEN",
"shipToAccountNumber": "183290",
"lineItems": [
{
"tiLineItemNumber": "000010",
"tiPartNumber": "SN7407N",
"customerLineItemNumber": "1",
"customerPartNumber": "TILMNOP",
"status": "Not Delivered",
"changeRequestWindow": "STD",
"tiTotalOrderItemQuantity": 2000,
"customerAnticipatedUnitPrice": "0.30",
"customerCurrencyCode": "USD",
"tiUnitPrice": 0.00,
"tiCurrencyCode": "JPY",
"messages": [
{
"code": "TI-TXT-005",
"type": "INFO",
"message": "Pricing could not be determined"
},
{
"code": "TI-TXT-077",
"type": "INFO",
"message": "Customer Request Date is not the same as Estimated Delivery Date"
}
],
"schedules": [
{
"requestedQuantity": 2000,
"requestedDeliveryDate": "2023-05-01",
"confirmations": [
{
"tiScheduleLineNumber": "0002",
"scheduledQuantity": 2000,
"estimatedShipDate": "2024-07-22",
"estimatedDeliveryDate": "2024-07-22",
"shippedQuantity": 0
}
]
}
]
},
{
"tiLineItemNumber": "000020",
"tiPartNumber": "DRV8304SRHAR",
"customerLineItemNumber": "2",
"customerPartNumber": "TIABCDEF",
"status": "Not Delivered",
"changeRequestWindow": "STD",
"tiTotalOrderItemQuantity": 5000,
"customerAnticipatedUnitPrice": "1.00",
"customerCurrencyCode": "USD",
"tiUnitPrice": 0.00,
"tiCurrencyCode": "JPY",
"messages": [
{
"code": "TI-TXT-005",
"type": "INFO",
"message": "Pricing could not be determined"
},
{
"code": "TI-TXT-077",
"type": "INFO",
"message": "Customer Request Date is not the same as Estimated Delivery Date"
}
],
"schedules": [
{
"requestedQuantity": 5000,
"requestedDeliveryDate": "2023-06-01",
"confirmations": [
{
"tiScheduleLineNumber": "0002",
"scheduledQuantity": 5000,
"estimatedShipDate": "2024-07-22",
"estimatedDeliveryDate": "2024-07-22",
"shippedQuantity": 0
}
]
}
]
},
{
"tiLineItemNumber": "000030",
"tiPartNumber": "SN7407DR",
"customerLineItemNumber": "3",
"customerPartNumber": "TIABCDEF",
"status": "Not Delivered",
"changeRequestWindow": "STD",
"tiTotalOrderItemQuantity": 7500,
"customerAnticipatedUnitPrice": "0.22",
"customerCurrencyCode": "USD",
"tiUnitPrice": 0.00,
"tiCurrencyCode": "JPY",
"messages": [
{
"code": "TI-TXT-005",
"type": "INFO",
"message": "Pricing could not be determined"
},
{
"code": "TI-TXT-077",
"type": "INFO",
"message": "Customer Request Date is not the same as Estimated Delivery Date"
}
],
"schedules": [
{
"requestedQuantity": 7500,
"requestedDeliveryDate": "2023-06-01",
"confirmations": [
{
"tiScheduleLineNumber": "0002",
"scheduledQuantity": 7500,
"estimatedShipDate": "2024-04-08",
"estimatedDeliveryDate": "2024-04-08",
"shippedQuantity": 0
}
]
}
]
}
]
},
{
"orderNumber": "1019620643",
"orderDate": "2023-04-03 13:44:58",
"customerPurchaseOrderNumber": "TestPO-001",
"orderStatus": "OPEN",
"shipToAccountNumber": "183290",
"lineItems": [
{
"tiLineItemNumber": "000010",
"tiPartNumber": "SN7407N",
"customerLineItemNumber": "1",
"customerPartNumber": "TILMNOP",
"status": "Not Delivered",
"changeRequestWindow": "STD",
"tiTotalOrderItemQuantity": 2000,
"customerAnticipatedUnitPrice": "0.30",
"customerCurrencyCode": "USD",
"tiUnitPrice": 0.00,
"tiCurrencyCode": "JPY",
"messages": [
{
"code": "TI-TXT-005",
"type": "INFO",
"message": "Pricing could not be determined"
},
{
"code": "TI-TXT-077",
"type": "INFO",
"message": "Customer Request Date is not the same as Estimated Delivery Date"
}
],
"schedules": [
{
"requestedQuantity": 2000,
"requestedDeliveryDate": "2023-05-01",
"confirmations": [
{
"tiScheduleLineNumber": "0002",
"scheduledQuantity": 2000,
"estimatedShipDate": "2024-07-22",
"estimatedDeliveryDate": "2024-07-22",
"shippedQuantity": 0
}
]
}
]
},
{
"tiLineItemNumber": "000020",
"tiPartNumber": "DRV8304SRHAR",
"customerLineItemNumber": "2",
"customerPartNumber": "TIABCDEF",
"status": "Not Delivered",
"changeRequestWindow": "STD",
"tiTotalOrderItemQuantity": 5000,
"customerAnticipatedUnitPrice": "1.00",
"customerCurrencyCode": "USD",
"tiUnitPrice": 0.00,
"tiCurrencyCode": "JPY",
"messages": [
{
"code": "TI-TXT-005",
"type": "INFO",
"message": "Pricing could not be determined"
},
{
"code": "TI-TXT-077",
"type": "INFO",
"message": "Customer Request Date is not the same as Estimated Delivery Date"
}
],
"schedules": [
{
"requestedQuantity": 5000,
"requestedDeliveryDate": "2023-06-01",
"confirmations": [
{
"tiScheduleLineNumber": "0002",
"scheduledQuantity": 5000,
"estimatedShipDate": "2024-07-22",
"estimatedDeliveryDate": "2024-07-22",
"shippedQuantity": 0
}
]
}
]
},
{
"tiLineItemNumber": "000030",
"tiPartNumber": "SN7407DR",
"customerLineItemNumber": "3",
"customerPartNumber": "TIABCDEF",
"status": "Not Delivered",
"changeRequestWindow": "STD",
"tiTotalOrderItemQuantity": 7500,
"customerAnticipatedUnitPrice": "0.22",
"customerCurrencyCode": "USD",
"tiUnitPrice": 0.00,
"tiCurrencyCode": "JPY",
"messages": [
{
"code": "TI-TXT-005",
"type": "INFO",
"message": "Pricing could not be determined"
},
{
"code": "TI-TXT-077",
"type": "INFO",
"message": "Customer Request Date is not the same as Estimated Delivery Date"
}
],
"schedules": [
{
"requestedQuantity": 7500,
"requestedDeliveryDate": "2023-06-01",
"confirmations": [
{
"tiScheduleLineNumber": "0002",
"scheduledQuantity": 7500,
"estimatedShipDate": "2024-04-08",
"estimatedDeliveryDate": "2024-04-08",
"shippedQuantity": 0
}
]
}
]
}
]
}
]
}
ステップ 8：1 件のご注文に変更を加える方法を確認します
注文の変更要求のペイロードで使用する注文の主なデータ・フィールドは、元の注文要求と完全に一致している必要があります。以下のフィールドが該当します。
- customerPurchaseOrderNumber (顧客注文書の番号)
- customerLineItemNumber (顧客の行項目番号)
- tiPartNumber (TI 製品型番)
貴社の API テスト・コードを使用して変更注文 API をテストする方法については、API support にお問い合わせください。
テスト用の注文要求の例：
{
"order": {
"customerPurchaseOrderNumber": "TestPO-230401-01",
"shipToAccountNumber": "111111",
"endCustomerCompanyName": "Company B",
"lineItems": [
{
"customerLineItemNumber": "1",
"tiPartNumber": "SN7407N",
"customerPartNumber": "TILMNOP",
"customerAnticipatedUnitPrice": 0.30,
"customerCurrencyCode": "USD",
"schedules": [
{
"requestedQuantity": 2000,
"requestedDeliveryDate": "2023-05-01"
}
]
}
]
}
}
テスト用の注残向け注文の変更 URL を使用して、注文の変更に関する以下のシナリオのいずれかをテストします。https://transact-pre.ti.com/v2/backlog/orders/customerPurchaseOrderNumber (正式運用前)
- 顧客要求日の変更 - CustomerItemChangeIndicator を「U」に設定し、必要に応じて CustomerRequestedDate を変更します。
- 顧客要求数量の変更 - CustomerItemChangeIndicator を「U」に設定し、必要に応じて CustomerRequestedQuanity を変更します
- 顧客が期待する単価 (+/-)：CustomerItemChangeIndicator を「U」に設定し、必要に応じて CustomerExpectedUnitPrice を変更します
注文の変更要求の例に変更を加えたもの：
curl --request GET \
--url 'https://transact-pre.ti.com/v2/backlog/orders/customerPurchaseOrderNumber' \
--header 'Authorization: Bearer {access_token}' \
--header 'Content-Type: application/json' \
--data-binary @- <<DATA
{
"order": {
"customerPurchaseOrderNumber": "TestPO-230401-01",
"shipToAccountNumber": "111111",
"endCustomerCompanyName": "Company B",
"lineItems": [
{
"customerLineItemNumber": "1",
"lineItemChangeIndicator": "U",
"tiPartNumber": "SN7407N",
"customerPartNumber": "TILMNOP",
"customerAnticipatedUnitPrice": 0.30,
"customerCurrencyCode": "USD",
"schedules": [
{
"requestedQuantity": 2000,
"requestedDeliveryDate": "2023-06-15"
}
]
}
]
}
}
DATA
テスト用の注残向け注文の変更を使用して、注文をキャンセルする方法。URL：https://transact-pre.ti.com/v2/backlog/orders/customerPurchaseOrderNumber (正式運用開始前)
- テスト用のご注文をキャンセルするシナリオ - 注文全体をキャンセルするには、その注文内にあるすべての項目 (1 ～ n) に対して CustomerItemChangeIndicator を「X」に設定する必要があります。個別の項目をキャンセルするには、キャンセルしようとする項目のみを列挙し、CustomerItemChangeIndicator を「X」に設定します。ご注文に残そうとする他のすべての項目は、列挙から除外します。
キャンセルを目的とするご注文の変更の例に変更を加えたもの：
curl --request GET \
--url 'https://transact-pre.ti.com/v2/backlog/orders/customerPurchaseOrderNumber' \
--header 'Authorization: Bearer {access_token}' \
--header 'Content-Type: application/json' \
--data-binary @- <<DATA
{
"order": {
"customerPurchaseOrderNumber": "TestPO-230401-01",
"shipToAccountNumber": "111111",
"endCustomerCompanyName": "Company B",
"lineItems": [
{
"customerLineItemNumber": "1",
"lineItemChangeIndicator": "X",
"tiPartNumber": "SN7407N",
"customerPartNumber": "TILMNOP",
"customerAnticipatedUnitPrice": 0.30,
"customerCurrencyCode": "USD",
"schedules": [
{
"requestedQuantity": 2000,
"requestedDeliveryDate": "2023-06-15"
}
]
}
]
}
}
DATA
ステップ 9：配送状況の追跡情報を取得する方法を確認します。
ご注文の梱包後、TI は出荷の準備ができた時点で、高度配送通知 (ASN) API を通じてアクセス可能な配送追跡情報を生成します。この応答は、配送追跡番号、配送業者情報、商用請求書など、顧客宛ての配送に関する詳細情報を格納しています。この API は、プッシュ型または 検索取得型の実装で利用できます。 貴社の API テスト・コードを使用して ASN をテストする方法の詳細については、 API support (英語) にお問い合わせください。
検索取得に対応する要求の例：
curl --request GET \
--url https://transact-pre.ti.com/v2/backlog/advanced-shipment-notices?orderNumber=1111111111111' \
--header 'Authorization: Bearer {access_token}' \
応答の例：
{
"orderNumber": "1111111111111",
"data": {
"consolidatedInformation": [
{
"estimatedDateOfArrival": "2023-03-28",
"goodsIssueDate": "2023-03-23",
"numberOfPallet": "1",
"grossWeight": "1.200",
"grossWeightUnitOfMeasure": "KG",
"numberOfPieces": "1",
"netWeight": "8.100",
"netWeightUnitOfMeasure": "KG",
"carrierShipmentMasterTrackingNumber": "30000001999999",
"shippingDate": "2023-03-23",
"shippingPoint": "9920",
"shippingCondition": "EF",
"modeOfTransport": "05",
"buyerCode": "999999",
"shipTrackReference": "30000001199999",
"wayBillNumberList": [
{
"wayBillNumber": "0423599999",
"creationDate": "2023-03-23",
"creationTime": "13:20:27"
}
],
"commercialInvoiceList": [
{
"commercialInvoiceNumber": "54901999999",
"invoiceDate": "2023-03-23",
"invoiceTime": "13:21:43",
"incotermCode": "FCA",
"incotermDescription": "BUYER'S FORWARDER",
"invoiceValue": "5000.000",
"currency": "USD"
}
],
"shipToDetails": {
"plantIdentifier": "0000111111",
"companyName": "ACME WIDGET SOLUTIONS INC",
"address1": "1234 MAIN ST",
"city": "ELDARADO",
"stateRegion": "TX",
"postalCode": "99999-9999",
"countryCode": "US",
"companyNameAdditionalDetail": "ACME SHIPPING DEPOT ORGANIZATIONS"
},
"shipFromDetails": {
"plantIdentifier": "9990",
"companyName": "Texas Instruments Southeast Asia PL",
"contactName": "GEROGE",
"address1": "No. 56, ACORN Avenue",
"city": "Singapore",
"stateRegion": "SGP",
"postalCode": "99999",
"countryCode": "SG"
},
"crossDockDetails": {
"plantIdentifier": "0000999999"
},
"manifestIdentifierList": {
"manifestIdentifier": "009999999"
},
"bookingOrderDetails": [
{
"customerPurchaseOrderNumber": "ABCD_9of10",
"purchaseOrderDate": "2023-01-13",
"passThrus": [
{
"orderNumber": "1019609117",
"passThru1": "ZHIC*00001*BP=0000111111",
"passThru2": "ZHIC*00002*AG=111111",
"passThru3": "ZHIC*00003*WE=111111"
}
],
"packageDetails": [
{
"packageHandlingUnitNumber": "0046677747",
"packageContainerVolume": "2.116",
"packageContainerVolumeUnitOfMeasure": "CDM",
"packageLength": "23.000",
"packageWidth": "23.000",
"packageHeight": "4.000",
"unitOfMeasure": "CM",
"trackingNumber": "30000001144761",
"numberOfLineItems": "1",
"netWeight": "8.100",
"grossWeight": "1.199",
"weightUnitOfMeasure": "KG",
"itemDetails": [
{
"tiPartNumber": "SN74LS00N",
"tiPartDescription": "QUAD 2-INPUT NAND GATE",
"deliveryLineItemNumber": "000010",
"deliveryDocumentNumber": "0620549184",
"orderNumber": "1019609117",
"lineItemNumber": "000010",
"customerPurchaseOrderNumber": "ABCD_9of10",
"customerLineItemNumber": "1",
"purchaseOrderDate": "2023-01-13",
"numberOfUnitsShipped": "0000005000",
"baseUnitOfMeasure": "EA",
"grossWeight": "1.199",
"netWeight": "8.100",
"weightUnitOfMeasure": "KG",
"commercialInvoiceNumber": "5490149743",
"commercialInvoiceItem": "000001",
"commercialInvoiceUnitprice": "1.000000",
"commercialInvoiceValue": "5000.000000",
"commercialInvoiceCurrency": "USD",
"countryOfOriginCode": "CN",
"countryOfOriginDescription": "China",
"assemblyCountryOfOriginCode3Character": "CHN",
"assemblyCountryOfOriginCode2Character": "CN",
"assemblyCountryOfOriginDescription": "China",
"harmonizedTariffScheduleExportCode": "85423900",
"harmonizedTariffScheduleExportDescription": "OTHER ELECTRONIC INTEGRATED CIRCUITS (MIL)",
"harmonizedTariffScheduleImportCode": "8542390001",
"harmonizedTariffScheduleImportDescription": "Electronic integrated circuits Other",
"confirmDate": "2023-03-23",
"orderType": "TA",
"deliveryLineItemTotalQuantity": "5000.000",
"deliveryLineItemTotalQuantityUnitOfMeasure": "EA",
"goodsIssueDate": "2023-03-23",
"goodsIssueTime": "13:21:48",
"shipTrackCodeList": [
{
"shipTrackCode": "0444872ZFV",
"chipCountryOfOriginCode3Character": "CHN",
"chipCountryOfOriginCode2Character": "CN",
"chipCountryOfOriginDescription": "China",
"shipTrackCodeQuantity": "0000005000",
"batchNumber": "1100044LGH",
"shipDate": "2023-03-23",
"dateCode": "2303+5"
}
]
}
]
}
]
}
]
}
]
}
}
ステップ 10： 各財務資料を検索取得する方法を確認します
財務文書 API は、お支払いに関する請求書情報を提供します。財務資料 API を使用して請求書を検索取得するには、注文番号、財務資料番号、配送番号、顧客の注文書番号のいずれかが必要です。 日付範囲を指定してクエリを実行する場合、開始日と終了日は請求書の作成日を意味します。財務資料は、TI が出荷を処理した後に入手可能になります。 この API は、 プッシュ型 、または 検索取得型 どちらかの実装が可能です。
PDF を検索取得するには、構成オプションに関する資料をご覧ください。
貴社の API テスト・コードを使用して財務資料 API による検索取得をテストする方法の詳細については、 API support (英語) にお問い合わせください。
例：
curl --request GET \
--url 'https://transact-pre.ti.com/v2/backlog/financial-documents?orderNumber=1111111111111' \
--header 'Authorization: Bearer {access_token}' \
応答の例：
{
"orderNumber": "1111111111111",
"totalNumberOfDocuments": "2",
"documents": [
{
"documentType": "INVOICE",
"financialDocumentNumber": "1111111111111",
"documentCreatedDate": "2023-03-23",
"status": "CLEARED",
"currencyCode": "USD",
"customerPurchaseOrderNumber": "PO_10of10",
"customerReferenceNumber": "1111111111111",
"grossWeight": "8100.000",
"netWeight": "8100.000",
"weightUnit": "GRM",
"carrier": "DHL WORLDWIDE EXPRESS",
"documentValue": {
"totalAmount": "5,312.50"
},
"salesOrder": {
"orderNumber": "1111111111111",
"lineItemNumber": "000000",
"customerPurchaseOrderNumber": "PO_10of10",
"purchaseOrderDate": "2023-01-13"
},
"paymentTerms": {
"incoterms1": "FCA",
"incoterms2": "BUYER'S FORWARDER",
"termsOfDelivery": "FCA BUYER'S FORWARDER",
"termsOfPayment": "Net 45 Days from Invoice Date",
"paymentTermsText": [
{
"SupplierPaymentTermsText": "Up to 05/07/2023 without deduction"
}
]
},
"delivery": {
"deliveryNumber": "1111111111111",
"deliveryLineItemNumber": "000000",
"deliveryDate": "2023-04-02",
"goodsMovementDate": "2023-03-23"
},
"waybill": {
"waybillNumber": "1111111111111",
"containerIdentifier": "30000001144761",
"numberOfBoxes": "1"
},
"partners": [
{
"partnerTypeDescription": "Sender",
"name1": "Texas Instruments Incorporated",
"name2": "Semiconductor",
"streetAddress": "12500 TI Boulevard",
"city": "Dallas",
"stateRegion": "TX",
"postalCode": "75243",
"countryCode": "US"
},
{
"partnerTypeDescription": "Remit To",
"name1": "For ACH Transfer send to:",
"name2": "Texas Instruments, c/o Bank of TI",
"name3": "Bank Acct 12345987",
"name4": "ABA 111111111",
"city": "DALLAS",
"stateRegion": "TX",
"postalCode": "75202",
"countryCode": "US"
},
{
"partnerTypeDescription": "Sold-to Party",
"partnerIdentifier": "1111111",
"name1": "ACME WIDGETS INC",
"name2": " ACME WIDGETS SHIPPING DEPOT ORGANIZATIONS",
"streetAddress": "123 MAIN ST",
"city": "ELDARADO",
"stateRegion": "TX",
"postalCode": "12345-1234",
"countryCode": "US"
},
{
"partnerTypeDescription": "Bill-to Party",
"name1": "ACME WIDGETS INC",
"name2": " ACME WIDGETS SHIPPING DEPOT ORGANIZATIONS",
"streetAddress": "123 MAIN ST",
"city": "ELDARAOD",
"stateRegion": "TX",
"postalCode": "12345-1234",
"countryCode": "US"
},
{
"partnerTypeDescription": "Ship-to Party",
"partnerIdentifier": "11111",
"name1": "ACME WIDGETS INC",
"name2": " ACME WIDGETS SHIPIPING DEPOT ORGANIZATIONS",
"streetAddress": "123 MAIN ST",
"city": "ELDAROAD",
"stateRegion": "TX",
"postalCode": "12345-1234",
"countryCode": "US"
}
],
"items": [
{
"lineItemNumber": "000010",
"tiPartNumber": "SN74LS00N",
"tiPartDescription": "QUAD 2-INPUT NAND GATE",
"quantity": "5000.000",
"unitPrice": "1.00",
"netPrice": "5,000.00",
"grossWeight": "8100.000",
"netWeight": "8100.000",
"commercialInvoiceNumber": "5490149745",
"salesOrder": {
"orderNumber": "1111111111111",
"lineItemNumber": "000010",
"customerPurchaseOrderNumber": "PO_10of10",
"customerPurchaseOrderLineItemNumber": "1",
"purchaseOrderDate": "2023-01-13"
},
"delivery": {
"deliveryNumber": "0620549185",
"deliveryLineItemNumber": "000010",
"deliveryDate": "2023-04-02",
"goodsMovementDate": "2023-03-23",
"grossWeight": "8100.000",
"netWeight": "8100.000"
},
"itemVAT": [
{
"taxIndicator": "O1",
"taxRate": "6.250",
"taxAmount": "312.50",
"taxJurisdiction": "USIL0000000000"
},
{
"taxIndicator": "O1",
"taxRate": "0.000",
"taxAmount": "0.00",
"taxJurisdiction": "USIL6012400000"
},
{
"taxIndicator": "O1",
"taxRate": "0.000",
"taxAmount": "0.00",
"taxJurisdiction": "USIL6012478340"
},
{
"taxIndicator": "O1",
"taxRate": "0.000",
"taxAmount": "0.00",
"taxJurisdiction": "USIL6012478340"
},
{
"taxIndicator": "O1",
"taxRate": "0.000",
"taxAmount": "0.00",
"taxJurisdiction": "USIL6012478340"
},
{
"taxIndicator": "O1",
"taxRate": "0.000",
"taxAmount": "0.00",
"taxJurisdiction": "USIL6012478340"
}
]
}
]
},
{
"documentType": "CREDIT NOTE",
"financialDocumentNumber": "11111111111",
"documentCreatedDate": "2023-03-29",
"status": "CLEARED",
"currencyCode": "USD",
"customerPurchaseOrderNumber": "PO_10of10",
"customerReferenceNumber": "11111111",
"grossWeight": "8100.000",
"netWeight": "8100.000",
"weightUnit": "GRM",
"carrier": "SEE CARRIER REFERENCE TABLE",
"documentValue": {
"totalAmount": "531.25"
},
"salesOrder": {
"orderNumber": "1111111111",
"lineItemNumber": "000000",
"customerPurchaseOrderNumber": "PO_10of10"
},
"paymentTerms": {
"incoterms1": "FCA",
"incoterms2": "TI's POINT OF SHIPMENT",
"termsOfDelivery": "FCA TI's POINT OF SHIPMENT",
"termsOfPayment": "Net 45 Days from Invoice Date",
"paymentTermsText": [
{
"SupplierPaymentTermsText": "Up to 05/13/2023 without deduction"
}
]
},
"delivery": {
"deliveryLineItemNumber": "000000"
},
"partners": [
{
"partnerTypeDescription": "Sender",
"name1": "Texas Instruments Incorporated",
"name2": "Semiconductor",
"streetAddress": "12500 TI Boulevard",
"city": "Dallas",
"stateRegion": "TX",
"postalCode": "75243",
"countryCode": "US"
},
{
"partnerTypeDescription": "Remit To",
"name1": "For ACH Transfer send to:",
"name2": "Texas Instruments, c/o Bank of TI",
"name3": "Bank Acct 123456879",
"name4": "ABA 111111111",
"city": "DALLAS",
"stateRegion": "TX",
"postalCode": "75202",
"countryCode": "US"
},
{
"partnerTypeDescription": "Sold-to Party",
"partnerIdentifier": "111111",
"name1": "ACME WIDGETS INC",
"name2": "ACME WIDGETS SHIPPING DEPOT ORGANIZATIONS",
"streetAddress": "1234 MAIN ST",
"city": "ELDARADO",
"stateRegion": “TX”,
"postalCode": "12345-1234",
"countryCode": "US"
},
{
"partnerTypeDescription": "Bill-to Party",
"name1": "ACME WIDGETS INC",
"name2": "ACME WIDGETS SHIPPING DEPOT ORGANIZATIONS",
"streetAddress": "1234 MAIN ST",
"city": "ELDARADO",
"stateRegion": “TX”,
"postalCode": "12345-1234",
"countryCode": "US"
},
{
"partnerTypeDescription": "Ship-to Party",
"partnerIdentifier": "111111",
"name1": "ACME WIDGETS INC",
"name2": "ACME WIDGETS SHIPPING DEPOT ORGANIZATIONS",
"streetAddress": "1234 MAIN ST",
"city": "ELDARADO",
"stateRegion": “TX”,
"postalCode": "12345-1234",
"countryCode": "US"
}
],
"items": [
{
"lineItemNumber": "000010",
"tiPartNumber": "SN74LS00N",
"tiPartDescription": "QUAD 2-INPUT NAND GATE",
"quantity": "5000.000",
"unitPrice": "0.10",
"netPrice": "500.00",
"grossWeight": "8100.000",
"netWeight": "8100.000",
"salesOrder": {
"orderNumber": "1111111111",
"lineItemNumber": "000010",
"customerPurchaseOrderNumber": "PO_10of10",
"customerPurchaseOrderLineItemNumber": "00010"
},
"delivery": {
"deliveryLineItemNumber": "000000"
},
"itemVAT": [
{
"taxIndicator": "O1",
"taxRate": "6.250",
"taxAmount": "31.25",
"taxJurisdiction": "USIL0000000000"
},
{
"taxIndicator": "O1",
"taxRate": "0.000",
"taxAmount": "0.00",
"taxJurisdiction": "USIL6012400000"
},
{
"taxIndicator": "O1",
"taxRate": "0.000",
"taxAmount": "0.00",
"taxJurisdiction": "USIL6012478340"
},
{
"taxIndicator": "O1",
"taxRate": "0.000",
"taxAmount": "0.00",
"taxJurisdiction": "USIL6012478340"
},
{
"taxIndicator": "O1",
"taxRate": "0.000",
"taxAmount": "0.00",
"taxJurisdiction": "USIL6012478340"
},
{
"taxIndicator": "O1",
"taxRate": "0.000",
"taxAmount": "0.00",
"taxJurisdiction": "USIL6012478340"
}
]
}
]
}
]
}
手順 11：送金通知を作成
顧客のシステムは、送金通知 API を呼び出し、 送金情報を送信して、TI のエンタープライズ・システム内に送金通知記録を作成することができます。
各要求に、ヘッダーと項目の両方のセクションを記述する必要があります。 ヘッダー・セクションには、顧客の送金通知と通貨コード情報が記載されています。 項目セクションには、具体的な支払い情報とそれに関連する財務資料情報を含め、1 つまたは任意の数の詳細なレコードを記述することができます。詳細については、 注残送金通知 API ページをご覧ください。
要求の例：
curl --request POST \
--url 'https://transact-pre.ti.com/v2/backlog/remittance-advice' \
--header 'Authorization: Bearer {access_token}' \
--header 'Content-Type: application/json' \
--data-binary @- <<DATA
{
"remittanceAdviceNumber": "CustomerRemit100",
"currencyCode": "USD",
"lineItems": [
{
"paymentAmount": "2000",
"financialDocumentNumber": "1234567890"
},
{
"paymentAmount": "200",
"financialDocumentNumber": "234567890"
}
]
}
DATA
応答の例：
{
"supplierRemittanceAdviceIdentifier": "06CustomerRemit1",
"remittanceAdviceNumber": "CustomerRemit100",
"currencyCode": "USD",
"message": [
{
"code": "TI-TXT-012013",
"type": "SUCCESS",
"message": "Remittance Advice 06CustomerRemit1 posted."
}
],
"lineItems": [
{
"paymentAmount": "2000",
"financialDocumentNumber": "1234567890"
},
{
"paymentAmount": "200",
"financialDocumentNumber": "234567890"
}
]
}
手順 12：技術サポートの検索場所
技術サポートの詳細については、TI E2E™ 設計サポート・フォーラム (一部は英語) を参照するか、質問を投稿してください。