Настройка интеграции с ПланФикс
Время чтения 4 мин
Настройка в ПланФикс
Перед тем, как приступить к настройке интеграции в GBS.Market, необходимо убедиться, что произведены настройки в ПланФикс и созданные все необходимые сущсности.
Получение данных для API
ВажноДоступ к API есть только на платных аккаунтах ПланФикс. На бесплатных аккаунтах настроить связку не получится.
Для настройки интеграции необходимо получить данные для авторизации через API.
Необходимы:
- API Key
- Токен авторизации
- Адрес сервера
- Имя аккаунта
Эти данные можно получить в аккаунте ПланФикс в Управлении аккаунтом – Доступ к API.
Если токен авторизации не был создан, необходимо создать его и задать права “Все функции”
Создание сущностей
КонфигруацияДля быстрого создания сущностей в ПланФикс можно использовать конфигурацию: https://planfix.ru/conf/138064/GBSMarket?type=description
Для работы интеграции необходимо наличие следующих сущностей:
- Проект – в рамках которого будут создаваться задачи-продажи
- Шаблон задачи – по которому будет создаваться задача-продажа
- Группа контактов – в которую будут передаваться контакты
- Справочник товаров – в который будут передаваться товары с остатками. Должен содержать поля:
- Название (строка)
- Категория (строка)
- Штрих-код (строка)
- Цена (число)
- Остаток (число)
- Аналитика “список товаров”. Должна содержать поля:
- Название товара (строка) [будет удалено в будущем]
- Товар (запись справочника с товарами)
- Цена (число)
- Кол-во (число)
- Скидка (число)
- Комментарий (строка)
- Аналитика “список платежей”. Должна содержать поля:
- Название платежа (строка)
- Сумма (число)
Права доступа
Необходимо убедиться, что у сотрудника (в ПланФикс), для которого создан токен авторизации есть все необходимые права доступа для созданных сущностей, чтобы к ним был доступ через API.
Дополнительные поля
В аналитиках при необходимости можно добавить поля итогов.
Например, для аналитики “список товаров” можно использовать вычисляемое поле по формуле:
{{Поле аналитики.Цена}}*{{Поле аналитики.Кол-во}}*((100-{{Поле аналитики.Скидка}})/100)
Добавив в шаблон задачи поле типа “итоги аналитик” это позволит отображать сумму товаров продажи.
Настройка в GBS.Market
После того, как в аккаунте ПланФикс будет выполнена настройка и созданы необходимые сущности, можно приступать к настройке программы.
Данные для авторизации
Откройте Файл-Настройки-Интеграции и включите интеграцию с ПланФикс.
Далее заполните данные, соответствующие указанным в вашем аккаунте ПланФикс.
Настройка связи сущностей
Необходимо выполнить настройку связки сущностей программы с сущностями ПланФикс.
Важно!Все необходимые сущности должны быть заранее созданные в ПланФикс
Чтобы настроить связку сущностей нажмите кнопку “Настроить” в настройках интеграции.
Для каждого из пунктов необходимо выбрать соответствующую сущность.
Настройка связи полей аналитик
После того, как связи сущностей будут настроены, необходимо настроить связку полей аналитик. Это необходимо сделать для всех аналитик. Нажмите “настроить” рядом с аналитикой, чтобы открыть настройку связей полей.
Для каждого параметры необходимо задать соответствующее поле аналитики.
Параметры выгрузки продаж
Выгрузка продаж происходит автоматически, согласно указанным настройкам.
- Период для автосохранения – периодичность в минутах, с которой будет происходить выгрузка данных о продажах
- Сохранять продажи начиная с.
- Если в GBS.Market уже есть продажи, то можно указать дату, с которой продажи начнут выгружаться в ПланФикс. Т.е. продажи, сделанные до указанной даты, не попадут в ПланФикс.