Получить выбранные реквизиты сторон карточки

Робот «Получить выбранные реквизиты сторон карточки» возвращает реквизиты клиента и продавца, явно выбранные в карточке.

Видимая часть формы настройки в Битрикс24. Скриншот показывает поля действия; он не подтверждает выполнение учебного примера.

Для кого и какую задачу решает

Менеджеру документов и администратору, которому важно использовать именно реквизиты сторон, уже выбранные в конкретной карточке.

У клиента и продавца бывает несколько наборов реквизитов. Поиск первого доступного набора может дать другую организацию или банковский счёт. Робот читает сохранённый выбор сторон и проверяет принадлежность реквизитов.

Параметры и подготовка

Поле	Как заполнить
Тип карточки: сделка 2, новый счёт 31 или смарт-процесс (ENTITY_TYPE_ID)	Обязательное поле
ID карточки (ENTITY_ID)	Обязательное поле

Перед настройкой выберите, откуда процесс получит каждое значение: постоянная настройка, поле карточки или результат предыдущего шага. Подписи в таблице соответствуют полям робота. Коды в скобках помогают различать похожие параметры при передаче данных между шагами.

Как использовать

1. Укажите тип карточки: сделка 2, новый счёт 31 либо поддерживаемый смарт-процесс. Затем передайте ID именно этой карточки.
2. Проверьте, что стороны и реквизиты уже выбраны в CRM. Робот читает выбор и не устанавливает его за пользователя.
3. После статуса изучите hasLink и found. Отсутствие связи или нулевые выбранные ID может дать успешный пустой результат.
4. Передайте ID клиента и продавца вместе с данными parties в следующий шаг. Не подменяйте отсутствующий выбор автоматически первым реквизитом клиента.

Учебный пример и ожидаемый результат

В учебной сделке 101 выбраны реквизит клиента 81 и продавца 82, без банковского выбора. При ENTITY_TYPE_ID=2, ENTITY_ID=101 ожидаются эти два ID и банковские ID 0. Если выбор не сохранён, вернётся пустой успешный результат с отрицательными признаками наличия, а не случайно подобранные реквизиты.

Пример показывает подготовленные учебные данные. Фактический результат зависит от переданных значений и доступных данных вашего процесса.

Что возвращает и как продолжить процесс

• «Связь с реквизитами найдена» (hasLink).
• «Есть выбранные реквизиты сторон» (found).
• «ID реквизита клиента» (clientRequisiteId).
• «ID банковского реквизита клиента» (clientBankDetailId).
• «ID реквизита продавца» (sellerRequisiteId).
• «ID банковского реквизита продавца» (sellerBankDetailId).
• «Данные выбранных сторон в JSON» (parties).

parties содержит доступные данные выбранных сторон; четыре отдельных ID удобно передавать в другие действия. hasLink описывает наличие записи выбора, found наличие выбранных реквизитов. Проверяйте оба признака, если ветка зависит от конкретного сохранённого выбора.

Выход «Статус выполнения» проверяйте перед передачей результата дальше. При отрицательном статусе прочитайте «Пояснение ошибки» и направьте процесс на исправление исходных данных. Успешный статус подтверждает выполнение действия; содержательные признаки результата проверяйте отдельно.

Ограничения и разбор ошибок

Принимает тип и ID сделки, нового счёта или смарт-процесса. Возвращает выбранные ID реквизитов и банковских реквизитов сторон, JSON доступных данных, признаки наличия связи и выбора. Если связь отсутствует или её ID равны нулю, возвращает успешный пустой результат. Проверяет принадлежность реквизитов сторонам карточки, банковских данных: выбранным реквизитам, и доступ к владельцам. Неполный ответ и отказ в доступе являются ошибками. Не выбирает реквизит автоматически и ничего не меняет.

Неполный ответ, отказ в доступе и несоответствие владельцев являются ошибками. Робот не переключает компанию, свою компанию или банковский счёт. Данные отражают прочитанное состояние карточки; параллельное изменение следует учитывать перед отдельным действием записи.