# API для работы со Справочниками пользователя

В данном разделе вы можете найти методы для работы с Автопарком, Водителями, Организациями, а также со Списками фирм и направлений:

- [API для работы с Автопарком](https://ati.su/developers/raw/api/catalogs/autopark.md#методы-для-работы-с-автопарком);
- [API для работы с Водителями](https://ati.su/developers/raw/api/catalogs/autopark.md#методы-для-работы-с-водителями);
- [API для работы с Организациями](https://ati.su/developers/raw/api/catalogs/organizations.md);
- [API для работы с Поиском краткой инфорации о фирмах](https://ati.su/developers/raw/api/catalogs/firm-search.md);
- [API для работы со Списками фирм](https://ati.su/developers/raw/api/catalogs/firm-lists.md);
- [API для работы со Списками направлений](https://ati.su/developers/raw/api/catalogs/geo-lists.md).

Данные методы нужны для заполнения [Справочников](https://help.ati.su/avtopark), которые будут использоваться при работе с:

- [Заказами](https://help.ati.su/bezogovorochnye-sdelki). Например, вы сможете использовать предварительно добавленные ТС и Водителей для быстрого взятия груза и оформления сделки.
- [Грузами](https://help.ati.su/kak-dobavljat-i-redaktirovat-gruzy). Например, если вы захотите включить режим [Стелс](https://help.ati.su/kak-vkljuchit-stels-chtoby-skryt-gruz-ot-nezhelatelnyh-firm) при добавлении груза, чтобы скрыть груз от нежелательных фирм, вам пригодятся Списки фирм.

### Автопарк

[API для работы с Автопарком](https://ati.su/developers/raw/api/catalogs/autopark.md#методы-для-работы-с-автопарком)

Представляет собой справочник данных по машинам, которые перевозчик заполняет во время отправки предложения грузовладельцу. Содержит 4 типа ТС (транспортных средств):

- грузовики;
- тягачи;
- полуприцепы;
- прицепы.

### Автопоезд (Автомобильный поезд)

В Автопарке имеется возможность создать комбинированное ТС - поезд, состоящий из автомобиля-тягача и прицепа или полуприцепа. Доступны следующие комбинации:

- грузовик + прицеп;
- тягач + полуприцеп;
- тягач + полуприцеп + прицеп.

Для создания автопоезда воспользуйтесь [методом создания связей](https://ati.su/developers/raw/api/catalogs/autopark.md#метод-для-работы-со-связями-сущностей-справочников).

### Водители

[API для работы с Водителями](https://ati.su/developers/raw/api/catalogs/autopark.md#методы-для-работы-с-водителями);

Справочник данных по водителям, которые перевозчик заполняет во время отправки предложения грузовладельцу. Водитель также может быть привязан к ТС с помощью [метода создания связей](https://ati.su/developers/raw/api/catalogs/autopark.md#метод-для-работы-со-связями-сущностей-справочников).

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

[API для работы с Организациями](https://ati.su/developers/raw/api/catalogs/organizations.md)

Представляет собой справочник данных по организациям, которые грузовладелец заполняет при оформлении Заказа.

Организации — офисы, склады, магазины. Вы можете указать адрес организации, режим работы и контакты. Перевозчик увидит все детали в заявке и будет точно знать, куда ехать и к кому обращаться на загрузке или выгрузке.

Организации могут быть доступны всем подразделениям вашей фирмы или выбранным.

### Списки фирм

[API для работы со Списками фирм](https://ati.su/developers/raw/api/catalogs/firm-lists.md)

Списки фирм позволяют помечать участников ATI.SU для себя — с кем успешно сотрудничали, а с кем были проблемы.
Информация о списках и участниках доступна только вам. Добавленные фирмы не знают, что участвуют в ваших списках.

**Списки фирм могут быть**:

- **системными** - готовые варианты списков:
  - _партнёры-грузоотправители_ - фирмы, которым вы перевозили или готовы перевезти грузы;
  - _партнёры-перевозчики_ - фирмы, которым вы готовы доверить перевозку своих грузов;
  - _«черный» список_ - фирмы, с которыми вы не хотите работать и контактировать.
- **персональными (списки вашей фирмы)** - списки, созданные вами непосредственно для вашей фирмы, доступ к котором возможно ограничивать - они могут быть доступны как только вам, так и всем контактам вашей фирмы. Данные списки делятся на:
  - нейтральные;
  - партнерские;
  - негативные.

### Списки направлений

[API для работы со Списками направлений](https://ati.su/developers/raw/api/catalogs/geo-lists.md)

Списки направлений (стран, регионов, городов) позволяют создавать списки для перевозки, которые можно использовать при поиске Грузов и Машин. Если нужно найти грузы или машины сразу из нескольких городов, то вместо выполнения нескольких последовательных поисков можно создать список из этих городов и найти все подходящие грузы одним поиском с использованием этого списка.

На данный момент возможность поиска с использованием списков направлений возможна только на сайте ATI.SU: [поиск грузов](https://loads.ati.su/) / [поиск машин](https://trucks.ati.su/).

**Списки направлений также могут быть**:

- **системными** - стандартные списки от ATI.SU, которые доступны для использования всем участникам;
- **персональными (списки вашей фирмы)** - списки, созданные вами непосредственно для вашей фирмы, доступ к котором возможно ограничивать - они могут быть доступны как только вам, так и всем контактам вашей фирмы.