网店模块

将 RetailCRM 接入 ILFF

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

RetailCRM(Simla)无需安装模块,也无需程序员即可接入 ILFF:ILFF 使用密钥通过 RetailCRM API 完成数据交换。

  • 配送类型为“ILFF”的订单会自动进入 ILFF,并生成配送申请;
  • 订单状态随配送申请状态更新,跟踪号、跟踪链接和 ILFF 状态会回写到订单字段;
  • 您在 ILFF 仓库中的商品库存会同步到 RetailCRM 的“ILFF”仓库;
  • 在 RetailCRM 取消订单时,如果配送申请尚未开始处理,ILFF 中的申请也会取消。

您需要:

  • RetailCRM 管理员权限(用于创建配送类型、仓库和 API 密钥);
  • ILFF 客户后台的访问权限。

接入大约需要 10 分钟。

RetailCRM 和 ILFF 客户后台均为俄语界面,下文按屏幕上的原文给出名称,并在首次出现时于括号中附上译文。

第 1 步:在 RetailCRM 中设置 ILFF 配送类型和仓库

  1. 打开 Настройки → Справочники → Типы доставок(设置 → 目录 → 配送类型),创建 ILFF 配送类型,符号代码为 ilff。需要由 ILFF 发货的订单,请选择此配送类型。
  2. 如果需要查看库存,请打开 Настройки → Склад → Склады(设置 → 仓库 → 仓库),创建 ILFF 仓库,符号代码为 ilff。
  3. 也可以使用自定义代码,但需要在接入时填写(第 3 步):配送类型和仓库必须使用相同的代码。

第 2 步:API 密钥

  1. 打开 Настройки → Интеграция → Ключи доступа к API(设置 → 集成 → API 访问密钥),点击 Добавить(添加)。
  2. 授予密钥访问网店的权限,ILFF 将从这些网店读取订单。
  3. 勾选以下权限:订单(读取和写入)、目录、仓库、自定义字段(读取和写入)。
  4. 保存并复制密钥。

第 3 步:在 ILFF 客户后台中接入

客户后台 → Интеграции(集成)标签页 → 展开 Интернет-магазин(网店)区块。

  1. Платформа(平台):选择 RetailCRM。
  2. Адрес магазина(网店地址):您的 RetailCRM 地址,例如 shop.retailcrm.ru。
  3. Код типа доставки и склада ILFF в RetailCRM(RetailCRM 中 ILFF 配送类型和仓库的代码):如果代码为“ilff”,请留空;否则填写自定义代码。
  4. Ключ API RetailCRM(RetailCRM API 密钥):第 2 步中的密钥。
  5. 勾选项 Выгружать остатки(同步库存):把 ILFF 仓库的库存同步到 RetailCRM 的“ILFF”仓库。
  6. 勾选项 Заказ с несвязанным товаром ждёт привязки(含未关联商品的订单等待关联):启用后,如果订单中的商品尚未与您在 ILFF 中的商品关联,该订单在关联完成前不会被接收(见第 4 步)。建议保持启用。
  7. 点击 Подключить(接入)。后台会验证密钥和配送类型,并在订单中创建“Трек ILFF”(ILFF 跟踪号)、“Ссылка отслеживания ILFF”(ILFF 跟踪链接)和“Статус ILFF”(ILFF 状态)字段。如果只修改设置,密钥栏可以留空。

第 4 步:关联商品

ILFF 每天自动读取一次 RetailCRM 的商品规格,先按条码、再按货号与您在 ILFF 中的商品关联。未匹配的商品可在客户后台的 Товары магазина(网店商品)按钮中查看:为每个商品选择您在 ILFF 中的商品,并点击 Привязать(关联)。

如何为 ILFF 提交订单

  1. 在订单中选择 ILFF 配送类型。
  2. 在订单字段中填写买家的名字、姓氏和电话号码。
  3. 在订单的配送区块中填写收货地址,邮编填写在地址中。
  4. 在运费栏中填写向买家收取的配送费用。
  5. 如果填写了配送日期和时间,它们将成为 ILFF 的配送日期和时间。
  6. 确认订单:将订单从“Новый”(新建)状态组移至任意处理中状态(例如“Согласовано”,已确认)。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 客户经理,或通过客户后台联系技术支持。

WeChat

微信二维码

用微信扫码添加

我们将在几分钟内回电

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