Инструкция по работе с модулем ЭКСПРЕСС ГАРАНТ для пользователей CMS Bitrix (Интеграция)

Требования к инфраструктуре

PHP  > 7.0,  Bitrix core > 17.0, Малый Бизнес +

Скачать API Exgarant

Установка в системе

  1. Установка модуля производится стандартным способом через Битрикс 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.

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

Можно напечатать ярлыки, отменить транспортную заявку.

Для изменения параметров созданной заявки просто выберите необходимые Вам параметры и отправьте еще раз. Страница обновится. В случае ошибки или невозможности произвести обновление, информация об этом будет выведена в консоль сообщений.

Просмотр списка сформированных заявок:

Посмотреть список отправленных заявок, можно в меню Заявки Экспресс гарант модуля (Интернет-магазин).

Остались вопросы?

Свяжитесь с нами!