旺店通集成专题

旺店通与金蝶云星空对接方案

旺店通管订单和发货,金蝶管财务和库存。销售出库、退货入库、收款按类同步到金蝶云星空,不用再靠人导表。旺店通的开放接口本身收费,这部分报价时单独列出来。

旺店通对接金蝶难在哪

旺店通集成面临的挑战

接口本身要收费

旺店通开放平台对接口调用单独收费:基础接口按次或按年,扩展接口按调用量。很多人以为只付开发费,做到一半才发现还有这笔。

企业版、旗舰版分开申请

旺店通企业版和旗舰版在开放平台是两套,分别申请、接口也不一样。动手之前要先确认你们用的是哪个版本。

重推既重单又多花钱

网络一卡就重推,金蝶里多出一张单;而旺店通接口按次计费,每重推一次还多付一次调用费。

鹰翔:旺店通集成解决方案

旺店通对接方案

方案概述

通过旺店通开放平台按增量拉取销售出库、退货入库、收款数据,在集成网关里完成字段映射和编码对照,再调用金蝶云星空 WebAPI 保存、提交、审核。

对接鹰翔的优势

  • 报价前把旺店通接口费讲清楚,单独列一行
  • 单号级幂等去重:不重单,也不多付调用费
  • 失败分级重试,资料缺失挂起并列出原因
  • 买断版装在你们服务器上,源码交付
旺店通开放平台销售出库 · 退货入库 · 收款 · 商品 · 店铺 · 仓库
增量拉取(按次计费,只拉一次)
鹰翔集成网关

转换

字段映射商品 → 物料店铺 → 客户仓库对照

可靠性

幂等去重分级重试挂起待处理报文留痕
WebAPI 保存 · 提交 · 审核
金蝶云星空销售出库单 · 销售退货单 · 收款单 · 回写单号

先说钱:旺店通的接口怎么收费

按旺店通开放平台公布的规则:

项目怎么收
基础接口所有商家都能用,申请授权后使用,按一次或按年收费
扩展接口用于特定业务,要旺店通审批,按调用次数收费
环境搭建费向旺店通 / 慧策的销售咨询并支付
调用量增值包0.2 元 / 100 次 / 每个 AppKey

依据:旺店通开放平台的公开说明,具体金额以旺店通销售报价为准。这部分钱付给旺店通,不经过我们。

同步策略

旺店通 → 金蝶云星空,同步哪些数据

每个月单量太少的,接口费加开发费可能比手工录还贵,先算一笔账再决定。

#旺店通金蝶云星空类别方式
1商品物料基础资料编码对照,以金蝶为准
2店铺客户基础资料每个网店对应一个客户
3仓库仓库基础资料编码对照
4销售出库销售出库单业务单据定时增量,逐单
5退货入库销售退货单业务单据定时增量,逐单
6收款收款单业务单据按需要加

核心能力与技术参数

一套集成网关:接入层 — 任务队列 — 适配器

业务系统和目标系统解耦,单据推送全程可监控、可追溯、可重放。下面每一条都对应对接程序里已经实现的功能,推送监控演示里能直接点。

异步任务队列

单据提交即受理即返回,后台队列调度执行,业务系统不用等。

幂等去重

以「连接 + 单据类型 + 单号」为唯一键,重复推送自动拦截,杜绝重单。

分级自动重试

网络、超时、数据锁定逐级退避重试;资料缺失、校验不过即时挂起并记录原因。

全链路报文审计

每一次请求与响应全量落库,密钥字段自动脱敏,问题逐笔可追溯。

配置化字段映射

映射规则与程序分开,换账套、调字段不用改代码。

推送监控

推送总数、完成、失败、排队、幂等拦截一屏可见,失败单据一键重推。

基础资料同步

客户、物料档案从目标系统拉回本地统一对码,两边不用重复维护。

多连接管理

测试账套、正式账套、多个账套独立配置,切换不改业务代码。

用量统计

每月推成功多少张、按单据类型拆开、最近三个月平均,一屏可见,可导出对账。

技术参数规格
运行环境Node.js 22 及以上,Windows / Linux
数据存储SQLite 本地持久化,任务状态与报文落盘,服务重启后排队任务继续执行
调度周期默认 5 秒轮询,可配置
重试策略最多 6 次,30 秒 / 2 分钟 / 10 分钟 / 30 分钟 / 1 小时 / 3 小时逐级退避
重试范围网络异常、请求超时、数据锁定、服务端错误;校验、认证、重复类错误不重试
报文留存默认 30 天,超期自动清理,可配置
接入协议HTTP + JSON,Bearer 令牌鉴权,提供健康检查接口
金蝶登录方式签名登录 LoginBySign(金蝶官方推荐,SHA256 / 老版本 SHA1);同一账套会话复用,过期自动重登
用量统计按月统计推送成功的单据张数(重复推送只算一次),页面可查、可导出,托管订阅按这个定档
部署方式私有部署到客户服务器,或由我们托管运行

以上为对接程序当前版本的默认配置,可按项目调整。

实施准备

要你们准备什么

旺店通接口开通

我们在旺店通开放平台申请应用,上线时填你们的正式卖家账号,审核后拿到正式环境密钥;接口费由你们付给旺店通。

金蝶授权

金蝶管理员在「第三方系统登录授权」里新增一个应用,把应用 ID 和密钥给我们。

编码对照

商品、店铺、仓库在两边分别叫什么,我们整理好表格,你们确认。

运行环境

买断版装在你们自己的服务器上;选托管订阅的,服务器由我们提供。

大概多少钱

同步商品、店铺、仓库 3 类基础资料,加销售出库、退货入库、收款 3 类单据:

基础资料 3 类 × 2,000 元 + 业务单据 3 类 × 4,000 元

= 实施费 18,000 元(旺店通接口费另付给旺店通)

按类计价,要哪几类算哪几类。之后二选一:托管 3,600 元/年起(按每月单量分档),或者买断——实施费加 4,000 元源码授权费,装你们自己服务器、源码交付,以后不交年费。用价格页的计算器算一下。

开始你的旺店通集成项目

告诉我们你们的旺店通是企业版还是旗舰版、金蝶版本和每个月大概多少单,接口费和实施费一起算清楚再报价。

立即咨询