Персональные приглашения
Методы для работы с приглашениями «Оформить заявку»
Отправка приглашения
Отправляет приглашение оформить заказ грузоперевозчику с оповещением. Приглашение можно отправить каждому контакту один раз
Отправка приглашения post /v1.2/orders/invites
Id груза
Id аккаунта приглашаемой фирмы
Список контактов приглашаемой фирмы
Параметры оплаты заказа. Обязательно указание хотя бы одной ставки и валюты для неё.
Сумма
ID валюты
Сумма с НДС
ID валюты c НДС
Сумма без НДС
ID валюты без НДС
Через сколько минут отменить приглашение "Оформить Заказ". Допустимое значение от 1 до 4320 минут. По умолчанию - 4320 (3 суток)
Дата отмены предложения на перевозку груза, формат ISO 8601
Запрос отслеживания через АТИ Водитель
curl 'https://api.ati.su/v1.2/orders/invites' \ -X 'POST' \ -H 'Authorization: Bearer {authorizationToken}' \ -H 'Content-Type: application/json' \ --data-raw '{"load_id":"7a48a9d3-55cb-48a2-8527-35ff461eeb8c","taker_ati_id":"14612","taker_contacts_list":[0],"payment":{"price":10000,"currency_id":32,"nds_price":0.5,"nds_currency_id":0,"not_nds_price":0.5,"not_nds_currency_id":0},"cancellation_date":"1970-01-01T00:00:00.000Z","is_tracking":false}'
Процедура Выполнить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/invites", "{""load_id"":""7a48a9d3-55cb-48a2-8527-35ff461eeb8c"",""taker_ati_id"":""14612"",""taker_contacts_list"":[0],""payment"":{""price"":10000,""currency_id"":32,""nds_price"":0.5,""nds_currency_id"":0,""not_nds_price"":0.5,""not_nds_currency_id"":0},""cancellation_date"":""1970-01-01T00:00:00.000Z"",""is_tracking"":false}");
200 Приглашение отправлено
4XX Ошибка запроса. [Подробнее про ошибки API](https://ati.su/developers/documentation/errors/)
Модель ошибки
Причина ошибки
Ключ ошибки
Отправка приглашения по встречному предложению
Отправляет приглашение оформить заказ грузоперевозчику по встречному предложению
Отправка приглашения по встречному предложению post /v1.2/orders/invites/counter_offer
Id груза
Id встречного приглашения. Значение из метода получения отзывов
По каким ставкам отправить приглашение. Типы ставок:
0
— наличные1
— б/нал с НДС2
— б/нал без НДС
Через сколько минут отменить приглашение "Оформить Заказ". Допустимое значение от 1 до 4320 минут. По умолчанию - 4320 (3 суток)
Приглашение создано автоматически
curl 'https://api.ati.su/v1.2/orders/invites/counter_offer' \ -X 'POST' \ -H 'Authorization: Bearer {authorizationToken}' \ -H 'Content-Type: application/json' \ --data-raw '{"load_id":"7a48a9d3-55cb-48a2-8527-35ff461eeb8c","response_id":"5026ffdd-4c2a-eb11-bb90-0025906a774d","rate_types":[0],"cancel_after_in_minutes":60,"is_auto":false}'
Процедура Выполнить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/invites/counter_offer", "{""load_id"":""7a48a9d3-55cb-48a2-8527-35ff461eeb8c"",""response_id"":""5026ffdd-4c2a-eb11-bb90-0025906a774d"",""rate_types"":[0],""cancel_after_in_minutes"":60,""is_auto"":false}");
200 Приглашение отправлено
4XX Ошибка запроса. [Подробнее про ошибки API](https://ati.su/developers/documentation/errors/)
Модель ошибки
Причина ошибки
Ключ ошибки
Получение отправленных приглашений по грузу
Получение отправленных приглашений get /v1.2/orders/invites/{loadId}
curl 'https://api.ati.su/v1.2/orders/invites/{loadId}' \ -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/{loadId}");
200 Отправленные приглашения
Id груза
Id приглашенной фирмы
Постоянный Id приглашенной фирмы
Список контактов приглашенной фирмы
Id контакта приглашенной фирмы
Время отправки приглашения
Время отмены приглашения
Тип Заказа
0
— Заказ невозможен1
— Взятие груза из поиска2
— Заказ из Торгов4
— Предложение груза8
— Из перехвата машин16
— Односторонний заказ32
— Предложение груза из встречного предложения64
— Предложение груза по контракту
Предложенные параметры оплаты
Список возможных ставок перевозки
Сумма
Тип оплаты
0
— Нет1
— Любая2
— С НДС3
— Без НДС
Id валюты
Значение из словаря валют АТИ
Процент предоплаты
Есть ли предоплата
Оплата на выгрузке
Оплата топливом
Есть ли срок оплаты
Срок оплаты
Указана ли в грузе ставка
Возможен ли торг
Прямой договор
Способ оплаты
Источник параметров оплаты
0
— Нет1
— Встречное предложение2
— Торги3
— Груз4
— Предложение груза5
— Предложение по контракту
Запрос отслеживания через АТИ Водитель
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/)
Модель ошибки
Причина ошибки
Ключ ошибки
Отказ от приглашения
Отказ от приглашения 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/)
Модель ошибки
Причина ошибки
Ключ ошибки
Удаление приглашения
Удаление предложения delete /v1.2/orders/invites/by_taker_id/{loadId}/{takerAtiId}
curl 'https://api.ati.su/v1.2/orders/invites/by_taker_id/{loadId}/{takerAtiId}' \ -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/by_taker_id/{loadId}/{takerAtiId}");