未交貨訂單 API 套件 v1 - API 業務指南 | TI API Portal

API 業務指南

API 呼叫是透過未交貨訂單建立 API、未交貨訂單變更 API、未交貨訂單報價 API、未交貨訂單擷取 API、未交貨訂單 ASN 擷取 API、未交貨訂單財務文件擷取 API、未交貨訂單匯款通知 API。

預設不啟用 API 推播通知
1. 如果您想要收到進階運送通知，財務文件和報價的 API 推播通知、請遵循下列指示。
  1. 前往 TI.com/support
  2. 選擇開啟新的支援要求
  3. 選擇直接客戶履行
  4. 填寫 API 推播表單、附加並提交

端對端訂單流程

API 初始設定
1. API 呼叫內的錯誤
  1. 客戶將需要修正錯誤
  2. 客戶系統會在同一個 API 呼叫中取得完整的錯誤詳細資料清單
  3. 如果有完整的警告或錯誤詳細資訊清單，客戶可以更順利控制如何及何時更正錯誤，並在需要時重新提交請求
2. 允許部分訂單
  1. 雖不輸入拒絕項目，但會接受正確的 API 訂單輸入
  2. API 訂單變更一律會在個別的品項層級執行
3. 同步回應
  1. 預設爲同步回應
  2. 在一個 API 呼叫中，客戶系統會得知 TI 是否已成功在 TI 系統中完全地處理請求，且成功地變更實際的銷售訂單
4. 連線所需的客戶詳細資料
  1. TI 會傳送電子郵件通知，內含您下訂單所需代碼，例如買方代碼和收貨地址代碼 (若您是合約製造商 (CM)、則會提供最終客戶代碼)

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. 已建立有問題的訂單
  1. 如果 CDP 和 TI 定價協議 (PA) 之間的價格不相符，則結果將是由 TI 審查的不完整訂單
  2. 如果 CDP 正確，TI 將重新整理價格 - 客戶無需採取任何動作
  3. 若 TI 價格正確，您需透過訂單變更來更新 CDP，價格不相符問題已解決，則系統會回覆說明
    1. 若要檢閱定價差異，請檢閱客戶未交貨訂單報告檔案、定價差異標籤
  4. 若發生 SPQ/MOQ/MIV 錯誤將無法建立訂單，請更正數量，並以建立訂單方式重新傳送給 TI

訂單取消或變更的期間

變更訂單時段 (COW) 定義變更或取消不再獲得授權處理的時段
COW 規則取決於零件類型
這適用於從預計出貨日 (ESD) 開始計算

除 CRD 提前交貨和價格變動外，TI 拒絕 COW 的所有變動

零件類型	變更週期
標準 (STD)	自預計出貨日起 30 天
自訂 (CST)	自預計出貨日起 90 天
不可取消不可退還 (NCNR)	無法取消

允許的訂單變更類型
1. 客戶請求日期 (CRD) 延後出貨或提前交貨。
2. PO 行項目價格更新
3. PO 行項目數量減少
4. PO 行項目取消

訂單變更秘訣：
1. 若要增加 PO 條項數量，請建立新 PO
2. 已完全出貨並隨附出貨前通知 (ASN) 的 PO 條項無法變更
3. PO 條項或 PO 取消可能會導致估計的運送日期 (ESD) 遺失
4. 在 PO 行項目上，變更客戶需求日、價格或取消 PO 行項目時，保留原始訂購數量
5. 變更 CRD 時請記住 COW
6. 在 COW 內延後出貨一次就會產生拒絕和錯誤
7. 客戶需要透過訂單變更來更新原始 PO 條項的價格，以取得新的有效價格
8. 在訂單變更請求中保留相同的 PO 和 PO 項目編號結構

匯款通知提示：
1. 使用 TI 的財務發票編號
  1. 如果未提供，請使用透過 ASN 提供的交貨單號碼或商業發票號碼
  2. TI 會在提交客戶上線表單後提供客戶付款人代碼

使用者驗收測試案例 (UAT) 通過測試階段：
1. 客戶完成自助測試案例 1.0–2.1 後，GBO 區域小組會聯絡可存取 API 金鑰的管理電子郵件