跳转至

Create SO JSON 接口规格交付（SAP侧）

最后变更：2026-09-21 12:50

邮件链

日期 发件人 内容
2026-08-25 William Wang 会议邀请：TPM 排期对齐，目标赶上 SAP SIT（9/15）
2026-08-26 William Wang 会议结论：13 接口排期表 v1
2026-09-14 何晓晔（Xiaoke/纷享销客） 最新排期状态：13 接口中 7 个 BLOCKED 等 SAP JSON spec
2026-09-21 Loi Hui Hong 交付 Create SO JSON 规格（6 文件）；endpoint 承诺 9/21 当天发出

JSON 规格要点

  • 同一 OData V4 服务承载三操作，靠 OrderStatus 区分：01=Create / 02=Change / 03=Reject
  • CrmSalesOrderNumber（TPM 单号）为创建关联键；Create Response 回传 SapSalesOrderNumber（如 IX1D000201）+ RequestNumber，Change/Reject 请求必填 SapSalesOrderNumber
  • Reject 极轻：仅 OrderStatus=03 + Sap 单号 + 行项目 RejectReason（样例 Z2）
  • Response 含 MessageType/MessageText/SAP__Messages 标准回执结构
  • metadataEtag 20260915… 说明 SAP 侧服务 9/15 已构建

审阅注意点（TPM 开发需知）

  1. ItemNumber 格式不一致：请求侧 000010（6位前导零），响应侧回 10——解析/回写需归一化
  2. Reject Response 的 CrmSalesOrderNumber 为空——TPM 关联只能靠 SapSalesOrderNumber，TPM 侧必须持久化两单号映射
  3. Change 请求回传 ConfirmQuantity=0 由 SAP 确认，TPM 不应回写该字段
  4. 样例 FlexibleField1-8 大量为空，实际启用范围待字段映射表对齐

排期影响

  • #4 Create SO 解除 JSON spec 阻塞（field mapping 已 Completed，TPM dev = T+3）；endpoint 未到前无法联调

  • 6 Change/Cancel SO 同服务模式，spec 实质就绪，等 endpoint

  • #7 PR / #9 Promo Plan 检查 / #11 #12 FI 仍无 spec——#11/#12 是 HIGH（9/15 deadline 零缓冲），下一个催办重点

⏳ 待办

  • 等 Loi 今天发 Create SO endpoint
  • 催 FI（#11/#12）与 MM（#7/#9）JSON spec
  • TPM 侧确认 ItemNumber 归一化与双单号映射方案

🔗 关联