Найти товар или вариацию по точному артикулу
Робот «Найти товар или вариацию по точному артикулу» получает ID записи из выбранного каталога Битрикс24. Поиск выполняется в конкретном поле артикула с точным совпадением значения. Результат помогает связать заявку, строку импорта или данные поставщика с существующим товаром.
Видимая часть формы настройки в Битрикс24. Скриншот показывает поля действия; он не подтверждает выполнение учебного примера.
Для кого и какую боль снимает
Робот нужен менеджеру каталога, администратору CRM и сотруднику, который настраивает загрузку товарных данных. Одинаковое название бывает у разных товаров, а артикул может храниться в пользовательском свойстве. Поиск в заранее выбранном поле уменьшает риск привязать заявку к похожей позиции.
При нескольких одинаковых артикулах робот может сообщить о дублях, чтобы ответственный разобрал их до дальнейших действий. Новая карточка товара при отсутствии совпадений не создаётся.
Что выяснить перед настройкой
Уточните ID каталога, вид записи и точное поле, где хранится артикул. Товар и вариация выбираются отдельно. Для свойства вида propertyN вместо N нужен реальный положительный номер свойства, например property145. Поле должно быть одиночной строкой; множественное или специальное свойство для этого поиска не подходит.
| Параметр | Значение |
|---|---|
Вид записи (KIND) |
«Товар» (product) либо «Вариация» (offer) |
ID каталога (CATALOG_ID) |
Положительный ID нужного каталога |
Поле артикула (ARTICLE_FIELD) |
code, xmlId либо подтверждённое строковое propertyN |
Точный артикул (ARTICLE) |
Непустая строка до 200 символов |
Несколько совпадений (AMBIGUITY) |
«Сообщить неоднозначность» (unique) либо «Выбрать наименьший ID» (lowest_id) |
Все параметры обязательны. Регистр, ведущие нули и пробелы внутри артикула значимы. Пробелы по краям значения не допускаются. Если источник присылает лишние пробелы, очистите их отдельным шагом до поиска.
Как использовать подробно
- Установите робота из каталога приложения и поместите перед шагом, которому требуется ID товара.
- Выберите «Товар» для обычной карточки или «Вариация» для конкретного варианта. Укажите соответствующий каталог.
- Введите код поля артикула. Не подменяйте код поля его пользовательским названием «Артикул».
- Подставьте точное значение артикула из заявки или подготовленного поля процесса. Сохраните ведущие нули, если они есть в каталоге.
- Для первого варианта настройки выберите
unique. Это позволяет отдельно обработать дубли и не продолжать процесс с произвольной позицией. - В следующем условии проверьте статус, наличие совпадений и признак неоднозначности. Передавайте «ID товара или вариации» только когда выбран ненулевой ID.
- При отсутствии совпадений направьте заявку ответственному за каталог. При дублях передайте число совпадений для проверки качества справочника.
Учебный пример
Предположим, в учебном каталоге 15 у товара 501 поле xmlId содержит AB-001. Укажите вид «Товар», ID каталога 15, поле xmlId, артикул AB-001 и правило unique. Если доступна только эта запись, результатом будет ID 501, одно совпадение, включённый признак найденных данных и выключенный признак неоднозначности.
Значения ab-001 и AB-1 не считаются этим же артикулом. При двух доступных товарах с AB-001 в режиме unique ID будет 0, найденные совпадения останутся отмечены, неоднозначность включится. Чтобы осознанно выбирать меньший ID, нужно изменить правило на lowest_id.
Что возвращает и где ошибаются
Результат содержит «ID товара или вариации», «Есть совпадения», «Несколько совпадений», «Число доступных совпадений», а также статус и пояснение ошибки. «Есть совпадения» не гарантирует ненулевой ID при дублях. Ошибка означает, что данные нельзя подтвердить; она отличается от успешного поиска с нулём совпадений.
Проверьте ID каталога, доступ к нему, тип поля и точное написание значения, если поиск не сработал. Поддерживается до 1000 доступных записей и 100 страниц. Неполные данные или ответ с другим артикулом вызывают ошибку. Робот не ищет по части строки, не исправляет опечатки, не меняет остатки и не создаёт товар автоматически.