API 業務指南

TI 未交貨項目 API 訂單套件包含：報價、訂單管理、出貨前通知 (ASN) 擷取、財務文件擷取和匯款通知 API。另外也提供推播通知 API，將數據輸入到客戶的系統中。如需詳細資訊、請遵循下列指示。

端對端訂單流程
API 預設的設定
1. 同步回應
  1. 在一個 API 呼叫中，客戶系統會得知 TI 是否已成功在 TI 系統中完全地處理請求，且成功地變更實際的銷售訂單
2. 允許建立和更改部分 PO
  1. 雖不輸入拒絕項目，但會接受正確的 API PO 行項目輸入
  2. API 訂單變更一律會在個別的品項層級執行
3. 錯誤處理
  1. 在 API 回應中，任何錯誤訊息或資訊化警告無論是在訂單層級或在個別的行項目層級都會傳回
  2. 如果有完整的警告或錯誤詳細資訊清單，客戶可以更順利控制如何及何時更正錯誤，並在需要時重新提交請求
推播 API
1. API 推播通知依預設為停用，但需此功能以獲得 TI API 的完整優點
2. 若要設定訂單、出貨前通知及財務文件的 API 推播通知，請遵循下列指示
  1. 前往 TI.com/support
  2. 選擇開啟新的支援要求
  3. 選擇直接客戶訂單履行
  4. 填寫 API 推播表單、附加並提交
報價 API
1. 未交貨訂單報價 API 可讓客戶建立報價單，並接收 TI 產品的回應。客戶也可以擷取先前建立的報價單
2. 報價 API 可用於同時請求多個報價行項目，以獲取不同製造商零件編號 (MPN)。如果客戶在多個行項目上提交具有相同 MPN 的報價，TI 只會處理 MPN 的第一個執行個體
3. 如果提交報價時要求的數量不符合最低訂單值、最低訂單數量 (MOQ) 或標準包裝數量 (SPQ) 倍數，TI 將以報價回應方式無條件進位至最近的 MOQ

訂單管理 API

訂單建立和變更立流程圖

API 訂單建立需求

用於建立訂單的必填欄位和選用欄位

訂購元素	必填/選用	字元限制
採購單 (PO) 編號	必填	不超過 35 個字元； PO 號碼中沒有空格
PO 行項目	必填
製造商零件編號 (MPN)	必填
客戶直接價格 (CDP)	必填	不超過五 (5) 位數
客戶請求日期 (CRD)	必填
數量	必填
客戶零件編號 (CPN)	選擇性
最終客戶	選用 (CM 必填)	大寫

對於每個 PO 行項目，只允許一個單一 CRD。
對於同一 PO 號碼下的每個 PO 行項目，不得複製項目編號，否則 PO 無法變更
針對每個 PO 接受具有相同或不同 TI 零件編號的多個 PO 行項目
對於含「最終客戶」的 PO，只有相同最終客戶的資料可以接受相同的 PO 編號
數量應是 TI 標準包裝數量 (SPQ) 的倍數，並符合 TI 產品目錄中定義的最低訂購要求 (MOQ) 和最小產品值 (MIV)

訂單回應規則
1. 對於允許部分交貨的客戶，您可能會收到多個計劃行/每個 PO 行項目的預計出貨日 (ESD)，具體取決於產品的可用性

API 訂單變更需求

允許的訂單變更類型
- CRD 提前交貨或延後出貨
- PO 行項目價格更新
- PO 行項目數量減少
- PO 行項目取消

訂單變更或取消期間

變更訂單時段 (COW) 定義變更或取消不再獲得授權處理的時段
- STD (標準) COW：30 天
- 非 STD (非標準) COW：90 天
除 CRD 提前交貨和價格變動外，TI 拒絕 COW 內的所有變動

COW 取消與重新安排規則取決於零件類型

關於產品、晶圓產品和裸片產品，買方得依據以下規則取消或重新安排訂單：

買方要求取消或重新安排日期	標準品	非標準品
< ESD 前 30 日	不允許	不允許
ESD 前 30-90 日	允許	不允許
< ESD 前 90 日	允許	必須經 TI 核准。可能加收費用。

關於評估產品：不得取消或重新安排評估產品的訂單。

儘管有上述規則，某些產品仍應適用特別的取消及重新安排條款，對此，TI 將於接受訂單前通知買方。

訂單變更規則
- 訂單變更位於 PO 行項目層級
  - 即使客戶只想變更特定計劃行，該計劃行數量的總和仍需要與 PO 行項目的總數量相符
  - 只有當客戶請求減少 PO 行項目的數量時，才需要完整的 PO 行項目原始數量
- 若要增加 PO 條項數量，請建立新 PO
- 已完全出貨並隨附出貨前通知 (ASN) 的 PO 條項無法變更
- 在 TI 內部已建立的客戶送貨地址上，PO 標題和行項目層級皆允許變更送貨地址
- 客戶需要透過訂單變更來更新原始 PO 條項的價格，以取得新的有效價格
- 對於具有完整配送設定的客戶，增加訂單數量可能會導致 ESD 遺失

訂單管理警告和錯誤處理
1. 如果 CDP 和 TI 定價協議 (PA) 之間的價格不相符，則結果將是由客戶與 TI 兩者審查的不完整訂單
  - 如果 CDP 正確，TI 將重新整理價格 - 客戶無需採取任何動作
  - 若 TI 價格正確，您需透過訂單變更來更新 CDP，價格不相符問題已解決，則系統會回覆說明
2. 若發生 SPQ/MOQ/MIV 錯誤將無法建立訂單，請更正數量，並以建立訂單方式重新傳送給 TI
3. 有關錯誤詳細資訊的完整清單，請檢查我們的詳細錯誤清單：

出貨前通知 (ASN) API
1. 未交貨訂單 ASN 擷取 API 可讓客戶擷取有關您的出貨詳細資訊，例如出貨追蹤編號、貨運業者資訊和商業發票。
財務文件 API
1. 未交貨訂單財務文件擷取 API 可讓客戶擷取財務發票資訊，例如發票號碼、發票金額及發票日期。
匯款通知 API
1. 未交貨訂單匯款通知 API，可讓取得授權之客戶傳送確認付款詳細資訊的匯款通知資訊。
使用者驗收測試案例 (UAT) 通過測試階段：
1. 客戶完成自助測試案例 1.0–2.1 後，我們的 GBO 區域小組會聯絡可存取 API 金鑰的管理員電子郵件

Sidebar - Backlog

API 業務指南