Поля из внешнего справочника (REST API, JSON, XML, HTML, Excel, Spreadsheets)

Приложение «Поля из внешнего справочника» для компаний, у которых актуальный список контрагентов, номенклатуры, договоров или других записей находится не в Битрикс24, а в ERP, учётной системе, API или таблице.
 Оно нужно администратору портала, который один раз подключает источник, и менеджерам, которые потом работают с этими данными в карточках сделок, компаний, контактов и лидов.

Какую задачу решает
 Обычное текстовое поле заставляет переписывать название вручную. Отсюда опечатки, разные написания одной и той же записи и потеря идентификатора, по которому система узнаёт контрагента.
 Приложение переносит выбор в карточку CRM: сотрудник находит нужную строку справочника и сохраняет её как официальное название вместе с ID, например ООО «Ромашка». Набранный текст без выбора из списка в поле не остаётся.

Как пользоваться
 Администратор открывает приложение из меню Битрикс24 и создаёт поле. Указывает название, объект CRM и режим. Источником может быть внешний API, файл Excel или CSV, ссылка на такой файл либо публичная Google Таблица.
 Для API в адресе или теле запроса отмечают, куда подставить текст поиска и данные карточки. На живом ответе выбирают, что считать названием, идентификатором и дополнительной информацией — ИНН, город, артикул. Затем поле включают в форме карточки: «Настроить» и галочка у нового поля.
 В режиме «Поиск сотрудником» менеджер открывает карточку, нажимает «выбрать» и начинает вводить текст. В списке видны название, ID и короткая подсказка, чтобы не перепутать похожие записи. Клик по строке записывает значение. Очистить его можно крестиком. Если поле множественное, в карточке собирают несколько записей и добавляют следующую. Свободный ввод без выбора не сохраняется, поэтому в CRM попадает запись из справочника, а не произвольная строка.
 В режиме «Автоподстановка» сотрудник ничего не ищет. Приложение само отправляет запрос с данными карточки, например с ИНН компании, и подставляет первую найденную запись. Так удобно связывать сделку с контрагентом из ERP, если опознавательный признак уже есть в карточке.

Польза
 CRM и внешний справочник перестают расходиться. Менеджер не держит второе окно и не копирует названия. В отчётах и карточках одна и та же запись называется одинаково и хранит тот же ID.
 Дополнительные поля вроде города или ИНН помогают узнать строку при выборе и остаются рядом с названием. Доступ к API настраивает администратор: токены и пароли хранятся на сервере приложения и не попадают
 в браузер сотрудников.

Сценарии

• Контрагент, договор или номенклатура из ERP выбираются в сделке, компании, контакте или лиде.
  
• Прайс или реестр из Excel, CSV или Google Таблицы становится полем карточки без ручного копирования.
  
• По уже заполненному признаку, например ИНН, запись подставляется сама.
  

Особенности работы
 Поле можно отключить, не удаляя его, продублировать настройку для другого объекта или проверить источник до публикации.
 После создания в Битрикс24 нельзя сменить объект CRM и признак множественности: для другого сочетания создают новое поле. Автоподстановка всегда сохраняет одну запись — первую подходящую.
 Таблица читается с первого листа, первая строка считается заголовками. Google Таблица должна открываться по ссылке без входа в аккаунт.