Перейти к основному содержимому

Сверка факта вывоза

Все методы вызываются запросом POST с заголовком Authorization: Bearer ваш_токен (см. «Авторизация для REST-запросов») и доступны ролям ROLE_ADMIN или ROLE_LK_ADMIN.

Суммарный объем за день​

/api/v1/lk/getVolumeReportGroupedByDay

Возвращает суммарные объемы двух видов, запланированные и фактические, по всем КП которые вывозились в указанный день.

PARAMSvalueКомментарий
dateFrom2024-05-20Дата с : format yyyy-MM-dd
dateTo2024-05-21Дата до : format yyyy-MM-dd

Пример запроса:\ curl --location --request POST --header 'Authorization: Bearer ваш_токен'

https://disp.t1.groupstp.ru/app/api/v1/lk/getVolumeReportGroupedByDay?dateFrom=2024-05-20&dateTo=2024-05-21

Результат
{
    "id": "e095b8bf-3db9-4b44-b7b3-f1d066747276",  // Рандомный id отчета (можно не использовать, на случай если нужно определить, что ответ не закеширован)
    "dateFrom": "2024-05-20",                      // Дата от
    "dateTo": "2024-05-21",                        // Дата до


    "volumes": [                                   // Объемы, сгруппированные по дням
        {
            "date": "2024-05-20",                  // Дата     
            "plan": 24661.999999999905,            // Запланированный объем
            "fact": 22366.499999999996             // Фактический объем
        },
        {
            "date": "2024-05-21",                  // Дата
            "plan": 23168.049999999945,            // Запланированный объем
            "fact": 19758.750000000073             // Фактический объем
        }
    ]
}

Объем по каждой КП за день​

/api/v1/lk/getVolumeReportGroupedByArea

Возвращает объемы двух видов, запланированный и фактический, по всем КП реестра и указанной дате.

PARAMSvalueКомментарий
date2024-05-20Дата : format yyyy-MM-dd

Пример запроса:\ curl --location --request POST --header 'Authorization: Bearer ваш_токен'

https://disp.t1.groupstp.ru/app/api/v1/lk/getVolumeReportGroupedByArea?date=2024-05-20

Результат
{
    "id": "7d412d32-bd66-4bcf-be4f-54014d290e6f",  // Рандомный id отчета (можно не использовать, на случай если нужно определить, что ответ не закеширован)
    "date": "2024-05-20",                          // Дата (параметр запроса)
    "volumes": [                                   // Объемы, сгруппированные по КП
        {
            "areaLkCode": "38013987",              // Код КП
            "plan": 8.0,                           // Запланированный объем
            "fact": 8.0                            // Фактический объем
        },
        {
            "areaLkCode": "38100000",              // Код КП
            "plan": 1.5,                           // Запланированный объем
            "fact": 0.75                           // Фактический объем
        }
     ]
}

Суммарный объем вывоза по КП за период​

/api/v1/lk/getSummaryRemoval

Возвращает суммарный объем вывоза по каждой КП за период. Фильтр передается в теле запроса (JSON). Метод можно вызывать не чаще 1 раза в 20 секунд, при превышении сервер вернет ошибку «Пользователь ... вышел за лимит разрешенных вызовов запроса ...».

Поле телаvalueКомментарий
removalDateFrom2024-05-20T00:00:00Обязательное. Дата и время вывоза с: format yyyy-MM-ddTHH:mm:ss
removalDateTo2024-05-21T00:00:00Обязательное. Дата и время вывоза по: format yyyy-MM-ddTHH:mm:ss. Период - не больше 35 дней
codes["38013987", "38100000"]Необязательное. Коды КП. Если не передано или пусто - по всем КП
modifyDateFrom2024-05-20T00:00:00Необязательное. Дата и время изменения отчета с
modifyDateTo2024-05-21T00:00:00Необязательное. Дата и время изменения отчета по
Пример запроса и результат
{
    "removalDateFrom": "2024-05-20T00:00:00",
    "removalDateTo": "2024-05-21T00:00:00",
    "codes": ["38013987", "38100000"]
}
[
    {
        "code": "38013987",                        // Код КП
        "removalVolume": 8.0                       // Объем вывоза
    }
]

Детализированный вывоз за период​

/api/v1/lk/getDetailingRemoval

Возвращает отчеты о вывозе за период с объемами по каждому отчету. Фильтр в теле запроса такой же, как у getSummaryRemoval. Ограничение - не чаще 1 вызова в 20 секунд.

Результат
[
    {
        "reportId": "3a6e3666-b169-4cff-9978-6f80d80f4a94", // ID отчета водителя
        "code": "38013987",                                 // Код КП
        "createDate": "2024-05-20T10:15:00",                // Дата создания отчета
        "updateDate": "2024-05-20T10:20:00",                // Дата изменения отчета
        "removalDate": "2024-05-20T10:12:00",               // Дата вывоза
        "containersAmount": 2,                              // Количество вывезенных контейнеров
        "containersVolume": 2.2,                            // Объем вывезенных контейнеров
        "pickedUpVolume": 0.0,                              // Объем подбора
        "volumeFull": 2.2                                   // Полный объем вывоза
    }
]

Определение участка по координатам​

/api/v1/lk/calculateRegionByPoints

Определяет участок для каждой переданной точки. В теле запроса передается массив точек. Ограничение - не чаще 1 вызова в 20 секунд.

Пример запроса и результат
[
    {
        "pointId": "1b9d6bcd-bbfd-4b2d-9b5d-ab8dfbbd4bed", // ID точки (задает вызывающая сторона)
        "lat": 52.2854833,                                 // Широта
        "lon": 104.2890217                                 // Долгота
    }
]
[
    {
        "pointId": "1b9d6bcd-bbfd-4b2d-9b5d-ab8dfbbd4bed", // ID точки из запроса
        "founded": true,                                   // Участок найден
        "regionId": "e4c64c3c-375b-41cf-9cef-35a7d1833687", // ID участка
        "regionName": "Ленинский"                          // Название участка
    }
]