История сервисного обслуживания ТС

A.0077.SRV.HIS

Содержит информацию о сервисных работах от дилерских и сервисных центров.

Период обновлений — в среднем 1 неделя, с каждым поставщиком период устанавливается индивидуально.

Идентификаторы объекта: VIN.

Иcпользуемые источники: service.history, service.history.fitservice, service.history.filter, service.history.wilgood.

Время генерации отчёта:

  • 50-й перцентиль — 2 с;
  • 95-й перцентиль — 2 с.

Параметры запроса

При отправке запроса на генерацию отчёта в теле запроса указываются следующие параметры:

Параметр Тип Обязательность Описание
queryType string Обязательный Тип идентификатора ТС.
Возможные значения: VIN
query string Обязательный Значение идентификатора ТС

Пример тела запроса

{
  "queryType": "VIN",
  "query": "EXAMPL0V1N1000000"
}

Структура отчёта

Данные отчёта находятся в объекте data[].content.service_history тела ответа.

Все даты в отчёте указываются в формате YYYY-MM-DD hh:mm:ss.

Поле Тип Описание
items[].dealer.name string Наименование автодилера
items[].dealer.branch.name string Наименование СТО
items[].date.start string Дата начала работ
items[].date.end string Дата окончания работ
items[].amount.value number Сумма за выполненные работы
items[].amount.currency string Тип валюты.
Справочник значений
items[].type string Тип услуги.
Справочник значений
items[].service.type string Тип сервисных работ.
Справочник значений
items[].service.content array Список сервисных работ СТО
items[].service.spare_parts array Список запасных частей для сервисных работ
items[].service.recommendations array Список рекомендованных работ СТО
items[].service.is_planned boolean Признак плановых сервисных работ
items[].client.type string Тип клиента.
Справочник значений
items[].geo object Геоданные места нахождения СТО
items[].vehicle.brand.name string Наименование марки (бренда) ТС
items[].vehicle.model.name string Модель ТС
items[].vehicle.year integer Год выпуска ТС
items[].vehicle.mileage integer Значение пробега ТС
items[].vehicle.body.doors integer Количество дверей у ТС
items[].vehicle.body.type string Тип кузова ТС.
Возможные значения: СЕДАН, ХЭТЧБЭК, УНИВЕРСАЛ, КАБРИОЛЕТ, КРОССОВЕР, КУПЕ, ЛИМУЗИН, МИНИВЭН, ПИКАП, ВАГОН, МИКРОАВТОБУС, ФУРГОН, ВНЕДОРОЖНИК, ПРОЧЕЕ
items[].vehicle.body.color string Цвет кузова ТС
items[].vehicle.engine.number string Номер двигателя ТС
items[].vehicle.engine.type string Тип топлива.
Возможные значения: БЕНЗИНОВЫЙ, ДИЗЕЛЬНЫЙ, ГИБРИДНЫЙ, ЭЛЕКТРО
items[].vehicle.engine.volume number Объём двигателя ТС
items[].vehicle.engine.power.hp number Мощность двигателя, л. с.
items[].vehicle.transmission.type string Тип трансмиссии.
Возможные значения: РУЧНАЯ, АВТОМАТИЧЕСКАЯ, ВАРИАТОР, РОБОТ
items[].vehicle.wheel.position string Расположение руля.
Возможные значения: ЛЕВЫЙ, ПРАВЫЙ
items[].vehicle.drive.type string Тип привода.
Возможные значения: ПЕРЕДНИЙ, ЗАДНИЙ, ПОЛНЫЙ
items[].vehicle.notes array Дополнительная информация по комплектации ТС
items[].vehicle.equipment.type string Описание комплектации ТС
items[].vehicle.identifiers.body string Номер кузова
items[].vehicle.identifiers.vin string VIN ТС
items[].vehicle.identifiers.chassis string Номер шасси
date.update string Дата обновления данных
count integer Количество найденных записей об истории сервисного обслуживания

Геоданные места нахождения СТО

Поле Тип Описание
country string Страна
region string Регион (область)
city string Город
street string Улица
house string Дом

Справочник Тип валюты

Значение Описание
RUB Российский рубль
EUR Евро
USD Доллар США

Справочник Тип услуги

Значение Описание
SERVICE Сервисные работы
SALE Продажа
INSURANCE Страхование
EQUIPMENT Установка дополнительного оборудования

Справочник Тип сервисных работ

Значение Описание
GUARANTEE Ремонт по гарантии
BODY_INSURANCE Кузовной ремонт за счёт страховой компании
ORDINARY_INSURANCE Текущий ремонт за счёт страховой компании
BODY_PAID Кузовной ремонт за свой счёт
ORDINARY_PAID Текущий ремонт за свой счёт
ORDINARY_DEALER Текущий ремонт за счёт дилера
REGULATION Регламентное ТО

Справочник Тип клиента

Значение Описание
PERSON Физическое лицо
LEGAL Юридическое лицо
LEASING Лизинг

Пример данных отчёта

{
  "data": [
    {
      "report_type_uid": "A.0077.SRV.HIS_test_report@test_domain",
      "progress_ok": 4,
      "progress_wait": 0,
      "progress_error": 0,
      "state": {
        "sources": [
          {
            "_id": "service.history",
            "state": "OK",
            "extended_state": "OK"
          },
          {
            "_id": "service.history.filter",
            "state": "OK",
            "extended_state": "OK"
          },
          {
            "_id": "service.history.fitservice",
            "state": "OK",
            "extended_state": "OK"
          },
          {
            "_id": "service.history.wilgood",
            "state": "OK",
            "extended_state": "OK"
          }
        ]
      },
      "content": {
        "service_history": {
          "items": [
            {
              "dealer": {
                "name": "euroauto",
                "branch": {
                  "name": "CTO Испытателей"
                }
              },
              "date": {
                "end": "2018-01-21 00:00:00"
              },
              "amount": {
                "currency": "RUB"
              },
              "type": "SERVICE",
              "service": {
                "content": [
                  "Проверка работы омывателя ветрового стекла",
                  "Визуальный контроль приводных ремней",
                  "Проверка щеток стеклоочистителя",
                  "Диагностика состояния АКБ"
                ],
                "spare_parts": [
                  "Лампа"
                ],
                "recommendations": [
                  "Диск тормозной передний вентилируемый - Замена",
                  "Колодки тормозные передние к-кт - Замена",
                  "Разъем - Замена"
                ],
                "is_planned": false
              },
              "client": {
                "type": "PERSON"
              },
              "geo": {
                "region": "Санкт-Петербург",
                "city": "Санкт-Петербург"
              },
              "vehicle": {
                "brand": {
                  "name": "Mazda"
                },
                "model": {
                  "name": "Mazda 3 (BK)"
                },
                "year": 2008,
                "mileage": 75893,
                "body": {
                  "color": "Белый"
                },
                "engine": {
                  "type": "БЕНЗИНОВЫЙ"
                },
                "transmission": {
                  "type": "АВТОМАТИЧЕСКАЯ"
                },
                "notes": [],
                "identifiers": {
                  "vin": "EXAMPL0V1N1000000"
                }
              }
            }
          ],
          "date": {
            "update": "2019-05-12 22:10:00"
          },
          "count": 1
        }
      }
    }
  ]
}