跳转至

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 接口全套

相关页面