PHP > 7.0, Bitrix core > 17.0, Малый Бизнес +
Инструкция по работе с модулем ЭКСПРЕСС ГАРАНТ для пользователей CMS Bitrix (Интеграция)
Требования к инфраструктуре
Установка в системе
- Установка модуля производится стандартным способом через Битрикс MarketPlace
На странице решения нажимаем кнопку УСТАНОВИТЬ
Либо в административной части сайта переходим в раздел MarketPlace каталог решений.
Находим в списке решение ЭКСПРЕСС ГАРАНТ (Интеграция) и нажимаем ссылку установить.
2. После этого Вы будете перенаправлены в панель администрирования вашего сайта в раздел MarketPlace установленные решения. Далее находим в списке доступных решений модуль ЭКСПРЕСС ГАРАНТ (Интеграция) жмем меню справа от названия, устанавливаем.
Настройка модуля
Переходим в меню админки Bitrix ( настройки -> настройки модулей -> ЭКСПРЕСС ГАРАНТ (Интеграция) ) попадаем на форму настроек модуля
На закладке настройки представлены следующие опции:
1) Тестовый режим: если установлено модуль будет работать с тестовым сервером ЭКСПРЕСС ГАРАНТ
2) Настройка интеграции: Указываем API ключи полученные у Вашего менеджера системы ЭКСПРЕСС ГАРАНТ
3) Настройка уведомлений: Если уведомления включены, в заявке будет автоматически заполнятся поля для уведомлений средствами ЭКСПРЕСС ГАРАНТ по e-mail и(или) SMS.
4) Настройка служб доставок: Связываем службы доставок, используемые у вас на сайте для различных способов доставки и способы доставок в ЭКСПРЕСС ГАРАНТ.
5) Настройка платежных систем: Выбираем платёжные системы для наложенных платежей, в заявках с этим типом оплат автоматически будет проставляться checkbox наложенный платеж.
6) Проверка на использование стандартных свойств заказа в Битрикс:
Если не будут определены стандартные свойства заказа такие как:
Будет выведено предупреждающее сообщение
Если не все стандартные свойства определены, некоторые типы заявок не смогут быть отправлены.
7) Определение свойств для разложения адреса заказа по полям: Некоторые типы заявок требуют разбиения адреса клиента по полям иначе заявка не может быть создана. Если вы не используете отдельные поля в форме оформления заказа для указания улицы, дома и квартиры, можно создать такие свойства, пометить их как служебные и заполнять самостоятельно а заказе.
8) Автоматизация процессов Битрикс: При установленных параметрах в отгрузке будут установлены соответствующие значения, можно использовать для автоматизации процессов модуля (Интернет-магазин)
9) Режим отладки: При включенном режиме отладки API в директории /bitrix/modules/knksoft.exgarant/log/ будет создан лог обмена данными с API сервером.
Закладка статусы предназначена для определения статусов заказа и отгрузки bitrix соответствующие статусу в системе ЭКСПРЕСС ГАРАНТ.
Для автоматической смены статусов необходимо в карточке клиента в личном кабинете указать адрес web-скрипта http(s)://(site)/bitrix/tools/exgarant/webhook.php
в поле «Url для получения информации о смене статуса:»
Служит для загрузки справочников ПВЗ и Регионов для доставок.
Загрузка справочников может занять продолжительное время!
Служит для определения групп пользователей CMS Bitrix, имеющих право работать с модулем.
Для создания заявки на доставку в систему ЭКСПРЕСС ГАРАНТ, нужно перейти на закладку Магазин перейти к списку заказов (интернет – магазина), открыть необходимый заказа на просмотр, и перейти на вкладку ЭКСПРЕСС ГАРАНТ.
На закладке представлены параметры заказа и в зависимости от используемой службы доставки параметры заявки в службу ЭКСПРЕСС ГАРАНТ. Перед отправкой Вы можете изменить необходимые параметры создаваемой заявки. При помощи кнопки отправить будет сформирована заявка.
Если в процессе формирования будут выявлены ошибки или не допустимые параметры заявки, сообщение о них будет выведено в поле консоль сообщений API.
В случае удачного формирования заявки произойдет автоматическое обновление страницы, в верхней части закладки появятся статус заявки и кнопки для работы с дополнительными возможностями.
Можно напечатать ярлыки, отменить транспортную заявку.
Для изменения параметров созданной заявки просто выберите необходимые Вам параметры и отправьте еще раз. Страница обновится. В случае ошибки или невозможности произвести обновление, информация об этом будет выведена в консоль сообщений.
Посмотреть список отправленных заявок, можно в меню Заявки Экспресс гарант модуля (Интернет-магазин).