Настройка модуля

1. Предварительные настройки

1. Рекомендуем создать нового пользователя под которым будут создаваться заказы от маркетплейса МегаМаркет.

• Настройки → Пользователи → Список пользователей
• Добавить пользователя. Создайте его правами зарегистрированного пользователя, а в поле логин укажите “sbermm”.

2. Если у вас нет подходящего, то создайте 2 новых свойства заказа “Внешний номер заказа” и “Дата отгрузки”.

• Магазин → Настройки → Свойства заказа → Список свойств





3. Если у Вас не создано подходящей службы доставки, создайте её

• Магазин → Настройки → Службы доставки
• Примечание: если вы хотите создать службу доставки, которая будет использоваться только для модуля МегаМаркет API вам ОБЯЗАТЕЛЬНО нужно ограничить по группе пользователей - "Администраторы", иначе эта служба будет видна обычным пользователям на сайте.

4. Если у Вас не создано подходящей платёжной системы, создайте её

• Магазин → Настройки → Платежные системы
• Примечание: если вы хотите создать платежную систему, которая будет использоваться только для модуля МегаМаркет API вам ОБЯЗАТЕЛЬНО нужно ограничить платежную систему по новой службе доставки, чтобы она не была видна обычным покупателям.

2. Подключение к API МегаМаркета

1. Выберите сервер для запросов к API

1. Для выбора доступно несколько вариантов:
   • Основной сервер с интеграцией по API
   • Основной сервер без интеграцией по API
   • Тестовый сервер
   • Свой сервер

При использовании основного сервера с интеграцией по API для получения новых заказов требуется включение параметра "Интеграция" на странице "Настройка интеграции по API" в личном кабинете МегаМаркет.

Там же необходимо заполнить пути к обработчикам на вашем сайте (вместо ДОМЕН_САЙТА укажите свой домен):

order/new: http(s)://ДОМЕН_САЙТА/bitrix/tools/wbs24.sbermmapi/order/new/

order/cancel: http(s)://ДОМЕН_САЙТА/bitrix/tools/wbs24.sbermmapi/order/cancel/





2. Введите URL для запросов к API (Доступно только если указано “Свой сервер” в пункте 2.1)

3. Введите уникальный ключ (API Key) из личного кабинета МегаМаркета

4. Введите клиентский идентификатор (Client ID) из личного кабинета МегаМаркета

5. Выберите количество дней, за которые будут обрабатываться статусы у заказов. Оптимальный период - 30 дней. (опционально)







Тестовый режим

Предназначен для проверки работоспособности модуля. При установке этой галочки и сохранении модуля в заказах должны появится 2 тестовых заказа. Если тестовые заказы появились, это означает, что модуль работает корректно. В этом случае необходимо снять галочку в настройках модуля и удалить тестовые заказы.
После этого можно вводить уникальный ключ и клиентский идентификатор (пункт 2.1 и 2.2)

Сохранение логов

Необходимо для проверки модуля если что-то идёт не так. Желательно не оставлять постоянно включенным, иначе может заполнить память.
Файлы логов можно просмотреть в папке /upload/ с префиксом 

wbs24.sbermmapi




3. Авто-запуск

1. Установите галочку на свойство “Включить авто-запуск забора заказов”.

• Без этой настройки заказы приходить не будут!

2. Установите интервал автозапуска. Оптимальный интервал - 10 минут. (Индивидуально)

3. Установите протокол передачи данных в зависимости от настроек сайта.






4. Данные для создания заказов

1. Укажите ID пользователя, под которым будет создаваться заказ (Пользователь из пункта 1.1)

Внимание! Если вы не заполните настройку 'ID пользователя', заказ автоматически будет создаваться под пользователем с ID = 1




2. Выберите ID сайта

• Настройки → Настройки продукта → Сайты → Список сайтов



3. Укажите Тип плательщика (физическое или юридическое лицо)

4. Укажите службу доставки по-умолчанию (пункт 1.3)

5. Укажите Платежную систему (пункт 1.4)

6. Укажите Свойство заказа “Внешний номер заказа” и “Дата отгрузки” (пункт 1.2)

7. Укажите Артикул в МегаМаркете (для товара, комплекта или набора) 

• Свойство товара, по которому осуществляется привязка. Должно быть одинаковое у товара на сайте и в кабинете МегаМаркета. Самый распространенный способ - использовать ID товара.

8. Укажите Артикул в МегаМаркете (для торгового предложения)

• Свойство торгового предложения,, по которому осуществляется привязка. Должно быть одинаковое у ТП на сайте и в кабинете МегаМаркета. Самый распространенный способ - использовать ID ТП.

9. Выберите свойство для настройки коэффициента упаковки, в котором храните количество единиц в упаковке.

• Цена товара будет разделена на значение выбранного коэффициента, количество товара будет умножено.

• По умолчанию коэффициент упаковки равен 1.

10. Создавать заказы в Битрикс с учетом скидок на МегаМаркете

• Если эта настройка включена, когда на МегаМаркете товар продался с скидкой, информация об этой скидке попадет в товар в заказе.
• Если опция не отмечена - то скидки на МегаМаркете игнорируются

11. Укажите Шаблон комментария

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

#SHIPMENT_ID# - ID отправления на МегаМаркете

#CREATE_DATE# - дата заказа






5. Соответствие статусов c МегаМаркет

1. Если ещё не настроено, добавьте и настройте статусы заказа

• Магазин → Настройки → Статусы



2. Можно выбрать те статусы, которые точно подходят по смыслу (Выполнен, Отменен).






6. Установка флагов для статусов с МегаМаркет

1. Выберите в списке статус(-ы) заказа на Маркетплейсе МегаМаркет, при которых вы хотите проставлять заказу флаг оплаты






2. Выберите в списке статус(-ы) заказа на Маркетплейсе МегаМаркет, при которых вы хотите проставлять заказу флаг отгрузки<



3. Выберите в списке статус(-ы) заказа на Маркетплейсе МегаМаркет, при которых вы хотите проставлять заказу флаг отмены






7. Автоподтверждение заказов FBS на МегаМаркет

1. Для активации установите галочку

• При активации опции автоподтверждения заказов по умолчанию все заказы, у которых все товары успешно привязаны к каталогу, будут автоматически подтверждены на МегаМаркет. 
• Доступно только для FBS доставки

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

• Данная опция будет срабатывать, когда в заказе Bitrix все товары создались без привязки к каталогу (у таких товаров будет идентификатор 99999999).
• Есть три варианта как будет действовать модуль в таком случае:
  1. Игнорировать - то есть никаких запросов на автоподтверждение заказа делаться не будет.
  2. Полная отмена - все товары будут отменены в заказе МегаМаркет.
  3. Подтвердить принудительно - в таком случае все товары будут автоматически подтверждены в заказе МегаМаркет.

3. Установите действие для случая, если лишь некоторые заказы, которые по каким-либо причинам создались некорректно

• Данная опция будет срабатывать, когда в заказе Bitrix есть товары с привязкой к каталогу и есть товары без привязки (у таких товаров будет идентификатор 99999999).
• Есть четыре варианта как будет действовать модуль в таком случае:
1. Игнорировать - то есть никаких запросов на автоподтверждение заказа делаться не будет.
2. Полная отмена - все товары будут отменены в заказе МегаМаркет.
3. Частичная отмена / Частичное подтверждение - те товары, у которых есть привязка к каталогу будут подтверждены в заказе МегаМаркет. А те товары, у которых нет привязки к каталогу, будут отменены.
4. Подтвердить принудительно - в таком случае все товары будут автоматически подтверждены в заказе МегаМаркет.





Нужна помощь? Напишите нам на почту support@wbs24.ru