该模块把您的 InSales 网店与 ILFF 服务连接起来：
- 下单流程中出现我们的配送方式，带价格和自提点地图；
- 商品页和购物车中显示运费；
- 订单自动进入 ILFF，跟踪号和状态回传到网店；
- 商品的库存、重量和尺寸从 ILFF 同步到网店；
- 在网店取消订单会取消 ILFF 中的发货申请。
接入需要 10–15 分钟，无需修改网站模板。您需要 InSales 后台和 ILFF 客户后台的访问权限。
InSales 后台和 ILFF 客户后台均为俄语界面，下文按屏幕上的原文给出名称，并在括号中附上译文。
第 1 步：InSales 中的 API 密钥
- 在 InSales 后台打开 Расширения → Разработчикам（扩展 → 开发者），创建访问密钥。并非所有 InSales 套餐都提供 API：如果没有该栏目，请向 InSales 客服确认套餐。
- 给密钥完全访问权限：模块需要访问订单、商品、配送方式、订单状态、附加字段和店面脚本。
- 保存密钥的两个值：Идентификатор（标识符）和 Пароль（密码）。不要转发给任何人，它们只在客户后台中填写。
第 2 步：在 ILFF 客户后台中接入
客户后台 → Интеграции（集成）标签页 → 展开 Интернет‑магазин（网店）区块。区块第一行是本指南俄语版的链接，平台栏上方显示已接入的网店。
- Адрес магазина（网店地址）：形如
магазин.myinsales.ru的技术地址。自有域名不适用。 - Идентификатор ключа API（API 密钥标识符）和 Пароль ключа API（API 密钥密码）：来自第 1 步。
- Когда забирать заказ（何时读取订单）：订单从哪个状态起进入 ILFF：
- Утверждён（已确认；默认，推荐）：您确认订单后进入；
- Новый（新订单）：买家下单后立即进入；
- Оплачен（已付款）：已付款或已确认；
- Свой статус магазина（网店自定义状态）：下方会出现您网店的状态列表，请选择所需状态。该选项在首次接入后可用：先用其他选项接入网店，再回来选择自定义状态。
- 勾选项：
- Выгружать остатки（同步库存）：网店收到可用库存，即 ILFF 仓库库存减去预留量和尚未载入 ILFF 的订单；
- Выгружать вес и габариты（同步重量和尺寸）：把 ILFF 中的商品重量和尺寸写入网店，仅限我们已填写这些数据的商品；
- Передавать вес и габариты заказа（回传订单重量和尺寸）：拣货和补充包装后，把实际重量、尺寸和件数写入网店订单；
- Заказ с несвязанным товаром ждёт привязки（含未关联商品的订单等待关联）：如果订单中的商品尚未与您在 ILFF 中的商品关联，该订单在关联完成前不会载入（见第 3 步）。不勾选时，此类商品会在 ILFF 中创建为新品项。建议保持勾选。
- 点击 Подключить（接入）。后台会验证密钥，区块标题显示«подключён»（已接入），网店随即自动完成设置：
- 创建配送方式 «Доставка до двери ILFF»（ILFF 送货上门）和 «Пункты выдачи ILFF»（ILFF 自提点）；
- 在订单中添加跟踪号、重量和尺寸字段；
- 在店面的商品页和购物车中安装运费显示区块。
接入后密钥栏保持为空，这是正常的：已保存的密钥不会显示。如果只修改设置，请保持为空并点击«Подключить»。
- 展开 Способы оплаты при получении（货到付款方式）分组，勾选买家在收货时付款的支付方式。列表从网店读取，Обновить из магазина（从网店刷新）按钮可重新读取。其作用见第 4 步。修改后点击«Подключить»保存。
- 展开 Статусы в магазине（网店状态）分组，检查哪些 ILFF 状态会回传到网店。表格在接入时自动填写，可以不修改：
| ILFF 状态 | 网店状态 |
|---|---|
| Передан в КС（已交给物流公司） | Отгружен（已发货） |
| Доставлен клиенту, Выдан, Частичная выдача（已送达、已取件、部分取件） | Доставлен（已送达） |
| Отменен, Аннулирован（已取消、已作废） | Отменен（已取消） |
| Возврат принят, Полный отказ（退货已接收、全部拒收） | Возврат（退货） |
其他状态不回传到网店。可以添加一行，或选择其他网店状态（包括自定义状态）：点击«Обновить из магазина»后，您的自定义状态会出现在选项中。
第 3 步：关联商品
同一区块中的 Товары магазина（网店商品）按钮显示网店的全部商品规格及其与您在 ILFF 中商品的关联情况。系统先按条码、再按货号匹配：
| 状态 | 处理方法 |
|---|---|
| Связан（已关联） | 无需操作，关联已保存 |
| Подобран（已匹配） | 检查并确认 |
| Несколько совпадений（多个匹配项） | 手动选择正确的商品 |
| Не найден（未找到） | 手动选择商品，或在网店中填写条码或货号 |
要解除关联，清空该行中的商品即可。同一款式的不同尺码往往共用一个货号，因此请在网店中填写条码。
如果有订单在等待关联，Интеграции 标签页顶部会出现提示条并显示此类订单的数量，“Интернет‑магазин”区块中会出现订单和商品的表格。关联后订单会自动载入。
第 4 步：InSales 网店设置
- 配送方式。 停用或删除网店中固定价格的配送方式（例如默认的«Курьером»）。否则买家会看到它们与我们的方式并列，并按它们自己的价格显示。
- 支付方式和货到付款。 下单时买家看到的运费不含货到付款手续费：在这一步 InSales 不向我们传递支付方式。只有在客户后台中标记为货到付款的支付方式，且订单未付款时，申请中才会带货到付款金额。其他支付方式的货到付款金额为 0，没有手续费，即使在线付款尚未到账。在没有标记任何方式之前，货到付款按订单的付款状态判断：在线支付但未付款的订单会带上货到付款金额，因此区块中会显示警告。如需由买家承担手续费，请在 InSales 的支付方式设置中设置加价。
- 隐藏缺货商品。 如果 InSales 设置中启用了«скрывать товары не в наличии»（隐藏缺货商品），ILFF 仓库库存为零的商品在同步库存后会从店面消失。请在勾选«Выгружать остатки»之前检查该设置。
- 库存扣减。 InSales 在创建订单时扣减库存。下次同步时，网店库存会按 ILFF 的实际库存校正。
- 演示商品。 当您创建第一个自己的商品时，InSales 会自动把带«[Пример]»标记的商品归档。
- 测试订单。 在网站上下一个订单，确认下单时能看到 ILFF 配送方式，并且订单已进入 ILFF。
买家看到的内容
- Доставка до двери ILFF：快递上门和俄罗斯邮政«Курьер онлайн»。
- Пункты выдачи ILFF：CDEK、5Post 的自提点和自提柜以及俄罗斯邮政网点显示在同一张地图上，标注为“物流公司 · 类型：地址”。
- 价格和时效按购物车的重量、尺寸和买家地址计算。
后续的数据交换
- 订单：ILFF 定期读取处于所选状态的订单。拣货开始前，网店中的订单修改会应用到发货申请。拣货开始后不再应用修改：后台的提示条和表格会显示此类订单，请联系客户经理。
- 取消：拣货开始前在网店取消的订单会取消 ILFF 中的申请。如果申请已在处理中，不会自动取消，由客户经理决定。
- 跟踪号和状态：我们收到跟踪号后写入网店订单。申请状态变化时，如果该状态在«Статусы в магазине»表中，状态会回传。两者都按计划任务同步，而不是即时同步。
- 库存、重量和尺寸：勾选相应选项后按计划任务同步到网店。
常见问题
| 提示或现象 | 原因和处理方法 |
|---|---|
| «Магазин не принял ключ API»（网店未接受 API 密钥） | 标识符或密码错误，或密钥已删除。请创建新密钥并重新接入 |
| «Магазин не отвечает, проверьте адрес»（网店无响应，请检查地址） | 填写了自有域名或有拼写错误。需要填写 магазин.myinsales.ru 形式的地址 |
| «Этот магазин уже подключён к другому клиенту»（该网店已接入其他客户） | 请联系客户经理 |
| 下单流程中没有我们的配送方式 | 再次点击«Подключить»：配送方式会重新创建 |
| 订单没有进入 ILFF | 检查网店中的订单状态和“等待关联”区块。订单必须在网站上使用 ILFF 配送下单：未使用 ILFF 配送的订单（包括通过网店 API 创建的订单）不会载入 |
| «Выберите статус магазина»（请选择网店状态） | 选择了«Свой статус магазина»但未指定状态。请在下方列表中选择，或改用其他选项 |
| 网店中的状态没有变化 | 该 ILFF 状态不在«Статусы в магазине»表中，或申请尚未到达该状态 |
| 在线支付但未付款的订单带上了货到付款金额 | 未标记货到付款方式（第 2 步第 6 项） |
| 商品从店面消失 | 启用了«скрывать товары не в наличии»，而 ILFF 中的库存为零（第 4 步） |
其他问题请联系您的 ILFF 客户经理。