# NetCat

Поиск товаров, карточки, наличие, ссылки, статус и создание заказов Netshop.

Сначала подключите NetCat. Затем в редакторе бота откройте Интеграции и действия, добавьте нужные операции и сохраните изменения.

Каталог доступен в режиме Netshop и для выбранных обычных компонентов. Поиск и создание заказов требуют модуля ChatRex 0.2.0 или новее, стандартного компонента заказов Netshop и отдельных разрешений.

# Найти товары NetCat

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

Поиск без названия, фильтры цены и наличия и переход к следующей части выдачи требуют модуля ChatRex 0.2.0 или новее. На более ранней версии доступен обычный поиск по названию; для новых возможностей обновите модуль.

Дополнительно можно задать минимальную и максимальную цену, оставить только товары в наличии и выбрать от 1 до 20 результатов. Поле Пропустить результатов позволяет получить следующую часть выдачи. Если действие возвращает has_more: true, используйте значение next_offset для продолжения с теми же критериями.

Характеристики зависят от сопоставления полей администратором. В предпросмотре указывайте каждую с новой строки в формате название: значение, например Цвет: чёрный.

Результат содержит найденные товары с точными идентификаторами. Выключенные товары и товары в скрытых родительских разделах не выдаются.

# Карточка, наличие и ссылка

Действие Что передать Результат
Получить товар NetCat Идентификатор из поиска Название, описание, цена, валюта, варианты и характеристики
Проверить остаток NetCat Идентификатор товара или варианта Доступность и известное количество; неизвестный остаток не заменяется нулём
Получить ссылку NetCat Идентификатор товара или варианта Публичная ссылка на витрину

Берите идентификатор из результата поиска или карточки. Не заменяйте его названием товара и не придумывайте ID. В Netshop для размера или цвета выбирайте точный идентификатор варианта и проверяйте его цену и остаток.

# Найти заказ NetCat

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

Действие возвращает состав, сумму, валюту и текущий статус заказа выбранного магазина. Оно не меняет заказ. При неверном контакте сведения о заказе не раскрываются.

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

Передайте от 1 до 20 разных товаров с точными идентификаторами и количеством. Для каждого товара допустимо количество от 0,001 до 1000 с точностью до трёх знаков после запятой. Одинаковые товары объединяйте в одну позицию.

Обязательны имя, email и город покупателя, в том числе для предварительного расчёта. Телефон, адрес, индекс и комментарий можно указать дополнительно. Выбирайте конкретный вариант товара; для оформления нужны известные цена и достаточный остаток.

Оформление проходит в два шага:

  1. Бот рассчитывает заказ и показывает покупателю товары, количество, сумму и валюту. Заказ ещё не создан. Расчёт действует 15 минут.
  2. После явного подтверждения покупателем бот создаёт заказ с теми же данными и сообщает его настоящий номер. Если состав, цена или доступность изменились либо расчёт истёк, нужен новый расчёт и новое подтверждение.

Предпросмотр действия в редакторе выполняет только первый шаг. Автоматическая оплата и оформление отправления не запускаются; дальнейшую обработку выполняет магазин. Изменение остатка определяется штатными правилами Netshop при оформлении заказа.

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

# Пример проверки

  1. Найдите реальный опубликованный товар только по категории, затем по названию или артикулу с нужными фильтрами.
  2. Получите карточку, проверьте точный вариант, наличие и ссылку на витрину.
  3. В предпросмотре Создать заказ NetCat заполните тестовые данные и проверьте расчёт: нового заказа в NetCat быть не должно.
  4. На отдельном тестовом боте попросите оформить заказ, проверьте состав и сумму, затем подтвердите. Сверьте номер и данные с заказом в NetCat.
  5. Запросите его статус с правильным контактом, затем проверьте, что другой контакт не раскрывает заказ.

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