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 开发需知)¶
- Host/Auth:
https://dev-cqg6dbov.it-cpi012-rt.cfapps.ap21.hana.ondemand.com,Basic Auth(凭据见 txt,Dev 环境) - Reject 极轻:
SapSalesOrderNumber+ 行项目RejectReason(样例 Z2) - 样例 Response 是真实报错(MessageType=E),两个独立问题:
Condition ZP01 cannot be entered manually(V1 239):ZP01(出厂价)在当前定价过程不允许手工录入 → 与 0903 字段映射「需 TPM 传输 ZP01」直接冲突,需 SAP 侧改配置或改传参方式,联调前必须关闭Reason for rejection Z2 is not defined(V1 415):S/4 配置里尚无 Z2 拒绝原因 → 开放项#5 RejectReason 值表仍未交付- #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