Найти активную ставку НДС каталога по проценту
Робот «Найти активную ставку НДС каталога по проценту» находит настроенную запись справочника Битрикс24 с точным процентом. Он возвращает её ID, название и процент, а при дублях сообщает о неоднозначности. Выбор применимого налога остаётся отдельным решением вашей организации.
Видимая часть формы настройки в Битрикс24. Скриншот показывает поля действия; он не подтверждает выполнение учебного примера.
Кому полезен
Администратору каталога и специалисту, который связывает товарные данные с учётной системой. Например, источник передаёт процент, а следующий шаг процесса ожидает ID ставки из справочника портала. Если записать ID вручную, после переноса каталога ссылка может вести на другую запись. Поиск по проценту снимает необходимость поддерживать такую таблицу вручную.
Другой сценарий: перед подготовкой товарных строк убедиться, что нужный процент существует среди активных записей. Неоднозначный результат позволяет остановить дальнейшее заполнение и попросить специалиста убрать дубли.
Параметры
Оба поля обязательны. Ставка по умолчанию и правило разрешения дублей автоматически не подставляются.
| Поле | Что указать |
|---|---|
Точный процент НДС от 0 до 100 (RATE) |
Неотрицательное число в пределах 100; для дробной части используйте точную десятичную запись |
Несколько совпадений (AMBIGUITY) |
«Только единственное» (unique) или «Наименьший ID» (lowest_id) |
Указывайте процент без знака %. Значение 0 означает поиск явно настроенной нулевой ставки. Отсутствующая запись по другому проценту не превращается автоматически в нулевую ставку.
Как настроить процесс
- Сверьте требуемый процент с ответственным за учёт и проверьте справочник каталога. Робот ищет запись, но не определяет налоговый режим.
- Установите робота в приложении и добавьте перед тем действием, которому нужен ID ставки.
- Заполните процент вручную либо подставьте подготовленное числовое значение из процесса. Убедитесь, что там нет текста «НДС», пробелов и символа процента.
- Выберите «Только единственное», если любое дублирование должно требовать проверки. «Наименьший ID» используйте только при заранее принятом правиле выбора.
- После выполнения сначала проверьте статус, затем число совпадений. Для записи ID в следующий шаг нужна выбранная запись с ненулевым ID.
- Для нуля совпадений предусмотрите уведомление ответственному. Для нескольких совпадений сохраните список найденных записей и направьте задачу администратору справочника.
Пример на учебных данных
Допустим, специалист заранее выбрал для учебного процесса процент 10, а в каталоге есть одна активная запись с этим процентом, ID 24 и названием «Учебная ставка 10%». Укажите RATE=10 и AMBIGUITY=unique. Ожидается ID 24, название из справочника, точный процент 10, одно совпадение и выключенная неоднозначность.
Если активных записей с процентом 10 две, робот вернёт обе в списке совпадений. При unique ID будет 0, хотя признак найденных совпадений включён. При lowest_id будет выбрана запись с меньшим ID, а признак нескольких совпадений останется включённым. Пример объясняет поиск справочника и не рекомендует применять конкретную ставку в реальной операции.
Результаты и дальнейшие действия
«ID ставки каталога», «Название ставки» и «Точный процент» описывают выбранную запись. «Все совпадения JSON» содержит найденные варианты. «Совпадения найдены», «Несколько совпадений» и «Число совпадений» нужны для развилок процесса. Общие «Статус выполнения» и «Пояснение ошибки» помогают отделить нормальное отсутствие ставки от ошибки чтения.
Не используйте только признак «Совпадения найдены» для автоматического заполнения: при дублях в строгом режиме ID остаётся нулевым. Отдельно проверяйте выбранный ID и правило обработки неоднозначности.
Ограничения и ошибки
Робот учитывает активные записи доступного справочника, читая до 1000 записей и 100 страниц. Неподтверждённая активность, отсутствующее название, неверный процент или неполный ответ приводят к ошибке. Если ставка не найдена, проверьте, активна ли запись и доступна ли она пользователю интеграции.
Робот не меняет товары и ставки, не рассчитывает налог и не проверяет законность применения процента, даты действия по законодательству или налоговый режим компании. Передача найденного ID дальше должна соответствовать правилам вашего учёта.