Planfix: подключение и настройка (одна форма)

Вся настройка Planfix — в Модули интеграций → Подключения модулей.

Отдельно заходить в Интеграции не нужно (для Planfix эта форма не предназначена).

---

Что подготовить

Данные	Где в Planfix
Поддомен	Вход в CRM: https://company.planfix.ru → в поле пишете company
REST-токен	API / интеграции → создать токен
Секрет	Придумайте длинный пароль (20+ символов) — один и тот же в магазине и в сценарии Planfix

---

Шаг 1. Создать подключение

1. Подключения модулей → Создать.
2. Модуль — Planfix CRM.
3. Точки выдачи:
   • Все активные точки — один токен на все склады (рекомендуется для сети);
   • Одна точка — только выбранный склад.
4. Название — например Planfix.
5. Активно — включено.

Пример «все точки»: активны «Центр», «Север», «Юг» → после сохранения в списке три строки 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 настроен (по желанию)

Дальше: Пример на три точки или Если не работает.