AdPar

Получение боевых доступов API Merlion и Cactus

Если у вас уже есть тестовые доступы Merlion или Cactus, укажите их в общих настройках AdPar в соответствующем блоке - Merlion / Cactus. Обязательно поставьте галочку Использовать тестовый сервер.

Если тестовых доступов еще нет, запросите их у дистрибьютора. Подробнее по ссылке.
В первую очередь для получения доступов к боевому серверу дистрибьютора необходимо загрузить в каталог товары дистрибьютора. Последовательность действий следующая:

Запускаем Агент категорий. Ждём окончания его работы.

Создаем тестовый раздел в инфоблоке (посредством функционала Битрикс) и привязываем к нему одну-две категории дистрибьютора. Инструкция по привязке категорий в уроке .

Внимание! Мы крайне не рекомендуем импортировать структуру дистрибьютора на тестовых доступах, поскольку на них могут быть ограничения по получению категорий дистрибьютора, а следовательно, структура загрузится не полностью.

Запускаем Агент товаров. Ждём окончания его работы. Проверяем наличие загруженных товаров в тестовом разделе каталога.

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

Для Merlion и Cactus обязательным условием полноценного использования доступа к сервису API является создание резерва товаров через API. Поэтому без проверки автоматического резервирования получить доступы к боевому серверу не получится.

В общих настройках AdPar в блоке Merlion (Cactus) активируем опцию Включить резервирование.

В таблице adpar_core_products (Настройки > Производительность > Таблицы > adpar_core_products) находим товар дистрибьютора, доступный для резервирования.

Признак он-лайн резервирования Merlion/Cactus:
"0" – да (разрешено)
"1" – нет (запрещено)
"2" – платная отмена резерва
"3" – дефицит
То есть ищем товары, которые в поле reserve имеют значение 0. Выбираем один товар и запоминаем значение в поле shop_product_id, это будет id элемента в каталоге Битрикс.
Переходим в раздел Магазин > Заказы и нажимаем Добавить заказ:
— При выборе товара в заказе находим по id элемента тот, который выбрали в предыдущем пункте.
— Статус заказа оставляем «Принят, ожидается оплата».
— Остальные параметры заказа (Покупатель, Доставка, Оплата) указываем на своё усмотрение, для резервирования они не имеют значения.
— Нажимаем Сохранить или Применить.

После создания заказа должен запуститься агент резервирования товаров дистрибьютора. Увидеть его можно в виде прогресс-бара в интерфейсе AdPar. Ждём когда данный агент завершит свою работу.

Переходим в логи AdPar:

Если всё отработало корректно, то в логах вы увидите запись следующего содержания:
Аналогичная запись об успешном создании резерва отобразится в комментарии менеджера в созданном заказе:

Внимание! Данный комментарий понадобится нам позже непосредственно при запросе боевых доступов у дистрибьютора. Скопируйте его и сохраните.
Далее необходимо отправить зарезервированный товар на отгрузку. Для этого в созданном заказе Битрикса нужно выбрать статус, при котором он уйдет на отгрузку. Данный статус указан в общих настройках модуля AdPar в блоке «Настройки заказа»:

По умолчанию данная опция имеет значение P (Оплачен), поэтому в нашем примере выбираем именно этот статус:
У вас название статуса может быть иным.

Сохраняем изменение статуса заказа.
Теперь в AdPar необходимо запустить агент подписи заказа:

В результате корректной работы данного агента в логах будет запись следующего типа:

В версии 4.0.2 модуля Merlion данная запись может отсутствовать, поэтому проверить отправлен ли заказ на подпись можно в тестовом B2B кабинете Merlion.
Для этого необходимо авторизоваться в тестовом B2B кабинете (адрес тестового B2B и данные для авторизации есть в письме дистрибьютора, в котором вы получали тестовые доступы для работы с API) и зайти в созданный вами ранее заказ. Если сверху справа видим кнопку Снять подпись, значит все прошло успешно:

Теперь можно отправлять дистрибьютору запрос на получение боевых доступов. Для этого необходимо заполнить форму:
- Для Merlion – https://api.merlion.com/
- Для Cactus – https://api.officeassistant.ru/
В поле Сервис необходимо указать B2B API (Интернет заказ), в поле Цель обращения – Запрос боевого доступа.

Сам запрос должен быть следующего содержания:

Добрый день.
Для работы с API используем готовое решение для 1С-Битрикс: Управление сайтом от компании «Инсмарт» – AdPar — автоматическая интеграция с B2B ___вставьте название дистрибьютора___.
С помощью модуля AdPar проверили загрузку данных по товарам. Протестировали резервирование:
«___ вставьте скопированный комментарий менеджера из заказа ___»
Просим предоставить боевые доступы.

После запроса может прийти ответ такого содержания:

Вероятнее всего это автоматическое сообщение, отправляемое роботом без участия оператора, поэтому в этом случае просто продублируйте вышеописанный текст с данными о нашем модуле и проведённом резервировании ещё раз.
После того, как получите ответ от дистрибьютора, вам нужно будет в настройках AdPar ввести новые логин и пароль (логин скорее всего останется прежним, пароль будет другой) и убрать галочку Использовать тестовый сервер:
Перед дальнейшей работой с модулем рекомендуем удалить весь тестовый товар из каталога, а также отвязать тестовые категории дистрибьютора.