聚水潭ERP对接京东店铺需完成七步：一、申请开发者资质并创建应用；二、配置京东店铺基础参数；三、通过OAuth2.0完成店铺授权；四、设置京东消息回调地址；五、执行商品与库存首次同步；六、开启订单自动同步与履约闭环；七、配置售后单双向同步。
如果您正在将聚水潭ERP系统与京东店铺进行对接，需完成开发者入驻、应用配置、店铺授权、回调设置及数据同步等关键环节。以下是实现该对接的完整操作步骤：
一、申请聚水潭开发者资质并创建应用
该步骤是对接的前提，只有成为聚水潭开放平台认证开发者，才能获取调用京东相关API所需的凭证信息。
1、访问聚水潭开放平台官网：https://openweb.jushuitan.com/，使用企业管理员账号登录。
2、进入【管理后台】→【我的应用】→【创建应用】，选择应用类型为“服务商应用”或“自研应用”，填写应用名称、描述等基本信息。
3、在应用创建完成后，记录页面显示的APP Key和APP Secret，后续配置中必须准确填写。
4、在【接口权限】模块中，搜索并勾选京东相关API权限，包括但不限于：商品同步、订单查询、发货回传、库存同步、售后单创建等，点击【一键申请】并等待审核通过。
二、获取京东店铺信息并配置基础参数
此步骤用于建立聚水潭与具体京东店铺的绑定关系，确保数据流向唯一且可控。
1、登录京东商家后台（POP平台）：https://shop.jd.com/，进入【店铺管理】→【店铺信息】，确认店铺类型（自营/POP）、店铺ID及店铺名称。
2、在聚水潭ERP管理后台（https://www.erp321.com/epaas）中，进入【系统设置】→【开放平台】→【京东对接设置】。
3、填写以下字段：京东店铺编号（shop_id）、京东AppKey、京东AppSecret、京东Access Token（需通过京东OAuth2.0流程获取），所有字段须与京东开放平台申请时一致。
4、点击【保存】按钮，系统校验参数格式与连通性，保存成功后方可进入授权环节。
三、完成京东店铺授权（OAuth2.0流程）
京东要求第三方系统通过标准OAuth2.0协议获取用户授权，以安全访问店铺数据，不可跳过或绕行。
1、在聚水潭京东对接设置页面，点击【立即授权】按钮，系统跳转至京东开放平台授权页。
2、使用京东POP店铺主账号（非子账号）登录，并勾选所需授权范围（如订单读取、发货写入、商品管理等）。
3、确认授权后，京东返回授权码（code），聚水潭自动完成token换取并持久化存储。
4、页面显示“已授权”状态及有效期倒计时，表示授权链路已打通。
四、配置京东消息推送回调地址
该配置使京东在发生订单创建、物流更新、售后申请等事件时，主动向聚水潭推送实时通知，避免轮询造成延迟与资源浪费。
1、在聚水潭京东对接设置页，复制【消息回调地址】字段值（格式为https://xxx.jushuitan.com/openapi/jd/notify）。
2、登录京东开放平台（https://jos.jd.com/），进入【应用管理】→【消息服务】→【消息订阅】。
3、点击【新增订阅】，选择消息类型（如：order_create、logistics_update、aftersale_apply），粘贴上述回调地址，勾选【启用】。
4、京东将发起签名验证请求，聚水潭自动响应验证成功后，该回调通道即生效。
五、执行商品与库存首次同步
首次同步用于将京东店铺现有商品结构、SKU、价格、库存等基础信息导入聚水潭，构建统一商品池。
1、确保京东商品已维护标准货号（item_code），且无重复；聚水潭中未存在同货号商品。
2、进入聚水潭【商品中心】→【京东商品同步】，点击【全量同步】按钮。
3、系统拉取京东商品列表，自动映射类目、规格、图片URL，并生成聚水潭内部商品编码。
4、同步完成后，在【商品列表】中筛选“来源：京东”，确认商品状态为“已同步”且库存数量与京东后台一致。
六、开启订单自动同步与履约闭环
该步骤确保京东订单实时流入聚水潭，并支持在聚水潭完成审单、打单、发货、物流回传全流程，形成业务闭环。
1、在聚水潭【订单中心】→【渠道订单设置】中，启用京东订单自动抓取，设置同步频率（建议5分钟/次）与时间范围（如近2小时）。
2、订单进入聚水潭后，按规则分配至对应仓库，操作【审核】→【打印面单】→【发货】。
3、发货动作触发物流单号回传至京东，京东后台订单状态自动更新为“已出库”，物流轨迹同步至买家端。
4、检查【订单日志】中京东渠道订单的“回传结果：success”及物流单号非空，确认履约链路通畅。
七、配置京东售后单双向同步
保障消费者在京东端发起的退换货申请能及时同步至聚水潭处理，并将处理结果反馈回京东，维持平台评分与体验一致性。
1、在聚水潭【售后中心】→【京东售后设置】中，启用售后单自动创建与处理结果自动回传开关。
2、当京东推送aftersale_apply消息后，聚水潭自动生成售后单，关联原订单、商品、问题类型及买家诉求。
3、在聚水潭完成审核（同意/拒绝）、退款、换货操作后，系统调用京东aftersale_process接口提交结果。
4、京东后台售后单状态更新为对应结果，买家端查看进度，且聚水潭售后日志中显示“京东回传成功”。
