Как заполняются реквизиты
В текущей инструкции описаны три независимых механизма. Их общее правило — не затирать значения, уже заполненные вручную.
Из реквизитов Битрикс24
Технический запуск получает реквизиты и адрес компании через REST Битрикс24 и заполняет только пустые поля. Если полученный ИНН отличается от уже сохранённого, обновление должно отменяться.
Массовую обработку запускает администратор или разработчик. Она идёт порциями с паузами, чтобы учитывать лимиты REST API.
Виджет «Основной реквизит»
Если к компании привязано несколько комплектов, в карточке можно выбрать основной ИНН. Приложение находит соответствующий комплект и дополняет КПП и ОГРН.
Дополнение через DaData
При обработке входящего документа приложение может найти или дополнить контрагента по ИНН и КПП. Из DaData используются название, регистрационные данные и структурированный адрес. Заполненные вручную значения не должны заменяться.
Откуда документы берут данные
Все три механизма выше только заполняют поля карточки компании. Сами документы формируются уже из этих полей:
- счёт берёт банковские данные из полей компании, а не из комплекта реквизитов Битрикс24;
- УПД собирается из товарных позиций и полей компаний-участников.
Поэтому заполненный комплект реквизитов Битрикс24 сам по себе не гарантирует корректный документ — значения должны попасть в поля карточки компании.
Массовое заполнение — административная операция. Перед запуском на рабочем портале требуется backup или экспорт затрагиваемых данных и проверка на тестовой компании.