Перейти к содержимому
AISARAISAR
Организации

Организации

Организация изменена

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:

http
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

json
{
  "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.idintegerID организации
organization.namestringНазвание
organization.legal_namestring|nullЮридическое название
organization.tax_idstring|nullБИН/ИИН или ИНН в нормализованном виде (без пробелов и дефисов). У ИП это ИИН физического лица, то есть персональные данные: значение передаётся в теле вебхука и хранится в журнале доставок вебхуков на срок его хранения, так же как телефоны контактов
organization.country_codestring|nullКод страны ISO из двух букв
organization.relation_typeobject|nullТип отношений `{id, name, system_key}` или null; `system_key` — постоянный ключ стартового типа (`customer`, `prospect`, `partner`, `supplier`, `competitor`, `other`), у своих типов компании null
organization.legal_formstring|nullОрганизационно-правовая форма (свободная строка)
organization.registration_codestring|nullРегистрационный код (ОКПО и т. п.)
organization.extra_codesstring|nullПрочие коды одной строкой
organization.signatory_namestring|nullФИО руководителя или подписанта. Персональные данные: значение передаётся в теле вебхука и хранится в журнале доставок вебхуков на срок его хранения
organization.signatory_positionstring|nullДолжность подписанта. Вместе с ФИО относится к персональным данным
organization.signatory_basisstring|nullНа каком основании действует подписант
organization.phonestring|nullТелефон в формате E.164
organization.emailstring|nullE-mail в нижнем регистре
organization.websitestring|nullСайт
organization.addressstring|nullАдрес
organization.commentsstring|nullКомментарий (полностью, без обрезки)
organization.responsible_userobject|nullОтветственный `{id, name}` или null
organization.sourcestring|nullОткуда появилась организация: `manual`, `api`, `backfill` (`import`, `bitrix24`, `amocrm` зарезервированы)
organization.custom_fieldsobjectЗначения своих полей организации `{ключ: значение}`; всегда объект, даже пустой
organization.created_atstringВремя создания (ISO-8601)
organization.updated_atstringВремя последнего изменения (ISO-8601)
changed_fieldsarrayИмена изменённых полей (`name`, `tax_id`, `relation_type_id`, `legal_form`, `signatory_name`, `responsible_user_id` и т. д.); свои поля приходят как `custom.<key>`; изменение банковских счетов — как `bank_accounts`