RetailCRM(Simla)无需安装模块,也无需程序员即可接入 ILFF:ILFF 使用密钥通过 RetailCRM API 完成数据交换。
- 配送类型为“ILFF”的订单会自动进入 ILFF,并生成配送申请;
- 订单状态随配送申请状态更新,跟踪号、跟踪链接和 ILFF 状态会回写到订单字段;
- 您在 ILFF 仓库中的商品库存会同步到 RetailCRM 的“ILFF”仓库;
- 在 RetailCRM 取消订单时,如果配送申请尚未开始处理,ILFF 中的申请也会取消。
您需要:
- RetailCRM 管理员权限(用于创建配送类型、仓库和 API 密钥);
- ILFF 客户后台的访问权限。
接入大约需要 10 分钟。
RetailCRM 和 ILFF 客户后台均为俄语界面,下文按屏幕上的原文给出名称,并在首次出现时于括号中附上译文。
第 1 步:在 RetailCRM 中设置 ILFF 配送类型和仓库
- 打开 Настройки → Справочники → Типы доставок(设置 → 目录 → 配送类型),创建 ILFF 配送类型,符号代码为 ilff。需要由 ILFF 发货的订单,请选择此配送类型。
- 如果需要查看库存,请打开 Настройки → Склад → Склады(设置 → 仓库 → 仓库),创建 ILFF 仓库,符号代码为 ilff。
- 也可以使用自定义代码,但需要在接入时填写(第 3 步):配送类型和仓库必须使用相同的代码。
第 2 步:API 密钥
- 打开 Настройки → Интеграция → Ключи доступа к API(设置 → 集成 → API 访问密钥),点击 Добавить(添加)。
- 授予密钥访问网店的权限,ILFF 将从这些网店读取订单。
- 勾选以下权限:订单(读取和写入)、目录、仓库、自定义字段(读取和写入)。
- 保存并复制密钥。
第 3 步:在 ILFF 客户后台中接入
客户后台 → Интеграции(集成)标签页 → 展开 Интернет-магазин(网店)区块。
- Платформа(平台):选择 RetailCRM。
- Адрес магазина(网店地址):您的 RetailCRM 地址,例如
shop.retailcrm.ru。 - Код типа доставки и склада ILFF в RetailCRM(RetailCRM 中 ILFF 配送类型和仓库的代码):如果代码为“ilff”,请留空;否则填写自定义代码。
- Ключ API RetailCRM(RetailCRM API 密钥):第 2 步中的密钥。
- 勾选项 Выгружать остатки(同步库存):把 ILFF 仓库的库存同步到 RetailCRM 的“ILFF”仓库。
- 勾选项 Заказ с несвязанным товаром ждёт привязки(含未关联商品的订单等待关联):启用后,如果订单中的商品尚未与您在 ILFF 中的商品关联,该订单在关联完成前不会被接收(见第 4 步)。建议保持启用。
- 点击 Подключить(接入)。后台会验证密钥和配送类型,并在订单中创建“Трек ILFF”(ILFF 跟踪号)、“Ссылка отслеживания ILFF”(ILFF 跟踪链接)和“Статус ILFF”(ILFF 状态)字段。如果只修改设置,密钥栏可以留空。
第 4 步:关联商品
ILFF 每天自动读取一次 RetailCRM 的商品规格,先按条码、再按货号与您在 ILFF 中的商品关联。未匹配的商品可在客户后台的 Товары магазина(网店商品)按钮中查看:为每个商品选择您在 ILFF 中的商品,并点击 Привязать(关联)。
如何为 ILFF 提交订单
- 在订单中选择 ILFF 配送类型。
- 在订单字段中填写买家的名字、姓氏和电话号码。
- 在订单的配送区块中填写收货地址,邮编填写在地址中。
- 在运费栏中填写向买家收取的配送费用。
- 如果填写了配送日期和时间,它们将成为 ILFF 的配送日期和时间。
- 确认订单:将订单从“Новый”(新建)状态组移至任意处理中状态(例如“Согласовано”,已确认)。ILFF 不读取新订单,便于保留草稿。
数据交换方式
| 内容 | 时间 |
|---|---|
| 使用 ILFF 配送类型的订单(新订单除外) | 每隔几分钟:新订单和上次读取后有变更的订单 |
| 拣货前修改订单 | 配送申请随之更新;拣货后的修改会显示在客户后台中(“изменён после сборки”,拣货后已修改) |
| 订单处于“Отменен”(已取消)状态组 | 配送申请尚未开始处理时会被取消;否则请联系 ILFF 客户经理 |
| 订单处于“Выполнен”(已完成)状态组 | ILFF 不再修改该订单 |
| 跟踪号和跟踪链接 | 物流公司生成跟踪号后,立即写入订单字段 |
| 订单状态 | 已交给物流公司 → “Передан в доставку”(已交配送)(或“Доставляется”,配送中);已签收 → “Выполнен”(已完成);取消和拒收 → “Отменен”(已取消)(其他)。如果没有这些状态,则使用相应状态组中的第一个状态;“Статус ILFF”字段显示准确状态 |
| ILFF 仓库库存 | ILFF 库存每次变化后:同步到代码为 ILFF 的仓库中的“Доступно”(可用)字段 |
常见问题
- «RetailCRM не принял ключ API»(RetailCRM 未接受 API 密钥):密钥已删除、复制不完整或没有所需权限。
- «В RetailCRM нет типа доставки с символьным кодом …»(RetailCRM 中没有具有该符号代码的配送类型):请创建配送类型,或检查接入字段中的代码。
- «Не удалось создать поле заказа»(无法创建订单字段):请授予密钥访问自定义字段的权限,或手动创建字符串类型的订单字段,代码分别为
ilff_track_number、ilff_tracking_url、ilff_status。 - 订单没有进入 ILFF:检查订单是否选择了 ILFF 配送类型、订单是否不在“Новый”状态组,以及所有商品是否已关联(Товары магазина 按钮)。
- 其他问题请联系 ILFF 客户经理,或通过客户后台联系技术支持。