Как оформить Заказ
Когда вы берете груз (после Торгов, из поиска или после получения персонального приглашения) вам нужно заполнить следующую информацию в заявке на перевозку:
- водитель, назначенный на Заказ (опционально, может быть указан позже или не указан вообще);
- транспортное средство (ТС), закрепленное за Заказом (опционально, может быть указан позже или не указан вообще);
- ваши реквизиты для оформления сделки.
Взятие груза / Редактирование Заказа 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 имеющихся у вас водителей и ТС, воспользуйтесь методами, описанными в разделе «Справочники пользователя. Автопарк и водители».
Получить ID ваших реквизитов вам поможет метод получения реквизитов своей фирмы:
Метод получения реквизитов фирмы get /v1.0/firms/requisites
curl 'https://api.ati.su/v1.0/firms/requisites' \ -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/firms/requisites");
200 Success
Идентификтаор реквизита
Код в ATI.SU фирмы
Тип реквизита
Название реквизита
Юридическое именование фирмы
Идентификатор формы собственности
ФИО владельца
ИНН
ОГРН, для реквизитов в валюте (USD и EUR) в этом поле храниться VAT
Телефон
Факс
Электронный адрес
КПП
Расчетный счет
КС
БИК
Наименование банка
Коды
Реквизиты только для чтения
ОКПО
Плательщик НДС
Дата последнего использования в системе
Активный реквизит
Будет ли виден реквизит пользователю в будущем
Нужен для одноразовых реквизитов, например, при создании счета с оплатой по банковской карте (там создается реквизит из пары полей)
Юридический адрес
Идентификатор адреса
Код в ATI.SU фирмы
Идентификатор страны
Идентификатор региона
Идентификатор Города
Название города
Почтовый индекс
Тип улицы
Улица
Номер дома
Корпус дома
Литера
Номер офиса
Получатель почты
Дата добавления
Аттрибуты
?
Примечание
?
Является почтовым адресом
Идентификатор в ФИАС
Почтовый адрес
Идентификатор адреса
Код в ATI.SU фирмы
Идентификатор страны
Идентификатор региона
Идентификатор Города
Название города
Почтовый индекс
Тип улицы
Улица
Номер дома
Корпус дома
Литера
Номер офиса
Получатель почты
Дата добавления
Аттрибуты
?
Примечание
?
Является почтовым адресом
Идентификатор в ФИАС
Идентификатор юридического адреса в системе
Идентификатор почтового адреса в системе
Список подписантов
Идентификатор подписанта.
Идентификатор реквизита, которому принадлежит эта запись.
ФИО (обязательно в родительном падеже).
Должность (обязательно в родительном падеже).
На основании чего действует (обязательно в родительном падеже).
Выбирать по умолчанию.
Дата удаления.
Поле, объединяющее FullName и Position. Не является автовычисляемым (т.е. не является конкатенацией полей FullName и Position), создано для других нужд.
Паспорт физического лица
Серия
Номер
Дата выдачи
Код подразделения
Выдан
Адрес регистрации
Файл со сканом паспорта
Ccылка
Идентификатор
Размер
Название
Доступно в АТИ Доках
400 Bad Request
401 Unauthorized
402 Client Error
403 Forbidden
404 Not Found
500 Server Error
504 Server Error
После того, как вы заполните данные и возьмете груз, ваша заявка будет отправлена грузовладельцу на рассмотрение. Отследить статус Заказа можно с помощью метода получения статусов Заказа:
Получение статусов Заказов post /v1.2/orders/get_orders_statuses
curl 'https://api.ati.su/v1.2/orders/get_orders_statuses' \ -X 'POST' \ -H 'Authorization: Bearer {authorizationToken}' \ -H 'Content-Type: application/json' \ --data-raw '["3fa85f64-5717-4562-b3fc-2c963f66afa6"]'
Процедура Выполнить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/get_orders_statuses", "[""3fa85f64-5717-4562-b3fc-2c963f66afa6""]");
200 Возвращает объект _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
— Заказ из Торгов4
— Предложение груза8
— Из перехвата машин16
— Односторонний заказ32
— Предложение груза из встречного предложения64
— Предложение груза по контракту
Статус перевозки
0
— Нет статуса1
— Едет на загрузку2
— Ожидает загрузку3
— Загружается4
— Загрузился, едет на выгрузку5
— Ожидает выгрузку6
— Выгружается7
— Выгрузился8
— Поломка9
— ДТП10
— Арест ТС11
— Контейнер получен на погрузку12
— Контейнер на погрузке13
— Погрузка контейнера окончена14
— Контейнер сдан с погрузки15
— Контейнер получен на выгрузку16
— Контейнер на выгрузке17
— Выгрузка контейнера окончена18
— Контейнер сдан с выгрузки19
— Пустой контейнер получен20
— Пустой контейнер сдан100
— Заказ завершён
Время изменения статуса
Для получения более детальной информации по Заказу, воспользуйтесь методом получения информации по Заказу:
Получение информации по Заказу get /v1.2/orders/{dealId}
curl 'https://api.ati.su/v1.2/orders/{dealId}' \ -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/{dealId}");
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/)
Модель ошибки
Причина ошибки
Ключ ошибки
Если грузовладельца устроит ваше предложение, он сможет оформить сделку одним из указанных ниже способов:
- с использованием сервиса «АТИ-Доки» - документооборот будет вестись через ATI.SU. Грузовладелец сформирует документ на перевозку и отправит его вам на согласование. Узнать ID полученного документа можно с помощью метода получения информации по Заказу - данная информация появится в структуре
document
. Для того, чтобы одобрить документ с вашей стороны, воспользуйтесь методом одобрения документа. После того, как вы одобрите документ, Заказ будет переведен в исполнение. При необходимости документ на перевозку может быть подписан с помощью электронной цифровой подписи.
Получение информации по Заказу get /v1.2/orders/{dealId}
curl 'https://api.ati.su/v1.2/orders/{dealId}' \ -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/{dealId}");
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/)
Модель ошибки
Причина ошибки
Ключ ошибки
Одобрить документ put /documents/{doc_id}/approve/
curl 'https://api.ati.su/documents/{doc_id}/approve/' \ -X 'PUT' \ -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Запрос("PUT", "https://api.ati.su", "/documents/{doc_id}/approve/");
200 Результат запроса
Результат сохранения документа
Идентификатор документа
400 Ошибка запроса, документ не может быть одобрен.
Сообщение об ошибке
Код ошибки
Описание ошибки и возможная причина
Полная документация API АТИ-Доков.
- без использования «АТИ-Доков» - как только Заказ будет одобрен грузовладельцем, он будет переведен в исполнение.
Если у назначенного вами на Заказ водителя установлено приложение «АТИ Водитель», отправьте Заказ данному водителю с помощью метода назначения Заказа на водителя:
Назначение заказа на водителя.
put /v1.2/orders/carrier/{dealId}/driver_tracker_points
Id точки из Заказа
Время
Дата
Время до (если есть)
Дата до (если есть)
Широта точки
Долгота точки
Адрес
Список контактов (не более 10 контактов)
Контактное лицо
Телефон контактного лица
Порядковый номер добавления контактного лица (от 1 до 10)
Примечание (до 1000 символов)
Айди склада из временных окон
curl 'https://api.ati.su/v1.2/orders/carrier/{dealId}/driver_tracker_points' \ -X 'PUT' \ -H 'Authorization: Bearer {authorizationToken}' \ -H 'Content-Type: application/json' \ --data-raw '[{"deal_point_id":"2fb965f2-85e9-4213-90e7-f396e47219e7","time":"10:00","date":"02.01.2019","time_to":"01:00","date_to":"13.02.2019","lat":30.3330562,"lon":59.974006,"address":"гор. Санкт-Петербург","contact_persons":[{"name":"string","phone":"string","ordinal_id":1}],"note":"string","timeslots_warehouse_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Запрос("PUT", "https://api.ati.su", "/v1.2/orders/carrier/{dealId}/driver_tracker_points", "[{""deal_point_id"":""2fb965f2-85e9-4213-90e7-f396e47219e7"",""time"":""10:00"",""date"":""02.01.2019"",""time_to"":""01:00"",""date_to"":""13.02.2019"",""lat"":30.3330562,""lon"":59.974006,""address"":""гор. Санкт-Петербург"",""contact_persons"":[{""name"":""string"",""phone"":""string"",""ordinal_id"":1}],""note"":""string"",""timeslots_warehouse_id"":0}]");
200 Созданная информация по заказу
Id точки из Заказа
Порядковый номер точки
Время
Дата
Время до (если есть)
Дата до (если есть)
Широта точки
Долгота точки
Адрес
Id города
Значение из словаря городов ATI.SU
Id региона
Значение из словаря регионов ATI.SU
Id страны
Значение из словаря стран ATI.SU
Тип точки
1
— Загрузка2
— Разгрузка
Список контактов (не более 10 контактов)
Контактное лицо
Телефон контактного лица
Порядковый номер добавления контактного лица (от 1 до 10)
Примечание (до 1000 символов)
Айди склада из временных окон
4XX Ошибка запроса. [Подробнее про ошибки API](https://ati.su/developers/documentation/errors/)
Модель ошибки
Причина ошибки
Ключ ошибки
После того, как водитель подтвердит получение Заказа в приложении, вы сможете отслеживать пройденный водителем маршрут и получать историю событий, произошедших в пути следования водителя.
Получение информации о пройденном маршруте АТИ Водителя
get /v1.2/orders/carrier/map_route/by_deal
curl 'https://api.ati.su/v1.2/orders/carrier/map_route/by_deal' \ -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/carrier/map_route/by_deal");
200 Информация для карты
Точки загрузки/разгрузки
Долгота
Широта
События
Тип события
0
— Значение по умолчанию1
— Метаинформация об устройстве. Включает в себя события выключения GPS, подмены GPS координат, выключения телефона.2
— Информация о статусе заказа (статусы выбираются водителем в приложении)
Тэг произошедшего события
Дата начала
Дата окончания
Время начала
Время окончания
Информация о местоположении
Страна
Регион
Город
Адрес
Номер по порядку
Нужно ли прокладывать маршрут для этой точки
Точки траектории движения водителя
Транспортное средство
Номер телефона водителя
Тип события
0
— Без происшествий1
— GPS был выключен2
— Попытка подделки GPS3
— Не было данных4
— Режим энергосбережения5
— Стоянка
Время начала действия
Время окончания действия
Точки маршрута
Долгота
Широта
События
Тип события
0
— Значение по умолчанию1
— Метаинформация об устройстве. Включает в себя события выключения GPS, подмены GPS координат, выключения телефона.2
— Информация о статусе заказа (статусы выбираются водителем в приложении)
Тэг произошедшего события
Дата начала
Дата окончания
Время начала
Время окончания
Информация о местоположении
Страна
Регион
Город
Адрес
Время местоположения
Флаг поддельного сигнала GPS
Фдаг выключенности GPS
Флаг наличия данных
Флаг включенности режима энергосбережения
Флаг холостого хода
Стоянка
4XX Ошибка запроса. [Подробнее про ошибки API](https://ati.su/developers/documentation/errors/)
Модель ошибки
Причина ошибки
Ключ ошибки
Получение истории
get /v1.2/orders/carrier/map/history
curl 'https://api.ati.su/v1.2/orders/carrier/map/history' \ -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/carrier/map/history");
200 История выполнения заказа водителем
События в пути
Время события
Событие
Тип события
0
— Значение по умолчанию1
— Метаинформация об устройстве. Включает в себя события выключения GPS, подмены GPS координат, выключения телефона.2
— Информация о статусе заказа (статусы выбираются водителем в приложении)
Тэг произошедшего события
Дата начала
Дата окончания
Время начала
Время окончания
Информация о местоположении
Страна
Регион
Город
Адрес
Долгота
Широта
4XX Ошибка запроса. [Подробнее про ошибки API](https://ati.su/developers/documentation/errors/)
Модель ошибки
Причина ошибки
Ключ ошибки
Подробнее о методах для работы с Заказами с участием приоложения «АТИ Водитель» описано тут.
Заказу, находящемуся в исполнении, могут быть присвоены различные статусы: едет на загрузку, ожидает загрузку, загружается и т. д. Для того, чтобы изменить статусы перевозки, воспользуйтесь методом смены статусов перевозки Заказа. Статусы можете менять как вы, так и грузовладелец.
Смена cтатуса перевозки Заказа post /v1.2/orders/{dealId}/inwork
Статус перевозки
0
— Нет статуса1
— Едет на загрузку2
— Ожидает загрузку3
— Загружается4
— Загрузился, едет на выгрузку5
— Ожидает выгрузку6
— Выгружается7
— Выгрузился8
— Поломка9
— ДТП10
— Арест ТС11
— Контейнер получен на погрузку12
— Контейнер на погрузке13
— Погрузка контейнера окончена14
— Контейнер сдан с погрузки15
— Контейнер получен на выгрузку16
— Контейнер на выгрузке17
— Выгрузка контейнера окончена18
— Контейнер сдан с выгрузки19
— Пустой контейнер получен20
— Пустой контейнер сдан100
— Заказ завершён
curl 'https://api.ati.su/v1.2/orders/{dealId}/inwork' \ -X 'POST' \ -H 'Authorization: Bearer {authorizationToken}' \ -H 'Content-Type: application/json' \ --data-raw '{"in_work_status":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", "/v1.2/orders/{dealId}/inwork", "{""in_work_status"":0}");
200 Успешное изменение статуса
4XX Ошибка запроса. [Подробнее про ошибки API](https://ati.su/developers/documentation/errors/)
Модель ошибки
Причина ошибки
Ключ ошибки
После того, как Заказ будет выполнен, его можно завершить.
Завершение перевозки put /v1.2/orders/{dealId}/finish
curl 'https://api.ati.su/v1.2/orders/{dealId}/finish' \ -X 'PUT' \ -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Запрос("PUT", "https://api.ati.su", "/v1.2/orders/{dealId}/finish");
200 Успешное завершение
4XX Ошибка запроса. [Подробнее про ошибки API](https://ati.su/developers/documentation/errors/)
Модель ошибки
Причина ошибки
Ключ ошибки