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

Реестры

Обновить реестр

Обновление реестра по uid

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

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

registry_uid
required
string

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

Request Body schema: application/json
required
payment_status
string
Enum: "pending_payment" "paid" "partially_paid"

Статус оплаты

  • pending_payment - Ожидает оплаты
  • paid - Оплачен
  • partially_paid - Оплачен частично
planned_payment_date
string <date>

Плановая дата оплаты

payment_accepted_on
string <date>

Дата фактической оплаты

Responses

Request samples

Content type
application/json
{
  • "payment_status": "partially_paid",
  • "planned_payment_date": "2025-05-05",
  • "payment_accepted_on": "2025-05-03"
}

Response samples

Content type
application/json
{
  • "code": "not_found",
  • "message": "Реестр не найден",
  • "errors": { }
}

Подбор исполнителей

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

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

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

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

order_iid
required
string

Порядковый номер заказа

Responses

Response samples

Content type
application/json
[
  • {
    }
]

Получить список потенциальных участников для заказа

Возвращает список партнеров, которые могут участвовать в подборе на роль перевозчика/экспедитора для заказа с указанным IID.

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

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

order_iid
required
string

Порядковый номер заказа

query Parameters
without_groups
boolean

При передаче значения true из списка будут исключены группы партнерств По умолчанию группы не исключаются из поиска

query
string

Поиск партнеров или групп по их наименованию

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

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

order_iid
required
string

Порядковый номер заказа

Request Body schema: application/json
required
quantity_for_reservation
required
integer

Количество рейсов, тонн или кубометров, предлагаемое к перевозке в рамках целевого предложения

contract_required
required
boolean

Обязательность наличия договора

Если наличие договора для заказа является обязательным, следует передавать значение true. Если у партнёра отсутствует договор, а значение true передано, создание целевого предложения будет невозможно.

currency
required
string (Currency)
Enum: "RUB" "USD" "EUR" "CNY" "BYN"

Валюта

expires_at
required
string <date-time>

Плановая дата и время истечения срока действия целевого предложения

partnership_id
required
string <uuid>

ID партнера, которому отправляется целевое предложение. Список доступных партнеров можно посмотреть в точке "Получить список потенциальных участников для заказа"

vat_rate
required
string (VatRate)
Enum: "vat_20" "vat_10" "vat_7" "vat_5" "vat_0" "vat_none"

НДС

  • vat_20 - 20% НДС
  • vat_10 - 10% НДС
  • vat_7 - 7% НДС
  • vat_5 - 5% НДС
  • vat_0 - 0% НДС
  • vat_none - без НДС
pricing_model
required
string (PricingModel)
Enum: "per_unit" "per_distance" "per_distance_unit"

Модель ценообразования

  • per_unit - За единицу учета (Цена за 1 рейс, 1 тонну или 1 кубометр)
  • per_distance - За расстояние. (Цена за 1 км)
  • per_distance_unit - За произведение объема груза (тонны или м³) на расстояние (км) и на тариф за единицу. Пример: 50 тонн × 200 км = 10000; умножаем на тариф 10₽ → получаем 100.000.
price
required
integer

Цена целевого предложения в копейках

Responses

Request samples

Content type
application/json
{
  • "quantity_for_reservation": 5,
  • "contract_required": false,
  • "currency": "RUB",
  • "expires_at": "2025-10-22T21:00:00.000Z",
  • "partnership_id": "e783cca0-a4bf-4a84-8336-585be143877a",
  • "vat_rate": "vat_20",
  • "pricing_model": "per_unit",
  • "price": 5400000
}

Response samples

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

Обновить целевое предложение на перевозку

Обновляет поля выбранного целевого предложения на перевозку.

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

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

target_offer_executors_lookup_id
required
string

ID подбора, который нужно обновить.

Request Body schema: application/json
required
expires_at
string <date-time>

Плановая дата и время истечения срока действия целевого предложения

Responses

Request samples

Content type
application/json
{
  • "expires_at": "2025-10-22T21:00:00.000Z"
}

Response samples

Content type
application/json
{
  • "code": "not_found",
  • "message": "Целевое предложение не найдено",
  • "errors": { }
}

Отменить целевое предложение на перевозку

Отменяет выбранное целевое предложение на перевозку.

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

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

target_offer_executors_lookup_id
required
string

ID подбора, который нужно отменить.

Responses

Response samples

Content type
application/json
{
  • "code": "not_found",
  • "message": "Целевое предложение не найдено",
  • "errors": { }
}