Пользовательские скрипты

В системе PARTS SOFT вы можете использовать собственные скрипты для автоматизации задач. При наступлении определённых событий JavaScript автоматически выполняет заданные действия по настроенному сценарию.

Например, при получении от клиента заявки на возврат можно автоматически ставить менеджеру задачу на обработку заявки, а возвратную позицию переводить в статус Возврат ожидает обработки.

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

Функционал доступен:

• на тарифах аренды Магазин / Расширенный — 1 скрипт  
• на тарифах обслуживания Сеть / Бизнес — 3 скрипта  
• на тарифах обслуживания Сеть+ / Бизнес+ — 10 скриптов

Список скриптов

Все созданные вами пользовательские скрипты находятся в разделе панели администрирования Служебные → Пользовательские скрипты.

На странице со списком скриптов доступны следующие действия:

1. Найти нужный скрипт с помощью фильтров;
2. Перейти к редактированию скрипта;
3. Перейти к просмотру событий скрипта;
4. Перейти к логам скрипта;
5. Перейти к редактированию скрипта;
6. Включить/Отключить скрипт;
7. Удалить скрипт;
8. Создать новый скрипт.

Список скриптов

Создание скрипта

Чтобы создать новый пользовательский скрипт, выполните следующие действия:

ШАГ 1. В панели администрирования перейдите в раздел Служебные → Пользовательские скрипты и в списке скриптов нажмите кнопку Создать скрипт.

ШАГ 2. На открывшейся странице выполните следующие действия:

Таблица 1. Настройки пользовательского скрипта

№	Название поля	Описание
1	Название	Укажите название скрипта.
2	Тип события	Выберите тип события, при котором будет срабатывать скрипт (JS-код, который вы далее укажете в поле JS-код). Доступные варианты: Позиция заказа клиента в статусе Весь заказ клиента в статусе Новый клиентский заказ — полезно, если требуется привлечь внимание менеджеров к определенным заказам (например, от конкретного клиента, заказ на очень большую сумму, заказ из конкретного прайс-листа и т.д.) Проверка перед сменой статуса позиции — полезно, если требуется запретить/изменить смену статуса заказа при определенных условиях (например, если заказ не оплачен)
3	Статус позиции	Выберите статус, в который должна перейти позиция заказа, чтобы сработал скрипт. Скрипт сработает только после перехода позиции заказа в выбранный статус.
4	Активен	Активируйте опцию, чтобы включить применение скрипта.
5	Не проверять синтаксис JS при сохранении	Активируйте опцию, если в JS-коде используются сложные Liquid-конструкции и вы столкнулись с ложным срабатыванием при статической проверке JS.
6	Регион	Выберите регион, в котором должен применяться скрипт. Оставьте это поле пустым, если требуется, чтобы скрипт выполнялся во всех регионах.
7	Пользователь API	Выберите пользователя, от имени которого будут выполняться автоматические действия в системе, предусмотренные скриптом (например, смена статусов).
8	Приоритет	Выберите приоритет скрипта среди остальных созданных вами скриптов.
9	JS-код	Введите скрипт в формате JS-кода. Поддерживаются шаблоны Liquid. Во избежание проблем с кодом обратитесь к нашим справочным материалам с помощью кнопки Справка. Ниже подробно рассказываем, как быстро создать скрипт с помощью нейросети.

Сохраните изменения.

Настройки скрипта

Пример настройки

Рассмотрим сценарий: как только все позиции заказа с типом доставки СДЭК доставка курьером проходят приёмку, требуется автоматически переводить их в статус Отправляем в СДЭК, а также ставить задачу менеджеру — создать отправку в СДЭК.

ШАГ 1. В панели администрирования переходим в раздел Справочники → Типы доставки.

В настройках типа доставки СДЭК доставка курьером удостоверимся, что в разделе Запрашивать данные все опции отключены.

Тип доставки заказа

ШАГ 2. В панели администрирования переходим в раздел Справочники → Статусы заказов.

Создадим новый статус Отправляем в СДЭК.

Настройки статуса 

ШАГ 3. Создадим тестовый заказ с типом доставки СДЭК доставка курьером.

Создание заказа

ШАГ 4. Нажимаем кнопку Справка и копируем документацию для нейросети с помощью кнопки Скопировать markdown (для LLM).

Копирование справки

ШАГ 5. Переходим к qwen.ai и ставим ему задачу написать для нас нужный скрипт, например:

<task>Напиши скрипт, который будет переводить заказ в статус Отправляем в СДЭК, если все позиции заказа перешли в статус Пришло. Заказ должен быть с типом доставки СДЭК доставка курьером. При создании скрипта ориентируйся на документацию</task><doc>*текст нашей справки*</doc>

Запускаем задачу.

Создание скрипта

Вставляем созданный код в поле Код скрипта и вставляем в поле JS-код в настройках скрипта.

Сохраняем изменения.

Копирование кода

Применение кода

ШАГ 6. Проверяем работу скрипта.

Переходим в раздел Заказы клиента → Все и переводим заказ в статус Пришло.

Обновляем страницу через несколько секунд.

В случае успешного применения скрипта:

1. В истории статусов мы увидим смену статуса на Отправляем в СДЭК с комментарием Авто-перевод

История статусов

2. В режиме Просмотр в строке скрипта увидим время последнего срабатывания скрипта

Переход к просмотру скрипта

Просмотр скрипта

3. В логе скрипта увидим статус success

Переход к логу скрипта

Лог скрипта

ШАГ 7. Обновим скрипт, добавив автоматическую постановку задачи клиентскому менеджеру на создание отправки в СДЭК.

В qwen.ai пишем:

В скрипт добавь автоматическую постановку задачи менеджеру клиента, создавшего заказ, с напоминанием, что он должен создать отправку заказа в СДЭК. В задаче должны быть перечислены позиции заказа и указаны контакты клиента.

Обновление задачи

ШАГ 8. Копируем обновленный код и переходим в настройки скрипта. В поле JS-код заменяем старый код на новый.

Сохраняем изменения.

Копирование обновленного кода

ШАГ 9. Проверяем работу скрипта.

Создаём новый заказ с типом доставки СДЭК и в разделе Заказы клиента → Все переводим его в статус Пришло.

В случае успешного применения скрипта:

1. В логе скрипта увидим статус success

Лог скрипта

2. В списке задач увидим созданную задачу

Созданная задача

Лог скрипта

При возникновении ошибки, например, если скрипт не сработал, вы можете обратиться к логу скрипта с помощью кнопки Логи.

Переход к логу скрипта

В логе отображаются данные о каждом запуске скрипта.

В случае ошибки запуск будет в статусе error. Нажмите кнопку Просмотр чтобы перейти к подробному логу запуска.

Лог скрипта

Чтобы ускорить исправление ошибки, скопируйте текст ошибки из лога и отправьте его в qwen.ai с запросом на исправление.
После того как нейросеть проанализирует проблему и предложит исправленный вариант, скопируйте обновлённый код и вставьте его в поле JS-код.

Перейти к редактированию можно прямо на странице лога — с помощью кнопки Редактировать.

Ошибка в логе