# Водители

События [Справочника Водителей](https://ati.su/developers/raw/api/catalogs/index.md#водители).

При возникновении события в системе ATI.SU, к вебхуку будет отправлен [POST запрос](https://ati.su/developers/raw/api/webhooks/index.md#получение-сообщений).
В параметре `entity` будет сущность темы подписки в соответствии с моделью, представленной на этой странице.

При удалении водителя, параметр `entity` будет принимать значение `null`.

Тема `catalogs.drivers`

**Пример**

```json
{
  "driver_id": "c063e1c5-a58f-4f6b-b805-62d0715f4fba",
  "first_name": "Иван",
  "second_name": "Иванов",
  "patronymic": "Иванович",
  "phone": {
    "phone": 0.5,
    "phone_string": "string",
    "presence": {
      "phone": 0.5,
      "initial_phone": "string",
      "last_active": "1970-01-01T00:00:00.000Z",
      "has_tracker": false,
      "sms_invite_status": {
        "invite_sent": false,
        "contact_name": "string",
        "firm_id": 0,
        "contact_id": 0,
        "sms_status": {},
        "when": "1970-01-01T00:00:00.000Z"
      }
    },
    "binding": {
      "status": {},
      "account_id": "string",
      "firm_name": "string",
      "owner_type": {}
    },
    "binding_type": {}
  },
  "driver_license_number": "77 77 123456",
  "driver_license_when_issued": "1970-01-01T00:00:00.000Z",
  "passport_series": "4010",
  "passport_number": "123456",
  "passport_issued_by": "УФМС России",
  "passport_when_issued": "2018-01-01",
  "registration": "гор. Санкт-Петербург",
  "is_attracted_driver": false,
  "related_id": "75fdfa06-287b-47ff-a6e7-1d9edfa5ac29",
  "last_deal_related_id": "75fdfa06-287b-47ff-a6e7-1d9edfa5ac29",
  "description": "Иванов Иван Иванович",
  "attracted_from": "ООО Название фирмы",
  "scans": [
    {
      "scan_id": "1bb60c95-957b-473f-b664-4026533fa5a9",
      "scan_owner_id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
      "scan_file_id": "string",
      "scan_path": "https://d.ati.su/api/next/filestorage/cf91cb04-80a1-4b97-8ea2-2f0ad3a4d579",
      "scan_name": "ВУ.pdf",
      "scan_type": 0
    }
  ],
  "date_of_birth": "1970-01-01T00:00:00.000Z",
  "department_code_in_passport": "string",
  "driver_inn": "string",
  "in_cargo_owner_black_list": false,
  "external_id": "string"
}
```

**Описание полей модели**
- `driver_id` — Id водителя
- `first_name` — Имя
- `second_name` — Фамилия
- `patronymic` — Отчество
- `phone` — Информация о номерe телефона водителя
- `phone.phone` — Номер телефона
- `phone.phone_string` — Номер телефона, как указан пользователем
- `phone.presence` — Статус приложения АТИ Водитель
- `phone.presence.phone` — Номер телефона, приведенный к числовому формату
- `phone.presence.initial_phone` — Номер телефона в том виде, в котором его указал пользователь
- `phone.presence.last_active` — Время последней активности в приложении
- `phone.presence.has_tracker` — Авторизация в приложении
- `phone.presence.sms_invite_status` — Статус приглашения в приложение
- `phone.presence.sms_invite_status.invite_sent` — Было ли отправлено приглашение
- `phone.presence.sms_invite_status.contact_name` — Имя пригласившего контакта
- `phone.presence.sms_invite_status.firm_id` — Id пригласившей фирмы
- `phone.presence.sms_invite_status.contact_id` — Id пригласившего контакт
- `phone.presence.sms_invite_status.sms_status` — Статус отправки СМС * `0` - Нет информации * `1` - Создано * `2` - Ошибка * `3` - Отправлено * `4` - Доставлено
- `phone.presence.sms_invite_status.when` — Время отправки SMS
- `phone.binding` — Информация об актуальной привязке
- `phone.binding.status` — Статус привязки * `0` - Эксклюзивный доступ * `1` - Запрос на эксклюзивный доступ * `2` - Запрос отклонен владельцем номера телефона * `3` - Фирма "уволила" владельца номера * `4` - Владелец номера "уволился" * `5` - Запрос удален
- `phone.binding.account_id` — Фирма, запрашивающая "Эксклюзивный доступ"
- `phone.binding.firm_name` — Название фирмы, запрашивающей "Эксклюзивный доступ"
- `phone.binding.owner_type` — Тип сущности, к которой привязан телефон * `0` — Водитель * `1` — ТС
- `phone.binding_type` — Тип привязки (Эксклюзивности) номера телефона * `0` - Номер не привязан * `1` - Номер привязан к водителю текущей фирмы * `2` - Номер привязан к ТС текущей фирмы * `3` - Номер привязан к водителю другой фирмы * `4` - Номер привязан к ТС другой фирмы
- `driver_license_number` — Номер водительского удостоверения
- `driver_license_when_issued` — Когда выдано водительское удостоверение
- `passport_series` — Серия паспорта
- `passport_number` — Номер паспорта
- `passport_issued_by` — Кем выдан
- `passport_when_issued` — Когда выдан
- `registration` — Прописка
- `is_attracted_driver` — Флаг привлеченного водителя (со стороны)
- `related_id` — Идентификатор связанного ТС, которое пользователь задал в кабинете
- `last_deal_related_id` — Идентификатор ТС, с которым был связан водитель во время выполнения последней сделки
- `description` — Краткое описание водителя
- `attracted_from` — Фирма от которой привлечен водитель.
- `scans` — Сканы документов водителя
- `scans[].scan_id` — Id скана
- `scans[].scan_path` — Адрес расположения файла скана в хранилище
- `scans[].scan_name` — Имя файла скана
- `scans[].scan_type` — Тип документа * `1` — Скан водительского удостоверения * `2` — Скан гражданского паспорта
- `date_of_birth` — Дата рождения
- `department_code_in_passport` — Код подразделения
- `driver_inn` — ИНН водителя
- `in_cargo_owner_black_list` — Есть в Черном списке у запрашиваемого грузовладельца
- `external_id` — Идентификатор