Skip to content
Мои токены Поддержка
Чат для вопросов по API Мгновенно ответим на ваши вопросы
api@ati.su Электронная почта техподдержки
Тикетная система Оставить заявку на отдел "Консультанты по интеграции (API)"
api.ati.su - заказы, торги, площадки Наш телеграм-канал
Авторизоваться
Для подтверждения действия введите пароль
Чтобы продолжить, введите пароль для пользователя
Отменить

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

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

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

Получение отзывов на конкретный груз фирмы. На данный момент можно получить только встречные предложения.
get /v1.0/loads/new/{loadId}/responses
Запрос
Пример запроса 
curl 'https://api.ati.su/v1.0/loads/new/{loadId}/responses' \
  -X 'GET' \
  -H 'Authorization: Bearer {authorizationToken}' \
  -H 'Content-Type: application/json'
Ответ
200 Массив отзывов
Модель
[{...}]
ResponseId: guid

Id отзыва

LoadId: guid

Id груза, на который оставлен отзыв

LoadNumber: string

Номер груза

LoadFirmId: int32

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

FirmId: int32

Id фирмы, которая оставила отзыв

FirmName: string

Название фирмы

ContactId: int32

Контакт, который сделал встречное предложение

AddedAt: date-time

Дата добавления отзыва

UpdatedAt: date-time

Дата изменения отзыва

Price: decimal

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

CurrencyId: int32

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

NdsPrice: decimal

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

NdsCurrencyId: int32

Валюта ставки встречного предложения б/нал с НДС.Параметр должен быть равен валюте, указанной в грузе, если параметр FixedRate равен True и параметр Torg равен False.
Значение из словаря валют АТИ

NotNdsPrice: decimal

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

NotNdsCurrencyId: int32

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

CounterOfferSource: enum
[0, 1, 2, 3, 4, 5, 6]

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

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

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

PayAttributes: int32

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

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

Процент предоплаты
Должен быть равен 0 или отсутствовать, если PayAttributes не содержит флаг 16 - возможна предоплата. Допустимое значение от 0 до 100

PayAfterMaxBankDays: int32

Оплата через ... банковских дней
Должен быть равен 0 или отсутствовать, если PayAttributes не содержит флаг 64 - включена оплата через некоторое количество банковских дней. Допустимое значение от 0 до 99

LoadingDate: date-time (nullable)

Дата, когда предложивший хочет перевезти ваш груз

IsOutdated: boolean

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

IsLoadPublished: boolean

Относится ли отзыв к публикующемуся грузу

IsNoLoad: boolean

Параметр "Груза нет"

AnnouncedCurrencyId: int32

Валюта "Озвученной ставки"
Значение из словаря валют АТИ

AnnouncedRate: int32

Озвученная ставка

}]
Пример
[...]
{...}
"ResponseId":"3fa85f64-5717-4562-b3fc-2c963f66afa6",
"LoadId":"3fa85f64-5717-4562-b3fc-2c963f66afa6",
"LoadNumber":"string",
"LoadFirmId":0,
"FirmId":0,
"FirmName":"string",
"ContactId":0,
"AddedAt":"1970-01-01T00:00:00.000Z",
"UpdatedAt":"1970-01-01T00:00:00.000Z",
"Price":0.5,
"CurrencyId":0,
"NdsPrice":0.5,
"NdsCurrencyId":0,
"NotNdsPrice":0.5,
"NotNdsCurrencyId":0,
"CounterOfferSource":0,
"Note":"string",
"PayAttributes":0,
"PrepayPercent":0,
"PayAfterMaxBankDays":0,
"LoadingDate":"1970-01-01T00:00:00.000Z",
"IsOutdated":false,
"IsLoadPublished":false,
"IsNoLoad":false,
"AnnouncedCurrencyId":0,
"AnnouncedRate":0,
"FirmInfo":{...}
"TotalScore":0.5,
"Status":0,
"FullFirmName":"string",
"Contact":{...},
"Id":0,
"Name":"string",
"Telephone":"string",
"Email":"string",
"Icq":"string",
"Mobile":"string",
"MobileOperator":"string",
"SkypeName":"string",
"CityId":0,
"Location":{...}
"CityId":0,
"RegionId":0,
"CountryId":0,
"FullName":"string",
"ShortName":"string",
"IsRegionalCenter":false,
"CitySize":0,
"FiasId":"3fa85f64-5717-4562-b3fc-2c963f66afa6",
"CityName":"string",
"RegionName":"string",
"CountryName":"string",
"CountryCodeName":"string"
}
},
"Inn":"string"
}
}
]
4XX Ошибка запроса. [Подробнее про ошибки API](https://ati.su/developers/api/loads/#loads-title-errors)
Модель
{...}

Модель ошибки

Reason: string

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

Error: string

Ключ ошибки

}
Пример
{...}
"Reason":"string",
"Error":"string"
}
Получение встречных предложений на грузы фирмы с одной или несколькими ставками .
get /v1.0/loads/new/responses
Запрос
Пример запроса 
curl 'https://api.ati.su/v1.0/loads/new/responses' \
  -X 'GET' \
  -H 'Authorization: Bearer {authorizationToken}' \
  -H 'Content-Type: application/json'
Ответ
200 Массив отзывов на все грузы фирмы
Модель
[{...}]
ResponseId: guid

Id отзыва

LoadId: guid

Id груза, на который оставлен отзыв

LoadNumber: string

Номер груза

LoadFirmId: int32

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

FirmId: int32

Id фирмы, которая оставила отзыв

FirmName: string

Название фирмы

ContactId: int32

Контакт, который сделал встречное предложение

AddedAt: date-time

Дата добавления отзыва

UpdatedAt: date-time

Дата изменения отзыва

Price: decimal

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

CurrencyId: int32

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

NdsPrice: decimal

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

NdsCurrencyId: int32

Валюта ставки встречного предложения б/нал с НДС.Параметр должен быть равен валюте, указанной в грузе, если параметр FixedRate равен True и параметр Torg равен False.
Значение из словаря валют АТИ

NotNdsPrice: decimal

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

NotNdsCurrencyId: int32

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

CounterOfferSource: enum
[0, 1, 2, 3, 4, 5, 6]

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

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

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

PayAttributes: int32

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

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

Процент предоплаты
Должен быть равен 0 или отсутствовать, если PayAttributes не содержит флаг 16 - возможна предоплата. Допустимое значение от 0 до 100

PayAfterMaxBankDays: int32

Оплата через ... банковских дней
Должен быть равен 0 или отсутствовать, если PayAttributes не содержит флаг 64 - включена оплата через некоторое количество банковских дней. Допустимое значение от 0 до 99

LoadingDate: date-time (nullable)

Дата, когда предложивший хочет перевезти ваш груз

IsOutdated: boolean

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

IsLoadPublished: boolean

Относится ли отзыв к публикующемуся грузу

IsNoLoad: boolean

Параметр "Груза нет"

AnnouncedCurrencyId: int32

Валюта "Озвученной ставки"
Значение из словаря валют АТИ

AnnouncedRate: int32

Озвученная ставка

}]
Пример
[...]
{...}
"ResponseId":"3fa85f64-5717-4562-b3fc-2c963f66afa6",
"LoadId":"3fa85f64-5717-4562-b3fc-2c963f66afa6",
"LoadNumber":"string",
"LoadFirmId":0,
"FirmId":0,
"FirmName":"string",
"ContactId":0,
"AddedAt":"1970-01-01T00:00:00.000Z",
"UpdatedAt":"1970-01-01T00:00:00.000Z",
"Price":0.5,
"CurrencyId":0,
"NdsPrice":0.5,
"NdsCurrencyId":0,
"NotNdsPrice":0.5,
"NotNdsCurrencyId":0,
"CounterOfferSource":0,
"Note":"string",
"PayAttributes":0,
"PrepayPercent":0,
"PayAfterMaxBankDays":0,
"LoadingDate":"1970-01-01T00:00:00.000Z",
"IsOutdated":false,
"IsLoadPublished":false,
"IsNoLoad":false,
"AnnouncedCurrencyId":0,
"AnnouncedRate":0,
"FirmInfo":{...}
"TotalScore":0.5,
"Status":0,
"FullFirmName":"string",
"Contact":{...},
"Id":0,
"Name":"string",
"Telephone":"string",
"Email":"string",
"Icq":"string",
"Mobile":"string",
"MobileOperator":"string",
"SkypeName":"string",
"CityId":0,
"Location":{...}
"CityId":0,
"RegionId":0,
"CountryId":0,
"FullName":"string",
"ShortName":"string",
"IsRegionalCenter":false,
"CitySize":0,
"FiasId":"3fa85f64-5717-4562-b3fc-2c963f66afa6",
"CityName":"string",
"RegionName":"string",
"CountryName":"string",
"CountryCodeName":"string"
}
},
"Inn":"string"
}
}
]
4XX Ошибка запроса. [Подробнее про ошибки API](https://ati.su/developers/api/loads/#loads-title-errors)
Модель
{...}

Модель ошибки

Reason: string

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

Error: string

Ключ ошибки

}
Пример
{...}
"Reason":"string",
"Error":"string"
}

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

Отправка приглашения по встречному предложению
post /v1.2/orders/invites/counter_offer
Запрос
Модель
{...}
load_id: guid

Id груза

response_id: guid

Id встречного приглашения. Значение из метода получения отзывов

rate_types: [enum]
[0, 1, 2]

По каким ставкам отправить приглашение. Типы ставок:

  • 0 — наличные
  • 1 — б/нал с НДС
  • 2 — б/нал без НДС
cancel_after_in_minutes: int32 (nullable)

Через сколько минут отменить приглашение "Оформить Заказ". Допустимое значение от 1 до 4320 минут. По умолчанию - 4320 (3 суток)

is_auto: boolean

Приглашение создано автоматически

}
Пример запроса 
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,"is_auto":false}'
Ответ
200 Приглашение отправлено
Модель
null
Пример
null
4XX Ошибка запроса. [Подробнее про ошибки API](https://ati.su/developers/documentation/errors/)
Модель
{...}

Модель ошибки

reason: string

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

error: string

Ключ ошибки

}
Пример
{...}
"reason":"string",
"error":"string"
}

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

Отправка приглашения
post /v1.2/orders/invites
Запрос
Модель
{...}
load_id*: guid
Минимальное количество символов: 1

Id груза

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

Id аккаунта приглашаемой фирмы

taker_contacts_list*: [int32]

Список контактов приглашаемой фирмы

cancel_after_in_minutes: int32 (nullable)

Через сколько минут отменить приглашение "Оформить Заказ". Допустимое значение от 1 до 4320 минут. По умолчанию - 4320 (3 суток)

deprecated
cancellation_date: date-time (nullable)

Дата отмены предложения на перевозку груза, формат ISO 8601

is_tracking: boolean

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

}
Пример запроса 
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":{"price":10000,"currency_id":32,"nds_price":0.5,"nds_currency_id":0,"not_nds_price":0.5,"not_nds_currency_id":0},"cancellation_date":"1970-01-01T00:00:00.000Z","is_tracking":false}'
Ответ
200 Приглашение отправлено
Модель
null
Пример
null
4XX Ошибка запроса. [Подробнее про ошибки API](https://ati.su/developers/documentation/errors/)
Модель
{...}

Модель ошибки

reason: string

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

error: string

Ключ ошибки

}
Пример
{...}
"reason":"string",
"error":"string"
}

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

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

Смена победителя Торгов (аукциона)
post /v1.2/auction/bet/win/{auctionRateId}
Запрос
Пример запроса 
curl 'https://api.ati.su/v1.2/auction/bet/win/{auctionRateId}' \
  -X 'POST' \
  -H 'Authorization: Bearer {authorizationToken}' \
  -H 'Content-Type: application/json'
Ответ
200 Торги (аукцион) грузовладельца
Модель
{...}

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

accept_second_pay_type: boolean

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

active_deal_id: uuid

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

auction_id*: uuid

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

auto_renew*: boolean

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

currency*: int32

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

current_rate_with_nds: double

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

current_rate_without_nds: double

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

deleted*: boolean

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

docs_expired_date: date-time

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

duration: int32

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

end_date: date-time

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

end_date_boundary: date-time

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

finish_type: enum
[0, 1, 2]

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

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

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

is_docs_expired: boolean

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

load_id*: uuid

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

max_rate: double

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

max_renew_time: int32

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

nds: double

Ставка НДС

next_rate_with_nds: double

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

next_rate_without_nds: double

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

participants_count*: int32

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

raise_bid: boolean

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

raise_bid_interval: int32

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

refuse_bet_prohibited: boolean

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

renew_time: int32

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

response_in_minutes: int32

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

response_prohibited: boolean

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

server_date*: date-time

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

start_date*: date-time

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

start_since_first_bet: boolean

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

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 - Идёт (уже есть валидные ставки)
step*: double

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

time_to_provide_documents: double

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

win_date: date-time

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

winner_criterion: enum
[0, 1]

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

  • 0 - Выбор победителя происходит автоматически по лучшей ставке
  • 1 - Выбор победителя происходит по ставке и дате загрузки. Если нет лучшей ставки с лучшей датой - требуется выбор победителя вручную
}
Пример
{...}
"accept_second_pay_type":true,
"active_deal_id":"c7ba865c-6dd2-43e4-bb29-66df7583989a",
"auction_id":"c771ed18-84e4-4ab8-8f91-1be412274d86",
"auction_rates":[...],
{...},
"added_at":"2023-04-24T11:31:52.0690515Z",
"ati_id":"12345",
"auction_rate_id":"5a2e6b1c-b02a-45b0-9136-f64a9236ab21",
"contact_id":0,
"loading_date":null,
"rate_with_nds":5500,
"rate_without_nds":6600,
"source":0,
"state":0
},
{...}
"added_at":"2023-04-24T11:32:52.0690605Z",
"ati_id":"33345",
"auction_rate_id":"cd342abc-ac8d-4b08-87d3-def8f125b28d",
"contact_id":0,
"loading_date":null,
"rate_with_nds":5000,
"rate_without_nds":6000,
"source":0,
"state":1
}
],
"auction_restart_parameters":{...},
"auction_finish_action":1,
"current_change_winner_count":2,
"current_restart_count":1,
"duration_after_restart":30,
"init_change_winner_count":2,
"init_restart_count":1,
"is_manually_restarted":false,
"rate_increase":null,
"rate_increase_option":null
},
"auto_renew":true,
"currency":1,
"current_rate_with_nds":5000,
"current_rate_without_nds":6000,
"deleted":false,
"docs_expired_date":"2023-04-24T14:36:52.0690757Z",
"duration":6,
"end_date":"2023-04-24T11:36:52.0690878Z",
"end_date_boundary":"2023-04-24T11:36:52.0690866Z",
"finish_type":0,
"finished":true,
"is_docs_expired":false,
"load_id":"a86db870-967e-4893-b6e1-fef16c73b054",
"max_rate":6000,
"max_renew_time":60,
"nds":20,
"participants_count":2,
"raise_bid":true,
"raise_bid_interval":30,
"renew_time":20,
"response_in_minutes":0,
"response_prohibited":false,
"server_date":"2023-04-24T11:36:52.069361Z",
"start_date":"2023-04-24T11:30:52.0690743Z",
"start_since_first_bet":false,
"state":0,
"step":500,
"time_to_provide_documents":3,
"win_date":"2023-04-24T11:36:52.0690844Z",
"winner_criterion":0
}
403 У вас нет доступа на установление победной ставки
Модель
null
Пример
null
404 Торги (аукцион) не найдены, либо груз не найден
Модель
null
Пример
null

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

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