Выбрать реквизиты клиента по точным условиям
Робот «Выбрать реквизиты клиента по точным условиям» находит реквизит указанной компании или контакта по шаблону, ИНН и КПП.
Видимая часть формы настройки в Битрикс24. Скриншот показывает поля действия; он не подтверждает выполнение учебного примера.
Для кого и какую задачу решает
Менеджеру документов и администратору, который выбирает реквизит конкретного клиента перед счётом или договором.
У одной компании может быть несколько шаблонов и подразделений с разными КПП. Робот применяет все заданные точные условия и явно показывает неоднозначность. Отсутствие совпадений не подменяется выбором первого реквизита.
Параметры и подготовка
| Поле | Как заполнить |
|---|---|
Тип клиента (ENTITY_TYPE_ID) |
Обязательное поле. Компания (4); Контакт (3) |
ID клиента (ENTITY_ID) |
Обязательное поле |
ID шаблона реквизитов (PRESET_ID) |
Необязательное поле |
Точный ИНН (INN) |
Необязательное поле |
Точный КПП (KPP) |
Необязательное поле |
При нескольких совпадениях (AMBIGUITY) |
Обязательное поле. по умолчанию unique. Сообщить неоднозначность (unique); Выбрать наименьший ID (lowest_id) |
Перед настройкой выберите, откуда процесс получит каждое значение: постоянная настройка, поле карточки или результат предыдущего шага. Подписи в таблице соответствуют полям робота. Коды в скобках помогают различать похожие параметры при передаче данных между шагами.
Как использовать
- Выберите тип клиента: компания 4 или контакт 3. Передайте ID клиента из карточки или предыдущего поиска.
- При необходимости заполните ID шаблона, точные ИНН и КПП. Пустые необязательные условия не ограничивают выборку; все заполненные условия должны совпасть одновременно.
- Оставьте unique для контроля дублей либо явно выберите lowest_id для согласованного выбора меньшего ID.
- После статуса проверьте found, ambiguous и requisiteId. Для зависимого действия нужен ненулевой выбранный ID, а не только наличие совпадений.
Учебный пример и ожидаемый результат
Для учебной компании 51 укажите тип 4 и ID 51. Если у неё один доступный реквизит, при unique будет выбран его ID. Если их два и условия пустые, found включится, ambiguous включится, count=2, а requisiteId=0. Добавление точного КПП или шаблона может сузить выбор до одного.
Пример показывает подготовленные учебные данные. Фактический результат зависит от переданных значений и доступных данных вашего процесса.
Что возвращает и как продолжить процесс
- «ID выбранного реквизита» (
requisiteId). - «Есть совпадения» (
found). - «Более одного совпадения» (
ambiguous). - «Число доступных совпадений» (
count).
count отражает доступные совпадения. При unique несколько записей дают нулевой ID без произвольного выбора; lowest_id разрешает выбрать минимальный. Это решение не делает выбранный набор реквизитов сохранённым выбором в самой сделке.
Выход «Статус выполнения» проверяйте перед передачей результата дальше. При отрицательном статусе прочитайте «Пояснение ошибки» и направьте процесс на исправление исходных данных. Успешный статус подтверждает выполнение действия; содержательные признаки результата проверяйте отдельно.
Ограничения и разбор ошибок
Принимает тип и ID клиента, необязательные ID шаблона, ИНН и КПП строками. Все заданные условия должны совпадать точно. При нескольких совпадениях можно вернуть неоднозначность без выбора либо явно выбрать наименьший ID. Возвращает ID, число доступных совпадений и признаки найденного результата и неоднозначности. Проверяет не более 1000 записей за 100 запросов; превышение является ошибкой. Отсутствие доступных совпадений успешно, отказ в доступе: ошибка. Ничего не меняет в карточке.
ИНН и КПП передаются строками с сохранением ведущих нулей, без крайних пробелов. Робот не проверяет контрольные разряды этих условий и не заполняет карточку. Для подтверждения комплектности и сохранения выбора предусмотрите отдельные действия.