Ошибка «Элемент с таким символьным кодом уже существует»
Кратко об ошибке
При передаче заказа из itl.merchant в Bitrix24 мы создаём сделку и добавляем в неё товар(ы). Если товар не найден в каталоге Bitrix24 по выбранному правилу поиска, Bitrix24 сам пытается создать новый товар и автоматически формирует символьный код. Этот код проверяется на уникальность. Если такой код уже занят существующим товаром, Bitrix24 возвращает ошибку: «Элемент с таким символьным кодом уже существует».
Важно: символьный код формирует Bitrix24, а не itl.merchant. Ошибка появляется даже в том случае, когда в каталоге уже есть нужный товар, но он не найден по текущему правилу поиска (например, по названию), и Bitrix24 пытается создать дубликат.
Почему это происходит
В настройках сервиса Bitrix24 в itl.merchant выбран способ поиска товара (например, по названию).
В каталоге Bitrix24 уже есть товар с тем же названием/близким названием, но он не попадает под критерии поиска (разные регистры/варианты написания и пр.).
Bitrix24 пытается создать новый товар, вычисляет для него символьный код (обычно из названия) и проверяет уникальность.
В каталоге уже существует любой элемент (товар/раздел) с таким кодом → возникает конфликт и Bitrix24 возвращает ошибку.
Как устранить проблему
Вариант A. Найти и удалить конфликтующий элемент
Откройте каталог товаров в Bitrix24 и выполните поиск товара из заказа.
Если обнаружен «лишний» дубликат — удалите его.
Повторите синхронизацию из itl.merchant (снимите блок с заказа).
Вариант B. Изменить правило поиска товара в интеграции
Если поиск настроен по названию, рекомендуем переключить его на более точный атрибут:
- по артикулу;
- по внешнему коду.
Сделайте это в настройках сервиса Bitrix24 в itl.merchant. После смены правила поиска повторная синхронизация найдёт существующий товар и ошибка не возникнет. Учтите что значение у товара долно быть уникальным.
Профилактика
- Заполняйте и поддерживайте уникальные артикулы для всех товаров.
- В интеграции используйте поиск по артикулу или внешнему коду — это надёжнее, чем поиск по названию.
- Избегайте массового создания товаров с одинаковыми/очень похожими названиями.
Частые вопросы
Кто формирует символьный код?
Его формирует Bitrix24 автоматически при создании элемента, согласно своим правилам транслитерации/уникализации.
Почему товар не нашёлся, хотя он есть?
Потому что текущее правило поиска (например, по названию) не совпало: разные пробелы, регистр, язык, опечатки и т.д.