![Rabitta.Shop](../assets/images/logo.png)

# Настройка вендор-части мерчантом

Инструкция для мерчанта по настройке «вендорной» части решения Rabitta.Shop в МойСклад и ВКонтакте.

## Что нужно до старта

- Аккаунт в **МойСклад** с правами администратора.
- Права администратора в сообществе ВКонтакте.
- Установленное расширение **Rabitta.Shop** в МойСклад.
- Установленное приложение **Rabitta.Shop** в ВКонтакте.

## Пошаговая настройка

- Войдите в расширение Rabitta.Shop в МойСклад под администратором.
- Откройте вкладку **«Настройки»** и включите нужные флаги (остатки, права для пользователей, обновление справочников).
- Откройте **«Интеграция ВК»** и привяжите сообщество, в котором будет работать витрина.
- Если у вас тариф с PIM, откройте **«Каталог PIM»**, создайте публикационный каталог и привяжите товары из МойСклад.
- Настройте отображаемые поля публикации: названия, описания, тип цены.
- Привяжите публикационный каталог к сообществу ВК и проверьте цены в сообществе.
- Во вкладке **«Платежи»** настройте интеграцию с платёжной системой.
- Во вкладке **«Пользователи ВК»** проверьте, что регистрации клиентов через ВК отображаются корректно.

## Настройка в МойСклад по шагам

### Шаг 1. Вкладка «Настройки» в решении Rabitta.Shop

Выберите "Использовать остатки в мини‑приложении ВК" - это значит, что будут использоваться остатки в каталоге и при оформлении заказа.
Выберите "Дать пользователям возможность настраивать каталоги" - вы предоставляете возможность пользователям аккаунта с не админскими правами править каталоги (закладка **«Каталог PIM»**)

Кнопка "Обновить справочники из МойСклад" загрузит в базу справочники, которые обычно редко меняются - склады, валюты, организации и т.д.

![Шаг 1 — Настройки в МойСклад](../assets/images/step-1.png)

После нажатия кнопки сохранить, слева внизу должно появиться зеленое поле с надписью "РЕШЕНИЕ ГОТОВО К РАБОТЕ"

![Шаг 1 — Настройки в МойСклад](../assets/images/step-1-2.png)

### Шаг 2. Привязка сообщества во вкладке «Интеграция ВК»

Перейдите на вкладку «Интеграция ВК». Первый раз у вас не привязано сообществ. Вы можете привязать столько сообществ, сколько вам предоставлено тарифом.

![Шаг 2 — Интеграция ВК](../assets/images/step-2.png)

Нажмите кнопку "Получить код привязки сообщества" и откроется окно с временным кодом привязки, код обновляется раз в минуту и вам надо успеть его ввести в мини апп ВК Rabitta.Shop. Установите в своем сообществе наше приложение и откройте его.[Сообщество Rabitta](https://vk.com/rabittapp)

![Шаг 2 — Интеграция ВК](../assets/images/step-2-2.png)

Как только вы ввели код, приложение привязывается к аккаунту МойСклад.

![Шаг 2 — Интеграция ВК](../assets/images/step-2-4.png)

Можно уже работать - базовый каталог МойСклад уже отображается в приложении.

![Шаг 2 — Интеграция ВК](../assets/images/step-2-5.png)

### Шаг 3. Настройка сообщества
Для корректного создания заказов в МойСклад необходимо заполнить все настройки.

![Шаг 3. Настройка сообщества](../assets/images/step-3-1.png)

**«Организация»** - компания, от имени которой идут продажи. Выбирается из справочника Организации в МойСклад.

**«Склад** - склад, который будет подставляться при создании заказа, но и если включен контроль остатков, то с него будет осуществляться контроль остатков.

**«Тип цены по умолчанию»** - Тип цены который будет показываться пользователям, если не установлены другие типы цен для каталога или персональные цены (в таком случае будет выбираться лучшая цена из имеющихся и показываться пользователю).

**«Канал продаж»** - Канал продаж выставляется в справочнике в Мой склад и используется для аналитики. Для настроек надо выбрать канал прода из списка, который настроен в Мой склад.

**«Публикационный каталог»** - Каталог для публикации в мини апп в ВК (если включает тариф).

**«Создавать заказ проведенным»** - По умолчанию заказ покупателя в Мой склад создается не проведенным, чтобы он создавался проведенным надо выбрать эту настройку.

**«Статус заказа при создании, с ожиданием оплаты через менеджера»** - Возможно выбрать статус заказа люой из настроенных. При оформлении заказа клиентом с оплатой через менеджера (без нлайн оплаты), выставляется выбранный статус.

**«Статус заказа, при создании с экварингом и для кнопки Оплатить...»** - Если клиент оплатил заказ сразу после оформления или отложил на оплату онлайн после оформления - будет установлен этот статус заказа в Мой склад.

![Шаг 3. Настройка сообщества](../assets/images/step-3-2.png)

**«Статус завершенного заказ»** - статус, который считаем, что заказ полностю выполнен и положительно завершен.

**«Статус отмененного заказа»** - статус, который считаем, что заказ отменен.

**«Статус возвращенного заказа»** - статус, который считаем, что заказ возвращен клиенту.

**«Минимальная сумма заказа, рубли»** - сумма минимального заказа к оформлению, меншь этой суммы заказ нельзя оформить, о чем будет предупреждение в корзине.

**«Токен сообщества ВК»** - для поддержки некоторых фичей требуется установка токена сообщества (уточняйте в поддержке).

### Шаг 4. Создание публикационного каталога PIM

- Придумайте название для каталога и сохраните его
- Нажмите кнопку **Редактировать** напротив каталога, чтобы его сделать. 

![Шаг 4 — Каталог PIM](../assets/images/step-4-1.png)

- Выберите Тип цены для каталога, она будет использоваться для отображения цены в каталоге, в соответствии с алгоритмом.
- Нажмите **Создать копию базового каталога**, если вы хотите сделать ваш Публикационный каталог на базе основного каталога. При этом вся структура текущего Публикационного каталога будет очищенна.

![Шаг 4 — Каталог PIM](../assets/images/step-4-2.png)

- Внизу страницы появится структура каталога, все шаги настройки относятся как к созданному каталогу копированием базового каталога, так и ручное содание каталога.
- Будет структура каталога, с любым количеством вложения.
- Внизу есть кнопка **Создать раздел** для создания раздела в корне каталога.
- Справа напротив каждого раздела есть меню операций.

![Шаг 4 — Каталог PIM](../assets/images/step-4-3.png)

#### **Редактировать**
- Можно изменить название раздела
- Можно изменить родительский раздел
- Можно установить Порядок сортировки число от 0, чем больше число - тем ниже будет отображаться раздел.

![Шаг 4 — Каталог PIM](../assets/images/step-4-3-1.png)

####**Создать**
- Можно создать название раздела
- Можно привязать к произвольному родительскому разделу
- Можно установить Порядок сортировки число от 0, чем больше число - тем ниже будет отображаться раздел.

![Шаг 4 — Каталог PIM](../assets/images/step-4-3-2.png)

####**Создать товар**
Здесь вы можете сделать привязку товара из базового каталога Мой склад. Новый товар не создается, вы можете привязать любое количество раз базовый товар в создаваемый каталог.
- **Поиск товара в каталоге** - введите название товара и нажмите **Найти** - отобразятся найденные товары и можно выбрать один товар.
- **Категория канала** - выберите раздел Публикационного каталога, в который будет привязан товар.
- **Переопределения для витрины ВК** - можно переопределить название, описание и цену товара. Алгоритм выбора цены сам выбирает самую низкую цену из настроенных и отображает именно ее, поэтому переопределить цену в сторону ее увеличения не получится, если будут настроены Типы цен в других местах, которые будут дешевле для этого товара.
- Выберите галочку **Задать цену на витрине (число)** если хотите ввести другую цену чем будет определена автоматом.

![Шаг 4 — Каталог PIM](../assets/images/step-4-3-3.png)

####**Удалить раздел**
Удаляет раздел, если он пустой.

####**Настройка связки товара**
Для связки товара возможно настроить/перенастроить название, описание и цену отображаемую в Публикационном каталоге.

![Шаг 4 — Каталог PIM](../assets/images/step-4-3-4.png)

Можно редактировать или удалить связку.
При редактировании откроется окно, в откором можно
- Изменить размещение связки в каталоге
- Изменить название (текущее название отображается)
- Изменить описание (текущее описание отображается)
- Изменить цену (текущая цена отображается)

![Шаг 4 — Каталог PIM](../assets/images/step-4-3-5.png)

### Шаг 5. Настройка приема онлайн оплат

Перейдите на закладку **Платежи**, на ней можно выбрать способ приема оплаты онлайн платежей (интернет-эквайринг).
При выборе типа оплаты будет отображаться специфическая документация, как активировать и протестировать оплату.

![Шаг 5 — Настройка приема онлайн оплат](../assets/images/step-5.png)

### Шаг 6. Отчет по пользователям ВК

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

![Шаг 6 — Отчет по пользователям ВК](../assets/images/step-6.png)

## Проверка перед запуском

- Сделайте тестовый заказ через мини-приложение ВК.
- Убедитесь, что заказ появился в МойСклад с корректными товарами, ценами и данными клиента.
- Проверьте, что цены считаются по правилу минимальной цены (сообщество / каталог / персональная цена контрагента).

## Полезные ссылки

- [Быстрый старт](../getting-started)
- [Каталог: МойСклад и PIM](../catalog)
- [Roadmap](../roadmap)

---

## 💡 Не хватает функции?

Создайте задачу и опишите ваш кейс:  
https://gitjet.ru/rabitta/rabitta.ru/issues