TMS API Грузовладельца (v1)

Download OpenAPI specification:

Health

Проверка доступности сервиса

Authorizations:
api_key
path Parameters
tenant_id
required
string <uuid> (Uuid) (?i-mx:^[\da-f]{8}-([\da-f]{4}-){3}[\da-f]{12...
Example: 9d82fff9-d029-44b2-b6b7-133b957aa926

Идентификатор компании

Responses

Справочники

Получение списка типов транспортных средств

Получение списка всех имеющихся в системе типов транспортных средств

Authorizations:
api_key
path Parameters
tenant_id
required
string <uuid> (Uuid) (?i-mx:^[\da-f]{8}-([\da-f]{4}-){3}[\da-f]{12...
Example: 9d82fff9-d029-44b2-b6b7-133b957aa926

Идентификатор компании

Responses

Response samples

Content type
application/json
[
  • {
    }
]

Получение списка видов кузовов

Получение списка всех имеющихся в системе видов кузовов

Authorizations:
api_key
path Parameters
tenant_id
required
string <uuid> (Uuid) (?i-mx:^[\da-f]{8}-([\da-f]{4}-){3}[\da-f]{12...
Example: 9d82fff9-d029-44b2-b6b7-133b957aa926

Идентификатор компании

Responses

Response samples

Content type
application/json
[
  • {
    }
]

Получение списка партнеров-перевозчиков

Получение списка всех имеющихся компаний партнеров-перевозчиков

Authorizations:
api_key
path Parameters
tenant_id
required
string <uuid> (Uuid) (?i-mx:^[\da-f]{8}-([\da-f]{4}-){3}[\da-f]{12...
Example: 9d82fff9-d029-44b2-b6b7-133b957aa926

Идентификатор компании

Responses

Response samples

Content type
application/json
[
  • {
    }
]

Отчеты

Запросить генерацию отчета

Создание запроса на генерацию отчета с заданными параметрами

Authorizations:
api_key
path Parameters
tenant_id
required
string <uuid> (Uuid) (?i-mx:^[\da-f]{8}-([\da-f]{4}-){3}[\da-f]{12...
Example: 9d82fff9-d029-44b2-b6b7-133b957aa926

Идентификатор компании

Request Body schema: application/json
required
columns
required
Array of strings

Список колонок, которые должны быть включены в отчет

filter_period_by
required
string
Enum: "loading_date" "unloading_date" "timeslot_booking_date" "order_creation_date" "order_confirmation_date"

Период выборки данных * loading_date - Дата погрузки * unloading_date - Дата разгрузки * timeslot_booking_date - Дата бронирования таймслота * order_creation_date - Дата создания заказа * order_confirmation_date - Дата принятия предложения / победы в торгах

date_from
required
string <date> (Date)

Дата начала периода выборки (включительно)

date_to
required
string <date> (Date)

Дата окончания периода выборки (включительно)

order_statuses
Array of strings
Items Enum: "pending" "on_bidding" "on_target_offering" "on_execution" "finalized"

Статусы заказов, которые должны быть включены в отчет * pending - К выполнению * on_bidding - Предложения * on_target_offering - Не подтверждено * on_execution - В работе * finalized - Завершенные

modalities
Array of strings
Items Enum: "auto" "railway" "sea" "air"

Список модальностей, по которым нужно отфильтровать заказы * auto - Авто * railway - ЖД * sea - Море * air - Авиа

Responses

Request samples

Content type
application/json
{
  • "columns": [
    ],
  • "filter_period_by": "loading_date",
  • "date_from": "2016-07-20",
  • "date_to": "2016-07-20",
  • "order_statuses": [
    ],
  • "modalities": [
    ]
}

Response samples

Content type
application/json
{
  • "id": "9d82fff9-d029-44b2-b6b7-133b957aa926"
}

Получение полей для отчета

Получение списка полей, которые можно использовать в отчете

Authorizations:
api_key
path Parameters
tenant_id
required
string <uuid> (Uuid) (?i-mx:^[\da-f]{8}-([\da-f]{4}-){3}[\da-f]{12...
Example: 9d82fff9-d029-44b2-b6b7-133b957aa926

Идентификатор компании

Responses

Response samples

Content type
application/json
[
  • {
    }
]

Скачать сформированный отчет

Скачать ранее сформированный отчет в формате XLSX

Authorizations:
api_key
path Parameters
tenant_id
required
string <uuid> (Uuid) (?i-mx:^[\da-f]{8}-([\da-f]{4}-){3}[\da-f]{12...
Example: 9d82fff9-d029-44b2-b6b7-133b957aa926

Идентификатор компании

report_id
required
string <uuid> (Uuid) (?i-mx:^[\da-f]{8}-([\da-f]{4}-){3}[\da-f]{12...
Example: 9d82fff9-d029-44b2-b6b7-133b957aa926

Идентификатор отчета

Responses

Тендеры

Получение списка тендеров

Получение списка всех тендеров

Authorizations:
api_key
path Parameters
tenant_id
required
string <uuid> (Uuid) (?i-mx:^[\da-f]{8}-([\da-f]{4}-){3}[\da-f]{12...
Example: 9d82fff9-d029-44b2-b6b7-133b957aa926

Идентификатор компании

query Parameters
page
integer
Default: 1

Номер страницы

items
integer <= 100
Default: 20

Кол-во объектов на странице

search_query
string

Полнотекстовый поиск по названию тендера

scope
string
Enum: "draft" "ready_to_start" "started" "paused" "finished" "canceled"

Фильтр по статусу тендера

start_date_from
string
Example: start_date_from=2023-10-14T12:34:56+03:00

Дата начала фильтра интервала проведения тендера в формате ISO 8601. Используется только вместе с end_date_to.

end_date_to
string
Example: end_date_to=2023-10-19T12:34:56+03:00

Дата начала фильтра интервала проведения тендера в формате ISO 8601. Используется только вместе с start_date_from.

Responses

Response samples

Content type
application/json
[
  • {
    }
]

Запрос на генерацию результатов тендера

Запросить генерацию результатов тендера в формате .xlsx. Генерация результатов происходит асинхронно, поэтому в ответе придет идентификатор, по которому можно будет затем запросить файл экспорта по пути /{tenant_id}/exports/{export_id}/file.

Authorizations:
api_key
path Parameters
tenant_id
required
string <uuid> (Uuid) (?i-mx:^[\da-f]{8}-([\da-f]{4}-){3}[\da-f]{12...
Example: 9d82fff9-d029-44b2-b6b7-133b957aa926

Идентификатор компании

tender_id
required
string <uuid> (Uuid) (?i-mx:^[\da-f]{8}-([\da-f]{4}-){3}[\da-f]{12...
Example: 9d82fff9-d029-44b2-b6b7-133b957aa926

Идентификатор тендера

query Parameters
type
string
Enum: "all" "winners" "incompleted"

Выбор типа результатов:

  • all - все лоты и ставки
  • winners - только лоты с назначенными победителями
  • incompleted - только незакрытые лоты (без ставок)

Responses

Response samples

Content type
application/json
{
  • "id": "string"
}

Экспорты

Получить файл экспорта

По заранее запрошенному идентификатору экспорта получить .xlsx файл.

Authorizations:
api_key
path Parameters
tenant_id
required
string <uuid> (Uuid) (?i-mx:^[\da-f]{8}-([\da-f]{4}-){3}[\da-f]{12...
Example: 9d82fff9-d029-44b2-b6b7-133b957aa926

Идентификатор компании

export_id
required
string <uuid> (Uuid) (?i-mx:^[\da-f]{8}-([\da-f]{4}-){3}[\da-f]{12...
Example: 9d82fff9-d029-44b2-b6b7-133b957aa926

Идентификатор экспорта

Responses