Настройка интеграции с ПланФикс¶

Настройка в ПланФикс¶

Перед тем, как приступить к настройке интеграции в GBS.Market, необходимо убедиться, что произведены настройки в ПланФикс и созданные все необходимые сущсности.

Получение данных для API¶

Важно Доступ к API есть только на платных аккаунтах ПланФикс. На бесплатных аккаунтах настроить связку не получится.

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

Необходимы:

API Key
Токен авторизации
Адрес сервера
Имя аккаунта

Эти данные можно получить в аккаунте ПланФикс в Управлении аккаунтом – Доступ к API.

Так выглядят настройки доступа к API в аккаунте ПланФикс

Если токен авторизации не был создан, необходимо создать его и задать права “Все функции”

Создание сущностей¶

Конфигруация Для быстрого создания сущностей в ПланФикс можно использовать конфигурацию: https://planfix.ru/conf/138064/GBSMarket?type=description

Для работы интеграции необходимо наличие следующих сущностей:

Проект – в рамках которого будут создаваться задачи-продажи
Шаблон задачи – по которому будет создаваться задача-продажа
Группа контактов – в которую будут передаваться контакты
Справочник товаров – в который будут передаваться товары с остатками. Должен содержать поля:
Название (строка)
Категория (строка)
Штрих-код (строка)
Цена (число)
Остаток (число)
Аналитика “список товаров”. Должна содержать поля:
Название товара (строка) [будет удалено в будущем]
Товар (запись справочника с товарами)
Цена (число)
Кол-во (число)
Скидка (число)
Комментарий (строка)
Аналитика “список платежей”. Должна содержать поля:
Название платежа (строка)
Сумма (число)

Права доступа¶

Необходимо убедиться, что у сотрудника (в ПланФикс), для которого создан токен авторизации есть все необходимые права доступа для созданных сущностей, чтобы к ним был доступ через API.

Дополнительные поля¶

В аналитиках при необходимости можно добавить поля итогов.

Например, для аналитики “список товаров” можно использовать вычисляемое поле по формуле:

{{Поле аналитики.Цена}}*{{Поле аналитики.Кол-во}}*((100-{{Поле аналитики.Скидка}})/100)

Добавив в шаблон задачи поле типа “итоги аналитик” это позволит отображать сумму товаров продажи.

Настройка в GBS.Market¶

После того, как в аккаунте ПланФикс будет выполнена настройка и созданы необходимые сущности, можно приступать к настройке программы.

Данные для авторизации¶

Откройте Файл-Настройки-Интеграции и включите интеграцию с ПланФикс.

Далее заполните данные, соответствующие указанным в вашем аккаунте ПланФикс.

Настройка данных для авторизации

Настройка связи сущностей¶

Необходимо выполнить настройку связки сущностей программы с сущностями ПланФикс.

Важно! Все необходимые сущности должны быть заранее созданные в ПланФикс

Чтобы настроить связку сущностей нажмите кнопку “Настроить” в настройках интеграции.

Настройка связки сущностей

Для каждого из пунктов необходимо выбрать соответствующую сущность.

Настройка связи полей аналитик¶

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

Настройка связи полей аналитик

Для каждого параметры необходимо задать соответствующее поле аналитики.

Параметры выгрузки продаж¶

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

Параметры выгрузки продаж

Период для автосохранения – периодичность в минутах, с которой будет происходить выгрузка данных о продажах
Сохранять продажи начиная с.
Если в GBS.Market уже есть продажи, то можно указать дату, с которой продажи начнут выгружаться в ПланФикс. Т.е. продажи, сделанные до указанной даты, не попадут в ПланФикс.