Коннектор Планфикс: инструкция
Решение связывает Планфикс и МойСклад. В Планфиксе сделка это задача, а этап воронки это статус задачи. Задача, дошедшая до выбранного статуса, создает в МоемСкладе контрагента и заказ покупателя. Когда вы меняете статус этого заказа, задача в Планфиксе переезжает на статус, указанный в настройках.
Что нужно до начала
- Аккаунт Планфикса, в котором ведутся сделки задачами (воронка это набор статусов задачи).
- Тариф МоегоСклада с поддержкой вебхуков: любой платный или пробный. На бесплатном тарифе МойСклад не отправляет уведомления об изменениях документов, поэтому направление из МоегоСклада в Планфикс работать не будет.
- Права в МоемСкладе на контрагентов, юрлица и заказы покупателей. Они запрашиваются при установке решения, отдельно настраивать ничего не нужно.
Шаг 1. Установка
Установите решение из каталога решений МоегоСклада. После установки откройте его: раздел Решения, карточка решения, кнопка Перейти в решение.
Откроется окно настройки внутри МоегоСклада. Никаких паролей вводить не нужно: решение узнает вас по учетной записи МоегоСклада.
Шаг 2. Подключение Планфикса
В окне решения два поля:
- REST токен Планфикса — ключ доступа к API вашего аккаунта;
- Адрес аккаунта — адрес вашего Планфикса вида
company.planfix.com.
Токен создает администратор аккаунта: Управление аккаунтом, раздел Доступ по API, вкладка REST API, создать токен. Токену нужен доступ к задачам, контактам и объектам.
Заполните оба поля и нажмите Подключить. Данные сохраняются только после успешной проверки связи: если Планфикс их не принял, вы увидите сообщение с причиной.
После подключения индикатор Планфикса станет зеленым, и откроется доступ к правилам синхронизации.
Шаг 3. Правила синхронизации
Настройки находятся в том же окне, в карточке Правила синхронизации.
Воронка и этап-триггер
Выберите воронку (шаблон или процесс задач) и статус, при достижении которого создается заказ. Обычно это статус вида Согласовано или Оплачено. Задачи на других статусах коннектор не трогает.
Соответствие статусов
Таблица для обратного направления. Слева перечислены статусы заказа покупателя из вашего аккаунта, справа выбирается статус задачи. Например:
| Статус заказа в МоемСкладе | Статус задачи в Планфиксе |
|---|---|
| Отгружен | Выполненная |
| Отменен | Отклоненная |
Строки со значением не переводить оставляют задачу на месте. Это обычный способ настроить реакцию только на важные статусы.
Поля контакта
Чем заполнять карточку контрагента при создании. По умолчанию переносятся имя, телефон и почта, даже если ни одной строки не добавлено. Дополнительные строки позволяют перенести другие поля.
Выключатель синхронизации
Пока он выключен, коннектор ничего не создает и не меняет, но записывает в журнал, что он нашел бы. Удобно посмотреть на поведение до запуска.
Нажмите Сохранить правила.
Шаг 4. Проверка
- Создайте в Планфиксе тестовую задачу и добавьте в нее контакт с телефоном и почтой.
- Переведите задачу на статус-триггер.
- В течение минуты в МоемСкладе появятся контрагент и заказ покупателя. В комментарии заказа будет указан номер задачи.
- Смените статус заказа на тот, для которого настроено соответствие, и сохраните заказ.
- Задача в Планфиксе переедет на указанный статус.
Журнал синхронизаций
Внизу окна решения есть журнал. В нем видно каждое событие: направление обмена, результат и краткое описание. Записи фильтруются по статусу и направлению.
| Статус записи | Что означает |
|---|---|
| успешно | действие выполнено |
| пропущено | коннектор осознанно ничего не сделал, причина указана рядом: например, заказ по этой задаче уже создан или для статуса не настроен статус задачи |
| ошибка | действие не удалось, показывается полный текст ошибки |
Частые вопросы
- Почему в заказе нет товарных позиций?
- В задаче Планфикса товарных позиций нет, а МойСклад считает сумму заказа по позициям. Поэтому заказ создается с контрагентом и комментарием, в котором указан номер задачи, а позиции добавляются уже в МоемСкладе.
- Создаст ли коннектор второй заказ по той же задаче?
- Нет. Связь задачи и заказа сохраняется, повторная обработка исключается независимо от того, сколько раз задача попадет в выборку.
- Что будет, если клиент уже есть в справочнике контрагентов?
- Коннектор найдет его по почте, затем по телефону, и привяжет заказ к существующему контрагенту. Данные найденного контрагента не перезаписываются.
- Заказ изменил я сам, задача переедет?
- Да, если для нового статуса заказа настроено соответствие. Изменения, которые сделал сам коннектор, ответной синхронизации не вызывают.
- Как временно остановить обмен?
- Снимите галочку Синхронизация включена и сохраните правила. Настройки при этом сохранятся.
- Как отключить Планфикс?
- В карточке подключений нажмите Отключить. Токен будет удален из хранилища.
Поддержка
Вопросы и сообщения об ошибках: dentrancer@mail.ru. Если речь об ошибке, укажите время события и его описание из журнала синхронизаций, это ускорит разбор.