«ILFF» 模块把您基于 NetCat（“网店”模块，netshop）的网店与 ILFF 服务连接起来：
- 下单流程中出现 ILFF 配送方式及其选项：快递上门、自提点和自提柜、俄罗斯邮政，带价格和时效；
- 使用 ILFF 配送方式的订单在进入您选定的状态时自动发送到 ILFF；
- 跟踪号和订单状态回传到网店；
- 商品的库存、重量和尺寸从 ILFF 同步到网店；
- 在网店取消订单会取消 ILFF 中的发货申请。
数据交换始终由网店发起：模块使用 API 密钥主动访问 ILFF 服务，无需向我们开放网店。
您需要：
- 带“网店”模块的 NetCat 7（已在 NetCat 7.2 E-commerce 上测试）；
- PHP 8.1 或更高版本，带 curl 扩展；
- 网店主货币为俄罗斯卢布；
- 网站管理员权限、网站文件的访问权限以及 ILFF 客户后台的访问权限。
接入需要 15–20 分钟。
模块、NetCat 管理后台和 ILFF 客户后台均为俄语界面，下文按屏幕上的原文给出其名称，并在括号中附上译文。
第 1 步：在 ILFF 客户后台中接入
客户后台 → Интеграции（集成）标签页 → 展开 Интернет-магазин（网店）区块。
- Платформа（平台）：选择 NetCat。
- Адрес магазина（网店地址）：网站地址，例如
shop.ru。 - 勾选项 Заказ с несвязанным товаром ждёт привязки（含未关联商品的订单等待关联）：启用后，如果订单中的商品尚未与您在 ILFF 中的商品关联，该订单在关联完成前不会被接收（见第 5 步）。建议保持勾选。
- 点击 Подключить（接入）。后台不会访问网店：连接由模块检查。
Интеграции 标签页顶部显示 Ключ API（API 密钥）。如果没有，点击 Сгенерировать（生成）。第 3 步需要用到该密钥。不要转发给任何人：ILFF 服务凭它识别您的网店。
第 2 步：安装模块
- 从 ILFF 网站的模块页面下载压缩包
ilff-netcat.zip，或向客户经理索取。 - 把压缩包解压到网站根目录：模块文件夹应位于
netcat/modules/ilff。 - 查看系统密钥：Настройки системы → Секретный ключ（系统设置 → 密钥）。
- 在浏览器中打开
https://您的网站/netcat/modules/ilff/install.php?secret_key=<密钥>。
安装程序会添加 ILFF 模块、运费计算服务 «ILFF»、模块数据表，并在 NetCat 计划任务中添加交换任务（每 5 分钟一次）。重复运行不会产生重复内容。
第 3 步：配送方式和模块设置
打开 Интернет-магазин → Доставка（网店 → 配送），创建一个使用自动计算 ILFF 的配送方式（例如 «Доставка ILFF»）。在服务设置中：
- Ключ API ILFF（ILFF API 密钥）：第 1 步中的密钥。
- Адрес сервиса ILFF（ILFF 服务地址）：已填写，无需修改。
- Вариант настроек калькулятора（计算器设置方案）：ILFF 客户后台中的方案代码，适用于该网站有单独配送设置的情况。留空表示使用默认设置。
- Курьер до двери（快递上门）、Пункты выдачи и постаматы（自提点和自提柜）、Почта России по адресу（俄罗斯邮政按地址配送）：向买家显示哪些选项。
- Статусы, в которых заказ передаётся в ILFF（把订单发送到 ILFF 的状态）：状态编号，用逗号分隔，默认是
1（«принят»，已接受）。处于 «новый»（新订单）状态的订单不会发送到 ILFF：审核后请把它转入 «принят»。 - Статусы, в которых заказ отменяется в ILFF（在 ILFF 中取消订单的状态）：默认是
2（«отменён»，已取消）。 - ILFF 状态对应的订单状态：«передан в службу доставки»（已交给物流公司，默认 «отправлен» 已发货）、«получен покупателем»（买家已收货，默认 «получен» 已收货）、«отменён в ILFF»（已在 ILFF 取消）、«возврат»（退货）。
- Способы оплаты при получении（货到付款的支付方式）：支付方式编号，用逗号分隔。留空表示 NetCat 中已启用“收货时付款”的支付方式。此类订单以货到付款方式发送到 ILFF，其他订单视为已预付。
- Загружать остатки из ILFF（从 ILFF 加载库存）、вес и габариты товаров（商品的重量和尺寸）、вес и места отправления заказа（订单的重量和包裹数）：从 ILFF 接收哪些数据。
如果有多个 ILFF 配送方式，交换设置取自第一个已启用的方式。
第 4 步：买家看到的内容
在选择配送的步骤中，ILFF 方式下方显示带价格和时效的选项：各物流公司的快递上门、自提点和自提柜（使用 NetCat 的标准自提点选择功能）、俄罗斯邮政。价格按买家所在城市计算。不向买家地址配送的选项不会显示。
请下一个使用 ILFF 方式的测试订单，把它转入发送状态，并确认订单已进入 ILFF。
第 5 步：关联商品
模块每天一次把商品和变体列表发送到 ILFF。在 ILFF 客户后台中，Товары магазина（网店商品）按钮显示这些商品及其与您在 ILFF 中商品的关联。关联按货号匹配，即商品或变体的 Артикул（货号）字段。
| 状态 | 处理方法 |
|---|---|
| Связан（已关联） | 无需操作，关联已保存 |
| Подобран（已匹配） | 检查并确认 |
| Несколько совпадений（多个匹配项） | 手动选择正确的商品 |
| Не найден（未找到） | 手动选择商品，或在网店中填写货号 |
如果有订单在等待关联，Интеграции 标签页顶部会出现带此类订单数量的提示条。关联完成后，模块会自动重新发送订单。
网店中的订单
模块把 ILFF 申请编号、带跟踪链接的跟踪号和交换错误写入订单的 Комментарий оператора（操作员备注）。它在管理后台的订单中可见，买家看不到。当 ILFF 状态改变订单状态时，NetCat 按自己的设置重新计算库存。
取消订单
把订单转入取消状态会取消 ILFF 中的申请，前提是申请尚未交给物流公司；已拣货的订单会重新入库存储。如果申请已交给支持取消的物流公司（Dalli、5Post），取消请求会转给该公司。否则操作员备注中会出现 ILFF 的答复，请联系客户经理。
交换任务
安装程序会自动把任务添加到 NetCat 计划任务（Инструменты → Задачи по расписанию，工具 → 计划任务）。为了让任务按时执行，NetCat 计划任务需要由服务器 cron 启动。也可以通过地址 https://您的网站/netcat/modules/ilff/cron.php?secret_key=<密钥> 运行任务；不要公开该地址。
该任务重新发送未能立即发出的订单，获取跟踪号和状态，更新库存和重量，并每天一次发送商品列表并核对全部库存。
常见问题
| 现象 | 原因和处理方法 |
|---|---|
| 下单流程中没有 ILFF 方式 | 未填写 API 密钥、方式已关闭、地址不在俄罗斯或地址中没有城市 |
| 订单没有进入 ILFF | 检查订单状态和 «Статусы, в которых заказ передаётся в ILFF» 设置、操作员备注（交换错误）以及后台的“等待关联”提示条 |
| «Тариф заказа не найден»（未找到订单费率） | 买家下单时没有 ILFF 运费计算结果：请在订单中重新选择配送 |
| 跟踪号和状态没有回传 | 交换任务没有运行：请检查 NetCat 计划任务和服务器 cron |
| 库存没有变化 | 未启用 «Загружать остатки из ILFF»，或商品的 «Количество на складе»（库存数量）字段为空，即该商品不跟踪库存 |
其他问题请联系您的 ILFF 客户经理。