Запросы статистики работы¶
GetProviderBalanceHistory¶
Запрос Провайдером истории изменения баланса провайдера за период, не позднее месяца назад.
GET-запрос¶
https://POISUrl/GetProviderBalanceHistory?apiKey=ProviderApiKey
| Параметр | Описание |
|---|---|
| ProviderApiKey | API ключ для POIS, полученный провайдером |
Тело запроса (JSON)¶
{
"TimeFrom":"2018-05-01T00:00", // дата-время в формате ISO 8601
"TimeTo":"2018-05-31T23:59", // дата-время в формате ISO 8601
"ServerId":75, //идентификатор сервера
"AccountId":"1248" // лицевой счет
}
Ответ -JSON вида¶
[
{
"ServerId":1, //id сервера SeDi
"SediOrderId":"25757", //id заказа SeDi
"IsCashless":0, //наличный - 0, безналичный - 1
"ProviderToSedi":0, //направление заказа(1 - от Провадера в СеДи, 0 - от СеДи к Провайдеру)
"OrderCost":250, //стоимость заказа
"Sum":-25, //сумма отчисления провайдеру(с минусом - Провайдер платит СеДи, с плюсом - СеДи платит Провайдеру)
"Percent":10, //процент от заказа(Sum = Percent от OrderCost, для сверки)
"AccountId":1248 //лицевой счет
},
{
"ServerId":2, //id сервера SeDi
"SediOrderId":"25750", //id заказа SeDi
"IsCashless":0, //наличный - 0, безналичный - 1
"ProviderToSedi":0, //направление заказа(1 - от Провадера в СеДи, 0 - от СеДи к Провайдеру)
"OrderCost":200, //стоимость заказа
"Sum":-20, //сумма отчисления провайдеру(с минусом - Провайдер платит СеДи, с плюсом - СеДи платит Провайдеру)
"Percent":10, //процент от заказа(Sum = Percent от OrderCost, для сверки)
"AccountId":1248 //лицевой счет
},
{
"ServerId":2, //id сервера SeDi
"SediOrderId":"25850", //id заказа SeDi
"IsCashless":0, //наличный - 0, безналичный - 1
"ProviderToSedi":1, //направление заказа(1 - от Провадера в СеДи, 0 - от СеДи к Провайдеру)
"OrderCost":300, //стоимость заказа
"Sum":30, //сумма отчисления провайдеру(с минусом - Провайдер платит СеДи, с плюсом - СеДи платит Провайдеру)
"Percent":10, //процент от заказа(Sum = Percent от OrderCost, для сверки)
"AccountId":1248 //лицевой счет
}
]
GetGroupActivityStatistics¶
Запрос Провайдером статистики активности группы
POST-запрос¶
https://POISUrl/GetGroupActivityStatistics?apiKey=ProviderApiKey
| Параметр | Описание |
|---|---|
| ProviderApiKey | API ключ для POIS, полученный провайдером |
| Year | Год |
| Month | Месяц |
| Day | День |
| GroupingDate | тип группировки по времени (день/неделя/месяц/год). Возможные значения: Day, Week, Month, Year |
| GroupingOwner | тип группировки по владельцу(группа/сервер). Возможные значения: Group, Server |
Тело запроса (JSON)¶
{
"Year":2024, // год
"Moth":12, // месяц
"Day":0, // день
"GroupingDate":"Month", // тип группировки по времени (день/неделя/месяц/год)
"GroupingOwner":"Group" // тип группировки по владельцу(группа/сервер)
}
Ответ¶
Ответ от POIS - JSON вида
[
{
"Year": 2025, //Год
"Month": 2, //Месяц
"Day": 1, //День
"Week": 5, //Неделя
"ServerId": 75, //ID сервера
"GroupId": 48, //ID группы
"DriverRegistrationCount": 0, //Количество регистраций водителей
"DriverPermitToWorkCount": 0, //Количество допусков к работе
"PermittedDriversCount": 196, //Количество в группе водителей с допуском к работе (среднее значение)
"ActiveDriversCount": 0 //Активных водителей за период (среднее значение)
},
{
"Year": 2025, //Год
"Month": 2, //Месяц
"Day": 2, //День
"Week": 5, //Неделя
"ServerId": 75, //ID сервера
"GroupId": 48, //ID группы
"DriverRegistrationCount": 0, //Количество регистраций водителей
"DriverPermitToWorkCount": 0, //Количество допусков к работе
"PermittedDriversCount": 196, //Количество в группе водителей с допуском к работе (среднее значение)
"ActiveDriversCount": 0 //Активных водителей за период (среднее значение)
}
]
Поля будут заполнены либо пустые, в зависимости от заданного типа группировки.
Дополнительно результат описывается кодом HTTP-ответа.
200 OK - запрос выполнен полностью без ошибок.
400 Bad Request - некорректный или пустой ключ ProviderApiKey, переданы некорректные параметры.
403 Forbidden - слишком много запросов
GetGroupOrderStatistics¶
Запрос Провайдером статистики по выполняемым заказам
POST-запрос¶
https://POISUrl/GetGroupOrderStatistics?apiKey=ProviderApiKey
| Параметр | Описание |
|---|---|
| ProviderApiKey | API ключ для POIS, полученный провайдером |
| Year | Год |
| Month | Месяц |
| Day | День |
| Hour | Час |
| RegionPlusId | Идентификатор региона |
| GroupingDate | тип группировки по времени (день/неделя/месяц/год). Возможные значения: Day, Week, Month, Year |
| GroupingOwner | тип группировки по владельцу(группа/сервер). Возможные значения: Group, Server |
| GroupByRegion | Группировка по региону, true или false |
Тело запроса (JSON)¶
{
"Year":2025, // год
"Month":0, // месяц
"Day":0, // день
"GroupingDate":"", // тип группировки по времени (день/неделя/месяц/год)
"GroupingOwner":"", // тип группировки по владельцу(группа/сервер)
"GroupByRegion":1 // тип группировки по региону
}
Ответ¶
Ответ от POIS - JSON вида
Массив сгруппированных (или нет) данных
[
{
"Year": null, //Год
"Month": null, //Месяц
"Day": null, //День
"ServerId": null, //ID сервера
"GroupId": null, //ID группы
"RegionPlusId": 11, //ID региона
"OrdersCount": 0, //количество предложенных заказов, уникальных по айди
"OffersCount": 0, //количество предложений заказов всего(могут быть одни и те же несколько раз, поэтому это число может быть больше, чем OrdersCount)
"TakeOrderRequestsCount": 4, //количество запросов на взятие заказов водителями
"ConfirmedOrdersCount": 5, //количество заказов, переданных водителям на исполнение
"RefusedOrdersCount": 0, //количество отказов водителей от принятых на исполнение заказов
"CanceledOrdersCount": 4, //количество отмен клиентом
"DoneNoClientOrdersCount": 1, //количество неявок клиентов
"FailedOrdersCount": 0, //количество проваленных заказов
"DoneOkOrdersCount": 0, //количество успешно завершенных заказов
}
]
Поля будут заполнены либо пустые, в зависимости от заданного типа группировки.
Дополнительно результат описывается кодом HTTP-ответа.
200 OK - запрос выполнен полностью без ошибок.
400 Bad Request - некорректный или пустой ключ ProviderApiKey, переданы некорректные параметры.
403 Forbidden - слишком много запросов
GetExecutorRequestStatistics¶
Запрос Провайдером статистики по запросам водителей (GetDrivers)
POST-запрос¶
https://POISUrl/GetExecutorRequestStatistics?apiKey=ProviderApiKey
| Параметр | Описание |
|---|---|
| ProviderApiKey | API ключ для POIS, полученный провайдером |
| Year | Год |
| Month | Месяц |
| Day | День |
| Hour | Час |
| RegionPlusId | Идентификатор региона |
| GroupingDate | тип группировки по времени (день/неделя/месяц/год). Возможные значения: Day, Week, Month, Year |
| GroupByRegion | Группировка по региону, 1 или 0 |
Тело запроса (JSON)¶
{
"Year":2025, // год
"Month":4, // месяц
"Day":0, // день
"Hour":0, // часы
"GroupingDate":"Year", // тип группировки по времени (день/неделя/месяц/год)
"GroupByRegion":1 // тип группировки по региону
}
Ответ¶
Ответ от POIS - JSON вида
Массив сгруппированных (или нет) данных
[
{
"Year": 2025, //Год
"Month": null, //Месяц
"Day": null, //День
"RegionPlusId": 11, //ID региона
"RegionPlusName": "Москва", //Название региона
"RequestsCount": 3, //Количество запросов
"EmptyAnswersCount": 3, //Количество пустых ответов
"ErrorAnswersCount": 0 //Количество ответов с ошибками
},
{
"Year": 2025, //Год
"Month": null, //Месяц
"Day": null, //День
"Hour": null, //Часы
"RegionPlusId": 63, //ID региона
"RegionPlusName": "Челябинск", //Название региона
"RequestsCount": 3, //Количество запросов
"EmptyAnswersCount": 3, //Количество пустых ответов, когда не найдены водители
"ErrorAnswersCount": 0 //Количество ответов с ошибкой(что-то не сработало, запрос прошел не успешно)
}
]
Поля будут заполнены либо пустые, в зависимости от заданного типа группировки.
Дополнительно результат описывается кодом HTTP-ответа.
200 OK - запрос выполнен полностью без ошибок.
400 Bad Request - некорректный или пустой ключ ProviderApiKey, переданы некорректные параметры.
403 Forbidden - слишком много запросов