МойСклад (MoySklad) 接入 ILFF 时无需安装模块，也无需程序员：ILFF 通过 МойСклад 的 JSON API 使用令牌完成数据交换。
- 使用 ILFF 仓库的已审核客户订单会自动进入 ILFF，并生成发货申请；
- 订单状态随发货申请状态更新，跟踪号、跟踪链接和 ILFF 状态会写入订单的附加字段；
- 在 МойСклад 中，ILFF 仓库的库存通过单据维护：ILFF 收货入库 → «Оприходование»（入库单），订单发货 → 按订单创建 «Отгрузка»（发货单），已接收退货 → «Возврат покупателя»（客户退货单）；
- 在 МойСклад 中取消订单时，如果发货申请尚未开始处理，ILFF 中的申请也会取消。
您需要：
- МойСклад 管理员账号（或拥有客户订单、仓库、商品、入库单、库存核销单、发货单、退货单和附加字段权限的员工账号）；
- ILFF 客户后台的访问权限。
接入大约需要 10 分钟。
МойСклад 和 ILFF 客户后台均为俄语界面。下文保留屏幕上的俄文名称，并在首次出现时于括号中附上译文。
第 1 步：在 МойСклад 中创建 ILFF 仓库
- 打开 «Товары → Склады»（商品 → 仓库），创建名为 ILFF 的仓库。该仓库对应您存放在我们这里的商品。
- 也可以使用其他名称，但需要在接入时填写该名称（第 3 步）。
- 对于需要由 ILFF 发货的订单，请选择此仓库。
第 2 步：令牌
- 打开 «Настройки → Токены»（设置 → 令牌）（齿轮图标 → «Токены»），点击 «Создать токен»（创建令牌）。
- 选择 ILFF 将以哪位员工的身份操作。ILFF 在 МойСклад 中创建的单据也将以该员工的名义创建。
- 复制令牌：完整令牌只在创建时显示一次。
第 3 步：在 ILFF 客户后台中接入
客户后台 → Интеграции（集成）标签页 → 展开 Интернет-магазин（网店）区块。
- Платформа（平台）：选择 МойСклад（MoySklad）。
- Склад ILFF в МойСклад（МойСклад 中的 ILFF 仓库）：如果仓库名称为“ILFF”，请留空；否则填写其名称。
- Токен JSON API МойСклад（МойСклад JSON API 令牌）：第 2 步中的令牌。
- 勾选项 Выгружать остатки（同步库存）：通过单据维护 МойСклад 中的 ILFF 仓库库存（见下文）。
- 勾选项 Заказ с несвязанным товаром ждёт привязки（含未关联商品的订单等待关联）：启用后，如果订单中的商品尚未与您在 ILFF 中的商品关联，该订单在关联完成前不会被接收（见第 4 步）。建议保持启用。
- 点击 Подключить（接入）。后台会验证令牌和仓库，并在 «Заказ покупателя»（客户订单）中创建附加字段 «Трек ILFF»（ILFF 跟踪号）、«Ссылка отслеживания ILFF»（ILFF 跟踪链接）和 «Статус ILFF»（ILFF 状态）。如果只修改设置，令牌栏可以留空。
第 4 步：关联商品
ILFF 每天自动读取一次 МойСклад 的商品和规格，先按条码、再按货号将其与您在 ILFF 中的商品关联（没有货号时按代码关联）。未匹配的商品显示在客户后台的 Товары магазина（网店商品）按钮中：为每个商品选择您在 ILFF 中的商品并点击 Привязать（关联）。服务和套装不参与关联。
如何为 ILFF 创建订单
- 创建 «Заказ покупателя»，选择 ILFF 仓库。
- 往来单位为买家：ILFF 从往来单位卡片中获取姓名和电话号码。
- 在订单的 «Адрес доставки»（配送地址）字段中填写配送地址。邮政编码包含在完整地址中。
- 将面向买家的配送费添加为服务行（例如 «Доставка»，配送）：ILFF 不把服务行作为商品发货，而是将其总金额计为配送费。
- 如果填写了计划发货日期，该日期将成为配送日期。
- 审核订单。ILFF 不读取未审核的订单，因此您可以将其保留为草稿。
数据交换方式
| 内容 | 时间 |
|---|---|
| 使用 ILFF 仓库的已审核订单 | 每隔几分钟：新订单和上次读取后有变更的订单 |
| 拣货前修改订单 | 发货申请随之更新；拣货后的修改会显示在客户后台中（“изменён после сборки”，拣货后已修改） |
| 订单处于 «Неуспешный»（失败）类型的状态（例如 «Отменен»（已取消）） | 申请尚未开始处理时会被取消；否则请联系 ILFF 客户经理 |
| 订单处于 «Успешный»（成功）类型的状态 | ILFF 不再修改该订单 |
| 跟踪号和跟踪链接 | 物流公司生成跟踪号后，立即写入订单的附加字段 |
| 订单状态 | 已交给物流公司 → «Отгружен»（已发货），已送达 → «Доставлен»（已送达），取消和拒收 → «Отменен»，退货已接收 → «Возврат»（退货）。如果没有这些状态，ILFF 使用所需类型的第一个状态；附加字段 «Статус ILFF» 显示准确状态 |
МойСклад 中的 ILFF 仓库
ILFF 通过单据维护 МойСклад 中 ILFF 仓库的库存。每个事件对应一张单独的单据，备注中带有“ILFF”标记：
| ILFF 中的事件 | МойСклад 中的单据 |
|---|---|
| 首次启用“Выгружать остатки” | 带有备注“ILFF: начальный остаток склада ILFF”（ILFF：ILFF 仓库初始库存）的 «Оприходование» 或 «Списание»（库存核销单）——仓库库存变为与 ILFF 的实际库存一致 |
| 您的供货收货入库完成 | 带有备注“ILFF: приёмка …”（ILFF：收货入库……）的 «Оприходование» |
| 来自 МойСклад 的订单已交给物流公司 | 按该订单创建 «Отгрузка»，价格取自订单 |
| 此类订单的退货已在仓库接收 | 按该发货单创建 «Возврат покупателя» |
| 其他所有情况：电商平台和其他网店的订单、不良品、盘点 | 带有备注“ILFF: прочие движения склада ILFF”（ILFF：ILFF 仓库的其他库存变动）的 «Оприходование» 或 «Списание» |
请勿修改或删除 ILFF 创建的单据：ILFF 通过外部编码识别这些单据并核对库存。您可以自行创建 ILFF 仓库的单据（例如调入该仓库），如有差异，ILFF 会通过“其他库存变动”单据进行更正。
常见问题
- «МойСклад не принял токен»（МойСклад 未接受令牌）——令牌已删除或复制不完整。请创建新令牌。
- «В МойСклад нет склада …»（МойСклад 中没有……仓库）——请创建仓库，或检查 «Склад ILFF»（ILFF 仓库）字段中的名称。
- «Не удалось создать доп. поле заказа»（无法创建订单附加字段）——令牌所属员工没有配置附加字段的权限。请授予权限或手动创建字段（类型为 «Строка»，字符串）：«Трек ILFF»、«Ссылка отслеживания ILFF»、«Статус ILFF»。
- 订单没有进入 ILFF——检查订单是否已审核、是否选择了 ILFF 仓库，以及所有商品是否已关联（Товары магазина 按钮）。
- 其他问题请联系 ILFF 客户经理，或通过客户后台联系支持团队。