Добавление счета

Создает новый счет с указанными полями.

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

Для кого и какую проблему решает

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

Что делает и когда применять

Робот создает новый счет и, по желанию, копирует в него товарные позиции из указанной сделки, а без её ID — из текущей сделки процесса.

Что подготовить

Нужен установленный робот из приложения «CRM роботы 2.0 + AI» и право на настройку автоматизации нужной CRM-воронки или шаблона бизнес-процесса. Пользователю, от имени которого работает приложение, должны быть доступны выбранные CRM-элементы и нужное действие с ними.

Проверьте, какой счёт нужно создать, и подготовьте ID сделки для связи. Если заполнен «ID сделки (для привязки)», товары берутся из этой сделки. Если ID не передан, для копирования нужна текущая сделка процесса. Перед выставлением проверьте состав и цены источника.

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

1. Откройте автоматизацию нужной сущности и выберите стадию, на которой нужен робот «Добавление счета». В шаблоне бизнес-процесса добавьте одноимённое действие.
2. Проверьте, какой счёт нужно создать, и подготовьте ID сделки для связи. Если заполнен «ID сделки (для привязки)», товары берутся из этой сделки. Если ID не передан, для копирования нужна текущая сделка процесса. Перед выставлением проверьте состав и цены источника.
3. Заполните Название, ID сделки (для привязки), Сумма, Валюта, Копировать товары из сделки. Для рабочего сценария подставьте значения полей документа или результаты предыдущих действий вместо учебных данных ниже.
4. Проверьте обязательные поля и варианты выбора в таблице настроек. Сохраните действие и свяжите его результаты с дальнейшими условиями процесса.
5. Выполните пробный запуск на отдельном учебном элементе. Сначала проверьте статус и пояснение ошибки, затем содержательный результат и ветку, выбранную следующим действием.

Параметры робота

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

Поле в настройках	Что передать	Обязательность и исходное значение
Название (title)	Текст названия, например Учебный счёт за панели. Это новое название карточки, не её ID.	Необязательно. Значение по умолчанию в настройках не задано
ID компании (companyId)	Числовой ID компании, например 101. Возьмите ID выбранной компании из результата её поиска или из сохранённого поля связи. Нужна компания этого портала; название организации и вся ссылка карточки не подходят.	Необязательно. Значение по умолчанию в настройках не задано
ID контакта (contactId)	Числовой ID контакта, например 201. Получите его из результата поиска контакта или подготовленной связи с контактом. ID компании и ID контакта — разные значения, даже если оба относятся к одному клиенту.	Необязательно. Значение по умолчанию в настройках не задано
ID сделки (для привязки) (dealId)	Числовой ID сделки, например 501, из результата создания/поиска сделки. Задаёт связь со счётом и источник товаров при включённом копировании. Без этого входа источник товаров берётся из текущей сделки процесса.	Необязательно. Значение по умолчанию в настройках не задано
Сумма (opportunity)	Число, например 20000 или 20000.50, без пробелов-разделителей, знака рубля и текста. Валюту укажите отдельно. Передавайте сумму в выбранной валюте, а не строку 20 000 руб..	Необязательно. Значение по умолчанию в настройках не задано
Валюта (currencyId)	Код доступной валюты, например RUB. Возьмите код валюты из настроек CRM или результата предыдущего шага. Для суммы в рублях в учебном примере используется RUB; на портале эта валюта должна быть доступна.	Необязательно. Значение по умолчанию в настройках не задано
Стадия (stageId)	Точный код стадии счёта, например DT31_34:N в учебной воронке 34, где такой код существует. Это пример формата, не универсальная стадия вашего портала. Возьмите фактический код из настройки стадий/результата получения данных счёта; надпись «Новый» код не заменяет.	Необязательно. Значение по умолчанию в настройках не задано
Комментарий (comments)	Обычный текст комментария, например Доставка согласована на 20 ноября.. Для изменения используйте полное новое содержимое: робот не дописывает фразу к прежнему комментарию автоматически.	Необязательно. Значение по умолчанию в настройках не задано
Копировать товары из сделки (addProducts)	Выберите «Да» (Y), чтобы перенести товары сделки, или «Нет» (N), чтобы создать счёт без этого переноса. При указанном ID сделки копируются её товары; без него нужен процесс текущей сделки.	Необязательно. Значение по умолчанию в настройках не задано

Откуда брать значения и что оставить без изменения

Числа 101, 201, 501, 801 и ID сотрудников в примерах условные. В рабочем процессе сначала получите нужный ID поиском, созданием элемента или из подготовленного поля; в редакторе робота выберите подстановку соответствующего результата. Не копируйте номер из другого портала. Если следующий шаг возвращает несколько ID, сначала выберите нужный элемент: одиночный вход не принимает весь список.

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

Для стадии счёта сначала убедитесь, что код относится к выбранной воронке счетов. Код DT31_34:N в примерах предполагает существование учебной воронки 34 и её стадии; у вас может быть другой код. Если стадию менять не требуется, не передавайте stageId. Не подменяйте эту настройку стадией сделки.

Учебный пример

Данные вымышленные. Подготовлены компания 101, контакт 201, сделка 501 и доступная валюта RUB. Название и комментарий вводятся текстом; ID выбираются из результатов подготовки.

Поле	Значение учебного сценария
Название	Учебный счёт за панели
ID компании	101
ID контакта	201
ID сделки (для привязки)	501
Сумма	20000
Валюта	RUB
Стадия	Не передаётся; если нужна конкретная стадия, используйте фактический код своего счёта, например учебный DT31_34:N при наличии этой стадии
Комментарий	Поставка 10 панелей. Доставка согласована.
Копировать товары из сделки	«Нет» (N)

Ожидается создание счёта с переданными сведениями и связью со сделкой 501. В результатах будут ID нового счёта и его номер. Номер может отличаться от ID. Повтор этого действия может создать второй счёт: отдельный ключ защиты от дубля не задаётся.

Вариант переноса товаров: процесс запущен в сделке 600, а в «ID сделки (для привязки)» передано 501; включено «Копировать товары из сделки» = «Да». Источник товаров — сделка 501. Если убрать ID сделки, источником станет текущая сделка 600. Передача ID меняет также связь создаваемого счёта, поэтому его нельзя использовать как случайный номер источника.

Какие данные возвращает и что делать дальше

Результат	Какое значение получает следующий шаг
ID счета (invoiceId)	целое число
Номер счета (accountNumber)	строка
Статус (status)	да/нет
Ошибка (error)	строка

Сохраните «ID счета» в поле сделки и используйте его для формирования документа или следующей проверки. Перед повтором после неясного результата сначала убедитесь, не появился ли счёт в CRM.

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

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