Умный поиск
Умный поиск товаров при выгрузке из МойСклад.
Когда каталог товаров уже есть и в МойСклад, и в Битрикс24, синхронизация может создавать "дубли": приложение не видит связь между «тем же» товаром и заводит новую карточку.
"Умный поиск" как раз пытается решить эту задачу. Перед созданием товара в Битрикс24 приложение пытается найти уже существующий и связать его с товаром из МойСклад.
Зачем это нужно?
Если одна сторона пустая - проблем почти нет: товары создаются с нуля, идентификатор МойСклад сразу записывается в Битрикс24.
Если каталоги уже заполнены с обеих сторон:
- названия могут совпадать, а «служебная» связь — нет;
- артикулы и коды есть, но приложение раньше смотрело в основном на скрытый ID;
- в итоге появляются вторые «такие же» товары.
Умный поиск уменьшает такие случаи "без остановки" обмена: если пару найти нельзя - товар создаётся как раньше. Приложение продолжает работать.
Как это работает (простыми словами)
При выгрузке товара из МойСклад в Битрикс24 приложение ищет совпадение по шагам:
1. "Уже известная связь" - в товаре Битрикс24 уже записан ID МойСклад (поле «Идентификатор МойСклад»). Нашли — обновляем, не создаём дубль.
2. "Артикул, код, внешний код" — если эти поля настроены в соответствиях свойств приложения и заполнены с обеих сторон. Совпало однозначно - связываем и записываем ID МойСклад.
3. "Название" - в самом конце, только если имя совпало "точно" и такой товар в каталоге "один". Коротких и «общих» имён это не касается.
Если нашлось несколько похожих товаров — приложение "не гадает", а создаёт новый (чтобы не склеить чужие позиции).
Что нужно настроить?
1. В настройках приложения укажите поле «Идентификатор МойСклад» для товаров (обычно это уже сделано).
2. В блоке соответствий свойств добавьте пары, например:
- артикул МойСклад ↔ дополнительное поле в Битрикс24;
- код МойСклад ↔ дополнительное поле в Битрикс24;
- внешний код МойСклад ↔ поле в Битрикс24 (часто это системное поле "Внешний код" / XML_ID).
3. Включите умный поиск для портала в настройках.
Чем лучше заполнены артикул и коды в обеих системах, тем надёжнее сшивка. Поиск по одному только названию — запасной вариант.
---
Когда срабатывает
Умный поиск товаров работает при выгрузке из МойСклад в Битрикс24:
- выгрузка каталога кнопкой;
- появление/изменение товара по событию из МойСклад;
- товар в составе документа, который уходит в Битрикс24.
Обратное направление (из Битрикс24 в МойСклад) этим механизмом пока не закрывается.
---
Группы товаров
Отдельно умный поиск помогает с **группами (разделами)** каталога.
В интерфейсе Битрикс24 нельзя вручную задать служебный ID группы. Если папка уже есть в Битрикс24, а в МойСклад - «та же» по смыслу, при полной выгрузке каталога раньше могла появиться "вторая" группа с тем же именем, а товары - переехать в неё.
Теперь приложение может найти группу по "точному имени" (с учётом родителя, если он уже связан) и записать ID МойСклад через API - без дубля папки.
---
Чего ждать на практике
---
Коротко
"Умный поиск" - это «сначала найти и связать, потом создавать». Он не отключает синхронизацию и не требует идеально чистых баз, но сильно помогает, когда каталоги уже живут в обеих системах. Лучшая страховка от дублей - заполненные артикулы и коды плюс настроенные соответствия в приложении.
Когда каталог товаров уже есть и в МойСклад, и в Битрикс24, синхронизация может создавать "дубли": приложение не видит связь между «тем же» товаром и заводит новую карточку.
"Умный поиск" как раз пытается решить эту задачу. Перед созданием товара в Битрикс24 приложение пытается найти уже существующий и связать его с товаром из МойСклад.
Зачем это нужно?
Если одна сторона пустая - проблем почти нет: товары создаются с нуля, идентификатор МойСклад сразу записывается в Битрикс24.
Если каталоги уже заполнены с обеих сторон:
- названия могут совпадать, а «служебная» связь — нет;
- артикулы и коды есть, но приложение раньше смотрело в основном на скрытый ID;
- в итоге появляются вторые «такие же» товары.
Умный поиск уменьшает такие случаи "без остановки" обмена: если пару найти нельзя - товар создаётся как раньше. Приложение продолжает работать.
Как это работает (простыми словами)
При выгрузке товара из МойСклад в Битрикс24 приложение ищет совпадение по шагам:
1. "Уже известная связь" - в товаре Битрикс24 уже записан ID МойСклад (поле «Идентификатор МойСклад»). Нашли — обновляем, не создаём дубль.
2. "Артикул, код, внешний код" — если эти поля настроены в соответствиях свойств приложения и заполнены с обеих сторон. Совпало однозначно - связываем и записываем ID МойСклад.
3. "Название" - в самом конце, только если имя совпало "точно" и такой товар в каталоге "один". Коротких и «общих» имён это не касается.
Если нашлось несколько похожих товаров — приложение "не гадает", а создаёт новый (чтобы не склеить чужие позиции).
Что нужно настроить?
1. В настройках приложения укажите поле «Идентификатор МойСклад» для товаров (обычно это уже сделано).
2. В блоке соответствий свойств добавьте пары, например:
- артикул МойСклад ↔ дополнительное поле в Битрикс24;
- код МойСклад ↔ дополнительное поле в Битрикс24;
- внешний код МойСклад ↔ поле в Битрикс24 (часто это системное поле "Внешний код" / XML_ID).
3. Включите умный поиск для портала в настройках.
Чем лучше заполнены артикул и коды в обеих системах, тем надёжнее сшивка. Поиск по одному только названию — запасной вариант.
---
Когда срабатывает
Умный поиск товаров работает при выгрузке из МойСклад в Битрикс24:
- выгрузка каталога кнопкой;
- появление/изменение товара по событию из МойСклад;
- товар в составе документа, который уходит в Битрикс24.
Обратное направление (из Битрикс24 в МойСклад) этим механизмом пока не закрывается.
---
Группы товаров
Отдельно умный поиск помогает с **группами (разделами)** каталога.
В интерфейсе Битрикс24 нельзя вручную задать служебный ID группы. Если папка уже есть в Битрикс24, а в МойСклад - «та же» по смыслу, при полной выгрузке каталога раньше могла появиться "вторая" группа с тем же именем, а товары - переехать в неё.
Теперь приложение может найти группу по "точному имени" (с учётом родителя, если он уже связан) и записать ID МойСклад через API - без дубля папки.
---
Чего ждать на практике
| Ситуация | Результат |
| Товар уже связан по ID | Обновление, без дубля |
| Совпал артикул / код / внешний код (один кандидат) | Связь + запись ID, без дубля |
| Совпало только уникальное имя | Связь по имени |
| Ничего общего или несколько похожих | Создаётся новый товар |
| Модификации (варианты) | Ищутся по своему ID; доп. поля для них пока не выгружаются |
---
Коротко
"Умный поиск" - это «сначала найти и связать, потом создавать». Он не отключает синхронизацию и не требует идеально чистых баз, но сильно помогает, когда каталоги уже живут в обеих системах. Лучшая страховка от дублей - заполненные артикулы и коды плюс настроенные соответствия в приложении.
