«ILFF» 模块把基于 UMI.CMS（“网店”模块）的网店与 ILFF 服务连接起来：
- 在 «Доставка»（配送）步骤出现 ILFF 配送方式：快递上门、从城市网点列表中选择的自提点和俄罗斯邮政，带价格和时效；
- 使用 ILFF 配送方式的订单在进入您选定的状态时自动发送到 ILFF；
- 跟踪号和订单状态回传到网店；
- 商品的库存和重量从 ILFF 同步到网店；
- 在网店取消订单会取消 ILFF 中的发货申请。
数据交换始终由网店发起：模块使用 API 密钥主动访问 ILFF 服务。
您需要：
- 带“网店”模块的 UMI.CMS 24（已在 UMI.CMS 24、demomarket 模板上测试）；
- PHP 8.2 或 8.3，带 curl 扩展，以及服务器控制台的访问权限（用于运行安装程序）；
- 网店货币为俄罗斯卢布；
- 网站管理员权限和 ILFF 客户后台的访问权限。
接入需要 20–30 分钟。
模块、UMI.CMS 管理后台和 ILFF 客户后台均为俄语界面，下文按屏幕上的原文给出其名称，并在括号中附上译文。
第 1 步：在 ILFF 客户后台中接入
客户后台 → Интеграции（集成）标签页 → Интернет-магазин（网店）区块：Платформа（平台）选择 UMI.CMS，Адрес магазина（网店地址）填写网站地址。建议保持勾选 Заказ с несвязанным товаром ждёт привязки（含未关联商品的订单等待关联）。点击 Подключить（接入）。标签页顶部显示 Ключ API（API 密钥）；如果没有，点击 Сгенерировать（生成）。不要转发给任何人。
第 2 步：安装模块
- 从 ILFF 网站的模块页面下载压缩包
ilff-umi.zip，或向客户经理索取。 - 把压缩包解压到网站根目录：文件会放入
classes/components/emarket/…、templates/demomarket/…，以及ilff_cron.php和ilff_install.php。 - 在服务器控制台的网站根目录中执行：
ILFF_API_KEY=<API 密钥> php ilff_install.php。
安装程序会创建数据类型和配送类型 «ILFF»、三种配送方式 Курьер ILFF（ILFF 快递上门）、Пункт выдачи ILFF（ILFF 自提点）和 Почта России (ILFF)（俄罗斯邮政），为目录商品添加 Артикул（货号）字段，并输出交换任务的地址。重复运行不会产生重复内容。
- 网站模板：在
templates/<您的模板>/php/emarket/delivery/choose/list.phtml中，用模板emarket/delivery/choose/ilff输出类型为ilff的配送方式（压缩包中带有 demomarket 的版本）。如果您使用 XSLT 模板或自定义的配送步骤结构，请把这项工作交给网站开发人员或 ILFF 客户经理。
第 3 步：模块设置
Модули → Интернет-магазин → Доставка（模块 → 网店 → 配送）：打开 ILFF 配送方式的 ILFF 字段组。设置取自第一个填写了 API 密钥的 ILFF 方式：
- Ключ API ILFF（ILFF API 密钥）、Адрес сервиса ILFF（ILFF 服务地址，已填写）、Вариант настроек калькулятора（计算器设置方案）；
- Передавать в ILFF в статусах（发送到 ILFF 的状态）：UMI 状态代码，用逗号分隔，默认是
accepted（已接受）； - Отменять заявку в статусах（取消申请的状态）：默认是
canceled,rejected； - Статус «передан в службу доставки»（已交给物流公司，
delivery）、«доставлен»（已送达，ready）、«отменён в ILFF»（已在 ILFF 取消，canceled）、«возврат»（退货）； - Оплата при получении（货到付款）：支付方式编号，用逗号分隔；留空表示向快递员付款的支付方式；
- Остатки из ILFF（来自 ILFF 的库存）、Вес товаров из ILFF（来自 ILFF 的商品重量）、Вес и габариты собранного заказа（已拣货订单的重量和尺寸）：
1或0。
每个方式的 Вид доставки ILFF（ILFF 配送类型）字段：door 为快递上门，pickup 为自提点，post 为俄罗斯邮政。
第 4 步：买家看到的内容
在 «Доставка» 步骤（填写地址之后）显示带价格的 ILFF 方式，其下方是物流公司或自提点以及时效。«Пункт выдачи ILFF» 在选择自提点之前显示 «выберите пункт выдачи, от N ₽»（请选择自提点，N ₽ 起）和城市网点列表；未选择自提点时无法完成该步骤。不向买家地址配送的方式不会显示。
请下一个测试订单，把它转入 «Принят»（已接受）状态，并确认订单已进入 ILFF。
第 5 步：关联商品
模块每天一次把目录商品发送到 ILFF。ILFF 客户后台中的关联（Товары магазина，网店商品）按商品的 Артикул 字段匹配：请为存放在 ILFF 仓库的商品填写该字段。
| 状态 | 处理方法 |
|---|---|
| Связан（已关联） | 无需操作，关联已保存 |
| Подобран（已匹配） | 检查并确认 |
| Несколько совпадений（多个匹配项） | 手动选择正确的商品 |
| Не найден（未找到） | 手动选择商品，或在网店中填写 «Артикул» 字段 |
网店中的订单
模块把 ILFF 申请编号、跟踪号和交换错误追加到订单的 Служебная информация（内部信息）中，该信息在管理后台可见。订单状态按设置随 ILFF 状态变更，库存写入商品的 «Общее количество на складах»（仓库总库存）字段。
取消订单
把订单转入取消状态会取消 ILFF 中的申请，前提是申请尚未交给物流公司。如果申请已交给支持取消的物流公司（Dalli、5Post），取消请求会转给该公司；否则内部信息中会出现 ILFF 的答复，请联系客户经理。
交换任务
任务需要每 5–15 分钟运行一次：通过访问地址 https://您的网站/ilff_cron.php?token=<令牌>（带令牌的地址由安装程序输出），或在服务器 cron 中于网站根目录执行命令 php ilff_cron.php。不要公开该地址。
常见问题
| 现象 | 原因和处理方法 |
|---|---|
| «Доставка» 步骤中没有 ILFF 方式 | 未填写 API 密钥、地址中没有城市，或配送步骤的模板没有输出 ILFF 方式（第 2 步第 4 项） |
| «Выберите пункт выдачи ILFF»（请选择 ILFF 自提点） | 请在 «Пункт выдачи ILFF» 方式下方的列表中选择自提点 |
| 订单没有进入 ILFF | 检查订单状态和 «Передавать в ILFF в статусах» 设置、订单的内部信息以及后台的“等待关联”提示条 |
| 跟踪号和状态没有回传 | 未配置交换任务 |
模块把交换错误写入 sys-temp/logs/ilff.log，其中不含 API 密钥和买家数据。其他问题请联系您的 ILFF 客户经理。