Sidebar - Backlog

API 业务指导手册

TI 备货 API 套件包括：报价、订单管理、出货前通知 (ASN) 检索、财务单据检索和汇款通知 API。还提供推送通知 API，用于自动将数据输入到客户的系统中。有关详细信息，请参阅以下说明。

  1. 端到端订单流程 
  2. API 默认设置
    1. 同步响应
      1. 在一次 API 调用中，客户系统将知道 TI 是否完整处理了申请，以及实际销售订单是否已在 TI 系统中成功更改
    2. 允许部分 PO 创建和更改
      1. 系统将接受正确的 API PO 行项目录入，而拒绝的订单不会录入系统
      2. API 订单更改将始终在单个行项目级别执行
    3. 错误处理
      1. 错误消息或信息性警告都将在订单级别或单个行项目级别的 API 响应中传回
      2. 有了完整的警告或错误详细信息列表，客户将更好地控制如何和何时纠正错误，并在需要时重新提交申请
  3. 推送 API
    1. 默认情况下不启用 API 推送通知，但需要启用才可充分利用 TI API
    2. 如需设置关于订单、出货前通知和财务单据的 API 推送通知，请按照以下说明进行操作
      1. 访问 TI.com/support
      2. 选择“创建新的支持申请”
      3. 选择“直接面向客户履单”
      4. 填写并附上 API 推送表提交
  4. 报价 API
    1. 备货报价 API 支持客户创建 TI 产品报价并接收响应。客户还可以检索之前创建的报价
    2. 报价 API 可用于针对不同的制造商器件型号 (MPN) 同时申请多个报价行项目。如果客户在多个行项目中提交具有相同 MPN 的报价，TI 将仅处理 MPN 的第一个实例
    3. 如果提交报价时申请的数量不满足最低订单价值、最低起订量 (MOQ) 或标准包装数量 (SPQ) 的倍数，TI 将在报价响应中四舍五入到最接近的 MOQ
  5. 订单管理 API
    1. 订单创建和变更流程图
    2. API 订单创建要求
      1. 用于创建订单的必填字段和可选字段
        订单元素 必填/可选 字符限制
        采购订单 (PO) 编号 必填 不得超过 35 个字符；
        PO 编号中不得包含空格
        PO 行项目 必填  
        制造商器件型号 (MPN) 必填  
        客户直销价格 (CDP) 必填 不超过五 (5) 位小数
        客户申请日期 (CRD) 必填  
        数量 必填  
        客户器件型号 (CPN) 可选  
        终端客户 可选（对于 CM 为必需） 大写
      2. 对于每个 PO 行项目，只允许有一个 CRD
      3. 对于同一 PO 编号下的每个 PO 行项目，项目号不应重复，否则 PO 更改将失败
      4. 对于每个 PO，具有相同或不同 TI 器件型号的多个 PO 行项目都可接受
      5. 对于具有“终端客户”的 PO，同一 PO 编号下只接受同一终端客户的物料
      6. 数量应为 TI 标准包装数量 (SPQ) 的倍数，并满足 TI 产品目录中定义的最低起订量要求 (MOQ) 和最低商品价值 (MIV)
    3. 订单响应规则
      1. 对于允许部分交付的客户，您可能会收到关于单个 PO 行项目的多个计划行/预计发货日期 (ESD)，具体取决于产品的供货情况
    4. API 订单变更要求
      1. 允许的订单变更类型
        • CRD 提前或延后
        • PO 行项目价格更新
        • PO 行项目数量减少
        • PO 行项目取消
      2. 订单变更或取消的时间段
        • 更改订单窗口 (COW) 定义了不再授权进行更改或取消的时间段
          • STD（标准）COW：30 天
          • 非 STD（非标准）COW：90 天
        • TI 会拒绝 COW 内的所有更改，但 CRD 提前和价格更改除外
        • COW 取消和重新安排规则取决于器件的类型
          • 对于产品、晶圆产品和裸片产品，买方可以根据以下规则取消或重新安排订单：
            买方要求的取消或重新安排日期 标准产品 非标准产品
            ESD 前 30 天内 不允许 不允许
            ESD 前 30-90 天 允许 不允许
            ESD 前 90 天内 允许 需要 TI 批准。可能会收费。
            对于评估类商品：不得取消或重新安排评估类商品订单。

            尽管有上述规则，某些商品仍需遵守特殊的取消和重新安排条款；TI 会在接受订单之前将这些条款告知买方。
      3. 订单变更规则
        • 订单变更在 PO 行项目级别进行
          • 即使客户只想变更特定的计划行，计划行数量的总和也需要与 PO 行项目的总数量相匹配
          • 仅当客户申请减少 PO 行项目的数量时，才需要完整的 PO 行项目原始数量
        • 要增加 PO 行项目数量，请创建一个新 PO
        • 已全部发货且带有出货前通知 (ASN) 的 PO 行项目无法更改
        • 收货地址允许在 TI 已创建客户收货地址上的 PO 标题和行项目级别进行变更
        • 客户需要通过更改订单来更新原始 PO 行项目的价格，获得新的有效价格
        • 对于已完成交货设置的客户，增加订单数量可能会导致 ESD 延长
    5. 订单管理警告和错误处理
      1. 如果 CDP 与 TI 的价格协议 (PA) 之间存在价格不一致，则交由客户和 TI 审核而无法完成订单
        • 如果 CDP 正确，TI 将更新价格 - 无需客户采取任何措施
        • 如果 TI 价格正确，客户将需要通过订单变更来更新 CDP，系统将指示价格不一致问题是否已解决
      2. 如果出现 SPQ/MOQ/MIV 错误，则不会创建订单，请更正数量并在创建订单时重新发送给 TI
      3. 有关错误详细信息的完整列表，请查看我们的详细错误列表：
  6. 出货前通知 (ASN) API
    1. 备货 ASN 检索 API 支持客户检索发货详细信息，例如物流跟踪单号、承运商信息和商业发票
  7. 财务单据 API
    1. 备货财务单据检索 API 支持客户检索财务发票信息，例如发票编号、发票金额和发票日期
  8. 汇款通知 API
    1. 备货汇款通知 API 支持授权客户发送确认付款细节的汇款通知信息。
  9. 用于通过测试阶段的用户验收测试方案 (UAT)：
    1. 客户完成自助服务测试方案 1.0–2.1 后，我们的 GBO 区域团队将向具有 API 密钥访问权限的管理员发送电子邮件