Sidebar - Backlog-V1

API 业务指导手册

API 调用通过以下 API 进行：备货订单创建 API、备货订单更改 API、备货报价 API、备货订单检索 API、备货 ASN 检索 API、备货财务单据检索 API、备货汇款通知 API。

  1. 默认情况下，系统不会启用 API 推送通知
    1. 如果您希望收到出货前通知、财务单据和报价的 API 推送通知，请按照以下说明进行操作
      1. 访问 TI.com/support
      2. 选择“创建新的支持申请”
      3. 选择“直接面向客户履单”
      4. 填写并附上 API 推送表提交

  2. 端到端订单流程
     

  3. API 初始设置
    1. API 调用中的错误
      1. 客户将需要修正错误
      2. 客户系统将在同一个 API 调用中获得完整的错误详细信息列表
      3. 有了完整的警告或错误详细信息列表，客户将更好地控制如何和何时纠正错误，并在需要时重新提交申请
    2. 允许部分订单
      1. 将接受正确的 API 订单录入，而不会输入拒绝的订单
      2. API 订单更改将始终在单个行项目级别执行
    3. 同步响应
      1. 默认为同步响应
      2. 在一次 API 调用中，客户系统将知道 TI 是否完整处理了申请，以及实际销售订单是否已在 TI 系统中成功更改
    4. 连接所需的客户详细信息
      1. TI 将发送一封电子邮件通知，其中包含您下订单所需的标识符，例如买方和收货方标识符（如果您是合同制造商 (CM)，将提供终端客户标识符）

  4. API 订单创建要求  
     订单元素  必填/可选  字符限制
     采购订单 (PO) 编号  必填

     大写；不超过 35 个字符

     PO 编号中不能有空格；
     PO 行项目  必填  
    制造商器件型号 (MPN)  必填  
     客户直销价格 (CDP)  必填  不超过五 (5) 位小数
     客户申请日期 (CRD)  必填  
     数量  必填  
     客户器件型号 (CPN)  可选  
     终端客户 可选（对于 CM 为必需）  大写
    1. 对于每个 PO 项，只允许有一个 CRD。
    2. 对于同一 PO 编号下的每个 PO 项，项号不应重复，否则 PO 更改将失败
    3. 对于每个 PO，具有相同或不同 TI 器件型号的多个 PO 项都可接受
    4. 对于具有“终端客户”的 PO，同一 PO 编号下只接受同一终端客户的物料
    5. 数量应为 TI 标准包装数量 (SPQ) 的倍数，并满足 TI 产品目录中定义的最低起订量要求 (MOQ) 和最低商品价值 (MIV)
  1. 订单创建和变更流程图和要点：
    1. 已创建订单，但有问题
      1. 如果 CDP 与 TI 的价格协议 (PA) 之间存在价格不一致，则交由 TI 审核而无法完成订单
      2. 如果 CDP 正确，TI 将更新价格 - 无需客户采取任何措施
      3. 如果 TI 价格正确，客户将需要通过订单变更来更新 CDP，系统将指示价格不一致问题是否已解决
        1. 若要查看价格差异，请查看客户备货报表文件、价格差异选项卡
      4. 如果出现 SPQ/MOQ/MIV 错误，则不会创建订单，请更正数量并在创建订单时重新发送给 TI
  1. 订单取消或更改的期限
    1. 更改订单窗口 (COW) 定义了不再授权进行更改或取消的时间段
    2. COW 规则取决于器件的类型
    3. 从 TI 的预计发货日期 (ESD) 开始计算
    4. TI 会拒绝 COW 内的所有更改，但 CRD 提前和价格更改除外
       器件类型  更改期限
       标准 (STD)  自预计发货日期起 30 天
       自定义 (CST)  自预计发货日期起 90 天
      不可取消不可退货 (NCNR)  无法取消

       

  2. 允许的订单更改类型
    1. 客户申请日期 (CRD) 延后或提前。
    2. PO 行项目价格更新
    3. PO 行项目数量减少
    4. PO 行项目取消

  3. 订单变更提示：
    1. 要增加 PO 行项目数量，请创建一个新 PO
    2. 已全部发货且带有出货前通知 (ASN) 的 PO 行项目无法更改
    3. PO 行项目或 PO 取消可能导致预计发货日期 (ESD) 丢失
    4. 在更改 CRD、价格或取消 PO 行项目时，保留 PO 行项目上的原始订购量
    5. 更改 CRD 时记住 COW
    6. 在 COW 内延后一次会产生拒绝和错误
    7. 客户需要通过更改订单来更新原始 PO 行项目的价格，获得新的有效价格
    8. 在订单变更申请中保持相同的 PO 和 PO 项目编号结构

  4. 汇款通知提示：
    1. 使用 TI 的财务发票编号
      1. 如果不可用，请使用通过 ASN 提供的交货单号或商业发票编号
      2. 提交客户引导表单后，TI 将提供客户付款人标识符

  5. 用于通过测试阶段的用户验收测试方案 (UAT)：
    1. 客户完成自助服务测试方案 1.0–2.1 后，我们的 GBO 区域团队将向具有 API 密钥访问权限的管理员发送电子邮件