Инструкция по установке приложения интеграции InSales с Бета ПРО

1) Войти в админку Вашего магазина и войти в центр приложений:

2) В центре приложений найти приложение «Интеграция с Бета ПРО» и нажать «Установить». После успешной установки приложения оно появится в списке установленных приложений (рис. выше).

3) Для настройки приложения требуется нажать на логотип «BETAPRO». В открывшемся окне «Регистрация и редактирование» заполнить поля формы.

4) Описание полей: - имя домена в InSales: требуется ввести название домена магазина в InSales. Пример: есть имя домена «myshop-da937.myinsales.ru», в поле требуется ввести «myshop-da937» (латинница)
- Название магазина: Название Вашего магазина или название Вашей организации.
- Ключ API для CRM InSales: API ключ для доступа в CRM InSales. Состоящий из пары: «Идентификатор»:«Пароль» разделенные двоеточием. Получить и сгенерировать можно на странице «Приложения» – «Разработчикам»

- Размеры и Вес посылки по умолчанию: ширина, глубина и высота стандартной посылки в мм и вес в граммах.
- Суммы в заказе включают НДС: Установить флаг, если суммы заказов включают НДС.
- Продукт Бета ПРО: установить флаг, если клиент Бета ПРО работает по схеме «Фулфилмент».
- Несколько магазинов: Установить флаг (в позицию “on”), если клиент Бета ПРО подключает несколько магазинов. При этом требуется заполнить поле «Префикс номера магазина»
- Префикс номера магазина: заполняется префиксом магазина, который будет добавлен в номер заказа в Бета ПРО. Только при установленном флаге «Несколько магазинов».
- Партнёрский ключ Бета ПРО: Партнёрский ключ клиента Бета ПРО для входа в личный кабинет.
- Пароль ЛК Бета ПРО: Пароль клиента для входа в личный кабинет Бета ПРО.
- Услуга доставки в Бета ПРО: Артикул услуги доставки в Бета ПРО.

5) После настройки полей, заполнить поле капчи и нажать кнопку «Зарегистрироваться». При этом все заполненные поля будут сохранены во внутренней таблице Бета ПРО. Далее перейти (если не открылось автоматически) к закладке «Выбор служб доставки». Откроется такое окно:

Если какие-то службы доставки из списка требуется включить, то установите флаг (в позицию “on”), иначе эта служба доставки будет отключена.
Список служб(способов) доставки в InSales – группа служб доставки, установленных в InSales до установки приложения. При отключении службы доставки в списке, служба исчезнет из списка до дальнейшей активации в админке магазина InSales.
Выберите службы доставки Бета ПРО – группа служб доставки, подключенных по партнёрскому договору с Бета ПРО. При отключении, служба доставки не будет выводиться в списке доступных служб доставки для выбора на форме оформления заказа и по этой службе не будет рассчитана предварительная сумма доставки.
При нажатии на кнопку «Сохранить» будут записаны настройки выбора служб доставок.

6) Нажать кнопку «Завершить установку». При этом в CRM InSales будут созданы: - службы доставки:

- дополнительные поля формы заказа:

- пользовательские статусы:

Пользовательские статусы должны быть активированы:

7) Далее предлагается настроить правила расчета суммы доставки. Для этого требуется перейти на закладку «Настройка вычисления суммы доставки». Здесть предлагается создать правило или набор правил для расчета суммы доставки.

Описание правил:
Увеличить/уменьшить предварительную сумму доставки на __ Рубли – увеличивает или уменьшает рассчитанную сумму доставки на сумму указанную в поле __. Формула: «сумма доставки» +/- «введенная сумма».
Увеличить/уменьшить предварительную сумму доставки на __ % от суммы доставки – увеличивает или уменьшает рассчитанную сумму доставки на % от суммы доставки указанную в поле __. Формула: «сумма доставки» +/- («сумма доставки» * «введенный %» / 100).
Увеличить/уменьшить предварительную сумму доставки на __ % от оценочной стоимости – увеличивает или уменьшает рассчитанную сумму доставки на % от оценочной стоимости. Формула: «сумма доставки» +/- («оценочная стоимость заказа» * «введенный %» / 100).
Увеличить/уменьшить предварительную сумму доставки на __ % от наложенного платежа – увеличивает или уменьшает рассчитанную сумму доставки на % от наложенного платежа. Формула: «сумма доставки» +/- («наложенный платеж заказа» * «введенный %» / 100).
Округлить до кратного в большую сторону на __ – увеличивает рассчитанную сумму доставки до суммы кратной введенному значению и больше начальной суммы доставки. Формула: ОКРБ(«сумма доставки» / «введенное значение») * «введенное значение», где ОКРБ – округление до большего значения (1,5 - 2).
Округлить до кратного в меньшую сторону на __ – уменьшает рассчитанную сумму доставки до суммы кратной введенному значению и больше начальной суммы доставки. Формула: ОКРМ(«сумма доставки» / «введенное значение») * «введенное значение», где ОКРМ – округление до меньшего значения (1,5 - 1).
Переключатель («on»/«off») служит для включения / выключения правила расчета суммы доставки. По выключенным правилам (положение «off») расчеты суммы доставки не производятся и правило игнорируется.
- кнопка удаления правила. После удаления правило не будет выводиться в таблице правил. Удаленное правило можно восстановить в таблице через программистов.
При создании нового правила расчета суммы доставки обязательно требуется заполнить поле «Название правила доставки».

8) На этом установка приложения завершена. После успешной инсталляции требуется настроить «Таблицу соответствий статусов».

Здесь пример настройки:

Требуется установить соответствие статусам Бета ПРО в левой части статусам InSales в правой. Заполнять соответствия требуется по всем полям (строкам). Поля "-" и "--" - должны соответствовать статусу ошибки в InSales.
Далее ввести капчу и нажать «Сохранить». Чтобы вернуться в натройки приложения, нажмите "Перейти на страницу настроек модуля интеграции" в правом нижнем углу формы.

9) На этом все настройки закончены. Можно приступать к выгрузке заказов или товаров в Бета ПРО.

10) Выгрузка товаров производится на закладке "Выгрузка товаров в Бета ПРО". При выборе закладки на форме появится примерно такая форма:

В таблице "Таблица товаров InSales" выведены все загруженные товары из InSales. Если флаг выгрузки (колонка "Выгрузить") установлен в - товар еще не выгружен в Бета ПРО, если установлен в - товар уже выгружался в Бета ПРО. При этом товар можно выгрузить (для смены типа товара или наименования) или оприходовать установив флаг "Выгрузить" в . Товары из Бета ПРО в этой таблице не выводятся.

Описание кнопок:
Установить флаг выгрузки для всех товаров - Устанавливает значение по флагу рядом с кнопкой для всех товаров в колонке "Выгрузить" таблицы "Таблица товаров InSales".
Обновить таблицу товаров InSales - Заново загружает товары из InSales в таблицу "Таблица товаров InSales", очищая старые значения. Тип всех товаров (колонка "Тип") устанавливается "товар".
Оформить задание на оприходование товаров в Бета ПРО - Формирует "Задание на оприходование товаров" в Бета ПРО перед поступлением товаров на склад Бета ПРО или создании нового товара по данным из таблицы "Таблица товаров InSales".
Выгрузить товары в Бета ПРО - Создаёт товары в справочнике товаров Бета ПРО по данным из таблицы "Таблица товаров InSales".
Описание кнопок пагинации под таблицей:
Первая - Кнопка для быстрого перехода на первую страницу пагинации.
Следующая - Кнопка для быстрого перехода на первую страницу пагинации.
С третьей страницы пагинации становится доступна кнопка "Предыдущая" для перехода на предыдущую страницу. Недоступна при переходе на первую и вторую страницу.
Примечание:
Пагинация выводит те товары, которые можно получить командой API InSales c указанием страницы. То есть товары выводятся в таком виде и в таком количестве, как их передаёт InSales.

Если товар отсутствует в таблице "Таблица товаров InSales", его можно добавить вручную в таблицу "Таблица товаров InSales" заполнив поля:

И нажать кнопку для добавления товара в таблицу "Таблица товаров InSales". Можно использовать для создания услуги доставки в Бета ПРО.
Описание полей:
Арт. - Поле для ввода артикула нового или изменяемого товара.
Наименование - Поле для ввода наименования нового или изменяемого товара.
Тип - Поле для выбора из списка типа товара.
Колич. - Поле для ввода количество нового или изменяемого товара. Вводится только для случая формирования "Задание на оприходование товаров" в Бета ПРО.
+ - Кнопка добавляет товар в таблицу "Таблица товаров InSales" по введенным значениям (далее пример заполнения полей для услуги "Доставка"):

Если требуется изменить наименование или тип товара в Бета ПРО, в случае отсутствия товара в таблице "Таблица товаров InSales", тогда ввести артикул существующего в Бета ПРО товара, заполнить нужное наименование, нужный тип товара, количество можно оставить 0. Добавить кнопкой товар в таблицу "Таблица товаров InSales", установить флаг в колонке "Выгрузить" в положение и сохранить изменения в Бета ПРО кнопкой "Выгрузить товары в Бета ПРО".

Примечания:
Выгрузка заказа в Бета ПРО производится в административной части магазина InSales установкой статуса «Готов к передаче в БП» в самом заказе

или групповой установкой статуса «Готов к передаче в БП» из меню «Изменить статус» в списке заказов «Все заказы»

Результатом выгрузки заказа в Бета ПРО является изменение пользовательского статуса заказа: «ошибка» - в случае ошибки загрузки и «Передан в БП» - в случае успешной выгрузки. Но конечный статус на форме заказа или в списке заказов в InSales после выгрузки в Бета ПРО отображается не сразу, требуется обновить форму заказа или обновить список заказов в браузере.

Для успешной выгрузки заказа в Бета ПРО требуется заполнение полей (только при выборе курьерских служб доставки и Почты России) "Улица (БП)", "дом/корпус-квартира (БП)" и "Почтовый индекс".

Как альтернатива, вместо заполнения полей "Улица (БП)", "дом/корпус-квартира (БП)" можно заполнить поле "Адрес" значением улцы, дома, квартиры и т.д. в произвольном формате. Система сама разделит адрес на части: улица, дом, квартира и т.д.

Но нет гарантии, что адрес будет кррректно разделен на части. За передачу адреса отвечает пользователь интеграции с Бета ПРО. Чтобы избежать ошибок, заполняйте поля "Улица (БП)" и "дом/корпус-квартира (БП)."