# Организации

### Методы для работы с организациями

<a id="get-v1.2-catalogs-organizations"></a>

**Версия: OAuth2.0 v1**

Получение всех доступных организаций пользователя

**Пример запроса (curl):**

```bash
curl 'https://api.ati.su/v1.2/catalogs/organizations' \
  -X 'GET' \
  -H 'Authorization: Bearer {authorizationToken}' \
  -H 'Content-Type: application/json'
```

**OpenAPI схема:** [JSON](https://ati.su/developers/raw/api/catalogs/organizations.openapi.json)

**Пример ответа (200)**

```json
[
  {
    "id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
    "name": "string",
    "ownership": 0,
    "residency": {},
    "inn": "string",
    "phone": "string",
    "extra_phone": 0,
    "docs_address": {
      "postcode": "string",
      "city_id": 0,
      "street_name": "string",
      "house_no": "string",
      "office_no": "string"
    },
    "addresses": [
      {
        "id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
        "address": "string",
        "address_city_id": 0,
        "address_latitude": 0.5,
        "address_longitude": 0.5,
        "note": "string",
        "contact_persons": [
          {
            "id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
            "name": "string",
            "phone": "string",
            "extra_phone": 0,
            "email": "string"
          }
        ],
        "schedule_summary": "string",
        "address_type": 0
      }
    ],
    "contact_persons": [
      {
        "id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
        "name": "string",
        "phone": "string",
        "extra_phone": 0,
        "email": "string"
      }
    ],
    "all_departments_allowed": false,
    "department_ids": [
      0
    ]
  }
]
```

**Описание полей ответа**
- `[].id` — ID организации
- `[].name` — Название
- `[].ownership` — Организационно-правовая форма собственности. Значение из [словаря](https://ati.su/developers/api/dictionaries/firms/#get-v1.0-dictionaries-ownerships)
- `[].inn` — Регистрационный номер (ИНН, ЕДРПОУ, УНП, БИН или их аналоги)
- `[].phone` — Номер телефона организации
- `[].extra_phone` — Добавочный номер
- `[].docs_address` — Адрес местонахождения для документов
- `[].docs_address.postcode` — Почтовый индекс
- `[].docs_address.city_id` — Id населенного пункта\ Значение из [словаря](https://ati.su/developers/api/dictionaries/geo/)
- `[].docs_address.street_name` — Улица, проспект, переулок, бульвар и пр.
- `[].docs_address.house_no` — Дом, строение, корпус, литера
- `[].docs_address.office_no` — Офис, помещение и пр.
- `[].addresses` — Адреса
- `[].addresses[].id` — ID адреса
- `[].addresses[].address` — Адрес
- `[].addresses[].address_city_id` — ID города. Значение из [словаря](https://ati.su/developers/api/dictionaries/geo/)
- `[].addresses[].address_latitude` — Координаты адреса: широта
- `[].addresses[].address_longitude` — Координаты адреса: долгота
- `[].addresses[].note` — Примечание
- `[].addresses[].contact_persons` — Контакты адреса
- `[].addresses[].contact_persons[].id` — ID контакного лица
- `[].addresses[].contact_persons[].name` — ФИО
- `[].addresses[].contact_persons[].phone` — Телефон
- `[].addresses[].contact_persons[].extra_phone` — Добавочный номер
- `[].addresses[].contact_persons[].email` — Электронная почта
- `[].addresses[].schedule_summary` — Текстовое описание времени работы
- `[].addresses[].address_type` — Тип адреса * `1` — Склад * `2` — Офис * `3` — Магазин
- `[].contact_persons` — Контакты организации
- `[].contact_persons[].id` — ID контакного лица
- `[].contact_persons[].name` — ФИО
- `[].contact_persons[].phone` — Телефон
- `[].contact_persons[].extra_phone` — Добавочный номер
- `[].contact_persons[].email` — Электронная почта
- `[].all_departments_allowed` — Организация доступна всем подразделениям
- `[].department_ids` — Подразделения, которым доступна организация

**Пример ответа (4XX)**

```json
{
  "error_code": "string",
  "reason": "string"
}
```

**Описание полей ответа**
- `error_code` — Код ошибки
- `reason` — Причина ошибки

<a id="get-catalogs-v1.2-organizations"></a>

**Версия: OAuth2.0 v2**

Получение всех доступных организаций пользователя

**Пример запроса (curl):**

```bash
curl 'https://api.ati.su/gw/oauth2/catalogs/v1.2/organizations' \
  -X 'GET' \
  -H 'Authorization: Bearer {authorizationToken}' \
  -H 'Content-Type: application/json'
```

**OpenAPI схема:** [JSON](https://ati.su/developers/raw/api/catalogs/organizations.openapi.json)

**Пример ответа (200)**

```json
[
  {
    "id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
    "name": "string",
    "ownership": 0,
    "residency": {},
    "inn": "string",
    "phone": "string",
    "extra_phone": 0,
    "docs_address": {
      "postcode": "string",
      "city_id": 0,
      "street_name": "string",
      "house_no": "string",
      "office_no": "string"
    },
    "addresses": [
      {
        "id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
        "address": "string",
        "address_city_id": 0,
        "address_latitude": 0.5,
        "address_longitude": 0.5,
        "note": "string",
        "contact_persons": [
          {
            "id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
            "name": "string",
            "phone": "string",
            "extra_phone": 0,
            "email": "string"
          }
        ],
        "schedule_summary": "string",
        "address_type": 0
      }
    ],
    "contact_persons": [
      {
        "id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
        "name": "string",
        "phone": "string",
        "extra_phone": 0,
        "email": "string"
      }
    ],
    "all_departments_allowed": false,
    "department_ids": [
      0
    ]
  }
]
```

**Описание полей ответа**
- `[].id` — ID организации
- `[].name` — Название
- `[].ownership` — Организационно-правовая форма собственности. Значение из [словаря](https://ati.su/developers/api/dictionaries/firms/#get-v1.0-dictionaries-ownerships)
- `[].inn` — Регистрационный номер (ИНН, ЕДРПОУ, УНП, БИН или их аналоги)
- `[].phone` — Номер телефона организации
- `[].extra_phone` — Добавочный номер
- `[].docs_address` — Адрес местонахождения для документов
- `[].docs_address.postcode` — Почтовый индекс
- `[].docs_address.city_id` — Id населенного пункта\ Значение из [словаря](https://ati.su/developers/api/dictionaries/geo/)
- `[].docs_address.street_name` — Улица, проспект, переулок, бульвар и пр.
- `[].docs_address.house_no` — Дом, строение, корпус, литера
- `[].docs_address.office_no` — Офис, помещение и пр.
- `[].addresses` — Адреса
- `[].addresses[].id` — ID адреса
- `[].addresses[].address` — Адрес
- `[].addresses[].address_city_id` — ID города. Значение из [словаря](https://ati.su/developers/api/dictionaries/geo/)
- `[].addresses[].address_latitude` — Координаты адреса: широта
- `[].addresses[].address_longitude` — Координаты адреса: долгота
- `[].addresses[].note` — Примечание
- `[].addresses[].contact_persons` — Контакты адреса
- `[].addresses[].contact_persons[].id` — ID контакного лица
- `[].addresses[].contact_persons[].name` — ФИО
- `[].addresses[].contact_persons[].phone` — Телефон
- `[].addresses[].contact_persons[].extra_phone` — Добавочный номер
- `[].addresses[].contact_persons[].email` — Электронная почта
- `[].addresses[].schedule_summary` — Текстовое описание времени работы
- `[].addresses[].address_type` — Тип адреса * `1` — Склад * `2` — Офис * `3` — Магазин
- `[].contact_persons` — Контакты организации
- `[].contact_persons[].id` — ID контакного лица
- `[].contact_persons[].name` — ФИО
- `[].contact_persons[].phone` — Телефон
- `[].contact_persons[].extra_phone` — Добавочный номер
- `[].contact_persons[].email` — Электронная почта
- `[].all_departments_allowed` — Организация доступна всем подразделениям
- `[].department_ids` — Подразделения, которым доступна организация

**Пример ответа (4XX)**

```json
{
  "error_code": "string",
  "reason": "string"
}
```

**Описание полей ответа**
- `error_code` — Код ошибки
- `reason` — Причина ошибки


<a id="post-v1.2-catalogs-organizations"></a>

**Версия: OAuth2.0 v1**

Добавление организации

**Пример запроса (curl):**

```bash
curl 'https://api.ati.su/v1.2/catalogs/organizations' \
  -X 'POST' \
  -H 'Authorization: Bearer {authorizationToken}' \
  -H 'Content-Type: application/json' \
  --data-raw '{
  "name": "string",
  "ownership": 0,
  "all_departments_allowed": false,
  "department_ids": [
    0
  ],
  "residency": 0,
  "inn": "string",
  "phone": "string",
  "extra_phone": 0,
  "docs_address": {
    "postcode": "string",
    "city_id": 0,
    "street_name": "string",
    "house_no": "string",
    "office_no": "string"
  },
  "address_ids": [
    "3fa85f64-5717-4562-b3fc-2c963f66afa6"
  ],
  "contact_person_ids": [
    "3fa85f64-5717-4562-b3fc-2c963f66afa6"
  ]
}'
```

**OpenAPI схема:** [JSON](https://ati.su/developers/raw/api/catalogs/organizations.openapi.json)

**Описание полей запроса**
- `name` — Название
- `ownership` — Организационно-правовая форма собственности. Значение из [словаря](https://ati.su/developers/api/dictionaries/firms/#get-v1.0-dictionaries-ownerships)
- `all_departments_allowed` — Организация доступна всем подразделениям? Если нет, то в параметре department_ids необходимо указать, каким подразделениям доступна
- `department_ids` — Подразделения, которым доступна организация
- `residency` — Резидентство * `1` — Россия * `2` — Украина * `3` — Беларусь * `10` — Казахстан * `200` — Международное (другое)
- `inn` — Регистрационный номер (ИНН, ЕДРПОУ, УНП, БИН или их аналоги). Используйте номер в соответствии со своим резидентством
- `phone` — Номер телефона организации
- `extra_phone` — Добавочный номер
- `docs_address` — Адрес местонахождения для документов
- `docs_address.postcode` — Почтовый индекс
- `docs_address.city_id` — Id населенного пункта\ Значение из [словаря](https://ati.su/developers/api/dictionaries/geo/)
- `docs_address.street_name` — Улица, проспект, переулок, бульвар и пр.
- `docs_address.house_no` — Дом, строение, корпус, литера
- `docs_address.office_no` — Офис, помещение и пр.
- `address_ids` — Адреса организации, id
- `contact_person_ids` — Контактные лица организации, id

**Пример ответа (200)**

```json
{
  "id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
  "name": "string",
  "ownership": 0,
  "residency": {},
  "inn": "string",
  "phone": "string",
  "extra_phone": 0,
  "docs_address": {
    "postcode": "string",
    "city_id": 0,
    "street_name": "string",
    "house_no": "string",
    "office_no": "string"
  },
  "addresses": [
    {
      "id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
      "address": "string",
      "address_city_id": 0,
      "address_latitude": 0.5,
      "address_longitude": 0.5,
      "note": "string",
      "contact_persons": [
        {
          "id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
          "name": "string",
          "phone": "string",
          "extra_phone": 0,
          "email": "string"
        }
      ],
      "schedule_summary": "string",
      "address_type": 0
    }
  ],
  "contact_persons": [
    {
      "id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
      "name": "string",
      "phone": "string",
      "extra_phone": 0,
      "email": "string"
    }
  ],
  "all_departments_allowed": false,
  "department_ids": [
    0
  ]
}
```

**Описание полей ответа**
- `id` — ID организации
- `name` — Название
- `ownership` — Организационно-правовая форма собственности. Значение из [словаря](https://ati.su/developers/api/dictionaries/firms/#get-v1.0-dictionaries-ownerships)
- `inn` — Регистрационный номер (ИНН, ЕДРПОУ, УНП, БИН или их аналоги)
- `phone` — Номер телефона организации
- `extra_phone` — Добавочный номер
- `docs_address` — Адрес местонахождения для документов
- `docs_address.postcode` — Почтовый индекс
- `docs_address.city_id` — Id населенного пункта\ Значение из [словаря](https://ati.su/developers/api/dictionaries/geo/)
- `docs_address.street_name` — Улица, проспект, переулок, бульвар и пр.
- `docs_address.house_no` — Дом, строение, корпус, литера
- `docs_address.office_no` — Офис, помещение и пр.
- `addresses` — Адреса
- `addresses[].id` — ID адреса
- `addresses[].address` — Адрес
- `addresses[].address_city_id` — ID города. Значение из [словаря](https://ati.su/developers/api/dictionaries/geo/)
- `addresses[].address_latitude` — Координаты адреса: широта
- `addresses[].address_longitude` — Координаты адреса: долгота
- `addresses[].note` — Примечание
- `addresses[].contact_persons` — Контакты адреса
- `addresses[].contact_persons[].id` — ID контакного лица
- `addresses[].contact_persons[].name` — ФИО
- `addresses[].contact_persons[].phone` — Телефон
- `addresses[].contact_persons[].extra_phone` — Добавочный номер
- `addresses[].contact_persons[].email` — Электронная почта
- `addresses[].schedule_summary` — Текстовое описание времени работы
- `addresses[].address_type` — Тип адреса * `1` — Склад * `2` — Офис * `3` — Магазин
- `contact_persons` — Контакты организации
- `contact_persons[].id` — ID контакного лица
- `contact_persons[].name` — ФИО
- `contact_persons[].phone` — Телефон
- `contact_persons[].extra_phone` — Добавочный номер
- `contact_persons[].email` — Электронная почта
- `all_departments_allowed` — Организация доступна всем подразделениям
- `department_ids` — Подразделения, которым доступна организация

**Пример ответа (4XX)**

```json
{
  "error_code": "string",
  "reason": "string"
}
```

**Описание полей ответа**
- `error_code` — Код ошибки
- `reason` — Причина ошибки

<a id="post-catalogs-v1.2-organizations"></a>

**Версия: OAuth2.0 v2**

Добавление организации

**Пример запроса (curl):**

```bash
curl 'https://api.ati.su/gw/oauth2/catalogs/v1.2/organizations' \
  -X 'POST' \
  -H 'Authorization: Bearer {authorizationToken}' \
  -H 'Content-Type: application/json' \
  --data-raw '{
  "name": "string",
  "ownership": 0,
  "all_departments_allowed": false,
  "department_ids": [
    0
  ],
  "residency": 0,
  "inn": "string",
  "phone": "string",
  "extra_phone": 0,
  "docs_address": {
    "postcode": "string",
    "city_id": 0,
    "street_name": "string",
    "house_no": "string",
    "office_no": "string"
  },
  "address_ids": [
    "3fa85f64-5717-4562-b3fc-2c963f66afa6"
  ],
  "contact_person_ids": [
    "3fa85f64-5717-4562-b3fc-2c963f66afa6"
  ]
}'
```

**OpenAPI схема:** [JSON](https://ati.su/developers/raw/api/catalogs/organizations.openapi.json)

**Описание полей запроса**
- `name` — Название
- `ownership` — Организационно-правовая форма собственности. Значение из [словаря](https://ati.su/developers/api/dictionaries/firms/#get-v1.0-dictionaries-ownerships)
- `all_departments_allowed` — Организация доступна всем подразделениям? Если нет, то в параметре department_ids необходимо указать, каким подразделениям доступна
- `department_ids` — Подразделения, которым доступна организация
- `residency` — Резидентство * `1` — Россия * `2` — Украина * `3` — Беларусь * `10` — Казахстан * `200` — Международное (другое)
- `inn` — Регистрационный номер (ИНН, ЕДРПОУ, УНП, БИН или их аналоги). Используйте номер в соответствии со своим резидентством
- `phone` — Номер телефона организации
- `extra_phone` — Добавочный номер
- `docs_address` — Адрес местонахождения для документов
- `docs_address.postcode` — Почтовый индекс
- `docs_address.city_id` — Id населенного пункта\ Значение из [словаря](https://ati.su/developers/api/dictionaries/geo/)
- `docs_address.street_name` — Улица, проспект, переулок, бульвар и пр.
- `docs_address.house_no` — Дом, строение, корпус, литера
- `docs_address.office_no` — Офис, помещение и пр.
- `address_ids` — Адреса организации, id
- `contact_person_ids` — Контактные лица организации, id

**Пример ответа (200)**

```json
{
  "id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
  "name": "string",
  "ownership": 0,
  "residency": {},
  "inn": "string",
  "phone": "string",
  "extra_phone": 0,
  "docs_address": {
    "postcode": "string",
    "city_id": 0,
    "street_name": "string",
    "house_no": "string",
    "office_no": "string"
  },
  "addresses": [
    {
      "id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
      "address": "string",
      "address_city_id": 0,
      "address_latitude": 0.5,
      "address_longitude": 0.5,
      "note": "string",
      "contact_persons": [
        {
          "id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
          "name": "string",
          "phone": "string",
          "extra_phone": 0,
          "email": "string"
        }
      ],
      "schedule_summary": "string",
      "address_type": 0
    }
  ],
  "contact_persons": [
    {
      "id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
      "name": "string",
      "phone": "string",
      "extra_phone": 0,
      "email": "string"
    }
  ],
  "all_departments_allowed": false,
  "department_ids": [
    0
  ]
}
```

**Описание полей ответа**
- `id` — ID организации
- `name` — Название
- `ownership` — Организационно-правовая форма собственности. Значение из [словаря](https://ati.su/developers/api/dictionaries/firms/#get-v1.0-dictionaries-ownerships)
- `inn` — Регистрационный номер (ИНН, ЕДРПОУ, УНП, БИН или их аналоги)
- `phone` — Номер телефона организации
- `extra_phone` — Добавочный номер
- `docs_address` — Адрес местонахождения для документов
- `docs_address.postcode` — Почтовый индекс
- `docs_address.city_id` — Id населенного пункта\ Значение из [словаря](https://ati.su/developers/api/dictionaries/geo/)
- `docs_address.street_name` — Улица, проспект, переулок, бульвар и пр.
- `docs_address.house_no` — Дом, строение, корпус, литера
- `docs_address.office_no` — Офис, помещение и пр.
- `addresses` — Адреса
- `addresses[].id` — ID адреса
- `addresses[].address` — Адрес
- `addresses[].address_city_id` — ID города. Значение из [словаря](https://ati.su/developers/api/dictionaries/geo/)
- `addresses[].address_latitude` — Координаты адреса: широта
- `addresses[].address_longitude` — Координаты адреса: долгота
- `addresses[].note` — Примечание
- `addresses[].contact_persons` — Контакты адреса
- `addresses[].contact_persons[].id` — ID контакного лица
- `addresses[].contact_persons[].name` — ФИО
- `addresses[].contact_persons[].phone` — Телефон
- `addresses[].contact_persons[].extra_phone` — Добавочный номер
- `addresses[].contact_persons[].email` — Электронная почта
- `addresses[].schedule_summary` — Текстовое описание времени работы
- `addresses[].address_type` — Тип адреса * `1` — Склад * `2` — Офис * `3` — Магазин
- `contact_persons` — Контакты организации
- `contact_persons[].id` — ID контакного лица
- `contact_persons[].name` — ФИО
- `contact_persons[].phone` — Телефон
- `contact_persons[].extra_phone` — Добавочный номер
- `contact_persons[].email` — Электронная почта
- `all_departments_allowed` — Организация доступна всем подразделениям
- `department_ids` — Подразделения, которым доступна организация

**Пример ответа (4XX)**

```json
{
  "error_code": "string",
  "reason": "string"
}
```

**Описание полей ответа**
- `error_code` — Код ошибки
- `reason` — Причина ошибки


<a id="post-v1.2-catalogs-organizations-filter"></a>

**Версия: OAuth2.0 v1**

Получение организаций пользователя по подразделениям

**Пример запроса (curl):**

```bash
curl 'https://api.ati.su/v1.2/catalogs/organizations/filter' \
  -X 'POST' \
  -H 'Authorization: Bearer {authorizationToken}' \
  -H 'Content-Type: application/json' \
  --data-raw '{
  "departments": [
    0
  ]
}'
```

**OpenAPI схема:** [JSON](https://ati.su/developers/raw/api/catalogs/organizations.openapi.json)

**Описание полей запроса**
- `departments` — Список подразделений, по которым необходимо отфильтровать организации

**Пример ответа (200)**

```json
[
  {
    "id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
    "name": "string",
    "ownership": 0,
    "residency": {},
    "inn": "string",
    "phone": "string",
    "extra_phone": 0,
    "docs_address": {
      "postcode": "string",
      "city_id": 0,
      "street_name": "string",
      "house_no": "string",
      "office_no": "string"
    },
    "addresses": [
      {
        "id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
        "address": "string",
        "address_city_id": 0,
        "address_latitude": 0.5,
        "address_longitude": 0.5,
        "note": "string",
        "contact_persons": [
          {
            "id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
            "name": "string",
            "phone": "string",
            "extra_phone": 0,
            "email": "string"
          }
        ],
        "schedule_summary": "string",
        "address_type": 0
      }
    ],
    "contact_persons": [
      {
        "id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
        "name": "string",
        "phone": "string",
        "extra_phone": 0,
        "email": "string"
      }
    ],
    "all_departments_allowed": false,
    "department_ids": [
      0
    ]
  }
]
```

**Описание полей ответа**
- `[].id` — ID организации
- `[].name` — Название
- `[].ownership` — Организационно-правовая форма собственности. Значение из [словаря](https://ati.su/developers/api/dictionaries/firms/#get-v1.0-dictionaries-ownerships)
- `[].inn` — Регистрационный номер (ИНН, ЕДРПОУ, УНП, БИН или их аналоги)
- `[].phone` — Номер телефона организации
- `[].extra_phone` — Добавочный номер
- `[].docs_address` — Адрес местонахождения для документов
- `[].docs_address.postcode` — Почтовый индекс
- `[].docs_address.city_id` — Id населенного пункта\ Значение из [словаря](https://ati.su/developers/api/dictionaries/geo/)
- `[].docs_address.street_name` — Улица, проспект, переулок, бульвар и пр.
- `[].docs_address.house_no` — Дом, строение, корпус, литера
- `[].docs_address.office_no` — Офис, помещение и пр.
- `[].addresses` — Адреса
- `[].addresses[].id` — ID адреса
- `[].addresses[].address` — Адрес
- `[].addresses[].address_city_id` — ID города. Значение из [словаря](https://ati.su/developers/api/dictionaries/geo/)
- `[].addresses[].address_latitude` — Координаты адреса: широта
- `[].addresses[].address_longitude` — Координаты адреса: долгота
- `[].addresses[].note` — Примечание
- `[].addresses[].contact_persons` — Контакты адреса
- `[].addresses[].contact_persons[].id` — ID контакного лица
- `[].addresses[].contact_persons[].name` — ФИО
- `[].addresses[].contact_persons[].phone` — Телефон
- `[].addresses[].contact_persons[].extra_phone` — Добавочный номер
- `[].addresses[].contact_persons[].email` — Электронная почта
- `[].addresses[].schedule_summary` — Текстовое описание времени работы
- `[].addresses[].address_type` — Тип адреса * `1` — Склад * `2` — Офис * `3` — Магазин
- `[].contact_persons` — Контакты организации
- `[].contact_persons[].id` — ID контакного лица
- `[].contact_persons[].name` — ФИО
- `[].contact_persons[].phone` — Телефон
- `[].contact_persons[].extra_phone` — Добавочный номер
- `[].contact_persons[].email` — Электронная почта
- `[].all_departments_allowed` — Организация доступна всем подразделениям
- `[].department_ids` — Подразделения, которым доступна организация

**Пример ответа (4XX)**

```json
{
  "error_code": "string",
  "reason": "string"
}
```

**Описание полей ответа**
- `error_code` — Код ошибки
- `reason` — Причина ошибки

<a id="post-catalogs-v1.2-organizations-filter"></a>

**Версия: OAuth2.0 v2**

Получение организаций пользователя по подразделениям

**Пример запроса (curl):**

```bash
curl 'https://api.ati.su/gw/oauth2/catalogs/v1.2/organizations/filter' \
  -X 'POST' \
  -H 'Authorization: Bearer {authorizationToken}' \
  -H 'Content-Type: application/json' \
  --data-raw '{
  "departments": [
    0
  ]
}'
```

**OpenAPI схема:** [JSON](https://ati.su/developers/raw/api/catalogs/organizations.openapi.json)

**Описание полей запроса**
- `departments` — Список подразделений, по которым необходимо отфильтровать организации

**Пример ответа (200)**

```json
[
  {
    "id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
    "name": "string",
    "ownership": 0,
    "residency": {},
    "inn": "string",
    "phone": "string",
    "extra_phone": 0,
    "docs_address": {
      "postcode": "string",
      "city_id": 0,
      "street_name": "string",
      "house_no": "string",
      "office_no": "string"
    },
    "addresses": [
      {
        "id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
        "address": "string",
        "address_city_id": 0,
        "address_latitude": 0.5,
        "address_longitude": 0.5,
        "note": "string",
        "contact_persons": [
          {
            "id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
            "name": "string",
            "phone": "string",
            "extra_phone": 0,
            "email": "string"
          }
        ],
        "schedule_summary": "string",
        "address_type": 0
      }
    ],
    "contact_persons": [
      {
        "id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
        "name": "string",
        "phone": "string",
        "extra_phone": 0,
        "email": "string"
      }
    ],
    "all_departments_allowed": false,
    "department_ids": [
      0
    ]
  }
]
```

**Описание полей ответа**
- `[].id` — ID организации
- `[].name` — Название
- `[].ownership` — Организационно-правовая форма собственности. Значение из [словаря](https://ati.su/developers/api/dictionaries/firms/#get-v1.0-dictionaries-ownerships)
- `[].inn` — Регистрационный номер (ИНН, ЕДРПОУ, УНП, БИН или их аналоги)
- `[].phone` — Номер телефона организации
- `[].extra_phone` — Добавочный номер
- `[].docs_address` — Адрес местонахождения для документов
- `[].docs_address.postcode` — Почтовый индекс
- `[].docs_address.city_id` — Id населенного пункта\ Значение из [словаря](https://ati.su/developers/api/dictionaries/geo/)
- `[].docs_address.street_name` — Улица, проспект, переулок, бульвар и пр.
- `[].docs_address.house_no` — Дом, строение, корпус, литера
- `[].docs_address.office_no` — Офис, помещение и пр.
- `[].addresses` — Адреса
- `[].addresses[].id` — ID адреса
- `[].addresses[].address` — Адрес
- `[].addresses[].address_city_id` — ID города. Значение из [словаря](https://ati.su/developers/api/dictionaries/geo/)
- `[].addresses[].address_latitude` — Координаты адреса: широта
- `[].addresses[].address_longitude` — Координаты адреса: долгота
- `[].addresses[].note` — Примечание
- `[].addresses[].contact_persons` — Контакты адреса
- `[].addresses[].contact_persons[].id` — ID контакного лица
- `[].addresses[].contact_persons[].name` — ФИО
- `[].addresses[].contact_persons[].phone` — Телефон
- `[].addresses[].contact_persons[].extra_phone` — Добавочный номер
- `[].addresses[].contact_persons[].email` — Электронная почта
- `[].addresses[].schedule_summary` — Текстовое описание времени работы
- `[].addresses[].address_type` — Тип адреса * `1` — Склад * `2` — Офис * `3` — Магазин
- `[].contact_persons` — Контакты организации
- `[].contact_persons[].id` — ID контакного лица
- `[].contact_persons[].name` — ФИО
- `[].contact_persons[].phone` — Телефон
- `[].contact_persons[].extra_phone` — Добавочный номер
- `[].contact_persons[].email` — Электронная почта
- `[].all_departments_allowed` — Организация доступна всем подразделениям
- `[].department_ids` — Подразделения, которым доступна организация

**Пример ответа (4XX)**

```json
{
  "error_code": "string",
  "reason": "string"
}
```

**Описание полей ответа**
- `error_code` — Код ошибки
- `reason` — Причина ошибки


<a id="get-v1.2-catalogs-organizations-{organizationId}"></a>

**Версия: OAuth2.0 v1**

Получение организации пользователя по id

**Пример запроса (curl):**

```bash
curl 'https://api.ati.su/v1.2/catalogs/organizations/3fa85f64-5717-4562-b3fc-2c963f66afa6' \
  -X 'GET' \
  -H 'Authorization: Bearer {authorizationToken}' \
  -H 'Content-Type: application/json'
```

**OpenAPI схема:** [JSON](https://ati.su/developers/raw/api/catalogs/organizations.openapi.json)

**Пример ответа (200)**

```json
{
  "id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
  "name": "string",
  "ownership": 0,
  "residency": {},
  "inn": "string",
  "phone": "string",
  "extra_phone": 0,
  "docs_address": {
    "postcode": "string",
    "city_id": 0,
    "street_name": "string",
    "house_no": "string",
    "office_no": "string"
  },
  "addresses": [
    {
      "id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
      "address": "string",
      "address_city_id": 0,
      "address_latitude": 0.5,
      "address_longitude": 0.5,
      "note": "string",
      "contact_persons": [
        {
          "id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
          "name": "string",
          "phone": "string",
          "extra_phone": 0,
          "email": "string"
        }
      ],
      "schedule_summary": "string",
      "address_type": 0
    }
  ],
  "contact_persons": [
    {
      "id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
      "name": "string",
      "phone": "string",
      "extra_phone": 0,
      "email": "string"
    }
  ],
  "all_departments_allowed": false,
  "department_ids": [
    0
  ]
}
```

**Описание полей ответа**
- `id` — ID организации
- `name` — Название
- `ownership` — Организационно-правовая форма собственности. Значение из [словаря](https://ati.su/developers/api/dictionaries/firms/#get-v1.0-dictionaries-ownerships)
- `inn` — Регистрационный номер (ИНН, ЕДРПОУ, УНП, БИН или их аналоги)
- `phone` — Номер телефона организации
- `extra_phone` — Добавочный номер
- `docs_address` — Адрес местонахождения для документов
- `docs_address.postcode` — Почтовый индекс
- `docs_address.city_id` — Id населенного пункта\ Значение из [словаря](https://ati.su/developers/api/dictionaries/geo/)
- `docs_address.street_name` — Улица, проспект, переулок, бульвар и пр.
- `docs_address.house_no` — Дом, строение, корпус, литера
- `docs_address.office_no` — Офис, помещение и пр.
- `addresses` — Адреса
- `addresses[].id` — ID адреса
- `addresses[].address` — Адрес
- `addresses[].address_city_id` — ID города. Значение из [словаря](https://ati.su/developers/api/dictionaries/geo/)
- `addresses[].address_latitude` — Координаты адреса: широта
- `addresses[].address_longitude` — Координаты адреса: долгота
- `addresses[].note` — Примечание
- `addresses[].contact_persons` — Контакты адреса
- `addresses[].contact_persons[].id` — ID контакного лица
- `addresses[].contact_persons[].name` — ФИО
- `addresses[].contact_persons[].phone` — Телефон
- `addresses[].contact_persons[].extra_phone` — Добавочный номер
- `addresses[].contact_persons[].email` — Электронная почта
- `addresses[].schedule_summary` — Текстовое описание времени работы
- `addresses[].address_type` — Тип адреса * `1` — Склад * `2` — Офис * `3` — Магазин
- `contact_persons` — Контакты организации
- `contact_persons[].id` — ID контакного лица
- `contact_persons[].name` — ФИО
- `contact_persons[].phone` — Телефон
- `contact_persons[].extra_phone` — Добавочный номер
- `contact_persons[].email` — Электронная почта
- `all_departments_allowed` — Организация доступна всем подразделениям
- `department_ids` — Подразделения, которым доступна организация

**Пример ответа (4XX)**

```json
{
  "error_code": "string",
  "reason": "string"
}
```

**Описание полей ответа**
- `error_code` — Код ошибки
- `reason` — Причина ошибки

<a id="get-catalogs-v1.2-organizations-{organizationId}"></a>

**Версия: OAuth2.0 v2**

Получение организации пользователя по id

**Пример запроса (curl):**

```bash
curl 'https://api.ati.su/gw/oauth2/catalogs/v1.2/organizations/3fa85f64-5717-4562-b3fc-2c963f66afa6' \
  -X 'GET' \
  -H 'Authorization: Bearer {authorizationToken}' \
  -H 'Content-Type: application/json'
```

**OpenAPI схема:** [JSON](https://ati.su/developers/raw/api/catalogs/organizations.openapi.json)

**Пример ответа (200)**

```json
{
  "id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
  "name": "string",
  "ownership": 0,
  "residency": {},
  "inn": "string",
  "phone": "string",
  "extra_phone": 0,
  "docs_address": {
    "postcode": "string",
    "city_id": 0,
    "street_name": "string",
    "house_no": "string",
    "office_no": "string"
  },
  "addresses": [
    {
      "id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
      "address": "string",
      "address_city_id": 0,
      "address_latitude": 0.5,
      "address_longitude": 0.5,
      "note": "string",
      "contact_persons": [
        {
          "id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
          "name": "string",
          "phone": "string",
          "extra_phone": 0,
          "email": "string"
        }
      ],
      "schedule_summary": "string",
      "address_type": 0
    }
  ],
  "contact_persons": [
    {
      "id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
      "name": "string",
      "phone": "string",
      "extra_phone": 0,
      "email": "string"
    }
  ],
  "all_departments_allowed": false,
  "department_ids": [
    0
  ]
}
```

**Описание полей ответа**
- `id` — ID организации
- `name` — Название
- `ownership` — Организационно-правовая форма собственности. Значение из [словаря](https://ati.su/developers/api/dictionaries/firms/#get-v1.0-dictionaries-ownerships)
- `inn` — Регистрационный номер (ИНН, ЕДРПОУ, УНП, БИН или их аналоги)
- `phone` — Номер телефона организации
- `extra_phone` — Добавочный номер
- `docs_address` — Адрес местонахождения для документов
- `docs_address.postcode` — Почтовый индекс
- `docs_address.city_id` — Id населенного пункта\ Значение из [словаря](https://ati.su/developers/api/dictionaries/geo/)
- `docs_address.street_name` — Улица, проспект, переулок, бульвар и пр.
- `docs_address.house_no` — Дом, строение, корпус, литера
- `docs_address.office_no` — Офис, помещение и пр.
- `addresses` — Адреса
- `addresses[].id` — ID адреса
- `addresses[].address` — Адрес
- `addresses[].address_city_id` — ID города. Значение из [словаря](https://ati.su/developers/api/dictionaries/geo/)
- `addresses[].address_latitude` — Координаты адреса: широта
- `addresses[].address_longitude` — Координаты адреса: долгота
- `addresses[].note` — Примечание
- `addresses[].contact_persons` — Контакты адреса
- `addresses[].contact_persons[].id` — ID контакного лица
- `addresses[].contact_persons[].name` — ФИО
- `addresses[].contact_persons[].phone` — Телефон
- `addresses[].contact_persons[].extra_phone` — Добавочный номер
- `addresses[].contact_persons[].email` — Электронная почта
- `addresses[].schedule_summary` — Текстовое описание времени работы
- `addresses[].address_type` — Тип адреса * `1` — Склад * `2` — Офис * `3` — Магазин
- `contact_persons` — Контакты организации
- `contact_persons[].id` — ID контакного лица
- `contact_persons[].name` — ФИО
- `contact_persons[].phone` — Телефон
- `contact_persons[].extra_phone` — Добавочный номер
- `contact_persons[].email` — Электронная почта
- `all_departments_allowed` — Организация доступна всем подразделениям
- `department_ids` — Подразделения, которым доступна организация

**Пример ответа (4XX)**

```json
{
  "error_code": "string",
  "reason": "string"
}
```

**Описание полей ответа**
- `error_code` — Код ошибки
- `reason` — Причина ошибки


<a id="put-v1.2-catalogs-organizations-{organizationId}"></a>

**Версия: OAuth2.0 v1**

Изменение организации

**Пример запроса (curl):**

```bash
curl 'https://api.ati.su/v1.2/catalogs/organizations/3fa85f64-5717-4562-b3fc-2c963f66afa6' \
  -X 'PUT' \
  -H 'Authorization: Bearer {authorizationToken}' \
  -H 'Content-Type: application/json' \
  --data-raw '{
  "name": "string",
  "ownership": 0,
  "all_departments_allowed": false,
  "department_ids": [
    0
  ],
  "residency": 0,
  "inn": "string",
  "phone": "string",
  "extra_phone": 0,
  "docs_address": {
    "postcode": "string",
    "city_id": 0,
    "street_name": "string",
    "house_no": "string",
    "office_no": "string"
  },
  "address_ids": [
    "3fa85f64-5717-4562-b3fc-2c963f66afa6"
  ],
  "contact_person_ids": [
    "3fa85f64-5717-4562-b3fc-2c963f66afa6"
  ]
}'
```

**OpenAPI схема:** [JSON](https://ati.su/developers/raw/api/catalogs/organizations.openapi.json)

**Описание полей запроса**
- `name` — Название
- `ownership` — Организационно-правовая форма собственности. Значение из [словаря](https://ati.su/developers/api/dictionaries/firms/#get-v1.0-dictionaries-ownerships)
- `all_departments_allowed` — Организация доступна всем подразделениям? Если нет, то в параметре department_ids необходимо указать, каким подразделениям доступна
- `department_ids` — Подразделения, которым доступна организация
- `residency` — Резидентство * `1` — Россия * `2` — Украина * `3` — Беларусь * `10` — Казахстан * `200` — Международное (другое)
- `inn` — Регистрационный номер (ИНН, ЕДРПОУ, УНП, БИН или их аналоги). Используйте номер в соответствии со своим резидентством
- `phone` — Номер телефона организации
- `extra_phone` — Добавочный номер
- `docs_address` — Адрес местонахождения для документов
- `docs_address.postcode` — Почтовый индекс
- `docs_address.city_id` — Id населенного пункта\ Значение из [словаря](https://ati.su/developers/api/dictionaries/geo/)
- `docs_address.street_name` — Улица, проспект, переулок, бульвар и пр.
- `docs_address.house_no` — Дом, строение, корпус, литера
- `docs_address.office_no` — Офис, помещение и пр.
- `address_ids` — Адреса организации, id
- `contact_person_ids` — Контактные лица организации, id

**Пример ответа (200)**

```json
{
  "id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
  "name": "string",
  "ownership": 0,
  "residency": {},
  "inn": "string",
  "phone": "string",
  "extra_phone": 0,
  "docs_address": {
    "postcode": "string",
    "city_id": 0,
    "street_name": "string",
    "house_no": "string",
    "office_no": "string"
  },
  "addresses": [
    {
      "id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
      "address": "string",
      "address_city_id": 0,
      "address_latitude": 0.5,
      "address_longitude": 0.5,
      "note": "string",
      "contact_persons": [
        {
          "id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
          "name": "string",
          "phone": "string",
          "extra_phone": 0,
          "email": "string"
        }
      ],
      "schedule_summary": "string",
      "address_type": 0
    }
  ],
  "contact_persons": [
    {
      "id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
      "name": "string",
      "phone": "string",
      "extra_phone": 0,
      "email": "string"
    }
  ],
  "all_departments_allowed": false,
  "department_ids": [
    0
  ]
}
```

**Описание полей ответа**
- `id` — ID организации
- `name` — Название
- `ownership` — Организационно-правовая форма собственности. Значение из [словаря](https://ati.su/developers/api/dictionaries/firms/#get-v1.0-dictionaries-ownerships)
- `inn` — Регистрационный номер (ИНН, ЕДРПОУ, УНП, БИН или их аналоги)
- `phone` — Номер телефона организации
- `extra_phone` — Добавочный номер
- `docs_address` — Адрес местонахождения для документов
- `docs_address.postcode` — Почтовый индекс
- `docs_address.city_id` — Id населенного пункта\ Значение из [словаря](https://ati.su/developers/api/dictionaries/geo/)
- `docs_address.street_name` — Улица, проспект, переулок, бульвар и пр.
- `docs_address.house_no` — Дом, строение, корпус, литера
- `docs_address.office_no` — Офис, помещение и пр.
- `addresses` — Адреса
- `addresses[].id` — ID адреса
- `addresses[].address` — Адрес
- `addresses[].address_city_id` — ID города. Значение из [словаря](https://ati.su/developers/api/dictionaries/geo/)
- `addresses[].address_latitude` — Координаты адреса: широта
- `addresses[].address_longitude` — Координаты адреса: долгота
- `addresses[].note` — Примечание
- `addresses[].contact_persons` — Контакты адреса
- `addresses[].contact_persons[].id` — ID контакного лица
- `addresses[].contact_persons[].name` — ФИО
- `addresses[].contact_persons[].phone` — Телефон
- `addresses[].contact_persons[].extra_phone` — Добавочный номер
- `addresses[].contact_persons[].email` — Электронная почта
- `addresses[].schedule_summary` — Текстовое описание времени работы
- `addresses[].address_type` — Тип адреса * `1` — Склад * `2` — Офис * `3` — Магазин
- `contact_persons` — Контакты организации
- `contact_persons[].id` — ID контакного лица
- `contact_persons[].name` — ФИО
- `contact_persons[].phone` — Телефон
- `contact_persons[].extra_phone` — Добавочный номер
- `contact_persons[].email` — Электронная почта
- `all_departments_allowed` — Организация доступна всем подразделениям
- `department_ids` — Подразделения, которым доступна организация

**Пример ответа (4XX)**

```json
{
  "error_code": "string",
  "reason": "string"
}
```

**Описание полей ответа**
- `error_code` — Код ошибки
- `reason` — Причина ошибки

<a id="put-catalogs-v1.2-organizations-{organizationId}"></a>

**Версия: OAuth2.0 v2**

Изменение организации

**Пример запроса (curl):**

```bash
curl 'https://api.ati.su/gw/oauth2/catalogs/v1.2/organizations/3fa85f64-5717-4562-b3fc-2c963f66afa6' \
  -X 'PUT' \
  -H 'Authorization: Bearer {authorizationToken}' \
  -H 'Content-Type: application/json' \
  --data-raw '{
  "name": "string",
  "ownership": 0,
  "all_departments_allowed": false,
  "department_ids": [
    0
  ],
  "residency": 0,
  "inn": "string",
  "phone": "string",
  "extra_phone": 0,
  "docs_address": {
    "postcode": "string",
    "city_id": 0,
    "street_name": "string",
    "house_no": "string",
    "office_no": "string"
  },
  "address_ids": [
    "3fa85f64-5717-4562-b3fc-2c963f66afa6"
  ],
  "contact_person_ids": [
    "3fa85f64-5717-4562-b3fc-2c963f66afa6"
  ]
}'
```

**OpenAPI схема:** [JSON](https://ati.su/developers/raw/api/catalogs/organizations.openapi.json)

**Описание полей запроса**
- `name` — Название
- `ownership` — Организационно-правовая форма собственности. Значение из [словаря](https://ati.su/developers/api/dictionaries/firms/#get-v1.0-dictionaries-ownerships)
- `all_departments_allowed` — Организация доступна всем подразделениям? Если нет, то в параметре department_ids необходимо указать, каким подразделениям доступна
- `department_ids` — Подразделения, которым доступна организация
- `residency` — Резидентство * `1` — Россия * `2` — Украина * `3` — Беларусь * `10` — Казахстан * `200` — Международное (другое)
- `inn` — Регистрационный номер (ИНН, ЕДРПОУ, УНП, БИН или их аналоги). Используйте номер в соответствии со своим резидентством
- `phone` — Номер телефона организации
- `extra_phone` — Добавочный номер
- `docs_address` — Адрес местонахождения для документов
- `docs_address.postcode` — Почтовый индекс
- `docs_address.city_id` — Id населенного пункта\ Значение из [словаря](https://ati.su/developers/api/dictionaries/geo/)
- `docs_address.street_name` — Улица, проспект, переулок, бульвар и пр.
- `docs_address.house_no` — Дом, строение, корпус, литера
- `docs_address.office_no` — Офис, помещение и пр.
- `address_ids` — Адреса организации, id
- `contact_person_ids` — Контактные лица организации, id

**Пример ответа (200)**

```json
{
  "id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
  "name": "string",
  "ownership": 0,
  "residency": {},
  "inn": "string",
  "phone": "string",
  "extra_phone": 0,
  "docs_address": {
    "postcode": "string",
    "city_id": 0,
    "street_name": "string",
    "house_no": "string",
    "office_no": "string"
  },
  "addresses": [
    {
      "id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
      "address": "string",
      "address_city_id": 0,
      "address_latitude": 0.5,
      "address_longitude": 0.5,
      "note": "string",
      "contact_persons": [
        {
          "id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
          "name": "string",
          "phone": "string",
          "extra_phone": 0,
          "email": "string"
        }
      ],
      "schedule_summary": "string",
      "address_type": 0
    }
  ],
  "contact_persons": [
    {
      "id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
      "name": "string",
      "phone": "string",
      "extra_phone": 0,
      "email": "string"
    }
  ],
  "all_departments_allowed": false,
  "department_ids": [
    0
  ]
}
```

**Описание полей ответа**
- `id` — ID организации
- `name` — Название
- `ownership` — Организационно-правовая форма собственности. Значение из [словаря](https://ati.su/developers/api/dictionaries/firms/#get-v1.0-dictionaries-ownerships)
- `inn` — Регистрационный номер (ИНН, ЕДРПОУ, УНП, БИН или их аналоги)
- `phone` — Номер телефона организации
- `extra_phone` — Добавочный номер
- `docs_address` — Адрес местонахождения для документов
- `docs_address.postcode` — Почтовый индекс
- `docs_address.city_id` — Id населенного пункта\ Значение из [словаря](https://ati.su/developers/api/dictionaries/geo/)
- `docs_address.street_name` — Улица, проспект, переулок, бульвар и пр.
- `docs_address.house_no` — Дом, строение, корпус, литера
- `docs_address.office_no` — Офис, помещение и пр.
- `addresses` — Адреса
- `addresses[].id` — ID адреса
- `addresses[].address` — Адрес
- `addresses[].address_city_id` — ID города. Значение из [словаря](https://ati.su/developers/api/dictionaries/geo/)
- `addresses[].address_latitude` — Координаты адреса: широта
- `addresses[].address_longitude` — Координаты адреса: долгота
- `addresses[].note` — Примечание
- `addresses[].contact_persons` — Контакты адреса
- `addresses[].contact_persons[].id` — ID контакного лица
- `addresses[].contact_persons[].name` — ФИО
- `addresses[].contact_persons[].phone` — Телефон
- `addresses[].contact_persons[].extra_phone` — Добавочный номер
- `addresses[].contact_persons[].email` — Электронная почта
- `addresses[].schedule_summary` — Текстовое описание времени работы
- `addresses[].address_type` — Тип адреса * `1` — Склад * `2` — Офис * `3` — Магазин
- `contact_persons` — Контакты организации
- `contact_persons[].id` — ID контакного лица
- `contact_persons[].name` — ФИО
- `contact_persons[].phone` — Телефон
- `contact_persons[].extra_phone` — Добавочный номер
- `contact_persons[].email` — Электронная почта
- `all_departments_allowed` — Организация доступна всем подразделениям
- `department_ids` — Подразделения, которым доступна организация

**Пример ответа (4XX)**

```json
{
  "error_code": "string",
  "reason": "string"
}
```

**Описание полей ответа**
- `error_code` — Код ошибки
- `reason` — Причина ошибки


<a id="delete-v1.2-catalogs-organizations-{organizationId}"></a>

**Версия: OAuth2.0 v1**

Удаление организации

**Пример запроса (curl):**

```bash
curl 'https://api.ati.su/v1.2/catalogs/organizations/3fa85f64-5717-4562-b3fc-2c963f66afa6' \
  -X 'DELETE' \
  -H 'Authorization: Bearer {authorizationToken}' \
  -H 'Content-Type: application/json'
```

**OpenAPI схема:** [JSON](https://ati.su/developers/raw/api/catalogs/organizations.openapi.json)

**Пример ответа (4XX)**

```json
{
  "error_code": "string",
  "reason": "string"
}
```

**Описание полей ответа**
- `error_code` — Код ошибки
- `reason` — Причина ошибки

<a id="delete-catalogs-v1.2-organizations-{organizationId}"></a>

**Версия: OAuth2.0 v2**

Удаление организации

**Пример запроса (curl):**

```bash
curl 'https://api.ati.su/gw/oauth2/catalogs/v1.2/organizations/3fa85f64-5717-4562-b3fc-2c963f66afa6' \
  -X 'DELETE' \
  -H 'Authorization: Bearer {authorizationToken}' \
  -H 'Content-Type: application/json'
```

**OpenAPI схема:** [JSON](https://ati.su/developers/raw/api/catalogs/organizations.openapi.json)

**Пример ответа (4XX)**

```json
{
  "error_code": "string",
  "reason": "string"
}
```

**Описание полей ответа**
- `error_code` — Код ошибки
- `reason` — Причина ошибки


### Методы для работы с адресами организаций

<a id="get-v1.2-catalogs-organizations-addresses"></a>

**Версия: OAuth2.0 v1**

Получение всех адресов пользователя

**Пример запроса (curl):**

```bash
curl 'https://api.ati.su/v1.2/catalogs/organizations/addresses' \
  -X 'GET' \
  -H 'Authorization: Bearer {authorizationToken}' \
  -H 'Content-Type: application/json'
```

**OpenAPI схема:** [JSON](https://ati.su/developers/raw/api/catalogs/organizations.openapi.json)

**Пример ответа (200)**

```json
[
  {
    "id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
    "address": "string",
    "address_city_id": 0,
    "address_latitude": 0.5,
    "address_longitude": 0.5,
    "note": "string",
    "contact_persons": [
      {
        "id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
        "name": "string",
        "phone": "string",
        "extra_phone": 0,
        "email": "string"
      }
    ],
    "schedule_summary": "string",
    "address_type": 0
  }
]
```

**Описание полей ответа**
- `[].id` — ID адреса
- `[].address` — Адрес
- `[].address_city_id` — ID города. Значение из [словаря](https://ati.su/developers/api/dictionaries/geo/)
- `[].address_latitude` — Координаты адреса: широта
- `[].address_longitude` — Координаты адреса: долгота
- `[].note` — Примечание
- `[].contact_persons` — Контакты адреса
- `[].contact_persons[].id` — ID контакного лица
- `[].contact_persons[].name` — ФИО
- `[].contact_persons[].phone` — Телефон
- `[].contact_persons[].extra_phone` — Добавочный номер
- `[].contact_persons[].email` — Электронная почта
- `[].schedule_summary` — Текстовое описание времени работы
- `[].address_type` — Тип адреса * `1` — Склад * `2` — Офис * `3` — Магазин

**Пример ответа (4XX)**

```json
{
  "error_code": "string",
  "reason": "string"
}
```

**Описание полей ответа**
- `error_code` — Код ошибки
- `reason` — Причина ошибки

<a id="get-catalogs-v1.2-organizations-addresses"></a>

**Версия: OAuth2.0 v2**

Получение всех адресов пользователя

**Пример запроса (curl):**

```bash
curl 'https://api.ati.su/gw/oauth2/catalogs/v1.2/organizations/addresses' \
  -X 'GET' \
  -H 'Authorization: Bearer {authorizationToken}' \
  -H 'Content-Type: application/json'
```

**OpenAPI схема:** [JSON](https://ati.su/developers/raw/api/catalogs/organizations.openapi.json)

**Пример ответа (200)**

```json
[
  {
    "id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
    "address": "string",
    "address_city_id": 0,
    "address_latitude": 0.5,
    "address_longitude": 0.5,
    "note": "string",
    "contact_persons": [
      {
        "id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
        "name": "string",
        "phone": "string",
        "extra_phone": 0,
        "email": "string"
      }
    ],
    "schedule_summary": "string",
    "address_type": 0
  }
]
```

**Описание полей ответа**
- `[].id` — ID адреса
- `[].address` — Адрес
- `[].address_city_id` — ID города. Значение из [словаря](https://ati.su/developers/api/dictionaries/geo/)
- `[].address_latitude` — Координаты адреса: широта
- `[].address_longitude` — Координаты адреса: долгота
- `[].note` — Примечание
- `[].contact_persons` — Контакты адреса
- `[].contact_persons[].id` — ID контакного лица
- `[].contact_persons[].name` — ФИО
- `[].contact_persons[].phone` — Телефон
- `[].contact_persons[].extra_phone` — Добавочный номер
- `[].contact_persons[].email` — Электронная почта
- `[].schedule_summary` — Текстовое описание времени работы
- `[].address_type` — Тип адреса * `1` — Склад * `2` — Офис * `3` — Магазин

**Пример ответа (4XX)**

```json
{
  "error_code": "string",
  "reason": "string"
}
```

**Описание полей ответа**
- `error_code` — Код ошибки
- `reason` — Причина ошибки


<a id="post-v1.2-catalogs-organizations-addresses"></a>

**Версия: OAuth2.0 v1**

Добавление адреса

**Пример запроса (curl):**

```bash
curl 'https://api.ati.su/v1.2/catalogs/organizations/addresses' \
  -X 'POST' \
  -H 'Authorization: Bearer {authorizationToken}' \
  -H 'Content-Type: application/json' \
  --data-raw '{
  "address": "string",
  "address_city_id": 0,
  "address_latitude": 0.5,
  "address_longitude": 0.5,
  "note": "string",
  "schedule_summary": "string",
  "address_type": 0,
  "contact_person_ids": [
    "3fa85f64-5717-4562-b3fc-2c963f66afa6"
  ]
}'
```

**OpenAPI схема:** [JSON](https://ati.su/developers/raw/api/catalogs/organizations.openapi.json)

**Описание полей запроса**
- `address` — Адрес
- `address_city_id` — ID города. Значение из [словаря](https://ati.su/developers/api/dictionaries/geo/)
- `address_latitude` — Координаты адреса: широта
- `address_longitude` — Координаты адреса: долгота
- `note` — Примечание
- `schedule_summary` — Текстовое описание времени работы
- `address_type` — Тип адреса * `1` — Склад * `2` — Офис * `3` — Магазин
- `contact_person_ids` — ID контактных лиц

**Пример ответа (200)**

```json
{
  "id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
  "address": "string",
  "address_city_id": 0,
  "address_latitude": 0.5,
  "address_longitude": 0.5,
  "note": "string",
  "contact_persons": [
    {
      "id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
      "name": "string",
      "phone": "string",
      "extra_phone": 0,
      "email": "string"
    }
  ],
  "schedule_summary": "string",
  "address_type": 0
}
```

**Описание полей ответа**
- `id` — ID адреса
- `address` — Адрес
- `address_city_id` — ID города. Значение из [словаря](https://ati.su/developers/api/dictionaries/geo/)
- `address_latitude` — Координаты адреса: широта
- `address_longitude` — Координаты адреса: долгота
- `note` — Примечание
- `contact_persons` — Контакты адреса
- `contact_persons[].id` — ID контакного лица
- `contact_persons[].name` — ФИО
- `contact_persons[].phone` — Телефон
- `contact_persons[].extra_phone` — Добавочный номер
- `contact_persons[].email` — Электронная почта
- `schedule_summary` — Текстовое описание времени работы
- `address_type` — Тип адреса * `1` — Склад * `2` — Офис * `3` — Магазин

**Пример ответа (4XX)**

```json
{
  "error_code": "string",
  "reason": "string"
}
```

**Описание полей ответа**
- `error_code` — Код ошибки
- `reason` — Причина ошибки

<a id="post-catalogs-v1.2-organizations-addresses"></a>

**Версия: OAuth2.0 v2**

Добавление адреса

**Пример запроса (curl):**

```bash
curl 'https://api.ati.su/gw/oauth2/catalogs/v1.2/organizations/addresses' \
  -X 'POST' \
  -H 'Authorization: Bearer {authorizationToken}' \
  -H 'Content-Type: application/json' \
  --data-raw '{
  "address": "string",
  "address_city_id": 0,
  "address_latitude": 0.5,
  "address_longitude": 0.5,
  "note": "string",
  "schedule_summary": "string",
  "address_type": 0,
  "contact_person_ids": [
    "3fa85f64-5717-4562-b3fc-2c963f66afa6"
  ]
}'
```

**OpenAPI схема:** [JSON](https://ati.su/developers/raw/api/catalogs/organizations.openapi.json)

**Описание полей запроса**
- `address` — Адрес
- `address_city_id` — ID города. Значение из [словаря](https://ati.su/developers/api/dictionaries/geo/)
- `address_latitude` — Координаты адреса: широта
- `address_longitude` — Координаты адреса: долгота
- `note` — Примечание
- `schedule_summary` — Текстовое описание времени работы
- `address_type` — Тип адреса * `1` — Склад * `2` — Офис * `3` — Магазин
- `contact_person_ids` — ID контактных лиц

**Пример ответа (200)**

```json
{
  "id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
  "address": "string",
  "address_city_id": 0,
  "address_latitude": 0.5,
  "address_longitude": 0.5,
  "note": "string",
  "contact_persons": [
    {
      "id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
      "name": "string",
      "phone": "string",
      "extra_phone": 0,
      "email": "string"
    }
  ],
  "schedule_summary": "string",
  "address_type": 0
}
```

**Описание полей ответа**
- `id` — ID адреса
- `address` — Адрес
- `address_city_id` — ID города. Значение из [словаря](https://ati.su/developers/api/dictionaries/geo/)
- `address_latitude` — Координаты адреса: широта
- `address_longitude` — Координаты адреса: долгота
- `note` — Примечание
- `contact_persons` — Контакты адреса
- `contact_persons[].id` — ID контакного лица
- `contact_persons[].name` — ФИО
- `contact_persons[].phone` — Телефон
- `contact_persons[].extra_phone` — Добавочный номер
- `contact_persons[].email` — Электронная почта
- `schedule_summary` — Текстовое описание времени работы
- `address_type` — Тип адреса * `1` — Склад * `2` — Офис * `3` — Магазин

**Пример ответа (4XX)**

```json
{
  "error_code": "string",
  "reason": "string"
}
```

**Описание полей ответа**
- `error_code` — Код ошибки
- `reason` — Причина ошибки


<a id="get-v1.2-catalogs-organizations-addresses-{addressId}"></a>

**Версия: OAuth2.0 v1**

Получение адреса пользователя по id

**Пример запроса (curl):**

```bash
curl 'https://api.ati.su/v1.2/catalogs/organizations/addresses/3fa85f64-5717-4562-b3fc-2c963f66afa6' \
  -X 'GET' \
  -H 'Authorization: Bearer {authorizationToken}' \
  -H 'Content-Type: application/json'
```

**OpenAPI схема:** [JSON](https://ati.su/developers/raw/api/catalogs/organizations.openapi.json)

**Пример ответа (200)**

```json
{
  "id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
  "address": "string",
  "address_city_id": 0,
  "address_latitude": 0.5,
  "address_longitude": 0.5,
  "note": "string",
  "contact_persons": [
    {
      "id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
      "name": "string",
      "phone": "string",
      "extra_phone": 0,
      "email": "string"
    }
  ],
  "schedule_summary": "string",
  "address_type": 0
}
```

**Описание полей ответа**
- `id` — ID адреса
- `address` — Адрес
- `address_city_id` — ID города. Значение из [словаря](https://ati.su/developers/api/dictionaries/geo/)
- `address_latitude` — Координаты адреса: широта
- `address_longitude` — Координаты адреса: долгота
- `note` — Примечание
- `contact_persons` — Контакты адреса
- `contact_persons[].id` — ID контакного лица
- `contact_persons[].name` — ФИО
- `contact_persons[].phone` — Телефон
- `contact_persons[].extra_phone` — Добавочный номер
- `contact_persons[].email` — Электронная почта
- `schedule_summary` — Текстовое описание времени работы
- `address_type` — Тип адреса * `1` — Склад * `2` — Офис * `3` — Магазин

**Пример ответа (4XX)**

```json
{
  "error_code": "string",
  "reason": "string"
}
```

**Описание полей ответа**
- `error_code` — Код ошибки
- `reason` — Причина ошибки

<a id="get-catalogs-v1.2-organizations-addresses-{addressId}"></a>

**Версия: OAuth2.0 v2**

Получение адреса пользователя по id

**Пример запроса (curl):**

```bash
curl 'https://api.ati.su/gw/oauth2/catalogs/v1.2/organizations/addresses/3fa85f64-5717-4562-b3fc-2c963f66afa6' \
  -X 'GET' \
  -H 'Authorization: Bearer {authorizationToken}' \
  -H 'Content-Type: application/json'
```

**OpenAPI схема:** [JSON](https://ati.su/developers/raw/api/catalogs/organizations.openapi.json)

**Пример ответа (200)**

```json
{
  "id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
  "address": "string",
  "address_city_id": 0,
  "address_latitude": 0.5,
  "address_longitude": 0.5,
  "note": "string",
  "contact_persons": [
    {
      "id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
      "name": "string",
      "phone": "string",
      "extra_phone": 0,
      "email": "string"
    }
  ],
  "schedule_summary": "string",
  "address_type": 0
}
```

**Описание полей ответа**
- `id` — ID адреса
- `address` — Адрес
- `address_city_id` — ID города. Значение из [словаря](https://ati.su/developers/api/dictionaries/geo/)
- `address_latitude` — Координаты адреса: широта
- `address_longitude` — Координаты адреса: долгота
- `note` — Примечание
- `contact_persons` — Контакты адреса
- `contact_persons[].id` — ID контакного лица
- `contact_persons[].name` — ФИО
- `contact_persons[].phone` — Телефон
- `contact_persons[].extra_phone` — Добавочный номер
- `contact_persons[].email` — Электронная почта
- `schedule_summary` — Текстовое описание времени работы
- `address_type` — Тип адреса * `1` — Склад * `2` — Офис * `3` — Магазин

**Пример ответа (4XX)**

```json
{
  "error_code": "string",
  "reason": "string"
}
```

**Описание полей ответа**
- `error_code` — Код ошибки
- `reason` — Причина ошибки


<a id="put-v1.2-catalogs-organizations-addresses-{addressId}"></a>

**Версия: OAuth2.0 v1**

Изменение адреса

**Пример запроса (curl):**

```bash
curl 'https://api.ati.su/v1.2/catalogs/organizations/addresses/3fa85f64-5717-4562-b3fc-2c963f66afa6' \
  -X 'PUT' \
  -H 'Authorization: Bearer {authorizationToken}' \
  -H 'Content-Type: application/json' \
  --data-raw '{
  "address": "string",
  "address_city_id": 0,
  "address_latitude": 0.5,
  "address_longitude": 0.5,
  "note": "string",
  "schedule_summary": "string",
  "address_type": 0,
  "contact_person_ids": [
    "3fa85f64-5717-4562-b3fc-2c963f66afa6"
  ]
}'
```

**OpenAPI схема:** [JSON](https://ati.su/developers/raw/api/catalogs/organizations.openapi.json)

**Описание полей запроса**
- `address` — Адрес
- `address_city_id` — ID города. Значение из [словаря](https://ati.su/developers/api/dictionaries/geo/)
- `address_latitude` — Координаты адреса: широта
- `address_longitude` — Координаты адреса: долгота
- `note` — Примечание
- `schedule_summary` — Текстовое описание времени работы
- `address_type` — Тип адреса * `1` — Склад * `2` — Офис * `3` — Магазин
- `contact_person_ids` — ID контактных лиц

**Пример ответа (200)**

```json
{
  "id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
  "address": "string",
  "address_city_id": 0,
  "address_latitude": 0.5,
  "address_longitude": 0.5,
  "note": "string",
  "contact_persons": [
    {
      "id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
      "name": "string",
      "phone": "string",
      "extra_phone": 0,
      "email": "string"
    }
  ],
  "schedule_summary": "string",
  "address_type": 0
}
```

**Описание полей ответа**
- `id` — ID адреса
- `address` — Адрес
- `address_city_id` — ID города. Значение из [словаря](https://ati.su/developers/api/dictionaries/geo/)
- `address_latitude` — Координаты адреса: широта
- `address_longitude` — Координаты адреса: долгота
- `note` — Примечание
- `contact_persons` — Контакты адреса
- `contact_persons[].id` — ID контакного лица
- `contact_persons[].name` — ФИО
- `contact_persons[].phone` — Телефон
- `contact_persons[].extra_phone` — Добавочный номер
- `contact_persons[].email` — Электронная почта
- `schedule_summary` — Текстовое описание времени работы
- `address_type` — Тип адреса * `1` — Склад * `2` — Офис * `3` — Магазин

**Пример ответа (4XX)**

```json
{
  "error_code": "string",
  "reason": "string"
}
```

**Описание полей ответа**
- `error_code` — Код ошибки
- `reason` — Причина ошибки

<a id="put-catalogs-v1.2-organizations-addresses-{addressId}"></a>

**Версия: OAuth2.0 v2**

Изменение адреса

**Пример запроса (curl):**

```bash
curl 'https://api.ati.su/gw/oauth2/catalogs/v1.2/organizations/addresses/3fa85f64-5717-4562-b3fc-2c963f66afa6' \
  -X 'PUT' \
  -H 'Authorization: Bearer {authorizationToken}' \
  -H 'Content-Type: application/json' \
  --data-raw '{
  "address": "string",
  "address_city_id": 0,
  "address_latitude": 0.5,
  "address_longitude": 0.5,
  "note": "string",
  "schedule_summary": "string",
  "address_type": 0,
  "contact_person_ids": [
    "3fa85f64-5717-4562-b3fc-2c963f66afa6"
  ]
}'
```

**OpenAPI схема:** [JSON](https://ati.su/developers/raw/api/catalogs/organizations.openapi.json)

**Описание полей запроса**
- `address` — Адрес
- `address_city_id` — ID города. Значение из [словаря](https://ati.su/developers/api/dictionaries/geo/)
- `address_latitude` — Координаты адреса: широта
- `address_longitude` — Координаты адреса: долгота
- `note` — Примечание
- `schedule_summary` — Текстовое описание времени работы
- `address_type` — Тип адреса * `1` — Склад * `2` — Офис * `3` — Магазин
- `contact_person_ids` — ID контактных лиц

**Пример ответа (200)**

```json
{
  "id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
  "address": "string",
  "address_city_id": 0,
  "address_latitude": 0.5,
  "address_longitude": 0.5,
  "note": "string",
  "contact_persons": [
    {
      "id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
      "name": "string",
      "phone": "string",
      "extra_phone": 0,
      "email": "string"
    }
  ],
  "schedule_summary": "string",
  "address_type": 0
}
```

**Описание полей ответа**
- `id` — ID адреса
- `address` — Адрес
- `address_city_id` — ID города. Значение из [словаря](https://ati.su/developers/api/dictionaries/geo/)
- `address_latitude` — Координаты адреса: широта
- `address_longitude` — Координаты адреса: долгота
- `note` — Примечание
- `contact_persons` — Контакты адреса
- `contact_persons[].id` — ID контакного лица
- `contact_persons[].name` — ФИО
- `contact_persons[].phone` — Телефон
- `contact_persons[].extra_phone` — Добавочный номер
- `contact_persons[].email` — Электронная почта
- `schedule_summary` — Текстовое описание времени работы
- `address_type` — Тип адреса * `1` — Склад * `2` — Офис * `3` — Магазин

**Пример ответа (4XX)**

```json
{
  "error_code": "string",
  "reason": "string"
}
```

**Описание полей ответа**
- `error_code` — Код ошибки
- `reason` — Причина ошибки


<a id="delete-v1.2-catalogs-organizations-addresses-{addressId}"></a>

**Версия: OAuth2.0 v1**

Удаление адреса

**Пример запроса (curl):**

```bash
curl 'https://api.ati.su/v1.2/catalogs/organizations/addresses/3fa85f64-5717-4562-b3fc-2c963f66afa6' \
  -X 'DELETE' \
  -H 'Authorization: Bearer {authorizationToken}' \
  -H 'Content-Type: application/json'
```

**OpenAPI схема:** [JSON](https://ati.su/developers/raw/api/catalogs/organizations.openapi.json)

**Пример ответа (4XX)**

```json
{
  "error_code": "string",
  "reason": "string"
}
```

**Описание полей ответа**
- `error_code` — Код ошибки
- `reason` — Причина ошибки

<a id="delete-catalogs-v1.2-organizations-addresses-{addressId}"></a>

**Версия: OAuth2.0 v2**

Удаление адреса

**Пример запроса (curl):**

```bash
curl 'https://api.ati.su/gw/oauth2/catalogs/v1.2/organizations/addresses/3fa85f64-5717-4562-b3fc-2c963f66afa6' \
  -X 'DELETE' \
  -H 'Authorization: Bearer {authorizationToken}' \
  -H 'Content-Type: application/json'
```

**OpenAPI схема:** [JSON](https://ati.su/developers/raw/api/catalogs/organizations.openapi.json)

**Пример ответа (4XX)**

```json
{
  "error_code": "string",
  "reason": "string"
}
```

**Описание полей ответа**
- `error_code` — Код ошибки
- `reason` — Причина ошибки


<a id="get-v1.2-catalogs-organizations-addresses-types"></a>

**Версия: OAuth2.0 v1**

Получение типов адресов

**Пример запроса (curl):**

```bash
curl 'https://api.ati.su/v1.2/catalogs/organizations/addresses/types' \
  -X 'GET' \
  -H 'Authorization: Bearer {authorizationToken}' \
  -H 'Content-Type: application/json'
```

**OpenAPI схема:** [JSON](https://ati.su/developers/raw/api/catalogs/organizations.openapi.json)

**Пример ответа (200)**

```json
[
  {
    "id": 0,
    "name": "string",
    "name_eng": "string"
  }
]
```

**Описание полей ответа**
- `[].id` — Тип адреса * `1` — Склад * `2` — Офис * `3` — Магазин

**Пример ответа (4XX)**

```json
{
  "error_code": "string",
  "reason": "string"
}
```

**Описание полей ответа**
- `error_code` — Код ошибки
- `reason` — Причина ошибки

<a id="get-catalogs-v1.2-organizations-addresses-types"></a>

**Версия: OAuth2.0 v2**

Получение типов адресов

**Пример запроса (curl):**

```bash
curl 'https://api.ati.su/gw/oauth2/catalogs/v1.2/organizations/addresses/types' \
  -X 'GET' \
  -H 'Authorization: Bearer {authorizationToken}' \
  -H 'Content-Type: application/json'
```

**OpenAPI схема:** [JSON](https://ati.su/developers/raw/api/catalogs/organizations.openapi.json)

**Пример ответа (200)**

```json
[
  {
    "id": 0,
    "name": "string",
    "name_eng": "string"
  }
]
```

**Описание полей ответа**
- `[].id` — Тип адреса * `1` — Склад * `2` — Офис * `3` — Магазин

**Пример ответа (4XX)**

```json
{
  "error_code": "string",
  "reason": "string"
}
```

**Описание полей ответа**
- `error_code` — Код ошибки
- `reason` — Причина ошибки


### Методы для работы с контактными лицами организаций

<a id="get-v1.2-catalogs-organizations-contactPersons"></a>

**Версия: OAuth2.0 v1**

Получение всех контактных лиц пользователя

**Пример запроса (curl):**

```bash
curl 'https://api.ati.su/v1.2/catalogs/organizations/contactPersons' \
  -X 'GET' \
  -H 'Authorization: Bearer {authorizationToken}' \
  -H 'Content-Type: application/json'
```

**OpenAPI схема:** [JSON](https://ati.su/developers/raw/api/catalogs/organizations.openapi.json)

**Пример ответа (200)**

```json
[
  {
    "id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
    "name": "string",
    "phone": "string",
    "extra_phone": 0,
    "email": "string"
  }
]
```

**Описание полей ответа**
- `[].id` — ID контакного лица
- `[].name` — ФИО
- `[].phone` — Телефон
- `[].extra_phone` — Добавочный номер
- `[].email` — Электронная почта

**Пример ответа (4XX)**

```json
{
  "error_code": "string",
  "reason": "string"
}
```

**Описание полей ответа**
- `error_code` — Код ошибки
- `reason` — Причина ошибки

<a id="get-catalogs-v1.2-organizations-contactPersons"></a>

**Версия: OAuth2.0 v2**

Получение всех контактных лиц пользователя

**Пример запроса (curl):**

```bash
curl 'https://api.ati.su/gw/oauth2/catalogs/v1.2/organizations/contactPersons' \
  -X 'GET' \
  -H 'Authorization: Bearer {authorizationToken}' \
  -H 'Content-Type: application/json'
```

**OpenAPI схема:** [JSON](https://ati.su/developers/raw/api/catalogs/organizations.openapi.json)

**Пример ответа (200)**

```json
[
  {
    "id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
    "name": "string",
    "phone": "string",
    "extra_phone": 0,
    "email": "string"
  }
]
```

**Описание полей ответа**
- `[].id` — ID контакного лица
- `[].name` — ФИО
- `[].phone` — Телефон
- `[].extra_phone` — Добавочный номер
- `[].email` — Электронная почта

**Пример ответа (4XX)**

```json
{
  "error_code": "string",
  "reason": "string"
}
```

**Описание полей ответа**
- `error_code` — Код ошибки
- `reason` — Причина ошибки


<a id="post-v1.2-catalogs-organizations-contactPersons"></a>

**Версия: OAuth2.0 v1**

Добавление контактного лица пользователя

**Пример запроса (curl):**

```bash
curl 'https://api.ati.su/v1.2/catalogs/organizations/contactPersons' \
  -X 'POST' \
  -H 'Authorization: Bearer {authorizationToken}' \
  -H 'Content-Type: application/json' \
  --data-raw '{
  "name": "string",
  "phone": "string",
  "extra_phone": 0,
  "email": "string"
}'
```

**OpenAPI схема:** [JSON](https://ati.su/developers/raw/api/catalogs/organizations.openapi.json)

**Описание полей запроса**
- `name` — ФИО
- `phone` — Телефон
- `extra_phone` — Добавочный номер
- `email` — Электронная почта

**Пример ответа (200)**

```json
{
  "id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
  "name": "string",
  "phone": "string",
  "extra_phone": 0,
  "email": "string"
}
```

**Описание полей ответа**
- `id` — ID контакного лица
- `name` — ФИО
- `phone` — Телефон
- `extra_phone` — Добавочный номер
- `email` — Электронная почта

**Пример ответа (4XX)**

```json
{
  "error_code": "string",
  "reason": "string"
}
```

**Описание полей ответа**
- `error_code` — Код ошибки
- `reason` — Причина ошибки

<a id="post-catalogs-v1.2-organizations-contactPersons"></a>

**Версия: OAuth2.0 v2**

Добавление контактного лица пользователя

**Пример запроса (curl):**

```bash
curl 'https://api.ati.su/gw/oauth2/catalogs/v1.2/organizations/contactPersons' \
  -X 'POST' \
  -H 'Authorization: Bearer {authorizationToken}' \
  -H 'Content-Type: application/json' \
  --data-raw '{
  "name": "string",
  "phone": "string",
  "extra_phone": 0,
  "email": "string"
}'
```

**OpenAPI схема:** [JSON](https://ati.su/developers/raw/api/catalogs/organizations.openapi.json)

**Описание полей запроса**
- `name` — ФИО
- `phone` — Телефон
- `extra_phone` — Добавочный номер
- `email` — Электронная почта

**Пример ответа (200)**

```json
{
  "id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
  "name": "string",
  "phone": "string",
  "extra_phone": 0,
  "email": "string"
}
```

**Описание полей ответа**
- `id` — ID контакного лица
- `name` — ФИО
- `phone` — Телефон
- `extra_phone` — Добавочный номер
- `email` — Электронная почта

**Пример ответа (4XX)**

```json
{
  "error_code": "string",
  "reason": "string"
}
```

**Описание полей ответа**
- `error_code` — Код ошибки
- `reason` — Причина ошибки


<a id="get-v1.2-catalogs-organizations-contactPersons-{contactPersonId}"></a>

**Версия: OAuth2.0 v1**

Получение контактного лица пользователя по id

**Пример запроса (curl):**

```bash
curl 'https://api.ati.su/v1.2/catalogs/organizations/contactPersons/3fa85f64-5717-4562-b3fc-2c963f66afa6' \
  -X 'GET' \
  -H 'Authorization: Bearer {authorizationToken}' \
  -H 'Content-Type: application/json'
```

**OpenAPI схема:** [JSON](https://ati.su/developers/raw/api/catalogs/organizations.openapi.json)

**Пример ответа (200)**

```json
{
  "id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
  "name": "string",
  "phone": "string",
  "extra_phone": 0,
  "email": "string"
}
```

**Описание полей ответа**
- `id` — ID контакного лица
- `name` — ФИО
- `phone` — Телефон
- `extra_phone` — Добавочный номер
- `email` — Электронная почта

**Пример ответа (4XX)**

```json
{
  "error_code": "string",
  "reason": "string"
}
```

**Описание полей ответа**
- `error_code` — Код ошибки
- `reason` — Причина ошибки

<a id="get-catalogs-v1.2-organizations-contactPersons-{contactPersonId}"></a>

**Версия: OAuth2.0 v2**

Получение контактного лица пользователя по id

**Пример запроса (curl):**

```bash
curl 'https://api.ati.su/gw/oauth2/catalogs/v1.2/organizations/contactPersons/3fa85f64-5717-4562-b3fc-2c963f66afa6' \
  -X 'GET' \
  -H 'Authorization: Bearer {authorizationToken}' \
  -H 'Content-Type: application/json'
```

**OpenAPI схема:** [JSON](https://ati.su/developers/raw/api/catalogs/organizations.openapi.json)

**Пример ответа (200)**

```json
{
  "id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
  "name": "string",
  "phone": "string",
  "extra_phone": 0,
  "email": "string"
}
```

**Описание полей ответа**
- `id` — ID контакного лица
- `name` — ФИО
- `phone` — Телефон
- `extra_phone` — Добавочный номер
- `email` — Электронная почта

**Пример ответа (4XX)**

```json
{
  "error_code": "string",
  "reason": "string"
}
```

**Описание полей ответа**
- `error_code` — Код ошибки
- `reason` — Причина ошибки


<a id="put-v1.2-catalogs-organizations-contactPersons-{contactPersonId}"></a>

**Версия: OAuth2.0 v1**

Изменение контактного лица пользователя

**Пример запроса (curl):**

```bash
curl 'https://api.ati.su/v1.2/catalogs/organizations/contactPersons/3fa85f64-5717-4562-b3fc-2c963f66afa6' \
  -X 'PUT' \
  -H 'Authorization: Bearer {authorizationToken}' \
  -H 'Content-Type: application/json' \
  --data-raw '{
  "name": "string",
  "phone": "string",
  "extra_phone": 0,
  "email": "string"
}'
```

**OpenAPI схема:** [JSON](https://ati.su/developers/raw/api/catalogs/organizations.openapi.json)

**Описание полей запроса**
- `name` — ФИО
- `phone` — Телефон
- `extra_phone` — Добавочный номер
- `email` — Электронная почта

**Пример ответа (200)**

```json
{
  "id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
  "name": "string",
  "phone": "string",
  "extra_phone": 0,
  "email": "string"
}
```

**Описание полей ответа**
- `id` — ID контакного лица
- `name` — ФИО
- `phone` — Телефон
- `extra_phone` — Добавочный номер
- `email` — Электронная почта

**Пример ответа (4XX)**

```json
{
  "error_code": "string",
  "reason": "string"
}
```

**Описание полей ответа**
- `error_code` — Код ошибки
- `reason` — Причина ошибки

<a id="put-catalogs-v1.2-organizations-contactPersons-{contactPersonId}"></a>

**Версия: OAuth2.0 v2**

Изменение контактного лица пользователя

**Пример запроса (curl):**

```bash
curl 'https://api.ati.su/gw/oauth2/catalogs/v1.2/organizations/contactPersons/3fa85f64-5717-4562-b3fc-2c963f66afa6' \
  -X 'PUT' \
  -H 'Authorization: Bearer {authorizationToken}' \
  -H 'Content-Type: application/json' \
  --data-raw '{
  "name": "string",
  "phone": "string",
  "extra_phone": 0,
  "email": "string"
}'
```

**OpenAPI схема:** [JSON](https://ati.su/developers/raw/api/catalogs/organizations.openapi.json)

**Описание полей запроса**
- `name` — ФИО
- `phone` — Телефон
- `extra_phone` — Добавочный номер
- `email` — Электронная почта

**Пример ответа (200)**

```json
{
  "id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
  "name": "string",
  "phone": "string",
  "extra_phone": 0,
  "email": "string"
}
```

**Описание полей ответа**
- `id` — ID контакного лица
- `name` — ФИО
- `phone` — Телефон
- `extra_phone` — Добавочный номер
- `email` — Электронная почта

**Пример ответа (4XX)**

```json
{
  "error_code": "string",
  "reason": "string"
}
```

**Описание полей ответа**
- `error_code` — Код ошибки
- `reason` — Причина ошибки


<a id="delete-v1.2-catalogs-organizations-contactPersons-{contactPersonId}"></a>

**Версия: OAuth2.0 v1**

Удаление контактного лица пользователя

**Пример запроса (curl):**

```bash
curl 'https://api.ati.su/v1.2/catalogs/organizations/contactPersons/3fa85f64-5717-4562-b3fc-2c963f66afa6' \
  -X 'DELETE' \
  -H 'Authorization: Bearer {authorizationToken}' \
  -H 'Content-Type: application/json'
```

**OpenAPI схема:** [JSON](https://ati.su/developers/raw/api/catalogs/organizations.openapi.json)

**Пример ответа (4XX)**

```json
{
  "error_code": "string",
  "reason": "string"
}
```

**Описание полей ответа**
- `error_code` — Код ошибки
- `reason` — Причина ошибки

<a id="delete-catalogs-v1.2-organizations-contactPersons-{contactPersonId}"></a>

**Версия: OAuth2.0 v2**

Удаление контактного лица пользователя

**Пример запроса (curl):**

```bash
curl 'https://api.ati.su/gw/oauth2/catalogs/v1.2/organizations/contactPersons/3fa85f64-5717-4562-b3fc-2c963f66afa6' \
  -X 'DELETE' \
  -H 'Authorization: Bearer {authorizationToken}' \
  -H 'Content-Type: application/json'
```

**OpenAPI схема:** [JSON](https://ati.su/developers/raw/api/catalogs/organizations.openapi.json)

**Пример ответа (4XX)**

```json
{
  "error_code": "string",
  "reason": "string"
}
```

**Описание полей ответа**
- `error_code` — Код ошибки
- `reason` — Причина ошибки
---

## llms.txt

Индекс ключевых страниц документации для LLM и AI-агентов доступен в [основном llms.txt](https://ati.su/developers/llms.txt).