跳转至

决策_TPM-SD接口

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

决策内容（口径收口）

1. SD 接口族范围（对应 13 接口排期表）

排期# 接口 方向 映射 技术文档 TPM Dev
#4 Create/Change/Reject SO（单服务三操作） TPM→SAP ✅ 0903 基线 ✅ JSON 样本 9/21 交付 T+3（T=映射确认）
#5 SO 状态回传（DO & Billing，SAP 推送） SAP→TPM ✅ Completed — 9/4
#6 取消 SO 前状态查询 TPM→SAP ✅ Completed ⏳ 等 JSON spec T+2
#1-3 客户/Vendor Employee/物料主数据 SAP→TPM ✅ Completed ✅ 文档完成 —

2. 字段映射基线 = 0903 确认版

  • 演进：0901 初版 → 0903 确认版（02-Reference/assets/TPM接口规范/SO接口_20260903_字段映射.xlsx）
  • 0903 相对 0901 唯一实质差异：删除「删除订单」（ZDELETE）字段——订单删除不再走 SO 接口
  • 其余 55 个字段的 ApiName/类型/长度/必填全部一致；TPM 侧 API 字段名（纷享销客 __c 字段）在 0903 定稿（如 order_status__c、sap_sales_order_number__c）

3. 技术实现口径（据 9/21 Loi 交付的 6 个 JSON 样本）

  1. 单 OData 服务承载三操作，靠 OrderStatus 区分：01=Create / 02=Change / 03=Reject（Change/Reject 请求必填 SapSalesOrderNumber）
  2. 单号关联模型：创建时 CrmSalesOrderNumber（TPM name ↔ SAP BSTNK）为关联键；Response 回传 SapSalesOrderNumber + RequestNumber；Reject 响应不含 CrmSalesOrderNumber → TPM 必须持久化双单号映射
  3. 行项目号归一化：请求发 000010（NUMC 6 位），SAP 响应回 10——TPM 解析需归一化
  4. 日期格式归一化：映射表示例 29.04.2026（DD.MM.YYYY），JSON 实际为 ISO 2026-04-29——以 JSON 为准
  5. ConfirmQuantity（LSMENG/BMENG）SAP 确认回传，TPM 只读不回写
  6. 体积 VOLUM/VOLEH 由 TPM 下单携带（SKU×工厂值，见 决策_TMS体积字段；MARA 单一值并存仅作参考）
  7. 状态回传/查询 payload 含 FO（/SCMTMS/TOR_ID）、DO（LIKP）、Billing（VBRP）三级单据号与数量、PGI 时间、ATP 状态——对应排期 #5/#6

依据文件链（均为工作底稿，权威口径以本记录为准）

日期 文件 性质
9/1 SO接口_20260901.xlsx 字段映射初版
9/3 SO接口_20260903_字段映射.xlsx 映射确认版（基线）
9/14 排期对齐邮件（何晓晔） 13 接口排期状态
9/21 Create/Change/Reject SO JSON 样本 ×6（Loi 邮件） 技术实现口径

排期影响

  • #4 Create SO 解除 JSON spec 阻塞：TPM dev = T+3；endpoint 承诺 9/21 当天发出，未到前无法联调

  • 6 同服务模式 spec 实质就绪，等 endpoint

  • #7 PR / #9 删促销计划检查 / #11 #12 FI 仍无 spec——FI 两项 HIGH（9/15 零缓冲），下一个催办重点

开放项

# 事项 责任侧
1 Create SO endpoint 交付与联调排期 SAP（Loi）
2 #6 状态查询 JSON spec SAP
3 FlexibleField1-10 实际启用范围确认 双方
4 映射表内 SAP 侧 TBD 字段（Partner PCA、行项目文本 ApiName）。Partner PCA 字典已在：BP主数据接口_20260814.xlsx「SO PCA Field」sheet（152 行 As-Is→To-Be 码表，IK8B/IL80/IX00 系列），待确认随客户接口一并交付 TPM SAP
5 RejectReason 值表（Z2 等）全集 SAP 提供
6 FI/MM 四接口（#7/#9/#11/#12）JSON spec SAP

订单类型 / Item Category / 定价过程（自 决策_TPM-MM接口 迁入，2026-09-21 归类纠正）

2026-09-02 用户确认两份 SO 接口文件并确认归档决策，原件存 01-Projects/TPM/： - 20260902_SalesItemcategory.xlsx — 订单类型 ↔ Item Category 映射 - 20260902_SalesOrderTypesandPricingProcedureV3.xlsx — 各订单类型定价过程 + 需 TPM 传输的条件类型

订单类型 ↔ Item Category 口径

订单类型 描述 Item Category 定价过程
ZF00 RHQ销售 ZO11/ZO12搭赠/ZO13返利 ZCNTAX
ZF01 工厂直接销售 ZO11-13 —（仅 Sheet1(2) 出现）
ZF02 来料加工销售 ZO11-13 ZCN01
ZF03 工厂杂项销售 ZM01 —（仅 Sheet1(2) 出现）
ZF05 样品销售 ZO11-13 样品专用
ZR01 销售退货(billing) ZI11-13 ZCNTAX
ZR02 退货退回(no billing) — ZCNTAX
ZR03 换货补货(no billing) — ZCNTAX

需 TPM 传输的条件类型（核心）

ZP01 出厂价含税、ZMW1 税率、ZR01 搭赠折扣（仅ZO12行）、ZR02 返利折扣（仅ZO13行）、ZR2X 返利台账折扣、ZD01 标准折扣（备用）、ZD04 随单折扣（不能与搭赠同用）、样品单另有 ZPSO/ZD08/ZMW2/ZNT1/ZMW5。

退换货口径

  • SAP 退货订单基础价 copy 原发票行价格，只允许退标准行项目
  • TPM 退货：参照原 TPM SO 行价格创建，须传原始 SAP 发票号到 S4
  • TPM 换货：参照原 TPM 退货 SO 行价格创建，须传原 SAP SO 号（ZR02）到 S4

⚠️ 退货/退换货对接细节未完成（2026-09-20 Kabin 确认）

ZR01/ZR02/ZR03 退换货场景的 TPM↔S4 对接细节（字段级）确实尚未完成，属本决策已知未完成项，SIT 合流与接口设计时需单独覆盖；不影响接口整体决策结论。

⚠️ 与蓝图 V1.05 7.3 节冲突

蓝图 IF-SO-01 的 item_category=TAN、折扣 ZDIS/ZREB 为旧口径，被本 V3 文件取代（ZO11-13 / ZR01/ZR02 口径）。用户已确认本文件为权威口径。

相关文档