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

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

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

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

 
Получение отзывов на конкретный груз фирмы. На данный момент можно получить только встречные предложения.
get
/v1.0/loads/new/{loadId}/responses
CURL 1C
CURL
Копировать

                
1C
Копировать

                
Пример ответа Ответ
200 Массив отзывов
Развернуть все Свернуть все
Пример Модель
[...]
{...}
"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"
}
}
]
[{...}]
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

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

}]
4XX Ошибка запроса. Подробнее про ошибки API
Развернуть все Свернуть все
Пример Модель
{...}
"Reason":"string",
"Error":"string"
}
{...}

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

Reason: string

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

Error: string

Ключ ошибки

}
Загрузка...
Развернуть все Свернуть все
Загрузка...
 
Получение встречных предложений на грузы фирмы с одной или несколькими ставками .
get
/v1.0/loads/new/responses
CURL 1C
CURL
Копировать

                
1C
Копировать

                
Пример ответа Ответ
200 Массив отзывов на все грузы фирмы
Развернуть все Свернуть все
Пример Модель
[...]
{...}
"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"
}
}
]
[{...}]
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

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

}]
4XX Ошибка запроса. Подробнее про ошибки API
Развернуть все Свернуть все
Пример Модель
{...}
"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 1C
CURL
Копировать

                
1C
Копировать

                
Пример ответа Ответ
200 Приглашение отправлено
Развернуть все Свернуть все
4XX Ошибка запроса. Подробнее про ошибки API
Развернуть все Свернуть все
Пример Модель
{...}
"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 1C
CURL
Копировать

                
1C
Копировать

                
Пример ответа Ответ
200 Приглашение отправлено
Развернуть все Свернуть все
4XX Ошибка запроса. Подробнее про ошибки API
Развернуть все Свернуть все
Пример Модель
{...}
"reason":"string",
"error":"string"
}
{...}

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

reason: string

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

error: string

Ключ ошибки

}
Загрузка...
Развернуть все Свернуть все
Загрузка...

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

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

 
Смена победителя Торгов (аукциона)
post
/v1.2/auction/bet/win/{auctionRateId}
CURL 1C
CURL
Копировать

                
1C
Копировать

                
Пример ответа Ответ
200 Торги (аукцион) грузовладельца
Развернуть все Свернуть все
Пример Модель
{...}
"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
}
{...}

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

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 - Не удалось определить состояние аукциона
  • -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 - Выбор победителя происходит по ставке и дате загрузки. Если нет лучшей ставки с лучшей датой - требуется выбор победителя вручную
}
403 У вас нет доступа на установление победной ставки
Развернуть все Свернуть все
404 Торги (аукцион) не найдены, либо груз не найден
Развернуть все Свернуть все
Загрузка...
Развернуть все Свернуть все
Загрузка...

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

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