# Реквизиты

Управление реквизитами CRM: создание, получение, обновление, удаление, фильтрация. Реквизиты всегда привязаны к контакту или компании и содержат юридическую информацию (название, ИНН/КПП/ОГРН, директор, бухгалтер и т. д.).

Битрикс24 API: `crm.requisite.*`
Скоуп: `crm`

## Операции

- [Создать реквизит](./requisites/create.md) — `POST /v1/requisites`
- [Список реквизитов](./requisites/list.md) — `GET /v1/requisites`
- [Получить реквизит](./requisites/get.md) — `GET /v1/requisites/:id`
- [Обновить реквизит](./requisites/update.md) — `PATCH /v1/requisites/:id`
- [Удалить реквизит](./requisites/delete.md) — `DELETE /v1/requisites/:id`
- [Поиск реквизитов](./requisites/search.md) — `POST /v1/requisites/search`
- [Поля реквизита](./requisites/fields.md) — `GET /v1/requisites/fields`
- [Агрегация реквизитов](./requisites/aggregate.md) — `POST /v1/requisites/aggregate`

## Ключевые поля

| Поле | Описание |
|------|---------|
| `entityTypeId` | Тип родительской сущности: `3` — контакт, `4` — компания |
| `entityId` | ID контакта или компании, которому принадлежит реквизит |
| `presetId` | ID [шаблона реквизитов](/docs/entities/requisite-presets) (задаёт набор доступных полей, неизменяем после создания) |
| `rqName` / `rqInn` / `rqKpp` / `rqOgrn` | Основные реквизиты юрлица |
| `rqCompanyName` / `rqCompanyFullName` / `rqDirector` / `rqAccountant` | Название и руководство |
| `rqOkpo` / `rqOkved` / `rqOktmo` / `rqVatPayer` | Классификаторы и НДС |

Полный список полей — [`GET /v1/requisites/fields`](./requisites/fields.md).

## Что нужно знать перед работой

1. **Шаблон определяет набор полей.** У шаблона «Организация» одни поля — ИНН, КПП, ОГРН, директор, у шаблона «Физ. лицо» другие — ФИО, паспорт, дата рождения.
2. **Для создания нужны 4 поля:** `entityTypeId`, `entityId`, `presetId`, `name`. `presetId` получается из [`GET /v1/requisite-presets`](/docs/entities/requisite-presets) — программное создание реквизита больше не требует копирования ID из UI Битрикса.
3. **Поля схемы возвращаются в camelCase.** Это касается и полей международных шаблонов — `rqEdrpou`, `rqKbe`, `rqRegon`, `rqSiret`, `rqCnpj`. Фильтр и сортировка идут по camelCase-имени. Пользовательские поля `UF_CRM_*` возвращаются в исходном регистре Битрикс24. См. [Поля реквизита](./requisites/fields.md). Чтобы получить только поля своего шаблона — добавьте `?presetId=N` к `GET /v1/requisites/fields`.

## Связанные сущности

Полноценная работа с реквизитами (счета, договоры, печатные формы) требует сопутствующих сущностей — все обёрнуты в API Вайбкод:

| Сущность | Эндпоинт | Назначение |
|----------|----------|-----------|
| [Шаблоны реквизитов](/docs/entities/requisite-presets) | `GET /v1/requisite-presets` | Шаблоны реквизитов — «Организация», «ИП», «Физ. лицо», «Иностранное юрлицо». Источник `presetId` для создания реквизита. На странице шаблона — состав его полей. |
| [Банковские реквизиты](/docs/entities/bank-details) | `GET /v1/bank-details?filter[entityId]=:requisiteId` | Р/с, БИК, к/с, SWIFT, IBAN. Без них нельзя выставить счёт на оплату. |
| [Адреса](/docs/entities/addresses) | `GET /v1/addresses?filter[entityTypeId]=8&filter[entityId]=:requisiteId` | Юридический, фактический, для корреспонденции, доставки. Композитный ключ `(typeId, entityTypeId, entityId)`. |
| [Связи реквизитов](/docs/entities/requisite-links) | `POST /v1/requisite-links` | Привязка конкретного реквизита (и опционально банка) к счёту/предложению. Нужно компаниям с несколькими реквизитами. |
| Пользовательские UF-поля | `POST /v1/userfields/requisites` | UF_CRM_* поля на реквизитах — добавить, изменить, удалить. |

## Типичный сценарий

1. Найти контакт или компанию: [`GET /v1/contacts`](/docs/entities/contacts) / [`GET /v1/companies`](/docs/entities/companies).
2. Посмотреть её реквизиты: [`GET /v1/requisites?filter[entityTypeId]=4&filter[entityId]=15`](./requisites/list.md).
3. Создать новый или обновить существующий: [`POST /v1/requisites`](./requisites/create.md) / [`PATCH /v1/requisites/:id`](./requisites/update.md).

## Лимиты

| Лимит | Значение |
|-------|----------|
| Максимум записей на запрос | 5000 (`limit ≤ 5000`) |
| Авто-пагинация | включается при `limit > 50` |
| `offset` на больших выборках | рекомендуется `limit ≤ 500` при `offset ≥ 2500` |
| Batch-запросы | до 50 операций в [`POST /v1/batch`](/docs/batch) |
| Rate limit | общий для API Вайбкод — см. [Лимиты и оптимизация](/docs/optimization) |

## Смотрите также

- [Реквизиты компании для генерации документа](/docs/recipes/document-requisites)
- [Entity API](/docs/entity-api)
- [Синтаксис фильтрации](/docs/filtering)
- [Batch](/docs/batch)
- [Справочник API](/docs/api-reference)