FOM (F-APTEKA)

Приложение FOM связывает магазин аптеки со складской системой F-APTEKA от FOM GROUP. Магазин загружает из неё справочник товаров, остатки и розничные цены по филиалам и регулярно обновляет их.

Для чего эта страница#

• Подключить сервер F-APTEKA вашей аптеки.
• Загрузить справочник товаров с ИКПУ, производителем и категориями.
• Получать остатки и цены по одному или нескольким филиалам.
• Получить адрес и токен для настройки автоматической отправки остатков со стороны FOM (SITE.exe).

Где найти#

Боковое меню: Настройки → Приложения, затем карточка FOM в каталоге (или Настроить в блоке Подключенные).

Кто видит#

Страница доступна сотрудникам с правом «Управлять приложениями и интеграциями».

Приложение бесплатное и доступно на всех тарифах. Новые товары из FOM учитываются в лимите товаров тарифа.

Обзор страницы#

1. Шапка — название, разработчик FOM GROUP, сайт и кнопка Установить. Кнопка остаётся и после подключения: так можно подключить ещё один сервер.
2. Карточка подключения — адрес сервера, категория и список филиалов, кнопки Настройки и Удалить FOM.
3. Кнопки — Импортировать товары из FOM, Обновить остатки и цены, Импортировать новые товары.
4. Webhook остатков (SITE.exe) — URL для FOM и Токен (TOCING) с кнопками Копировать и кнопка Сменить токен.
5. Справка по кнопкам — раскрывающийся список с описанием кнопок.

Как сделать#

Подключить FOM#

1. Попросите технический отдел FOM GROUP открыть доступ к сервису REPORT.exe вашей аптеки из интернета и узнайте его адрес и порт (например, http://203.0.113.10:8084).
2. В каталоге приложений откройте FOM и нажмите Установить.
3. Заполните URL сервера F-APTEKA. Если не указать http://, он добавится автоматически.
4. В поле ID филиала укажите номер основного филиала (обычно 1 для одной аптеки).
5. Если филиалов несколько, перечислите их через запятую в поле ID филиалов, например 1,2,3.
6. Поле Токен оставьте пустым, если FOM GROUP не выдала его.
7. Нажмите Установить и через несколько секунд обновите страницу.

Если после обновления страницы подключение исчезло, адрес сервера не прошёл проверку. Проверьте адрес и установите приложение заново.

Загрузить товары#

1. Нажмите Импортировать товары из FOM. Импорт идёт в фоне.
2. Проверьте товары в каталоге и добавьте фото и описания — FOM их не передаёт.

Для последующих загрузок используйте Импортировать новые товары: эта кнопка добавляет только новые товары и не меняет существующие.

Обновить остатки и цены вручную#

Нажмите Обновить остатки и цены. Повторно кнопку можно нажать не раньше чем через 15 минут.

Настроить автоматическую отправку остатков из FOM#

1. Скопируйте URL для FOM и Токен (TOCING) в блоке Webhook остатков (SITE.exe).
2. Передайте их техническому специалисту FOM GROUP для настройки SITE.exe.

После настройки FOM сам присылает текущие остатки филиала, а магазин сразу обновляет остаток и цену.

Сменить токен webhook#

Нажмите Сменить токен и подтвердите. Старый токен перестанет работать — передайте новый технику FOM GROUP.

Удалить подключение#

Нажмите Удалить FOM и подтвердите. Настройки интеграции удалятся, товары сохранятся.

Как это работает#

• Что загружает импорт. Название, производитель (в поле производителя), единица измерения (в поле типа товара), ИКПУ (MXIK), артикул (код товара FOM), остаток, розничная цена и срок годности самой ранней партии — тегом вида expires:2026-12-31. Каждый товар становится товаром с одним вариантом.
• Категории. Группа и подгруппа FOM становятся категорией и подкатегорией магазина. Товар привязывается к обеим. Если FOM не вернула категории, привязка товаров не меняется.
• Остатки и цены по филиалам. Остатки суммируются по всем филиалам из поля ID филиалов (если поле пустое — по основному филиалу) и по всем партиям. Цена — наибольшая розничная цена среди партий. Дробное количество округляется вниз до целого.
• Публикация. При полном импорте товар с остатком публикуется, товар без остатка снимается с публикации.
• Как связаны товары. Товар в магазине помнит код товара FOM, поэтому повторный импорт обновляет тот же товар. Фото и описание, добавленные в магазине, импорт не трогает.
• Автоматическое обновление. Каждые 15 минут магазин запрашивает остатки и цены по филиалам и обновляет существующие товары. Новые товары при этом не создаются, статус публикации не меняется.
• Webhook (SITE.exe). Если FOM настроен на отправку, каждая отправка сразу обновляет остаток и цену товаров, которые уже есть в магазине. Неизвестные товары пропускаются.
• Удалённые товары. Полный импорт снимает с публикации товары, которых больше нет в FOM.
• История остатков. Изменения остатков видны в истории корректировок товара с источником «FOM».

Ограничения и важные нюансы#

• Адрес сервера должен быть доступен из интернета. Адреса локальной сети (например, 192.168.… или 10.…) не принимаются. Если сервер доступен только через VPN, напишите в поддержку.
• Товар, снятый с публикации из-за нулевого остатка, не публикуется снова при автоматическом обновлении — только при следующем полном импорте.
• Фото и описания FOM не передаёт.
• Товары без остатка, без цены и без партий не импортируются.
• Полный импорт перезаписывает название, производителя, единицу измерения, теги, цену, ИКПУ и статус публикации товаров FOM: товар с остатком, снятый с публикации вручную, снова станет опубликованным. Ручные изменения остатков перезаписываются при каждом обновлении.
• Заказы в FOM не передаются.
• Ошибки синхронизации в админке не показываются. Кнопки сообщают только, что задача запущена, уже выполняется или недавно запускалась.
• Когда достигнут лимит товаров тарифа, новые товары не добавляются, существующие продолжают обновляться.

Частые вопросы#

После установки подключение пропало со страницы. Почему? Адрес сервера F-APTEKA не прошёл проверку: он недоступен из интернета или указан во внутренней сети. Уточните адрес у FOM GROUP.

Импорт прошёл, но товаров нет или их мало. Чаще всего неверно указан ID филиала. Сверьте номера филиалов с технической службой FOM GROUP.

Товар снова появился на складе, но в магазине не виден. Он был снят с публикации при импорте из-за нулевого остатка. Запустите Импортировать товары из FOM или опубликуйте товар вручную.

Нужен ли webhook, если остатки и так обновляются каждые 15 минут? Нет, это необязательно. Webhook ускоряет обновление: остатки приходят сразу после отправки из FOM.

Связанные статьи#

• Каталог приложений
• Товары
• Категории
• Инвентарь
• ИКПУ