将 1C-Bitrix 网站接入 ILFF

下载模块 ilff.delivery.zip

ILFF 模块把您基于 1C-Bitrix 的网店与 ILFF 服务连接起来：

• 下单流程中出现我们的配送方式，带价格、时效和自提点地图；
• 使用 ILFF 配送的订单在进入您选定的状态时自动发送到 ILFF；
• 跟踪号和订单状态回传到网站；
• 商品的库存、重量和尺寸从 ILFF 同步到网站；
• 在网站取消订单会取消 ILFF 中的发货申请。

数据交换始终由网站发起：模块使用 API 密钥主动访问 ILFF 服务，无需向我们开放网站。

您需要带网店功能的 1C-Bitrix 版本（«Интернет-магазин» 和 «Торговый каталог» 模块）、PHP 8、网站管理员权限以及 ILFF 客户后台的访问权限。接入需要 15–20 分钟。

模块、1C-Bitrix 后台和 ILFF 客户后台均为俄语界面，下文按屏幕上的原文给出名称，并在括号中附上译文。

第 1 步：在 ILFF 客户后台中接入

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

1. Платформа（平台）：选择 1С-Битрикс。
2. Адрес магазина（网店地址）：网站地址，例如 shop.ru。
3. 勾选项 Заказ с несвязанным товаром ждёт привязки（含未关联商品的订单等待关联）：启用后，如果订单中的商品尚未与您在 ILFF 中的商品关联，该订单在关联完成前不会被接收（见第 5 步）。不勾选时，此类商品会在 ILFF 中创建为新品项。建议保持勾选。
4. 点击 Подключить（接入）。后台会创建接入记录。此时后台不会访问网站：连接由模块在第 3 步检查。

Интеграции 标签页顶部显示 Ключ API（API 密钥）。如果没有，点击 Сгенерировать（生成）。第 3 步需要用到该密钥。不要转发给任何人：ILFF 服务凭它识别您的网站。

第 2 步：安装模块

1. 从 ILFF 网站的模块页面下载模块压缩包 ilff.delivery.zip，或向客户经理索取。
2. 把压缩包解压到网站目录 /local/modules/，得到 /local/modules/ilff.delivery/。如果没有 local/modules 目录，请先创建。
3. 在后台打开 Marketplace → Установленные решения（已安装的解决方案），找到 ILFF: доставка и обмен заказами，点击 Установить（安装）。

安装时模块会自动：

• 创建配送服务 «Доставка до двери ILFF»（ILFF 送货上门）和 «Пункты выдачи ILFF»（ILFF 自提点）（Магазин → Настройки → Службы доставки）；
• 在订单中添加服务属性：费率、自提点、重量、尺寸和件数；
• 在下单页面接入自提点选择地图；
• 创建数据交换代理任务（见第 6 步）。

第 3 步：模块设置

后台 → Настройки → Настройки продукта → Настройки модулей → ILFF: доставка и обмен заказами（设置 → 产品设置 → 模块设置）。

1. Адрес сервиса ILFF（ILFF 服务地址）：已填写，无需修改。
2. Ключ API клиента ILFF（ILFF 客户 API 密钥）：第 1 步中的密钥。保存后该栏保持为空，已保存的密钥不会显示。如果只修改设置，请保持为空。
3. Статус, при котором заказ уходит в ILFF（订单发送到 ILFF 的状态）：默认是«Принят, ожидается оплата»（已接收，等待付款），即下单后立即发送。如果您要先审核订单或等待付款，请选择审核后订单所转入的状态，例如«Оплачен, формируется к отправке»（已付款，准备发货）。订单在转入该状态时发送。
4. ILFF 状态对应的 Статусы сайта（网站状态）。空值«Не менять»（不修改）表示保持网站状态不变：

安装时模块会自动创建«Передан в доставку»和«Возврат»两个状态并设置对应关系：已交付配送 →«Передан в доставку»，已送达 →«Выполнен»，已取消 → 订单标记为已取消（选项«Отменить заказ (флаг «Отменён»)»），退货 →«Возврат»。如果您已经选择了状态，则不会更改。

1. Способы оплаты при получении（货到付款方式）：勾选买家向快递员或在自提点付款的支付方式，例如«Наличные курьеру»或«Наложенный платёж»。只有这些方式且订单未付款时，申请中才带货到付款金额。其他订单视为已预付，即使在线付款尚未到账。
2. 勾选项：
   • Получать остатки из ILFF（从 ILFF 获取库存）：把可用库存写入网站，即 ILFF 仓库库存减去预留量和尚未到达 ILFF 的订单。处于仓库收货区的商品在上架前不计入库存；
   • Получать вес и габариты товаров（获取商品重量和尺寸）：把 ILFF 中的商品重量和尺寸写入网站，仅限我们已填写这些数据的商品；
   • Получать вес и габариты заказа（获取订单重量和尺寸）：拣货后把实际重量、尺寸和件数写入订单属性；
   • Доставка в карточке товара（商品页显示配送；默认关闭）：在购买按钮下方显示网店所在城市的快递上门和自提点“起”价。
3. Окно выбора пункта выдачи（自提点选择窗口）：«Виджет ILFF»（ILFF 组件，默认：地图、物流公司和价格）或«Простое окно»（简易窗口：列表和地图）。使用组件时，请填写客户后台中的 Код клиента ILFF для виджета（组件用 ILFF 客户代码），并在后台把网站域名加入组件域名列表。未填写代码时打开简易窗口。Вариант настроек калькулятора（计算器配置方案）是 ILFF 客户后台中的方案代码，例如 site2，适用于该网站有单独配送设置的情况。留空则使用默认设置。免运费门槛（«Бесплатно для получателя от суммы товаров»）在 ILFF 客户后台中设置，商品金额达到门槛时，模块把运费显示为«Бесплатно»（免费）。
4. Адрес подсказки городов（城市提示地址）：可选。留空时使用 ILFF 服务地址旁的提示服务。
5. 勾选 Передать список товаров сейчас（立即发送商品列表），点击 Сохранить и проверить связь（保存并检查连接）。顶部会显示«Связь с ILFF есть, клиент: …»（已连接 ILFF，客户：…）、已发送的商品数量，以及在启用库存同步时已更新的库存数量。

第 4 步：配送服务和下单流程

1. 如果配送由 ILFF 完成，请停用网站中固定价格的配送方式。否则买家会看到它们与我们的方式并列，并按它们自己的价格显示。
2. 如有需要，可在 ILFF 配送服务中设置限制：按支付方式、所在地或订单金额。
3. 订单中必须填写买家所在地：运费据此计算（快递按城市计算，街道不影响价格）。城市取自«Местоположение»（所在地）属性，连同地区和区县，因此不同地区的同名村镇不会混淆。街道取自带«Адрес»标志的属性或代码为 ADDRESS 的属性，原样写入 ILFF 申请。

配送到村镇需要包含村镇的所在地目录：Bitrix 默认只加载城市，来自村镇的买家会看到«Местоположение не найдено»（未找到所在地）。请加载目录：«Магазин → Настройки → Местоположения → Импорт местоположений»，来源为 1C-Bitrix 服务器，国家为俄罗斯，详细程度为«с сёлами»（含村镇）；完整加载需要几分钟。

1. 在网站上用 ILFF 配送下一个测试订单，确认显示了运费和时效，并且订单已进入 ILFF。
2. 如果 ILFF 运费无法计算或未选择自提点，使用该服务的订单无法提交：买家会看到«Доставка ILFF: …. Выберите другой пункт или способ доставки.»（请选择其他自提点或配送方式）。这样订单不会以 0 ₽ 运费发出。

如果买家所在城市没有自提点或邮政网点，自提点选择窗口（ILFF 组件）会在地址位置打开地图，显示邻近城市最近的自提点及其距离；价格按所选自提点计算。快递价格始终按城市计算。选择自提点之前，«Пункты выдачи ILFF»服务显示«от N ₽»（N ₽ 起；村镇按最近的自提点计算），在地图上选择后显示准确价格。

第 5 步：关联商品

在 ILFF 客户后台，“Интернет-магазин”区块中的 Товары магазина（网店商品）按钮显示模块发送的网站商品及其与您在 ILFF 中商品的关联情况。系统先按条码、再按货号（ARTNUMBER 属性）匹配。

如果有订单在等待关联，Интеграции 标签页顶部会出现提示条并显示此类订单的数量，“Интернет-магазин”区块中会出现订单和商品的表格。关联后模块会自动补发订单。

第 6 步：代理任务和 cron

模块通过 Bitrix 代理任务工作：

订单在状态变化时立即发送到 ILFF，代理任务只用于重试。Bitrix 默认在访客访问时运行代理任务。访问量较小的网站请通过 cron 运行代理任务（bitrix/modules/main/tools/cron_events.php），否则库存和跟踪号会延迟。模块设置底部的«Запуск агентов»一行显示当前的运行方式，«последний запуск»（上次运行）显示每个代理任务是否在工作。

买家看到的内容

• Доставка до двери ILFF：快递上门和俄罗斯邮政«Курьер онлайн»，系统选择最便宜的费率。
• Пункты выдачи ILFF：地图上的 CDEK、5Post 自提点和自提柜以及俄罗斯邮政网点。选择自提点之前，运费为 0，并显示«Выберите пункт выдачи на карте»（请在地图上选择自提点）。
• 价格和时效按购物车的重量、尺寸和买家地址计算。

后续的数据交换

• 订单：使用 ILFF 配送的订单在转入«Статус, при котором заказ уходит в ILFF»设置中的状态时发送。如果 ILFF 服务没有响应，订单留在队列中，由代理任务补发：间隔为 1、5、15、60 和 180 分钟。
• 取消：在申请交给物流公司之前，在网站取消订单会取消 ILFF 中的申请；已拣货的订单会重新入库存储。如果申请已交给支持取消的物流公司（Dalli、5Post），取消请求会转给该公司，订单退回仓库。其他物流公司的在途申请不会自动取消：订单备注中会出现«ILFF: Заявка уже в работе…»（申请已在处理中），请联系客户经理。
• 跟踪号和状态：跟踪号写入订单的发货记录，状态按第 3 步的表格变更。由代理任务每 15 分钟同步一次。模块通过 Bitrix 的标准跟踪功能提供物流公司的包裹跟踪链接：买家在个人中心的跟踪号旁可以看到它，也可以把它插入订单邮件。
• 库存、重量和尺寸：勾选相应选项后由代理任务写入。

更新模块

1. 从本页面下载新的模块压缩包，解压到网站的 /local/modules/ 目录，覆盖旧版本（ilff.delivery 目录）。
2. 在后台打开 Marketplace → Установленные решения，对 ILFF 模块点击 Удалить（删除），然后点击 Установить（安装）。模块设置、配送服务和订单属性会保留：重新安装只更新下单脚本和处理程序。
3. 打开模块设置，点击 Сохранить и проверить связь。

常见问题

其他问题请联系您的 ILFF 客户经理。