集成

连接 E-Gestor ERP，把客户、产品和销售带入 CRM

用个人令牌连接您的 E-Gestor 账户，把客户、供应商、产品、服务、销售和财务记录带入 CRM，不产生重复数据。

E-Gestor 是一款巴西的云端 ERP。连接之后，CRM 会读取您的 E-Gestor 账户，并在这里持续更新客户、供应商、产品、服务、销售和财务记录，通过 E-Gestor 的编码相互关联。再次同步绝不会产生重复数据：它会更新已经存在的那条记录。

采用的是 BYO 模式（“自带账户”）：您使用自己的 E-Gestor 账户和自己的个人令牌。我们看不到您的数据，也不向您收取任何费用。集成一开始是静止的：在您粘贴令牌并启用之前，什么都不会发生。

💡 同步是单向的：从 E-Gestor 到 CRM。CRM 做的任何事都不会写进您的 ERP。销售根本无法通过 E-Gestor API 编辑（它的文档说要先删除再重建），而从这里去那边创建记录会让您的账目出现重复。

前提条件

一个 E-Gestor 账户。没有沙盒环境：每个账户都是独立的，所以如果想在连到真实数据之前先试一下，请先创建一个免费的测试账户。
个人令牌，在 E-Gestor 内的“设置 → API”（Configurações → API）中生成。
在 Sellio 中要有管理员身份（管理设置权限），才能在“设置 → 集成”中保存令牌。

第 1 步：在 E-Gestor 中生成个人令牌

登录 E-Gestor，打开“设置”菜单（Configurações）。
进入 API 选项卡，生成个人令牌。
复制这个令牌。它是一长串文本（一个 JWT），也是唯一长期有效的凭据：CRM 会用它自行换取短期访问令牌。

第 2 步：把令牌粘贴到 CRM 中

打开“设置 → 集成”，找到“E-Gestor ERP”卡片。
粘贴个人令牌并保存。它会加密保存，且不会再显示出来；以后把该字段留空即可保留当前令牌。
点击“测试连接”。它会从 E-Gestor 读取您的公司资料并显示账户名称，这样您就能在启用任何东西之前确认公司是否正确。
在“同步哪些内容”里，选择 CRM 要读取六组中的哪几组。客户、产品和销售默认开启；服务、应收账款和应付账款默认关闭。
点击“启用”。首次同步会在下一个计划周期运行，也可以用“立即同步”马上开始。

每样东西在 CRM 中的落点

带 CNPJ（14 位）的客户会变成“公司”；带 CPF 的会变成“联系人”。只登记为供应商或承运商的会变成“供应商”。同时登记为客户和供应商的，按客户导入。
产品和服务都会变成“产品”；服务会被标记为产品类型“服务”。
销售会变成“销售订单”，如果该客户已经同步过，就会关联到这个客户。状态 10（报价）变成“草稿”，50（销售）变成“已确认”，已取消的销售变成“已取消”。
应收账款和应付账款会变成所属客户或供应商时间线上的备注。

哪些内容不会同步，为什么

库存余额。CRM 有自己的库存模块和出入库流水账；把 ERP 里的数字写进去，就等于两个系统同时宣称同一个余额。
发票（NF-e 和 NFS-e）、采购、价格表、付款方式和会计科目表。E-Gestor API 里都有，但这里没有对应的对象，而为了一个连接器就凭空造一个，等于从外部改变了产品本身。
您 E-Gestor 中的自定义字段。连接器只读取每个资源中有文档说明的字段。
个人的 CPF 在“联系人”对象上没有标准字段，因此会写在名为 tax_id 的字段下。如果想在记录上看到它，请在“联系人”上创建一个同名的自定义字段；“公司”和“供应商”本来就有这个字段。

实时更新（webhook）

只要记录发生变化，E-Gestor 就可以主动调用 CRM，这样您就不用等下一次计划同步。

复制 Sellio 卡片上显示的 webhook 地址。
在 E-Gestor 中打开“设置 → API → Webhooks”（Configurações → API → Webhooks），注册这个地址，并启用“联系人、产品、销售”这几个模块。
回到 Sellio，再次点击“测试连接”：它会取回 E-Gestor 为您的 webhook 生成的安全令牌，并加密保存。从那时起，任何没有带上这个令牌的调用都会被丢弃。

💡 webhook 的“用户”和“财务”模块是故意不使用的。财务事件只带一个编码，并不说明这个编码是应收还是应付，据此行动就有可能动到错误的记录。这些记录仍然会通过计划同步进来，因为同步知道每一行来自哪个资源。在 E-Gestor 中删除的记录，在 CRM 里也不会被删除：您的团队通常已经在这里把它补充得更完整了。

速度和限制

E-Gestor 每分钟允许 60 次请求，每页返回 50 条记录。连接器有意保持在这个上限之下，并在触到上限之前就停下来，因此大账户的首次导入会分几次运行完成，而不会做到一半就失败。每次运行都从上一次停下的地方继续，而且因为一切都以 E-Gestor 的编码为锚点，即使运行之间有重叠，也只会更新而不会重复。

故障排查

“E-Gestor 拒绝了这个个人令牌”：令牌在 ERP 中被吊销或重新生成了。请在“设置 → API”（Configurações → API）中生成一个新的，然后再次粘贴。
启用之后什么都没出现：请检查您期待的那一组是否设成了“从 E-Gestor 同步过来”，并使用“立即同步”，不必等每天的周期。
webhook 好像没有触发：确认这个地址已经在 E-Gestor 中注册，并且启用了“联系人、产品、销售”模块，还要确认注册之后您点过“测试连接”，这样安全令牌才对得上。
数字看起来小数点错位：CRM 存储价格用的是小数，和 E-Gestor 发过来的一模一样。如果这里的价格不对，那边也是不对的。

在系统内打开这篇文章 →