Материал блога
Поиск по артикулу в Shop-Script не находит товар: как проверить SKU и витрину

Покупатель вводит точный артикул запчасти или модели, но поиск интернет-магазина показывает пустую страницу. При этом менеджер видит товар в каталоге Shop-Script и может открыть его по прямой ссылке. Причина не обязательно в «сломавшемся поиске»: запрос может обрабатываться не тем полем, товар может быть скрыт на конкретной витрине, а выпадающие подсказки — работать отдельно от основной выдачи.
Разбирать ситуацию лучше на одной подтверждённой карточке, а не начинать с переиндексации всего каталога. Ниже — последовательность проверок для магазинов на Webasyst/Shop-Script, в том числе с отдельными поисковыми плагинами и несколькими витринами.
Зафиксируйте один артикул и воспроизведите ошибку
Выберите товар, который точно должен быть доступен покупателю. Запишите ID товара, ID его варианта (SKU), фактический код артикула, адрес карточки и домен витрины. Сравните три запроса: полное название товара, точный код SKU и часть этого кода. Повторите каждый запрос в основной строке поиска и в подсказках, если они предусмотрены темой.
Обязательно проверьте выдачу в приватном окне без авторизации и на мобильной версии сайта. Если товар находится по названию, но отсутствует по коду, это более узкий случай, чем полная неработоспособность поиска. Если основной поиск работает, а подсказки пустые, начинать диагностику стоит с механизма подсказок, а не с каталога.
Не путайте товар, модификацию и код SKU
В Shop-Script у одного товара может быть несколько артикулов или модификаций с собственными кодами, ценами и наличием. ID товара, внутренний ID модификации и строка кода артикула — разные значения. Например, запрос по буквенно-цифровому коду может не совпасть с тем, что сохранено в поле названия товара.
Откройте карточку в административной панели и проверьте все модификации. Тот ли код указан в поле SKU, нет ли лишних пробелов, опечаток или старого артикула после импорта? Официальный метод shop.product.skus.getList описывает структуру модификаций, включая строковый код sku и ID. Использовать API в диагностике следует только с разрешённым доступом и без публикации ключей.
Проверьте статус товара и видимость варианта
То, что товар виден администратору, ещё не гарантирует его доступность в публичной выдаче. Сверьте статус публикации товара, настройки видимости его модификаций, правила показа отсутствующих товаров и состав каталога конкретной витрины. Не делайте вывод по одной отметке «в наличии»: наличие для заказа и публичная видимость — разные характеристики.
Если магазин обслуживает несколько доменов или языков, откройте ту витрину, на которой клиент вводил артикул. Сравните результат с соседней витриной и проверьте правила маршрутизации. Не исправляйте проблему, публикуя скрытый товар на всех доменах: сначала подтвердите, должен ли он вообще попадать в публичный поиск.
Выясните, какой механизм обрабатывает строку поиска
Не каждый поиск на витрине одинаково интерпретирует запрос. Стандартная логика Shop-Script зависит от настроек магазина; тема дизайна или установленный плагин могут использовать собственный обработчик. В официальной документации метода shop.product.search отдельно описан режим search/query, который учитывает выбранные настройки поиска. Это не доказательство, что любая сторонняя строка автоматически ищет по SKU.
Сравните URL запроса после отправки формы, параметры поиска и фактически активный модуль. Если поиск по названию проходит, но поиск по артикулу не предусмотрен используемой реализацией, изменение одного шаблона не заменит доработку серверной логики. Для таких случаев может понадобиться доработка поиска по артикулу в Shop-Script, но только после проверки существующих настроек.
Проверьте различия в написании артикула
Внутри кода часто встречаются дефисы, пробелы, слэши, ведущие нули и похожие символы латиницы и кириллицы. Артикулы AB-001 и AB001 визуально близки, но программно не обязательно эквивалентны. Аналогично латинская A и кириллическая А выглядят одинаково, хотя это разные символы.
Проверьте точное значение, скопированное из карточки администратора, затем варианты без разделителей и с другим регистром. Если результат меняется, запишите действующие правила нормализации запросов. Не заменяйте массово артикулы и не удаляйте ведущие нули: код может использоваться в складской системе, документах и интеграциях как строгий идентификатор. Безопаснее отдельно нормализовать поисковый ввод, сохраняя исходный SKU.
Отделите поиск на странице от автоподсказок
Во многих темах подсказки показываются через отдельный AJAX-запрос и имеют собственный шаблон вывода. В инструментах разработчика браузера проверьте вкладку Network: какой адрес запрашивается при вводе, какой HTTP-статус возвращается, есть ли в ответе нужный товар. Затем проверьте JavaScript Console на ошибки, особенно после обновления темы или плагина.
Если сервер вернул корректный результат, но он не показан на экране, проверьте обработку ответа, скрытие блока стилями и конкуренцию обработчиков JavaScript. Если сервер вернул пустую выборку, анализируйте параметры запроса, права видимости и логику плагина. Не отключайте защиту от автоматических запросов или кеширование сразу на всём сайте только ради теста.
Проверяйте индексы и кеш только там, где они реально используются
Отдельный поисковый плагин может хранить собственный индекс, поисковые словари или кеш результатов. Но нельзя считать, что в каждом Shop-Script есть одна обязательная кнопка «переиндексировать всё». Сначала выясните название компонента и предусмотренную его разработчиком процедуру обновления данных.
Если модуль действительно использует индекс, проверьте время последней успешной сборки, журнал ошибок, источник данных и реакцию на изменение одного тестового товара. Для больших каталогов полный пересчёт без подготовки может создать нагрузку и не исправить неправильный поисковый параметр. До массовых действий сделайте резервную копию настроек и оцените возможность отката.
Сопоставьте данные с импортом и учётной системой
Если проблема появилась после обмена с 1С, МойСклад или поставщиком, сравните значение артикула в исходном файле, настройках сопоставления полей и итоговом SKU магазина. Уточните, сохраняет ли импорт существующий ID модификации или создаёт новую запись. Особенно важно проверить, не оказались ли код поставщика и код SKU в разных полях.
Если код неожиданно меняется после каждого синхронизирования, ручное исправление в карточке будет временным. Исправлять нужно источник и правила импорта, а результат проверять после следующего штатного обмена. При регулярных сбоях полезна техническая поддержка интернет-магазина с журналом повторяемых проверок.
Проведите контрольный тест и зафиксируйте результат
Составьте небольшую проверочную выборку: один обычный товар, позиция с несколькими модификациями, SKU с дефисом, SKU с ведущими нулями и скрытый товар, который не должен находиться публично. Для каждого укажите ожидаемый результат в основной выдаче и подсказках, затем проверьте его на нужном домене с телефона и компьютера.
После исправления повторите тесты и убедитесь, что поиск по названию продолжает работать, время ответа не увеличилось заметно, а скрытые позиции не раскрылись посторонним. Зафиксируйте изменённые настройки, версии плагинов и тему оформления. Дополнительные примеры технических задач можно посмотреть в портфолио Quadro Design; само наличие похожего проекта не означает, что его исправление подходит без проверки вашей конфигурации.
Вывод: диагностировать отсутствие результата по артикулу следует по цепочке «код SKU → видимость товара → механизм поиска → обработка запроса → отображение результата». Такой порядок помогает отделить ошибку данных от ошибки темы или поискового плагина и не рисковать всем каталогом ради одной неисправной строки.