网店模块

将 amoCRM 接入 ILFF

另请参阅: 购物车配送组件 · ILFF API · 全部 CMS 模块

数据交换通过 amoCRM 私有集成和长期令牌完成。无需公开发布该集成。

ILFF 提供以下功能:

  • 读取指定阶段的交易,并创建或更新配送申请;
  • 将状态、跟踪号和跟踪链接写入交易,按配置更改阶段并添加备注;
  • 交易进入 Закрыто и не реализовано(已关闭且未成交)阶段时,如果尚未开始拣货,则取消配送申请;
  • 同步商品,先按货号、再按条码将其与 ILFF 商品关联。

当前版本不会向 amoCRM 同步库存。

ILFF 客户后台中用于接入的菜单项称为 amoCRM。为您的账号启用此平台后,该菜单项就会显示。

第 1 步:私有集成

  1. 以管理员权限登录 amoCRM。
  2. 打开 Настройки → Интеграции → Создать интеграцию(设置 → 集成 → 创建集成),创建私有集成。
  3. 授予其 Доступ к данным аккаунта(访问账号数据)权限。该权限用于读取交易、联系人和商品,以及写入订单状态和创建 ILFF 字段。

重要提示:对于私有集成,amoCRM 不提供系统错误方面的技术支持。接入时需要声明放弃此类支持。咨询服务及付款问题方面的帮助仍然可用。

第 2 步:长期令牌

  1. 打开已创建的集成,进入 Ключи(Keys and scopes,密钥和范围)标签页。
  2. 点击 Сгенерировать токен(生成令牌),选择有效期。建议有效期为 1 год(1 年)。
  3. 立即将令牌保存到安全的存储位置:此后 amoCRM 不会再次显示该令牌。请勿公开传输令牌,也不要将其保存在文档中。

长期令牌不会自动续期。令牌到期后,请在此集成中创建新令牌,并在 ILFF 客户后台的 amoCRM 区块中替换旧令牌。

第 3 步:接入和交易阶段

  1. 查找账号的完整地址:https://<поддомен>.amocrm.ru。
  2. 在 ILFF 客户后台打开 amoCRM,填写账号地址和长期令牌。
  3. 选择 ILFF 读取交易的销售漏斗或具体阶段。如果未选择,则使用主销售漏斗的第一个处理中阶段。如果只选择销售漏斗而未选择阶段,则使用该漏斗的第一个处理中阶段。
  4. Неразобранное(未分类)阶段不适用于数据交换。请选择交易已包含配送所需数据的阶段。

接入时,ILFF 会自动创建缺失的交易字段:

  • Трек ILFF(ILFF 跟踪号);
  • Ссылка отслеживания ILFF(ILFF 跟踪链接);
  • Статус ILFF(ILFF 状态)。

无需手动创建这些字段。

第 4 步:商品

  1. 在 amoCRM 设置中打开 Списки(列表),启用 Товары(商品)目录。
  2. 在商品卡片中填写货号和价格。为按条码关联,ILFF 会查找现有的 Штрихкод(条码)、ШК 或 Barcode 字段,或者自动创建 Штрихкод 字段。
  3. 将 Товары 目录中的商品行添加到交易,并填写整数数量。

ILFF 先按货号、再按条码查找匹配项。如果无法唯一关联商品,该商品会保留在客户后台的手动关联列表中。

如何为 ILFF 准备交易

  1. 填写主联系人、收件人姓名和电话号码。
  2. 在 Адрес(地址)类型的联系人字段中填写地址。城市为必填项。也可以改用 Адрес 文本字段。该字段可填写在交易中或其主联系人中。
  3. 从目录中添加商品行,并检查数量。
  4. 填写交易预算。该金额将成为订单总额和货到付款金额。商品行价格根据商品卡片中的价格计算。
  5. 将交易移至为 ILFF 选择的阶段。

如果未填写地址或商品,或者商品未与 ILFF 商品关联,则不会创建配送申请。该交易会连同原因一起显示在等待补充数据的列表中。

状态和取消

ILFF 将配送申请状态写入 Статус ILFF、Трек ILFF 和 Ссылка отслеживания ILFF 字段。状态实际发生变化时,会向交易添加备注;如果配置了对应关系,还会更改阶段。

要取消订单,请在开始拣货前将交易移至 Закрыто и не реализовано 阶段。删除交易也会取消关联的配送申请。如果已经开始拣货,请与 ILFF 协商取消事宜。

常见问题

  • 令牌已过期或被撤销——请创建新的长期令牌,并在 ILFF 客户后台的 amoCRM 区块中替换旧令牌。
  • 未创建 ILFF 字段——请检查 Доступ к данным аккаунта 权限以及创建集成的用户是否具有管理员权限,然后重新接入。
  • 交易未进入 ILFF——请检查阶段、主联系人、包含城市的地址和商品行,并查看客户后台中等待补充数据的列表。
  • 商品未关联——请检查商品卡片中的货号和条码,或在客户后台手动关联。
  • 未找到商品目录——请在 amoCRM 的 Списках(列表)中启用 Товары 目录,然后重新接入。

WeChat

微信二维码

用微信扫码添加

我们将在几分钟内回电

工作时间我们会立即回电,其他时间将在次日早上回电。周一至周五 11:00–20:00(莫斯科时间,UTC+3)。客户经理使用俄文或英文。