跳到主要内容

ERP对接中心 — 用户操作手册

功能概述​

ERP 对接中心用于把啤啤猩球 OS 和您的 ERP 系统连接起来。连接完成后，商品、客户、订单等常用资料可以按设置自动同步，减少重复录入。

前置条件
  • 已登录品牌管理后台
  • 您的账号具备系统设置权限（通常为管理员）
  • 已购买并部署目标ERP系统
  • 已准备好 ERP 管理员账号，以及 ERP 服务商提供的接入信息

一、页面总览​

进入「ERP对接中心」页面后，您将看到以下区域：

区域说明
ERP系统选择区选择要对接的ERP系统类型
连接配置区填写 ERP 提供的连接信息
数据同步设置区选择哪些资料要同步、按什么方向同步
同步任务列表查看同步是否成功、失败原因是什么
操作按钮区保存配置、测试连接、开始同步

支持的ERP系统​

ERP系统版本要求支持功能
管家婆 NGPV1.0及以上商品同步、客户同步、订单同步
金蝶云星空标准版/企业版商品同步、客户同步、订单同步

二、配置管家婆NGP对接​

Step 1：选择ERP系统​

  1. 在页面顶部的ERP系统选择区，点击「管家婆NGP」选项卡
  2. 系统将显示管家婆NGP的专属配置界面

Step 2：填写连接信息​

在「连接配置」区域填写以下信息：

配置项必填说明
应用ID是管家婆NGP分配的应用标识
应用密钥是管家婆NGP分配的应用密钥
企业ID是您的企业在管家婆NGP中的唯一标识
API地址是管家婆NGP的API服务地址
提示

如果您不清楚这些信息在哪里获取，建议联系管家婆实施人员或负责 ERP 的同事协助填写。

Step 3：选择同步内容​

在「数据同步设置」区域，按业务需要选择同步内容：

3.1 商品资料同步​

  • 同步方向：

    • 啤啤猩球OS → 管家婆NGP（单向同步）
    • 管家婆NGP → 啤啤猩球OS（单向同步）
    • 双向同步

  • 同步触发方式：

    • 实时同步（数据变更立即触发）
    • 定时同步（按设定时间间隔同步）
    • 手动同步（人工触发）

3.2 客户资料同步​

  • 同步方向：选择数据从哪边同步到哪边
  • 客户分类对应：确认 ERP 里的客户分类要对应到系统中的哪类客户

3.3 订单数据同步​

  • 同步方向：通常设置为 啤啤猩球OS → 管家婆NGP
  • 订单状态映射：
    • 待发货 → 待处理
    • 已发货 → 已出库
    • 已完成 → 已完成
  • 同步时机：订单确认后自动同步

Step 4：测试连接​

  1. 填写完所有配置信息后，点击「测试连接」按钮
  2. 系统将尝试连接管家婆NGP服务器
  3. 根据提示结果：
    • 连接成功：可以继续保存配置
    • 连接失败：请检查网络、API地址、密钥等信息

Step 5：保存配置​

  1. 确认连接测试通过
  2. 点击「保存配置」按钮
  3. 系统提示「保存成功」即表示配置完成

三、配置金蝶云星空对接​

Step 1：选择ERP系统​

  1. 点击「金蝶云星空」选项卡
  2. 系统将显示金蝶云星空的专属配置界面

Step 2：填写连接信息​

配置项必填说明
数据中心ID是金蝶云星空的数据中心标识
应用ID是金蝶云星空开放平台应用ID
应用密钥是金蝶云星空应用密钥
用户名是金蝶云星空登录账号
密码是金蝶云星空登录密码
获取方式

登录金蝶云星空 → 系统管理 → 系统集成 → 开放平台 → 创建应用

Step 3：选择同步内容​

配置方式与管家婆 NGP 类似，请参考上文「Step 3：选择同步内容」。

Step 4：完成授权​

金蝶云星空需要先完成一次授权确认：

  1. 点击「开始授权」按钮
  2. 系统将跳转至金蝶云星空授权页面
  3. 使用金蝶管理员账号登录并确认授权
  4. 授权成功后自动返回ERP对接中心
说明

授权过程中会跳转到金蝶云星空官方页面。只要按页面提示完成确认即可，不需要手动处理技术参数。

Step 5：测试连接并保存​

  1. 点击「测试连接」验证配置
  2. 测试通过后点击「保存配置」

四、管理同步任务​

查看同步任务​

在「同步任务列表」区域，您可以查看：

字段说明
任务ID任务编号
任务类型商品同步/客户同步/订单同步
同步方向数据来源 → 数据目标
执行时间任务开始执行的时间
执行状态待执行/执行中/成功/失败
数据量同步的数据条数
操作查看详情、重新执行

手动触发同步​

  1. 在同步任务列表中找到需要执行的任务
  2. 点击「立即同步」按钮
  3. 系统将立即启动同步流程
  4. 可在列表中查看同步进度和结果

查看同步日志​

  1. 点击任务行的「查看详情」按钮
  2. 在详情页面查看：
    • 同步开始/结束时间
    • 成功同步的数据明细
    • 失败的数据及失败原因
    • 异常处理建议

五、处理同步异常​

常见异常类型​

异常类型可能原因解决方案
连接超时网络不稳定或ERP服务器响应慢检查网络连接，稍后重试
认证失败授权失效，或 ERP 账号权限不足重新授权，或确认 ERP 账号权限
数据格式错误两边资料填写方式不一致检查商品、客户、订单资料是否完整
数据重复同一批数据重复同步检查是否重复点击同步或重复导入
ERP端限制ERP 侧限制了同步频率稍后重试，或联系 ERP 服务商

异常处理流程​

  1. 在同步任务列表中找到状态为「失败」的任务
  2. 点击「查看详情」查看错误信息
  3. 根据错误类型采取相应措施：
    • 网络问题：检查网络后点击「重试」
    • 配置问题：修改配置后重新测试连接
    • 数据问题：修正数据后手动触发同步
  4. 如无法解决，可点击「导出日志」联系技术支持

六、启用/停用对接​

停用对接​

  1. 在页面顶部找到「对接状态」开关
  2. 将开关切换为「关闭」
  3. 确认停用后，系统将停止所有自动同步任务
  4. 已配置的信息会保留，可随时重新启用

启用对接​

  1. 将「对接状态」开关切换为「开启」
  2. 系统将恢复自动同步任务
  3. 手动检查连接状态确保正常

七、删除对接配置​

警告

删除操作将清除所有对接配置和同步规则，已同步的数据不会删除，但后续将不再自动同步。

删除步骤​

  1. 点击页面底部的「删除对接配置」按钮
  2. 在确认对话框中输入「DELETE」确认
  3. 点击「确定」完成删除

常见问题​

问题原因与解决方案
测试连接提示"应用ID无效"请确认应用ID填写正确，且应用已在ERP系统中启用
授权后无法返回系统检查回调地址配置是否正确，或手动返回ERP对接中心页面
同步任务一直显示"执行中"可能是网络延迟或ERP系统响应慢，建议等待5-10分钟后刷新页面
部分数据同步失败查看同步日志，检查失败原因。常见原因：必填字段为空、数据格式不符
同步的数据在ERP中找不到检查同步方向设置，确认数据是同步到ERP还是从ERP同步
如何修改已保存的配置直接在配置页面修改参数，修改后需要重新测试连接并保存
可以同时对接多个ERP吗目前仅支持对接一个ERP系统，切换ERP需要先删除现有配置
同步频率如何设置在数据同步设置中选择"定时同步"，可设置间隔时间（最短5分钟）

最佳实践​

1. 配置建议​

  • 先测试后启用：正式启用前充分测试连接和数据同步
  • 小批量验证：首次同步建议选择少量数据进行验证
  • 定期检查：每周检查同步任务状态，及时处理异常

2. 数据安全​

  • 妥善保管ERP系统的密钥和密码
  • 定期更换API密钥
  • 启用操作日志记录，便于审计

3. 异常处理​

  • 建立异常处理机制，指定专人负责
  • 保留同步日志至少3个月
  • 定期备份重要数据