Найти единицу каталога по коду ОКЕИ
Робот «Найти единицу каталога по коду ОКЕИ» сопоставляет числовой код единицы измерения с записью справочника Битрикс24. Он возвращает ID, название и условные обозначения найденной единицы. Это помогает передать правильную ссылку на единицу в следующий шаг процесса.
Видимая часть формы настройки в Битрикс24. Скриншот показывает поля действия; он не подтверждает выполнение учебного примера.
Для кого и какую задачу решает
Инструкция пригодится администратору CRM, специалисту по товарному каталогу и сотруднику, который настраивает обмен с учётной системой. Во внешних данных часто передают код ОКЕИ, а внутри каталога нужна конкретная запись с собственным ID. Ручная таблица соответствий устаревает, если справочник изменился или данные перенесли на другой портал.
Робот проверяет доступные записи по точному числовому коду и отдельно сообщает о дублях. Он полезен перед подготовкой товарных данных, проверкой импортируемой номенклатуры или заполнением документа. Пересчёт количества между упаковками и штуками нужно выполнять отдельным шагом.
Что подготовить
Уточните код, который приходит из источника, и проверьте наличие единицы в каталоге. У пользователя интеграции должен быть доступ к справочнику. ID записи каталога и код ОКЕИ различаются: в первое поле робота вводят именно код классификатора. Все поля настроек обязательны; автоматический выбор правила для дублей не предусмотрен.
| Поле | Как заполнить |
|---|---|
Точный числовой код ОКЕИ (CODE) |
Положительное целое число. Ведущие нули нормализуются: 006 и 6 обозначают один код |
Несколько совпадений (AMBIGUITY) |
«Только единственное» (unique) либо «Наименьший ID» (lowest_id) |
Как использовать
- Установите робота из каталога приложения и добавьте его на нужный этап автоматизации.
- В поле кода укажите постоянное значение либо подставьте значение из подготовленного поля процесса. Не передавайте название «штука» вместо числового кода.
- Начните с варианта «Только единственное». При нескольких записях он позволит направить карточку на ручную проверку, не выбирая одну случайно.
- После робота добавьте условие на «Статус выполнения». Если он отрицательный, используйте «Пояснение ошибки» для уведомления ответственного.
- При успешной проверке сначала посмотрите «Число совпадений» и «Несколько совпадений», затем используйте «ID единицы каталога». Наличие совпадений само по себе ещё не означает, что выбран ID.
- Передайте выбранный ID, название или символы в следующий шаг. Робот сам не записывает их в товар и не создаёт отсутствующую единицу.
Учебный пример
Предположим, в учебном каталоге есть одна доступная запись с кодом 796, ID 81, названием «Штука» и заполненными символами. Укажите CODE=796, AMBIGUITY=unique. Ожидаемый результат: найдено одно совпадение, признак неоднозначности выключен, ID единицы равен 81, название равно «Штука». Это пример подготовленных данных, а не сообщение о вашем справочнике.
Если с тем же кодом существуют записи 81 и 92, режим unique вернёт признак наличия совпадений и неоднозначности, число 2, но ID будет 0. Для автоматического выбора меньшего ID нужно сознательно переключить правило на lowest_id. Проверьте, что такой выбор соответствует правилам вашего каталога.
Какие данные возвращает
Кроме ID и названия робот отдаёт «Символы единицы JSON» с русским, международным и буквенным международным обозначением, а также «Все совпадения JSON». Пустое название остаётся пустой строкой; название из другого источника не подставляется. Явно отсутствующий символ сохраняется в JSON как null.
«Совпадения найдены», «Несколько совпадений» и «Число совпадений» позволяют построить отдельные ветки для нуля, одной записи и дублей. Общие «Статус выполнения» и «Пояснение ошибки» отражают успешность чтения и проверки данных.
Если результат пустой или появилась ошибка
Ноль совпадений при успешном статусе означает, что доступная запись по этому коду не найдена. Уточните код и права доступа. Если получены неполные данные названия или символов, робот завершится с ошибкой. Он не заменяет такой ответ пустым справочником. Поддерживается чтение до 1000 записей и 100 страниц; робот не создаёт единицы, не меняет каталог и не проверяет актуальность внешнего классификатора.