跳转至

SAP到纷享销客主数据同步接口规范

最后变更：2026-09-04 20:18

📥 2026-08-29 入库。两份接口规范 v1.0（2026-08-07，何锐burning），SAP → 纷享销客ERP 主数据同步。

📝 摘要

  • 两份接口共用同一 webhook：POST https://open.fxiaoke.com/erp/syncdata/open/webhook/834636/6a2a1b4e0cfd5800077d9505/f49790274d16405e1c5b4f4f2694c534，JSON/UTF-8，仅 Content-Type header
  • formId 区分：物料=MARA，客户=CUST；响应统一 {"code":0,"msg":"success"}，错误码仅 0/400/401/500 四个
  • 完整字段定义、校验规则、枚举值见原文 docx（原件已存 assets/TPM接口规范/）

1. 物料主数据同步（formId=MARA）

  • 结构：dataList[] → MARA 基本 + MAKT 描述 + MARC_LIST 工厂(可选) + MVKE_LIST 销售视图(可选)
  • 必填：MATNR(18)、MTART(4)、MATKL(9)、MEINS(3)、MAKT.SPRAS(1)、MAKT.MAKTX(≤40)
  • 可选：GROES、VOLUM/VOLEH、NTGEW/GEWEI、BRGEW、ERSDA/LAEDA(YYYYMMDD)、PRCTR、LGORT、MMSTA、EKGRP、MVGR2-5
  • 删除标记：LVORM_MARA / LVORM_MARC，仅允许空或 "X"
  • 关键枚举：
  • MTART：FERT成品/HALB半成品/ROH原材料/FDFG CH FOOD-成品/PROM促销品类
  • WERKS：B5F0上海RHQ、R5F1兴化、R5F2东阿、R5F3阜新、R5F5咸阳、R5F6韶关
  • EKGRP：CF1直接材料/CF2直接包装/CF3间接/CF8 STO/CF9 TM
  • MMSTA：01采购仓库冻结/02 BOM冻结/81 MPN:BOM抬头/Z7生产库存移动冻结
  • VKORG：文档写 IG00韶关/IL00兴化/IM00东阿/IQ00阜新/IR00咸阳/IX00中国RHQ — 🚨 2026-08-29 Kabin 确认：文档枚举有误，~~权威口径销售组织=IG20/IL20/IM20/IQ20/IR20/IX20（公司代码前2位+20）~~

    🚨 2026-09-01 再修正（EDM Daisy 邮件）：China Food 属 Branded，编码规则改为 KDD Global 标准——XX00-XX19=Branded，XX20-XX99=Trading。原 XX20 系列编码作废。 ✅ 2026-09-02 重排完毕（Kabin 确认）：China Food 销售组织 = {公司代码前2位}00，即 IX00(RHQ)/IL00(兴化)/IM00(东阿)/IQ00(阜新)/IR00(咸阳)/IG00(韶关)（与公司代码同码，BRD 段）。China Agri 维持 XX20。以 S4_China_Enterprise_Structure 为准

  • VTWEG：01直销/02经销商/03电商/10 Export/20 Local
  • 计量单位300+条、库存地点50+条 → 附件 Excel Sheet6/8/13

2. 客户主数据同步（formId=CUST）

  • 结构：dataList[] → header（客户基本）+ items[]（销售范围，必填≥1条）+ items[].KUNN2 合作伙伴(SP/SH/BP/PY，可选)
  • header 必填：BU_GROUP(4)、KUNNR(10)、NAME1(40)、STREET(60)、CITY1(40)、BEZEI(省/地区)、COUNTRY(2)
  • items 必填：VKORG、VTWEG、SPART、KTEXT客户渠道、BZIRK大区、VKBUR营业部、VKGRP营业所、VWERK发货工厂、INCO1/INCO2贸易条款、VSBED运输条件（及各 DESC 描述字段）
  • 冻结/删除（均可选）：CASSD销售冻结(2)、LOEVM_COMPANY、LOEVM_SALES、SPERR过账冻结
  • 关键枚举：
  • BU_GROUP：B3RD第三方/BAFF关联方/BONT一次性/BSHP收货方/BPPL工厂
  • SPART：BF品牌/ZO其他；KTEXT：01 GT/02 EC/03 MT/05 OT/06 MK/07 IC
  • BZIRK：CHQ1 HQ、CN01东北…CN08特通；VKBUR 22条、VKGRP 79条、省34条、付款方式50+、贸易条款17条 → 附件 Excel Sheet8/9/11/15/16
  • ZTERM 示例：0001立即到期/H0款到发货/H30/H60/M30/M60月结/N30/C40

⚠️ 审阅要点（2026-08-29 记录，待与何锐/集成方确认）

  1. 无部分成功语义 — 批量 dataList 响应只有整体 code/msg，无逐条回执；批量出错时的失败粒度（整批失败 or 跳过）未定义
  2. URL 内嵌 token 认证 — 两接口共用同一 URL/token，无有效期与轮换约定，日志泄露风险高于 header 认证，且无法按接口做权限隔离
  3. 冻结/删除字段全可选且无默认值口径 — 客户被冻结但字段未传时，ERP 侧状态如何收敛未定义
  4. 客户接口必填面过宽 — items 的 VKGRP/INCO1/INCO2 等全部必填，一次性客户(BONT)等场景 SAP 侧数据完整度存疑
  5. KUNN2 合作伙伴整体可选 — PY 付款方缺省时的结算主体未定义，财务对账风险
  6. 标记删除下游口径未定义 — LVORM/LOEVM=X 后纷享销客侧是停用、归档还是物理删除
  7. 错误码仅4个 — 枚举校验失败（如79个营业所）统一 400，SAP 侧无法按错误类型自动重试
  8. PRCTR 利润中心无枚举参考

🔗 关联