Организации
Организация изменена
organization.updatedОтправляется, когда меняются поля организации (`PATCH /v1/organizations/{organization}`) или её свои поля (`PUT /v1/organizations/{organization}/custom-fields`). Добавление, правка и удаление банковского счёта организации тоже приходят этим событием, с `changed_fields: ["bank_accounts"]`; сами счета (номера) в тело не входят никогда, их читают в карточке `GET /v1/organizations/{organization}` с правом `organization_bank_account.view`. Правка справочника типов отношений событий не порождает. Запрос без фактических изменений события не порождает. Привязка и отвязка контакта или сделки приходят не этим событием, а `contact.updated` и `deal.updated`. Realtime-копия несёт только `{"organization_id": 12}`.
HTTP-запрос
AISAR отправляет подписанный POST-запрос на ваш webhook_url:
POST {webhook_url}
Content-Type: application/json
X-AISAR-Signature: sha256=...
{
"event": "organization.updated",
"event_id": "evt_01JXXXXXXXXXXXXXXXXXXXXX",
"timestamp": "2026-11-17T10:05:00.000000Z",
"company_id": 1,
"data": {
"organization": {
"id": 12,
"name": "Альфа Трейд",
"legal_name": "ТОО «Альфа Трейд»",
"tax_id": "120340567891",
"country_code": "KZ",
"relation_type": { "id": 31, "name": "Клиент", "system_key": "customer" },
"legal_form": "ТОО",
"registration_code": null,
"extra_codes": null,
"signatory_name": "Иван Петров",
"signatory_position": "Директор",
"signatory_basis": "Устава",
"phone": "+12025550142",
"email": "office@example.com",
"website": "https://example.com",
"address": null,
"comments": null,
"responsible_user": { "id": 7, "name": "Anna Smith" },
"source": "api",
"custom_fields": { "segment": "wholesale" },
"created_at": "2026-11-17T09:30:00.000000Z",
"updated_at": "2026-11-17T10:05:00.000000Z"
},
"changed_fields": ["phone", "responsible_user_id"]
}
}Заголовок X-AISAR-Signature содержит HMAC-SHA256 подпись тела запроса — используйте её, чтобы убедиться, что запрос пришёл от AISAR.
Пример payload
{
"event": "organization.updated",
"event_id": "evt_01JXXXXXXXXXXXXXXXXXXXXX",
"timestamp": "2026-11-17T10:05:00.000000Z",
"company_id": 1,
"data": {
"organization": {
"id": 12,
"name": "Альфа Трейд",
"legal_name": "ТОО «Альфа Трейд»",
"tax_id": "120340567891",
"country_code": "KZ",
"relation_type": { "id": 31, "name": "Клиент", "system_key": "customer" },
"legal_form": "ТОО",
"registration_code": null,
"extra_codes": null,
"signatory_name": "Иван Петров",
"signatory_position": "Директор",
"signatory_basis": "Устава",
"phone": "+12025550142",
"email": "office@example.com",
"website": "https://example.com",
"address": null,
"comments": null,
"responsible_user": { "id": 7, "name": "Anna Smith" },
"source": "api",
"custom_fields": { "segment": "wholesale" },
"created_at": "2026-11-17T09:30:00.000000Z",
"updated_at": "2026-11-17T10:05:00.000000Z"
},
"changed_fields": ["phone", "responsible_user_id"]
}
}Поля payload
| Поле | Тип | Описание |
|---|---|---|
organization.id | integer | ID организации |
organization.name | string | Название |
organization.legal_name | string|null | Юридическое название |
organization.tax_id | string|null | БИН/ИИН или ИНН в нормализованном виде (без пробелов и дефисов). У ИП это ИИН физического лица, то есть персональные данные: значение передаётся в теле вебхука и хранится в журнале доставок вебхуков на срок его хранения, так же как телефоны контактов |
organization.country_code | string|null | Код страны ISO из двух букв |
organization.relation_type | object|null | Тип отношений `{id, name, system_key}` или null; `system_key` — постоянный ключ стартового типа (`customer`, `prospect`, `partner`, `supplier`, `competitor`, `other`), у своих типов компании null |
organization.legal_form | string|null | Организационно-правовая форма (свободная строка) |
organization.registration_code | string|null | Регистрационный код (ОКПО и т. п.) |
organization.extra_codes | string|null | Прочие коды одной строкой |
organization.signatory_name | string|null | ФИО руководителя или подписанта. Персональные данные: значение передаётся в теле вебхука и хранится в журнале доставок вебхуков на срок его хранения |
organization.signatory_position | string|null | Должность подписанта. Вместе с ФИО относится к персональным данным |
organization.signatory_basis | string|null | На каком основании действует подписант |
organization.phone | string|null | Телефон в формате E.164 |
organization.email | string|null | E-mail в нижнем регистре |
organization.website | string|null | Сайт |
organization.address | string|null | Адрес |
organization.comments | string|null | Комментарий (полностью, без обрезки) |
organization.responsible_user | object|null | Ответственный `{id, name}` или null |
organization.source | string|null | Откуда появилась организация: `manual`, `api`, `backfill` (`import`, `bitrix24`, `amocrm` зарезервированы) |
organization.custom_fields | object | Значения своих полей организации `{ключ: значение}`; всегда объект, даже пустой |
organization.created_at | string | Время создания (ISO-8601) |
organization.updated_at | string | Время последнего изменения (ISO-8601) |
changed_fields | array | Имена изменённых полей (`name`, `tax_id`, `relation_type_id`, `legal_form`, `signatory_name`, `responsible_user_id` и т. д.); свои поля приходят как `custom.<key>`; изменение банковских счетов — как `bank_accounts` |