Синхронизация каталога

Синхронизация каталога является первой задачей на пути к запуску интеграции на сервисе Ютека.

Из всех пунктов каталога, обязательным для работы в автоматическом режиме, это товары и остатки.
Остальные данные (регионы, аптеки) могут заводиться в ручном или полу-ручном режиме.

Технически, обмен каталогом может проходить через:

• HTTP API Партнера (если такое имеется и стабильно работает)
• Партнер выкладывает на FTP сервер файлы с аптеками, товарами и остатками в формате csv (описание протокола)

Краткая таблица

Синхронизация регионов/городов

Для корректной работы региональных доменов Ютеки, поиска, отображения карты и остатков, Партнер предоставляет список регионов, в которых его сеть представлена.
Два главных параметра, которые нужны - Id партнера и название региона. Ютека может предоставить свой список регионов. Регионы можно заводить в автоматическом или ручном режимах.

• Автоматический режим предполагает частое включение и отключение самих регионов.
• В ручном режиме Партнер связывается с представителями Ютеки и сообщает о новых регионах или просит выключить какой-либо регион.

Синхронизация аптек

Аптеки являются связующим звеном между покупателем и товаром.

Интересующая Ютеку информация по аптекам:

Аптеки можно заводить в ручном или автоматическом режимах:

• В автоматическом режиме, Ютека периодически (каждые 3 часа) импортирует к себе все аптеки. В случае появления новых аптек в выгрузке, сотрудники Ютеки проверяют корректность данных в выгрузке и добавляют новые аптеки на сайт.
• В ручном режиме Партнер сообщает о новых и удаленных аптеках через каналы связи сотрудникам Ютеки.

График работы

График работы ожидается в JSON формате, разбитый по дням недели.
Комментарии для формата ниже:

1. Дни недели пронумерованы от 1 до 7, где 1 - понедельник, 7 - воскресенье.
2. “open” - время открытия аптеки, “close” - время закрытия. Относительно этих значений присылаются уведомления пользователям, и считаются регламенты (например, “будет собран до”).
3. Если аптека не работает в какой-то день (например, в воскресенье), то день недели пропускается.
4. Если аптека круглосуточная, то время открытия и закрытия присылается 00:00 (т.е. "open":"00:00","close":"00:00")
5. Разработчикам: нужно учитывать, что JSON формат относится только к одному полю из АПИ, а поле (колонка в выгрузке) должна быть строкой в соответствующем формате (CSV, XML или JSON, как договорились). Поэтому нужно не забывать про экранирование данных при подстановке в выгрузку.

{
  "1": {
    "open": "08:00",
    "close": "20:00"
  },
  "2": {
    "open": "08:00",
    "close": "20:00"
  },
  "3": {
    "open": "08:00",
    "close": "20:00"
  },
  "4": {
    "open": "08:00",
    "close": "20:00"
  },
  "5": {
    "open": "08:00",
    "close": "20:00"
  },
  "6": {
    "open": "09:00",
    "close": "20:00"
  },
  "7": {
    "open": "09:00",
    "close": "20:00"
  }
}

todo: добавить пример

Синхронизация каталога/товаров

Синхронизация каталога подразумевает, что Партнер предоставляет Ютеке полный список товаров и лекарств, которые можно купить в аптеках сети Партнера.

Перед появлением товара на сервисе Ютека, все товары проходят ручную модерацию. Предварительная привязка происходит по штрихкодам (баркодам), а уже после по Id товара партнера. Сотрудники Ютеки проверяют название товара, страну производства и завод-изготовитель, а так же другие данные препарата/товара, такие как дозировка, кол-во в упаковке и др.

Партнер может предоставить Ютеке связи его Id товаров с другими справочниками: РЛС, Катрен, Протек, ЕГК.

• При индивидуальной интеграции сотрудники Ютеки заносят в каталог недостающие товары, и товары без корректного штрихкода и кодов других справочников.
• При стандартной интеграции при модерации привязываются только товары с корректными штрихкодами или кодами справочников. Если этого недостаточно, Ютека может прислать Партнёру свой каталог в Excel файле. На основе него Партнёр может прислать привязки id своих товаров с id товаров Ютеки.

Стандартный график синхронизации товаров: каждые 3 часа.

Данные товаров, которые требуются для включения товара на сейте Ютеки:

Синхронизация остатков

Синхронизация торговых предложений — наиболее важная часть интеграции каталога.

Чем стабильнее и чаще происходит синхронизация остатков, тем меньше проблем при заказах (например, отмен из-за расхождения цен).

Ютека рекомендует синхронизировать цену и количество товара в аптеке каждые 15 минут. Период можно, но не рекомендуется, увеличивать.

Когда объемы данных для синхронизации становятся большими, и Партнер не может выгружать (или предоставлять по АПИ) данные по остаткам из-за технических особенностей работы их системы,

При индивидуальной интеграции возможна работа по механизму точечных остатков.

Требующиеся данные по остаткам:

Основные моменты синхронизации цен

С указанной периодичностью Ютека импортирует к себе остатки товаров по аптекам, полностью заменяя старые значения.

Ютека не предоставляет возможности делать заказы

• На дробное число товаров (например, 2 шприца из 10 в упаковке).
• По сильно заниженным или завышенным ценам

Механизм точечных остатков

При индивидуальной интеграции, Ютека может получать остатки у Партнёра при добавлении товара в корзину. Это позволяет снизить нагрузку на сервера Партнёра и улучшить точность формирования корзины. Кроме того, Ютека может работать без получения полных по-аптечных остатков товара от Партнера.
Подробнее механизм точечных остатков описан в разделе индивидуальной интеграции.