Planfix: подключение и настройка (одна форма)
Вся настройка Planfix — в Модули интеграций → Подключения модулей.
Отдельно заходить в Интеграции не нужно (для Planfix эта форма не предназначена).
Что подготовить
| Данные | Где в Planfix |
|---|---|
| Поддомен | Вход в CRM: https://company.planfix.ru → в поле пишете company |
| REST-токен | API / интеграции → создать токен |
| Секрет | Придумайте длинный пароль (20+ символов) — один и тот же в магазине и в сценарии Planfix |
Шаг 1. Создать подключение
- Подключения модулей → Создать.
- Модуль — Planfix CRM.
- Точки выдачи:
- Все активные точки — один токен на все склады (рекомендуется для сети);
- Одна точка — только выбранный склад.
- Название — например
Planfix. - Активно — включено.
Пример «все точки»: активны «Центр», «Север», «Юг» → после сохранения в списке три строки Planfix — Центр, Planfix — Север, Planfix — Юг с одинаковыми настройками.
Шаг 2. Учётные данные Planfix
| Поле | Пример | Пояснение |
|---|---|---|
| Поддомен Planfix | company |
Без .planfix.ru |
| REST-токен | •••••• |
При редактировании пустое поле = не менять токен |
| Секрет inbound webhook | K7mP9xQ2nL4vR8wT1yU6sA0dF |
Ваш пароль; не публикуйте |
Шаг 3. Задачи Planfix
После поддомена и токена подгрузятся списки из Planfix.
| Поле | Пример | Обязательно |
|---|---|---|
| Шаблон задачи | «Заказ с сайта» | Да для новых заказов |
| Процесс задачи | «Интернет-заказы» | Рекомендуется |
| Статус по умолчанию | «Новая» | После выбора процесса |
| Позиции заказа | Чеклист задачи | Обычно так и оставляют |
Пример: без шаблона заказ № 1842 в Planfix не создастся — в логах будет просьба указать шаблон.
Шаг 4. Поведение экспорта
| Поле | Рекомендация |
|---|---|
| Режим экспорта | Авто + кнопка в заказе (или пусто = как в Настройках Planfix в каталоге) |
| Экспорт при оформлении | Вкл. |
| Экспорт при смене статуса заказа | Вкл. |
| Экспорт при смене статуса позиции | Вкл., если важны строки заказа |
| Экспорт при успешной оплате | Вкл. |
| Не экспортировать гостя без телефона | По желанию |
| Экспорт: dry-run, Опрос: dry-run | Выкл. на проде (только тест) |
| Терминальные статусы заказа | «Выполнен», «Отменён» — не опрашивать Planfix лишний раз |
Подробнее про работу заказов — Заказы в Planfix.
Шаг 5. Маппинг статусов
Блок «Маппинг статусов Planfix».
Статусы заказа
Нажмите Добавить для каждой пары:
| ID статуса Planfix | Статус заказа на сайте |
|---|---|
| 3 | В работе |
| 5 | Готов к выдаче |
| 7 | Выполнен |
ID берите в Planfix (справочник статусов процесса) — уточните у администратора CRM.
Пример: в Planfix задача перешла в статус 5 → на сайте заказ становится «Готов к выдаче».
Статусы позиций (необязательно)
| Ключ checklist | Статус позиции на сайте |
|---|---|
arrived |
Пришло |
issued |
Выдано |
Шаг 6. Адрес для Planfix
После сохранения в форме появится строка Inbound webhook, например:
POST /api/integrations/v1/integrations/inbound/Planfix/10
Пример для администратора Planfix:
- Полный URL:
https://ваш-магазин.ru/api/integrations/v1/integrations/inbound/Planfix/10 - Секрет — тот же, что в поле Секрет inbound webhook
- Тело запроса — см. Статусы из Planfix
У каждой точки выдачи свой номер в URL (10, 11, 12…). Смотрите ID в списке Подключения модулей.
Шаг 7. Каталог модуля
Каталог модулей → Planfix CRM:
| Кнопка | Когда нажимать |
|---|---|
| Настройки Planfix | Режим «сам / кнопка» по умолчанию для новых подключений |
| Отправить накопившиеся | Заказы не ушли 2–3 минуты |
| Включить фон | Обычно не нужно — сайт уже обрабатывает очередь |
| Подключения | Список всех точек Planfix |
Редактирование нескольких точек
Если создавали «Все точки», настройки одинаковые, но править нужно каждую строку в списке подключений (или создайте заново «все точки» с новыми значениями).
Пример: сменили шаблон задачи — откройте Planfix — Центр, Planfix — Север, Planfix — Юг и сохраните в каждой.
Чеклист
- Лицензия и включение модуля
- Подключение создано, шаблон задачи выбран
- Маппинг статусов заполнен (если нужен обмен из Planfix)
- Тестовый заказ → задача в Planfix
- Сценарий в Planfix настроен (по желанию)
Дальше: Пример на три точки или Если не работает.