Найти реквизиты по номеру

POST /v1/requisites/lookup вызывает crm.requisite.entity.search. Пресет обязателен: по нему Битрикс24 выбирает страну и внешний справочник.

{"searchQuery":"7707083893","options":{"presetId":1}}

Для банковского БИК передайте typeId: "BIC"; для номера СРО страны с соответствующим справочником — typeId: "SRO". Допустимые типы зависят от страны пресета. Номер должен содержать 10–12 цифр для ИНН, 9 для БИК или 8 для СРО. Неверный тип или формат отвечает 400 до поиска; неизвестный пресет — 404. На тарифе без поиска реквизитов Битрикс24 может вернуть пустой список без ошибки. Отказ самого Битрикс24 отвечает 422.

Результат data[] содержит title, subTitle, fields с полями в формате V1 (rqInn, rqCompanyName и другие). Вложенный адрес приходит отдельно в address, поскольку POST /v1/requisites его не принимает. При создании реквизита передайте подходящие для выбранного пресета поля вместе с обязательными entityTypeId, entityId, name и тем же presetId, который использовался для поиска. Не полагайтесь на presetId из ответа справочника: Битрикс24 может вернуть другой пресет. Адрес при необходимости создайте отдельно через адресный маршрут. Для результата БИК создайте банковский реквизит через POST /v1/bank-details с полями банка и обязательными entityId реквизита-владельца и name. Доступность и набор полей определяются страной, справочником Битрикс24 и пресетом; в облаке некоторые поля могут прийти сверх полей пресета, поэтому сверьте их с GET /v1/requisites/fields.

Выбор страны

Страны шаблонов помогают выбрать countryId, затем шаблон для options.presetId.