跳转至

SO接口规格变更交付:多端点架构 + Dev凭据(2026-10-12)

最后变更:2026-10-12 15:21

⚠️ 邮件含 Integration Suite Dev 环境明文 Basic 凭据(原件在本目录及 cache,归档注意保密级别)

本封邮件说了什么(一句话)

Loi 回复 Burning:SO 创建的 JSON 规格变了——order_type 判别字段移除,改为每种 OrderType 独立 endpoint;随附两个 txt:SO Creation(Create/Change/Reject 三端点+样例)和 DO & Billing Status 查询端点,均含 Dev host + Basic 凭据。

邮件链

日期 发件人 内容
2026-08-25/26 William Wang 会议邀请 + 13 接口排期表 v1
2026-09-14 何晓晔(Xiaoke) 最新排期:7 接口 BLOCKED 等 SAP JSON spec
2026-09-21 Loi 交付 Create SO JSON 规格(OrderStatus 01/02/03 单服务三操作);承诺当天发 endpoint
2026-09-21 Loi 补发 Integration Suite URL + SO_CREATE endpoint
2026-09-21 Burning(何锐) 确认收到,索要 Create SO Request URL
2026-10-12 Loi 规格变更:order_type 判别字段移除→多端点;发两份 txt(端点+JSON+凭据)
2026-10-12 11:41 Eve Huang 质疑:Order TYPE 是建单必要条件,接口必须保留;SO create JSON 有订单类型字段、SO change 不需要传
2026-10-12 11:49 Loi 书面改口:「对不起。Eve 说的对。不是 OrderType。是 OrderStatus=01/02/03 已被移除。」三端点架构维持

与 9/21 版规格的实质差异(字段级 diff 已做)

命名澄清(2026-10-12,✅ 已由 Loi 11:49 邮件书面确认,闭环):Eve 质疑「Order TYPE 是建单必要条件」后,Loi 邮件原话改口:「对不起。Eve 说的对。不是 OrderType。是 OrderStatus=01/02/03 已被移除。」——双方口语里的 "Order Type / order_type" 均指"请求类型判别字段",其字段名实为 OrderStatus;请求体里同音不同义的 OrderType(SAP 单据类型,ZF00 等)不删,Create 仍必须传。TPM 开发必须按字段名而非口语理解。(早期 IM 佐证:Eko_OrderType澄清截图_20261012.jpg)

维度 9/21 版(旧) 10/12 版(新,以此为准)
操作判别 OrderStatus 字段(01=Create/02=Change/03=Reject)单服务三操作 字段移除;Create/Change/Reject 各自独立端点
Endpoints /http/TPM/SO_CREATE(单) /http/TPM/SO_CREATE、/http/TPM/SO_CHANGE、/http/TPM/SO_REJECT
Create 请求头 26 字段(含 OrderStatus) 27 字段(无 OrderStatus;FlexibleField4/5 出现在样例)
Item 层 含 ConfirmQuantity/MessageType/MessageText/RejectReason 混入 混入字段移除;CrmSalesOrderNumber、Currency 加入 Item 层
Change/Reject Change 靠 OrderStatus=02 独立端点;请求含 SapSalesOrderNumber(不变)
metadataEtag W/"20260915…" W/"20261009063751" — SAP 服务 10/9 重新构建
状态查询 #6 spec 未到 新增 /http/TPM/GET_DO_BILLING(POST,双单号入参,回 Credit/Delivery/DO/Billing 四级状态)

新端点与样例要点(TPM 开发需知)

  1. Host/Auth:https://dev-cqg6dbov.it-cpi012-rt.cfapps.ap21.hana.ondemand.com,Basic Auth(凭据见 txt,Dev 环境)
  2. Reject 极轻:SapSalesOrderNumber + 行项目 RejectReason(样例 Z2)
  3. 样例 Response 是真实报错(MessageType=E),两个独立问题:
  4. Condition ZP01 cannot be entered manually(V1 239):ZP01(出厂价)在当前定价过程不允许手工录入 → 与 0903 字段映射「需 TPM 传输 ZP01」直接冲突,需 SAP 侧改配置或改传参方式,联调前必须关闭
  5. Reason for rejection Z2 is not defined(V1 415):S/4 配置里尚无 Z2 拒绝原因 → 开放项#5 RejectReason 值表仍未交付
  6. #6 状态查询:入参 Sap+Crm 双单号;回 CreditCheckStatus/DeliveryStatus/DONumber/BillingNumber/确认数量/PGI 时间;样例即信用冻结场景(CreditCheckStatus=B)

排期影响

接口 变化
#4 Create/Change/Reject SO spec+endpoint 齐了,可开发/联调;TPM dev = T+3
#6 取消前状态查询 spec+endpoint 齐了;TPM dev = T+2
#7 PR / #9 删促销计划检查 仍 BLOCKED(MM spec 未到)
#11 #12 FI 过账/冲销 仍 BLOCKED,HIGH——下一个催办重点

⏳ 待办

  • 转交 Burning/纷享团队按新端点开发(Dev 凭据在 txt 内)
  • ZP01 手工录入报错 → 需 SAP 侧答复:改定价配置 or TPM 不传 ZP01
  • RejectReason Z2 未定义 → 催 SAP 补配置+值表(开放项#5)
  • 催 #11/#12 FI JSON spec(HIGH)
  • FlexibleField1-10 启用范围确认(开放项#3,样例新出现 FF4/FF5)

🔗 关联

  • 决策_TPM-SD接口 — 技术口径已按本邮件更新(多端点取代 OrderStatus 01/02/03)
  • Create_SO_JSON规格交付_20260921 — 旧版规格(已被本版取代)
  • 原件:TPM_Schedule status alignment 0914_20261012.msg(本目录)
  • 附件:接口JSON规格/Integration Suite - SO Creation_20261012.txt、接口JSON规格/Integration Suite - DO & Billing Status_20261012.txt