接入你的 ERP / CRM

适用对象：已经有自己一套 ERP / CRM（金蝶、用友、聚水潭、旺店通、SAP、Salesforce，或自建系统）的商户。
入口：console → Integrations（/console/integrations）

这件事解决什么

你的库存、订单、客户数据在自己的系统里，agent 却看不到。传统做法是「先做一次数据同步」——那就有了两套数据、两个真相源，对不上账时没人说得清。

这里的做法是反过来的：不复制你的数据，只把「查一次」变成一个 agent 能调用的能力。 agent 需要库存时问一次，拿到的结果作为一条带时间戳的快照事实记下来：

谁在什么时候、向哪个地址、问了什么、返回了什么

对账时能追到每一条。

四步接入

1. 选连接器

在 console 里选厂商。目录按 ERP / CRM / 自建系统分组：

分类	连接器
ERP	金蝶云星空、用友 YonSuite、聚水潭、旺店通、SAP S/4HANA
CRM	Salesforce
自建 / 私有化部署	通用 REST

2. 填实例地址与凭据

字段	说明
实例地址	你自己的系统地址，必须 HTTPS。SaaS 版要求域名属于该厂商；私有化部署请选「通用 REST」
凭据	按连接器要求填（账号密码 / Token / API Key）。加密存储，保存后界面上只看得到「已配置」

3. 做一次自检

点「自检」，平台会真的向你的地址发一次请求，并记录结果：

结果	含义	下一步
`2xx`	地址通、认证也过	可以发布
`401` / `403`	地址通，但凭据不对	改凭据
`404` / `405`	地址通，路径可能要调整	确认实例地址是否带了多余路径
连不上 / 超时	地址、网络或防火墙问题	检查地址与外网可达性

地址通但凭据错，仍然是「已就绪」——因为那是能改的配置问题，不该卡住你。

4. 发布给 agent

勾选要开放的能力（库存查询 / 订单查询 / 客户查询…），发布之后 agent 就能在任务里调用。界面上会标出哪些能力「可调用」。

什么时候需要运维配合

如果实例在内网，公网访问不到，或者你用的是私有化部署：联系运维用 INTEGRATION_ALLOW_HOSTS 显式放行你的主机。

这个开关默认是空的，放行只跳过「本机 / 内网 / 管理端口」检查， HTTPS 要求与厂商域名规则仍然生效。

变更与撤销

你做的事	平台的行为
改实例地址	撤销已发布的能力，需要重新自检
改凭据	撤销已发布的能力（旧凭据已失效）
取消某个能力	只撤销那一个
停用 / 删除连接	撤销全部

服务重启后平台会自动恢复已发布的能力，不需要你重新点发布。

常见问题

数据会同步过来吗？ 不会，也不打算这么做。平台只在需要时问一次，并把答案记成快照事实。要的是「可追溯」，不是「再存一份」。

能写回我的系统吗？ 可以，取决于连接器提供了哪些能力（部分连接器有「订单创建 / 通用写入」）。写回同样要经过自检与发布。

支持哪些认证方式？ Basic、Bearer Token、API Key 三种。厂商专有的签名算法不在平台侧实现——如果你的系统需要，可以在前面挂一层轻量适配端点。

凭据安全吗？ 加密存储（AES-256-GCM），接口从不返回明文或密文，只告诉你「已配置哪些字段」。

接入你的 ERP / CRM ​

这件事解决什么 ​

四步接入 ​

1. 选连接器 ​

2. 填实例地址与凭据 ​

3. 做一次自检 ​

4. 发布给 agent ​

什么时候需要运维配合 ​

变更与撤销 ​

常见问题 ​

相关 ​