概覽
若要開始使用 TI 未交貨訂單 API 套件,請依照下列步驟執行:
- 符合存取和開發的先決條件
- 接收客戶身分代碼
- 使用未交貨訂單 API 套件檢閱一般訂購流程
- 驗證以接收存取權杖
- 了解如何建立及擷取 TI 產品的報價單
- 了解如何建立測試訂單
- 了解如何存取您的訂單資訊
- 了解如何變更訂單
- 了解如何擷取出貨追蹤
- 了解如何擷取財務文件
- 了解如何建立匯款通知
- 取得支援
步驟 1:設定與檢閱上線序的先決條件
只有經核准的客戶才能使用未交貨訂單 API 套件建置應用程式。獲得核准:
- 建立 myTI 帳戶或登入您現有的 myTI 帳戶
- 將您的 myTI 帳戶與公司帳戶建立關聯
- 登入 API 入口網站
- 檢閱客戶上線流程
- 提交客戶上線表單並檢閱
- 在您的內部系統中將 TI 設定爲廠商
- 檢閱 API 業務指南中的業務和流程相關知識
步驟 2:接收客戶身分代碼
- 填寫客戶上線表單後,TI 將提供您所在網站的客戶身分代碼。這些代碼可用於訂單、變更訂單與報價的未交貨訂單 API 連線。這些代碼也會出現在傳送給客戶的各種輸出文件上:
- 收貨地址代碼是 TI 產品送達的地址
- 最終客戶身分代碼僅適用於已核准的合約製造商 (CM) 或代表另一名客戶購買的客戶
- TI 的廠商資訊與銀行詳細資料也會透過電子郵件通知提供客戶身分代碼
- 客戶可透過連結的 PDF 存取 TI 的廠商資訊和財務資訊。這是爲了方便在您系統中設定廠商。PDF 將包含 TI 郵寄地址、NAICS 代碼、聯邦稅務 ID 號碼、年收入及標準付款資訊。PDF也包含年度報告、公民報告和品質認證的連結。根據您對客戶上線表單的回覆,我們會在本電子郵件通知中指出銀行所在國家/地區,供您在廠商設定中使用。
步驟 3:訂購流程概覽
- 已擷取 TI 標準 API 格式,若偏好使用 API 推播,請參閱 API 業務指南
- 使用您指定的 API金鑰和秘密進行驗證
- 若無法建立報價單,請確認您要訂購的零件已包含在 TI 定價合約中
- 使用所需的酬載建立您的訂單,並將訂單發佈到未交貨訂單 API
- API 將會回覆狀態代碼 201 Created 及包含訂單確認的 JSON
- 查詢未交貨訂單 API 的訂單狀態和其他訂單詳細資料
- 在訂單出貨後,透過出貨前通知 (ASN) 擷取 API擷取出貨追蹤,並且透過財務文件擷取 API 擷取發票
- 匯款通知 API 為必填項。呼叫匯款通知 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 企業系統內建立報價單。可針對多個零件和數量提交報價單。您會收到報價單編號供您參考。 報價回應通常在提交報價單後 30 分鐘至 24 小時內提供。「quoteStatus」指出報價是否被接受、拒絕或變更;「status」指出行項目是否為待處理、競標價或無競標價。如需詳細資訊,請參閱未交貨項目報價 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:https://transact.ti.com/v1/oauth and 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:了解如何變更訂單
變更訂單請求有效負載中的主要訂單資料欄位,必須與原始訂單請求完全相符。這些欄位包括:
- customerPurchaseOrderNumber
- customerLineItemNumber
- tiPartNumber
請聯絡 API 支援部門以尋求有關使用 API 測試代碼測試變更訂單 API 的協助。
測試訂單請求範例:
{
"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 支援中心。
請求擷取範例:
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 支援中心。
範例:
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 企業系統中建立匯款通知記錄。
每個請求都必須包含標題和項目部分。 標題部分識別客戶的匯款通和貨幣代碼資訊。 項目部分可包含一筆或多筆詳細記錄,以及特定付款和相關財務文件資訊。如需詳細資訊,請參閱未交貨訂單匯款通知 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™ 設計支援論壇或發佈您的問題。