问达通本文件说明标准接口如何适配厂家既有 ERP。兼容是版本、模块、接口权限及业务规则确认后的集成结果，不是对所有厂商产品的开箱即用承诺。本次未实现、安装或认证任何连接器。
适配范围与官方依据
| 系统 | 官方开放能力依据 | 拟定适配方式 | 必须确认 |
|---|---|---|---|
| 金蝶云星空 | 官方 OpenAPI 平台公开基础信息与单据开放能力 | 通过官方 API 映射客户、物料及销售/发货单据 | 产品版本、组织、第三方授权、单据模型与自定义字段 |
| 用友 U8 | 官方 API 中心列出客户、存货、仓库、销售订单及发货单等接口 | 在厂商允许的版本与权限下建立客户和单据映射 | U8 版本、开放平台接入、账套、审核权限与接口许可 |
| 用友 U8 Cloud / YonSuite | 官方开发者中心提供相应产品开放平台入口 | 以客户所用产品的实际 API 文档逐项评估 | 产品不能混用接口、云租户授权、开放模块和组织 |
| 畅捷通 T+ 等 | 官方开放平台与 T+ 文档提供开发者和应用接入流程 | 应用授权后按具体版本的接口做适配 | T+ 具体版本/部署、企业授权、应用审核及单据能力 |
| 厂家自研 ERP | 以厂家提供的 API 或受控数据交换合同为准 | 实现与问达通标准对象之间的适配 | 维护团队、鉴权、幂等查询、网络边界与数据主系统 |
上述依据仅证明第三方存在开放入口，不证明问达通连接器已完成，也不证明客户购买的具体版本包含相关接口。未列出的 ERP、WMS 可按同一评估流程纳入，不标为已兼容。
官方参考链接
资料核对日期：2026-09-24。厂商页面和许可规则会变化，应在实施启动时重新确认。
- 金蝶云星空 OpenAPI：https://openapi.open.kingdee.com/ApiHome?lang=zh-CN
- 用友 U8 API 中心：https://open.yonyouup.com/apiCenter/index
- 用友开发者中心：https://developer.yonyou.com/openAPI
- 畅捷通开放平台：https://open.chanjet.com/
- 畅捷通 T+ 入门：https://doc.chanapp.chanjet.com/help/快速入门/构建沙箱必读/
本文件未使用厂商 Logo，厂商名称仅用于系统适配说明，不表示合作、授权背书或官方认证。
首期字段映射表
| 问达通对象 | ERP 常见对象语义 | 关键映射 |
|---|---|---|
| dealer_id | 客户档案 | 客户编码、账套、销售组织；不能仅用名称 |
| store_id | 客户收货单位或门店 | 明确一客多店关系与人员可见范围 |
| sku_id | 物料或存货 | 规格、基础单位、订货单位、箱规 |
| price_list_id | 客户价目表或报价策略 | 适用客户、含税口径、生效区间 |
| warehouse_id | 仓库或库存组织 | 可售库存口径、仓库授权、更新时间 |
| order_id | 外部来源单号 | 必须可唯一查询 ERP 单据，不重复建单 |
| erp_order_id | ERP 销售订单号 | 原订单主键与审核结果 |
| shipment_id | 发货单或出库单 | 多批次、多单号、订单行数量 |
| return_id | 售后申请或销退流程 | 申请、审核、实收与财务状态分开 |
以上为语义映射，不虚构通用厂商字段名。金蝶单据 FormId、用友具体字段和 T+ 接口路径，须依据客户版本官方文档及沙箱确认后形成项目映射附件。
实施步骤与各方责任
1. 厂家指定业务负责人、ERP 管理员和试点经销商；确认实际产品、版本、模块及接口采购许可。
2. 问达通实施方与 ERP 实施商确认只读/写入范围、数据主系统、字段映射、单位金额规则及回退方式。
3. ERP 方提供脱敏样例、沙箱和最小权限的服务账号；安全渠道交付凭据，文档和聊天不传密钥。
4. 适配方完成主数据同步与订单唯一映射；按异常清单验证失败、重复和乱序。
5. 厂家业务方用真实规则的试点数据验收。技术连通不等于业务验收，演示成功不等于生产成功。
6. 分批开放经销商，监控异常并执行对账。扩大范围前确认人员培训、客服支持与异常责任人。
联调验收清单
| 场景 | 验收结果要求 |
|---|---|
| 一经销商多门店 | 账号只能查看获授权门店，客户编码映射无串户 |
| 价格可见性 | A 经销商不能获取 B 的专属价，失效价格不可继续成交 |
| 10箱每箱6袋 | ERP 数量正确为10箱或60袋，金额与明确计价单位一致 |
| 网络超时重试 | 同业务订单 ID 在 ERP 只生成一张单，结果未知时先查后恢复 |
| 相同 key 不同 body | 返回冲突，不覆盖已有业务 |
| 旧版本和乱序回调 | 不把已取消或已发货状态退回旧值 |
| ERP 拒单 | 经销商看到具体结果，不显示接单成功 |
| 调价 | 必须重新确认，不静默改变已提交金额 |
| 分两批发货 | 两个发运单、数量和订单行对应，累计不超订货量 |
| 批次与保质期 | 实际出库批次与生产/失效日期可关联，不能从SKU猜批次 |
| 取消与发货竞争 | 由ERP最终确认，已实际出库不能只改前端成已取消 |
| 停用客户和商品 | 拦截新需求，历史业务保留且访问受权限约束 |
| Token或Webhook失效 | 失败可定位并安全恢复，不泄漏密钥、不绕过鉴权 |
| Webhook重复或丢失 | 去重生效，游标补偿找回事件 |
| 游标过期 | 返回明确错误并完成受控对账恢复，不静默丢单 |
| 上线回退 | 可暂停写入并恢复厂家既有ERP工作流程，保留已生成单据及映射 |
回退与业务保全
上线前记录每个连接、映射版本、启用范围和异常处理人。出现异常时先停适配层的新写入和经销商新提交，保留查询及证据；核对已进入 ERP 的业务单，不删除或反向扣库存。未受理需求可以重新分配处理，已审核、出库和财务相关单据按 ERP 原撤销/冲销流程办理。旧版本恢复前确认数据兼容性，不能用程序回退代替业务回退。
待客户填写的信息
公司与品牌名称、ERP 名称/版本/部署方式、账套与组织、接口授权联系人、经销商及门店结构、SKU与单位样表、报价与审核规则、发货与物流来源、试点范围、允许数据范围、验收负责人、运维响应和服务合同。仅使用脱敏样例；不在此表填账号密码或访问令牌。