聚水潭对接金蝶难在哪
聚水潭集成面临的挑战
聚水潭自己带了一个金蝶、用友对接。能用的直接用；下面这几条接受不了的，才需要单独做。
自带对接要等月结
聚水潭自带的财务软件对接，要在聚水潭做完财务结算（结账）之后才能传，一般按自然月。月中在金蝶里看不到当月的销售和库存。
按汇总传，追不到原始单
销售出库按「商品 + 日期」或「店铺 + 商品 + 日期」汇总传。客户对账、查差异时，追不到具体是哪一张单。
版本和编码对不上
自带对接只支持部分金蝶、用友版本；商品、店铺、仓库在两边编码不同，对不上单据就推不进去，推失败了还没人知道。
鹰翔：聚水潭集成解决方案
聚水潭对接方案
方案概述
通过聚水潭开放平台拉取出库、售后、采购等单据，在集成网关里完成字段映射和编码对照，再调用金蝶云星空 WebAPI 保存、提交、审核，把金蝶单号回写记录。整个过程按设定频率自动跑，不用等月结。
对接鹰翔的优势
- 一单一单传，金蝶里能对到每一张原始单
- 同一张单重复推送不会重复入账
- 失败自动重试，挂起的单据列出原因，一键重推
- 买断版装在你们服务器上，源码交付
转换
可靠性
聚水潭自带对接 vs 单独对接
聚水潭在官方百科里写明了自带的财务软件对接能做什么，拿来对照一下：
| 聚水潭自带对接 | 鹰翔单独对接 | |
|---|---|---|
| 什么时候传 | 聚水潭做完财务结算之后才能传，一般按自然月 | 按设定频率传，不用等月结 |
| 传到什么粒度 | 销售出库按汇总传：商品 + 日期，或店铺 + 商品 + 日期 | 逐单传，金蝶里能对到每一张原始单 |
| 支持的金蝶版本 | K3 14.0 / 14.2、KIS 旗舰版 4.0 / 4.2 / 5.0、K3Cloud | 看对方开放了什么接口，接之前先确认 |
| 支持的用友版本 | U8 12.1 / 12.5、T+ 12.0 | 同上 |
| 传的内容 | 仓库、供应商、商品、店铺、业务员；采购进仓、销售出库、其他出入库、进仓补入 | 按需要选，按类计价 |
| 谁来配 | 聚水潭的实施人员提供接口程序 | 我们做，买断版源码交付 |
左栏依据：聚水潭官方百科「财务软件对接（金蝶、用友）」，以聚水潭最新说明为准。月底汇总进一次账就够用的，用自带的就行，这篇文章写了怎么判断。
同步策略
聚水潭 → 金蝶云星空，同步哪些数据
按你们实际要用的选，不用的不做。基础资料先对上，单据才推得进去。
| # | 聚水潭 | 金蝶云星空 | 类别 | 方式 |
|---|---|---|---|---|
| 1 | 商品 | 物料 | 基础资料 | 编码对照，以金蝶为准 |
| 2 | 店铺 | 客户 | 基础资料 | 每个网店对应一个客户，方便按店出报表 |
| 3 | 仓库 | 仓库 | 基础资料 | 编码对照 |
| 4 | 销售出库单 | 销售出库单 | 业务单据 | 定时增量，逐单 |
| 5 | 售后退货 | 销售退货单 | 业务单据 | 定时增量，逐单 |
| 6 | 采购入库 | 采购入库单 | 业务单据 | 定时增量，逐单 |
| 7 | 其他出入库、调拨 | 其他出入库单、调拨单 | 业务单据 | 按需要加 |
异步任务队列
单据提交即受理即返回，后台队列调度执行，业务系统不用等。
幂等去重
以「连接 + 单据类型 + 单号」为唯一键，重复推送自动拦截，杜绝重单。
分级自动重试
网络、超时、数据锁定逐级退避重试；资料缺失、校验不过即时挂起并记录原因。
全链路报文审计
每一次请求与响应全量落库，密钥字段自动脱敏，问题逐笔可追溯。
配置化字段映射
映射规则与程序分开，换账套、调字段不用改代码。
推送监控
推送总数、完成、失败、排队、幂等拦截一屏可见，失败单据一键重推。
基础资料同步
客户、物料档案从目标系统拉回本地统一对码，两边不用重复维护。
多连接管理
测试账套、正式账套、多个账套独立配置，切换不改业务代码。
用量统计
每月推成功多少张、按单据类型拆开、最近三个月平均，一屏可见，可导出对账。
| 技术参数 | 规格 |
|---|---|
| 运行环境 | Node.js 22 及以上，Windows / Linux |
| 数据存储 | SQLite 本地持久化，任务状态与报文落盘，服务重启后排队任务继续执行 |
| 调度周期 | 默认 5 秒轮询，可配置 |
| 重试策略 | 最多 6 次，30 秒 / 2 分钟 / 10 分钟 / 30 分钟 / 1 小时 / 3 小时逐级退避 |
| 重试范围 | 网络异常、请求超时、数据锁定、服务端错误；校验、认证、重复类错误不重试 |
| 报文留存 | 默认 30 天，超期自动清理，可配置 |
| 接入协议 | HTTP + JSON，Bearer 令牌鉴权，提供健康检查接口 |
| 金蝶登录方式 | 签名登录 LoginBySign（金蝶官方推荐，SHA256 / 老版本 SHA1）；同一账套会话复用，过期自动重登 |
| 用量统计 | 按月统计推送成功的单据张数（重复推送只算一次），页面可查、可导出，托管订阅按这个定档 |
| 部署方式 | 私有部署到客户服务器，或由我们托管运行 |
以上为对接程序当前版本的默认配置，可按项目调整。
实施准备
要你们准备什么
聚水潭授权
我们在聚水潭开放平台发起授权，你们用聚水潭主账号登录确认一下。
金蝶授权
金蝶管理员在「第三方系统登录授权」里新增一个应用，把应用 ID 和密钥给我们。公有云新账套只能走这条。
编码对照
商品、店铺、仓库在两边分别叫什么，我们整理好表格，你们确认。
运行环境
买断版装在你们自己的服务器上；选托管订阅的，服务器由我们提供。
大概多少钱
标准包
商品、店铺、仓库 3 类基础资料 + 销售出库、售后退货 2 类单据，含上线联调和 15 天保修：
= 12,800 元（一次性）
要加采购入库、收款，一类 4,000 元。之后二选一：托管 3,600 元/年起（按每月单量分档，500 单以内 3,600、2,000 单以内 6,000、1 万单以内 9,600），或者买断 16,800 元——装在你们自己服务器上、源码交付，以后不交年费。完整价格说明。
推荐阅读
数据集成实战与案例
聚水潭对接金蝶：自带的对接能做什么、三个限制、什么时候够用
聚水潭自带金蝶、用友对接，但要等财务结算后才传、销售出库按汇总传、只支持部分版本。三条都能接受的，用它就行。
金蝶云星空 WebAPI 实测：两个接口参数结构不一样，还有这几个坑
查询和详情两个接口，一个 FormId 放里面、一个 formid 放外面还得小写；查询返回二维数组；公有云新账套只能走第三方授权。
查看全部文章金蝶、金蝶云星空、聚水潭为各自权利人的商标，本页仅用于说明对接对象，鹰翔科技与上述公司不存在隶属、代理或授权关系。聚水潭自带对接的说明引自聚水潭官方百科。