Как найти груз
Через API поддержана возможность поиска грузов только на Персональных площадках.
Если вы еще не состоите ни на одной Персональной площадке:
- попросите зарегистрированных на ATI.SU грузовладельцев, с которыми вы сотрудничаете, добавить вас на их Персональные площадки;
- вступите на открытую Площадку;
- либо самостоятельно создайте площадку типа «Грузы/машины для владельца Площадки» и пригласите на нее знакомых вам грузовладельцев, зарегистрированных на ATI.SU.
Создать площадку
post /v2/boards/public/boards/create
Площадка доступна всем подразделениям компании. Такую площадку могут видеть все сотрудники, независимо от их подразделения Если передано true, то DepartmentsIds должен быть null или пустым Пример: true
Направление обмена информацией на площадке (влияет на права доступа участников по умолчанию)
exchange
— Обмен грузами/машинамиinput
— Грузы/машины для владельца площадкиoutput
- Грузы/машины от владельца площадки
Тип содержимого на площадке
loads
- Площадка с грузамиtrucks
- Площадка с машинами (зарезервировано, в данный момент такая возможность ещё не доступна)
Цвет плашки площадки
Пример: "#FF00FF"
Перечень подразделений компании, которым доступна площадка.
В случае, если передан не пустой перечень значение AllDepartmentsAllowed должно быть false.
Ответственный контакт ResponsibleContactId должен состоять (принадлежать) хотя бы одному из указанных подразделений
Пример: [100302, 100303]
Описание площадки (можно использовать тэги "b", "i", "span", "u", "ul", "li", "br")
Пример: "Лучшая площадка из всех созданных"
Публичное имя, видимое участникам площадки (до 50 символов)
Пример: "Приходите, покупайте"
Имя, которое видит только владелец площадки (до 50 символов)
Пример: "Покупайте, приходите"
Открытая площадка или закрытая. На открытую может подать заявку на вступление любой пользователь. На закрытую можно
попасть только по приглашению владельца.
Пример: true
ID контакта ответственного пользователя
Пример: 1
Правила участия, которые требуется принять участникам при вступлении (можно использовать тэги "b", "i", "span", "u", "ul", "li", "br")
Пример: "Только красные машины"
curl 'https://api.ati.su/v2/boards/public/boards/create' \ -X 'POST' \ -H 'Authorization: Bearer {authorizationToken}' \ -H 'Content-Type: application/json' \ --data-raw '{"all_departments_allowed":false,"board_exchange_direction":"input","board_type":"loads","color":"string","departments_ids":[0],"description":"string","name_for_users":"string","private_name":"string","public":false,"responsible_contact_id":0,"rules":"string"}'
Процедура ВыполнитьHTTPЗапрос(МетодЗапроса, АдресХоста, АдресРесурса, ТекстЗапроса) Экспорт ЗаголовкиHTTP = Новый Соответствие(); ЗаголовкиHTTP.Вставить("Accept", "application/json"); ЗаголовкиHTTP.Вставить("Content-Type", "application/json"); ЗаголовкиHTTP.Вставить("Authorization", "Bearer {authorizationToken}"); HTTPЗапрос = Новый HTTPЗапрос(АдресРесурса, ЗаголовкиHTTP); HTTPЗапрос.УстановитьТелоИзСтроки(ТекстЗапроса, КодировкаТекста.UTF8, ИспользованиеByteOrderMark.НеИспользовать); ЗащищенноеСоединениеSSL = Новый ЗащищенноеСоединениеOpenSSL(Новый СертификатКлиентаWindows, Новый СертификатыУдостоверяющихЦентровWindows);
Соединение = Новый HTTPСоединение(АдресХоста,,,,,, ЗащищенноеСоединениеSSL);
Попытка Ответ = Соединение.ВызватьHTTPМетод(МетодЗапроса, HTTPЗапрос); Сообщить("Код ответа: " + Ответ.КодСостояния); Сообщить("Ответ: " + Ответ.ПолучитьТелоКакСтроку("UTF-8")); Исключение Сообщить("Ошибка выполнения запроса!" + Символы.ПС + ОписаниеОшибки()); КонецПопытки;КонецПроцедуры
ВыполнитьHTTPЗапрос("POST", "https://api.ati.su", "/v2/boards/public/boards/create", "{""all_departments_allowed"":false,""board_exchange_direction"":""input"",""board_type"":""loads"",""color"":""string"",""departments_ids"":[0],""description"":""string"",""name_for_users"":""string"",""private_name"":""string"",""public"":false,""responsible_contact_id"":0,""rules"":""string""}");
200 Данные о площадке
Информация о площадке (api v2)
Площадка доступна всем подразделениям компании. Такую площадку могут видеть все сотрудники, независимо от их подразделения Пример: true
Площадка доступна для данного контакта
Пример: true
Направление обмена информацией на площадке (влияет на права доступа участников по умолчанию)
exchange
— Обмен грузами/машинамиinput
— Грузы/машины для владельца площадкиoutput
- Грузы/машины от владельца площадки
Тип содержимого на площадке
loads
- Площадка с грузамиtrucks
- Площадка с машинами (зарезервировано, в данный момент такая возможность ещё не доступна)
Цвет площадки
Пример: "#FF00FF"
Время создания площадки (timestamp)
Пример: 1556201954901
Перечень подразделений компании, которым доступна площадка
Пример: [100302, 100303]
ID площадки (строка 24 символа)
Пример: "507f1f77bcf86cd799439011"
Название площадки
Пример: "Образцово-показательная площадка"
Код участника ATI.SU создавшего площадку
Пример: 1111111
Последнее время изменения площадки (Timestamp)
Пример: 1556201954901
Участник может видеть только свои грузы/машины
Пример: true
400 Ошибка валидации или другая
Код ошибки
Текст ошибки
Детали ошибки при валидации запроса. Поле может отсутствовать в ответе, если для данного типа ошибки оно не предусмотрено
Список ошибок. Поле может отсутствовать в ответе, если для данного типа ошибки оно не предусмотрено
Пригласить участника ATI.SU на площадку (создание участника площадки с типом Invited)
post /v2/boards/public/participants/invite
код участника в ATI.SU
ID площадки
ID контакта
curl 'https://api.ati.su/v2/boards/public/participants/invite' \ -X 'POST' \ -H 'Authorization: Bearer {authorizationToken}' \ -H 'Content-Type: application/json' \ --data-raw '{"ati_id":"string","board_id":"string","contact_id":0}'
Процедура ВыполнитьHTTPЗапрос(МетодЗапроса, АдресХоста, АдресРесурса, ТекстЗапроса) Экспорт ЗаголовкиHTTP = Новый Соответствие(); ЗаголовкиHTTP.Вставить("Accept", "application/json"); ЗаголовкиHTTP.Вставить("Content-Type", "application/json"); ЗаголовкиHTTP.Вставить("Authorization", "Bearer {authorizationToken}"); HTTPЗапрос = Новый HTTPЗапрос(АдресРесурса, ЗаголовкиHTTP); HTTPЗапрос.УстановитьТелоИзСтроки(ТекстЗапроса, КодировкаТекста.UTF8, ИспользованиеByteOrderMark.НеИспользовать); ЗащищенноеСоединениеSSL = Новый ЗащищенноеСоединениеOpenSSL(Новый СертификатКлиентаWindows, Новый СертификатыУдостоверяющихЦентровWindows);
Соединение = Новый HTTPСоединение(АдресХоста,,,,,, ЗащищенноеСоединениеSSL);
Попытка Ответ = Соединение.ВызватьHTTPМетод(МетодЗапроса, HTTPЗапрос); Сообщить("Код ответа: " + Ответ.КодСостояния); Сообщить("Ответ: " + Ответ.ПолучитьТелоКакСтроку("UTF-8")); Исключение Сообщить("Ошибка выполнения запроса!" + Символы.ПС + ОписаниеОшибки()); КонецПопытки;КонецПроцедуры
ВыполнитьHTTPЗапрос("POST", "https://api.ati.su", "/v2/boards/public/participants/invite", "{""ati_id"":""string"",""board_id"":""string"",""contact_id"":0}");
200 ID приглашения
400 Ошибка валидации
Код ошибки
Текст ошибки
Детали ошибки при валидации запроса. Поле может отсутствовать в ответе, если для данного типа ошибки оно не предусмотрено
Список ошибок. Поле может отсутствовать в ответе, если для данного типа ошибки оно не предусмотрено
Полная документация API Площадок.
После того, как вы вступите на Персональную площадку, вы сможете получать грузы, размещенные на ней, используя соответствующий метод:
Проводит поиск грузов, которые размещены на указанных площадках. В результате присутствуют как ваши грузы, так и грузы других пользователей. get /v1.0/loads/search/byboards
curl 'https://api.ati.su/v1.0/loads/search/byboards' \ -X 'GET' \ -H 'Authorization: Bearer {authorizationToken}' \ -H 'Content-Type: application/json'
Процедура ВыполнитьHTTPЗапрос(МетодЗапроса, АдресХоста, АдресРесурса, ТекстЗапроса) Экспорт ЗаголовкиHTTP = Новый Соответствие(); ЗаголовкиHTTP.Вставить("Accept", "application/json"); ЗаголовкиHTTP.Вставить("Content-Type", "application/json"); ЗаголовкиHTTP.Вставить("Authorization", "Bearer {authorizationToken}"); HTTPЗапрос = Новый HTTPЗапрос(АдресРесурса, ЗаголовкиHTTP); HTTPЗапрос.УстановитьТелоИзСтроки(ТекстЗапроса, КодировкаТекста.UTF8, ИспользованиеByteOrderMark.НеИспользовать); ЗащищенноеСоединениеSSL = Новый ЗащищенноеСоединениеOpenSSL(Новый СертификатКлиентаWindows, Новый СертификатыУдостоверяющихЦентровWindows);
Соединение = Новый HTTPСоединение(АдресХоста,,,,,, ЗащищенноеСоединениеSSL);
Попытка Ответ = Соединение.ВызватьHTTPМетод(МетодЗапроса, HTTPЗапрос); Сообщить("Код ответа: " + Ответ.КодСостояния); Сообщить("Ответ: " + Ответ.ПолучитьТелоКакСтроку("UTF-8")); Исключение Сообщить("Ошибка выполнения запроса!" + Символы.ПС + ОписаниеОшибки()); КонецПопытки;КонецПроцедуры
ВыполнитьHTTPЗапрос("GET", "https://api.ati.su", "/v1.0/loads/search/byboards");
200 Массив грузов, которые опубликованы на выбранных площадках
Метаданные для интеграторов
Идентификатор метаданных
Метаданные
Максимальная длина 1024 символа
Идентификатор первого выбранного контакта.
Список всех контактов и их идентификаторы можно получить с помощью API для работы с фирмами
Контакт должен быть виден для остальных участников АТИ
Идентификатор второго выбранного контакта, если не выбрано, то null
Контакт должен быть виден для остальных участников АТИ
Примечание к грузу
Ограничение по длине: 1000 символов
Дата, начиная с которой груз актуален, в формате UTC
Минимальное значение равно текущей дате
При значении параметра DateType равным 0, допустимое значение поля - текущая дата
При значении параметра DateType равным 1, допустимое значение поля - от текущей даты до 60 дней вперед
При значении параметра DateType равным 2, допустимое значение поля - текущая дата
При значении параметра DateType равным 3, FirstDate должен принимать значение текущей даты или отсутствовать
Дата, после которой груз не актуален, в формате UTC
Минимальное значение равно значению параметра FirstDate
При значении параметра DateType равным 0, допустимое значение поля - от текущей даты до 1 дня вперед
При значении параметра DateType равным 1, допустимое значение поля - от даты в параметре FirstDate до 9 дней вперед
При значении параметра DateType равным 2, данное поле вычисляется автоматически по формуле FirstDate + 2 месяца, передаваемое значение игнорируется
При значении параметра DateType равным 3, LastDate автоматически устанавливается на значение + 2 дня от текущей даты, передаваемое значение игнорируется
Выбор типа готовности груза к перевозке
0
- Готов к загрузке1
- с Х по У2
- постоянно3
- груза нет, запрос ставки
Периодичность загрузки
Если параметр DateType не равен 2, PeriodicityId равен 0.
Иначе PeriodicityId может принимать следующие значения:
1
- ежедневно100
- по рабочим дням
Номер заказа
Ограничение по длине: 250 символов
Параметр, который определяет, включен ли кругорейс для перевозки груза
Загрузка
Идентификатор города загрузки/разгрузки
Значение из словаря городов АТИ
Широта города загрузки/разгрузки
Параметр должен быть указан, если не указана улица (параметр Street равен null или имеет длину менее 5 символов) и выполняется хотя бы одно из трех условий:
- указан город Москва;
- указан город Санкт-Петербург;
- города загрузки и разгрузки совпадают.
Если параметр Longitude задан, то необходимо указать и этот параметр.
Допустимое значение от -90 до 90.
Долгота города загрузки/разгрузки
Параметр должен быть указан, если не указана улица (параметр Street равен null или имеет длину менее 5 символов) и выполняется хотя бы одно из трех условий:
- указан город Москва;
- указан город Санкт-Петербург;
- города загрузки и разгрузки совпадают.
Если параметр Latitude задан, то необходимо указать и этот параметр.
Допустимое значение от -90 до 90.
Улица или район города загрузки/разгрузки
Параметр должен быть указан и иметь длину не менее 5 символов, если не указаны координаты (параметры Longtittude и Lattitude равны null) и выполняется хотя бы одно из трех условий:
- указан город Москва;
- указан город Санкт-Петербург;
- города загрузки и разгрузки совпадают.
Максимальная длина 100 символов.
Время начала загрузки/разгрузки
Не указывается при значении параметра DateType равным 3.
Не указывается при значении IsRoundTheClock: true
Время завершения загрузки/разгрузки
Не указывается при значении параметра DateType равным 3.
Не указывается при значении IsRoundTheClock: true
Определяет выбрано ли значение Круглосуточно
По умолчанию - false
Не указывается при значении параметра DateType равным 3.
Массив идентификаторов ближайших крупных городов
Значение из словаря городов АТИ
Максимальное количество - 10 штук
Id груза
Наименование груза
Упаковка
Объем
Габариты
Список дополнительных пунктов маршрута
Максимальное количество - 15 штук
Идентификатор города
Значение из словаря городов АТИ
Тип точки:
1
- загрузка2
- разгрузка3
- таможня8
- проехать через
Долгота
Широта
Улица или район
Порядковый номер
Загрузка/разгрузка круглосуточно
Дата начала периода загрузки/разгрузки
Дата окончания периода загрузки/разгрузки
Время начала загрузки/разгрузки
Время окончания загрузки/разгрузки
Id груза
Наименование груза
Упаковка
Объем
Габариты
Id груза
Вес
Объём
Выгружаемая часть упаковки
Выгружаемая часть груза будет определена в ТТН
Разгрузка
Идентификатор города загрузки/разгрузки
Значение из словаря городов АТИ
Широта города загрузки/разгрузки
Параметр должен быть указан, если не указана улица (параметр Street равен null или имеет длину менее 5 символов) и выполняется хотя бы одно из трех условий:
- указан город Москва;
- указан город Санкт-Петербург;
- города загрузки и разгрузки совпадают.
Если параметр Longitude задан, то необходимо указать и этот параметр.
Допустимое значение от -90 до 90.
Долгота города загрузки/разгрузки
Параметр должен быть указан, если не указана улица (параметр Street равен null или имеет длину менее 5 символов) и выполняется хотя бы одно из трех условий:
- указан город Москва;
- указан город Санкт-Петербург;
- города загрузки и разгрузки совпадают.
Если параметр Latitude задан, то необходимо указать и этот параметр.
Допустимое значение от -90 до 90.
Улица или район города загрузки/разгрузки
Параметр должен быть указан и иметь длину не менее 5 символов, если не указаны координаты (параметры Longtittude и Lattitude равны null) и выполняется хотя бы одно из трех условий:
- указан город Москва;
- указан город Санкт-Петербург;
- города загрузки и разгрузки совпадают.
Максимальная длина 100 символов.
Время начала загрузки/разгрузки
Не указывается при значении параметра DateType равным 3.
Не указывается при значении IsRoundTheClock: true
Время завершения загрузки/разгрузки
Не указывается при значении параметра DateType равным 3.
Не указывается при значении IsRoundTheClock: true
Определяет выбрано ли значение Круглосуточно
По умолчанию - false
Не указывается при значении параметра DateType равным 3.
Массив идентификаторов ближайших крупных городов
Значение из словаря городов АТИ
Максимальное количество - 10 штук
Id груза
Наименование груза
Упаковка
Объем
Габариты
Информация о грузе
Вес груза в тоннах
Обязательный параметр, если не задан параметр Volume.
Объем груза в кубических метрах
Обязательный параметр, если не задан параметр Weight. Максимальная длина - 4 символа
Параметр, определяющий степень опасности груза
Допустимое значение от 0 до 9. По умолчанию - 0
Идентификатор наименования груза
Значение из Словаря наименований грузов
Строковое наименование груза.
Обязательный параметр, если значение параметра CargoTypeId равно 59
.
Максимальная длина названия - 50 символов.
Этот параметр должен быть пустым, если параметр CargoTypeId
отличен от 59
.
В этом поле запрещено указывать контактную информацию
Идентификатор наименования упаковки (навалом, коробки, россыпью...)
Значение из Словаря наименований грузов
Количество упаковок для груза
Допустимое значение от 0 до 9999. По умолчанию - 0
Количество ремней для груза
Допустимое значение от 0 до 9999. По умолчанию - 0
Вариант перевозки:
1
- только отдельной машиной2
- отдельной или догрузом
Определяет, является ли груз сборным
Параметры размера груза
Длина груза в метрах
Допустимое значение от 0 до 50. Максимальная длина - 5 символов. По умолчанию - 0
Ширина груза в метрах
Допустимое значение от 0 до 50. Максимальная длина - 5 символов. По умолчанию - 0
Высота груза в метрах
Допустимое значение от 0 до 50. Максимальная длина - 5 символов. По умолчанию - 0
Диаметр груза в метрах
Допустимое значение от 0 до 50. Максимальная длина - 5 символов. По умолчанию - 0
Выделение красным цветом длины груза (для привлечения внимания перевозчика в случае нестандартных размеров груза)
Выделение красным цветом ширины груза (для привлечения внимания перевозчика в случае нестандартных размеров груза)
Выделение красным цветом высоты груза (для привлечения внимания перевозчика в случае нестандартных размеров груза)
Параметры транспорта
Битовая сумма ID кузовов
Значение из словаря кузовов АТИ
Битовая сумма ID типов загрузки
Значение из словаря вариантов загрузки АТИ
Тип условия загрузки:
OR
- необходимо, чтобы присутствовал один из способов загрузкиAND
- необходимо, чтобы присутствовали все выбранные типы загрузки
Битовая сумма ID типов разгрузки.
Значение из словаря вариантов разагрузки АТИ
Тип условия разгрузки:
OR
- необходимо, чтобы присутствовал один из способов разгрузкиAND
- необходимо, чтобы присутствовали все выбранные типы разгрузки
Количество машин
Допустимое значение от 1 до 99. По умолчанию - 1
Минимальная температура для груза, если выбран тип кузова "Рефрижератор", "Рефрижератор с перегородкой", "Рефрижератор-мультирежимный"
Допустимое значение от -99 до 999
Максимальная температура для груза, если выбран тип кузова "Рефрижератор", "Рефрижератор с перегородкой", "Рефрижератор-мультирежимный"
Допустимое значение от -99 до 999
Определяет, нужна ли сцепка для груза
Определяет, нужен ли пневмоход для груза
Определяет, нужны ли коники для груза
Документы на транспорт, необходимые для провоза этого груза: документы TIR
Документы на транспорт, необходимые для провоза этого груза: документы CMR
Документы на транспорт, необходимые для провоза этого груза: документы T1
Документы на транспорт, необходимые для провоза этого груза: медкнижка
Трекинг через АТИ Водитель
Оплата
Идентификатор валюты
По умолчанию - 1. Должен принимать значение 0, если параметр FixedRate равен false
Значение из словаря валют АТИ
Идентификатор варианта оплаты
По умолчанию - 22
. Должен принимать значение 22
, если параметр FixedRate
равен false
Значение из словаря вариантов оплаты АТИ
Ставка для груза
Обязательный параметр, если параметр FixedRate равен true и не заданы параметры SumWithNDS или SumWithoutNDS. Максимальная длина 6 символов. Если ввести более двух цифр после запятой, будет произведено округление. Если параметр MoneyType равен 22 и RateSum > 0, тогда поля SumWithNDS и SumWithoutNDS должны быть пустыми или принимать значение 0
Ставка б/нал с НДС
Обязательный параметр, если параметр FixedRate равен true и не заданы параметры RateSum или SumWithoutNDS. Максимальная длина 6 символов. Если ввести более двух цифр после запятой, будет произведено округление. Если параметр FixedRate равен false, то параметр SumWithNDS должен отсутствовать или быть равным 0
Ставка б/нал без НДС
Обязательный параметр, если параметр FixedRate равен true и не заданы параметры SumWithNDS или RateSum. Максимальная длина 6 символов. Если ввести более двух цифр после запятой, будет произведено округление. Если параметр FixedRate равен false, то параметр SumWithoutNDS должен отсутствовать или быть равным 0
Процент предоплаты
Допустимое значение от 0 до 100. Должен отсутствовать или принимать значение 0, если параметр PrepayPercentEnabled равен false
Есть ли предоплата
Через сколько банковских дней оплата
Допустимое значение от 0 до 99. Должен отсутствовать или принимать значение 0, если параметр PayDaysEnabled равен false
Параметр, что включен флажок "через банк. дней"
По умолчанию - false. Не может быть установлен в true, если параметр OnUnloading тоже установлен в true
true, если ставка задана, false если запрос ставки
По умолчанию - true. При значении параметра DateType равным 3, должен иметь значение false. Если указано значение True, значение хотя бы одного из полей RateSum, SumWithNDS, SumWithoutNDS должно быть больше или равно 1
Возможен ли торг
По умолчанию - false. Не учитывается, если параметр FixedRate равен false
Прямой договор
Предоплата топливом
Оплата на выгрузке
Скрыть встречные предложения
Позволяет указать форму оплаты при выборе параметра "Запрос ставки":
1
- наличные2
- б/нал с НДС3
- нал и б/нал с НДС4
- б/нал без НДС5
- нал и б/нал без НДС6
- б/нал с НДС и без НДС7
- нал и б/нал с НДС и без НДС0
- указана фикс. ставка
Настройки автоприглашений
Время в секундах сбора встречных предложений, по истечение которого будет создано приглашение по лучшему из них
Время в секундах действия приглашения
Приоритетный показ
Суточный лимит списания по услуге
- Должен иметь длину не более 5 символов
- Не более 2 символов после запятой
- Должен быть больше либо равен значению ViewRate или быть равным нулю (если ограничения нет)
- Должен быть равен 0 или отсутствовать, если параметр ViewRate отсутствует или равен 0
Показывать приоритетный показ только платным пользователям
Лимит на заявку
- Должен иметь длину не более 5 символов
- Не более 2 символов после запятой
- Должен быть больше либо равен значению ViewRate или быть равным нулю (если ограничения нет)
- Должен быть равен 0 или отсутствовать, если параметр ViewRate отсутствует или равен 0
Ставка за просмотр
- Минимальное значение 0,6
- Не более 2 символов после запятой
- Должен иметь длину не более 5 символов
Количество денег, потраченное на заявку за день. Только для чтения
Количество денег, потраченное на заявку в целом. Только для чтения
Настройки показа груза
Режим стэлс, ID списка для которого данный груз показываться не будет
Получить ID списка можно с помощью API списков фирмы
Режим стэлс, Для фирм с датой регистрации меньше данной груз показываться не будет
Режим стэлс, минимальное количество баллов фирмы. Для фирм с меньшим количество баллов груз показываться не будет
Файлы к грузу
Перед добавлением груза с файлом, файл предварительно необходимо загрузить в АТИ-Доки (см. API для хранения файлов)
Идентификатор файла, возвращается при загрузке файла в АТИ-Доки
Тип загруженного файла:
1
- документ
Битовый набор опции файла
0
- Значение по умолчанию. Данный файл доступен по ссылке1
- Данный файл доступен только владельцу груза
Имя файла
Для имени файла разрешено использовать следующие символы: цифры, заглавные и строчные буквы латинского и кириллического алфавита, дефис, точка, пробел.
Длинна: до 100 символов. Имя файла присваивается при загрузке в АТИ-Доки
Ссылка, по которой можно скачать файл, возвращается при загрузке файла в АТИ-Доки
Размер файла
Информационное поле, на текущий момент не используется
Параметры аукциона
Начальная ставка аукциона
Параметр должен принимать значение от 1 до 9999999999 (включительно) и содержать не более 10 символов.
Валюта аукциона
Значение из словаря валют АТИ
Минимальное изменение ставки по аукциону
Параметр должен принимать значение от 1 до 9999999999 (включительно), содержать не более 10 символов и не должен превышать половину начальной ставки startRate.
Тип оплаты
22
: любой1
: наличные23
: по карте24
: безнал с НДС25
: безнал без НДС
Принимать ставки без НДС. Параметр можно указать, если начальная ставка указана с НДС (PaymentType=24)
Время начала аукциона. Должно быть позже времени начала публикации груза на площадке. По умолчанию устанавливается текущая дата UTC.
Время окончания аукциона. Необязательное поле, если есть значение в поле Duration
Время окончания аукциона "завершить не позже". Если указанное время, меньше значения Duration - аукцион заканчивается по времени "завершить не позже", если нет автопродления. Время устанавливается в формате UTC.
% НДС, от 1 до 99. Если выбрана опция "Принимать ставки без НДС", этот параметр определяет величину процента НДС.
Время на отправку заявки перевозчиком (в часах). Время на отправку заявки перевозчику должно быть не больше 24 часов, и не должно превышать 4 символов в длину.
Нужно ли продление аукциона, если была ставка в последние 5 минут до окончания
Время, на которое надо сдвигать окончание аукциона при включенном AutoRenew
Максимально допустимое время, на которое можно сдвинуть окончание аукциона при включенном AutoRenew
Указывать, если raiseBid = true. Параметр должен принимать значение от 1 до 999999 (включительно) и содержать не более 6 символов.
Повысить ставку на Шаг, если нет предложений
Максимально допустимая ставка по аукциону
Указывать, если raiseBid = true. Параметр должен принимать значение от 1 до 999999 (включительно) и содержать не более 6 символов.
Период увеличения ставки при отсутствии предложений
При RaiseBid = true должно принимать значение не меньше 1 минуты и не больше 24 часов.
Указывает, через какой промежуток времени с момента публикации аукциона принимать встречные предложения:
1
- сразу15, 30, 60, 120, 180
- время в минутахnull
- не принимать
Если AcceptCounterOffersOnlyBeforeFirstBet = true, то встречные предложения будут приниматься только до 1-й ставки
Длительность аукциона в минутах: 30, 60, 120, 180, 240, 360, 720, 1440, 2880, 4320, 5760, 7200
Значение не может быть больше времени актуальности груза LastDate
Флаг, определяющий, что обратный отсчет до окончания аукциона начинается только после первой ставки.
Параметры перезапуска аукциона
Действие после того, как все попытки перезапуска и выбора нового победителя торгов исчерпаны:
1
- Опубликовать груз со ставкой. В грузе должна быть указана ставка (SumWithNDS, SumWithoutNDS, RateSum)2
- Опубликовать с запросом ставки, возможные типы оплаты будут взяты из поля AcceptPaymentTypes в грузе3
- Перенести груз в архив
Количество перезапусков Торгов, от 0 до 3 включительно.
Если параметр не передать, по умолчанию 0
Сколько раз выбирать следующего победителя с лучшей ставкой, если предыдущий отказался, от 0 до 3 включительно
Если параметр не передать, по умолчанию 0
Длительность торгов в минутах после перезапуска
Необязательное поле, если его не передавать, то торги будут перезапущены с изначальной длительностью (поле Duration в структуре Аукцион). Однако если в структуре Аукцион заполнено поле EndDateBoundary и поле InitRestartCount имеет значение больше 0, то DurationAfterRestart становится обязательным
Можно принимать встречные предложения только до первой ставки?
Критерий выбора победителя торгов
0
- Выбор победителя происходит автоматически по лучшей ставке1
- Выбор победителя происходит по ставке и дате загрузки. Если нет лучшей ставки с лучшей датой - требуется выбор победителя вручную.
Id аукциона
Id груза, для которого активен аукцион
Id сделки, привязанной к аукциону
Статус аукциона
-100
- Не удалось определить состояние аукциона-14
- Аукцион отменен руками грузовладельца-13
- Аукцион удален, т.к. расторгнут заказ-12
- Аукцион без ставок завершен-11
- Аукцион удален автоматически-10
- Аукцион удален т.к. сделка завершена-9
- Аукцион удален-8
- При включенном копировании грузов: ожидается действие от экспедитора в случае, когда заказ с победителем отменен, других участников нет-7
- При включенном копировании грузов:ожидается действие с торгами от экспедитора в случае, когда заказ с победителем отменен и есть потенциальный победитель-6
- При включенном копировании грузов: торги завершены, экспедитор не является победителем-5
- Одна ставка лучшая по цене, другая по дате-4
- Закончился, но победитель вовремя не взял груз и при этом есть еще возможные победители-3
- Закончился, но победитель вовремя не взял груз и при этом он единственный возможный победитель-2
- Закончился, ждем когда победитель возьмет груз-1
- Закончился, ставок нет0
- Идет, ставок нет1
- Идет (уже есть валидные ставки)
Завершен ли аукцион
Время выигрыша ставки (когда для определенной ставки в AuctionRates установлен State = Winner)
Список ставок по аукциону
ID ставки
Когда сделана ставка
Фирма, оставившая заявку
"Звезды" фирмы
Тип звезд фирмы
0
: Серый1
: Красный2
: Желтый3
: Зеленый4
: Партнер АТИ5
: Сотрудник АТИ6
: Гос. органы7
: ОДКС
Имя фирмы
Имя контакта
Идентификатор фирмы в АТИ
Ставка на груз, которую поставил пользователь
Статус ставки
1
: Победная ставка в аукционе0
: Обычная ставка по аукциону (участник аукциона)-2
: Участник аукциона отменил ставку-3
: Бывший победитель, который не прислал документы-4
: Победитель отказался от участия-5
: Грузовладелец отменил безоговорочную сделку-6
: Победитель отменил безоговорочную сделку-7
: Победитель отклонил документ-8
: Грузовладелец отклонил документ
Ближайшая возможная для перевозчика дата загрузки
Используется только в аукционах с критерием победы по ставке и дате загрузки
Код фирмы, сделавшей ставку
Контакт, сделавший ставку
Список площадок
ID площадки
Время публикации на площадке
Учитывается, если PublicationOption
равно 6
Показывает разрешено ли бронирование грузов на Общей площадке
Учитывается только для Общей площадки, только при включенном Stealth
Параметры публикации груза:
0
- сразу1
- через 15 минут2
- через 30 минут3
- через час4
- через 3 часа5
- через 6 часов6
- указать точное время
Показывает, что груз уже опубликован на странице
Показывает является ли площадка Общей
Дата начала разгрузки, в формате UTC.
Может иметь значение null
.
Минимальное значение равно текущей дате.
При значении параметра DateType равным 3
, UnloadFirstDate принимает значение null
Дата окончания разгрузки, в формате UTC.
Может иметь значение null
.
Если нет даты начала разгрузки UnloadFirstDate, должна отсутствовать дата окончания разгрузки UnloadLastDate.
При значении параметра DateType равным 3
, UnloadFirstDate принимает значение null
Дата и время переноса в архив
Причина переноса в архив
Озвученная ставка
ID валюты озвученной ставки
Количество отзывов о грузе (без встречных предложений)
Количество встречных предложений (остальные отзывы не учитываются)
Есть ли доступ на удаление груза.
Есть ли доступ на работу с грузом (без учета прав).
Есть ли доступ на редактирование груза.
Есть ли доступ на обновление груза.
Есть ли доступ на восстановление груза
Причины отказа в доступе на редактирование груза:
0
- Вы имеете доступ к работе с грузом1
- Ваша фирма больше не может размещать грузы из-за нарушения правил АТИ2
- Груз зарезервирован/взят, операции с грузом запрещены3
- Превышен лимит актуальных грузов4
- Вы пытаетесь работать с грузами под общим пользователем. Недостаточно прав5
- У вашего контакта недостаточно прав для работы с данным грузом6
- Груз имеет завершенные Торги, операции с грузом запрещены7
- Сервис сделок временно недоступен8
- Нельзя изменять или удалять груз из сквозных торгов9
- У вашего контакта недостаточно прав для создания грузов10
- У вашего контакта недостаточно прав для работы с виртуальными кошельками11
- У вашего контакта недостаточно прав для работы с грузами на Общей площадке12
- У вашего контакта недостаточно прав для работы с грузами на Персональных площадках13
- У вашего контакта нет доступа для работы с одной или несколькими персональными площадками, указанными в грузе14
- У вашего контакта нет доступа для работы с подразделением, в которое восстанавливается груз15
- Ваш контакт должен быть указан первым в грузе
Причины отказа в доступе на удаление контакта:
0
- Вы имеете доступ к работе с грузом1
- Ваша фирма больше не может размещать грузы из-за нарушения правил АТИ2
- Груз зарезервирован/взят, операции с грузом запрещены3
- Превышен лимит актуальных грузов4
- Вы пытаетесь работать с грузами под общим пользователем. Недостаточно прав5
- У вашего контакта недостаточно прав для работы с данным грузом6
- Груз имеет завершенные Торги, операции с грузом запрещены7
- Сервис сделок временно недоступен8
- Нельзя изменять или удалять груз из сквозных торгов9
- У вашего контакта недостаточно прав для создания грузов10
- У вашего контакта недостаточно прав для работы с виртуальными кошельками11
- У вашего контакта недостаточно прав для работы с грузами на Общей площадке12
- У вашего контакта недостаточно прав для работы с грузами на Персональных площадках13
- У вашего контакта нет доступа для работы с одной или несколькими персональными площадками, указанными в грузе14
- У вашего контакта нет доступа для работы с подразделением, в которое восстанавливается груз15
- Ваш контакт должен быть указан первым в грузе
Причины отказа в доступе на восстановление груза:
0
- Вы имеете доступ к работе с грузом1
- Ваша фирма больше не может размещать грузы из-за нарушения правил АТИ2
- Груз зарезервирован/взят, операции с грузом запрещены3
- Превышен лимит актуальных грузов4
- Вы пытаетесь работать с грузами под общим пользователем. Недостаточно прав5
- У вашего контакта недостаточно прав для работы с данным грузом6
- Груз имеет завершенные Торги, операции с грузом запрещены7
- Сервис сделок временно недоступен8
- Нельзя изменять или удалять груз из сквозных торгов9
- У вашего контакта недостаточно прав для создания грузов10
- У вашего контакта недостаточно прав для работы с виртуальными кошельками11
- У вашего контакта недостаточно прав для работы с грузами на Общей площадке12
- У вашего контакта недостаточно прав для работы с грузами на Персональных площадках13
- У вашего контакта нет доступа для работы с одной или несколькими персональными площадками, указанными в грузе14
- У вашего контакта нет доступа для работы с подразделением, в которое восстанавливается груз15
- Ваш контакт должен быть указан первым в грузе
Причина отказа в доступе на обновление груза.
Идентификатор груза
Номер груза
Дата последнего изменения груза в формате UTC
Время добавления груза в формате UTC
Расстояние по дорогам в км
Протяженность дорог в км, в построенном пути за которые взимается плата по системе Платон
Протяженность платных дорог в построенном пути в км
Время в пути
Параметр, который определяет, включен ли зимник для перевозки груза
Параметр, который определяет, учитывать ли паромные переправы для перевозки груза
Идентификатор фирмы
Id аукциона
4XX Ошибка запроса. [Подробнее про ошибки API](https://ati.su/developers/api/loads/#loads-title-errors)
Модель ошибки
Причина ошибки
Ключ ошибки
Сформируйте свое предложение на перевозку
Получив грузы, отберите те, что вас заинтересовали. Чтобы понять, каким способом формируется цена на перевозку, определите тип ставки в грузе.
Грузы могут быть размещены со следующими вариантами ставок:
- запрос ставки - в данном случае грузовладелец ожидает получить различные предложения по ценам от перевозчиков. Отправить встречное предложение можно с помощью метода добавления отзыва на груз. Если грузовладельца устроит ваше предложение, он отправит вам приглашение на сделку, которое можно получить методом получения списка приглашений.
Добавление либо редактирование отзыва на чужой груз. put /v1.0/loads/new/{loadId}/responses
Id отзыва
Только для чтения
Id груза, на который оставлен отзыв
Только для чтения
Номер груза
Только для чтения
Id фирмы, которой принадлежит груз
Только для чтения
Id фирмы, которая оставила отзыв
Только для чтения
Контакт, который сделал встречное предложение
Дата добавления отзыва
Только для чтения
Дата изменения отзыва
Только для чтения
Предложенная ставка встречного предложения не б/нал. Параметр должен быть равен одной из ставок груза: RateSum, SumWithNDS или SumWithoutNDS, если у груза, которому выставляется встречное предложение, параметр FixedRate равен True И параметр Torg равен False. Значение больше 0 и содержит не более 10 символов.
Валюта встречного предложения. Параметр должен быть равен валюте, указанной в грузе, если параметр FixedRate равен True и параметр Torg равен False
Значение из словаря валют АТИ
Предложенная ставка встречного предложения б/нал с НДС
Валюта ставки встречного предложения б/нал с НДС.Параметр должен быть равен валюте, указанной в грузе, если параметр FixedRate равен True и параметр Torg равен False.
Значение из словаря валют АТИ
Предложенная ставка встречного предложения б/нал без НДС
Валюта ставки встречного предложения б/нал без НДС. Параметр должен быть равен валюте, указанной в грузе, если параметр FixedRate равен True и параметр Torg равен False
Значение из словаря валют АТИ
Примечание к встречному предложению
Максимальная длина - 512 символов
Атрибуты оплаты, по умолчанию - 0. Битовая сумма следующих параметров:
1
- возможна оплата наличными2
- возможна оплата по безналичному рассчету4
- блиц8
- оплата с НДС16
- возможна предоплата32
- оплата на выгрузке64
- включена ли оплата через некоторое количество банковских дней
Процент предоплаты
Должен быть равен 0 или отсутствовать, если PayAttributes не содержит флаг 16 - возможна предоплата. Допустимое значение от 0 до 100
Оплата через ... банковских дней
Должен быть равен 0 или отсутствовать, если PayAttributes не содержит флаг 64 - включена оплата через некоторое количество банковских дней. Допустимое значение от 0 до 99
Дата, когда предложивший хочет перевезти ваш груз
Определяет, просрочен ли отзыв. Когда груз редактируют, удаляют, обновляют, отзыв помечается просроченным.
Только для чтения.
Относится ли отзыв к публикующемуся грузу
Только для чтения
Параметр "Груза нет"
Валюта "Озвученной ставки"
Значение из словаря валют АТИ
Озвученная ставка
curl 'https://api.ati.su/v1.0/loads/new/{loadId}/responses' \ -X 'PUT' \ -H 'Authorization: Bearer {authorizationToken}' \ -H 'Content-Type: application/json' \ --data-raw '{"ResponseId":"3fa85f64-5717-4562-b3fc-2c963f66afa6","LoadId":"3fa85f64-5717-4562-b3fc-2c963f66afa6","LoadNumber":"string","LoadFirmId":0,"FirmId":0,"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,"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}'
Процедура ВыполнитьHTTPЗапрос(МетодЗапроса, АдресХоста, АдресРесурса, ТекстЗапроса) Экспорт ЗаголовкиHTTP = Новый Соответствие(); ЗаголовкиHTTP.Вставить("Accept", "application/json"); ЗаголовкиHTTP.Вставить("Content-Type", "application/json"); ЗаголовкиHTTP.Вставить("Authorization", "Bearer {authorizationToken}"); HTTPЗапрос = Новый HTTPЗапрос(АдресРесурса, ЗаголовкиHTTP); HTTPЗапрос.УстановитьТелоИзСтроки(ТекстЗапроса, КодировкаТекста.UTF8, ИспользованиеByteOrderMark.НеИспользовать); ЗащищенноеСоединениеSSL = Новый ЗащищенноеСоединениеOpenSSL(Новый СертификатКлиентаWindows, Новый СертификатыУдостоверяющихЦентровWindows);
Соединение = Новый HTTPСоединение(АдресХоста,,,,,, ЗащищенноеСоединениеSSL);
Попытка Ответ = Соединение.ВызватьHTTPМетод(МетодЗапроса, HTTPЗапрос); Сообщить("Код ответа: " + Ответ.КодСостояния); Сообщить("Ответ: " + Ответ.ПолучитьТелоКакСтроку("UTF-8")); Исключение Сообщить("Ошибка выполнения запроса!" + Символы.ПС + ОписаниеОшибки()); КонецПопытки;КонецПроцедуры
ВыполнитьHTTPЗапрос("PUT", "https://api.ati.su", "/v1.0/loads/new/{loadId}/responses", "{""ResponseId"":""3fa85f64-5717-4562-b3fc-2c963f66afa6"",""LoadId"":""3fa85f64-5717-4562-b3fc-2c963f66afa6"",""LoadNumber"":""string"",""LoadFirmId"":0,""FirmId"":0,""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,""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}");
200 Отзыв на груз
Id отзыва
Id груза, на который оставлен отзыв
Номер груза
Id фирмы, которой принадлежит груз
Id фирмы, которая оставила отзыв
Название фирмы
Контакт, который сделал встречное предложение
Дата добавления отзыва
Дата изменения отзыва
Предложенная цена встречного предложения
Валюта встречного предложения
Значение из словаря валют АТИ
Предложенная цена встречного предложения с ндс
Валюта ставки встречного предложения б/нал с НДС.Параметр должен быть равен валюте, указанной в грузе, если параметр FixedRate равен True и параметр Torg равен False.
Значение из словаря валют АТИ
Предложенная цена встречного предложения без ндс
Валюта встречного предложения без ндс
Обозначение откуда было добавлено встречное предложение
0
- Неизвестный источник1
- Мобильное приложение2
- Интегратор3
- Перехват грузов интегратором4
- Страница поиска грузов5
- Перехват машин6
- Сквозное встречное предложение, добавлено автоматически
Примечание к встречному предложению
Максимальная длина - 512 символов
Атрибуты оплаты, по умолчанию - 0. Битовая сумма следующих параметров:
1
- возможна оплата наличными2
- возможна оплата по безналичному рассчету4
- блиц8
- оплата с НДС16
- возможна предоплата32
- оплата на выгрузке64
- включена ли оплата через некоторое количество банковских дней
Процент предоплаты
Должен быть равен 0 или отсутствовать, если PayAttributes не содержит флаг 16 - возможна предоплата. Допустимое значение от 0 до 100
Оплата через ... банковских дней
Должен быть равен 0 или отсутствовать, если PayAttributes не содержит флаг 64 - включена оплата через некоторое количество банковских дней. Допустимое значение от 0 до 99
Дата, когда предложивший хочет перевезти ваш груз
Определяет, просрочен ли отзыв. Когда груз редактируют, удаляют, обновляют, отзыв помечается просроченным.
Только для чтения.
Относится ли отзыв к публикующемуся грузу
Параметр "Груза нет"
Валюта "Озвученной ставки"
Значение из словаря валют АТИ
Озвученная ставка
Информация о фирме, оставившей отзыв на груз
Сумма очков фирмы (количество звезд)
Тип звезд фирмы
0
: Серый1
: Красный2
: Желтый3
: Зеленый4
: Партнер АТИ5
: Сотрудник АТИ6
: Гос. органы7
: ОДКС
Полное название фирмы
Информация о контакте фирмы, оставившем отзыв на груз
Id контакта в фирме
Имя контакта
Телефон
Электронная почта
Аккаунт ICQ
Телефон(мобильный)
Мобильный оператор
Аккаунт Skype
Id города
Значение из словаря городов АТИ
Информация о местоположении фирмы
Id города
Значение из словаря городов АТИ
Id региона
Значение из словаря регионов АТИ
Id страны
Значение из словаря стран АТИ
Составное название состоящее из названий города, региона и страны разделенные через запятую
Составное название состоящее из названия города, названия региона (если город не является областным центром) и буквенного кода страны (если страна отличается от России)
Является ли город региональным центром
Размер города по числу жителей
1
: до 10.0002
: от 10.000 до 50.000;3
: от 50.000 до 100.000;4
: от 100.000 до 500.000;5
: от 500.000 до 1.000.000;6
: свыше 1.000.000.
Id в базе ФИАС
Название города
Название региона
Название страны
Буквенный код страны
ИНН
4XX Ошибка запроса. [Подробнее про ошибки API](https://ati.su/developers/api/loads/#loads-title-errors)
Модель ошибки
Причина ошибки
Ключ ошибки
Получение списка приглашений get /v1.2/orders/invites/my
curl 'https://api.ati.su/v1.2/orders/invites/my' \ -X 'GET' \ -H 'Authorization: Bearer {authorizationToken}' \ -H 'Content-Type: application/json'
Процедура ВыполнитьHTTPЗапрос(МетодЗапроса, АдресХоста, АдресРесурса, ТекстЗапроса) Экспорт ЗаголовкиHTTP = Новый Соответствие(); ЗаголовкиHTTP.Вставить("Accept", "application/json"); ЗаголовкиHTTP.Вставить("Content-Type", "application/json"); ЗаголовкиHTTP.Вставить("Authorization", "Bearer {authorizationToken}"); HTTPЗапрос = Новый HTTPЗапрос(АдресРесурса, ЗаголовкиHTTP); HTTPЗапрос.УстановитьТелоИзСтроки(ТекстЗапроса, КодировкаТекста.UTF8, ИспользованиеByteOrderMark.НеИспользовать); ЗащищенноеСоединениеSSL = Новый ЗащищенноеСоединениеOpenSSL(Новый СертификатКлиентаWindows, Новый СертификатыУдостоверяющихЦентровWindows);
Соединение = Новый HTTPСоединение(АдресХоста,,,,,, ЗащищенноеСоединениеSSL);
Попытка Ответ = Соединение.ВызватьHTTPМетод(МетодЗапроса, HTTPЗапрос); Сообщить("Код ответа: " + Ответ.КодСостояния); Сообщить("Ответ: " + Ответ.ПолучитьТелоКакСтроку("UTF-8")); Исключение Сообщить("Ошибка выполнения запроса!" + Символы.ПС + ОписаниеОшибки()); КонецПопытки;КонецПроцедуры
ВыполнитьHTTPЗапрос("GET", "https://api.ati.su", "/v1.2/orders/invites/my");
200 Список приглашений на перевозку груза
Id фирмы грузовладельца
Постоянный Id фирмы грузовладельца
Id контакта, который отправил приглашение
Id приглашенной фирмы
Постоянный Id приглашенной фирмы
Id контакта приглашенной фирмы
Список контактов приглашенной фирмы
Время отправки приглашения
Время отмены приглашения
Предложенные параметры оплаты
Список возможных ставок перевозки
Сумма
Тип оплаты
0
— Нет1
— Любая2
— С НДС3
— Без НДС
Id валюты
Значение из словаря валют АТИ
Процент предоплаты
Есть ли предоплата
Оплата на выгрузке
Оплата топливом
Есть ли срок оплаты
Срок оплаты
Указана ли в грузе ставка
Возможен ли торг
Прямой договор
Способ оплаты
Источник параметров оплаты
0
— Нет1
— Встречное предложение2
— Торги3
— Груз4
— Предложение груза5
— Предложение по контракту
Параметры предложенного груза
ID груза
Сгенерированный номер груза
Расстояние для груза
При расчете учитываются дополнительные пункты разгрузки
Маршрут построен с проездом по МКАД или без МКАД
0
— без МКАД1
— с МКАД
Расстояние по Платону
Расстояние по платным дорогам
Время в пути
Озвученная ставка
ID валюты озвученной ставки
Примечание к грузу
Дата, начиная с которой груз актуален
Дата, после которой груз не актуален
Готовность груза к перевозке
0
— Готов к отправке сегодня или завтра1
— Готов к отправке между FirstDate и LastDate2
— Готов к отправке постоянно3
— Груза нет, запрос ставки
Периодичность загрузки
0
— Нет1
— Ежедневно100
— Только по рабочим дням
Номер груза/заказа
Кругорейс
Зимники
Паромные переправы
Точка загрузки
Id точки по базе ФИАС
Id города
Значение из словаря городов ATI.SU
Широта
Долгота
Адрес
Id из справочника организаций
Id адреса в организации
Время "От"
Время "До"
Круглосуточно
Список Id ближайших крупных городов
Расстояния до ближайших крупных городов
Id города
Значение из словаря городов ATI.SU
Расстояние
Id груза
Наименование груза
Упаковка
Объем
Габариты
Длина в метрах
Ширина в метрах
Высота в метрах
Диаметр в метрах
Подсвечивать ли длину
Подсвечивать ли ширину
Подсвечивать ли высоту
Дополнительные точки
Id города
Значение из словаря городов ATI.SU
Тип дополнительной точки маршрута груза
1
— Загрузка2
— Разгрузка3
— Таможня4
— Ближайший крупный город к городу загрузки5
— Ближайший крупный город к городу разгрузки8
— Проехать через
Порядковый номер в маршруте
Расстояние
Адрес
Широта
Долгота
Id из справочника организаций
Id адреса в организации
Дата начала загрузки
Дата конца загрузки
Время начала загрузки
Время конца загрузки
Круглосуточно
Id груза
Наименование груза
Упаковка
Объем
Габариты
Длина в метрах
Ширина в метрах
Высота в метрах
Диаметр в метрах
Подсвечивать ли длину
Подсвечивать ли ширину
Подсвечивать ли высоту
Id груза
Вес
Объём
Выгружаемая часть упаковки
Выгружаемая часть груза будет определена в ТТН
Точка разгрузки
Id точки по базе ФИАС
Id города
Значение из словаря городов ATI.SU
Широта
Долгота
Адрес
Id из справочника организаций
Id адреса в организации
Время "От"
Время "До"
Круглосуточно
Список Id ближайших крупных городов
Расстояния до ближайших крупных городов
Id города
Значение из словаря городов ATI.SU
Расстояние
Id груза
Наименование груза
Упаковка
Объем
Габариты
Длина в метрах
Ширина в метрах
Высота в метрах
Диаметр в метрах
Подсвечивать ли длину
Подсвечивать ли ширину
Подсвечивать ли высоту
Параметры груза
Вес
Объем
Модификатор опасности груза с 0 до 9
Идентификатор наименования груза
Значение из словаря наименований грузов
Строковое наименование груза. Выводится если CargoTypeId не указан, либо равен 59
Тип упаковки(навалом, коробки, россыпью, запаллечен ... пирамида). Значение из словаря PackTypes
Количество паллетов
Количество ремней
Параметр, отвечающий за способ перевозки груза
1
— Только отдельной машиной2
— Догруз возможен3
— Догруз
Сборный груз
Размеры груза
Длина в метрах
Ширина в метрах
Высота в метрах
Диаметр в метрах
Подсвечивать ли длину
Подсвечивать ли ширину
Подсвечивать ли высоту
Параметры перевозки
Битовая сумма кузовов
Битовая сумма типов загрузки
Тип условия загрузки
OR
AND
Битовая сумма типов разгрузки
Тип условия разгрузки
OR
AND
Количество машин
Температура перевозки - нижнее значение
Температура перевозки - верхнее значение
Сцепка
Пневмоход
Коники
TIR
CMR
Т1
Мед книжка
Запрос отслеживания через АТИ Водитель
Требуемая грузоподъёмность в тоннах
Дата, начиная с которой можно разгрузить груз
Дата, до которой можно разгрузить груз
Запрос отслеживания через АТИ Водитель
Тип Заказа
0
— Заказ невозможен1
— Взятие груза из поиска2
— Заказ из Торгов4
— Предложение груза8
— Из перехвата машин16
— Односторонний заказ32
— Предложение груза из встречного предложения64
— Предложение груза по контракту
4XX Ошибка запроса. [Подробнее про ошибки API](https://ati.su/developers/documentation/errors/)
Модель ошибки
Причина ошибки
Ключ ошибки
- фиксированная ставка, с возможностью торга - в данном случае грузовладелец озвучивает свой вариант цены, но при этом готов поторговаться. Вы можете отправить встречное предложение с той ставкой, что опубликовал грузовладелец, или предложить свою цену. Аналогично предыдущему пункту, отправить встречное предложение вы можете с помощью метода добавления отзыва на груз. Если грузовладельца устроит ваше предложение, он отправит вам приглашение на сделку, которое можно получить методом получения списка приглашений.
Добавление либо редактирование отзыва на чужой груз. put /v1.0/loads/new/{loadId}/responses
Id отзыва
Только для чтения
Id груза, на который оставлен отзыв
Только для чтения
Номер груза
Только для чтения
Id фирмы, которой принадлежит груз
Только для чтения
Id фирмы, которая оставила отзыв
Только для чтения
Контакт, который сделал встречное предложение
Дата добавления отзыва
Только для чтения
Дата изменения отзыва
Только для чтения
Предложенная ставка встречного предложения не б/нал. Параметр должен быть равен одной из ставок груза: RateSum, SumWithNDS или SumWithoutNDS, если у груза, которому выставляется встречное предложение, параметр FixedRate равен True И параметр Torg равен False. Значение больше 0 и содержит не более 10 символов.
Валюта встречного предложения. Параметр должен быть равен валюте, указанной в грузе, если параметр FixedRate равен True и параметр Torg равен False
Значение из словаря валют АТИ
Предложенная ставка встречного предложения б/нал с НДС
Валюта ставки встречного предложения б/нал с НДС.Параметр должен быть равен валюте, указанной в грузе, если параметр FixedRate равен True и параметр Torg равен False.
Значение из словаря валют АТИ
Предложенная ставка встречного предложения б/нал без НДС
Валюта ставки встречного предложения б/нал без НДС. Параметр должен быть равен валюте, указанной в грузе, если параметр FixedRate равен True и параметр Torg равен False
Значение из словаря валют АТИ
Примечание к встречному предложению
Максимальная длина - 512 символов
Атрибуты оплаты, по умолчанию - 0. Битовая сумма следующих параметров:
1
- возможна оплата наличными2
- возможна оплата по безналичному рассчету4
- блиц8
- оплата с НДС16
- возможна предоплата32
- оплата на выгрузке64
- включена ли оплата через некоторое количество банковских дней
Процент предоплаты
Должен быть равен 0 или отсутствовать, если PayAttributes не содержит флаг 16 - возможна предоплата. Допустимое значение от 0 до 100
Оплата через ... банковских дней
Должен быть равен 0 или отсутствовать, если PayAttributes не содержит флаг 64 - включена оплата через некоторое количество банковских дней. Допустимое значение от 0 до 99
Дата, когда предложивший хочет перевезти ваш груз
Определяет, просрочен ли отзыв. Когда груз редактируют, удаляют, обновляют, отзыв помечается просроченным.
Только для чтения.
Относится ли отзыв к публикующемуся грузу
Только для чтения
Параметр "Груза нет"
Валюта "Озвученной ставки"
Значение из словаря валют АТИ
Озвученная ставка
curl 'https://api.ati.su/v1.0/loads/new/{loadId}/responses' \ -X 'PUT' \ -H 'Authorization: Bearer {authorizationToken}' \ -H 'Content-Type: application/json' \ --data-raw '{"ResponseId":"3fa85f64-5717-4562-b3fc-2c963f66afa6","LoadId":"3fa85f64-5717-4562-b3fc-2c963f66afa6","LoadNumber":"string","LoadFirmId":0,"FirmId":0,"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,"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}'
Процедура ВыполнитьHTTPЗапрос(МетодЗапроса, АдресХоста, АдресРесурса, ТекстЗапроса) Экспорт ЗаголовкиHTTP = Новый Соответствие(); ЗаголовкиHTTP.Вставить("Accept", "application/json"); ЗаголовкиHTTP.Вставить("Content-Type", "application/json"); ЗаголовкиHTTP.Вставить("Authorization", "Bearer {authorizationToken}"); HTTPЗапрос = Новый HTTPЗапрос(АдресРесурса, ЗаголовкиHTTP); HTTPЗапрос.УстановитьТелоИзСтроки(ТекстЗапроса, КодировкаТекста.UTF8, ИспользованиеByteOrderMark.НеИспользовать); ЗащищенноеСоединениеSSL = Новый ЗащищенноеСоединениеOpenSSL(Новый СертификатКлиентаWindows, Новый СертификатыУдостоверяющихЦентровWindows);
Соединение = Новый HTTPСоединение(АдресХоста,,,,,, ЗащищенноеСоединениеSSL);
Попытка Ответ = Соединение.ВызватьHTTPМетод(МетодЗапроса, HTTPЗапрос); Сообщить("Код ответа: " + Ответ.КодСостояния); Сообщить("Ответ: " + Ответ.ПолучитьТелоКакСтроку("UTF-8")); Исключение Сообщить("Ошибка выполнения запроса!" + Символы.ПС + ОписаниеОшибки()); КонецПопытки;КонецПроцедуры
ВыполнитьHTTPЗапрос("PUT", "https://api.ati.su", "/v1.0/loads/new/{loadId}/responses", "{""ResponseId"":""3fa85f64-5717-4562-b3fc-2c963f66afa6"",""LoadId"":""3fa85f64-5717-4562-b3fc-2c963f66afa6"",""LoadNumber"":""string"",""LoadFirmId"":0,""FirmId"":0,""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,""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}");
200 Отзыв на груз
Id отзыва
Id груза, на который оставлен отзыв
Номер груза
Id фирмы, которой принадлежит груз
Id фирмы, которая оставила отзыв
Название фирмы
Контакт, который сделал встречное предложение
Дата добавления отзыва
Дата изменения отзыва
Предложенная цена встречного предложения
Валюта встречного предложения
Значение из словаря валют АТИ
Предложенная цена встречного предложения с ндс
Валюта ставки встречного предложения б/нал с НДС.Параметр должен быть равен валюте, указанной в грузе, если параметр FixedRate равен True и параметр Torg равен False.
Значение из словаря валют АТИ
Предложенная цена встречного предложения без ндс
Валюта встречного предложения без ндс
Обозначение откуда было добавлено встречное предложение
0
- Неизвестный источник1
- Мобильное приложение2
- Интегратор3
- Перехват грузов интегратором4
- Страница поиска грузов5
- Перехват машин6
- Сквозное встречное предложение, добавлено автоматически
Примечание к встречному предложению
Максимальная длина - 512 символов
Атрибуты оплаты, по умолчанию - 0. Битовая сумма следующих параметров:
1
- возможна оплата наличными2
- возможна оплата по безналичному рассчету4
- блиц8
- оплата с НДС16
- возможна предоплата32
- оплата на выгрузке64
- включена ли оплата через некоторое количество банковских дней
Процент предоплаты
Должен быть равен 0 или отсутствовать, если PayAttributes не содержит флаг 16 - возможна предоплата. Допустимое значение от 0 до 100
Оплата через ... банковских дней
Должен быть равен 0 или отсутствовать, если PayAttributes не содержит флаг 64 - включена оплата через некоторое количество банковских дней. Допустимое значение от 0 до 99
Дата, когда предложивший хочет перевезти ваш груз
Определяет, просрочен ли отзыв. Когда груз редактируют, удаляют, обновляют, отзыв помечается просроченным.
Только для чтения.
Относится ли отзыв к публикующемуся грузу
Параметр "Груза нет"
Валюта "Озвученной ставки"
Значение из словаря валют АТИ
Озвученная ставка
Информация о фирме, оставившей отзыв на груз
Сумма очков фирмы (количество звезд)
Тип звезд фирмы
0
: Серый1
: Красный2
: Желтый3
: Зеленый4
: Партнер АТИ5
: Сотрудник АТИ6
: Гос. органы7
: ОДКС
Полное название фирмы
Информация о контакте фирмы, оставившем отзыв на груз
Id контакта в фирме
Имя контакта
Телефон
Электронная почта
Аккаунт ICQ
Телефон(мобильный)
Мобильный оператор
Аккаунт Skype
Id города
Значение из словаря городов АТИ
Информация о местоположении фирмы
Id города
Значение из словаря городов АТИ
Id региона
Значение из словаря регионов АТИ
Id страны
Значение из словаря стран АТИ
Составное название состоящее из названий города, региона и страны разделенные через запятую
Составное название состоящее из названия города, названия региона (если город не является областным центром) и буквенного кода страны (если страна отличается от России)
Является ли город региональным центром
Размер города по числу жителей
1
: до 10.0002
: от 10.000 до 50.000;3
: от 50.000 до 100.000;4
: от 100.000 до 500.000;5
: от 500.000 до 1.000.000;6
: свыше 1.000.000.
Id в базе ФИАС
Название города
Название региона
Название страны
Буквенный код страны
ИНН
4XX Ошибка запроса. [Подробнее про ошибки API](https://ati.su/developers/api/loads/#loads-title-errors)
Модель ошибки
Причина ошибки
Ключ ошибки
Получение списка приглашений get /v1.2/orders/invites/my
curl 'https://api.ati.su/v1.2/orders/invites/my' \ -X 'GET' \ -H 'Authorization: Bearer {authorizationToken}' \ -H 'Content-Type: application/json'
Процедура ВыполнитьHTTPЗапрос(МетодЗапроса, АдресХоста, АдресРесурса, ТекстЗапроса) Экспорт ЗаголовкиHTTP = Новый Соответствие(); ЗаголовкиHTTP.Вставить("Accept", "application/json"); ЗаголовкиHTTP.Вставить("Content-Type", "application/json"); ЗаголовкиHTTP.Вставить("Authorization", "Bearer {authorizationToken}"); HTTPЗапрос = Новый HTTPЗапрос(АдресРесурса, ЗаголовкиHTTP); HTTPЗапрос.УстановитьТелоИзСтроки(ТекстЗапроса, КодировкаТекста.UTF8, ИспользованиеByteOrderMark.НеИспользовать); ЗащищенноеСоединениеSSL = Новый ЗащищенноеСоединениеOpenSSL(Новый СертификатКлиентаWindows, Новый СертификатыУдостоверяющихЦентровWindows);
Соединение = Новый HTTPСоединение(АдресХоста,,,,,, ЗащищенноеСоединениеSSL);
Попытка Ответ = Соединение.ВызватьHTTPМетод(МетодЗапроса, HTTPЗапрос); Сообщить("Код ответа: " + Ответ.КодСостояния); Сообщить("Ответ: " + Ответ.ПолучитьТелоКакСтроку("UTF-8")); Исключение Сообщить("Ошибка выполнения запроса!" + Символы.ПС + ОписаниеОшибки()); КонецПопытки;КонецПроцедуры
ВыполнитьHTTPЗапрос("GET", "https://api.ati.su", "/v1.2/orders/invites/my");
200 Список приглашений на перевозку груза
Id фирмы грузовладельца
Постоянный Id фирмы грузовладельца
Id контакта, который отправил приглашение
Id приглашенной фирмы
Постоянный Id приглашенной фирмы
Id контакта приглашенной фирмы
Список контактов приглашенной фирмы
Время отправки приглашения
Время отмены приглашения
Предложенные параметры оплаты
Список возможных ставок перевозки
Сумма
Тип оплаты
0
— Нет1
— Любая2
— С НДС3
— Без НДС
Id валюты
Значение из словаря валют АТИ
Процент предоплаты
Есть ли предоплата
Оплата на выгрузке
Оплата топливом
Есть ли срок оплаты
Срок оплаты
Указана ли в грузе ставка
Возможен ли торг
Прямой договор
Способ оплаты
Источник параметров оплаты
0
— Нет1
— Встречное предложение2
— Торги3
— Груз4
— Предложение груза5
— Предложение по контракту
Параметры предложенного груза
ID груза
Сгенерированный номер груза
Расстояние для груза
При расчете учитываются дополнительные пункты разгрузки
Маршрут построен с проездом по МКАД или без МКАД
0
— без МКАД1
— с МКАД
Расстояние по Платону
Расстояние по платным дорогам
Время в пути
Озвученная ставка
ID валюты озвученной ставки
Примечание к грузу
Дата, начиная с которой груз актуален
Дата, после которой груз не актуален
Готовность груза к перевозке
0
— Готов к отправке сегодня или завтра1
— Готов к отправке между FirstDate и LastDate2
— Готов к отправке постоянно3
— Груза нет, запрос ставки
Периодичность загрузки
0
— Нет1
— Ежедневно100
— Только по рабочим дням
Номер груза/заказа
Кругорейс
Зимники
Паромные переправы
Точка загрузки
Id точки по базе ФИАС
Id города
Значение из словаря городов ATI.SU
Широта
Долгота
Адрес
Id из справочника организаций
Id адреса в организации
Время "От"
Время "До"
Круглосуточно
Список Id ближайших крупных городов
Расстояния до ближайших крупных городов
Id города
Значение из словаря городов ATI.SU
Расстояние
Id груза
Наименование груза
Упаковка
Объем
Габариты
Длина в метрах
Ширина в метрах
Высота в метрах
Диаметр в метрах
Подсвечивать ли длину
Подсвечивать ли ширину
Подсвечивать ли высоту
Дополнительные точки
Id города
Значение из словаря городов ATI.SU
Тип дополнительной точки маршрута груза
1
— Загрузка2
— Разгрузка3
— Таможня4
— Ближайший крупный город к городу загрузки5
— Ближайший крупный город к городу разгрузки8
— Проехать через
Порядковый номер в маршруте
Расстояние
Адрес
Широта
Долгота
Id из справочника организаций
Id адреса в организации
Дата начала загрузки
Дата конца загрузки
Время начала загрузки
Время конца загрузки
Круглосуточно
Id груза
Наименование груза
Упаковка
Объем
Габариты
Длина в метрах
Ширина в метрах
Высота в метрах
Диаметр в метрах
Подсвечивать ли длину
Подсвечивать ли ширину
Подсвечивать ли высоту
Id груза
Вес
Объём
Выгружаемая часть упаковки
Выгружаемая часть груза будет определена в ТТН
Точка разгрузки
Id точки по базе ФИАС
Id города
Значение из словаря городов ATI.SU
Широта
Долгота
Адрес
Id из справочника организаций
Id адреса в организации
Время "От"
Время "До"
Круглосуточно
Список Id ближайших крупных городов
Расстояния до ближайших крупных городов
Id города
Значение из словаря городов ATI.SU
Расстояние
Id груза
Наименование груза
Упаковка
Объем
Габариты
Длина в метрах
Ширина в метрах
Высота в метрах
Диаметр в метрах
Подсвечивать ли длину
Подсвечивать ли ширину
Подсвечивать ли высоту
Параметры груза
Вес
Объем
Модификатор опасности груза с 0 до 9
Идентификатор наименования груза
Значение из словаря наименований грузов
Строковое наименование груза. Выводится если CargoTypeId не указан, либо равен 59
Тип упаковки(навалом, коробки, россыпью, запаллечен ... пирамида). Значение из словаря PackTypes
Количество паллетов
Количество ремней
Параметр, отвечающий за способ перевозки груза
1
— Только отдельной машиной2
— Догруз возможен3
— Догруз
Сборный груз
Размеры груза
Длина в метрах
Ширина в метрах
Высота в метрах
Диаметр в метрах
Подсвечивать ли длину
Подсвечивать ли ширину
Подсвечивать ли высоту
Параметры перевозки
Битовая сумма кузовов
Битовая сумма типов загрузки
Тип условия загрузки
OR
AND
Битовая сумма типов разгрузки
Тип условия разгрузки
OR
AND
Количество машин
Температура перевозки - нижнее значение
Температура перевозки - верхнее значение
Сцепка
Пневмоход
Коники
TIR
CMR
Т1
Мед книжка
Запрос отслеживания через АТИ Водитель
Требуемая грузоподъёмность в тоннах
Дата, начиная с которой можно разгрузить груз
Дата, до которой можно разгрузить груз
Запрос отслеживания через АТИ Водитель
Тип Заказа
0
— Заказ невозможен1
— Взятие груза из поиска2
— Заказ из Торгов4
— Предложение груза8
— Из перехвата машин16
— Односторонний заказ32
— Предложение груза из встречного предложения64
— Предложение груза по контракту
4XX Ошибка запроса. [Подробнее про ошибки API](https://ati.su/developers/documentation/errors/)
Модель ошибки
Причина ошибки
Ключ ошибки
- фиксированная ставка, без возможности торга - в данном случае грузовладелец озвучивает конкретную цену за перевозку его груза. Если цена вас устраивает, то вы можете забронировать груз и отправить грузовладельцу все данные для оформления сделки с помощью метода “взять груз”. Грузовладелец, рассмотрев ваше предложение, может либо оформить сделку, если его все устроит, либо отказать вам в сделке.
Взятие груза / Редактирование Заказа post /v1.2/orders/takeload/{loadId}
Параметры Заказа
Тип оплаты
0
— Нет1
— Любая2
— С НДС3
— Без НДС
Id водителя
Id транспортного средства
Id полуприцепа
Может быть указан только если транспортное средство — тягач
Id прицепа
Может быть указан только если указан полуприцеп или транспортное средство — грузовик
Id реквизитов
Id подписанта
Отзывать ли привязанные документы
Используется при редактировании
Тип Заказа
0
— Заказ невозможен1
— Взятие груза из поиска2
— Заказ из Торгов4
— Предложение груза8
— Из перехвата машин16
— Односторонний заказ32
— Предложение груза из встречного предложения64
— Предложение груза по контракту
Комментарий перевозчика
curl 'https://api.ati.su/v1.2/orders/takeload/{loadId}' \ -X 'POST' \ -H 'Authorization: Bearer {authorizationToken}' \ -H 'Content-Type: application/json' \ --data-raw '{"rate_type":0,"driver_id":"3fa85f64-5717-4562-b3fc-2c963f66afa6","truck_info_id":"3fa85f64-5717-4562-b3fc-2c963f66afa6","semitrailer_id":"3fa85f64-5717-4562-b3fc-2c963f66afa6","trailer_id":"3fa85f64-5717-4562-b3fc-2c963f66afa6","requisites_id":"3fa85f64-5717-4562-b3fc-2c963f66afa6","signer_id":"3fa85f64-5717-4562-b3fc-2c963f66afa6","is_drop_docs":false,"deal_kind":0,"taker_note":"string"}'
Процедура ВыполнитьHTTPЗапрос(МетодЗапроса, АдресХоста, АдресРесурса, ТекстЗапроса) Экспорт ЗаголовкиHTTP = Новый Соответствие(); ЗаголовкиHTTP.Вставить("Accept", "application/json"); ЗаголовкиHTTP.Вставить("Content-Type", "application/json"); ЗаголовкиHTTP.Вставить("Authorization", "Bearer {authorizationToken}"); HTTPЗапрос = Новый HTTPЗапрос(АдресРесурса, ЗаголовкиHTTP); HTTPЗапрос.УстановитьТелоИзСтроки(ТекстЗапроса, КодировкаТекста.UTF8, ИспользованиеByteOrderMark.НеИспользовать); ЗащищенноеСоединениеSSL = Новый ЗащищенноеСоединениеOpenSSL(Новый СертификатКлиентаWindows, Новый СертификатыУдостоверяющихЦентровWindows);
Соединение = Новый HTTPСоединение(АдресХоста,,,,,, ЗащищенноеСоединениеSSL);
Попытка Ответ = Соединение.ВызватьHTTPМетод(МетодЗапроса, HTTPЗапрос); Сообщить("Код ответа: " + Ответ.КодСостояния); Сообщить("Ответ: " + Ответ.ПолучитьТелоКакСтроку("UTF-8")); Исключение Сообщить("Ошибка выполнения запроса!" + Символы.ПС + ОписаниеОшибки()); КонецПопытки;КонецПроцедуры
ВыполнитьHTTPЗапрос("POST", "https://api.ati.su", "/v1.2/orders/takeload/{loadId}", "{""rate_type"":0,""driver_id"":""3fa85f64-5717-4562-b3fc-2c963f66afa6"",""truck_info_id"":""3fa85f64-5717-4562-b3fc-2c963f66afa6"",""semitrailer_id"":""3fa85f64-5717-4562-b3fc-2c963f66afa6"",""trailer_id"":""3fa85f64-5717-4562-b3fc-2c963f66afa6"",""requisites_id"":""3fa85f64-5717-4562-b3fc-2c963f66afa6"",""signer_id"":""3fa85f64-5717-4562-b3fc-2c963f66afa6"",""is_drop_docs"":false,""deal_kind"":0,""taker_note"":""string""}");
200 Успешное взятие/редактирование
Копия груза
При создании заказа груз копируется, копия не отображается в поиске и её невозможно отредактировать
Id копии груза
Сгенерированный номер груза
Метаданные груза
Id
Данные
Id Торгов (аукциона)
Дата последнего изменения груза
Дата добавления груза
Дата помещения груза в архив
При взятии груза, он попадает в архив
Расстояние для груза
При расчете учитываются дополнительные пункты разгрузки
Маршрут построен с проездом по МКАД или без МКАД
0
— без МКАД1
— с МКАД
Расстояние по Платону
Расстояние по платным дорогам
Время в пути
Озвученная ставка
Id валюты озвученной ставки
Id груза
Груз не опубликован
ID фирмы, выставившей груз
Контакт #1, указанный в грузе
Контакт #2, указанный в грузе
Примечание к грузу
Дата, начиная с которой груз актуален
Дата, после которой груз не актуален
Готовность груза к перевозке
0
— Готов к отправке сегодня или завтра1
— Готов к отправке между FirstDate и LastDate2
— Готов к отправке постоянно3
— Груза нет, запрос ставки
Периодичность загрузки
0
— Нет1
— Ежедневно100
— Только по рабочим дням
Номер груза/заказа
Кругорейс
Зимники
Паромные переправы
Точка загрузки
Id точки по базе ФИАС
Id города
Значение из словаря городов ATI.SU
Широта
Долгота
Адрес
Id из справочника организаций
Id адреса в организации
Время "От"
Время "До"
Круглосуточно
Список Id ближайших крупных городов
Расстояния до ближайших крупных городов
Id города
Значение из словаря городов ATI.SU
Расстояние
Id груза
Наименование груза
Упаковка
Объем
Габариты
Длина в метрах
Ширина в метрах
Высота в метрах
Диаметр в метрах
Подсвечивать ли длину
Подсвечивать ли ширину
Подсвечивать ли высоту
Дополнительные точки
Id города
Значение из словаря городов ATI.SU
Тип дополнительной точки маршрута груза
1
— Загрузка2
— Разгрузка3
— Таможня4
— Ближайший крупный город к городу загрузки5
— Ближайший крупный город к городу разгрузки8
— Проехать через
Порядковый номер в маршруте
Расстояние
Адрес
Широта
Долгота
Id из справочника организаций
Id адреса в организации
Дата начала загрузки
Дата конца загрузки
Время начала загрузки
Время конца загрузки
Круглосуточно
Id груза
Наименование груза
Упаковка
Объем
Габариты
Длина в метрах
Ширина в метрах
Высота в метрах
Диаметр в метрах
Подсвечивать ли длину
Подсвечивать ли ширину
Подсвечивать ли высоту
Id груза
Вес
Объём
Выгружаемая часть упаковки
Выгружаемая часть груза будет определена в ТТН
Точка разгрузки
Id точки по базе ФИАС
Id города
Значение из словаря городов ATI.SU
Широта
Долгота
Адрес
Id из справочника организаций
Id адреса в организации
Время "От"
Время "До"
Круглосуточно
Список Id ближайших крупных городов
Расстояния до ближайших крупных городов
Id города
Значение из словаря городов ATI.SU
Расстояние
Id груза
Наименование груза
Упаковка
Объем
Габариты
Длина в метрах
Ширина в метрах
Высота в метрах
Диаметр в метрах
Подсвечивать ли длину
Подсвечивать ли ширину
Подсвечивать ли высоту
Параметры груза
Вес
Объем
Модификатор опасности груза с 0 до 9
Идентификатор наименования груза
Значение из словаря наименований грузов
Строковое наименование груза. Выводится если CargoTypeId не указан, либо равен 59
Тип упаковки(навалом, коробки, россыпью, запаллечен ... пирамида). Значение из словаря PackTypes
Количество паллетов
Количество ремней
Параметр, отвечающий за способ перевозки груза
1
— Только отдельной машиной2
— Догруз возможен3
— Догруз
Сборный груз
Размеры груза
Длина в метрах
Ширина в метрах
Высота в метрах
Диаметр в метрах
Подсвечивать ли длину
Подсвечивать ли ширину
Подсвечивать ли высоту
Параметры перевозки
Битовая сумма кузовов
Битовая сумма типов загрузки
Тип условия загрузки
OR
AND
Битовая сумма типов разгрузки
Тип условия разгрузки
OR
AND
Количество машин
Температура перевозки - нижнее значение
Температура перевозки - верхнее значение
Сцепка
Пневмоход
Коники
TIR
CMR
Т1
Мед книжка
Запрос отслеживания через АТИ Водитель
Требуемая грузоподъёмность в тоннах
Площадки, на которых опубликован груз
Id площадки
Имя площадки
Цвет площадки
Дата, начиная с которой можно разгрузить груз
Дата, до которой можно разгрузить груз
Заказ
Основная информация о заказе
Id Заказа
Id связанной копии груза
Id груза
Код фирмы, взявшей груз
Идентификатор пользователя, взявшего груз
Id контакта, взявшего груз
Код фирмы опубликовавшей груз
Идентификатор пользователя, опубликовавшего груз
Время изменения информации по Заказу
Время до которого груз зарезервирован
Id Торгов (аукциона)
Статус Заказа
0
— Груз зарезервирован перевозчиком1
— Перевозчик заполнил информацию о реквизитах/водителе/машине и грузовладелец не просмотрел заявку2
— Перевозчик заполнил информацию о реквизитах/водителе/машине и грузовладелец просмотрел заявку3
— Грузовладелец отправил документ-заявку перевозчику4
— Заказ в исполнении (перевозчик дал согласие на документ-заявку)5
— Заказ завершен и перенесен в архив7
— Есть только приглашение на Заказ8
— Заказа нет, но есть Торги, у которых есть возможные победители9
— Заказ отклонен автоматически, так как после последней даты загрузки прошло уже более 7 дней10
— Заказ завершен, ожидается оплата11
— В Торгах лучшая ставка из других Торгов-11
— Заказ удален-10
— Резерв груза перевозчиком отменен-9
— Заказ отклонен грузовладельцем в Торгах после истечения срока подачи документов (смена победителя)-8
— Грузовладелец отменил Заказ в исполнении-7
— Перевозчик отменил Заказ в исполнении-6
— Заказ отклонен грузовладельцем после удаления Торгов-4
— Заказ отклонен грузовладельцем в Торгах (смена победителя)-3
— Заказ отклонен грузовладельцем-2
— Заказ отозван перевозчиком
Статус Заказа у контрагента
0
— Груз зарезервирован перевозчиком1
— Перевозчик заполнил информацию о реквизитах/водителе/машине и грузовладелец не просмотрел заявку2
— Перевозчик заполнил информацию о реквизитах/водителе/машине и грузовладелец просмотрел заявку3
— Грузовладелец отправил документ-заявку перевозчику4
— Заказ в исполнении (перевозчик дал согласие на документ-заявку)5
— Заказ завершен и перенесен в архив7
— Есть только приглашение на Заказ8
— Заказа нет, но есть Торги, у которых есть возможные победители9
— Заказ отклонен автоматически, так как после последней даты загрузки прошло уже более 7 дней10
— Заказ завершен, ожидается оплата11
— В Торгах лучшая ставка из других Торгов-11
— Заказ удален-10
— Резерв груза перевозчиком отменен-9
— Заказ отклонен грузовладельцем в Торгах после истечения срока подачи документов (смена победителя)-8
— Грузовладелец отменил Заказ в исполнении-7
— Перевозчик отменил Заказ в исполнении-6
— Заказ отклонен грузовладельцем после удаления Торгов-4
— Заказ отклонен грузовладельцем в Торгах (смена победителя)-3
— Заказ отклонен грузовладельцем-2
— Заказ отозван перевозчиком
Параметры оплаты Заказа
Список возможных ставок перевозки
Сумма
Тип оплаты
0
— Нет1
— Любая2
— С НДС3
— Без НДС
Id валюты
Является ли ставка выбранной
Процент предоплаты
Есть ли предоплата
Оплата на выгрузке
Оплата топливом
Есть ли срок оплаты
Срок оплаты
Указана ли в грузе ставка
Возможен ли торг
Прямой договор
Способ оплаты
Информация об оплате заказа
Информация о копиях документов
Документ получен
Дата получения документов
Информация о оригиналах документов
Документ получен
Дата получения документов
Информация об отслеживании оригиналов документов
Id транспортной компании, осуществляющей доставку документов
Сссылка для отслеживания статуса отправления
Номер отправления
Дата отправки документов
Информация о оплате
Заказ оплачен
Дата оплаты
Файлы Заказа
Id файла
Id файла в хранилище
Доступ к файлу
0
— только загрузивший файл1
— обе стороны2
— загрузивший файл и водитель3
— доступен обеим сторонам и водителю
Время загрузки файла
Id связанного Заказа
Файл контрагента
Имя файла
Размер файла
Ссылка на файл
Источник файла
0
— Загружен в заказ1
— Скопирован из груза2
— Скопирован из данных о водителе3
— Скопироване из данных о грузовике4
— Скопирован из данных о прицепе5
— Скопирован из данных о полуприцепе6
— Скопирован из данных о тягаче7
— Загружен для Ати-водителя
Тип загруженного файла
0
— Обычный файл1
— Водительское удостоверение2
— Паспорт водителя3
— Техпаспорт ТС4
— Пластик5
— Фото ТС
Тип файла
0
— Другой документ1
— Товарно-транспортная накладная2
— Товарная накладная3
— Транспортная накладная4
— Накладная5
— Счет-фактура6
— Счет на оплату7
— Платежное поручение8
— Акт выполненных работ9
— Заявка10
— Заявка (к договору)11
— Заказ12
— Договор13
— Доп. соглашение (к договору)14
— Доверенность15
— Поручение экспедитору16
— Информационное письмо17
— Документ о происшествии с грузом/ТС
Список складов с Временными окнами с доступом к файлу
Информация о шаблонах документов в заказах
Адрес организации
Шаблоны документов
Время загрузки документа
Доступ к документу
0
— только загрузивший документ1
— обе стороны
Список складов с Временными окнами с доступом к документу
Id связанного Заказа
Id точки в заказе, к которой привязан документ
Id фирмы, загрузившей документ
Поле-хэш, рассчитывается на основе id грузов, выгружаемых в точке DealPointId. Если выгружаемые грузы не указаны - будет равно 0
Id контакта
Название документа
Id файла документа Можно скачать файл с помощью метода(https://ati.su/developers/api/filestorage/#get-v1.0-filestorage-files-%7bfile_id%7d-)
Id документа
Размер документа
Ссылка на документ (только для сайта)
Запрос отслеживания через АТИ Водитель
Показывать ли ставку водителю (для ОЗ)
Дата взятия/резервирования груза
Дата завершения заказа
Причина отклонения заказа
Присутствует когда Status -2
или -3
Id реквизитов
см. taker_requisites, в новой версии API это поле перестанет существовать
Реквизиты перевозчика
Id реквизитов
Более подробную информацию о реквизитах можно посмотреть здесь
Название компании
Id подписанта
Идентификатор формы собственности
Значение из словаря ОПФ АТИ
ИНН
КПП
Тип реквизитов
Id подписанта
см. taker_requisites, в новой версии API это поле перестанет существовать
Копия водителя
При взятии груза, водитель копируется, копию редактировать невозможно
Id копии водителя
Идентификатор водителя из Справочника Водителей
Имя водителя
Фамилия водителя
Отчество водителя
Номер телефона
Номер водительского удостоверения
Серия паспорта
Номер паспорта
Кем выдан
Когда выдан
Прописка
Флаг привлеченного водителя (со стороны)
Id связанной сущности по Заказу
Краткое описание водителя
Фирма от которой привлечен водитель.
Сканы паспорта / водительского удостоверения
ID
ID сущности, котрой принадлежит скан
Путь к файлу
Название
Тип документа
1
— Скан водительского удостоверения2
— Скан гражданского паспорта3
— Скан ПТС4
— Скан пластикового ПТС5
— Фото ТС8
— Договор о безвоздмездном пользовании
Идентификатор источника информации о водителе
0
— Неизвестно откуда указан водитель1
— Водитель указан на странице заказов у Заказа в исполнении2
— Водитель указан в АТИ-Доках
Дата рождения
Код подразделения
ИНН водителя
Есть в Черном списке
Причины добавления в Черный список
Копия транспортного средства
При взятии груза, транспортное средство копируется, копию редактировать невозможно
Id копии транспортного средства
Id транспортного средства из Автопарка
Id ТС, с которым было связано ТС во время выполнения последнего Заказа
Тип транспортного средства
1
— Грузовик2
— Тягач4
— Полуприцеп8
— Прицеп
Описание транспортного средства
Марка
Модель
Номер
Телефон
Привлеченное ТС
Тип владения ТС
0
- Собственное1
- Привлеченное2
- Аренда3
- Лизинг4
- Совместная собственность (супругов)5
- Безвозмездное пользование
Тип Кузова
Грузоподъемность
Объем
Длина
Ширина
Высота
Год выпуска
VIN
СТС
Номер кузова
Размерность контейнера
Номер ПТС
Способность возить реф-контейнеры
Есть GenSet
Имя владельца по СТС
Способность перевозить тяжелые контейнеры
Способность перевозить высокие контейнеры
Проверено
Запрещено редактирование и удаление ТС.
Сканы ПТС
ID
ID сущности, котрой принадлежит скан
Путь к файлу
Название
Тип документа
1
— Скан водительского удостоверения2
— Скан гражданского паспорта3
— Скан ПТС4
— Скан пластикового ПТС5
— Фото ТС8
— Договор о безвоздмездном пользовании
Источник создания Транспорта
0
— Неизвестно откуда указано ТС1
— ТС указано на странице заказов у Заказа в исполнении2
— ТС Указано в АТИ-доках
Копия прицепа
При взятии груза, прицеп копируется, копию редактировать невозможно
Id копии транспортного средства
Id транспортного средства из Автопарка
Id ТС, с которым было связано ТС во время выполнения последнего Заказа
Тип транспортного средства
1
— Грузовик2
— Тягач4
— Полуприцеп8
— Прицеп
Описание транспортного средства
Марка
Модель
Номер
Телефон
Привлеченное ТС
Тип владения ТС
0
- Собственное1
- Привлеченное2
- Аренда3
- Лизинг4
- Совместная собственность (супругов)5
- Безвозмездное пользование
Тип Кузова
Грузоподъемность
Объем
Длина
Ширина
Высота
Год выпуска
VIN
СТС
Номер кузова
Размерность контейнера
Номер ПТС
Способность возить реф-контейнеры
Есть GenSet
Имя владельца по СТС
Способность перевозить тяжелые контейнеры
Способность перевозить высокие контейнеры
Проверено
Запрещено редактирование и удаление ТС.
Сканы ПТС
ID
ID сущности, котрой принадлежит скан
Путь к файлу
Название
Тип документа
1
— Скан водительского удостоверения2
— Скан гражданского паспорта3
— Скан ПТС4
— Скан пластикового ПТС5
— Фото ТС8
— Договор о безвоздмездном пользовании
Источник создания Транспорта
0
— Неизвестно откуда указано ТС1
— ТС указано на странице заказов у Заказа в исполнении2
— ТС Указано в АТИ-доках
Копия полуприцепа
При взятии груза, полуприцеп копируется, копию редактировать невозможно
Id копии транспортного средства
Id транспортного средства из Автопарка
Id ТС, с которым было связано ТС во время выполнения последнего Заказа
Тип транспортного средства
1
— Грузовик2
— Тягач4
— Полуприцеп8
— Прицеп
Описание транспортного средства
Марка
Модель
Номер
Телефон
Привлеченное ТС
Тип владения ТС
0
- Собственное1
- Привлеченное2
- Аренда3
- Лизинг4
- Совместная собственность (супругов)5
- Безвозмездное пользование
Тип Кузова
Грузоподъемность
Объем
Длина
Ширина
Высота
Год выпуска
VIN
СТС
Номер кузова
Размерность контейнера
Номер ПТС
Способность возить реф-контейнеры
Есть GenSet
Имя владельца по СТС
Способность перевозить тяжелые контейнеры
Способность перевозить высокие контейнеры
Проверено
Запрещено редактирование и удаление ТС.
Сканы ПТС
ID
ID сущности, котрой принадлежит скан
Путь к файлу
Название
Тип документа
1
— Скан водительского удостоверения2
— Скан гражданского паспорта3
— Скан ПТС4
— Скан пластикового ПТС5
— Фото ТС8
— Договор о безвоздмездном пользовании
Источник создания Транспорта
0
— Неизвестно откуда указано ТС1
— ТС указано на странице заказов у Заказа в исполнении2
— ТС Указано в АТИ-доках
Основной документ в АТИ-Доках
ID документа
ID старого документа
Фирма, отредактировавшая документ
Адрес просмотра договора
Адрес просмотра старого договора
Имя документа
Документ подписан перевозчиком
Доступ к документу
0
— Обе стороны1
— Водитель
Дополнительные документы
Id документа
Файл контрагента
Адрес документа
Имя документа
Документ подписан перевозчиком
Тип документа
0
— Нет1
— Заказ2
— Договор-заявка3
— Поручение экспедитору4
— Акт5
— Счет6
— Одностороннее расторжение7
— Доверенность8
— Табличный заказ9
— Заявка к договору (табличный вид)
Доступ к документу
0
— Обе стороны1
— Водитель
Статусная модель перевозки
0
— Простая перевозка1
— Первая миля2
— Последняя миля3
— Порожний контейнер
Статус перевозки заказа
Id Заказа
Статус перевозки
0
— Нет статуса1
— Едет на загрузку2
— Ожидает загрузку3
— Загружается4
— Загрузился, едет на выгрузку5
— Ожидает выгрузку6
— Выгружается7
— Выгрузился8
— Поломка9
— ДТП10
— Арест ТС11
— Контейнер получен на погрузку12
— Контейнер на погрузке13
— Погрузка контейнера окончена14
— Контейнер сдан с погрузки15
— Контейнер получен на выгрузку16
— Контейнер на выгрузке17
— Выгрузка контейнера окончена18
— Контейнер сдан с выгрузки19
— Пустой контейнер получен20
— Пустой контейнер сдан100
— Заказ завершён
Дата выставления статуса
Фирма, выставившая статус (перевозчик или грузовладелец)
Контакт, выставивший статус
Номер телефона трекера, откуда получен статус
Предлагаемые правки к документу
Тип Заказа
0
— Заказ невозможен1
— Взятие груза из поиска2
— Заказ из Торгов4
— Предложение груза8
— Из перехвата машин16
— Односторонний заказ32
— Предложение груза из встречного предложения64
— Предложение груза по контракту
Точки маршрута
Id точки заказа
Порядковый номер
Тип точки маршрута
1
— Загрузка2
— Разгрузка
Id города
Значение из словаря городов ATI.SU
Широта
Долгота
Адрес
Название организации
Id региона Значение из словаря регионов ATI.SU
4XX Ошибка запроса. [Подробнее про ошибки API](https://ati.su/developers/documentation/errors/)
Модель ошибки
Причина ошибки
Ключ ошибки
- Торги (Аукцион) - в данном случае грузовладелец устанавливает начальную ставку и шаг, с которым эта ставка будет понижаться, а также время, в течение которого продлятся Торги. Вы вместе с другими перевозчиками можете побороться за право перевезти груз. Победит тот, чья ставка будет самой низкой, либо кто предложит самую лучшую дату перевозки, если это опция была предусмотрена грузовладельцем.
Получить всю информацию по идущим Торгам можно с помощью метода получения Торгов:
Получение Торгов (аукциона) по Id get /v1.2/auction/{auctionId}
curl 'https://api.ati.su/v1.2/auction/{auctionId}' \ -X 'GET' \ -H 'Authorization: Bearer {authorizationToken}' \ -H 'Content-Type: application/json'
Процедура ВыполнитьHTTPЗапрос(МетодЗапроса, АдресХоста, АдресРесурса, ТекстЗапроса) Экспорт ЗаголовкиHTTP = Новый Соответствие(); ЗаголовкиHTTP.Вставить("Accept", "application/json"); ЗаголовкиHTTP.Вставить("Content-Type", "application/json"); ЗаголовкиHTTP.Вставить("Authorization", "Bearer {authorizationToken}"); HTTPЗапрос = Новый HTTPЗапрос(АдресРесурса, ЗаголовкиHTTP); HTTPЗапрос.УстановитьТелоИзСтроки(ТекстЗапроса, КодировкаТекста.UTF8, ИспользованиеByteOrderMark.НеИспользовать); ЗащищенноеСоединениеSSL = Новый ЗащищенноеСоединениеOpenSSL(Новый СертификатКлиентаWindows, Новый СертификатыУдостоверяющихЦентровWindows);
Соединение = Новый HTTPСоединение(АдресХоста,,,,,, ЗащищенноеСоединениеSSL);
Попытка Ответ = Соединение.ВызватьHTTPМетод(МетодЗапроса, HTTPЗапрос); Сообщить("Код ответа: " + Ответ.КодСостояния); Сообщить("Ответ: " + Ответ.ПолучитьТелоКакСтроку("UTF-8")); Исключение Сообщить("Ошибка выполнения запроса!" + Символы.ПС + ОписаниеОшибки()); КонецПопытки;КонецПроцедуры
ВыполнитьHTTPЗапрос("GET", "https://api.ati.su", "/v1.2/auction/{auctionId}");
200 Торги (аукцион) для грузовладельца (код 200)
Торги (аукцион) для грузовладельца
Возможность принимать другой тип оплаты (с НДС или без НДС)
Id сделки, привязанной к Торгам (аукциону)
Id Торгов (аукциона)
Список ставок по Торгам (аукциону)
Дата добавления
Фирма, поставившая ставку
Id ставки
Контакт
Ближайшая возможная для перевозчика дата загрузки. Используется только в Торгах с критерием победы по ставке и дате загрузки
Ставка c НДС на груз, выставленная перевозчиком
Ставка без НДС на груз, выставленная перевозчиком
Система, на стороне которой сделана ставка
Статус ставки
-8
- Грузоотправитель отклонил документ-7
- Победитель отклонил документ-6
- Победитель отменил сделку-5
- Грузовладелец отменил сделку-4
- Победитель отказался, теперь его нельзя выбрать больше в качестве победителя-3
- Бывший победитель-2
- Перевозчик отказался от участия0
- Непобедная ставка при завершении Торгов (аукциона)1
- Победная ставка
Параметры перезапуска торгов
Финальное действие после завершения аукциона
1
— Опубликовать груз со ставкой2
— Опубликовать груз с запросом ставки3
— Удалить груз
Оставшееся количество попыток выбора нового победителя
Оставшееся количество попыток перезапуска торгов
Длительность торгов в минутах после перезапуска
Начальное количество попыток выбора нового победителя
Начальное количество попыток перезапуска торгов
Параметр, показывающий, был ли последний перезапуск выбран вручную
Повышение ставки при перезапуске
Способ повышения ставки
1
— Повышение ставки в валюте2
— Повышение ставки в процентах
Автопродление Торгов (аукциона) при выставлении ставки в последние 5 минут до окончания Торгов (аукциона)
Валюта ставки на груз
Текущая ставка с НДС
Текущая ставка без НДС
Аукцион помечен удалённым - спустя некоторое время он автоматически удалится полностью
Время окончания подачи документов (только для победителя)
Длительность Торгов (аукциона) в минутах
Время окончания Торгов (аукциона)
Время окончания Торгов (аукциона), после которого они автоматически завершаются, если нет автопродления
Тип окончания аукциона
0
- По времени1
- По минимальной ставке2
- Досрочное
Завершены ли Торги (аукцион)
Время подачи документов истекло (только для победителя)
Id груза, для которого активны Торги (аукцион)
Максимально допустимая ставка по Торгам (аукциону) при автоповышении (RaiseBid = true)
Максимально допустимое время, на которое сдвигается окончание Торгов (аукциона) при включённом AutoRenew (в минутах)
Ставка НДС
Следующая возможная ставка с НДС
Следующая возможная ставка без НДС
Количество участников
Автоповышение ставки на Шаг (step), если нет предложений
Период увеличения ставки в минутах при автоповышении (RaiseBid = true)
Отмена ставки запрещена
Время, на которое сдвигается окончание Торгов (аукциона) при включённом AutoRenew (в минутах)
Количество минут с момента начала Торгов (аукциона) (StartDate), после которых возможно принимать встречные предложения
Встречные предложения запрещены
Серверное время. Для синхронизации Торгов (аукциона)
Время начала Торгов (аукциона)
Длительность Торгов (аукциона) отсчитывается с момента первой ставки
Статус аукциона
-100
- Не удалось определить состояние аукциона-14
- Аукцион отменён вручную грузовладельцем-13
- Аукцион удалён, т.к. расторгнут заказ-12
- Аукцион без ставок завершён-11
- Аукцион удалён автоматически-
-10
- Аукцион удалён т.к. сделка завершена -9
- Аукцион удалён-8
- При включённом копировании грузов: ожидается действие от экспедитора в случае, когда заказ с победителем отменён, других участников нет-7
- При включённом копировании грузов: ожидается действие с торгами от экспедитора в случае, когда заказ с победителем отменён и есть потенциальный победитель-6
- При включённом копировании грузов: торги завершены, экспедитор не является победителем-5
- Одна ставка лучшая по цене, другая по дате-4
- Закончился, но победитель вовремя не взял груз и при этом есть еще возможные победители-3
- Закончился, но победитель вовремя не взял груз и при этом он единственный возможный победитель-2
- Закончился, ждем когда победитель возьмёт груз-1
- Закончился, ставок нет0
- Идет, ставок нет1
- Идёт (уже есть валидные ставки)
Шаг изменения ставки Торгов (аукциона)
Время на предоставление перевозчиком данных для заявки (в часах)
Время выигрыша ставки (только для победителя)
Критерий победы в аукционе
0
- Выбор победителя происходит автоматически по лучшей ставке1
- Выбор победителя происходит по ставке и дате загрузки. Если нет лучшей ставки с лучшей датой - требуется выбор победителя вручную
201 Торги (аукцион) для участника (код 200)
Торги (аукцион) для перевозчика
Id Торгов (аукциона)
Валюта ставки на груз
Текущая ставка с НДС
Текущая ставка без НДС
Время окончания Торгов (аукциона)
Завершены ли Торги (аукцион)
Ставка лучшая в незавершенных Торгах (аукционе) (в завершенных - не отображается)
Id груза, для которого активны Торги (аукцион)
Следующая возможная ставка с НДС
Следующая возможная ставка без НДС
Выставленная ставка
Дата добавления
Id ставки
Контакт
Ближайшая возможная для перевозчика дата загрузки. Используется только в Торгах с критерием победы по ставке и дате загрузки
Ставка c НДС на груз, выставленная перевозчиком
Ставка без НДС на груз, выставленная перевозчиком
Статус ставки
-8
- Грузоотправитель отклонил документ-7
- Победитель отклонил документ-6
- Победитель отменил сделку-5
- Грузовладелец отменил сделку-4
- Победитель отказался, теперь его нельзя выбрать больше в качестве победителя-3
- Бывший победитель-2
- Перевозчик отказался от участия0
- Непобедная ставка при завершении Торгов (аукциона)1
- Победная ставка
Количество участников
Отмена ставки запрещена
Встречные предложения запрещены
Серверное время. Для синхронизации Торгов (аукциона)
Время начала Торгов (аукциона)
Критерий победы в аукционе
0
- Выбор победителя происходит автоматически по лучшей ставке1
- Выбор победителя происходит по ставке и дате загрузки. Если нет лучшей ставки с лучшей датой - требуется выбор победителя вручную
202 Торги (аукцион) для победителя (код 200)
Торги (аукцион) для победителя
Id сделки, привязанной к Торгам (аукциону)
Id Торгов (аукциона)
Валюта ставки на груз
Текущая ставка с НДС
Текущая ставка без НДС
Время окончания подачи документов (только для победителя)
Время окончания Торгов (аукциона)
Завершены ли Торги (аукцион)
Время подачи документов истекло (только для победителя)
Id груза, для которого активны Торги (аукцион)
Выставленная ставка
Дата добавления
Id ставки
Контакт
Ближайшая возможная для перевозчика дата загрузки. Используется только в Торгах с критерием победы по ставке и дате загрузки
Ставка c НДС на груз, выставленная перевозчиком
Ставка без НДС на груз, выставленная перевозчиком
Статус ставки
-8
- Грузоотправитель отклонил документ-7
- Победитель отклонил документ-6
- Победитель отменил сделку-5
- Грузовладелец отменил сделку-4
- Победитель отказался, теперь его нельзя выбрать больше в качестве победителя-3
- Бывший победитель-2
- Перевозчик отказался от участия0
- Непобедная ставка при завершении Торгов (аукциона)1
- Победная ставка
Количество участников
Отмена ставки запрещена
Встречные предложения запрещены
Серверное время. Для синхронизации Торгов (аукциона)
Время начала Торгов (аукциона)
Время на предоставление перевозчиком данных для заявки (в часах)
Время выигрыша ставки (только для победителя)
Критерий победы в аукционе
0
- Выбор победителя происходит автоматически по лучшей ставке1
- Выбор победителя происходит по ставке и дате загрузки. Если нет лучшей ставки с лучшей датой - требуется выбор победителя вручную
404 Торги (аукцион) не найдены
Для этого вам понадобится ID Торгов, который вы можете получить в ответе метода поиска грузов:
Проводит поиск грузов, которые размещены на указанных площадках. В результате присутствуют как ваши грузы, так и грузы других пользователей. get /v1.0/loads/search/byboards
curl 'https://api.ati.su/v1.0/loads/search/byboards' \ -X 'GET' \ -H 'Authorization: Bearer {authorizationToken}' \ -H 'Content-Type: application/json'
Процедура ВыполнитьHTTPЗапрос(МетодЗапроса, АдресХоста, АдресРесурса, ТекстЗапроса) Экспорт ЗаголовкиHTTP = Новый Соответствие(); ЗаголовкиHTTP.Вставить("Accept", "application/json"); ЗаголовкиHTTP.Вставить("Content-Type", "application/json"); ЗаголовкиHTTP.Вставить("Authorization", "Bearer {authorizationToken}"); HTTPЗапрос = Новый HTTPЗапрос(АдресРесурса, ЗаголовкиHTTP); HTTPЗапрос.УстановитьТелоИзСтроки(ТекстЗапроса, КодировкаТекста.UTF8, ИспользованиеByteOrderMark.НеИспользовать); ЗащищенноеСоединениеSSL = Новый ЗащищенноеСоединениеOpenSSL(Новый СертификатКлиентаWindows, Новый СертификатыУдостоверяющихЦентровWindows);
Соединение = Новый HTTPСоединение(АдресХоста,,,,,, ЗащищенноеСоединениеSSL);
Попытка Ответ = Соединение.ВызватьHTTPМетод(МетодЗапроса, HTTPЗапрос); Сообщить("Код ответа: " + Ответ.КодСостояния); Сообщить("Ответ: " + Ответ.ПолучитьТелоКакСтроку("UTF-8")); Исключение Сообщить("Ошибка выполнения запроса!" + Символы.ПС + ОписаниеОшибки()); КонецПопытки;КонецПроцедуры
ВыполнитьHTTPЗапрос("GET", "https://api.ati.su", "/v1.0/loads/search/byboards");
200 Массив грузов, которые опубликованы на выбранных площадках
Метаданные для интеграторов
Идентификатор метаданных
Метаданные
Максимальная длина 1024 символа
Идентификатор первого выбранного контакта.
Список всех контактов и их идентификаторы можно получить с помощью API для работы с фирмами
Контакт должен быть виден для остальных участников АТИ
Идентификатор второго выбранного контакта, если не выбрано, то null
Контакт должен быть виден для остальных участников АТИ
Примечание к грузу
Ограничение по длине: 1000 символов
Дата, начиная с которой груз актуален, в формате UTC
Минимальное значение равно текущей дате
При значении параметра DateType равным 0, допустимое значение поля - текущая дата
При значении параметра DateType равным 1, допустимое значение поля - от текущей даты до 60 дней вперед
При значении параметра DateType равным 2, допустимое значение поля - текущая дата
При значении параметра DateType равным 3, FirstDate должен принимать значение текущей даты или отсутствовать
Дата, после которой груз не актуален, в формате UTC
Минимальное значение равно значению параметра FirstDate
При значении параметра DateType равным 0, допустимое значение поля - от текущей даты до 1 дня вперед
При значении параметра DateType равным 1, допустимое значение поля - от даты в параметре FirstDate до 9 дней вперед
При значении параметра DateType равным 2, данное поле вычисляется автоматически по формуле FirstDate + 2 месяца, передаваемое значение игнорируется
При значении параметра DateType равным 3, LastDate автоматически устанавливается на значение + 2 дня от текущей даты, передаваемое значение игнорируется
Выбор типа готовности груза к перевозке
0
- Готов к загрузке1
- с Х по У2
- постоянно3
- груза нет, запрос ставки
Периодичность загрузки
Если параметр DateType не равен 2, PeriodicityId равен 0.
Иначе PeriodicityId может принимать следующие значения:
1
- ежедневно100
- по рабочим дням
Номер заказа
Ограничение по длине: 250 символов
Параметр, который определяет, включен ли кругорейс для перевозки груза
Загрузка
Идентификатор города загрузки/разгрузки
Значение из словаря городов АТИ
Широта города загрузки/разгрузки
Параметр должен быть указан, если не указана улица (параметр Street равен null или имеет длину менее 5 символов) и выполняется хотя бы одно из трех условий:
- указан город Москва;
- указан город Санкт-Петербург;
- города загрузки и разгрузки совпадают.
Если параметр Longitude задан, то необходимо указать и этот параметр.
Допустимое значение от -90 до 90.
Долгота города загрузки/разгрузки
Параметр должен быть указан, если не указана улица (параметр Street равен null или имеет длину менее 5 символов) и выполняется хотя бы одно из трех условий:
- указан город Москва;
- указан город Санкт-Петербург;
- города загрузки и разгрузки совпадают.
Если параметр Latitude задан, то необходимо указать и этот параметр.
Допустимое значение от -90 до 90.
Улица или район города загрузки/разгрузки
Параметр должен быть указан и иметь длину не менее 5 символов, если не указаны координаты (параметры Longtittude и Lattitude равны null) и выполняется хотя бы одно из трех условий:
- указан город Москва;
- указан город Санкт-Петербург;
- города загрузки и разгрузки совпадают.
Максимальная длина 100 символов.
Время начала загрузки/разгрузки
Не указывается при значении параметра DateType равным 3.
Не указывается при значении IsRoundTheClock: true
Время завершения загрузки/разгрузки
Не указывается при значении параметра DateType равным 3.
Не указывается при значении IsRoundTheClock: true
Определяет выбрано ли значение Круглосуточно
По умолчанию - false
Не указывается при значении параметра DateType равным 3.
Массив идентификаторов ближайших крупных городов
Значение из словаря городов АТИ
Максимальное количество - 10 штук
Id груза
Наименование груза
Упаковка
Объем
Габариты
Список дополнительных пунктов маршрута
Максимальное количество - 15 штук
Идентификатор города
Значение из словаря городов АТИ
Тип точки:
1
- загрузка2
- разгрузка3
- таможня8
- проехать через
Долгота
Широта
Улица или район
Порядковый номер
Загрузка/разгрузка круглосуточно
Дата начала периода загрузки/разгрузки
Дата окончания периода загрузки/разгрузки
Время начала загрузки/разгрузки
Время окончания загрузки/разгрузки
Id груза
Наименование груза
Упаковка
Объем
Габариты
Id груза
Вес
Объём
Выгружаемая часть упаковки
Выгружаемая часть груза будет определена в ТТН
Разгрузка
Идентификатор города загрузки/разгрузки
Значение из словаря городов АТИ
Широта города загрузки/разгрузки
Параметр должен быть указан, если не указана улица (параметр Street равен null или имеет длину менее 5 символов) и выполняется хотя бы одно из трех условий:
- указан город Москва;
- указан город Санкт-Петербург;
- города загрузки и разгрузки совпадают.
Если параметр Longitude задан, то необходимо указать и этот параметр.
Допустимое значение от -90 до 90.
Долгота города загрузки/разгрузки
Параметр должен быть указан, если не указана улица (параметр Street равен null или имеет длину менее 5 символов) и выполняется хотя бы одно из трех условий:
- указан город Москва;
- указан город Санкт-Петербург;
- города загрузки и разгрузки совпадают.
Если параметр Latitude задан, то необходимо указать и этот параметр.
Допустимое значение от -90 до 90.
Улица или район города загрузки/разгрузки
Параметр должен быть указан и иметь длину не менее 5 символов, если не указаны координаты (параметры Longtittude и Lattitude равны null) и выполняется хотя бы одно из трех условий:
- указан город Москва;
- указан город Санкт-Петербург;
- города загрузки и разгрузки совпадают.
Максимальная длина 100 символов.
Время начала загрузки/разгрузки
Не указывается при значении параметра DateType равным 3.
Не указывается при значении IsRoundTheClock: true
Время завершения загрузки/разгрузки
Не указывается при значении параметра DateType равным 3.
Не указывается при значении IsRoundTheClock: true
Определяет выбрано ли значение Круглосуточно
По умолчанию - false
Не указывается при значении параметра DateType равным 3.
Массив идентификаторов ближайших крупных городов
Значение из словаря городов АТИ
Максимальное количество - 10 штук
Id груза
Наименование груза
Упаковка
Объем
Габариты
Информация о грузе
Вес груза в тоннах
Обязательный параметр, если не задан параметр Volume.
Объем груза в кубических метрах
Обязательный параметр, если не задан параметр Weight. Максимальная длина - 4 символа
Параметр, определяющий степень опасности груза
Допустимое значение от 0 до 9. По умолчанию - 0
Идентификатор наименования груза
Значение из Словаря наименований грузов
Строковое наименование груза.
Обязательный параметр, если значение параметра CargoTypeId равно 59
.
Максимальная длина названия - 50 символов.
Этот параметр должен быть пустым, если параметр CargoTypeId
отличен от 59
.
В этом поле запрещено указывать контактную информацию
Идентификатор наименования упаковки (навалом, коробки, россыпью...)
Значение из Словаря наименований грузов
Количество упаковок для груза
Допустимое значение от 0 до 9999. По умолчанию - 0
Количество ремней для груза
Допустимое значение от 0 до 9999. По умолчанию - 0
Вариант перевозки:
1
- только отдельной машиной2
- отдельной или догрузом
Определяет, является ли груз сборным
Параметры размера груза
Длина груза в метрах
Допустимое значение от 0 до 50. Максимальная длина - 5 символов. По умолчанию - 0
Ширина груза в метрах
Допустимое значение от 0 до 50. Максимальная длина - 5 символов. По умолчанию - 0
Высота груза в метрах
Допустимое значение от 0 до 50. Максимальная длина - 5 символов. По умолчанию - 0
Диаметр груза в метрах
Допустимое значение от 0 до 50. Максимальная длина - 5 символов. По умолчанию - 0
Выделение красным цветом длины груза (для привлечения внимания перевозчика в случае нестандартных размеров груза)
Выделение красным цветом ширины груза (для привлечения внимания перевозчика в случае нестандартных размеров груза)
Выделение красным цветом высоты груза (для привлечения внимания перевозчика в случае нестандартных размеров груза)
Параметры транспорта
Битовая сумма ID кузовов
Значение из словаря кузовов АТИ
Битовая сумма ID типов загрузки
Значение из словаря вариантов загрузки АТИ
Тип условия загрузки:
OR
- необходимо, чтобы присутствовал один из способов загрузкиAND
- необходимо, чтобы присутствовали все выбранные типы загрузки
Битовая сумма ID типов разгрузки.
Значение из словаря вариантов разагрузки АТИ
Тип условия разгрузки:
OR
- необходимо, чтобы присутствовал один из способов разгрузкиAND
- необходимо, чтобы присутствовали все выбранные типы разгрузки
Количество машин
Допустимое значение от 1 до 99. По умолчанию - 1
Минимальная температура для груза, если выбран тип кузова "Рефрижератор", "Рефрижератор с перегородкой", "Рефрижератор-мультирежимный"
Допустимое значение от -99 до 999
Максимальная температура для груза, если выбран тип кузова "Рефрижератор", "Рефрижератор с перегородкой", "Рефрижератор-мультирежимный"
Допустимое значение от -99 до 999
Определяет, нужна ли сцепка для груза
Определяет, нужен ли пневмоход для груза
Определяет, нужны ли коники для груза
Документы на транспорт, необходимые для провоза этого груза: документы TIR
Документы на транспорт, необходимые для провоза этого груза: документы CMR
Документы на транспорт, необходимые для провоза этого груза: документы T1
Документы на транспорт, необходимые для провоза этого груза: медкнижка
Трекинг через АТИ Водитель
Оплата
Идентификатор валюты
По умолчанию - 1. Должен принимать значение 0, если параметр FixedRate равен false
Значение из словаря валют АТИ
Идентификатор варианта оплаты
По умолчанию - 22
. Должен принимать значение 22
, если параметр FixedRate
равен false
Значение из словаря вариантов оплаты АТИ
Ставка для груза
Обязательный параметр, если параметр FixedRate равен true и не заданы параметры SumWithNDS или SumWithoutNDS. Максимальная длина 6 символов. Если ввести более двух цифр после запятой, будет произведено округление. Если параметр MoneyType равен 22 и RateSum > 0, тогда поля SumWithNDS и SumWithoutNDS должны быть пустыми или принимать значение 0
Ставка б/нал с НДС
Обязательный параметр, если параметр FixedRate равен true и не заданы параметры RateSum или SumWithoutNDS. Максимальная длина 6 символов. Если ввести более двух цифр после запятой, будет произведено округление. Если параметр FixedRate равен false, то параметр SumWithNDS должен отсутствовать или быть равным 0
Ставка б/нал без НДС
Обязательный параметр, если параметр FixedRate равен true и не заданы параметры SumWithNDS или RateSum. Максимальная длина 6 символов. Если ввести более двух цифр после запятой, будет произведено округление. Если параметр FixedRate равен false, то параметр SumWithoutNDS должен отсутствовать или быть равным 0
Процент предоплаты
Допустимое значение от 0 до 100. Должен отсутствовать или принимать значение 0, если параметр PrepayPercentEnabled равен false
Есть ли предоплата
Через сколько банковских дней оплата
Допустимое значение от 0 до 99. Должен отсутствовать или принимать значение 0, если параметр PayDaysEnabled равен false
Параметр, что включен флажок "через банк. дней"
По умолчанию - false. Не может быть установлен в true, если параметр OnUnloading тоже установлен в true
true, если ставка задана, false если запрос ставки
По умолчанию - true. При значении параметра DateType равным 3, должен иметь значение false. Если указано значение True, значение хотя бы одного из полей RateSum, SumWithNDS, SumWithoutNDS должно быть больше или равно 1
Возможен ли торг
По умолчанию - false. Не учитывается, если параметр FixedRate равен false
Прямой договор
Предоплата топливом
Оплата на выгрузке
Скрыть встречные предложения
Позволяет указать форму оплаты при выборе параметра "Запрос ставки":
1
- наличные2
- б/нал с НДС3
- нал и б/нал с НДС4
- б/нал без НДС5
- нал и б/нал без НДС6
- б/нал с НДС и без НДС7
- нал и б/нал с НДС и без НДС0
- указана фикс. ставка
Настройки автоприглашений
Время в секундах сбора встречных предложений, по истечение которого будет создано приглашение по лучшему из них
Время в секундах действия приглашения
Приоритетный показ
Суточный лимит списания по услуге
- Должен иметь длину не более 5 символов
- Не более 2 символов после запятой
- Должен быть больше либо равен значению ViewRate или быть равным нулю (если ограничения нет)
- Должен быть равен 0 или отсутствовать, если параметр ViewRate отсутствует или равен 0
Показывать приоритетный показ только платным пользователям
Лимит на заявку
- Должен иметь длину не более 5 символов
- Не более 2 символов после запятой
- Должен быть больше либо равен значению ViewRate или быть равным нулю (если ограничения нет)
- Должен быть равен 0 или отсутствовать, если параметр ViewRate отсутствует или равен 0
Ставка за просмотр
- Минимальное значение 0,6
- Не более 2 символов после запятой
- Должен иметь длину не более 5 символов
Количество денег, потраченное на заявку за день. Только для чтения
Количество денег, потраченное на заявку в целом. Только для чтения
Настройки показа груза
Режим стэлс, ID списка для которого данный груз показываться не будет
Получить ID списка можно с помощью API списков фирмы
Режим стэлс, Для фирм с датой регистрации меньше данной груз показываться не будет
Режим стэлс, минимальное количество баллов фирмы. Для фирм с меньшим количество баллов груз показываться не будет
Файлы к грузу
Перед добавлением груза с файлом, файл предварительно необходимо загрузить в АТИ-Доки (см. API для хранения файлов)
Идентификатор файла, возвращается при загрузке файла в АТИ-Доки
Тип загруженного файла:
1
- документ
Битовый набор опции файла
0
- Значение по умолчанию. Данный файл доступен по ссылке1
- Данный файл доступен только владельцу груза
Имя файла
Для имени файла разрешено использовать следующие символы: цифры, заглавные и строчные буквы латинского и кириллического алфавита, дефис, точка, пробел.
Длинна: до 100 символов. Имя файла присваивается при загрузке в АТИ-Доки
Ссылка, по которой можно скачать файл, возвращается при загрузке файла в АТИ-Доки
Размер файла
Информационное поле, на текущий момент не используется
Параметры аукциона
Начальная ставка аукциона
Параметр должен принимать значение от 1 до 9999999999 (включительно) и содержать не более 10 символов.
Валюта аукциона
Значение из словаря валют АТИ
Минимальное изменение ставки по аукциону
Параметр должен принимать значение от 1 до 9999999999 (включительно), содержать не более 10 символов и не должен превышать половину начальной ставки startRate.
Тип оплаты
22
: любой1
: наличные23
: по карте24
: безнал с НДС25
: безнал без НДС
Принимать ставки без НДС. Параметр можно указать, если начальная ставка указана с НДС (PaymentType=24)
Время начала аукциона. Должно быть позже времени начала публикации груза на площадке. По умолчанию устанавливается текущая дата UTC.
Время окончания аукциона. Необязательное поле, если есть значение в поле Duration
Время окончания аукциона "завершить не позже". Если указанное время, меньше значения Duration - аукцион заканчивается по времени "завершить не позже", если нет автопродления. Время устанавливается в формате UTC.
% НДС, от 1 до 99. Если выбрана опция "Принимать ставки без НДС", этот параметр определяет величину процента НДС.
Время на отправку заявки перевозчиком (в часах). Время на отправку заявки перевозчику должно быть не больше 24 часов, и не должно превышать 4 символов в длину.
Нужно ли продление аукциона, если была ставка в последние 5 минут до окончания
Время, на которое надо сдвигать окончание аукциона при включенном AutoRenew
Максимально допустимое время, на которое можно сдвинуть окончание аукциона при включенном AutoRenew
Указывать, если raiseBid = true. Параметр должен принимать значение от 1 до 999999 (включительно) и содержать не более 6 символов.
Повысить ставку на Шаг, если нет предложений
Максимально допустимая ставка по аукциону
Указывать, если raiseBid = true. Параметр должен принимать значение от 1 до 999999 (включительно) и содержать не более 6 символов.
Период увеличения ставки при отсутствии предложений
При RaiseBid = true должно принимать значение не меньше 1 минуты и не больше 24 часов.
Указывает, через какой промежуток времени с момента публикации аукциона принимать встречные предложения:
1
- сразу15, 30, 60, 120, 180
- время в минутахnull
- не принимать
Если AcceptCounterOffersOnlyBeforeFirstBet = true, то встречные предложения будут приниматься только до 1-й ставки
Длительность аукциона в минутах: 30, 60, 120, 180, 240, 360, 720, 1440, 2880, 4320, 5760, 7200
Значение не может быть больше времени актуальности груза LastDate
Флаг, определяющий, что обратный отсчет до окончания аукциона начинается только после первой ставки.
Параметры перезапуска аукциона
Действие после того, как все попытки перезапуска и выбора нового победителя торгов исчерпаны:
1
- Опубликовать груз со ставкой. В грузе должна быть указана ставка (SumWithNDS, SumWithoutNDS, RateSum)2
- Опубликовать с запросом ставки, возможные типы оплаты будут взяты из поля AcceptPaymentTypes в грузе3
- Перенести груз в архив
Количество перезапусков Торгов, от 0 до 3 включительно.
Если параметр не передать, по умолчанию 0
Сколько раз выбирать следующего победителя с лучшей ставкой, если предыдущий отказался, от 0 до 3 включительно
Если параметр не передать, по умолчанию 0
Длительность торгов в минутах после перезапуска
Необязательное поле, если его не передавать, то торги будут перезапущены с изначальной длительностью (поле Duration в структуре Аукцион). Однако если в структуре Аукцион заполнено поле EndDateBoundary и поле InitRestartCount имеет значение больше 0, то DurationAfterRestart становится обязательным
Можно принимать встречные предложения только до первой ставки?
Критерий выбора победителя торгов
0
- Выбор победителя происходит автоматически по лучшей ставке1
- Выбор победителя происходит по ставке и дате загрузки. Если нет лучшей ставки с лучшей датой - требуется выбор победителя вручную.
Id аукциона
Id груза, для которого активен аукцион
Id сделки, привязанной к аукциону
Статус аукциона
-100
- Не удалось определить состояние аукциона-14
- Аукцион отменен руками грузовладельца-13
- Аукцион удален, т.к. расторгнут заказ-12
- Аукцион без ставок завершен-11
- Аукцион удален автоматически-10
- Аукцион удален т.к. сделка завершена-9
- Аукцион удален-8
- При включенном копировании грузов: ожидается действие от экспедитора в случае, когда заказ с победителем отменен, других участников нет-7
- При включенном копировании грузов:ожидается действие с торгами от экспедитора в случае, когда заказ с победителем отменен и есть потенциальный победитель-6
- При включенном копировании грузов: торги завершены, экспедитор не является победителем-5
- Одна ставка лучшая по цене, другая по дате-4
- Закончился, но победитель вовремя не взял груз и при этом есть еще возможные победители-3
- Закончился, но победитель вовремя не взял груз и при этом он единственный возможный победитель-2
- Закончился, ждем когда победитель возьмет груз-1
- Закончился, ставок нет0
- Идет, ставок нет1
- Идет (уже есть валидные ставки)
Завершен ли аукцион
Время выигрыша ставки (когда для определенной ставки в AuctionRates установлен State = Winner)
Список ставок по аукциону
ID ставки
Когда сделана ставка
Фирма, оставившая заявку
"Звезды" фирмы
Тип звезд фирмы
0
: Серый1
: Красный2
: Желтый3
: Зеленый4
: Партнер АТИ5
: Сотрудник АТИ6
: Гос. органы7
: ОДКС
Имя фирмы
Имя контакта
Идентификатор фирмы в АТИ
Ставка на груз, которую поставил пользователь
Статус ставки
1
: Победная ставка в аукционе0
: Обычная ставка по аукциону (участник аукциона)-2
: Участник аукциона отменил ставку-3
: Бывший победитель, который не прислал документы-4
: Победитель отказался от участия-5
: Грузовладелец отменил безоговорочную сделку-6
: Победитель отменил безоговорочную сделку-7
: Победитель отклонил документ-8
: Грузовладелец отклонил документ
Ближайшая возможная для перевозчика дата загрузки
Используется только в аукционах с критерием победы по ставке и дате загрузки
Код фирмы, сделавшей ставку
Контакт, сделавший ставку
Список площадок
ID площадки
Время публикации на площадке
Учитывается, если PublicationOption
равно 6
Показывает разрешено ли бронирование грузов на Общей площадке
Учитывается только для Общей площадки, только при включенном Stealth
Параметры публикации груза:
0
- сразу1
- через 15 минут2
- через 30 минут3
- через час4
- через 3 часа5
- через 6 часов6
- указать точное время
Показывает, что груз уже опубликован на странице
Показывает является ли площадка Общей
Дата начала разгрузки, в формате UTC.
Может иметь значение null
.
Минимальное значение равно текущей дате.
При значении параметра DateType равным 3
, UnloadFirstDate принимает значение null
Дата окончания разгрузки, в формате UTC.
Может иметь значение null
.
Если нет даты начала разгрузки UnloadFirstDate, должна отсутствовать дата окончания разгрузки UnloadLastDate.
При значении параметра DateType равным 3
, UnloadFirstDate принимает значение null
Дата и время переноса в архив
Причина переноса в архив
Озвученная ставка
ID валюты озвученной ставки
Количество отзывов о грузе (без встречных предложений)
Количество встречных предложений (остальные отзывы не учитываются)
Есть ли доступ на удаление груза.
Есть ли доступ на работу с грузом (без учета прав).
Есть ли доступ на редактирование груза.
Есть ли доступ на обновление груза.
Есть ли доступ на восстановление груза
Причины отказа в доступе на редактирование груза:
0
- Вы имеете доступ к работе с грузом1
- Ваша фирма больше не может размещать грузы из-за нарушения правил АТИ2
- Груз зарезервирован/взят, операции с грузом запрещены3
- Превышен лимит актуальных грузов4
- Вы пытаетесь работать с грузами под общим пользователем. Недостаточно прав5
- У вашего контакта недостаточно прав для работы с данным грузом6
- Груз имеет завершенные Торги, операции с грузом запрещены7
- Сервис сделок временно недоступен8
- Нельзя изменять или удалять груз из сквозных торгов9
- У вашего контакта недостаточно прав для создания грузов10
- У вашего контакта недостаточно прав для работы с виртуальными кошельками11
- У вашего контакта недостаточно прав для работы с грузами на Общей площадке12
- У вашего контакта недостаточно прав для работы с грузами на Персональных площадках13
- У вашего контакта нет доступа для работы с одной или несколькими персональными площадками, указанными в грузе14
- У вашего контакта нет доступа для работы с подразделением, в которое восстанавливается груз15
- Ваш контакт должен быть указан первым в грузе
Причины отказа в доступе на удаление контакта:
0
- Вы имеете доступ к работе с грузом1
- Ваша фирма больше не может размещать грузы из-за нарушения правил АТИ2
- Груз зарезервирован/взят, операции с грузом запрещены3
- Превышен лимит актуальных грузов4
- Вы пытаетесь работать с грузами под общим пользователем. Недостаточно прав5
- У вашего контакта недостаточно прав для работы с данным грузом6
- Груз имеет завершенные Торги, операции с грузом запрещены7
- Сервис сделок временно недоступен8
- Нельзя изменять или удалять груз из сквозных торгов9
- У вашего контакта недостаточно прав для создания грузов10
- У вашего контакта недостаточно прав для работы с виртуальными кошельками11
- У вашего контакта недостаточно прав для работы с грузами на Общей площадке12
- У вашего контакта недостаточно прав для работы с грузами на Персональных площадках13
- У вашего контакта нет доступа для работы с одной или несколькими персональными площадками, указанными в грузе14
- У вашего контакта нет доступа для работы с подразделением, в которое восстанавливается груз15
- Ваш контакт должен быть указан первым в грузе
Причины отказа в доступе на восстановление груза:
0
- Вы имеете доступ к работе с грузом1
- Ваша фирма больше не может размещать грузы из-за нарушения правил АТИ2
- Груз зарезервирован/взят, операции с грузом запрещены3
- Превышен лимит актуальных грузов4
- Вы пытаетесь работать с грузами под общим пользователем. Недостаточно прав5
- У вашего контакта недостаточно прав для работы с данным грузом6
- Груз имеет завершенные Торги, операции с грузом запрещены7
- Сервис сделок временно недоступен8
- Нельзя изменять или удалять груз из сквозных торгов9
- У вашего контакта недостаточно прав для создания грузов10
- У вашего контакта недостаточно прав для работы с виртуальными кошельками11
- У вашего контакта недостаточно прав для работы с грузами на Общей площадке12
- У вашего контакта недостаточно прав для работы с грузами на Персональных площадках13
- У вашего контакта нет доступа для работы с одной или несколькими персональными площадками, указанными в грузе14
- У вашего контакта нет доступа для работы с подразделением, в которое восстанавливается груз15
- Ваш контакт должен быть указан первым в грузе
Причина отказа в доступе на обновление груза.
Идентификатор груза
Номер груза
Дата последнего изменения груза в формате UTC
Время добавления груза в формате UTC
Расстояние по дорогам в км
Протяженность дорог в км, в построенном пути за которые взимается плата по системе Платон
Протяженность платных дорог в построенном пути в км
Время в пути
Параметр, который определяет, включен ли зимник для перевозки груза
Параметр, который определяет, учитывать ли паромные переправы для перевозки груза
Идентификатор фирмы
Id аукциона
4XX Ошибка запроса. [Подробнее про ошибки API](https://ati.su/developers/api/loads/#loads-title-errors)
Модель ошибки
Причина ошибки
Ключ ошибки
А чтобы предложить свою ставку, воспользуйтесь методом выставления ставки в Торгах:
Выставление ставки в Торгах (аукционе) post /v1.2/auction/bet
Для внесения ставки грузоперевозчиком
Id аукциона
Ближайшая возможная для перевозчика дата загрузки. Используется только в Торгах с критерием победы по ставке и дате загрузки
Тип оплаты
1
- Наличка22
- Любая23
- На карту24
- С НДС25
- Без НДС- Остальные зарезервированы
Ставка на груз, поставленная перевозчиком
curl 'https://api.ati.su/v1.2/auction/bet' \ -X 'POST' \ -H 'Authorization: Bearer {authorizationToken}' \ -H 'Content-Type: application/json' \ --data-raw '{"auction_id":"3fa85f64-5717-4562-b3fc-2c963f66afa6","loading_date":"1970-01-01T00:00:00.000Z","payment_type":0,"rate":0.5}'
Процедура ВыполнитьHTTPЗапрос(МетодЗапроса, АдресХоста, АдресРесурса, ТекстЗапроса) Экспорт ЗаголовкиHTTP = Новый Соответствие(); ЗаголовкиHTTP.Вставить("Accept", "application/json"); ЗаголовкиHTTP.Вставить("Content-Type", "application/json"); ЗаголовкиHTTP.Вставить("Authorization", "Bearer {authorizationToken}"); HTTPЗапрос = Новый HTTPЗапрос(АдресРесурса, ЗаголовкиHTTP); HTTPЗапрос.УстановитьТелоИзСтроки(ТекстЗапроса, КодировкаТекста.UTF8, ИспользованиеByteOrderMark.НеИспользовать); ЗащищенноеСоединениеSSL = Новый ЗащищенноеСоединениеOpenSSL(Новый СертификатКлиентаWindows, Новый СертификатыУдостоверяющихЦентровWindows);
Соединение = Новый HTTPСоединение(АдресХоста,,,,,, ЗащищенноеСоединениеSSL);
Попытка Ответ = Соединение.ВызватьHTTPМетод(МетодЗапроса, HTTPЗапрос); Сообщить("Код ответа: " + Ответ.КодСостояния); Сообщить("Ответ: " + Ответ.ПолучитьТелоКакСтроку("UTF-8")); Исключение Сообщить("Ошибка выполнения запроса!" + Символы.ПС + ОписаниеОшибки()); КонецПопытки;КонецПроцедуры
ВыполнитьHTTPЗапрос("POST", "https://api.ati.su", "/v1.2/auction/bet", "{""auction_id"":""3fa85f64-5717-4562-b3fc-2c963f66afa6"",""loading_date"":""1970-01-01T00:00:00.000Z"",""payment_type"":0,""rate"":0.5}");
200 Статус ставки
Статус ставки после выставления
Торги (аукцион) для перевозчика
Id Торгов (аукциона)
Валюта ставки на груз
Текущая ставка с НДС
Текущая ставка без НДС
Время окончания Торгов (аукциона)
Завершены ли Торги (аукцион)
Ставка лучшая в незавершенных Торгах (аукционе) (в завершенных - не отображается)
Id груза, для которого активны Торги (аукцион)
Следующая возможная ставка с НДС
Следующая возможная ставка без НДС
Выставленная ставка
Дата добавления
Id ставки
Контакт
Ближайшая возможная для перевозчика дата загрузки. Используется только в Торгах с критерием победы по ставке и дате загрузки
Ставка c НДС на груз, выставленная перевозчиком
Ставка без НДС на груз, выставленная перевозчиком
Статус ставки
-8
- Грузоотправитель отклонил документ-7
- Победитель отклонил документ-6
- Победитель отменил сделку-5
- Грузовладелец отменил сделку-4
- Победитель отказался, теперь его нельзя выбрать больше в качестве победителя-3
- Бывший победитель-2
- Перевозчик отказался от участия0
- Непобедная ставка при завершении Торгов (аукциона)1
- Победная ставка
Количество участников
Отмена ставки запрещена
Встречные предложения запрещены
Серверное время. Для синхронизации Торгов (аукциона)
Время начала Торгов (аукциона)
Критерий победы в аукционе
0
- Выбор победителя происходит автоматически по лучшей ставке1
- Выбор победителя происходит по ставке и дате загрузки. Если нет лучшей ставки с лучшей датой - требуется выбор победителя вручную
Параметр устарел, используйте auction.end_date. Дата окончания Торгов (аукциона).
Статус выставленной ставки
0
- Ставка выставлена1
- Ставка выставлена и Торги (аукцион) завершены2
- Ставка не выставлена, поскольку Торги (аукцион) не найдены3
- Ставка не выставлена, поскольку она не лучшая4
- Ставка выставлена минимальная, но Торги (аукцион) не завершены5
- Ставка выставлена и Торги (аукцион) продлены6
- Ставка не выставлена, поскольку торги завершены
403 У вас нет доступа на сохранение ставки
404 Торги (аукцион) не найдены
Полная документация API Торгов.
Если вы одержите победу в Торгах, груз будет автоматически зарезервирован за вами, после чего вам нужно будет отправить грузовладельцу данные для оформления сделки на перевозку:
Взятие груза / Редактирование Заказа post /v1.2/orders/takeload/{loadId}
Параметры Заказа
Тип оплаты
0
— Нет1
— Любая2
— С НДС3
— Без НДС
Id водителя
Id транспортного средства
Id полуприцепа
Может быть указан только если транспортное средство — тягач
Id прицепа
Может быть указан только если указан полуприцеп или транспортное средство — грузовик
Id реквизитов
Id подписанта
Отзывать ли привязанные документы
Используется при редактировании
Тип Заказа
0
— Заказ невозможен1
— Взятие груза из поиска2
— Заказ из Торгов4
— Предложение груза8
— Из перехвата машин16
— Односторонний заказ32
— Предложение груза из встречного предложения64
— Предложение груза по контракту
Комментарий перевозчика
curl 'https://api.ati.su/v1.2/orders/takeload/{loadId}' \ -X 'POST' \ -H 'Authorization: Bearer {authorizationToken}' \ -H 'Content-Type: application/json' \ --data-raw '{"rate_type":0,"driver_id":"3fa85f64-5717-4562-b3fc-2c963f66afa6","truck_info_id":"3fa85f64-5717-4562-b3fc-2c963f66afa6","semitrailer_id":"3fa85f64-5717-4562-b3fc-2c963f66afa6","trailer_id":"3fa85f64-5717-4562-b3fc-2c963f66afa6","requisites_id":"3fa85f64-5717-4562-b3fc-2c963f66afa6","signer_id":"3fa85f64-5717-4562-b3fc-2c963f66afa6","is_drop_docs":false,"deal_kind":0,"taker_note":"string"}'
Процедура ВыполнитьHTTPЗапрос(МетодЗапроса, АдресХоста, АдресРесурса, ТекстЗапроса) Экспорт ЗаголовкиHTTP = Новый Соответствие(); ЗаголовкиHTTP.Вставить("Accept", "application/json"); ЗаголовкиHTTP.Вставить("Content-Type", "application/json"); ЗаголовкиHTTP.Вставить("Authorization", "Bearer {authorizationToken}"); HTTPЗапрос = Новый HTTPЗапрос(АдресРесурса, ЗаголовкиHTTP); HTTPЗапрос.УстановитьТелоИзСтроки(ТекстЗапроса, КодировкаТекста.UTF8, ИспользованиеByteOrderMark.НеИспользовать); ЗащищенноеСоединениеSSL = Новый ЗащищенноеСоединениеOpenSSL(Новый СертификатКлиентаWindows, Новый СертификатыУдостоверяющихЦентровWindows);
Соединение = Новый HTTPСоединение(АдресХоста,,,,,, ЗащищенноеСоединениеSSL);
Попытка Ответ = Соединение.ВызватьHTTPМетод(МетодЗапроса, HTTPЗапрос); Сообщить("Код ответа: " + Ответ.КодСостояния); Сообщить("Ответ: " + Ответ.ПолучитьТелоКакСтроку("UTF-8")); Исключение Сообщить("Ошибка выполнения запроса!" + Символы.ПС + ОписаниеОшибки()); КонецПопытки;КонецПроцедуры
ВыполнитьHTTPЗапрос("POST", "https://api.ati.su", "/v1.2/orders/takeload/{loadId}", "{""rate_type"":0,""driver_id"":""3fa85f64-5717-4562-b3fc-2c963f66afa6"",""truck_info_id"":""3fa85f64-5717-4562-b3fc-2c963f66afa6"",""semitrailer_id"":""3fa85f64-5717-4562-b3fc-2c963f66afa6"",""trailer_id"":""3fa85f64-5717-4562-b3fc-2c963f66afa6"",""requisites_id"":""3fa85f64-5717-4562-b3fc-2c963f66afa6"",""signer_id"":""3fa85f64-5717-4562-b3fc-2c963f66afa6"",""is_drop_docs"":false,""deal_kind"":0,""taker_note"":""string""}");
200 Успешное взятие/редактирование
Копия груза
При создании заказа груз копируется, копия не отображается в поиске и её невозможно отредактировать
Id копии груза
Сгенерированный номер груза
Метаданные груза
Id
Данные
Id Торгов (аукциона)
Дата последнего изменения груза
Дата добавления груза
Дата помещения груза в архив
При взятии груза, он попадает в архив
Расстояние для груза
При расчете учитываются дополнительные пункты разгрузки
Маршрут построен с проездом по МКАД или без МКАД
0
— без МКАД1
— с МКАД
Расстояние по Платону
Расстояние по платным дорогам
Время в пути
Озвученная ставка
Id валюты озвученной ставки
Id груза
Груз не опубликован
ID фирмы, выставившей груз
Контакт #1, указанный в грузе
Контакт #2, указанный в грузе
Примечание к грузу
Дата, начиная с которой груз актуален
Дата, после которой груз не актуален
Готовность груза к перевозке
0
— Готов к отправке сегодня или завтра1
— Готов к отправке между FirstDate и LastDate2
— Готов к отправке постоянно3
— Груза нет, запрос ставки
Периодичность загрузки
0
— Нет1
— Ежедневно100
— Только по рабочим дням
Номер груза/заказа
Кругорейс
Зимники
Паромные переправы
Точка загрузки
Id точки по базе ФИАС
Id города
Значение из словаря городов ATI.SU
Широта
Долгота
Адрес
Id из справочника организаций
Id адреса в организации
Время "От"
Время "До"
Круглосуточно
Список Id ближайших крупных городов
Расстояния до ближайших крупных городов
Id города
Значение из словаря городов ATI.SU
Расстояние
Id груза
Наименование груза
Упаковка
Объем
Габариты
Длина в метрах
Ширина в метрах
Высота в метрах
Диаметр в метрах
Подсвечивать ли длину
Подсвечивать ли ширину
Подсвечивать ли высоту
Дополнительные точки
Id города
Значение из словаря городов ATI.SU
Тип дополнительной точки маршрута груза
1
— Загрузка2
— Разгрузка3
— Таможня4
— Ближайший крупный город к городу загрузки5
— Ближайший крупный город к городу разгрузки8
— Проехать через
Порядковый номер в маршруте
Расстояние
Адрес
Широта
Долгота
Id из справочника организаций
Id адреса в организации
Дата начала загрузки
Дата конца загрузки
Время начала загрузки
Время конца загрузки
Круглосуточно
Id груза
Наименование груза
Упаковка
Объем
Габариты
Длина в метрах
Ширина в метрах
Высота в метрах
Диаметр в метрах
Подсвечивать ли длину
Подсвечивать ли ширину
Подсвечивать ли высоту
Id груза
Вес
Объём
Выгружаемая часть упаковки
Выгружаемая часть груза будет определена в ТТН
Точка разгрузки
Id точки по базе ФИАС
Id города
Значение из словаря городов ATI.SU
Широта
Долгота
Адрес
Id из справочника организаций
Id адреса в организации
Время "От"
Время "До"
Круглосуточно
Список Id ближайших крупных городов
Расстояния до ближайших крупных городов
Id города
Значение из словаря городов ATI.SU
Расстояние
Id груза
Наименование груза
Упаковка
Объем
Габариты
Длина в метрах
Ширина в метрах
Высота в метрах
Диаметр в метрах
Подсвечивать ли длину
Подсвечивать ли ширину
Подсвечивать ли высоту
Параметры груза
Вес
Объем
Модификатор опасности груза с 0 до 9
Идентификатор наименования груза
Значение из словаря наименований грузов
Строковое наименование груза. Выводится если CargoTypeId не указан, либо равен 59
Тип упаковки(навалом, коробки, россыпью, запаллечен ... пирамида). Значение из словаря PackTypes
Количество паллетов
Количество ремней
Параметр, отвечающий за способ перевозки груза
1
— Только отдельной машиной2
— Догруз возможен3
— Догруз
Сборный груз
Размеры груза
Длина в метрах
Ширина в метрах
Высота в метрах
Диаметр в метрах
Подсвечивать ли длину
Подсвечивать ли ширину
Подсвечивать ли высоту
Параметры перевозки
Битовая сумма кузовов
Битовая сумма типов загрузки
Тип условия загрузки
OR
AND
Битовая сумма типов разгрузки
Тип условия разгрузки
OR
AND
Количество машин
Температура перевозки - нижнее значение
Температура перевозки - верхнее значение
Сцепка
Пневмоход
Коники
TIR
CMR
Т1
Мед книжка
Запрос отслеживания через АТИ Водитель
Требуемая грузоподъёмность в тоннах
Площадки, на которых опубликован груз
Id площадки
Имя площадки
Цвет площадки
Дата, начиная с которой можно разгрузить груз
Дата, до которой можно разгрузить груз
Заказ
Основная информация о заказе
Id Заказа
Id связанной копии груза
Id груза
Код фирмы, взявшей груз
Идентификатор пользователя, взявшего груз
Id контакта, взявшего груз
Код фирмы опубликовавшей груз
Идентификатор пользователя, опубликовавшего груз
Время изменения информации по Заказу
Время до которого груз зарезервирован
Id Торгов (аукциона)
Статус Заказа
0
— Груз зарезервирован перевозчиком1
— Перевозчик заполнил информацию о реквизитах/водителе/машине и грузовладелец не просмотрел заявку2
— Перевозчик заполнил информацию о реквизитах/водителе/машине и грузовладелец просмотрел заявку3
— Грузовладелец отправил документ-заявку перевозчику4
— Заказ в исполнении (перевозчик дал согласие на документ-заявку)5
— Заказ завершен и перенесен в архив7
— Есть только приглашение на Заказ8
— Заказа нет, но есть Торги, у которых есть возможные победители9
— Заказ отклонен автоматически, так как после последней даты загрузки прошло уже более 7 дней10
— Заказ завершен, ожидается оплата11
— В Торгах лучшая ставка из других Торгов-11
— Заказ удален-10
— Резерв груза перевозчиком отменен-9
— Заказ отклонен грузовладельцем в Торгах после истечения срока подачи документов (смена победителя)-8
— Грузовладелец отменил Заказ в исполнении-7
— Перевозчик отменил Заказ в исполнении-6
— Заказ отклонен грузовладельцем после удаления Торгов-4
— Заказ отклонен грузовладельцем в Торгах (смена победителя)-3
— Заказ отклонен грузовладельцем-2
— Заказ отозван перевозчиком
Статус Заказа у контрагента
0
— Груз зарезервирован перевозчиком1
— Перевозчик заполнил информацию о реквизитах/водителе/машине и грузовладелец не просмотрел заявку2
— Перевозчик заполнил информацию о реквизитах/водителе/машине и грузовладелец просмотрел заявку3
— Грузовладелец отправил документ-заявку перевозчику4
— Заказ в исполнении (перевозчик дал согласие на документ-заявку)5
— Заказ завершен и перенесен в архив7
— Есть только приглашение на Заказ8
— Заказа нет, но есть Торги, у которых есть возможные победители9
— Заказ отклонен автоматически, так как после последней даты загрузки прошло уже более 7 дней10
— Заказ завершен, ожидается оплата11
— В Торгах лучшая ставка из других Торгов-11
— Заказ удален-10
— Резерв груза перевозчиком отменен-9
— Заказ отклонен грузовладельцем в Торгах после истечения срока подачи документов (смена победителя)-8
— Грузовладелец отменил Заказ в исполнении-7
— Перевозчик отменил Заказ в исполнении-6
— Заказ отклонен грузовладельцем после удаления Торгов-4
— Заказ отклонен грузовладельцем в Торгах (смена победителя)-3
— Заказ отклонен грузовладельцем-2
— Заказ отозван перевозчиком
Параметры оплаты Заказа
Список возможных ставок перевозки
Сумма
Тип оплаты
0
— Нет1
— Любая2
— С НДС3
— Без НДС
Id валюты
Является ли ставка выбранной
Процент предоплаты
Есть ли предоплата
Оплата на выгрузке
Оплата топливом
Есть ли срок оплаты
Срок оплаты
Указана ли в грузе ставка
Возможен ли торг
Прямой договор
Способ оплаты
Информация об оплате заказа
Информация о копиях документов
Документ получен
Дата получения документов
Информация о оригиналах документов
Документ получен
Дата получения документов
Информация об отслеживании оригиналов документов
Id транспортной компании, осуществляющей доставку документов
Сссылка для отслеживания статуса отправления
Номер отправления
Дата отправки документов
Информация о оплате
Заказ оплачен
Дата оплаты
Файлы Заказа
Id файла
Id файла в хранилище
Доступ к файлу
0
— только загрузивший файл1
— обе стороны2
— загрузивший файл и водитель3
— доступен обеим сторонам и водителю
Время загрузки файла
Id связанного Заказа
Файл контрагента
Имя файла
Размер файла
Ссылка на файл
Источник файла
0
— Загружен в заказ1
— Скопирован из груза2
— Скопирован из данных о водителе3
— Скопироване из данных о грузовике4
— Скопирован из данных о прицепе5
— Скопирован из данных о полуприцепе6
— Скопирован из данных о тягаче7
— Загружен для Ати-водителя
Тип загруженного файла
0
— Обычный файл1
— Водительское удостоверение2
— Паспорт водителя3
— Техпаспорт ТС4
— Пластик5
— Фото ТС
Тип файла
0
— Другой документ1
— Товарно-транспортная накладная2
— Товарная накладная3
— Транспортная накладная4
— Накладная5
— Счет-фактура6
— Счет на оплату7
— Платежное поручение8
— Акт выполненных работ9
— Заявка10
— Заявка (к договору)11
— Заказ12
— Договор13
— Доп. соглашение (к договору)14
— Доверенность15
— Поручение экспедитору16
— Информационное письмо17
— Документ о происшествии с грузом/ТС
Список складов с Временными окнами с доступом к файлу
Информация о шаблонах документов в заказах
Адрес организации
Шаблоны документов
Время загрузки документа
Доступ к документу
0
— только загрузивший документ1
— обе стороны
Список складов с Временными окнами с доступом к документу
Id связанного Заказа
Id точки в заказе, к которой привязан документ
Id фирмы, загрузившей документ
Поле-хэш, рассчитывается на основе id грузов, выгружаемых в точке DealPointId. Если выгружаемые грузы не указаны - будет равно 0
Id контакта
Название документа
Id файла документа Можно скачать файл с помощью метода(https://ati.su/developers/api/filestorage/#get-v1.0-filestorage-files-%7bfile_id%7d-)
Id документа
Размер документа
Ссылка на документ (только для сайта)
Запрос отслеживания через АТИ Водитель
Показывать ли ставку водителю (для ОЗ)
Дата взятия/резервирования груза
Дата завершения заказа
Причина отклонения заказа
Присутствует когда Status -2
или -3
Id реквизитов
см. taker_requisites, в новой версии API это поле перестанет существовать
Реквизиты перевозчика
Id реквизитов
Более подробную информацию о реквизитах можно посмотреть здесь
Название компании
Id подписанта
Идентификатор формы собственности
Значение из словаря ОПФ АТИ
ИНН
КПП
Тип реквизитов
Id подписанта
см. taker_requisites, в новой версии API это поле перестанет существовать
Копия водителя
При взятии груза, водитель копируется, копию редактировать невозможно
Id копии водителя
Идентификатор водителя из Справочника Водителей
Имя водителя
Фамилия водителя
Отчество водителя
Номер телефона
Номер водительского удостоверения
Серия паспорта
Номер паспорта
Кем выдан
Когда выдан
Прописка
Флаг привлеченного водителя (со стороны)
Id связанной сущности по Заказу
Краткое описание водителя
Фирма от которой привлечен водитель.
Сканы паспорта / водительского удостоверения
ID
ID сущности, котрой принадлежит скан
Путь к файлу
Название
Тип документа
1
— Скан водительского удостоверения2
— Скан гражданского паспорта3
— Скан ПТС4
— Скан пластикового ПТС5
— Фото ТС8
— Договор о безвоздмездном пользовании
Идентификатор источника информации о водителе
0
— Неизвестно откуда указан водитель1
— Водитель указан на странице заказов у Заказа в исполнении2
— Водитель указан в АТИ-Доках
Дата рождения
Код подразделения
ИНН водителя
Есть в Черном списке
Причины добавления в Черный список
Копия транспортного средства
При взятии груза, транспортное средство копируется, копию редактировать невозможно
Id копии транспортного средства
Id транспортного средства из Автопарка
Id ТС, с которым было связано ТС во время выполнения последнего Заказа
Тип транспортного средства
1
— Грузовик2
— Тягач4
— Полуприцеп8
— Прицеп
Описание транспортного средства
Марка
Модель
Номер
Телефон
Привлеченное ТС
Тип владения ТС
0
- Собственное1
- Привлеченное2
- Аренда3
- Лизинг4
- Совместная собственность (супругов)5
- Безвозмездное пользование
Тип Кузова
Грузоподъемность
Объем
Длина
Ширина
Высота
Год выпуска
VIN
СТС
Номер кузова
Размерность контейнера
Номер ПТС
Способность возить реф-контейнеры
Есть GenSet
Имя владельца по СТС
Способность перевозить тяжелые контейнеры
Способность перевозить высокие контейнеры
Проверено
Запрещено редактирование и удаление ТС.
Сканы ПТС
ID
ID сущности, котрой принадлежит скан
Путь к файлу
Название
Тип документа
1
— Скан водительского удостоверения2
— Скан гражданского паспорта3
— Скан ПТС4
— Скан пластикового ПТС5
— Фото ТС8
— Договор о безвоздмездном пользовании
Источник создания Транспорта
0
— Неизвестно откуда указано ТС1
— ТС указано на странице заказов у Заказа в исполнении2
— ТС Указано в АТИ-доках
Копия прицепа
При взятии груза, прицеп копируется, копию редактировать невозможно
Id копии транспортного средства
Id транспортного средства из Автопарка
Id ТС, с которым было связано ТС во время выполнения последнего Заказа
Тип транспортного средства
1
— Грузовик2
— Тягач4
— Полуприцеп8
— Прицеп
Описание транспортного средства
Марка
Модель
Номер
Телефон
Привлеченное ТС
Тип владения ТС
0
- Собственное1
- Привлеченное2
- Аренда3
- Лизинг4
- Совместная собственность (супругов)5
- Безвозмездное пользование
Тип Кузова
Грузоподъемность
Объем
Длина
Ширина
Высота
Год выпуска
VIN
СТС
Номер кузова
Размерность контейнера
Номер ПТС
Способность возить реф-контейнеры
Есть GenSet
Имя владельца по СТС
Способность перевозить тяжелые контейнеры
Способность перевозить высокие контейнеры
Проверено
Запрещено редактирование и удаление ТС.
Сканы ПТС
ID
ID сущности, котрой принадлежит скан
Путь к файлу
Название
Тип документа
1
— Скан водительского удостоверения2
— Скан гражданского паспорта3
— Скан ПТС4
— Скан пластикового ПТС5
— Фото ТС8
— Договор о безвоздмездном пользовании
Источник создания Транспорта
0
— Неизвестно откуда указано ТС1
— ТС указано на странице заказов у Заказа в исполнении2
— ТС Указано в АТИ-доках
Копия полуприцепа
При взятии груза, полуприцеп копируется, копию редактировать невозможно
Id копии транспортного средства
Id транспортного средства из Автопарка
Id ТС, с которым было связано ТС во время выполнения последнего Заказа
Тип транспортного средства
1
— Грузовик2
— Тягач4
— Полуприцеп8
— Прицеп
Описание транспортного средства
Марка
Модель
Номер
Телефон
Привлеченное ТС
Тип владения ТС
0
- Собственное1
- Привлеченное2
- Аренда3
- Лизинг4
- Совместная собственность (супругов)5
- Безвозмездное пользование
Тип Кузова
Грузоподъемность
Объем
Длина
Ширина
Высота
Год выпуска
VIN
СТС
Номер кузова
Размерность контейнера
Номер ПТС
Способность возить реф-контейнеры
Есть GenSet
Имя владельца по СТС
Способность перевозить тяжелые контейнеры
Способность перевозить высокие контейнеры
Проверено
Запрещено редактирование и удаление ТС.
Сканы ПТС
ID
ID сущности, котрой принадлежит скан
Путь к файлу
Название
Тип документа
1
— Скан водительского удостоверения2
— Скан гражданского паспорта3
— Скан ПТС4
— Скан пластикового ПТС5
— Фото ТС8
— Договор о безвоздмездном пользовании
Источник создания Транспорта
0
— Неизвестно откуда указано ТС1
— ТС указано на странице заказов у Заказа в исполнении2
— ТС Указано в АТИ-доках
Основной документ в АТИ-Доках
ID документа
ID старого документа
Фирма, отредактировавшая документ
Адрес просмотра договора
Адрес просмотра старого договора
Имя документа
Документ подписан перевозчиком
Доступ к документу
0
— Обе стороны1
— Водитель
Дополнительные документы
Id документа
Файл контрагента
Адрес документа
Имя документа
Документ подписан перевозчиком
Тип документа
0
— Нет1
— Заказ2
— Договор-заявка3
— Поручение экспедитору4
— Акт5
— Счет6
— Одностороннее расторжение7
— Доверенность8
— Табличный заказ9
— Заявка к договору (табличный вид)
Доступ к документу
0
— Обе стороны1
— Водитель
Статусная модель перевозки
0
— Простая перевозка1
— Первая миля2
— Последняя миля3
— Порожний контейнер
Статус перевозки заказа
Id Заказа
Статус перевозки
0
— Нет статуса1
— Едет на загрузку2
— Ожидает загрузку3
— Загружается4
— Загрузился, едет на выгрузку5
— Ожидает выгрузку6
— Выгружается7
— Выгрузился8
— Поломка9
— ДТП10
— Арест ТС11
— Контейнер получен на погрузку12
— Контейнер на погрузке13
— Погрузка контейнера окончена14
— Контейнер сдан с погрузки15
— Контейнер получен на выгрузку16
— Контейнер на выгрузке17
— Выгрузка контейнера окончена18
— Контейнер сдан с выгрузки19
— Пустой контейнер получен20
— Пустой контейнер сдан100
— Заказ завершён
Дата выставления статуса
Фирма, выставившая статус (перевозчик или грузовладелец)
Контакт, выставивший статус
Номер телефона трекера, откуда получен статус
Предлагаемые правки к документу
Тип Заказа
0
— Заказ невозможен1
— Взятие груза из поиска2
— Заказ из Торгов4
— Предложение груза8
— Из перехвата машин16
— Односторонний заказ32
— Предложение груза из встречного предложения64
— Предложение груза по контракту
Точки маршрута
Id точки заказа
Порядковый номер
Тип точки маршрута
1
— Загрузка2
— Разгрузка
Id города
Значение из словаря городов ATI.SU
Широта
Долгота
Адрес
Название организации
Id региона Значение из словаря регионов ATI.SU
4XX Ошибка запроса. [Подробнее про ошибки API](https://ati.su/developers/documentation/errors/)
Модель ошибки
Причина ошибки
Ключ ошибки
Приглашение взять груз
Существует еще один способ получить предложение на перевозку - персональное приглашение от грузовладельца на сделку. Как это работает:
При публикации груза с фиксированной ставкой у грузовладельца есть возможность отправить персональное предложение различным перевозчикам. Чтобы получить список поступивших вам персональных предложений, воспользуйтесь методом:
Получение списка приглашений get /v1.2/orders/invites/my
curl 'https://api.ati.su/v1.2/orders/invites/my' \ -X 'GET' \ -H 'Authorization: Bearer {authorizationToken}' \ -H 'Content-Type: application/json'
Процедура ВыполнитьHTTPЗапрос(МетодЗапроса, АдресХоста, АдресРесурса, ТекстЗапроса) Экспорт ЗаголовкиHTTP = Новый Соответствие(); ЗаголовкиHTTP.Вставить("Accept", "application/json"); ЗаголовкиHTTP.Вставить("Content-Type", "application/json"); ЗаголовкиHTTP.Вставить("Authorization", "Bearer {authorizationToken}"); HTTPЗапрос = Новый HTTPЗапрос(АдресРесурса, ЗаголовкиHTTP); HTTPЗапрос.УстановитьТелоИзСтроки(ТекстЗапроса, КодировкаТекста.UTF8, ИспользованиеByteOrderMark.НеИспользовать); ЗащищенноеСоединениеSSL = Новый ЗащищенноеСоединениеOpenSSL(Новый СертификатКлиентаWindows, Новый СертификатыУдостоверяющихЦентровWindows);
Соединение = Новый HTTPСоединение(АдресХоста,,,,,, ЗащищенноеСоединениеSSL);
Попытка Ответ = Соединение.ВызватьHTTPМетод(МетодЗапроса, HTTPЗапрос); Сообщить("Код ответа: " + Ответ.КодСостояния); Сообщить("Ответ: " + Ответ.ПолучитьТелоКакСтроку("UTF-8")); Исключение Сообщить("Ошибка выполнения запроса!" + Символы.ПС + ОписаниеОшибки()); КонецПопытки;КонецПроцедуры
ВыполнитьHTTPЗапрос("GET", "https://api.ati.su", "/v1.2/orders/invites/my");
200 Список приглашений на перевозку груза
Id фирмы грузовладельца
Постоянный Id фирмы грузовладельца
Id контакта, который отправил приглашение
Id приглашенной фирмы
Постоянный Id приглашенной фирмы
Id контакта приглашенной фирмы
Список контактов приглашенной фирмы
Время отправки приглашения
Время отмены приглашения
Предложенные параметры оплаты
Список возможных ставок перевозки
Сумма
Тип оплаты
0
— Нет1
— Любая2
— С НДС3
— Без НДС
Id валюты
Значение из словаря валют АТИ
Процент предоплаты
Есть ли предоплата
Оплата на выгрузке
Оплата топливом
Есть ли срок оплаты
Срок оплаты
Указана ли в грузе ставка
Возможен ли торг
Прямой договор
Способ оплаты
Источник параметров оплаты
0
— Нет1
— Встречное предложение2
— Торги3
— Груз4
— Предложение груза5
— Предложение по контракту
Параметры предложенного груза
ID груза
Сгенерированный номер груза
Расстояние для груза
При расчете учитываются дополнительные пункты разгрузки
Маршрут построен с проездом по МКАД или без МКАД
0
— без МКАД1
— с МКАД
Расстояние по Платону
Расстояние по платным дорогам
Время в пути
Озвученная ставка
ID валюты озвученной ставки
Примечание к грузу
Дата, начиная с которой груз актуален
Дата, после которой груз не актуален
Готовность груза к перевозке
0
— Готов к отправке сегодня или завтра1
— Готов к отправке между FirstDate и LastDate2
— Готов к отправке постоянно3
— Груза нет, запрос ставки
Периодичность загрузки
0
— Нет1
— Ежедневно100
— Только по рабочим дням
Номер груза/заказа
Кругорейс
Зимники
Паромные переправы
Точка загрузки
Id точки по базе ФИАС
Id города
Значение из словаря городов ATI.SU
Широта
Долгота
Адрес
Id из справочника организаций
Id адреса в организации
Время "От"
Время "До"
Круглосуточно
Список Id ближайших крупных городов
Расстояния до ближайших крупных городов
Id города
Значение из словаря городов ATI.SU
Расстояние
Id груза
Наименование груза
Упаковка
Объем
Габариты
Длина в метрах
Ширина в метрах
Высота в метрах
Диаметр в метрах
Подсвечивать ли длину
Подсвечивать ли ширину
Подсвечивать ли высоту
Дополнительные точки
Id города
Значение из словаря городов ATI.SU
Тип дополнительной точки маршрута груза
1
— Загрузка2
— Разгрузка3
— Таможня4
— Ближайший крупный город к городу загрузки5
— Ближайший крупный город к городу разгрузки8
— Проехать через
Порядковый номер в маршруте
Расстояние
Адрес
Широта
Долгота
Id из справочника организаций
Id адреса в организации
Дата начала загрузки
Дата конца загрузки
Время начала загрузки
Время конца загрузки
Круглосуточно
Id груза
Наименование груза
Упаковка
Объем
Габариты
Длина в метрах
Ширина в метрах
Высота в метрах
Диаметр в метрах
Подсвечивать ли длину
Подсвечивать ли ширину
Подсвечивать ли высоту
Id груза
Вес
Объём
Выгружаемая часть упаковки
Выгружаемая часть груза будет определена в ТТН
Точка разгрузки
Id точки по базе ФИАС
Id города
Значение из словаря городов ATI.SU
Широта
Долгота
Адрес
Id из справочника организаций
Id адреса в организации
Время "От"
Время "До"
Круглосуточно
Список Id ближайших крупных городов
Расстояния до ближайших крупных городов
Id города
Значение из словаря городов ATI.SU
Расстояние
Id груза
Наименование груза
Упаковка
Объем
Габариты
Длина в метрах
Ширина в метрах
Высота в метрах
Диаметр в метрах
Подсвечивать ли длину
Подсвечивать ли ширину
Подсвечивать ли высоту
Параметры груза
Вес
Объем
Модификатор опасности груза с 0 до 9
Идентификатор наименования груза
Значение из словаря наименований грузов
Строковое наименование груза. Выводится если CargoTypeId не указан, либо равен 59
Тип упаковки(навалом, коробки, россыпью, запаллечен ... пирамида). Значение из словаря PackTypes
Количество паллетов
Количество ремней
Параметр, отвечающий за способ перевозки груза
1
— Только отдельной машиной2
— Догруз возможен3
— Догруз
Сборный груз
Размеры груза
Длина в метрах
Ширина в метрах
Высота в метрах
Диаметр в метрах
Подсвечивать ли длину
Подсвечивать ли ширину
Подсвечивать ли высоту
Параметры перевозки
Битовая сумма кузовов
Битовая сумма типов загрузки
Тип условия загрузки
OR
AND
Битовая сумма типов разгрузки
Тип условия разгрузки
OR
AND
Количество машин
Температура перевозки - нижнее значение
Температура перевозки - верхнее значение
Сцепка
Пневмоход
Коники
TIR
CMR
Т1
Мед книжка
Запрос отслеживания через АТИ Водитель
Требуемая грузоподъёмность в тоннах
Дата, начиная с которой можно разгрузить груз
Дата, до которой можно разгрузить груз
Запрос отслеживания через АТИ Водитель
Тип Заказа
0
— Заказ невозможен1
— Взятие груза из поиска2
— Заказ из Торгов4
— Предложение груза8
— Из перехвата машин16
— Односторонний заказ32
— Предложение груза из встречного предложения64
— Предложение груза по контракту
4XX Ошибка запроса. [Подробнее про ошибки API](https://ati.su/developers/documentation/errors/)
Модель ошибки
Причина ошибки
Ключ ошибки
У вас будет возможность взять груз по указанной ставке или отказаться от предложения, если условия вас не устроят.
Взятие груза / Редактирование Заказа post /v1.2/orders/takeload/{loadId}
Параметры Заказа
Тип оплаты
0
— Нет1
— Любая2
— С НДС3
— Без НДС
Id водителя
Id транспортного средства
Id полуприцепа
Может быть указан только если транспортное средство — тягач
Id прицепа
Может быть указан только если указан полуприцеп или транспортное средство — грузовик
Id реквизитов
Id подписанта
Отзывать ли привязанные документы
Используется при редактировании
Тип Заказа
0
— Заказ невозможен1
— Взятие груза из поиска2
— Заказ из Торгов4
— Предложение груза8
— Из перехвата машин16
— Односторонний заказ32
— Предложение груза из встречного предложения64
— Предложение груза по контракту
Комментарий перевозчика
curl 'https://api.ati.su/v1.2/orders/takeload/{loadId}' \ -X 'POST' \ -H 'Authorization: Bearer {authorizationToken}' \ -H 'Content-Type: application/json' \ --data-raw '{"rate_type":0,"driver_id":"3fa85f64-5717-4562-b3fc-2c963f66afa6","truck_info_id":"3fa85f64-5717-4562-b3fc-2c963f66afa6","semitrailer_id":"3fa85f64-5717-4562-b3fc-2c963f66afa6","trailer_id":"3fa85f64-5717-4562-b3fc-2c963f66afa6","requisites_id":"3fa85f64-5717-4562-b3fc-2c963f66afa6","signer_id":"3fa85f64-5717-4562-b3fc-2c963f66afa6","is_drop_docs":false,"deal_kind":0,"taker_note":"string"}'
Процедура ВыполнитьHTTPЗапрос(МетодЗапроса, АдресХоста, АдресРесурса, ТекстЗапроса) Экспорт ЗаголовкиHTTP = Новый Соответствие(); ЗаголовкиHTTP.Вставить("Accept", "application/json"); ЗаголовкиHTTP.Вставить("Content-Type", "application/json"); ЗаголовкиHTTP.Вставить("Authorization", "Bearer {authorizationToken}"); HTTPЗапрос = Новый HTTPЗапрос(АдресРесурса, ЗаголовкиHTTP); HTTPЗапрос.УстановитьТелоИзСтроки(ТекстЗапроса, КодировкаТекста.UTF8, ИспользованиеByteOrderMark.НеИспользовать); ЗащищенноеСоединениеSSL = Новый ЗащищенноеСоединениеOpenSSL(Новый СертификатКлиентаWindows, Новый СертификатыУдостоверяющихЦентровWindows);
Соединение = Новый HTTPСоединение(АдресХоста,,,,,, ЗащищенноеСоединениеSSL);
Попытка Ответ = Соединение.ВызватьHTTPМетод(МетодЗапроса, HTTPЗапрос); Сообщить("Код ответа: " + Ответ.КодСостояния); Сообщить("Ответ: " + Ответ.ПолучитьТелоКакСтроку("UTF-8")); Исключение Сообщить("Ошибка выполнения запроса!" + Символы.ПС + ОписаниеОшибки()); КонецПопытки;КонецПроцедуры
ВыполнитьHTTPЗапрос("POST", "https://api.ati.su", "/v1.2/orders/takeload/{loadId}", "{""rate_type"":0,""driver_id"":""3fa85f64-5717-4562-b3fc-2c963f66afa6"",""truck_info_id"":""3fa85f64-5717-4562-b3fc-2c963f66afa6"",""semitrailer_id"":""3fa85f64-5717-4562-b3fc-2c963f66afa6"",""trailer_id"":""3fa85f64-5717-4562-b3fc-2c963f66afa6"",""requisites_id"":""3fa85f64-5717-4562-b3fc-2c963f66afa6"",""signer_id"":""3fa85f64-5717-4562-b3fc-2c963f66afa6"",""is_drop_docs"":false,""deal_kind"":0,""taker_note"":""string""}");
200 Успешное взятие/редактирование
Копия груза
При создании заказа груз копируется, копия не отображается в поиске и её невозможно отредактировать
Id копии груза
Сгенерированный номер груза
Метаданные груза
Id
Данные
Id Торгов (аукциона)
Дата последнего изменения груза
Дата добавления груза
Дата помещения груза в архив
При взятии груза, он попадает в архив
Расстояние для груза
При расчете учитываются дополнительные пункты разгрузки
Маршрут построен с проездом по МКАД или без МКАД
0
— без МКАД1
— с МКАД
Расстояние по Платону
Расстояние по платным дорогам
Время в пути
Озвученная ставка
Id валюты озвученной ставки
Id груза
Груз не опубликован
ID фирмы, выставившей груз
Контакт #1, указанный в грузе
Контакт #2, указанный в грузе
Примечание к грузу
Дата, начиная с которой груз актуален
Дата, после которой груз не актуален
Готовность груза к перевозке
0
— Готов к отправке сегодня или завтра1
— Готов к отправке между FirstDate и LastDate2
— Готов к отправке постоянно3
— Груза нет, запрос ставки
Периодичность загрузки
0
— Нет1
— Ежедневно100
— Только по рабочим дням
Номер груза/заказа
Кругорейс
Зимники
Паромные переправы
Точка загрузки
Id точки по базе ФИАС
Id города
Значение из словаря городов ATI.SU
Широта
Долгота
Адрес
Id из справочника организаций
Id адреса в организации
Время "От"
Время "До"
Круглосуточно
Список Id ближайших крупных городов
Расстояния до ближайших крупных городов
Id города
Значение из словаря городов ATI.SU
Расстояние
Id груза
Наименование груза
Упаковка
Объем
Габариты
Длина в метрах
Ширина в метрах
Высота в метрах
Диаметр в метрах
Подсвечивать ли длину
Подсвечивать ли ширину
Подсвечивать ли высоту
Дополнительные точки
Id города
Значение из словаря городов ATI.SU
Тип дополнительной точки маршрута груза
1
— Загрузка2
— Разгрузка3
— Таможня4
— Ближайший крупный город к городу загрузки5
— Ближайший крупный город к городу разгрузки8
— Проехать через
Порядковый номер в маршруте
Расстояние
Адрес
Широта
Долгота
Id из справочника организаций
Id адреса в организации
Дата начала загрузки
Дата конца загрузки
Время начала загрузки
Время конца загрузки
Круглосуточно
Id груза
Наименование груза
Упаковка
Объем
Габариты
Длина в метрах
Ширина в метрах
Высота в метрах
Диаметр в метрах
Подсвечивать ли длину
Подсвечивать ли ширину
Подсвечивать ли высоту
Id груза
Вес
Объём
Выгружаемая часть упаковки
Выгружаемая часть груза будет определена в ТТН
Точка разгрузки
Id точки по базе ФИАС
Id города
Значение из словаря городов ATI.SU
Широта
Долгота
Адрес
Id из справочника организаций
Id адреса в организации
Время "От"
Время "До"
Круглосуточно
Список Id ближайших крупных городов
Расстояния до ближайших крупных городов
Id города
Значение из словаря городов ATI.SU
Расстояние
Id груза
Наименование груза
Упаковка
Объем
Габариты
Длина в метрах
Ширина в метрах
Высота в метрах
Диаметр в метрах
Подсвечивать ли длину
Подсвечивать ли ширину
Подсвечивать ли высоту
Параметры груза
Вес
Объем
Модификатор опасности груза с 0 до 9
Идентификатор наименования груза
Значение из словаря наименований грузов
Строковое наименование груза. Выводится если CargoTypeId не указан, либо равен 59
Тип упаковки(навалом, коробки, россыпью, запаллечен ... пирамида). Значение из словаря PackTypes
Количество паллетов
Количество ремней
Параметр, отвечающий за способ перевозки груза
1
— Только отдельной машиной2
— Догруз возможен3
— Догруз
Сборный груз
Размеры груза
Длина в метрах
Ширина в метрах
Высота в метрах
Диаметр в метрах
Подсвечивать ли длину
Подсвечивать ли ширину
Подсвечивать ли высоту
Параметры перевозки
Битовая сумма кузовов
Битовая сумма типов загрузки
Тип условия загрузки
OR
AND
Битовая сумма типов разгрузки
Тип условия разгрузки
OR
AND
Количество машин
Температура перевозки - нижнее значение
Температура перевозки - верхнее значение
Сцепка
Пневмоход
Коники
TIR
CMR
Т1
Мед книжка
Запрос отслеживания через АТИ Водитель
Требуемая грузоподъёмность в тоннах
Площадки, на которых опубликован груз
Id площадки
Имя площадки
Цвет площадки
Дата, начиная с которой можно разгрузить груз
Дата, до которой можно разгрузить груз
Заказ
Основная информация о заказе
Id Заказа
Id связанной копии груза
Id груза
Код фирмы, взявшей груз
Идентификатор пользователя, взявшего груз
Id контакта, взявшего груз
Код фирмы опубликовавшей груз
Идентификатор пользователя, опубликовавшего груз
Время изменения информации по Заказу
Время до которого груз зарезервирован
Id Торгов (аукциона)
Статус Заказа
0
— Груз зарезервирован перевозчиком1
— Перевозчик заполнил информацию о реквизитах/водителе/машине и грузовладелец не просмотрел заявку2
— Перевозчик заполнил информацию о реквизитах/водителе/машине и грузовладелец просмотрел заявку3
— Грузовладелец отправил документ-заявку перевозчику4
— Заказ в исполнении (перевозчик дал согласие на документ-заявку)5
— Заказ завершен и перенесен в архив7
— Есть только приглашение на Заказ8
— Заказа нет, но есть Торги, у которых есть возможные победители9
— Заказ отклонен автоматически, так как после последней даты загрузки прошло уже более 7 дней10
— Заказ завершен, ожидается оплата11
— В Торгах лучшая ставка из других Торгов-11
— Заказ удален-10
— Резерв груза перевозчиком отменен-9
— Заказ отклонен грузовладельцем в Торгах после истечения срока подачи документов (смена победителя)-8
— Грузовладелец отменил Заказ в исполнении-7
— Перевозчик отменил Заказ в исполнении-6
— Заказ отклонен грузовладельцем после удаления Торгов-4
— Заказ отклонен грузовладельцем в Торгах (смена победителя)-3
— Заказ отклонен грузовладельцем-2
— Заказ отозван перевозчиком
Статус Заказа у контрагента
0
— Груз зарезервирован перевозчиком1
— Перевозчик заполнил информацию о реквизитах/водителе/машине и грузовладелец не просмотрел заявку2
— Перевозчик заполнил информацию о реквизитах/водителе/машине и грузовладелец просмотрел заявку3
— Грузовладелец отправил документ-заявку перевозчику4
— Заказ в исполнении (перевозчик дал согласие на документ-заявку)5
— Заказ завершен и перенесен в архив7
— Есть только приглашение на Заказ8
— Заказа нет, но есть Торги, у которых есть возможные победители9
— Заказ отклонен автоматически, так как после последней даты загрузки прошло уже более 7 дней10
— Заказ завершен, ожидается оплата11
— В Торгах лучшая ставка из других Торгов-11
— Заказ удален-10
— Резерв груза перевозчиком отменен-9
— Заказ отклонен грузовладельцем в Торгах после истечения срока подачи документов (смена победителя)-8
— Грузовладелец отменил Заказ в исполнении-7
— Перевозчик отменил Заказ в исполнении-6
— Заказ отклонен грузовладельцем после удаления Торгов-4
— Заказ отклонен грузовладельцем в Торгах (смена победителя)-3
— Заказ отклонен грузовладельцем-2
— Заказ отозван перевозчиком
Параметры оплаты Заказа
Список возможных ставок перевозки
Сумма
Тип оплаты
0
— Нет1
— Любая2
— С НДС3
— Без НДС
Id валюты
Является ли ставка выбранной
Процент предоплаты
Есть ли предоплата
Оплата на выгрузке
Оплата топливом
Есть ли срок оплаты
Срок оплаты
Указана ли в грузе ставка
Возможен ли торг
Прямой договор
Способ оплаты
Информация об оплате заказа
Информация о копиях документов
Документ получен
Дата получения документов
Информация о оригиналах документов
Документ получен
Дата получения документов
Информация об отслеживании оригиналов документов
Id транспортной компании, осуществляющей доставку документов
Сссылка для отслеживания статуса отправления
Номер отправления
Дата отправки документов
Информация о оплате
Заказ оплачен
Дата оплаты
Файлы Заказа
Id файла
Id файла в хранилище
Доступ к файлу
0
— только загрузивший файл1
— обе стороны2
— загрузивший файл и водитель3
— доступен обеим сторонам и водителю
Время загрузки файла
Id связанного Заказа
Файл контрагента
Имя файла
Размер файла
Ссылка на файл
Источник файла
0
— Загружен в заказ1
— Скопирован из груза2
— Скопирован из данных о водителе3
— Скопироване из данных о грузовике4
— Скопирован из данных о прицепе5
— Скопирован из данных о полуприцепе6
— Скопирован из данных о тягаче7
— Загружен для Ати-водителя
Тип загруженного файла
0
— Обычный файл1
— Водительское удостоверение2
— Паспорт водителя3
— Техпаспорт ТС4
— Пластик5
— Фото ТС
Тип файла
0
— Другой документ1
— Товарно-транспортная накладная2
— Товарная накладная3
— Транспортная накладная4
— Накладная5
— Счет-фактура6
— Счет на оплату7
— Платежное поручение8
— Акт выполненных работ9
— Заявка10
— Заявка (к договору)11
— Заказ12
— Договор13
— Доп. соглашение (к договору)14
— Доверенность15
— Поручение экспедитору16
— Информационное письмо17
— Документ о происшествии с грузом/ТС
Список складов с Временными окнами с доступом к файлу
Информация о шаблонах документов в заказах
Адрес организации
Шаблоны документов
Время загрузки документа
Доступ к документу
0
— только загрузивший документ1
— обе стороны
Список складов с Временными окнами с доступом к документу
Id связанного Заказа
Id точки в заказе, к которой привязан документ
Id фирмы, загрузившей документ
Поле-хэш, рассчитывается на основе id грузов, выгружаемых в точке DealPointId. Если выгружаемые грузы не указаны - будет равно 0
Id контакта
Название документа
Id файла документа Можно скачать файл с помощью метода(https://ati.su/developers/api/filestorage/#get-v1.0-filestorage-files-%7bfile_id%7d-)
Id документа
Размер документа
Ссылка на документ (только для сайта)
Запрос отслеживания через АТИ Водитель
Показывать ли ставку водителю (для ОЗ)
Дата взятия/резервирования груза
Дата завершения заказа
Причина отклонения заказа
Присутствует когда Status -2
или -3
Id реквизитов
см. taker_requisites, в новой версии API это поле перестанет существовать
Реквизиты перевозчика
Id реквизитов
Более подробную информацию о реквизитах можно посмотреть здесь
Название компании
Id подписанта
Идентификатор формы собственности
Значение из словаря ОПФ АТИ
ИНН
КПП
Тип реквизитов
Id подписанта
см. taker_requisites, в новой версии API это поле перестанет существовать
Копия водителя
При взятии груза, водитель копируется, копию редактировать невозможно
Id копии водителя
Идентификатор водителя из Справочника Водителей
Имя водителя
Фамилия водителя
Отчество водителя
Номер телефона
Номер водительского удостоверения
Серия паспорта
Номер паспорта
Кем выдан
Когда выдан
Прописка
Флаг привлеченного водителя (со стороны)
Id связанной сущности по Заказу
Краткое описание водителя
Фирма от которой привлечен водитель.
Сканы паспорта / водительского удостоверения
ID
ID сущности, котрой принадлежит скан
Путь к файлу
Название
Тип документа
1
— Скан водительского удостоверения2
— Скан гражданского паспорта3
— Скан ПТС4
— Скан пластикового ПТС5
— Фото ТС8
— Договор о безвоздмездном пользовании
Идентификатор источника информации о водителе
0
— Неизвестно откуда указан водитель1
— Водитель указан на странице заказов у Заказа в исполнении2
— Водитель указан в АТИ-Доках
Дата рождения
Код подразделения
ИНН водителя
Есть в Черном списке
Причины добавления в Черный список
Копия транспортного средства
При взятии груза, транспортное средство копируется, копию редактировать невозможно
Id копии транспортного средства
Id транспортного средства из Автопарка
Id ТС, с которым было связано ТС во время выполнения последнего Заказа
Тип транспортного средства
1
— Грузовик2
— Тягач4
— Полуприцеп8
— Прицеп
Описание транспортного средства
Марка
Модель
Номер
Телефон
Привлеченное ТС
Тип владения ТС
0
- Собственное1
- Привлеченное2
- Аренда3
- Лизинг4
- Совместная собственность (супругов)5
- Безвозмездное пользование
Тип Кузова
Грузоподъемность
Объем
Длина
Ширина
Высота
Год выпуска
VIN
СТС
Номер кузова
Размерность контейнера
Номер ПТС
Способность возить реф-контейнеры
Есть GenSet
Имя владельца по СТС
Способность перевозить тяжелые контейнеры
Способность перевозить высокие контейнеры
Проверено
Запрещено редактирование и удаление ТС.
Сканы ПТС
ID
ID сущности, котрой принадлежит скан
Путь к файлу
Название
Тип документа
1
— Скан водительского удостоверения2
— Скан гражданского паспорта3
— Скан ПТС4
— Скан пластикового ПТС5
— Фото ТС8
— Договор о безвоздмездном пользовании
Источник создания Транспорта
0
— Неизвестно откуда указано ТС1
— ТС указано на странице заказов у Заказа в исполнении2
— ТС Указано в АТИ-доках
Копия прицепа
При взятии груза, прицеп копируется, копию редактировать невозможно
Id копии транспортного средства
Id транспортного средства из Автопарка
Id ТС, с которым было связано ТС во время выполнения последнего Заказа
Тип транспортного средства
1
— Грузовик2
— Тягач4
— Полуприцеп8
— Прицеп
Описание транспортного средства
Марка
Модель
Номер
Телефон
Привлеченное ТС
Тип владения ТС
0
- Собственное1
- Привлеченное2
- Аренда3
- Лизинг4
- Совместная собственность (супругов)5
- Безвозмездное пользование
Тип Кузова
Грузоподъемность
Объем
Длина
Ширина
Высота
Год выпуска
VIN
СТС
Номер кузова
Размерность контейнера
Номер ПТС
Способность возить реф-контейнеры
Есть GenSet
Имя владельца по СТС
Способность перевозить тяжелые контейнеры
Способность перевозить высокие контейнеры
Проверено
Запрещено редактирование и удаление ТС.
Сканы ПТС
ID
ID сущности, котрой принадлежит скан
Путь к файлу
Название
Тип документа
1
— Скан водительского удостоверения2
— Скан гражданского паспорта3
— Скан ПТС4
— Скан пластикового ПТС5
— Фото ТС8
— Договор о безвоздмездном пользовании
Источник создания Транспорта
0
— Неизвестно откуда указано ТС1
— ТС указано на странице заказов у Заказа в исполнении2
— ТС Указано в АТИ-доках
Копия полуприцепа
При взятии груза, полуприцеп копируется, копию редактировать невозможно
Id копии транспортного средства
Id транспортного средства из Автопарка
Id ТС, с которым было связано ТС во время выполнения последнего Заказа
Тип транспортного средства
1
— Грузовик2
— Тягач4
— Полуприцеп8
— Прицеп
Описание транспортного средства
Марка
Модель
Номер
Телефон
Привлеченное ТС
Тип владения ТС
0
- Собственное1
- Привлеченное2
- Аренда3
- Лизинг4
- Совместная собственность (супругов)5
- Безвозмездное пользование
Тип Кузова
Грузоподъемность
Объем
Длина
Ширина
Высота
Год выпуска
VIN
СТС
Номер кузова
Размерность контейнера
Номер ПТС
Способность возить реф-контейнеры
Есть GenSet
Имя владельца по СТС
Способность перевозить тяжелые контейнеры
Способность перевозить высокие контейнеры
Проверено
Запрещено редактирование и удаление ТС.
Сканы ПТС
ID
ID сущности, котрой принадлежит скан
Путь к файлу
Название
Тип документа
1
— Скан водительского удостоверения2
— Скан гражданского паспорта3
— Скан ПТС4
— Скан пластикового ПТС5
— Фото ТС8
— Договор о безвоздмездном пользовании
Источник создания Транспорта
0
— Неизвестно откуда указано ТС1
— ТС указано на странице заказов у Заказа в исполнении2
— ТС Указано в АТИ-доках
Основной документ в АТИ-Доках
ID документа
ID старого документа
Фирма, отредактировавшая документ
Адрес просмотра договора
Адрес просмотра старого договора
Имя документа
Документ подписан перевозчиком
Доступ к документу
0
— Обе стороны1
— Водитель
Дополнительные документы
Id документа
Файл контрагента
Адрес документа
Имя документа
Документ подписан перевозчиком
Тип документа
0
— Нет1
— Заказ2
— Договор-заявка3
— Поручение экспедитору4
— Акт5
— Счет6
— Одностороннее расторжение7
— Доверенность8
— Табличный заказ9
— Заявка к договору (табличный вид)
Доступ к документу
0
— Обе стороны1
— Водитель
Статусная модель перевозки
0
— Простая перевозка1
— Первая миля2
— Последняя миля3
— Порожний контейнер
Статус перевозки заказа
Id Заказа
Статус перевозки
0
— Нет статуса1
— Едет на загрузку2
— Ожидает загрузку3
— Загружается4
— Загрузился, едет на выгрузку5
— Ожидает выгрузку6
— Выгружается7
— Выгрузился8
— Поломка9
— ДТП10
— Арест ТС11
— Контейнер получен на погрузку12
— Контейнер на погрузке13
— Погрузка контейнера окончена14
— Контейнер сдан с погрузки15
— Контейнер получен на выгрузку16
— Контейнер на выгрузке17
— Выгрузка контейнера окончена18
— Контейнер сдан с выгрузки19
— Пустой контейнер получен20
— Пустой контейнер сдан100
— Заказ завершён
Дата выставления статуса
Фирма, выставившая статус (перевозчик или грузовладелец)
Контакт, выставивший статус
Номер телефона трекера, откуда получен статус
Предлагаемые правки к документу
Тип Заказа
0
— Заказ невозможен1
— Взятие груза из поиска2
— Заказ из Торгов4
— Предложение груза8
— Из перехвата машин16
— Односторонний заказ32
— Предложение груза из встречного предложения64
— Предложение груза по контракту
Точки маршрута
Id точки заказа
Порядковый номер
Тип точки маршрута
1
— Загрузка2
— Разгрузка
Id города
Значение из словаря городов ATI.SU
Широта
Долгота
Адрес
Название организации
Id региона Значение из словаря регионов ATI.SU
4XX Ошибка запроса. [Подробнее про ошибки API](https://ati.su/developers/documentation/errors/)
Модель ошибки
Причина ошибки
Ключ ошибки
Отказ от приглашения delete /v1.2/orders/invites/{loadId}/{contactId}
curl 'https://api.ati.su/v1.2/orders/invites/{loadId}/{contactId}' \ -X 'DELETE' \ -H 'Authorization: Bearer {authorizationToken}' \ -H 'Content-Type: application/json'
Процедура ВыполнитьHTTPЗапрос(МетодЗапроса, АдресХоста, АдресРесурса, ТекстЗапроса) Экспорт ЗаголовкиHTTP = Новый Соответствие(); ЗаголовкиHTTP.Вставить("Accept", "application/json"); ЗаголовкиHTTP.Вставить("Content-Type", "application/json"); ЗаголовкиHTTP.Вставить("Authorization", "Bearer {authorizationToken}"); HTTPЗапрос = Новый HTTPЗапрос(АдресРесурса, ЗаголовкиHTTP); HTTPЗапрос.УстановитьТелоИзСтроки(ТекстЗапроса, КодировкаТекста.UTF8, ИспользованиеByteOrderMark.НеИспользовать); ЗащищенноеСоединениеSSL = Новый ЗащищенноеСоединениеOpenSSL(Новый СертификатКлиентаWindows, Новый СертификатыУдостоверяющихЦентровWindows);
Соединение = Новый HTTPСоединение(АдресХоста,,,,,, ЗащищенноеСоединениеSSL);
Попытка Ответ = Соединение.ВызватьHTTPМетод(МетодЗапроса, HTTPЗапрос); Сообщить("Код ответа: " + Ответ.КодСостояния); Сообщить("Ответ: " + Ответ.ПолучитьТелоКакСтроку("UTF-8")); Исключение Сообщить("Ошибка выполнения запроса!" + Символы.ПС + ОписаниеОшибки()); КонецПопытки;КонецПроцедуры
ВыполнитьHTTPЗапрос("DELETE", "https://api.ati.su", "/v1.2/orders/invites/{loadId}/{contactId}");
200 Успешный отказ от приглашения
4XX Ошибка запроса. [Подробнее про ошибки API](https://ati.su/developers/documentation/errors/)
Модель ошибки
Причина ошибки
Ключ ошибки
В случае, если несколько перевозчиков согласятся на предложенные грузовладельцем условия, грузовладелец будет иметь возможность выбрать одно из полученных предложений.