TPM 物料主数据 & SO 销售订单接口(20260901)¶
最后变更:2026-09-04 20:18
2026-09-01 版接口规范两份:物料主数据(SAP→TPM/纷享销客)+ 销售订单双向接口。原件存
02-Reference/assets/TPM接口规范/。 关联:TPM_SAP到纷享销客主数据同步接口规范(8/7 v1.0 旧版)· S4_China_Enterprise_Structure(销售组织编码权威)· TPM主数据接口
一、物料主数据接口(SAP → TPM)¶
结构:ZTPM_MAT_OUT¶
| 分层 | 表 | 字段 |
|---|---|---|
| Message Header | ZTPM_MAT_OUT | Z_INTER_ID(40)/Z_LOG_ID(20)/SEND_STAT(10)/TOTAL_COUNT/MSGTY/MSGID/MESSAGE_TEXT(255)/SENT_TS |
| Business Header | ZTPM_MAT_OUT | Z_SEQUENCE(NUMC6 项目序号) |
| Business Header | MAKT | SPRAS 语言 / MAKTX 描述(中) / MAKTX 描述(英) |
| Business Header | MARA | MTART 物料类型 / MATNR(18) / MEINS 基本单位 / MATKL 物料组(9) / VOLUM+VOLEH 体积 / NTGEW+GEWEI 净重 / BRGEW+GEWEI 毛重 / ERSDA 创建日期 / LAEDA 更改日期 / LVORM 客户级删除标记 |
| Business Item | MARC | WERKS 工厂 / EKGRP 采购组(3) / MMSTA 物料状态 / LGORT 库存地点 / PRCTR 利润中心 / LVORM 工厂级删除标记 |
| Business Item | MVKE | VKORG 销售组织 / VTWEG 分销渠道 / MVGR2-5 物料组2-5 |
枚举值(20260901 口径,销售组织已按重排后编码 ✅)¶
销售组织 VKORG(= 公司代码同码,BRD 段):
| 编码 | 描述 |
|---|---|
| IX00 | SCHL TRD RHQ 中国RHQ |
| IG00 | SFSL TRD Shaoguan 韶关 |
| IL00 | ZHXL TRD Xinghua 兴化 |
| IM00 | ZHDL TRD Dong'e 东阿 |
| IQ00 | HFFL TRD Fuxin 阜新 |
| IR00 | HFXL TRD Xianyang 咸阳 |
采购组 EKGRP:CF1 直接材料 / CF2 直接包装 / CF3 间接 / CF8 STO / CF9 TM
工厂 WERKS:B5F0 (RHQ上海) / R5F1 兴化 / R5F2 东阿 / R5F3 阜新 / R5F5 咸阳 / R5F6 韶关
分销渠道 VTWEG:10 Export 国外销售 / 20 Local 国内销售
物料组 MATKL:01 / 02 / DV_MGRP01(数字车辆物料组)— ⚠️ 描述仍为占位符(物料组1/2),文档标 To be updated
物料组2 MVGR2(品牌系列,14个):F01 魔法士 / F02 薯你脆 / F03 脆不可挡 / F04 魔法士1.5元 / F05 魔法士2元 / F06 三鲜伊面 / F07 油泼辣子 / F08 华丰面馆车仔面 / F09 辣系列 / F10 鲜汤系列 / F11 华丰杯面 / F12 魔芋QQ杯 / F13 椰语清澜100%椰子水 / F14 天然矿泉水
物料类型:3 种;体积/基本计量单位:425/424 条枚举;库存地点:57 条;工厂级/客户级删除标记各 3 条
文档内开放问题(顾问批注,未拍板)¶
- EKGRP 是否跟工厂一致?
- 库存地点 / 利润中心 / 销售组织是否做成 TPM 单独档案?
- 重量单位/基本单位选项集确认(Sheet 已有全量枚举)
二、SO 销售订单接口(双向)¶
Sheet 结构(7个)¶
| Sheet | 方向 | 规模 |
|---|---|---|
| 客户(SAP→CRM) | 下发 | 59 字段 |
| 销售订单接口(CRM→SAP) | 创建/变更 | 61 字段 |
| SAP SO Response-Create / Update / Reject | 回传 | 14/58/15 字段 |
| TPM Call SO Status | TPM 拉取状态 | 23 字段 |
| SAP Send SO Status to TPM | SAP 推送状态 | 28 字段 |
关键字段(CRM→SAP 订单)¶
| 字段 | ApiName | 必填 | 示例 |
|---|---|---|---|
| 订单状态 | — | Y | 01-Create / 02-Change / 03-Reject |
| CRM订单编号 | BSTNK | Y | Customer PO |
| SAP销售订单 | VBELN | N | IX1D0000002 |
| 删除标记 | ZDELETE | N | 订单拒绝标记 |
| 订单类型 | AUART | Y | RHQ Sales Order / RHQ Sample |
| 参考订单 | VGBEL | N | IX1D0000001 |
| 销售组织 | VKORG | Y | IX00(新编码 ✅) |
| 销售渠道 | VTWEG | Y | 20 |
| 产品组 | SPART | Y | BF |
| 客户渠道 | KDGRP | Y | Z1 |
| 预留字段 | Flexible Fields 1-10 | N | — |
客户主数据(SAP→CRM)要点¶
- BP group (BU_GROUP, BUT000) / KUNNR(10) 客户编码 / NAME1 名称 / SORT1 简称 / 地址(STREET/CITY1)
- 销售冻结 CASSD (KNVV);Delivery Block / Billing Block / Company Code Block: TBD(待定)
响应/状态报文¶
- 统一 BAPIRET2 结构:Messages type (S/W/E) / code (ID+NUMBER) / text (220)
- Create 响应 13 字段含 Status(SUCCESS: Order created...)+ Order Operation (01 Create)
- SAP Send SO Status 22 字段含 TOTAL_SO 发送数量总计
与旧版差异记录¶
- 2026-08-07 v1.0(TPM_SAP到纷享销客主数据同步接口规范):VKORG 枚举写 IG00/IL00 等 → 8/29 曾判为错误改 XX20 → 9/1 EDM 澄清后 20260901 版已回归 IG00 系列(=公司代码同码),原文口径正确
- 20260901 新增:物料组2-5(MVGR2-5)、利润中心、ZDELETE 订单拒绝标记、双向 SO 接口全套
相关页面¶
- TPM_SAP到纷享销客主数据同步接口规范 — 旧版 v1.0
- TPM主数据接口 — 接口字段口径总表
- S4_China_Enterprise_Structure — 销售组织编码规则权威
- 系统集成字段映射参考0612 — deprecated 旧映射