数据交换通过 amoCRM 私有集成和长期令牌完成。无需公开发布该集成。
ILFF 提供以下功能:
- 读取指定阶段的交易,并创建或更新配送申请;
- 将状态、跟踪号和跟踪链接写入交易,按配置更改阶段并添加备注;
- 交易进入 Закрыто и не реализовано(已关闭且未成交)阶段时,如果尚未开始拣货,则取消配送申请;
- 同步商品,先按货号、再按条码将其与 ILFF 商品关联。
当前版本不会向 amoCRM 同步库存。
ILFF 客户后台中用于接入的菜单项称为 amoCRM。为您的账号启用此平台后,该菜单项就会显示。
第 1 步:私有集成
- 以管理员权限登录 amoCRM。
- 打开 Настройки → Интеграции → Создать интеграцию(设置 → 集成 → 创建集成),创建私有集成。
- 授予其 Доступ к данным аккаунта(访问账号数据)权限。该权限用于读取交易、联系人和商品,以及写入订单状态和创建 ILFF 字段。
重要提示:对于私有集成,amoCRM 不提供系统错误方面的技术支持。接入时需要声明放弃此类支持。咨询服务及付款问题方面的帮助仍然可用。
第 2 步:长期令牌
- 打开已创建的集成,进入 Ключи(Keys and scopes,密钥和范围)标签页。
- 点击 Сгенерировать токен(生成令牌),选择有效期。建议有效期为 1 год(1 年)。
- 立即将令牌保存到安全的存储位置:此后 amoCRM 不会再次显示该令牌。请勿公开传输令牌,也不要将其保存在文档中。
长期令牌不会自动续期。令牌到期后,请在此集成中创建新令牌,并在 ILFF 客户后台的 amoCRM 区块中替换旧令牌。
第 3 步:接入和交易阶段
- 查找账号的完整地址:
https://<поддомен>.amocrm.ru。 - 在 ILFF 客户后台打开 amoCRM,填写账号地址和长期令牌。
- 选择 ILFF 读取交易的销售漏斗或具体阶段。如果未选择,则使用主销售漏斗的第一个处理中阶段。如果只选择销售漏斗而未选择阶段,则使用该漏斗的第一个处理中阶段。
- Неразобранное(未分类)阶段不适用于数据交换。请选择交易已包含配送所需数据的阶段。
接入时,ILFF 会自动创建缺失的交易字段:
- Трек ILFF(ILFF 跟踪号);
- Ссылка отслеживания ILFF(ILFF 跟踪链接);
- Статус ILFF(ILFF 状态)。
无需手动创建这些字段。
第 4 步:商品
- 在 amoCRM 设置中打开 Списки(列表),启用 Товары(商品)目录。
- 在商品卡片中填写货号和价格。为按条码关联,ILFF 会查找现有的 Штрихкод(条码)、ШК 或 Barcode 字段,或者自动创建 Штрихкод 字段。
- 将 Товары 目录中的商品行添加到交易,并填写整数数量。
ILFF 先按货号、再按条码查找匹配项。如果无法唯一关联商品,该商品会保留在客户后台的手动关联列表中。
如何为 ILFF 准备交易
- 填写主联系人、收件人姓名和电话号码。
- 在 Адрес(地址)类型的联系人字段中填写地址。城市为必填项。也可以改用 Адрес 文本字段。该字段可填写在交易中或其主联系人中。
- 从目录中添加商品行,并检查数量。
- 填写交易预算。该金额将成为订单总额和货到付款金额。商品行价格根据商品卡片中的价格计算。
- 将交易移至为 ILFF 选择的阶段。
如果未填写地址或商品,或者商品未与 ILFF 商品关联,则不会创建配送申请。该交易会连同原因一起显示在等待补充数据的列表中。
状态和取消
ILFF 将配送申请状态写入 Статус ILFF、Трек ILFF 和 Ссылка отслеживания ILFF 字段。状态实际发生变化时,会向交易添加备注;如果配置了对应关系,还会更改阶段。
要取消订单,请在开始拣货前将交易移至 Закрыто и не реализовано 阶段。删除交易也会取消关联的配送申请。如果已经开始拣货,请与 ILFF 协商取消事宜。
常见问题
- 令牌已过期或被撤销——请创建新的长期令牌,并在 ILFF 客户后台的 amoCRM 区块中替换旧令牌。
- 未创建 ILFF 字段——请检查 Доступ к данным аккаунта 权限以及创建集成的用户是否具有管理员权限,然后重新接入。
- 交易未进入 ILFF——请检查阶段、主联系人、包含城市的地址和商品行,并查看客户后台中等待补充数据的列表。
- 商品未关联——请检查商品卡片中的货号和条码,或在客户后台手动关联。
- 未找到商品目录——请在 amoCRM 的 Списках(列表)中启用 Товары 目录,然后重新接入。