PHP > 7.0, Bitrix core > 17.0, Малый Бизнес +
Инструкция по работе с модулем ЭКСПРЕСС ГАРАНТ для пользователей CMS Bitrix (Интеграция)
Требования к инфраструктуре
Установка в системе
- Установка модуля производится стандартным способом через Битрикс MarketPlace
На странице решения нажимаем кнопку УСТАНОВИТЬ
![](https://ex-garant.ru/wp-content/uploads/2021/02/900x536xustanovka-modulja.jpg.pagespeed.ic.KIJZvvb0cA.jpg)
![](https://ex-garant.ru/wp-content/uploads/2021/02/marketplace-katalog-reshenij.jpg)
Либо в административной части сайта переходим в раздел MarketPlace каталог решений.
Находим в списке решение ЭКСПРЕСС ГАРАНТ (Интеграция) и нажимаем ссылку установить.
![](https://ex-garant.ru/wp-content/uploads/2021/02/ustanovit.jpg)
2. После этого Вы будете перенаправлены в панель администрирования вашего сайта в раздел MarketPlace установленные решения. Далее находим в списке доступных решений модуль ЭКСПРЕСС ГАРАНТ (Интеграция) жмем меню справа от названия, устанавливаем.
![](https://ex-garant.ru/wp-content/uploads/2021/02/modul.jpg)
Настройка модуля
![](https://ex-garant.ru/wp-content/uploads/2021/02/formu-nastroek-modulja.jpg)
Переходим в меню админки Bitrix ( настройки -> настройки модулей -> ЭКСПРЕСС ГАРАНТ (Интеграция) ) попадаем на форму настроек модуля
На закладке настройки представлены следующие опции:
1) Тестовый режим: если установлено модуль будет работать с тестовым сервером ЭКСПРЕСС ГАРАНТ
![](https://ex-garant.ru/wp-content/uploads/2021/02/xtestovyj-rezhim.jpg.pagespeed.ic.4gJQhh1tMk.jpg)
2) Настройка интеграции: Указываем API ключи полученные у Вашего менеджера системы ЭКСПРЕСС ГАРАНТ
![](https://ex-garant.ru/wp-content/uploads/2021/02/nastrojki-integracii.jpg)
3) Настройка уведомлений: Если уведомления включены, в заявке будет автоматически заполнятся поля для уведомлений средствами ЭКСПРЕСС ГАРАНТ по e-mail и(или) SMS.
![](https://ex-garant.ru/wp-content/uploads/2021/02/nastrojka-uvedomlenij.jpg)
4) Настройка служб доставок: Связываем службы доставок, используемые у вас на сайте для различных способов доставки и способы доставок в ЭКСПРЕСС ГАРАНТ.
![](https://ex-garant.ru/wp-content/uploads/2021/02/nastrojka-sluzhb-dostavok.jpg)
5) Настройка платежных систем: Выбираем платёжные системы для наложенных платежей, в заявках с этим типом оплат автоматически будет проставляться checkbox наложенный платеж.
![](https://ex-garant.ru/wp-content/uploads/2021/02/nastrojka-platezhnyh-sistem.jpg)
6) Проверка на использование стандартных свойств заказа в Битрикс:
![](https://ex-garant.ru/wp-content/uploads/2021/02/proverka.jpg)
Если не будут определены стандартные свойства заказа такие как:
![](https://ex-garant.ru/wp-content/uploads/2021/02/standartnye-sv-va.jpg)
Будет выведено предупреждающее сообщение
![](https://ex-garant.ru/wp-content/uploads/2021/02/preduprezhdajushhee-soobshhenie.jpg)
Если не все стандартные свойства определены, некоторые типы заявок не смогут быть отправлены.
7) Определение свойств для разложения адреса заказа по полям: Некоторые типы заявок требуют разбиения адреса клиента по полям иначе заявка не может быть создана. Если вы не используете отдельные поля в форме оформления заказа для указания улицы, дома и квартиры, можно создать такие свойства, пометить их как служебные и заполнять самостоятельно а заказе.
![](https://ex-garant.ru/wp-content/uploads/2021/02/opredelenie-svojstv-dlja-razlozhenija-adresa.jpg)
8) Автоматизация процессов Битрикс: При установленных параметрах в отгрузке будут установлены соответствующие значения, можно использовать для автоматизации процессов модуля (Интернет-магазин)
![](https://ex-garant.ru/wp-content/uploads/2021/02/avtomatizacija-processov-bitriks.jpg)
9) Режим отладки: При включенном режиме отладки API в директории /bitrix/modules/knksoft.exgarant/log/ будет создан лог обмена данными с API сервером.
![](https://ex-garant.ru/wp-content/uploads/2021/02/rezhim-otladki.jpg)
Закладка статусы предназначена для определения статусов заказа и отгрузки bitrix соответствующие статусу в системе ЭКСПРЕСС ГАРАНТ.
Для автоматической смены статусов необходимо в карточке клиента в личном кабинете указать адрес web-скрипта http(s)://(site)/bitrix/tools/exgarant/webhook.php
в поле «Url для получения информации о смене статуса:»
![](https://ex-garant.ru/wp-content/uploads/2021/02/zakladka-statusy.jpg)
Служит для загрузки справочников ПВЗ и Регионов для доставок.
Загрузка справочников может занять продолжительное время!
![](https://ex-garant.ru/wp-content/uploads/2021/02/zakladka-spravochniki.jpg)
Служит для определения групп пользователей CMS Bitrix, имеющих право работать с модулем.
![](https://ex-garant.ru/wp-content/uploads/2021/02/zakladka-dostup.jpg)
Для создания заявки на доставку в систему ЭКСПРЕСС ГАРАНТ, нужно перейти на закладку Магазин перейти к списку заказов (интернет – магазина), открыть необходимый заказа на просмотр, и перейти на вкладку ЭКСПРЕСС ГАРАНТ.
![](https://ex-garant.ru/wp-content/uploads/2021/02/prosmotr-zakaza.jpg)
На закладке представлены параметры заказа и в зависимости от используемой службы доставки параметры заявки в службу ЭКСПРЕСС ГАРАНТ. Перед отправкой Вы можете изменить необходимые параметры создаваемой заявки. При помощи кнопки отправить будет сформирована заявка.
![](https://ex-garant.ru/wp-content/uploads/2021/02/parametry-zakaza.jpg)
Если в процессе формирования будут выявлены ошибки или не допустимые параметры заявки, сообщение о них будет выведено в поле консоль сообщений API.
![](https://ex-garant.ru/wp-content/uploads/2021/02/vyjavlenie-oshibok.jpg)
В случае удачного формирования заявки произойдет автоматическое обновление страницы, в верхней части закладки появятся статус заявки и кнопки для работы с дополнительными возможностями.
![](https://ex-garant.ru/wp-content/uploads/2021/02/transportnaja-zajavka.jpg)
Можно напечатать ярлыки, отменить транспортную заявку.
Для изменения параметров созданной заявки просто выберите необходимые Вам параметры и отправьте еще раз. Страница обновится. В случае ошибки или невозможности произвести обновление, информация об этом будет выведена в консоль сообщений.
Посмотреть список отправленных заявок, можно в меню Заявки Экспресс гарант модуля (Интернет-магазин).
![](https://ex-garant.ru/wp-content/uploads/2021/02/otpravlennye-zajavki.jpg)
![](https://ex-garant.ru/wp-content/uploads/2021/02/otpravlennye-zajavki-2.jpg)