将 AdvantShop 网店接入 ILFF

AdvantShop（Alfa-Seller Pro）网店接入 ILFF 时无需在网站上安装模块：数据交换由 ILFF 通过网店的 Management API 完成。

• 使用 ILFF 配送方式的订单会自动进入 ILFF；
• 跟踪号和订单状态会回传到网店，状态备注中带有物流公司和跟踪链接；
• ILFF 的可用库存会同步到网店的商品规格；
• 在网店取消订单时，如果发货申请尚未开始处理，ILFF 中的申请也会取消。

目前 ILFF 不在 AdvantShop 的购物车中显示运费，也不提供自提点选择：ILFF 配送的费用由您在网店的配送方式中自行设置（固定金额或按区域）。ILFF 按买家地址选择发货方式。

您需要：

• 网店管理员权限和 ILFF 客户后台的访问权限；
• 带有 Management API 功能的 AdvantShop（Настройки → API，«API ключи» 标签页，即“设置 → API → API 密钥”）。

接入大约需要 10 分钟。

ILFF 客户后台为俄语界面，下文按屏幕上的原文给出名称，并在括号中附上译文。

第 1 步：在网店中创建 ILFF 配送方式

1. 在网店后台打开 Настройки → Доставка（设置 → 配送），添加一种配送方式，例如“Доставка ILFF”。类型为固定金额或按区域，价格由您自定。
2. 配送方式的名称中必须包含“ILFF”：ILFF 据此识别自己的订单。不要把名称改成不含“ILFF”的形式，否则订单将不再传入。
3. 也可以不用名称，而是填写配送方式的编号（id）：编号可在配送方式页面的地址中看到，例如 …/shippingmethods/edit/7。如果有多种 ILFF 配送方式（例如快递上门和自提），需要填写所有编号。

第 2 步：Management API 密钥

1. 打开 Настройки → API（设置 → API）的 API ключи（API 密钥）标签页，点击 Создать ключ（创建密钥）。
2. 名称例如“ILFF”，类型为 Management API，权限为订单和商品（或完全管理），有效期为永久。
3. 复制密钥：完整密钥只在创建时显示一次。

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

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

1. Платформа（平台）：选择 AdvantShop。
2. Адрес магазина（网店地址）：网站或后台的地址，例如 shop.ru 或 s10.alslr.su/123456-abcd。
3. Id способа доставки ILFF（ILFF 配送方式 id）：留空时，系统读取名称中含有“ILFF”的配送方式的订单。也可以填写第 1 步中的编号（多个编号用逗号分隔）。
4. Ключ Management API（Management API 密钥）：第 2 步中的密钥。
5. 勾选项 Выгружать остатки（同步库存）：把 ILFF 的可用库存同步到商品规格。
6. 勾选项 Заказ с несвязанным товаром ждёт привязки（含未关联商品的订单等待关联）：启用后，如果订单中的商品尚未与您在 ILFF 中的商品关联，该订单在关联完成前不会被接收（见第 4 步）。建议保持启用。
7. 点击 Подключить（接入）。后台会在网店中验证密钥并保存接入设置。如果只修改设置，密钥栏可以留空。

第 4 步：关联商品

ILFF 每天自动读取一次网店商品，并先按条码、再按规格货号把商品规格与您在 ILFF 中的商品关联。未匹配的规格显示在客户后台“Интернет-магазин”区块的 Товары магазина（网店商品）按钮中：为每个规格选择您的商品并点击 Привязать（关联）。

数据交换方式

ILFF 按状态列表选择网店状态：“Отправлен”按名称匹配，完成状态和取消状态按状态标志匹配。网店中已完成的订单，ILFF 不再修改。

常见问题