插件 «ILFF - доставка и фулфилмент»（ILFF：配送与订单履约）把基于 Moguta.CMS 的网店与 ILFF 服务连接起来：
- 下单页面出现 ILFF 配送方式：快递上门、从城市网点列表中选择的自提点和俄罗斯邮政；价格和时效按买家填写的城市计算；
- 使用 ILFF 配送方式的订单在进入您选定的状态时自动发送到 ILFF；
- 跟踪号和订单状态回传到网店；
- 商品的库存和重量从 ILFF 同步到网店；
- 在网店取消订单会取消 ILFF 中的发货申请。
数据交换始终由网店发起：插件使用 API 密钥主动访问 ILFF 服务。
您需要：
- Moguta.CMS（已在 Moguta.CMS 14 «Минимаркет» 版本上测试）；
- PHP 8.1 或更高版本，带 curl 扩展；
- 网店货币为俄罗斯卢布；
- 网站管理员权限、服务器 cron 或主机计划任务的访问权限以及 ILFF 客户后台的访问权限。
接入需要 15–20 分钟。
插件、Moguta.CMS 管理后台和 ILFF 客户后台均为俄语界面，下文按屏幕上的原文给出其名称，并在括号中附上译文。
第 1 步：在 ILFF 客户后台中接入
客户后台 → Интеграции（集成）标签页 → Интернет-магазин（网店）区块：Платформа（平台）选择 Moguta.CMS，Адрес магазина（网店地址）填写网站地址。建议保持勾选 Заказ с несвязанным товаром ждёт привязки（含未关联商品的订单等待关联）。点击 Подключить（接入）。标签页顶部显示 Ключ API（API 密钥）；如果没有，点击 Сгенерировать（生成）。不要转发给任何人。
第 2 步：安装插件
- 从 ILFF 网站的模块页面下载压缩包
ilff-moguta.zip，或向客户经理索取。 - 在 Moguta 管理后台打开 Плагины（插件），上传压缩包（或把它解压到
mg-plugins/ilff文件夹），并激活插件 «ILFF - доставка и фулфилмент»。
激活时，插件会创建配送方式 Курьер ILFF（ILFF 快递上门）、Пункт выдачи ILFF（ILFF 自提点）和 Почта России (ILFF)（俄罗斯邮政），其支付方式与您的第一个配送方式相同，并创建自己的数据表。重复激活不会产生重复的配送方式。
第 3 步：插件设置
Плагины → «ILFF - доставка и фулфилмент» → Настройки（设置）：
- Ключ API ILFF（ILFF API 密钥）：第 1 步中的密钥。
- Адрес сервиса ILFF（ILFF 服务地址）：已填写，无需修改。
- Вариант настроек калькулятора（计算器设置方案）：ILFF 客户后台中的方案代码；留空表示使用默认设置。
- Передавать в ILFF в статусах（发送到 ILFF 的状态）：Moguta 状态编号，用逗号分隔，默认是
2,6（已付款、处理中）。处于 «не подтверждён»（未确认）状态的订单不会发送到 ILFF。 - Отменять заявку в статусах（取消申请的状态）：默认是
4（已取消）。 - Статус «передан в службу доставки»（已交给物流公司：
3，配送中）、«доставлен»（已送达：5，已完成）、«отменён в ILFF»（已在 ILFF 取消：4）、«возврат»（退货：留空，不改变）。 - Оплата при получении（货到付款）：支付方式编号，用逗号分隔；留空表示名称中含有 «наложенный» 或 «при получении» 的支付方式。
- Остатки из ILFF（来自 ILFF 的库存）、Вес товаров из ILFF（来自 ILFF 的商品重量）、Вес и габариты собранного заказа（已拣货订单的重量和尺寸）：
1或0。
点击 Сохранить（保存）：出现 «Сохранено, связь с ILFF есть»（已保存，已连接 ILFF）。交换任务的地址显示在同一页面。
第 4 步：买家看到的内容
在下单页面，ILFF 方式下方有 Город доставки（配送城市）字段。买家填写城市后，ILFF 方式显示价格、物流公司和时效。«Пункт выдачи ILFF» 显示 «выберите пункт выдачи, от N руб.»（请选择自提点，N 卢布起）和城市网点列表；选择自提点后显示其准确价格。不向该城市配送的方式不可选。
可以在 Настройки → Доставка（设置 → 配送）中重命名 ILFF 方式并调整其排序；不要为它们设置价格，价格由 ILFF 计算。
请下一个测试订单，把它转入发送状态，并确认订单已进入 ILFF。
第 5 步：关联商品
插件每天一次把商品和变体发送到 ILFF。ILFF 客户后台中的关联（Товары магазина，网店商品）按商品或变体的 Артикул（货号）字段匹配。
| 状态 | 处理方法 |
|---|---|
| Связан（已关联） | 无需操作，关联已保存 |
| Подобран（已匹配） | 检查并确认 |
| Несколько совпадений（多个匹配项） | 手动选择正确的商品 |
| Не найден（未找到） | 手动选择商品，或在网店中填写 «Артикул» 字段 |
关联完成后，插件会自动重新发送等待中的订单。
网店中的订单
插件把 ILFF 申请编号、跟踪号和交换错误追加到订单的管理员备注中（在管理后台可见，买家看不到）。当 ILFF 状态改变订单状态时，买家会收到带跟踪号的状态变更邮件。ILFF 库存写入商品或变体的 «Количество»（数量）；数量不限的商品不会被修改。
取消订单
把订单转入取消状态会取消 ILFF 中的申请，前提是申请尚未交给物流公司。如果申请已交给支持取消的物流公司（Dalli、5Post），取消请求会转给该公司；否则备注中会出现 ILFF 的答复，请联系客户经理。
交换任务
请把插件设置中的交换任务地址（形如 https://您的网站/ajaxrequest?pluginHandler=ilff&mguniqueurl=action/cron&token=…）添加到服务器 cron 或主机的计划任务中，每 5–15 分钟运行一次。不要公开该地址。
常见问题
| 现象 | 原因和处理方法 |
|---|---|
| «Сохранено, нет связи с ILFF»（已保存，无法连接 ILFF） | 请检查 API 密钥，并确认客户后台中已接入平台 «Moguta.CMS» |
| ILFF 方式显示 «укажите город доставки»（请填写配送城市） | 买家没有在 «Город доставки» 字段中填写城市 |
| «по этому городу не рассчитано»（该城市无法计算运费） | 物流公司不向该城市配送，或城市填写有误 |
| 无法为 ILFF 方式选择支付方式 | ILFF 配送方式没有勾选支付方式：Настройки → Доставка |
| 订单没有进入 ILFF | 检查订单状态和 «Передавать в ILFF в статусах» 设置、订单备注以及后台的“等待关联”提示条 |
| 跟踪号和状态没有回传 | 未配置交换任务 |
插件把交换错误写入 uploads/ilff/ilff.log，其中不含 API 密钥和买家数据。其他问题请联系您的 ILFF 客户经理。