Skip to content
Для ИИ NEW Мои токены Поддержка
Чат для вопросов по API Мгновенно ответим на ваши вопросы
api@ati.su Электронная почта техподдержки
Тикетная система Оставить заявку на отдел "Консультанты по интеграции (API)"
api.ati.su - заказы, торги, площадки Наш телеграм-канал
Для подтверждения действия введите пароль
Чтобы продолжить, введите пароль для пользователя
Отменить
For LLMs and AI agents: canonical Markdown source of this documentation page (plain-text .md — fetch this URL to use the page content in tools and RAG). For LLMs and AI agents: developers documentation index in llms.txt format — ordered list of key documentation URLs for the developers section.

OpenAPI · Markdown

Как найти перевозчика на груз

Если вы опубликовали груз на персональной Площадке или включили возможность бронирования грузов, то перевозчик может забронировать ваш груз и прислать данные для оформления заявки на перевозку.

Если вы собираете встречные предложения к грузу, получить их можно одним из методов получения встречных предложений — по конкретному грузу или сразу по всем опубликованным грузам фирмы:

Получение встречных предложений для опубликованного груза
get /gw/cargo-counter-offers-api/integrator/v1/cargos/{cargoId}/counter-offers
Параметры
Параметр Тип Расположение Описание
cargoId обязательный string (guid) path
ID груза Пример: 3fa85f64-5717-4562-b3fc-2c963f66afa6
fromDate string (date-time) query
Дата с которой вернуть встречные предложения Пример: 2024-01-01T00:00:00+00:00
Запрос
Пример запроса 
curl 'https://api.ati.su/gw/cargo-counter-offers-api/integrator/v1/cargos/{cargoId}/counter-offers' \
  -X 'GET' \
  -H 'Authorization: Bearer {authorizationToken}' \
  -H 'Content-Type: application/json'
Ответ
200
Модель
[{...}]

Встречное предложение

id: guid

Id встречного предложения

cargo_id: guid

Id груза, на который оставлено встречное предложение

cargo_number: string
Минимальное количество символов: 1

Номер груза

cargo_firm_id: int32

Id фирмы, которой принадлежит груз

firm_id: int32

Id фирмы, которая оставила встречное предложение

added_at: date-time

Дата добавления встречного предложения

updated_at: date-time

Дата изменения встречного предложения

price: decimal

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

currency_id: int32

Валюта встречного предложения
Значение из словаря валют АТИ

nds_price: decimal

Предложенная цена встречного предложения с НДС

nds_percent: int32

Процент НДС ставки встречного предложения

nds_currency_id: int32

Валюта ставки встречного предложения б/нал с НДС. Значение из словаря валют АТИ

not_nds_price: decimal

Предложенная цена встречного предложения без НДС

not_nds_currency_id: int32

Валюта встречного предложения без НДС

counter_offer_source: int32

Обозначение откуда было добавлено встречное предложение

  • 0 - Неизвестный источник
  • 1 - Мобильное приложение
  • 2 - Интегратор
  • 3 - Перехват грузов интегратором
  • 4 - Страница поиска грузов
  • 5 - Перехват машин
  • 6 - Сквозное встречное предложение, добавлено автоматически
note: string
Минимальное количество символов: 1

Примечание к встречному предложению
Максимальная длина - 512 символов

pay_attributes: int32

Атрибуты оплаты, по умолчанию - 0. Битовая сумма следующих параметров:

  • 1 - возможна оплата наличными
  • 2 - возможна оплата по безналичному рассчету
  • 4 - блиц
  • 8 - оплата с НДС
  • 16 - возможна предоплата
  • 32 - оплата на выгрузке
  • 64 - включена ли оплата через некоторое количество банковских дней
prepay_percent: int32

Процент предоплаты

pay_after_max_bank_days: int32

Оплата через ... банковских дней

loading_date: date

Дата загрузки

is_outdated: boolean

Определяет, просрочено ли встречное предложение. Когда груз редактируют, удаляют, обновляют, встречное предложение помечается просроченным.\

is_cargo_published: boolean

Относится ли встречное предложение к опубликованному грузу

firm_info:

Информация о фирме, оставившей встречное предложение на груз

ONE-OF
}]
Пример
[...]
{...}
"id":"3fa85f64-5717-4562-b3fc-2c963f66afa6",
"cargo_id":"3fa85f64-5717-4562-b3fc-2c963f66afa6",
"cargo_number":"CES23786",
"cargo_firm_id":1234,
"firm_id":1234,
"added_at":"2024-01-15T10:30:00+03:00",
"updated_at":"2024-01-15T10:30:00+03:00",
"price":100.5,
"currency_id":1,
"nds_price":100.5,
"nds_percent":22,
"nds_currency_id":1,
"not_nds_price":100.5,
"not_nds_currency_id":1,
"counter_offer_source":2,
"note":"Тестовое примечание",
"pay_attributes":0,
"prepay_percent":0,
"pay_after_max_bank_days":0,
"loading_date":"2024-01-15",
"is_outdated":false,
"is_cargo_published":false,
"firm_info":{...}
"total_score":4.5,
"status":3,
"full_firm_name":"ООО Тест",
"contact":{...},
"id":1,
"name":"Иванов Иван",
"telephone":"+74951234567",
"email":"test@test.ru",
"mobile":"+79001234567",
"mobile_operator":"МТС",
"location":{...}
"city_id":1,
"region_id":1,
"country_id":1,
"full_name":"Москва, Россия",
"short_name":"Москва",
"is_regional_center":true,
"fias_id":"0c5b2444-70a0-4932-980c-b4dc0d3f02b5",
"city_name":"Москва",
"region_name":"Московская область",
"country_name":"Россия",
"country_code":"RU"
}
},
"inn":1234567890
}
}
]
4XX Ошибка запроса
Модель
{...}
error: string

Код ошибки

reason: string (nullable)

Причина ошибки

}
Пример
{...}
"error":"string",
"reason":"string",
"details":[...]
{...}
"property":"string",
"error":"string",
"reason":"string"
}
]
}
Получение встречных предложений для всех опубликованных грузов
get /gw/cargo-counter-offers-api/integrator/v1/cargos/counter-offers
Параметры
Параметр Тип Расположение Описание
fromDate string (date-time) query
Дата с которой вернуть встречные предложения Пример: 2024-01-01T00:00:00+00:00
Запрос
Пример запроса 
curl 'https://api.ati.su/gw/cargo-counter-offers-api/integrator/v1/cargos/counter-offers' \
  -X 'GET' \
  -H 'Authorization: Bearer {authorizationToken}' \
  -H 'Content-Type: application/json'
Ответ
200
Модель
[{...}]

Встречное предложение

id: guid

Id встречного предложения

cargo_id: guid

Id груза, на который оставлено встречное предложение

cargo_number: string
Минимальное количество символов: 1

Номер груза

cargo_firm_id: int32

Id фирмы, которой принадлежит груз

firm_id: int32

Id фирмы, которая оставила встречное предложение

added_at: date-time

Дата добавления встречного предложения

updated_at: date-time

Дата изменения встречного предложения

price: decimal

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

currency_id: int32

Валюта встречного предложения
Значение из словаря валют АТИ

nds_price: decimal

Предложенная цена встречного предложения с НДС

nds_percent: int32

Процент НДС ставки встречного предложения

nds_currency_id: int32

Валюта ставки встречного предложения б/нал с НДС. Значение из словаря валют АТИ

not_nds_price: decimal

Предложенная цена встречного предложения без НДС

not_nds_currency_id: int32

Валюта встречного предложения без НДС

counter_offer_source: int32

Обозначение откуда было добавлено встречное предложение

  • 0 - Неизвестный источник
  • 1 - Мобильное приложение
  • 2 - Интегратор
  • 3 - Перехват грузов интегратором
  • 4 - Страница поиска грузов
  • 5 - Перехват машин
  • 6 - Сквозное встречное предложение, добавлено автоматически
note: string
Минимальное количество символов: 1

Примечание к встречному предложению
Максимальная длина - 512 символов

pay_attributes: int32

Атрибуты оплаты, по умолчанию - 0. Битовая сумма следующих параметров:

  • 1 - возможна оплата наличными
  • 2 - возможна оплата по безналичному рассчету
  • 4 - блиц
  • 8 - оплата с НДС
  • 16 - возможна предоплата
  • 32 - оплата на выгрузке
  • 64 - включена ли оплата через некоторое количество банковских дней
prepay_percent: int32

Процент предоплаты

pay_after_max_bank_days: int32

Оплата через ... банковских дней

loading_date: date

Дата загрузки

is_outdated: boolean

Определяет, просрочено ли встречное предложение. Когда груз редактируют, удаляют, обновляют, встречное предложение помечается просроченным.\

is_cargo_published: boolean

Относится ли встречное предложение к опубликованному грузу

firm_info:

Информация о фирме, оставившей встречное предложение на груз

ONE-OF
}]
Пример
[...]
{...}
"id":"3fa85f64-5717-4562-b3fc-2c963f66afa6",
"cargo_id":"3fa85f64-5717-4562-b3fc-2c963f66afa6",
"cargo_number":"CES23786",
"cargo_firm_id":1234,
"firm_id":1234,
"added_at":"2024-01-15T10:30:00+03:00",
"updated_at":"2024-01-15T10:30:00+03:00",
"price":100.5,
"currency_id":1,
"nds_price":100.5,
"nds_percent":22,
"nds_currency_id":1,
"not_nds_price":100.5,
"not_nds_currency_id":1,
"counter_offer_source":2,
"note":"Тестовое примечание",
"pay_attributes":0,
"prepay_percent":0,
"pay_after_max_bank_days":0,
"loading_date":"2024-01-15",
"is_outdated":false,
"is_cargo_published":false,
"firm_info":{...}
"total_score":4.5,
"status":3,
"full_firm_name":"ООО Тест",
"contact":{...},
"id":1,
"name":"Иванов Иван",
"telephone":"+74951234567",
"email":"test@test.ru",
"mobile":"+79001234567",
"mobile_operator":"МТС",
"location":{...}
"city_id":1,
"region_id":1,
"country_id":1,
"full_name":"Москва, Россия",
"short_name":"Москва",
"is_regional_center":true,
"fias_id":"0c5b2444-70a0-4932-980c-b4dc0d3f02b5",
"city_name":"Москва",
"region_name":"Московская область",
"country_name":"Россия",
"country_code":"RU"
}
},
"inn":1234567890
}
}
]
4XX Ошибка запроса
Модель
{...}
error: string

Код ошибки

reason: string (nullable)

Причина ошибки

}
Пример
{...}
"error":"string",
"reason":"string",
"details":[...]
{...}
"property":"string",
"error":"string",
"reason":"string"
}
]
}

Перевозчика, предложившего хорошую ставку, вы можете пригласить на Заказ.

Отправка приглашения по встречному предложению. Отправляет приглашение оформить заказ грузоперевозчику по встречному предложению
post /v1.2/orders/invites/counter_offer
Параметры
Параметров нет
Запрос
Модель
ONE-OF

(nullable)

Пример запроса 
curl 'https://api.ati.su/v1.2/orders/invites/counter_offer' \
  -X 'POST' \
  -H 'Authorization: Bearer {authorizationToken}' \
  -H 'Content-Type: application/json' \
  --data-raw '{"load_id":"7a48a9d3-55cb-48a2-8527-35ff461eeb8c","response_id":"5026ffdd-4c2a-eb11-bb90-0025906a774d","rate_types":[0],"cancel_after_in_minutes":60,"need_archive_on_invite":false}'
Ответ
200 Приглашение отправлено
Успешный ответ
4XX Ошибка запроса. [Подробнее про ошибки API](https://ati.su/developers/documentation/errors/)
Модель
ONE-OF

(nullable)

Пример
{...}
"reason":"Неизвестная ошибка",
"error":"unknown_server_error"
}

Если вы знаете, какому перевозчику хотите отдать груз, опубликуйте груз с нужной ставкой и отправьте персональное приглашение на Заказ.

Отправка приглашения. Отправляет приглашение оформить заказ грузоперевозчику с оповещением *Отправленное повторно приглашение удалит предыдущее*
post /v1.2/orders/invites
Параметры
Параметров нет
Запрос
Модель
ONE-OF

(nullable)

Пример запроса 
curl 'https://api.ati.su/v1.2/orders/invites' \
  -X 'POST' \
  -H 'Authorization: Bearer {authorizationToken}' \
  -H 'Content-Type: application/json' \
  --data-raw '{"load_id":"7a48a9d3-55cb-48a2-8527-35ff461eeb8c","taker_ati_id":"14612","taker_contacts_list":[0],"payment":{"rates":[{"rate_type":0,"rate":120000,"currency":1,"vat_percent":22}]},"cancellation_date":"2024-06-16T12:00:00Z","is_tracking":true}'
Ответ
200 Приглашение отправлено
Успешный ответ
4XX Ошибка запроса. [Подробнее про ошибки API](https://ati.su/developers/documentation/errors/)
Модель
ONE-OF

(nullable)

Пример
{...}
"reason":"Неизвестная ошибка",
"error":"unknown_server_error"
}

Перевозчик получит уведомление и сможет взять груз и отправить вам данные для оформления документов.

Если же по грузу проводились торги (аукцион), то после их завершения груз автоматически будет забронирован за победителем, за исключением случая, когда несколько ставок будут считаться лучшими: одна - “с лучшей датой”, а другая - “с лучшей ставкой”. В этом случае победителя нужно будет выбрать вручную. Это можно сделать с помощью метода смены победителя в торгах.

Назначает победителя торгов (аукциона).
post /v1.2/auction/bet/win/{auctionRateId}
Параметры
Параметр Тип Расположение Описание
auctionRateId обязательный string (uuid) path
Id ставки торгов (аукциона). Выбирается одна из ставок со статусами state=[0,-3] и устанавливается победной (state=1). Пример: 2fb965f2-85e9-4213-90e7-f396e47219e7
Запрос
Пример запроса 
curl 'https://api.ati.su/v1.2/auction/bet/win/{auctionRateId}' \
  -X 'POST' \
  -H 'Authorization: Bearer {authorizationToken}' \
  -H 'Content-Type: application/json'
Ответ
200 Success
Модель
{...}

Торги (аукцион) для грузовладельца.

step*: double

Шаг изменения ставки торгов (аукциона).

accept_second_pay_type: boolean

Возможность принимать другой тип оплаты (с НДС или без НДС).

nds: double (nullable)

Ставка НДС.

end_date_boundary: date-time (nullable)

Время окончания торгов (аукциона), после которого они автоматически завершаются, если нет автопродления.

auto_renew*: boolean

Автопродление торгов (аукциона) при выставлении ставки в последние 5 минут до окончания торгов (аукциона).

renew_time: int32 (nullable)

Время, на которое сдвигается окончание торгов (аукциона) при включенном AutoRenew (в минутах).

max_renew_time: int32 (nullable)

Максимально допустимое время, на которое сдвигается окончание торгов (аукциона) при включенном AutoRenew (в минутах).

is_antisniper: boolean

Опция Антиснайпер.

raise_bid: boolean

Автоповышение ставки на Шаг (step), если нет предложений.

max_rate: double (nullable)

Максимально допустимая ставка по торгам (аукциону) при автоповышении (RaiseBid = true).

raise_bid_interval: int32 (nullable)

Период увеличения ставки в минутах при автоповышении (RaiseBid = true).

response_in_minutes: int32 (nullable)

Количество минут с момента начала торгов (аукциона), после которых можно принимать встречные предложения (0 — встречные предложения разрешены сразу).

finish_type: enum
[0, 1, 2]

Тип окончания аукциона

  • 0 - По времени
  • 1 - По минимальной ставке
  • 2 - Досрочное
duration: int32

Длительность торгов (аукциона) в минутах.

start_since_first_bet: boolean

Длительность торгов (аукциона) отсчитывается с момента первой ставки.

active_deal_id: uuid (nullable)

Id сделки, привязанной к торгам (аукциону).

time_to_provide_documents: double (nullable)

Время на предоставление перевозчиком данных для заявки (в часах).

win_date: date-time (nullable)

Время выигрыша ставки (только для победителя).

docs_expired_date: date-time (nullable)

Время окончания подачи документов (только для победителя).

is_docs_expired: boolean (nullable)

Время подачи документов истекло (только для победителя).

next_rate_with_nds: double (nullable)

Следующая возможная ставка с НДС.

next_rate_without_nds: double (nullable)

Следующая возможная ставка без НДС.

state: enum
[0, 1, -100, -14, -13, -12, -11, -10, -9, -8, -7, -6, -5, -4, -3, -2, -1]

Статус аукциона

  • -100 - Не удалось определить состояние аукциона
  • -14 - Аукцион отменен руками грузовладельца
  • -13 - Аукцион удален, т.к. расторгнут заказ
  • -12 - Аукцион без ставок завершен
  • -11 - Аукцион удален автоматически
  • -10 - Аукцион удален т.к. сделка завершена
  • -9 - Аукцион удален
  • -8 - При включенном копировании грузов: ожидается действие от экспедитора в случае, когда заказ с победителем отменен, других участников нет
  • -7 - При включенном копировании грузов:ожидается действие с торгами от экспедитора в случае, когда заказ с победителем отменен и есть потенциальный победитель
  • -6 - При включенном копировании грузов: торги завершены, экспедитор не является победителем
  • -5 - Одна ставка лучшая по цене, другая по дате
  • -4 - Закончился, но победитель вовремя не взял груз и при этом есть еще возможные победители
  • -3 - Закончился, но победитель вовремя не взял груз и при этом он единственный возможный победитель
  • -2 - Закончился, ждем когда победитель возьмет груз
  • -1 - Закончился, ставок нет
  • 0 - Идет, ставок нет
  • 1 - Идет (уже есть валидные ставки)
deleted*: boolean

Аукцион помечен удаленным - спустя некоторое время он автоматически удалится полностью.

auction_id*: uuid

Id торгов (аукциона).

load_id*: uuid

Id груза, для которого активны торги (аукцион).

finished*: boolean

Завершены ли торги (аукцион).

currency*: int32

Валюта ставки на груз.

start_date*: date-time

Время начала торгов (аукциона).

end_date: date-time (nullable)

Время окончания торгов (аукциона).

participants_count*: int32

Количество участников.

server_date*: date-time

Серверное время. Для синхронизации торгов (аукциона).

read only
current_rate_with_nds: double (nullable)

Текущая ставка с НДС.

current_rate_without_nds: double (nullable)

Текущая ставка без НДС.

response_prohibited: boolean (nullable)

Встречные предложения запрещены.

refuse_bet_prohibited: boolean (nullable)

Отмена ставки запрещена.

winner_criterion: enum
[0, 1]

Критерий победы в аукционе

  • 0 - Выбор победителя происходит автоматически по лучшей ставке
  • 1 - Выбор победителя происходит по ставке и дате загрузки. Если нет лучшей ставки с лучшей датой - требуется выбор победителя вручную
}
Пример
{...}
"step":500,
"accept_second_pay_type":true,
"nds":22,
"end_date_boundary":"2026-10-20T12:06:11.0264125Z",
"auto_renew":true,
"renew_time":20,
"max_renew_time":60,
"is_antisniper":true,
"raise_bid":true,
"max_rate":6000,
"raise_bid_interval":30,
"response_in_minutes":0,
"auction_rates":[...],
{...},
"ati_id":"12345",
"source":0,
"auction_rate_id":"60b38d60-bd59-479d-a344-6c9dc7f67ab2",
"contact_id":0,
"added_at":"2026-10-20T12:01:11.0264048Z",
"rate_with_nds":5500,
"rate_without_nds":6600,
"state":0,
"loading_date":null
},
{...}
"ati_id":"33345",
"source":0,
"auction_rate_id":"90cd9f41-8520-46af-9471-4d206c75d32c",
"contact_id":0,
"added_at":"2026-10-20T12:02:11.0264071Z",
"rate_with_nds":5000,
"rate_without_nds":6000,
"state":1,
"loading_date":null
}
],
"finish_type":0,
"duration":6,
"start_since_first_bet":false,
"active_deal_id":"a2708595-5f89-4787-a34e-fdf7a2420720",
"time_to_provide_documents":3,
"win_date":"2026-10-20T12:06:11.0264122Z",
"docs_expired_date":"2026-10-20T15:06:11.0264099Z",
"is_docs_expired":false,
"auction_restart_parameters":{...},
"auction_finish_action":1,
"duration_after_restart":30,
"init_restart_count":1,
"current_restart_count":1,
"init_change_winner_count":2,
"current_change_winner_count":2,
"is_manually_restarted":false,
"rate_increase":null,
"rate_increase_option":null
},
"state":0,
"deleted":false,
"auction_id":"d3575e91-ea65-45e1-b970-e61a5b3159aa",
"load_id":"3cf61f34-0a5b-44d2-b3d2-ed728bb2a983",
"finished":true,
"currency":1,
"start_date":"2026-10-20T12:00:11.0264096Z",
"end_date":"2026-10-20T12:06:11.026413Z",
"participants_count":2,
"server_date":"2026-10-20T12:06:11.0266111Z",
"current_rate_with_nds":5000,
"current_rate_without_nds":6000,
"response_prohibited":false,
"winner_criterion":0
}
403 Forbidden
Модель
null
Пример
null
404 Not Found
Модель
null
Пример
null

После того, как победитель возьмет груз и отправит вам данные, вы сможете оформить с ним Заказ.

Полная документация API торгов.