# МойСклад

Перед добавлением действий подключите МойСклад.

# Получить категории товаров

Возвращает идентификаторы и названия категорий. Можно разрешить все категории или выбрать только определённые.

# Получить товары в категории

Возвращает товары заданной или подобранной ботом категории: идентификатор, название, цену, остаток и артикул при наличии. Включите ожидание категории от бота, если категория определяется из запроса пользователя.

Включите Получать товары только с остатками, чтобы отфильтровать каталог. Затем выберите более или менее и укажите порог остатка.

# Найти товары по названию или артикулу

Ищет товары из запроса клиента по названию, коду или артикулу. Один запрос может содержать до 200 поисковых позиций, включая заказ более чем из 60 товаров.

Для оформления заказа бот получает краткие данные: название, цену, валюту и остаток. Если клиенту нужны описание или варианты, бот может запросить подробности отдельно. Для поиска доступны фильтры по остатку и складам.

Если по одной позиции подходит несколько товаров, бот должен уточнить выбор. Не разрешайте ему выбирать первый вариант или придумывать количество.

# Фильтрация по складам

В действиях Получить категории товаров, Получить товары в категории и Найти товары по названию или артикулу можно ограничить результат выбранными складами:

1. Добавьте одно из перечисленных действий МойСклад.
2. В карточке действия включите Фильтрация по складам. По умолчанию переключатель выключен.
3. В появившемся поле выберите один или несколько складов.
4. Завершите настройку действия и сохраните изменения бота.

После включения фильтра бот получает данные только из выбранных складов. Если фильтрация не нужна, оставьте переключатель выключенным — действие будет работать без ограничения по складам.

Наведите указатель на значок подсказки рядом с настройкой, чтобы увидеть описание: «Позволяет передавать боту данные только из выбранных складов».

# Создать заказ

Создаёт заказ после проверки всей корзины и явного подтверждения клиента. Возвращает номер созданного заказа.

Рекомендуемая последовательность:

1. Узнать товары, количество и нужные варианты.
2. Найти все позиции и уточнить отсутствующие или неоднозначные товары.
3. Показать клиенту состав, количества, цены, валюту и итоговую сумму.
4. Получить необходимые контактные данные и явное подтверждение.
5. Создать заказ из согласованного черновика и сообщить его номер.

Черновик действует 30 минут. Короткое подтверждение неизменённой корзины использует уже найденные товары. Если срок истёк, состав изменился или цена стала другой, бот должен показать актуальные данные и запросить подтверждение заново.

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

# Настройка бота для заказов

Во вкладке Основное настройте Глубина размышления: начните с medium, особенно для большой корзины. Уровень low можно использовать после проверки собственного сценария. Обновление интеграции не меняет эту настройку существующего бота автоматически.

Добавьте в системный промпт правило: «Проверь всю корзину, уточни неоднозначные товары и покажи цены и количества. Итоговую сумму бери из результата действия. Создавай заказ только после явного подтверждения клиента. Если цена или состав изменились, согласуй заказ заново».

В тестовом чате проверьте всю последовательность: подбор товаров, показ корзины, короткое подтверждение и результат создания заказа. Сравните состав и сумму с заказом в МойСклад. Модель может ошибиться в формулировке ответа, поэтому проверяйте данные действия и самого заказа.

# Поиск заказа

Ищет заказ по номеру и возвращает основные данные: идентификатор, статус, дату и состав.