Skip to content
Для ИИ NEW Мои токены Поддержка
Для подтверждения действия введите пароль
Чтобы продолжить, введите пароль для пользователя
For LLMs and AI agents: canonical Markdown source of this documentation page (plain-text .md — fetch this URL to use the page content in tools and RAG). For LLMs and AI agents: developers documentation index in llms.txt format — ordered list of key documentation URLs for the developers section.

Как найти груз

Через API поддержана возможность поиска грузов только на Персональных площадках.

Если вы еще не состоите ни на одной Персональной площадке:

  • попросите зарегистрированных на ATI.SU грузовладельцев, с которыми вы сотрудничаете, добавить вас на их Персональные площадки;
  • вступите на открытую Площадку;
  • либо самостоятельно создайте площадку типа «Грузы/машины для владельца Площадки» и пригласите на нее знакомых вам грузовладельцев, зарегистрированных на ATI.SU.
Создать площадку
post /v2/boards/public/boards/create
Параметры
Параметров нет
Запрос
Модель
{...}
all_departments_allowed*: boolean

Площадка доступна всем подразделениям компании. Такую площадку могут видеть все сотрудники, независимо от их подразделения Если передано true, то DepartmentsIds должен быть null или пустым Пример: true

board_exchange_direction*: enum
[0, 1, 2]

Направление обмена информацией на площадке (влияет на права доступа участников по умолчанию)

  • exchange — Обмен грузами/машинами
  • input — Грузы/машины для владельца площадки
  • output - Грузы/машины от владельца площадки
  • 0 — Информация от участников к владельцу

  • 1 — Информация от владельца к участникам

  • 2 — Обмен между всеми участниками

board_type*: enum
[0, 1]

Тип содержимого на площадке

  • loads - Площадка с грузами
  • trucks - Площадка с машинами (зарезервировано, в данный момент такая возможность ещё не доступна)
  • 0 — Грузы

  • 1 — Машины

color: string

Цвет плашки площадки Пример: "#d8cfd0"

departments_ids: [int32]

Перечень подразделений компании, которым доступна площадка. В случае, если передан не пустой перечень значение AllDepartmentsAllowed должно быть false. Ответственный контакт ResponsibleContactId должен состоять (принадлежать) хотя бы одному из указанных подразделений Пример: [100302, 100303]

description: string

Описание площадки (можно использовать тэги "b", "i", "span", "u", "ul", "li", "br") Пример: "Лучшая площадка из всех созданных"

name_for_users: string

Публичное имя, видимое участникам площадки (до 50 символов) Пример: "Приходите, покупайте"

private_name: string

Имя, которое видит только владелец площадки (до 50 символов) Пример: "Покупайте, приходите"

public*: boolean

Открытая площадка или закрытая. На открытую может подать заявку на вступление любой пользователь. На закрытую можно попасть только по приглашению владельца. Пример: true

responsible_contact_id: int32

ID контакта ответственного пользователя Пример: 1

subscribe_to_notifications: boolean

Подписывать на уведомления новых участников. Пример: true

}
Пример запроса
curl 'https://api.ati.su/v2/boards/public/boards/create' \
-X 'POST' \
-H 'Authorization: Bearer {authorizationToken}' \
-H 'Content-Type: application/json' \
--data-raw '{"all_departments_allowed":false,"board_exchange_direction":"0","board_requirements":{"requirement_document_types":[{"base_type_id":"1","custom_type_name":"string","is_requirable":false}],"rules":"string"},"board_type":"0","color":"string","departments_ids":[0],"description":"string","name_for_users":"string","private_name":"string","public":false,"responsible_contact_id":0,"subscribe_to_notifications":false}'
Ответ
200 Данные о площадке
Модель
{...}
all_departments_allowed*: boolean

Площадка доступна всем подразделениям компании. Такую площадку могут видеть все сотрудники, независимо от их подразделения Пример: true

available_for_contact*: boolean

Площадка доступна для данного контакта Пример: true

board_exchange_direction*: enum
[0, 1, 2]

Направление обмена информацией на площадке (влияет на права доступа участников по умолчанию)

  • exchange — Обмен грузами/машинами
  • input — Грузы/машины для владельца площадки
  • output - Грузы/машины от владельца площадки
  • 0 — Информация от участников к владельцу

  • 1 — Информация от владельца к участникам

  • 2 — Обмен между всеми участниками

board_type*: enum
[0, 1]

Тип содержимого на площадке

  • loads - Площадка с грузами
  • trucks - Площадка с машинами (зарезервировано, в данный момент такая возможность ещё не доступна)
  • 0 — Грузы

  • 1 — Машины

color: string

Цвет площадки Пример: "#d8cfd0"

created_on*: date-time

Время создания площадки (timestamp) Пример: 1556201954901

departments_ids: [int32]

Перечень подразделений компании, которым доступна площадка Пример: [100302, 100303]

id: string

ID площадки (строка 24 символа) Пример: "507f1f77bcf86cd799439011"

name: string

Название площадки Пример: "Образцово-показательная площадка"

owner_ati_id: string

Код участника АТИ создавшего площадку Пример: "1111111"

owner_firm*: int32

Код участника АТИ создавшего площадку Пример: 1111111

updated_on*: date-time

Последнее время изменения площадки (Timestamp) Пример: 1556201954901

view_only_own*: boolean

Участник может видеть только свои грузы/машины Пример: true

}
Пример
{...}
"all_departments_allowed":false,
"available_for_contact":false,
"board_exchange_direction":"0",
"board_type":"0",
"color":"string",
"created_on":"1970-01-01T00:00:00.000Z",
"departments_ids":[...],
0
],
"id":"string",
"name":"string",
"owner_ati_id":"string",
"owner_firm":0,
"updated_on":"1970-01-01T00:00:00.000Z",
"view_only_own":false
}
400 Ошибка валидации или другая
Модель
{...}
error: string

Код ошибки

reason: string

Текст ошибки

errors_list: [string]

Список ошибок. Поле может отсутствовать в ответе, если для данного типа ошибки оно не предусмотрено

}
Пример
{...}
"error":"string",
"reason":"string",
"details":{...},
"any-key":null
},
"errors_list":[...]
"string"
]
}
Пригласить участника АТИ на площадку
post /v2/boards/public/participants/invite
Параметры
Параметров нет
Запрос
Модель
{...}
ati_id: string

код участника в АТИ

board_id: string

ID площадки

contact_id: int32

ID контакта

}
Пример запроса
curl 'https://api.ati.su/v2/boards/public/participants/invite' \
-X 'POST' \
-H 'Authorization: Bearer {authorizationToken}' \
-H 'Content-Type: application/json' \
--data-raw '{"ati_id":"string","board_id":"string","contact_id":0}'
Ответ
200 ID приглашения
Модель
string
Пример
"string"
400 Ошибка валидации
Модель
{...}
error: string

Код ошибки

reason: string

Текст ошибки

errors_list: [string]

Список ошибок. Поле может отсутствовать в ответе, если для данного типа ошибки оно не предусмотрено

}
Пример
{...}
"error":"string",
"reason":"string",
"details":{...},
"any-key":null
},
"errors_list":[...]
"string"
]
}

Полная документация API Площадок.

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

Поиск грузов, размещённых на указанных площадках. API для интеграции. Площадка — закрытый список фирм, которым виден груз; в выдачу попадают и ваши грузы, и чужие. Искать можно только по площадкам, доступным вашей фирме; общая площадка исключена.
get /v1.0/loads/search/byboards
Параметры
Параметр Тип Расположение Описание
boardIds string[] query
Идентификаторы закрытых площадок, по 24 символа. Пустой список — поиск по всем площадкам, доступным фирме. Пример: ["5f1e2d3c4b5a69788796a5b4"]
Запрос
Пример запроса
curl 'https://api.ati.su/v1.0/loads/search/byboards' \
-X 'GET' \
-H 'Authorization: Bearer {authorizationToken}' \
-H 'Content-Type: application/json'
Ответ
200 Грузы, опубликованные на выбранных площадках.
Модель
[{...}]

Груз в ответе: поля публикации и вычисляемые сервисом.

LoadMeta:

Метаданные публикации: по их идентификатору можно получить все грузы, размещённые одной публикацией

ONE-OF
ContactId1*: int32

Идентификатор первого выбранного контакта. dict: GET https://api.ati.su/firms/v1.0/contacts → id. Список всех контактов и их идентификаторы можно получить с помощью API для работы с фирмами. Контакт должен быть виден для остальных участников АТИ

ContactId2: int32 (nullable)

Идентификатор второго выбранного контакта, если не выбрано, то null. Контакт должен быть виден для остальных участников АТИ

Note: string

Примечание к грузу. Ограничение по длине: 1000 символов

FirstDate: date-time

Дата, начиная с которой груз актуален, в формате UTC. Минимальное значение равно текущей дате. При значении параметра DateType равным 0, допустимое значение поля - текущая дата. При значении параметра DateType равным 1, допустимое значение поля - от текущей даты до 2 месяцев вперед. При значении параметра DateType равным 2, допустимое значение поля - текущая дата. При значении параметра DateType равным 3, FirstDate должен принимать значение текущей даты или отсутствовать

LastDate: date-time

Дата, после которой груз не актуален, в формате UTC. Минимальное значение равно значению параметра FirstDate. При значении параметра DateType равным 0, допустимое значение поля - от текущей даты до 1 дня вперед. При значении параметра DateType равным 1, допустимое значение поля - от даты в параметре FirstDate до 9 дней вперед. При значении параметра DateType равным 2, сервис вычисляет поле как FirstDate + 2 месяца, передаваемое значение игнорируется. При значении параметра DateType равным 3, LastDate автоматически устанавливается на значение + 2 дня от текущей даты, передаваемое значение игнорируется

DateType: int32

Тип готовности груза к перевозке, по умолчанию 0

  • 0 - Готов к загрузке
  • 1 - в период с FirstDate по LastDate
  • 2 - постоянно
  • 3 - груза нет, запрос ставки
PeriodicityId: int32

Периодичность загрузки. Если параметр DateType не равен 2, PeriodicityId равен 0. Иначе PeriodicityId может принимать следующие значения:

  • 1 - ежедневно
  • 100 - по рабочим дням
OrderNumber: string

Номер заказа. Ограничение по длине: 250 символов

Krugoreis: boolean

Включён ли кругорейс

Loading*:

Точка погрузки

ONE-OF
Unloading*:

Точка выгрузки

ONE-OF
Cargo*:

Что везём: наименование, вес, объём, упаковка

ONE-OF
Transport*:

Требования к транспорту: кузов, варианты загрузки и выгрузки

ONE-OF
Payment*:

Условия оплаты и ставка

ONE-OF
InviteSettings:

Настройки автоприглашений

ONE-OF
PriorityView:

Приоритетный показ

ONE-OF
Stealth:

Настройки показа груза

ONE-OF
Deal:

Сделка, в рамках которой размещён груз

ONE-OF
UnloadFirstDate: date-time (nullable)

Дата начала разгрузки, в формате UTC. Может иметь значение null. Минимальное значение равно текущей дате. Не указывается при значении параметра DateType равным 3

UnloadLastDate: date-time (nullable)

Дата окончания разгрузки, в формате UTC. Может иметь значение null. Если нет даты начала разгрузки UnloadFirstDate, должна отсутствовать дата окончания разгрузки UnloadLastDate. Не указывается при значении параметра DateType равным 3

ArchiveDate: date-time (nullable)

Дата и время переноса в архив

ArchiveReason:

Причина переноса в архив

ONE-OF

(nullable)

enum
[Unknown, System, Manual, Complaints, UnwantedContent, DeleteCsvLoad, MergeLoadsAfterEdit, ContactDoesNotHaveAccessToVirtualPayments, VerticesLoadDelete, StealthStatisticError, CheckDuplicateComplaints, DeleteContact, DeleteFirm, CleanOldLoadsJob]

Причина, по которой груз оказался в архиве.

  • VerticesLoadDelete - Снят при сквозной передаче груза
  • StealthStatisticError - Снят из-за ошибки при подсчёте статистики Стелса
  • CheckDuplicateComplaints - Снят при проверке дублирующих жалоб
  • DeleteContact - Удалён контакт
  • DeleteFirm - Удалена фирма
  • CleanOldLoadsJob - Истёк срок актуальности
  • Unknown - Причина не определена
  • System - Снят системой
  • Manual - Снят с публикации владельцем
  • Complaints - Снят по жалобам
  • UnwantedContent - Снят за недопустимое содержимое
  • DeleteCsvLoad - Удалён вместе с CSV-загрузкой
  • MergeLoadsAfterEdit - Объединён с другим грузом после редактирования
  • ContactDoesNotHaveAccessToVirtualPayments - Снят: у контакта нет права оплачивать услугу со счёта фирмы
TruePrice: int32

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

TrueCurrencyId: int32

Идентификатор валюты озвученной ставки. dict: GET /v1.0/dictionaries/currencyTypes → Id

ResponseCount: int32

Количество отзывов о грузе (без встречных предложений)

OfferCount: int32

Количество встречных предложений (остальные отзывы не учитываются)

CanBeDeleted: boolean

Можно ли снять груз с публикации

HasPermissionsToLoad: boolean

Есть ли у текущего контакта доступ к грузу: контакт указан в грузе или имеет доступ к его подразделению

CanBeEdited: boolean

Можно ли редактировать груз

CanBeRenewed: boolean

Можно ли обновить груз

CanBeRestored: boolean

Можно ли восстановить груз из архива

EditRestriction:

Причина отказа в редактировании груза, 0 — доступ есть. dict: GET /v1.0/dictionaries/load_access_denied_reasons → ключ

ONE-OF
enum
[0, 1, 2, 3, 4, 5, 6, 7, 8, 9, 10, 11, 12, 13, 14, 15, 16]

Причина отказа в доступе к грузу.

  • 0 - Вы имеете доступ к работе с грузом
  • 1 - Ваша фирма больше не может размещать грузы из-за нарушения правил АТИ
  • 2 - Груз зарезервирован или взят, операции с грузом запрещены
  • 3 - Превышен лимит актуальных грузов
  • 4 - Вы пытаетесь работать с грузами под общим пользователем, недостаточно прав
  • 5 - У вашего контакта недостаточно прав для работы с данным грузом
  • 6 - Груз имеет завершённые торги, операции с грузом запрещены
  • 7 - Сервис сделок временно недоступен
  • 8 - Нельзя изменять или удалять груз из сквозных торгов
  • 9 - У вашего контакта недостаточно прав для создания грузов
  • 10 - У вашего контакта недостаточно прав для работы с виртуальными кошельками
  • 11 - У вашего контакта недостаточно прав для работы с грузами на общей площадке
  • 12 - У вашего контакта недостаточно прав для работы с грузами на персональных площадках
  • 13 - У вашего контакта нет доступа к одной или нескольким персональным площадкам, указанным в грузе
  • 14 - У вашего контакта нет доступа к подразделению груза
  • 15 - Ваш контакт должен быть указан первым в грузе
  • 16 - Груз не опубликован ни на одной площадке
DeleteRestriction:

Причина отказа в снятии груза с публикации, 0 — доступ есть. dict: GET /v1.0/dictionaries/load_access_denied_reasons → ключ

ONE-OF
enum
[0, 1, 2, 3, 4, 5, 6, 7, 8, 9, 10, 11, 12, 13, 14, 15, 16]

Причина отказа в доступе к грузу.

  • 0 - Вы имеете доступ к работе с грузом
  • 1 - Ваша фирма больше не может размещать грузы из-за нарушения правил АТИ
  • 2 - Груз зарезервирован или взят, операции с грузом запрещены
  • 3 - Превышен лимит актуальных грузов
  • 4 - Вы пытаетесь работать с грузами под общим пользователем, недостаточно прав
  • 5 - У вашего контакта недостаточно прав для работы с данным грузом
  • 6 - Груз имеет завершённые торги, операции с грузом запрещены
  • 7 - Сервис сделок временно недоступен
  • 8 - Нельзя изменять или удалять груз из сквозных торгов
  • 9 - У вашего контакта недостаточно прав для создания грузов
  • 10 - У вашего контакта недостаточно прав для работы с виртуальными кошельками
  • 11 - У вашего контакта недостаточно прав для работы с грузами на общей площадке
  • 12 - У вашего контакта недостаточно прав для работы с грузами на персональных площадках
  • 13 - У вашего контакта нет доступа к одной или нескольким персональным площадкам, указанным в грузе
  • 14 - У вашего контакта нет доступа к подразделению груза
  • 15 - Ваш контакт должен быть указан первым в грузе
  • 16 - Груз не опубликован ни на одной площадке
RestoreRestriction:

Причина отказа в восстановлении груза из архива, 0 — доступ есть. dict: GET /v1.0/dictionaries/load_access_denied_reasons → ключ

ONE-OF
enum
[0, 1, 2, 3, 4, 5, 6, 7, 8, 9, 10, 11, 12, 13, 14, 15, 16]

Причина отказа в доступе к грузу.

  • 0 - Вы имеете доступ к работе с грузом
  • 1 - Ваша фирма больше не может размещать грузы из-за нарушения правил АТИ
  • 2 - Груз зарезервирован или взят, операции с грузом запрещены
  • 3 - Превышен лимит актуальных грузов
  • 4 - Вы пытаетесь работать с грузами под общим пользователем, недостаточно прав
  • 5 - У вашего контакта недостаточно прав для работы с данным грузом
  • 6 - Груз имеет завершённые торги, операции с грузом запрещены
  • 7 - Сервис сделок временно недоступен
  • 8 - Нельзя изменять или удалять груз из сквозных торгов
  • 9 - У вашего контакта недостаточно прав для создания грузов
  • 10 - У вашего контакта недостаточно прав для работы с виртуальными кошельками
  • 11 - У вашего контакта недостаточно прав для работы с грузами на общей площадке
  • 12 - У вашего контакта недостаточно прав для работы с грузами на персональных площадках
  • 13 - У вашего контакта нет доступа к одной или нескольким персональным площадкам, указанным в грузе
  • 14 - У вашего контакта нет доступа к подразделению груза
  • 15 - Ваш контакт должен быть указан первым в грузе
  • 16 - Груз не опубликован ни на одной площадке
RenewRestriction: string

Причина отказа в обновлении груза. Пустая строка, если обновление доступно

Id: guid

Идентификатор груза

LoadNumber: string

Номер груза

UpdatedAt: date-time

Дата последнего изменения груза в UTC

AddedAt: date-time

Дата публикации груза в UTC

RefreshedAt: date-time

Дата последнего обновления груза в выдаче, в UTC

Distance: int32

Расстояние по дорогам в километрах

PlatonRoadsLength: int32

Протяжённость участков маршрута, за которые взимается плата по системе «Платон», в километрах

TollRoadsLength: int32

Протяжённость платных дорог на маршруте в километрах

TravelTime: string

Расчётное время в пути в формате [d.]hh:mm:ss

Zimnik: boolean

Учитывать ли зимники при построении маршрута

Ferries: boolean

Учитывать ли паромные переправы при построении маршрута

FirmId: string

Идентификатор фирмы

AuctionId: guid (nullable)

Идентификатор аукциона по грузу

}]
Пример
[...]
{...}
"LoadMeta":{...},
"LoadMetaId":"3fa85f64-5717-4562-b3fc-2c963f66afa6",
"MetaData":"import-2026-09"
},
"ContactId1":1234567,
"ContactId2":1234568,
"Note":"Погрузка с 9 до 18, пропуск заказывать заранее",
"FirstDate":"2026-09-08T00:00:00.000Z",
"LastDate":"2026-09-10T00:00:00.000Z",
"DateType":1,
"PeriodicityId":0,
"OrderNumber":"ЗК-2026-0917",
"Krugoreis":false,
"Loading":{...},
"CityId":1,
"Latitude":59.939095,
"Longitude":30.315868,
"Street":"ул. Салова, 57",
"OrganizationId":"3fa85f64-5717-4562-b3fc-2c963f66afa6",
"AddressId":"3fa85f64-5717-4562-b3fc-2c963f66afa6",
"TimeStart":"2026-09-08T09:00:00.000Z",
"TimeEnd":"2026-09-08T18:00:00.000Z",
"IsRoundTheClock":false,
"LargeCities":[...],
0
],
"LoadingCargos":[...]
{...}
"CargoId":1,
"NameId":1,
"Name":"Продукты питания",
"PackagingType":1,
"PackagingQuantity":20,
"Weight":20,
"Volume":82,
"Sizes":{...}
"Length":13.6,
"Width":2.45,
"Height":2.7,
"Diameter":1.2,
"LengthHighlight":false,
"WidthHighlight":false,
"HeightHighlight":false
}
}
]
},
"ExtraPoints":[...],
{...}
"CityId":1,
"PointType":2,
"Latitude":59.939095,
"Longitude":30.315868,
"Street":"пр. Ленина, 10",
"OrganizationId":"3fa85f64-5717-4562-b3fc-2c963f66afa6",
"AddressId":"3fa85f64-5717-4562-b3fc-2c963f66afa6",
"OrdinalId":1,
"IsRoundTheClock":false,
"LoadingDateStart":"2026-09-09T00:00:00.000Z",
"LoadingDateEnd":"2026-09-09T00:00:00.000Z",
"LoadingTimeStart":"09:00:00",
"LoadingTimeEnd":"18:00:00",
"LoadingCargos":[...],
{...}
"CargoId":1,
"NameId":1,
"Name":"Продукты питания",
"PackagingType":1,
"PackagingQuantity":20,
"Weight":20,
"Volume":82,
"Sizes":{...}
"Length":13.6,
"Width":2.45,
"Height":2.7,
"Diameter":1.2,
"LengthHighlight":false,
"WidthHighlight":false,
"HeightHighlight":false
}
}
],
"UnloadingCargos":[...]
{...}
"CargoId":1,
"Weight":10,
"Volume":40,
"PackagingQuantity":10,
"IsDefinedByTtn":false
}
]
}
],
"Unloading":{...},
"CityId":1,
"Latitude":59.939095,
"Longitude":30.315868,
"Street":"ул. Салова, 57",
"OrganizationId":"3fa85f64-5717-4562-b3fc-2c963f66afa6",
"AddressId":"3fa85f64-5717-4562-b3fc-2c963f66afa6",
"TimeStart":"2026-09-08T09:00:00.000Z",
"TimeEnd":"2026-09-08T18:00:00.000Z",
"IsRoundTheClock":false,
"LargeCities":[...],
0
],
"LoadingCargos":[...]
{...}
"CargoId":1,
"NameId":1,
"Name":"Продукты питания",
"PackagingType":1,
"PackagingQuantity":20,
"Weight":20,
"Volume":82,
"Sizes":{...}
"Length":13.6,
"Width":2.45,
"Height":2.7,
"Diameter":1.2,
"LengthHighlight":false,
"WidthHighlight":false,
"HeightHighlight":false
}
}
]
},
"Cargo":{...},
"Weight":20,
"Volume":82,
"ADR":0,
"CargoTypeId":59,
"CargoType":"Стройматериалы",
"PackType":1,
"PalletCount":33,
"BeltCount":0,
"DogruzType":1,
"SborGruz":false,
"Size":{...}
"Length":13.6,
"Width":2.45,
"Height":2.7,
"Diameter":1.2,
"LengthHighlight":false,
"WidthHighlight":false,
"HeightHighlight":false
}
},
"Transport":{...},
"CarType":5,
"CarTypeString":"5",
"LoadingType":3,
"LoadingLogicalOperator":"OR",
"UnloadingType":3,
"UnloadingLogicalOperator":"OR",
"TrucksQuantity":1,
"TemperatureFrom":-18,
"TemperatureTo":4,
"Stsepka":false,
"Pnevmohod":false,
"Koniki":false,
"TIR":false,
"CMR":false,
"T1":false,
"SanPassport":false,
"IsTracking":false,
"RequiredCapacity":20
},
"Payment":{...},
"CurrencyId":1,
"MoneyType":22,
"RateSum":85000,
"SumWithNDS":102000,
"SumWithoutNDS":85000,
"PrepayPercent":30,
"PrepayPercentEnabled":true,
"PayDays":5,
"PayDaysEnabled":true,
"FixedRate":true,
"Torg":false,
"DirectContract":false,
"InFuel":false,
"OnUnloading":false,
"HideResponses":false,
"AcceptPaymentTypes":0
},
"InviteSettings":{...},
"InviteDelayInSeconds":600,
"InviteDurationInSeconds":3600,
"MaxPercentDeviation":10,
"NeedArchiveOnInvite":false
},
"PriorityView":{...},
"DailyLimit":500,
"IsForPayedOnly":false,
"OrderLimit":100,
"ViewRate":1.5,
"MoneySpentPerDay":12,
"MoneySpentPerOrder":45
},
"Stealth":{...},
"ListIdToHide":"3fa85f64-5717-4562-b3fc-2c963f66afa6",
"FirmRegDateToHide":"2024-01-01T00:00:00.000Z",
"ScoreToHide":3
},
"LoadFiles":[...],
{...}
"FileId":"a1b2c3d4e5f6a7b8c9d0e1f2",
"FileType":1,
"Attributes":0,
"Name":"Договор.pdf",
"Link":"https://api.ati.su/gw/plyushkin/v1/a1b2c3d4e5f6a7b8c9d0e1f2",
"Size":-1
}
],
"Deal":{...},
"Auction":{...}
"StartRate":50000,
"Currency":1,
"Step":500,
"PaymentType":0,
"AcceptSecondPayType":false,
"StartDate":"2026-09-08T09:00:00.000Z",
"EndDate":"2026-09-08T12:00:00.000Z",
"EndDateBoundary":"2026-09-09T09:00:00.000Z",
"Nds":20,
"TimeToProvideDocuments":4,
"AutoRenew":true,
"RenewTime":5,
"MaxRenewTime":30,
"RaiseBid":false,
"MaxRate":60000,
"RaiseBidInterval":30,
"ResponseInMinutes":15,
"Duration":180,
"StartSinceFirstBet":false,
"AuctionRestartParameters":{...},
"AuctionFinishAction":0,
"InitRestartCount":1,
"InitChangeWinnerCount":1,
"DurationAfterRestart":120,
"RateIncrease":500,
"RateIncreaseOption":1
},
"AcceptCounterOffersOnlyBeforeFirstBet":false,
"WinnerCriterion":0,
"Source":0,
"AuctionId":"3fa85f64-5717-4562-b3fc-2c963f66afa6",
"LoadId":"3fa85f64-5717-4562-b3fc-2c963f66afa6",
"ActiveDealId":"3fa85f64-5717-4562-b3fc-2c963f66afa6",
"State":0,
"Finished":false,
"WinDate":"2026-09-08T12:05:00.000Z",
"AuctionRates":[...]
{...}
"AuctionRateId":"3fa85f64-5717-4562-b3fc-2c963f66afa6",
"AddedAt":"2026-09-08T10:15:30.000Z",
"RateFirm":{...},
"Score":4.5,
"Status":0,
"Name":"ООО «Перевозчик»",
"ContactName":"Иван Петров",
"AtiId":"1234567"
},
"Rate":48000,
"State":0,
"LoadingDate":"2026-09-09T00:00:00.000Z",
"FirmId":7654321,
"ContactId":0
}
]
}
},
"Boards":[...],
{...}
"BoardId":"a0a0a0a0a0a0a0a0a0a0a0a0",
"PublicationTime":"2026-09-08T12:00:00.000Z",
"IsReservationEnabled":false,
"PublicationOption":0,
"IsPublished":true,
"IsCommonBoard":true
}
],
"UnloadFirstDate":"2026-09-11T00:00:00.000Z",
"UnloadLastDate":"2026-09-12T00:00:00.000Z",
"ArchiveDate":"2026-09-07T10:15:30.000Z",
"ArchiveReason":"Unknown",
"TruePrice":85000,
"TrueCurrencyId":1,
"ResponseCount":3,
"OfferCount":2,
"CanBeDeleted":true,
"HasPermissionsToLoad":true,
"CanBeEdited":true,
"CanBeRenewed":true,
"CanBeRestored":false,
"EditRestriction":0,
"DeleteRestriction":0,
"RestoreRestriction":0,
"RenewRestriction":"Груз можно обновить не ранее чем через 40 минут",
"Id":"3fa85f64-5717-4562-b3fc-2c963f66afa6",
"LoadNumber":"12345678",
"UpdatedAt":"2026-09-07T10:15:30.000Z",
"AddedAt":"2026-09-05T08:00:00.000Z",
"RefreshedAt":"2026-09-07T09:00:00+00:00",
"Distance":712,
"PlatonRoadsLength":540,
"TollRoadsLength":120,
"TravelTime":"10:30:00",
"Zimnik":false,
"Ferries":false,
"FirmId":"1234567",
"AuctionId":"3fa85f64-5717-4562-b3fc-2c963f66afa6"
}
]
400 Идентификатор площадки не из 24 символов.
Модель
{...}

Ошибка вместо результата: машинный ключ и пояснение для пользователя.

Reason: string

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

Error: string

Ключ ошибки

}
Пример
{...}
"Reason":"Ошибка валидации: Массив ids не должен быть пуст",
"Error":"validation_error"
}
403 Среди площадок есть недоступная фирме, в том числе общая.
Модель
{...}

Ошибка вместо результата: машинный ключ и пояснение для пользователя.

Reason: string

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

Error: string

Ключ ошибки

}
Пример
{...}
"Reason":"Следующие площадки не существуют или вы не имеете доступа к ним: 5f1e2d3c4b5a69788796a5b4",
"Error":"boards_access_denied_error"
}

Сформируйте свое предложение на перевозку

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

Грузы могут быть размещены со следующими вариантами ставок:

  • запрос ставки - в данном случае грузовладелец ожидает получить различные предложения по ценам от перевозчиков. Своё предложение отправьте методом создания встречного предложения. Если грузовладельца устроит ваше предложение, он отправит вам приглашение на сделку, которое можно получить методом получения списка приглашений.
Создание встречного предложения
post /gw/cargo-counter-offers-api/integrator/v1/cargos/{cargoId}/counter-offers
Параметры
Параметр Тип Расположение Описание
cargoId обязательный string (guid) path
ID груза Пример: 3fa85f64-5717-4562-b3fc-2c963f66afa6
Запрос
Модель
{...}
contact_id*: int32

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

price: decimal

Предложенная ставка встречного предложения не б/нал.

currency_id: int32

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

nds_price: decimal

Предложенная ставка встречного предложения б/нал с НДС

nds_percent: int32 (nullable)

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

nds_currency_id: int32

Валюта ставки встречного предложения б/нал с НДС. Значение из словаря валют АТИ

not_nds_price: decimal

Предложенная ставка встречного предложения б/нал без НДС

not_nds_currency_id: int32

Валюта ставки встречного предложения б/нал без НДС. Значение из словаря валют АТИ

note: string (nullable)

Примечание к встречному предложению

prepay_percent: int32

Процент предоплаты
Допустимое значение от 0 до 100

pay_after_max_bank_days: int32

Оплата через ... банковских дней\

loading_date: date (nullable)

Дата загрузки

pay_attributes: int32

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

  • 1 - возможна оплата наличными
  • 2 - возможна оплата по безналичному рассчету
  • 4 - блиц
  • 8 - оплата с НДС
  • 16 - возможна предоплата
  • 32 - оплата на выгрузке
  • 64 - включена ли оплата через некоторое количество банковских дней
}
Пример запроса
curl 'https://api.ati.su/gw/cargo-counter-offers-api/integrator/v1/cargos/{cargoId}/counter-offers' \
-X 'POST' \
-H 'Authorization: Bearer {authorizationToken}' \
-H 'Content-Type: application/json' \
--data-raw '{"contact_id":1,"price":100.5,"currency_id":1,"nds_price":100.5,"nds_percent":22,"nds_currency_id":1,"not_nds_price":100.5,"not_nds_currency_id":1,"note":"Примечание","prepay_percent":10,"pay_after_max_bank_days":0,"loading_date":"2024-01-15","pay_attributes":64}'
Ответ
200
Модель
{...}

Встречное предложение

id: guid

Id встречного предложения

cargo_id: guid

Id груза, на который оставлено встречное предложение

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

Номер груза

cargo_firm_id: int32

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

firm_id: int32

Id фирмы, которая оставила встречное предложение

added_at: date-time

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

updated_at: date-time

Дата изменения встречного предложения

price: decimal

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

currency_id: int32

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

nds_price: decimal

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

nds_percent: int32

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

nds_currency_id: int32

Валюта ставки встречного предложения б/нал с НДС. Значение из словаря валют АТИ

not_nds_price: decimal

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

not_nds_currency_id: int32

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

counter_offer_source: int32

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

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

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

pay_attributes: int32

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

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

Процент предоплаты

pay_after_max_bank_days: int32

Оплата через ... банковских дней

loading_date: date

Дата загрузки

is_outdated: boolean

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

is_cargo_published: boolean

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

firm_info:

Информация о фирме, оставившей встречное предложение на груз

ONE-OF
}
Пример
{...}
"id":"3fa85f64-5717-4562-b3fc-2c963f66afa6",
"cargo_id":"3fa85f64-5717-4562-b3fc-2c963f66afa6",
"cargo_number":"CES23786",
"cargo_firm_id":1234,
"firm_id":1234,
"added_at":"2024-01-15T10:30:00+03:00",
"updated_at":"2024-01-15T10:30:00+03:00",
"price":100.5,
"currency_id":1,
"nds_price":100.5,
"nds_percent":22,
"nds_currency_id":1,
"not_nds_price":100.5,
"not_nds_currency_id":1,
"counter_offer_source":2,
"note":"Тестовое примечание",
"pay_attributes":0,
"prepay_percent":0,
"pay_after_max_bank_days":0,
"loading_date":"2024-01-15",
"is_outdated":false,
"is_cargo_published":false,
"firm_info":{...}
"total_score":4.5,
"status":3,
"full_firm_name":"ООО Тест",
"contact":{...},
"id":1,
"name":"Иванов Иван",
"telephone":"+74951234567",
"email":"test@test.ru",
"mobile":"+79001234567",
"mobile_operator":"МТС",
"location":{...}
"city_id":1,
"region_id":1,
"country_id":1,
"full_name":"Москва, Россия",
"short_name":"Москва",
"is_regional_center":true,
"fias_id":"0c5b2444-70a0-4932-980c-b4dc0d3f02b5",
"city_name":"Москва",
"region_name":"Московская область",
"country_name":"Россия",
"country_code":"RU"
}
},
"inn":1234567890
}
}
4XX Ошибка запроса
Модель
{...}
error: string

Код ошибки

reason: string (nullable)

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

}
Пример
{...}
"error":"string",
"reason":"string",
"details":[...]
{...}
"property":"string",
"error":"string",
"reason":"string"
}
]
}
Получение списка приглашений.
get /v1.2/orders/invites/my
Параметры
Параметр Тип Расположение Описание
role integer query
Роль пользователя: `0` — Грузовладелец, `1` — Перевозчик Пример: 1
Запрос
Пример запроса
curl 'https://api.ati.su/v1.2/orders/invites/my' \
-X 'GET' \
-H 'Authorization: Bearer {authorizationToken}' \
-H 'Content-Type: application/json'
Ответ
200 Список приглашений на перевозку груза
Модель
[{...}]

Персональное приглашение.

owner_ati_id: string

Id фирмы грузовладельца.

owner_persistent_user_id: int32

Постоянный Id фирмы грузовладельца.

owner_contact_id: int32 (nullable)

Id контакта, который отправил приглашение.

taker_ati_id: string

Id приглашенной фирмы.

taker_persistent_user_id: int32

Постоянный Id приглашенной фирмы.

taker_contact_id: int32

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

taker_contacts_list: [int32]

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

date: date-time

Время отправки приглашения.

cancellation_date: date-time (nullable)

Время отмены приглашения.

payment:

Предложенные параметры оплаты.

ONE-OF
load:

Параметры предложенного груза.

ONE-OF
is_tracking: boolean

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

deal_kind:

Тип заказа.

ONE-OF
enum
[0, 1, 2, 4, 8, 16, 32, 64, 128, 256]

Тип заказа.

  • 0 — Заказ невозможен
  • 1 — Взятие груза из поиска
  • 2 — Заказ из торгов
  • 4 — Предложение груза
  • 8 — Из перехвата машин
  • 16 — Односторонний заказ
  • 32 — Предложение груза из встречного предложения
  • 64 — Предложение груза по контракту
  • 128 — Создан вручную для тестирования черновиков
  • 256 — Создан из АТИ-Доков
}]
Пример
[...]
{...}
"owner_ati_id":67890,
"owner_persistent_user_id":2002,
"owner_contact_id":200,
"taker_ati_id":12345,
"taker_persistent_user_id":1001,
"taker_contact_id":100,
"taker_contacts_list":[...],
0
],
"date":"2024-06-15T10:30:00Z",
"cancellation_date":"2024-06-16T12:00:00Z",
"payment":{...},
"rates":[...],
{...}
"rate":45000,
"rate_type":0,
"currency":1,
"vat_percent":22
}
],
"prepay_percent":30,
"prepay_percent_enabled":true,
"on_unloading":false,
"in_fuel":false,
"pay_days_enabled":true,
"pay_days":5,
"fixed_rate":true,
"torg":false,
"direct_contract":true,
"payment_source":0
},
"load":{...},
"id":"2fb965f2-85e9-4213-90e7-f396e47219e7",
"load_number":"ATI00012345",
"distance":720,
"distance_type":1,
"platon_roads_length":120,
"toll_roads_length":80,
"travel_time":"08:30:00",
"true_price":80000,
"true_currency_id":1,
"note":"Тент, боковая загрузка",
"first_date":"2024-06-16T00:00:00Z",
"last_date":"2024-06-18T00:00:00Z",
"date_type":0,
"periodicity_id":0,
"order_number":"ЗН-15",
"krugoreis":false,
"zimnik":false,
"ferries":false,
"loading":{...},
"fias_id":"2fb965f2-85e9-4213-90e7-f396e47219e7",
"city_id":1,
"latitude":55.7558,
"longitude":37.6173,
"street":"ул. Ленина, 1",
"organization_id":"7c9e6679-7425-40de-944b-e07fc1f90ae7",
"address_id":"9c514669-b666-42ea-85e6-312093b93a50",
"time_start":"1900-01-01T08:00:00Z",
"time_end":"1900-01-01T18:00:00Z",
"is_round_the_clock":false,
"large_cities":[...],
0
],
"large_cities_with_distance":[...],
{...}
"city_id":1,
"distance":15.5
}
],
"loading_cargos":[...],
{...}
"cargo_id":1,
"name_id":59,
"name":"Щебень",
"packaging_type":1,
"packaging_quantity":10,
"weight":20,
"volume":40,
"sizes":{...},
"length":13.6,
"width":2.45,
"height":2.7,
"diameter":0,
"length_highlight":false,
"width_highlight":false,
"height_highlight":false
},
"packaging_type_name":"коробки"
}
],
"organization":{...}
"organization_id":"2fb965f2-85e9-4213-90e7-f396e47219e7",
"firm_id":12345,
"name":"ООО Ромашка",
"ownership":1,
"residency":0,
"inn":7707083893,
"phone":"+79001234567",
"extra_phone":123,
"docs_address":{...},
"postcode":101000,
"city_id":1,
"street_name":"ул. Ленина",
"house_no":1,
"office_no":10
},
"stocks":[...],
{...}
"stock_id":"2fb965f2-85e9-4213-90e7-f396e47219e7",
"address":"ул. Ленина, 1",
"address_city_id":1,
"address_latitude":55.7558,
"address_longitude":37.6173,
"note":"Въезд со двора",
"work_schedules":[...],
{...}
"stock_schedule_id":"2fb965f2-85e9-4213-90e7-f396e47219e7",
"day_of_week":0,
"start_time":"09:00:00",
"end_time":"18:00:00"
}
],
"breaks_schedules":[...],
{...}
"stock_schedule_id":"2fb965f2-85e9-4213-90e7-f396e47219e7",
"day_of_week":0,
"start_time":"09:00:00",
"end_time":"18:00:00"
}
],
"contact_persons":[...],
{...}
"contact_person_id":"2fb965f2-85e9-4213-90e7-f396e47219e7",
"name":"Иван Иванов",
"phone":"+79001234567",
"email":"driver@example.com",
"extra_phone":123
}
],
"schedule_summary":"пн–пт 09:00–18:00",
"stock_type":0,
"timeslots_binding":{...}
"warehouse_id":1001,
"status":0
}
}
],
"contact_persons":[...],
{...}
"contact_person_id":"2fb965f2-85e9-4213-90e7-f396e47219e7",
"name":"Иван Иванов",
"phone":"+79001234567",
"email":"driver@example.com",
"extra_phone":123
}
],
"ownership_name":"ООО"
}
},
"extra_points":[...],
{...}
"route_point_id":"2fb965f2-85e9-4213-90e7-f396e47219e7",
"id":"2fb965f2-85e9-4213-90e7-f396e47219e7",
"city_id":1,
"point_type":0,
"ordinal_id":1,
"distance":120,
"street":"ул. Ленина, 1",
"latitude":55.7558,
"longitude":37.6173,
"organization_id":"7c9e6679-7425-40de-944b-e07fc1f90ae7",
"address_id":"9c514669-b666-42ea-85e6-312093b93a50",
"loading_date_start":"2024-06-15T00:00:00Z",
"loading_date_end":"2024-06-15T00:00:00Z",
"loading_time_start":"08:00:00",
"loading_time_end":"18:00:00",
"is_round_the_clock":false,
"city_name":"Москва",
"loading_cargos":[...],
{...}
"cargo_id":1,
"name_id":59,
"name":"Щебень",
"packaging_type":1,
"packaging_quantity":10,
"weight":20,
"volume":40,
"sizes":{...},
"length":13.6,
"width":2.45,
"height":2.7,
"diameter":0,
"length_highlight":false,
"width_highlight":false,
"height_highlight":false
},
"packaging_type_name":"коробки"
}
],
"unloading_cargos":[...],
{...}
"cargo_id":1,
"weight":20,
"volume":40,
"packaging_quantity":10,
"is_defined_by_ttn":false
}
],
"organization":{...}
"organization_id":"2fb965f2-85e9-4213-90e7-f396e47219e7",
"firm_id":12345,
"name":"ООО Ромашка",
"ownership":1,
"residency":0,
"inn":7707083893,
"phone":"+79001234567",
"extra_phone":123,
"docs_address":{...},
"postcode":101000,
"city_id":1,
"street_name":"ул. Ленина",
"house_no":1,
"office_no":10
},
"stocks":[...],
{...}
"stock_id":"2fb965f2-85e9-4213-90e7-f396e47219e7",
"address":"ул. Ленина, 1",
"address_city_id":1,
"address_latitude":55.7558,
"address_longitude":37.6173,
"note":"Въезд со двора",
"work_schedules":[...],
{...}
"stock_schedule_id":"2fb965f2-85e9-4213-90e7-f396e47219e7",
"day_of_week":0,
"start_time":"09:00:00",
"end_time":"18:00:00"
}
],
"breaks_schedules":[...],
{...}
"stock_schedule_id":"2fb965f2-85e9-4213-90e7-f396e47219e7",
"day_of_week":0,
"start_time":"09:00:00",
"end_time":"18:00:00"
}
],
"contact_persons":[...],
{...}
"contact_person_id":"2fb965f2-85e9-4213-90e7-f396e47219e7",
"name":"Иван Иванов",
"phone":"+79001234567",
"email":"driver@example.com",
"extra_phone":123
}
],
"schedule_summary":"пн–пт 09:00–18:00",
"stock_type":0,
"timeslots_binding":{...}
"warehouse_id":1001,
"status":0
}
}
],
"contact_persons":[...],
{...}
"contact_person_id":"2fb965f2-85e9-4213-90e7-f396e47219e7",
"name":"Иван Иванов",
"phone":"+79001234567",
"email":"driver@example.com",
"extra_phone":123
}
],
"ownership_name":"ООО"
}
}
],
"unloading":{...},
"fias_id":"2fb965f2-85e9-4213-90e7-f396e47219e7",
"city_id":1,
"latitude":55.7558,
"longitude":37.6173,
"street":"ул. Ленина, 1",
"organization_id":"7c9e6679-7425-40de-944b-e07fc1f90ae7",
"address_id":"9c514669-b666-42ea-85e6-312093b93a50",
"time_start":"1900-01-01T08:00:00Z",
"time_end":"1900-01-01T18:00:00Z",
"is_round_the_clock":false,
"large_cities":[...],
0
],
"large_cities_with_distance":[...],
{...}
"city_id":1,
"distance":15.5
}
],
"loading_cargos":[...],
{...}
"cargo_id":1,
"name_id":59,
"name":"Щебень",
"packaging_type":1,
"packaging_quantity":10,
"weight":20,
"volume":40,
"sizes":{...},
"length":13.6,
"width":2.45,
"height":2.7,
"diameter":0,
"length_highlight":false,
"width_highlight":false,
"height_highlight":false
},
"packaging_type_name":"коробки"
}
],
"organization":{...}
"organization_id":"2fb965f2-85e9-4213-90e7-f396e47219e7",
"firm_id":12345,
"name":"ООО Ромашка",
"ownership":1,
"residency":0,
"inn":7707083893,
"phone":"+79001234567",
"extra_phone":123,
"docs_address":{...},
"postcode":101000,
"city_id":1,
"street_name":"ул. Ленина",
"house_no":1,
"office_no":10
},
"stocks":[...],
{...}
"stock_id":"2fb965f2-85e9-4213-90e7-f396e47219e7",
"address":"ул. Ленина, 1",
"address_city_id":1,
"address_latitude":55.7558,
"address_longitude":37.6173,
"note":"Въезд со двора",
"work_schedules":[...],
{...}
"stock_schedule_id":"2fb965f2-85e9-4213-90e7-f396e47219e7",
"day_of_week":0,
"start_time":"09:00:00",
"end_time":"18:00:00"
}
],
"breaks_schedules":[...],
{...}
"stock_schedule_id":"2fb965f2-85e9-4213-90e7-f396e47219e7",
"day_of_week":0,
"start_time":"09:00:00",
"end_time":"18:00:00"
}
],
"contact_persons":[...],
{...}
"contact_person_id":"2fb965f2-85e9-4213-90e7-f396e47219e7",
"name":"Иван Иванов",
"phone":"+79001234567",
"email":"driver@example.com",
"extra_phone":123
}
],
"schedule_summary":"пн–пт 09:00–18:00",
"stock_type":0,
"timeslots_binding":{...}
"warehouse_id":1001,
"status":0
}
}
],
"contact_persons":[...],
{...}
"contact_person_id":"2fb965f2-85e9-4213-90e7-f396e47219e7",
"name":"Иван Иванов",
"phone":"+79001234567",
"email":"driver@example.com",
"extra_phone":123
}
],
"ownership_name":"ООО"
}
},
"cargo":{...},
"weight":20,
"volume":40,
"adr":0,
"cargo_type_id":1,
"cargo_type":"Щебень",
"pack_type":1,
"pallet_count":11,
"belt_count":6,
"dogruz_type":0,
"sbor_gruz":false,
"size":{...}
"length":13.6,
"width":2.45,
"height":2.7,
"diameter":0,
"length_highlight":false,
"width_highlight":false,
"height_highlight":false
}
},
"transport":{...},
"car_type":200,
"car_type_string":"200",
"loading_type":0,
"loading_logical_operator":"OR",
"unloading_type":0,
"unloading_logical_operator":"OR",
"trucks_quantity":1,
"temperature_from":-18,
"temperature_to":-10,
"truck_attribs":0,
"stsepka":false,
"pnevmohod":false,
"koniki":false,
"tir":false,
"cmr":false,
"t1":false,
"san_passport":false,
"sanitation_logbook":false,
"is_tracking":true,
"required_capacity":20,
"team_driving":false
},
"unload_first_date":"2024-06-17T00:00:00Z",
"unload_last_date":"2024-06-19T00:00:00Z"
},
"is_tracking":true,
"deal_kind":0
}
]
4XX Ошибка запроса. [Подробнее про ошибки API](https://ati.su/developers/documentation/errors/)
Модель
ONE-OF

(nullable)

Пример
{...}
"reason":"Неизвестная ошибка",
"error":"unknown_server_error"
}
  • фиксированная ставка, с возможностью торга - в данном случае грузовладелец озвучивает свой вариант цены, но при этом готов поторговаться. Вы можете отправить встречное предложение с той ставкой, что опубликовал грузовладелец, или предложить свою цену. Метод тот же — создание встречного предложения. Если грузовладельца устроит ваше предложение, он отправит вам приглашение на сделку, которое можно получить методом получения списка приглашений.
Создание встречного предложения
post /gw/cargo-counter-offers-api/integrator/v1/cargos/{cargoId}/counter-offers
Параметры
Параметр Тип Расположение Описание
cargoId обязательный string (guid) path
ID груза Пример: 3fa85f64-5717-4562-b3fc-2c963f66afa6
Запрос
Модель
{...}
contact_id*: int32

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

price: decimal

Предложенная ставка встречного предложения не б/нал.

currency_id: int32

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

nds_price: decimal

Предложенная ставка встречного предложения б/нал с НДС

nds_percent: int32 (nullable)

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

nds_currency_id: int32

Валюта ставки встречного предложения б/нал с НДС. Значение из словаря валют АТИ

not_nds_price: decimal

Предложенная ставка встречного предложения б/нал без НДС

not_nds_currency_id: int32

Валюта ставки встречного предложения б/нал без НДС. Значение из словаря валют АТИ

note: string (nullable)

Примечание к встречному предложению

prepay_percent: int32

Процент предоплаты
Допустимое значение от 0 до 100

pay_after_max_bank_days: int32

Оплата через ... банковских дней\

loading_date: date (nullable)

Дата загрузки

pay_attributes: int32

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

  • 1 - возможна оплата наличными
  • 2 - возможна оплата по безналичному рассчету
  • 4 - блиц
  • 8 - оплата с НДС
  • 16 - возможна предоплата
  • 32 - оплата на выгрузке
  • 64 - включена ли оплата через некоторое количество банковских дней
}
Пример запроса
curl 'https://api.ati.su/gw/cargo-counter-offers-api/integrator/v1/cargos/{cargoId}/counter-offers' \
-X 'POST' \
-H 'Authorization: Bearer {authorizationToken}' \
-H 'Content-Type: application/json' \
--data-raw '{"contact_id":1,"price":100.5,"currency_id":1,"nds_price":100.5,"nds_percent":22,"nds_currency_id":1,"not_nds_price":100.5,"not_nds_currency_id":1,"note":"Примечание","prepay_percent":10,"pay_after_max_bank_days":0,"loading_date":"2024-01-15","pay_attributes":64}'
Ответ
200
Модель
{...}

Встречное предложение

id: guid

Id встречного предложения

cargo_id: guid

Id груза, на который оставлено встречное предложение

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

Номер груза

cargo_firm_id: int32

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

firm_id: int32

Id фирмы, которая оставила встречное предложение

added_at: date-time

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

updated_at: date-time

Дата изменения встречного предложения

price: decimal

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

currency_id: int32

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

nds_price: decimal

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

nds_percent: int32

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

nds_currency_id: int32

Валюта ставки встречного предложения б/нал с НДС. Значение из словаря валют АТИ

not_nds_price: decimal

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

not_nds_currency_id: int32

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

counter_offer_source: int32

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

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

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

pay_attributes: int32

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

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

Процент предоплаты

pay_after_max_bank_days: int32

Оплата через ... банковских дней

loading_date: date

Дата загрузки

is_outdated: boolean

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

is_cargo_published: boolean

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

firm_info:

Информация о фирме, оставившей встречное предложение на груз

ONE-OF
}
Пример
{...}
"id":"3fa85f64-5717-4562-b3fc-2c963f66afa6",
"cargo_id":"3fa85f64-5717-4562-b3fc-2c963f66afa6",
"cargo_number":"CES23786",
"cargo_firm_id":1234,
"firm_id":1234,
"added_at":"2024-01-15T10:30:00+03:00",
"updated_at":"2024-01-15T10:30:00+03:00",
"price":100.5,
"currency_id":1,
"nds_price":100.5,
"nds_percent":22,
"nds_currency_id":1,
"not_nds_price":100.5,
"not_nds_currency_id":1,
"counter_offer_source":2,
"note":"Тестовое примечание",
"pay_attributes":0,
"prepay_percent":0,
"pay_after_max_bank_days":0,
"loading_date":"2024-01-15",
"is_outdated":false,
"is_cargo_published":false,
"firm_info":{...}
"total_score":4.5,
"status":3,
"full_firm_name":"ООО Тест",
"contact":{...},
"id":1,
"name":"Иванов Иван",
"telephone":"+74951234567",
"email":"test@test.ru",
"mobile":"+79001234567",
"mobile_operator":"МТС",
"location":{...}
"city_id":1,
"region_id":1,
"country_id":1,
"full_name":"Москва, Россия",
"short_name":"Москва",
"is_regional_center":true,
"fias_id":"0c5b2444-70a0-4932-980c-b4dc0d3f02b5",
"city_name":"Москва",
"region_name":"Московская область",
"country_name":"Россия",
"country_code":"RU"
}
},
"inn":1234567890
}
}
4XX Ошибка запроса
Модель
{...}
error: string

Код ошибки

reason: string (nullable)

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

}
Пример
{...}
"error":"string",
"reason":"string",
"details":[...]
{...}
"property":"string",
"error":"string",
"reason":"string"
}
]
}
Получение списка приглашений.
get /v1.2/orders/invites/my
Параметры
Параметр Тип Расположение Описание
role integer query
Роль пользователя: `0` — Грузовладелец, `1` — Перевозчик Пример: 1
Запрос
Пример запроса
curl 'https://api.ati.su/v1.2/orders/invites/my' \
-X 'GET' \
-H 'Authorization: Bearer {authorizationToken}' \
-H 'Content-Type: application/json'
Ответ
200 Список приглашений на перевозку груза
Модель
[{...}]

Персональное приглашение.

owner_ati_id: string

Id фирмы грузовладельца.

owner_persistent_user_id: int32

Постоянный Id фирмы грузовладельца.

owner_contact_id: int32 (nullable)

Id контакта, который отправил приглашение.

taker_ati_id: string

Id приглашенной фирмы.

taker_persistent_user_id: int32

Постоянный Id приглашенной фирмы.

taker_contact_id: int32

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

taker_contacts_list: [int32]

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

date: date-time

Время отправки приглашения.

cancellation_date: date-time (nullable)

Время отмены приглашения.

payment:

Предложенные параметры оплаты.

ONE-OF
load:

Параметры предложенного груза.

ONE-OF
is_tracking: boolean

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

deal_kind:

Тип заказа.

ONE-OF
enum
[0, 1, 2, 4, 8, 16, 32, 64, 128, 256]

Тип заказа.

  • 0 — Заказ невозможен
  • 1 — Взятие груза из поиска
  • 2 — Заказ из торгов
  • 4 — Предложение груза
  • 8 — Из перехвата машин
  • 16 — Односторонний заказ
  • 32 — Предложение груза из встречного предложения
  • 64 — Предложение груза по контракту
  • 128 — Создан вручную для тестирования черновиков
  • 256 — Создан из АТИ-Доков
}]
Пример
[...]
{...}
"owner_ati_id":67890,
"owner_persistent_user_id":2002,
"owner_contact_id":200,
"taker_ati_id":12345,
"taker_persistent_user_id":1001,
"taker_contact_id":100,
"taker_contacts_list":[...],
0
],
"date":"2024-06-15T10:30:00Z",
"cancellation_date":"2024-06-16T12:00:00Z",
"payment":{...},
"rates":[...],
{...}
"rate":45000,
"rate_type":0,
"currency":1,
"vat_percent":22
}
],
"prepay_percent":30,
"prepay_percent_enabled":true,
"on_unloading":false,
"in_fuel":false,
"pay_days_enabled":true,
"pay_days":5,
"fixed_rate":true,
"torg":false,
"direct_contract":true,
"payment_source":0
},
"load":{...},
"id":"2fb965f2-85e9-4213-90e7-f396e47219e7",
"load_number":"ATI00012345",
"distance":720,
"distance_type":1,
"platon_roads_length":120,
"toll_roads_length":80,
"travel_time":"08:30:00",
"true_price":80000,
"true_currency_id":1,
"note":"Тент, боковая загрузка",
"first_date":"2024-06-16T00:00:00Z",
"last_date":"2024-06-18T00:00:00Z",
"date_type":0,
"periodicity_id":0,
"order_number":"ЗН-15",
"krugoreis":false,
"zimnik":false,
"ferries":false,
"loading":{...},
"fias_id":"2fb965f2-85e9-4213-90e7-f396e47219e7",
"city_id":1,
"latitude":55.7558,
"longitude":37.6173,
"street":"ул. Ленина, 1",
"organization_id":"7c9e6679-7425-40de-944b-e07fc1f90ae7",
"address_id":"9c514669-b666-42ea-85e6-312093b93a50",
"time_start":"1900-01-01T08:00:00Z",
"time_end":"1900-01-01T18:00:00Z",
"is_round_the_clock":false,
"large_cities":[...],
0
],
"large_cities_with_distance":[...],
{...}
"city_id":1,
"distance":15.5
}
],
"loading_cargos":[...],
{...}
"cargo_id":1,
"name_id":59,
"name":"Щебень",
"packaging_type":1,
"packaging_quantity":10,
"weight":20,
"volume":40,
"sizes":{...},
"length":13.6,
"width":2.45,
"height":2.7,
"diameter":0,
"length_highlight":false,
"width_highlight":false,
"height_highlight":false
},
"packaging_type_name":"коробки"
}
],
"organization":{...}
"organization_id":"2fb965f2-85e9-4213-90e7-f396e47219e7",
"firm_id":12345,
"name":"ООО Ромашка",
"ownership":1,
"residency":0,
"inn":7707083893,
"phone":"+79001234567",
"extra_phone":123,
"docs_address":{...},
"postcode":101000,
"city_id":1,
"street_name":"ул. Ленина",
"house_no":1,
"office_no":10
},
"stocks":[...],
{...}
"stock_id":"2fb965f2-85e9-4213-90e7-f396e47219e7",
"address":"ул. Ленина, 1",
"address_city_id":1,
"address_latitude":55.7558,
"address_longitude":37.6173,
"note":"Въезд со двора",
"work_schedules":[...],
{...}
"stock_schedule_id":"2fb965f2-85e9-4213-90e7-f396e47219e7",
"day_of_week":0,
"start_time":"09:00:00",
"end_time":"18:00:00"
}
],
"breaks_schedules":[...],
{...}
"stock_schedule_id":"2fb965f2-85e9-4213-90e7-f396e47219e7",
"day_of_week":0,
"start_time":"09:00:00",
"end_time":"18:00:00"
}
],
"contact_persons":[...],
{...}
"contact_person_id":"2fb965f2-85e9-4213-90e7-f396e47219e7",
"name":"Иван Иванов",
"phone":"+79001234567",
"email":"driver@example.com",
"extra_phone":123
}
],
"schedule_summary":"пн–пт 09:00–18:00",
"stock_type":0,
"timeslots_binding":{...}
"warehouse_id":1001,
"status":0
}
}
],
"contact_persons":[...],
{...}
"contact_person_id":"2fb965f2-85e9-4213-90e7-f396e47219e7",
"name":"Иван Иванов",
"phone":"+79001234567",
"email":"driver@example.com",
"extra_phone":123
}
],
"ownership_name":"ООО"
}
},
"extra_points":[...],
{...}
"route_point_id":"2fb965f2-85e9-4213-90e7-f396e47219e7",
"id":"2fb965f2-85e9-4213-90e7-f396e47219e7",
"city_id":1,
"point_type":0,
"ordinal_id":1,
"distance":120,
"street":"ул. Ленина, 1",
"latitude":55.7558,
"longitude":37.6173,
"organization_id":"7c9e6679-7425-40de-944b-e07fc1f90ae7",
"address_id":"9c514669-b666-42ea-85e6-312093b93a50",
"loading_date_start":"2024-06-15T00:00:00Z",
"loading_date_end":"2024-06-15T00:00:00Z",
"loading_time_start":"08:00:00",
"loading_time_end":"18:00:00",
"is_round_the_clock":false,
"city_name":"Москва",
"loading_cargos":[...],
{...}
"cargo_id":1,
"name_id":59,
"name":"Щебень",
"packaging_type":1,
"packaging_quantity":10,
"weight":20,
"volume":40,
"sizes":{...},
"length":13.6,
"width":2.45,
"height":2.7,
"diameter":0,
"length_highlight":false,
"width_highlight":false,
"height_highlight":false
},
"packaging_type_name":"коробки"
}
],
"unloading_cargos":[...],
{...}
"cargo_id":1,
"weight":20,
"volume":40,
"packaging_quantity":10,
"is_defined_by_ttn":false
}
],
"organization":{...}
"organization_id":"2fb965f2-85e9-4213-90e7-f396e47219e7",
"firm_id":12345,
"name":"ООО Ромашка",
"ownership":1,
"residency":0,
"inn":7707083893,
"phone":"+79001234567",
"extra_phone":123,
"docs_address":{...},
"postcode":101000,
"city_id":1,
"street_name":"ул. Ленина",
"house_no":1,
"office_no":10
},
"stocks":[...],
{...}
"stock_id":"2fb965f2-85e9-4213-90e7-f396e47219e7",
"address":"ул. Ленина, 1",
"address_city_id":1,
"address_latitude":55.7558,
"address_longitude":37.6173,
"note":"Въезд со двора",
"work_schedules":[...],
{...}
"stock_schedule_id":"2fb965f2-85e9-4213-90e7-f396e47219e7",
"day_of_week":0,
"start_time":"09:00:00",
"end_time":"18:00:00"
}
],
"breaks_schedules":[...],
{...}
"stock_schedule_id":"2fb965f2-85e9-4213-90e7-f396e47219e7",
"day_of_week":0,
"start_time":"09:00:00",
"end_time":"18:00:00"
}
],
"contact_persons":[...],
{...}
"contact_person_id":"2fb965f2-85e9-4213-90e7-f396e47219e7",
"name":"Иван Иванов",
"phone":"+79001234567",
"email":"driver@example.com",
"extra_phone":123
}
],
"schedule_summary":"пн–пт 09:00–18:00",
"stock_type":0,
"timeslots_binding":{...}
"warehouse_id":1001,
"status":0
}
}
],
"contact_persons":[...],
{...}
"contact_person_id":"2fb965f2-85e9-4213-90e7-f396e47219e7",
"name":"Иван Иванов",
"phone":"+79001234567",
"email":"driver@example.com",
"extra_phone":123
}
],
"ownership_name":"ООО"
}
}
],
"unloading":{...},
"fias_id":"2fb965f2-85e9-4213-90e7-f396e47219e7",
"city_id":1,
"latitude":55.7558,
"longitude":37.6173,
"street":"ул. Ленина, 1",
"organization_id":"7c9e6679-7425-40de-944b-e07fc1f90ae7",
"address_id":"9c514669-b666-42ea-85e6-312093b93a50",
"time_start":"1900-01-01T08:00:00Z",
"time_end":"1900-01-01T18:00:00Z",
"is_round_the_clock":false,
"large_cities":[...],
0
],
"large_cities_with_distance":[...],
{...}
"city_id":1,
"distance":15.5
}
],
"loading_cargos":[...],
{...}
"cargo_id":1,
"name_id":59,
"name":"Щебень",
"packaging_type":1,
"packaging_quantity":10,
"weight":20,
"volume":40,
"sizes":{...},
"length":13.6,
"width":2.45,
"height":2.7,
"diameter":0,
"length_highlight":false,
"width_highlight":false,
"height_highlight":false
},
"packaging_type_name":"коробки"
}
],
"organization":{...}
"organization_id":"2fb965f2-85e9-4213-90e7-f396e47219e7",
"firm_id":12345,
"name":"ООО Ромашка",
"ownership":1,
"residency":0,
"inn":7707083893,
"phone":"+79001234567",
"extra_phone":123,
"docs_address":{...},
"postcode":101000,
"city_id":1,
"street_name":"ул. Ленина",
"house_no":1,
"office_no":10
},
"stocks":[...],
{...}
"stock_id":"2fb965f2-85e9-4213-90e7-f396e47219e7",
"address":"ул. Ленина, 1",
"address_city_id":1,
"address_latitude":55.7558,
"address_longitude":37.6173,
"note":"Въезд со двора",
"work_schedules":[...],
{...}
"stock_schedule_id":"2fb965f2-85e9-4213-90e7-f396e47219e7",
"day_of_week":0,
"start_time":"09:00:00",
"end_time":"18:00:00"
}
],
"breaks_schedules":[...],
{...}
"stock_schedule_id":"2fb965f2-85e9-4213-90e7-f396e47219e7",
"day_of_week":0,
"start_time":"09:00:00",
"end_time":"18:00:00"
}
],
"contact_persons":[...],
{...}
"contact_person_id":"2fb965f2-85e9-4213-90e7-f396e47219e7",
"name":"Иван Иванов",
"phone":"+79001234567",
"email":"driver@example.com",
"extra_phone":123
}
],
"schedule_summary":"пн–пт 09:00–18:00",
"stock_type":0,
"timeslots_binding":{...}
"warehouse_id":1001,
"status":0
}
}
],
"contact_persons":[...],
{...}
"contact_person_id":"2fb965f2-85e9-4213-90e7-f396e47219e7",
"name":"Иван Иванов",
"phone":"+79001234567",
"email":"driver@example.com",
"extra_phone":123
}
],
"ownership_name":"ООО"
}
},
"cargo":{...},
"weight":20,
"volume":40,
"adr":0,
"cargo_type_id":1,
"cargo_type":"Щебень",
"pack_type":1,
"pallet_count":11,
"belt_count":6,
"dogruz_type":0,
"sbor_gruz":false,
"size":{...}
"length":13.6,
"width":2.45,
"height":2.7,
"diameter":0,
"length_highlight":false,
"width_highlight":false,
"height_highlight":false
}
},
"transport":{...},
"car_type":200,
"car_type_string":"200",
"loading_type":0,
"loading_logical_operator":"OR",
"unloading_type":0,
"unloading_logical_operator":"OR",
"trucks_quantity":1,
"temperature_from":-18,
"temperature_to":-10,
"truck_attribs":0,
"stsepka":false,
"pnevmohod":false,
"koniki":false,
"tir":false,
"cmr":false,
"t1":false,
"san_passport":false,
"sanitation_logbook":false,
"is_tracking":true,
"required_capacity":20,
"team_driving":false
},
"unload_first_date":"2024-06-17T00:00:00Z",
"unload_last_date":"2024-06-19T00:00:00Z"
},
"is_tracking":true,
"deal_kind":0
}
]
4XX Ошибка запроса. [Подробнее про ошибки API](https://ati.su/developers/documentation/errors/)
Модель
ONE-OF

(nullable)

Пример
{...}
"reason":"Неизвестная ошибка",
"error":"unknown_server_error"
}
  • фиксированная ставка, без возможности торга - в данном случае грузовладелец озвучивает конкретную цену за перевозку его груза. Если цена вас устраивает, то вы можете забронировать груз и отправить грузовладельцу все данные для оформления сделки с помощью метода “взять груз”. Грузовладелец, рассмотрев ваше предложение, может либо оформить сделку, если его все устроит, либо отказать вам в сделке.
Взятие груза / Редактирование заказа. Взятие груза возможно в том случае, если пользователь является победителем торгов (аукциона), получил приглашение от грузовладельца или состоит на площадке, где опубликован груз.
post /v1.2/orders/takeload/{loadId}
Параметры
Параметр Тип Расположение Описание
loadId обязательный string (guid) path
Id груза Пример: 2fb965f2-85e9-4213-90e7-f396e47219e7
Запрос
Модель
ONE-OF

(nullable)

Пример запроса
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,"vat_percent":7,"driver_id":"2fb965f2-85e9-4213-90e7-f396e47219e7","truck_info_id":"2fb965f2-85e9-4213-90e7-f396e47219e7","semitrailer_id":"2fb965f2-85e9-4213-90e7-f396e47219e7","trailer_id":"2fb965f2-85e9-4213-90e7-f396e47219e7","requisites_id":"2fb965f2-85e9-4213-90e7-f396e47219e7","signer_id":"2fb965f2-85e9-4213-90e7-f396e47219e7","is_drop_docs":false,"deal_kind":0,"taker_note":"Комментарий"}'
Ответ
200 Успешное взятие/редактирование
Модель
{...}

Заказ с копией груза.

load_copy:

Копия груза.
При создании заказа груз копируется, копия не отображается в поиске и её невозможно отредактировать

ONE-OF
deal:

Заказ.

Основная информация о заказе

ONE-OF

(nullable)

}
Пример
{...}
"load_copy":{...},
"id":"2fb965f2-85e9-4213-90e7-f396e47219e7",
"load_number":"ATI00012345",
"load_meta":{...},
"load_meta_id":"2fb965f2-85e9-4213-90e7-f396e47219e7",
"meta_data":{}
},
"auction_id":"7c9e6679-7425-40de-944b-e07fc1f90ae7",
"updated_at":"2024-06-15T10:30:00Z",
"added_at":"2024-06-14T09:00:00Z",
"archive_date":"2024-06-15T12:00:00Z",
"distance":720,
"distance_type":1,
"platon_roads_length":120,
"toll_roads_length":80,
"travel_time":"08:30:00",
"true_price":80000,
"true_currency_id":1,
"parent_id":"9c514669-b666-42ea-85e6-312093b93a50",
"is_unpublished":true,
"firm_id":12345,
"contact_id1":100,
"contact_id2":101,
"note":"Тент, боковая загрузка",
"first_date":"2024-06-16T00:00:00Z",
"last_date":"2024-06-18T00:00:00Z",
"date_type":0,
"periodicity_id":0,
"order_number":"ЗН-15",
"krugoreis":false,
"zimnik":false,
"ferries":false,
"loading":{...},
"fias_id":"2fb965f2-85e9-4213-90e7-f396e47219e7",
"city_id":1,
"latitude":55.7558,
"longitude":37.6173,
"street":"ул. Ленина, 1",
"organization_id":"7c9e6679-7425-40de-944b-e07fc1f90ae7",
"address_id":"9c514669-b666-42ea-85e6-312093b93a50",
"time_start":"2024-06-15T08:00:00Z",
"time_end":"2024-06-15T18:00:00Z",
"is_round_the_clock":false,
"large_cities":[...],
0
],
"large_cities_with_distance":[...],
{...}
"city_id":1,
"distance":15.5
}
],
"loading_cargos":[...],
{...}
"cargo_id":1,
"name_id":59,
"name":"Щебень",
"packaging_type":1,
"packaging_quantity":10,
"weight":20,
"volume":40,
"sizes":{...},
"length":13.6,
"width":2.45,
"height":2.7,
"diameter":0,
"length_highlight":false,
"width_highlight":false,
"height_highlight":false
},
"packaging_type_name":"коробки"
}
],
"organization":{...}
"organization_id":"2fb965f2-85e9-4213-90e7-f396e47219e7",
"firm_id":12345,
"name":"ООО Ромашка",
"ownership":1,
"residency":0,
"inn":7707083893,
"phone":"+79001234567",
"extra_phone":123,
"docs_address":{...},
"postcode":101000,
"city_id":1,
"street_name":"ул. Ленина",
"house_no":1,
"office_no":10
},
"stocks":[...],
{...}
"stock_id":"2fb965f2-85e9-4213-90e7-f396e47219e7",
"address":"ул. Ленина, 1",
"address_city_id":1,
"address_latitude":55.7558,
"address_longitude":37.6173,
"note":"Въезд со двора",
"work_schedules":[...],
{...}
"stock_schedule_id":"2fb965f2-85e9-4213-90e7-f396e47219e7",
"day_of_week":0,
"start_time":"09:00:00",
"end_time":"18:00:00"
}
],
"breaks_schedules":[...],
{...}
"stock_schedule_id":"2fb965f2-85e9-4213-90e7-f396e47219e7",
"day_of_week":0,
"start_time":"09:00:00",
"end_time":"18:00:00"
}
],
"contact_persons":[...],
{...}
"contact_person_id":"2fb965f2-85e9-4213-90e7-f396e47219e7",
"name":"Иван Иванов",
"phone":"+79001234567",
"email":"driver@example.com",
"extra_phone":123
}
],
"schedule_summary":"пн–пт 09:00–18:00",
"stock_type":0,
"timeslots_binding":{...}
"warehouse_id":1001,
"status":0
}
}
],
"contact_persons":[...],
{...}
"contact_person_id":"2fb965f2-85e9-4213-90e7-f396e47219e7",
"name":"Иван Иванов",
"phone":"+79001234567",
"email":"driver@example.com",
"extra_phone":123
}
],
"ownership_name":"ООО"
}
},
"extra_points":[...],
{...}
"route_point_id":"2fb965f2-85e9-4213-90e7-f396e47219e7",
"id":"2fb965f2-85e9-4213-90e7-f396e47219e7",
"city_id":1,
"point_type":0,
"ordinal_id":1,
"distance":120,
"street":"ул. Ленина, 1",
"latitude":55.7558,
"longitude":37.6173,
"organization_id":"7c9e6679-7425-40de-944b-e07fc1f90ae7",
"address_id":"9c514669-b666-42ea-85e6-312093b93a50",
"loading_date_start":"2024-06-15T00:00:00Z",
"loading_date_end":"2024-06-15T00:00:00Z",
"loading_time_start":"08:00:00",
"loading_time_end":"18:00:00",
"is_round_the_clock":false,
"city_name":"Москва",
"loading_cargos":[...],
{...}
"cargo_id":1,
"name_id":59,
"name":"Щебень",
"packaging_type":1,
"packaging_quantity":10,
"weight":20,
"volume":40,
"sizes":{...},
"length":13.6,
"width":2.45,
"height":2.7,
"diameter":0,
"length_highlight":false,
"width_highlight":false,
"height_highlight":false
},
"packaging_type_name":"коробки"
}
],
"unloading_cargos":[...],
{...}
"cargo_id":1,
"weight":20,
"volume":40,
"packaging_quantity":10,
"is_defined_by_ttn":false
}
],
"organization":{...}
"organization_id":"2fb965f2-85e9-4213-90e7-f396e47219e7",
"firm_id":12345,
"name":"ООО Ромашка",
"ownership":1,
"residency":0,
"inn":7707083893,
"phone":"+79001234567",
"extra_phone":123,
"docs_address":{...},
"postcode":101000,
"city_id":1,
"street_name":"ул. Ленина",
"house_no":1,
"office_no":10
},
"stocks":[...],
{...}
"stock_id":"2fb965f2-85e9-4213-90e7-f396e47219e7",
"address":"ул. Ленина, 1",
"address_city_id":1,
"address_latitude":55.7558,
"address_longitude":37.6173,
"note":"Въезд со двора",
"work_schedules":[...],
{...}
"stock_schedule_id":"2fb965f2-85e9-4213-90e7-f396e47219e7",
"day_of_week":0,
"start_time":"09:00:00",
"end_time":"18:00:00"
}
],
"breaks_schedules":[...],
{...}
"stock_schedule_id":"2fb965f2-85e9-4213-90e7-f396e47219e7",
"day_of_week":0,
"start_time":"09:00:00",
"end_time":"18:00:00"
}
],
"contact_persons":[...],
{...}
"contact_person_id":"2fb965f2-85e9-4213-90e7-f396e47219e7",
"name":"Иван Иванов",
"phone":"+79001234567",
"email":"driver@example.com",
"extra_phone":123
}
],
"schedule_summary":"пн–пт 09:00–18:00",
"stock_type":0,
"timeslots_binding":{...}
"warehouse_id":1001,
"status":0
}
}
],
"contact_persons":[...],
{...}
"contact_person_id":"2fb965f2-85e9-4213-90e7-f396e47219e7",
"name":"Иван Иванов",
"phone":"+79001234567",
"email":"driver@example.com",
"extra_phone":123
}
],
"ownership_name":"ООО"
}
}
],
"unloading":{...},
"fias_id":"2fb965f2-85e9-4213-90e7-f396e47219e7",
"city_id":1,
"latitude":55.7558,
"longitude":37.6173,
"street":"ул. Ленина, 1",
"organization_id":"7c9e6679-7425-40de-944b-e07fc1f90ae7",
"address_id":"9c514669-b666-42ea-85e6-312093b93a50",
"time_start":"2024-06-15T08:00:00Z",
"time_end":"2024-06-15T18:00:00Z",
"is_round_the_clock":false,
"large_cities":[...],
0
],
"large_cities_with_distance":[...],
{...}
"city_id":1,
"distance":15.5
}
],
"loading_cargos":[...],
{...}
"cargo_id":1,
"name_id":59,
"name":"Щебень",
"packaging_type":1,
"packaging_quantity":10,
"weight":20,
"volume":40,
"sizes":{...},
"length":13.6,
"width":2.45,
"height":2.7,
"diameter":0,
"length_highlight":false,
"width_highlight":false,
"height_highlight":false
},
"packaging_type_name":"коробки"
}
],
"organization":{...}
"organization_id":"2fb965f2-85e9-4213-90e7-f396e47219e7",
"firm_id":12345,
"name":"ООО Ромашка",
"ownership":1,
"residency":0,
"inn":7707083893,
"phone":"+79001234567",
"extra_phone":123,
"docs_address":{...},
"postcode":101000,
"city_id":1,
"street_name":"ул. Ленина",
"house_no":1,
"office_no":10
},
"stocks":[...],
{...}
"stock_id":"2fb965f2-85e9-4213-90e7-f396e47219e7",
"address":"ул. Ленина, 1",
"address_city_id":1,
"address_latitude":55.7558,
"address_longitude":37.6173,
"note":"Въезд со двора",
"work_schedules":[...],
{...}
"stock_schedule_id":"2fb965f2-85e9-4213-90e7-f396e47219e7",
"day_of_week":0,
"start_time":"09:00:00",
"end_time":"18:00:00"
}
],
"breaks_schedules":[...],
{...}
"stock_schedule_id":"2fb965f2-85e9-4213-90e7-f396e47219e7",
"day_of_week":0,
"start_time":"09:00:00",
"end_time":"18:00:00"
}
],
"contact_persons":[...],
{...}
"contact_person_id":"2fb965f2-85e9-4213-90e7-f396e47219e7",
"name":"Иван Иванов",
"phone":"+79001234567",
"email":"driver@example.com",
"extra_phone":123
}
],
"schedule_summary":"пн–пт 09:00–18:00",
"stock_type":0,
"timeslots_binding":{...}
"warehouse_id":1001,
"status":0
}
}
],
"contact_persons":[...],
{...}
"contact_person_id":"2fb965f2-85e9-4213-90e7-f396e47219e7",
"name":"Иван Иванов",
"phone":"+79001234567",
"email":"driver@example.com",
"extra_phone":123
}
],
"ownership_name":"ООО"
}
},
"cargo":{...},
"weight":20,
"volume":40,
"adr":0,
"cargo_type_id":1,
"cargo_type":"Щебень",
"pack_type":1,
"pallet_count":11,
"belt_count":6,
"dogruz_type":0,
"sbor_gruz":false,
"size":{...}
"length":13.6,
"width":2.45,
"height":2.7,
"diameter":0,
"length_highlight":false,
"width_highlight":false,
"height_highlight":false
}
},
"transport":{...},
"car_type":200,
"car_type_string":"тентованный, рефрижератор",
"loading_type":0,
"loading_logical_operator":"OR",
"unloading_type":0,
"unloading_logical_operator":"OR",
"trucks_quantity":1,
"temperature_from":-18,
"temperature_to":-10,
"truck_attribs":0,
"stsepka":false,
"pnevmohod":false,
"koniki":false,
"tir":false,
"cmr":false,
"t1":false,
"san_passport":false,
"sanitation_logbook":false,
"is_tracking":true,
"required_capacity":20,
"team_driving":false
},
"boards":[...],
{...}
"board_id":"ati",
"name":"АТИ",
"color":"#FF6600"
}
],
"unload_first_date":"2024-06-17T00:00:00Z",
"unload_last_date":"2024-06-19T00:00:00Z"
},
"deal":{...}
"deal_id":"2fb965f2-85e9-4213-90e7-f396e47219e7",
"load_copy_id":"7c9e6679-7425-40de-944b-e07fc1f90ae7",
"load_id":"9c514669-b666-42ea-85e6-312093b93a50",
"taker_ati_id":12345,
"taker_persistent_user_id":1001,
"taker_contact_id":100,
"cargo_owner_ati_id":67890,
"cargo_owner_persistent_user_id":2002,
"updated_at":"2024-06-15T10:30:00Z",
"end_of_reservation":"2024-06-16T18:00:00Z",
"auction_id":"6ba7b810-9dad-11d1-80b4-00c04fd430c8",
"status":0,
"counterparty_status":0,
"payment":{...},
"rates":[...],
{...}
"rate":45000,
"rate_type":0,
"currency":1,
"active":true,
"vat_percent":22
}
],
"prepay_percent":30,
"prepay_percent_enabled":true,
"on_unloading":false,
"in_fuel":false,
"pay_days_enabled":true,
"pay_days":5,
"fixed_rate":true,
"torg":false,
"direct_contract":true,
"money_type":1
},
"pay_docs":{...},
"documents_copies":{...},
"checked":true,
"date":"2024-06-15T10:30:00Z"
},
"documents_original":{...},
"checked":true,
"date":"2024-06-15T10:30:00Z"
},
"documents_original_track":{...},
"transport_company_id":100,
"tracking_url":"https://files.ati.su/example",
"tracking_number":"RD123456789RU",
"sending_date":"2024-06-15T10:30:00Z"
},
"payment":{...}
"checked":true,
"date":"2024-06-15T10:30:00Z"
}
},
"files":[...],
{...}
"id":"2fb965f2-85e9-4213-90e7-f396e47219e7",
"storage_file_id":"file-abc-123",
"access":0,
"add_date":"2024-06-15T10:30:00Z",
"deal_id":"2fb965f2-85e9-4213-90e7-f396e47219e7",
"is_counterparty_file":false,
"file_name":"Накладная.pdf",
"size":102400,
"link":"https://files.ati.su/example",
"file_id":"file-abc-123",
"source_type":0,
"source_file_type":0,
"file_type":0,
"timeslots_warehouse_ids":[...]
0
]
}
],
"document_templates":[...],
{...}
"organization_address":"ул. Ленина, 1",
"templates":[...]
{...}
"add_date":"2024-06-15T10:30:00Z",
"access":0,
"timeslots_warehouse_ids":[...],
0
],
"deal_id":"2fb965f2-85e9-4213-90e7-f396e47219e7",
"deal_point_id":"2fb965f2-85e9-4213-90e7-f396e47219e7",
"owner_firm_id":12345,
"cargoes_ids_hash":0,
"contact_id":100,
"file_name":"Заявка.pdf",
"file_id":"file-abc-123",
"id":"7c9e6679-7425-40de-944b-e07fc1f90ae7",
"size":102400,
"link":"https://files.ati.su/example"
}
]
}
],
"customer":{...},
"ati_id":12345,
"source":0,
"name":"ООО Ромашка",
"ownership_id":1,
"inn":7707083893,
"ogrn":1027700132195,
"requisite":{...},
"name":"Основной счёт",
"bank":"ПАО Сбербанк",
"ks":30101810400000000000,
"registration_number":1481,
"rs":40702810938000000000,
"bik":9611925
},
"gen_director":{...},
"name":"Иван",
"surname":"Иванов",
"patronymic":"Иванович",
"number_phone":"+79001234567"
},
"contact":{...},
"name":"Иван",
"surname":"Иванов",
"patronymic":"Иванович",
"number_phone":"+79001234567",
"phone":"+74951234567",
"messenger_phone":"+79007654321",
"fax":"+74957654321",
"was_modified":false,
"selected_number":{...},
"value":"+79001234567",
"country_code":"RU"
},
"is_confirmed":true
},
"address":[...],
{...}
"is_legal":true,
"post_index":101000,
"city_id":1,
"street_name":"ул. Ленина",
"house":1,
"entrance":2,
"litera":"А",
"office_no":10,
"recipient_full_name":"Иван Иванов",
"comment":"Комментарий",
"region_id":1
}
],
"claims_count":3,
"recommendation_count":12,
"bad_partner_firms_count":2
},
"is_tracking":true,
"should_show_rate_to_driver":true,
"started_at":"2024-06-15T08:00:00Z",
"finished_at":"2024-06-20T18:00:00Z",
"denial_reason":"Грузовладелец отклонил заказ",
"taker_requisites":{...},
"requisite_id":"2fb965f2-85e9-4213-90e7-f396e47219e7",
"requisite_firm_name":"ООО Ромашка",
"signer_id":"7c9e6679-7425-40de-944b-e07fc1f90ae7",
"own_ship_id":1,
"inn":7707083893,
"kpp":770701001,
"requisite_type_id":1
},
"driver":{...},
"driver_id":"2fb965f2-85e9-4213-90e7-f396e47219e7",
"parent_id":"7c9e6679-7425-40de-944b-e07fc1f90ae7",
"first_name":"Иван",
"second_name":"Иванов",
"patronymic":"Иванович",
"phone_number":"+79001234567",
"driver_license_number":"77АА123456",
"driver_license_when_issued":"2018-04-12T00:00:00Z",
"passport_series":4510,
"passport_number":123456,
"passport_issued_by":"ОВД г. Москвы",
"passport_when_issued":"2015-06-15T00:00:00Z",
"registration":"г. Москва",
"is_attracted_driver":false,
"last_deal_related_id":"9c514669-b666-42ea-85e6-312093b93a50",
"description":"Опыт 10 лет",
"attracted_from":"ООО Ромашка",
"scans":[...],
{...}
"id":"2fb965f2-85e9-4213-90e7-f396e47219e7",
"owner_id":"7c9e6679-7425-40de-944b-e07fc1f90ae7",
"name":"ПТС.pdf",
"file_id":"file-abc-123",
"type":0
}
],
"origin":0,
"date_of_birth":"1985-03-20T00:00:00Z",
"department_code_in_passport":"770-001",
"driver_inn":7707083893,
"in_cargo_owner_black_list":false,
"external_id":"ext-driver-1",
"black_list_reasons":[...]
"string"
]
},
"truck":{...},
"truck_id":"2fb965f2-85e9-4213-90e7-f396e47219e7",
"parent_id":"7c9e6679-7425-40de-944b-e07fc1f90ae7",
"last_deal_related_id":"9c514669-b666-42ea-85e6-312093b93a50",
"type":0,
"description":"Тент 82 м³",
"brand_id":1,
"model":"Actros",
"number":"А123ВС77",
"phone_number":"+79001234567",
"is_attracted_truck":false,
"ownership_type":0,
"car_type_id":200,
"capacity":20,
"volume":82,
"length":13.6,
"width":2.45,
"height":2.7,
"manufacture_year":2020,
"vin":"WDB9340321L123456",
"vrc":"77АА123456",
"body_number":123456,
"dimension":40,
"truck_passport_number":"77ТТ123456",
"can_refrigerator":false,
"has_gen_set":false,
"truck_owner_name":"ООО Ромашка",
"can_carry_heavy_container":false,
"can_carry_tall_container":false,
"external_id":"ext-truck-1",
"verified":true,
"modification_restricted":false,
"scans":[...],
{...}
"id":"2fb965f2-85e9-4213-90e7-f396e47219e7",
"owner_id":"7c9e6679-7425-40de-944b-e07fc1f90ae7",
"name":"ПТС.pdf",
"file_id":"file-abc-123",
"type":0
}
],
"origin":0
},
"trailer":{...},
"truck_id":"2fb965f2-85e9-4213-90e7-f396e47219e7",
"parent_id":"7c9e6679-7425-40de-944b-e07fc1f90ae7",
"last_deal_related_id":"9c514669-b666-42ea-85e6-312093b93a50",
"type":0,
"description":"Тент 82 м³",
"brand_id":1,
"model":"Actros",
"number":"А123ВС77",
"phone_number":"+79001234567",
"is_attracted_truck":false,
"ownership_type":0,
"car_type_id":200,
"capacity":20,
"volume":82,
"length":13.6,
"width":2.45,
"height":2.7,
"manufacture_year":2020,
"vin":"WDB9340321L123456",
"vrc":"77АА123456",
"body_number":123456,
"dimension":40,
"truck_passport_number":"77ТТ123456",
"can_refrigerator":false,
"has_gen_set":false,
"truck_owner_name":"ООО Ромашка",
"can_carry_heavy_container":false,
"can_carry_tall_container":false,
"external_id":"ext-truck-1",
"verified":true,
"modification_restricted":false,
"scans":[...],
{...}
"id":"2fb965f2-85e9-4213-90e7-f396e47219e7",
"owner_id":"7c9e6679-7425-40de-944b-e07fc1f90ae7",
"name":"ПТС.pdf",
"file_id":"file-abc-123",
"type":0
}
],
"origin":0
},
"semi_trailer":{...},
"truck_id":"2fb965f2-85e9-4213-90e7-f396e47219e7",
"parent_id":"7c9e6679-7425-40de-944b-e07fc1f90ae7",
"last_deal_related_id":"9c514669-b666-42ea-85e6-312093b93a50",
"type":0,
"description":"Тент 82 м³",
"brand_id":1,
"model":"Actros",
"number":"А123ВС77",
"phone_number":"+79001234567",
"is_attracted_truck":false,
"ownership_type":0,
"car_type_id":200,
"capacity":20,
"volume":82,
"length":13.6,
"width":2.45,
"height":2.7,
"manufacture_year":2020,
"vin":"WDB9340321L123456",
"vrc":"77АА123456",
"body_number":123456,
"dimension":40,
"truck_passport_number":"77ТТ123456",
"can_refrigerator":false,
"has_gen_set":false,
"truck_owner_name":"ООО Ромашка",
"can_carry_heavy_container":false,
"can_carry_tall_container":false,
"external_id":"ext-truck-1",
"verified":true,
"modification_restricted":false,
"scans":[...],
{...}
"id":"2fb965f2-85e9-4213-90e7-f396e47219e7",
"owner_id":"7c9e6679-7425-40de-944b-e07fc1f90ae7",
"name":"ПТС.pdf",
"file_id":"file-abc-123",
"type":0
}
],
"origin":0
},
"document":{...},
"id":"2fb965f2-85e9-4213-90e7-f396e47219e7",
"old_id":"7c9e6679-7425-40de-944b-e07fc1f90ae7",
"editor":12345,
"url":"https://files.ati.su/example",
"old_url":"https://files.ati.su/example",
"name":"Заявка",
"is_signed":true,
"access":0
},
"additional_documents":[...],
{...}
"id":"2fb965f2-85e9-4213-90e7-f396e47219e7",
"is_counterparty_file":false,
"url":"https://files.ati.su/example",
"name":"Акт.pdf",
"is_signed":true,
"document_type":0,
"access":0
}
],
"in_work_status_model":0,
"in_work":{...},
"deal_id":"2fb965f2-85e9-4213-90e7-f396e47219e7",
"in_work_status":0,
"in_work_date":"2024-06-15T10:30:00Z",
"ati_id":12345,
"contact_id":100,
"tracker_phone":79001234567
},
"deal_note":"Просим уточнить время загрузки",
"deal_kind":0,
"points":[...]
{...}
"deal_point_id":"2fb965f2-85e9-4213-90e7-f396e47219e7",
"ordinal_id":1,
"point_type":0,
"city_id":1,
"lat":55.75,
"lon":37.62,
"address":"ул. Ленина, 1",
"participant_name":"ООО Ромашка",
"region_id":1,
"contact_name":"Иван Иванов",
"organization_id":"2fb965f2-85e9-4213-90e7-f396e47219e7",
"stock_id":"2fb965f2-85e9-4213-90e7-f396e47219e7",
"stock":{...},
"stock_id":"2fb965f2-85e9-4213-90e7-f396e47219e7",
"address":"ул. Ленина, 1",
"address_city_id":1,
"note":"Въезд со двора",
"contact_persons":[...],
{...}
"contact_person_id":"2fb965f2-85e9-4213-90e7-f396e47219e7",
"name":"Иван Иванов",
"phone":"+79001234567",
"email":"driver@example.com"
}
],
"schedule_summary":"пн–пт 09:00–18:00",
"stock_type":0,
"timeslots_warehouse_id":1001
},
"organization":{...}
"organization_id":"2fb965f2-85e9-4213-90e7-f396e47219e7",
"name":"ООО Ромашка",
"phone":"+79001234567",
"contact_persons":[...]
{...}
"contact_person_id":"2fb965f2-85e9-4213-90e7-f396e47219e7",
"name":"Иван Иванов",
"phone":"+79001234567",
"email":"driver@example.com"
}
]
}
}
]
}
}
4XX Ошибка запроса. [Подробнее про ошибки API](https://ati.su/developers/documentation/errors/)
Модель
ONE-OF

(nullable)

Пример
{...}
"reason":"Неизвестная ошибка",
"error":"unknown_server_error"
}
  • Торги (Аукцион) - в данном случае грузовладелец устанавливает начальную ставку и шаг, с которым эта ставка будет понижаться, а также время, в течение которого продлятся Торги. Вы вместе с другими перевозчиками можете побороться за право перевезти груз. Победит тот, чья ставка будет самой низкой, либо кто предложит самую лучшую дату перевозки, если это опция была предусмотрена грузовладельцем.

Получить всю информацию по идущим Торгам можно с помощью метода получения Торгов:

Получение Торгов (аукциона) по Id
get /v1.2/auction/{auctionId}
Параметры
Параметр Тип Расположение Описание
auctionId обязательный string (uuid) path
Id Торгов (аукциона) Пример: 3fa85f64-5717-4562-b3fc-2c963f66afa6
withDeleted boolean query
Возвращать удалённые торги Пример: true
Запрос
Пример запроса
curl 'https://api.ati.su/v1.2/auction/{auctionId}' \
-X 'GET' \
-H 'Authorization: Bearer {authorizationToken}' \
-H 'Content-Type: application/json'
Ответ
200 Торги (аукцион) для грузовладельца (код 200)
Модель
{...}

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

accept_second_pay_type: boolean

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

active_deal_id: uuid

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

auction_id*: uuid

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

auto_renew*: boolean

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

currency*: int32

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

current_rate_with_nds: double

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

current_rate_without_nds: double

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

deleted*: boolean

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

docs_expired_date: date-time

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

duration: int32

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

end_date: date-time

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

end_date_boundary: date-time

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

finish_type: enum
[0, 1, 2]

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

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

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

is_docs_expired: boolean

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

load_id*: uuid

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

max_rate: double

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

max_renew_time: int32

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

nds: double

Ставка НДС

next_rate_with_nds: double

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

next_rate_without_nds: double

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

participants_count*: int32

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

raise_bid: boolean

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

raise_bid_interval: int32

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

refuse_bet_prohibited: boolean

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

renew_time: int32

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

response_in_minutes: int32

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

response_prohibited: boolean

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

server_date*: date-time

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

start_date*: date-time

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

start_since_first_bet: boolean

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

state: enum
[0, 1, -100, -14, -13, -12, -11, -10, -9, -8, -7, -6, -5, -4, -3, -2, -1]

Статус аукциона

  • -100 - Не удалось определить состояние аукциона
  • -14 - Аукцион отменён вручную грузовладельцем
  • -13 - Аукцион удалён, т.к. расторгнут заказ
  • -12 - Аукцион без ставок завершён
  • -11 - Аукцион удалён автоматически
  • -10 - Аукцион удалён т.к. сделка завершена
  • -9 - Аукцион удалён
  • -8 - При включённом копировании грузов: ожидается действие от экспедитора в случае, когда заказ с победителем отменён, других участников нет
  • -7 - При включённом копировании грузов: ожидается действие с торгами от экспедитора в случае, когда заказ с победителем отменён и есть потенциальный победитель
  • -6 - При включённом копировании грузов: торги завершены, экспедитор не является победителем
  • -5 - Одна ставка лучшая по цене, другая по дате
  • -4 - Закончился, но победитель вовремя не взял груз и при этом есть еще возможные победители
  • -3 - Закончился, но победитель вовремя не взял груз и при этом он единственный возможный победитель
  • -2 - Закончился, ждем когда победитель возьмёт груз
  • -1 - Закончился, ставок нет
  • 0 - Идет, ставок нет
  • 1 - Идёт (уже есть валидные ставки)
step*: double

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

time_to_provide_documents: double

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

win_date: date-time

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

winner_criterion: enum
[0, 1]

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

  • 0 - Выбор победителя происходит автоматически по лучшей ставке
  • 1 - Выбор победителя происходит по ставке и дате загрузки. Если нет лучшей ставки с лучшей датой - требуется выбор победителя вручную
}
Пример
{...}
"accept_second_pay_type":true,
"active_deal_id":"4300ad9e-c164-447d-a00c-1b0f16355c89",
"auction_id":"edfa4cbc-868f-4ce7-89e2-8764df59151a",
"auction_rates":[...],
{...},
"added_at":"2023-04-24T11:31:51.9296722Z",
"ati_id":"12345",
"auction_rate_id":"fb6093ff-28e8-4c45-ac33-5c88e68b349f",
"contact_id":0,
"loading_date":null,
"rate_with_nds":5500,
"rate_without_nds":6600,
"source":0,
"state":0
},
{...}
"added_at":"2023-04-24T11:32:51.9296877Z",
"ati_id":"33345",
"auction_rate_id":"fdae4ca4-8c8b-44ac-9174-21614de4341f",
"contact_id":0,
"loading_date":null,
"rate_with_nds":5000,
"rate_without_nds":6000,
"source":0,
"state":1
}
],
"auction_restart_parameters":{...},
"auction_finish_action":1,
"current_change_winner_count":2,
"current_restart_count":1,
"duration_after_restart":30,
"init_change_winner_count":2,
"init_restart_count":1,
"is_manually_restarted":false,
"rate_increase":null,
"rate_increase_option":null
},
"auto_renew":true,
"currency":1,
"current_rate_with_nds":5000,
"current_rate_without_nds":6000,
"deleted":false,
"docs_expired_date":"2023-04-24T14:36:51.9297113Z",
"duration":6,
"end_date":"2023-04-24T11:36:51.9297297Z",
"end_date_boundary":"2023-04-24T11:36:51.9297268Z",
"finish_type":0,
"finished":true,
"is_docs_expired":false,
"load_id":"a2f03352-d1f2-4d76-bc65-94d5c2914847",
"max_rate":6000,
"max_renew_time":60,
"nds":20,
"participants_count":2,
"raise_bid":true,
"raise_bid_interval":30,
"renew_time":20,
"response_in_minutes":0,
"response_prohibited":false,
"server_date":"2023-04-24T11:36:51.9302947Z",
"start_date":"2023-04-24T11:30:51.9297089Z",
"start_since_first_bet":false,
"state":0,
"step":500,
"time_to_provide_documents":3,
"win_date":"2023-04-24T11:36:51.9297244Z",
"winner_criterion":0
}
201 Торги (аукцион) для участника (код 200)
Модель
{...}

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

auction_id*: uuid

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

currency*: int32

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

current_rate_with_nds: double

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

current_rate_without_nds: double

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

end_date: date-time

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

finished*: boolean

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

is_our_rate_best: boolean

Ставка лучшая в незавершенных Торгах (аукционе) (в завершенных - не отображается)

load_id*: uuid

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

next_rate_with_nds: double

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

next_rate_without_nds: double

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

participants_count*: int32

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

refuse_bet_prohibited: boolean

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

response_prohibited: boolean

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

server_date*: date-time

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

start_date*: date-time

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

winner_criterion: enum
[0, 1]

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

  • 0 - Выбор победителя происходит автоматически по лучшей ставке
  • 1 - Выбор победителя происходит по ставке и дате загрузки. Если нет лучшей ставки с лучшей датой - требуется выбор победителя вручную
}
Пример
{...}
"auction_id":"248de03c-c445-4cca-8858-4e9b495ce3d7",
"currency":1,
"current_rate_with_nds":5000,
"current_rate_without_nds":6000,
"end_date":"2023-04-24T11:36:51.930351Z",
"finished":false,
"is_our_rate_best":true,
"load_id":"dcbe9875-ebb8-4c06-bbb9-ab4093c5fe20",
"next_rate_with_nds":5500,
"next_rate_without_nds":6600,
"our_rate":{...},
"added_at":"2023-04-24T11:35:51.9303557Z",
"auction_rate_id":"47c55885-1ca1-4d05-bc66-968d0e53f0ce",
"contact_id":1,
"loading_date":null,
"rate_with_nds":4500,
"rate_without_nds":5400,
"state":0
},
"participants_count":2,
"response_prohibited":false,
"server_date":"2023-04-24T11:36:51.9305017Z",
"start_date":"2023-04-24T11:30:51.930351Z",
"winner_criterion":0
}
202 Торги (аукцион) для победителя (код 200)
Модель
{...}

Торги (аукцион) для победителя

active_deal_id: uuid

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

auction_id*: uuid

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

currency*: int32

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

current_rate_with_nds: double

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

current_rate_without_nds: double

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

docs_expired_date: date-time

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

end_date: date-time

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

finished*: boolean

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

is_docs_expired: boolean

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

load_id*: uuid

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

participants_count*: int32

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

refuse_bet_prohibited: boolean

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

response_prohibited: boolean

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

server_date*: date-time

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

start_date*: date-time

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

time_to_provide_documents: double

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

win_date: date-time

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

winner_criterion: enum
[0, 1]

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

  • 0 - Выбор победителя происходит автоматически по лучшей ставке
  • 1 - Выбор победителя происходит по ставке и дате загрузки. Если нет лучшей ставки с лучшей датой - требуется выбор победителя вручную
}
Пример
{...}
"active_deal_id":"38bd5f61-d3e4-432f-be4c-6bcf0a5b7045",
"auction_id":"fd831353-d13d-43a1-91d3-6ad06c84a8db",
"currency":1,
"current_rate_with_nds":5000,
"current_rate_without_nds":6000,
"docs_expired_date":"2023-04-24T14:36:51.9305482Z",
"end_date":"2023-04-24T11:36:51.93054Z",
"finished":true,
"is_docs_expired":false,
"load_id":"f0f98614-3fa3-4a6f-87ed-953b0f500eeb",
"our_rate":{...},
"added_at":"2023-04-24T11:35:51.9305428Z",
"auction_rate_id":"242bc0ad-56d9-49c1-93eb-7e93f53b139e",
"contact_id":1,
"loading_date":null,
"rate_with_nds":6000,
"rate_without_nds":5000,
"state":1
},
"participants_count":2,
"response_prohibited":false,
"server_date":"2023-04-24T11:36:51.9306908Z",
"start_date":"2023-04-24T11:30:51.93054Z",
"time_to_provide_documents":3,
"win_date":"2023-04-24T11:36:51.9305506Z",
"winner_criterion":0
}
404 Торги (аукцион) не найдены
Модель
null
Пример
null

Для этого вам понадобится ID Торгов, который вы можете получить в ответе метода поиска грузов:

Поиск грузов, размещённых на указанных площадках. API для интеграции. Площадка — закрытый список фирм, которым виден груз; в выдачу попадают и ваши грузы, и чужие. Искать можно только по площадкам, доступным вашей фирме; общая площадка исключена.
get /v1.0/loads/search/byboards
Параметры
Параметр Тип Расположение Описание
boardIds string[] query
Идентификаторы закрытых площадок, по 24 символа. Пустой список — поиск по всем площадкам, доступным фирме. Пример: ["5f1e2d3c4b5a69788796a5b4"]
Запрос
Пример запроса
curl 'https://api.ati.su/v1.0/loads/search/byboards' \
-X 'GET' \
-H 'Authorization: Bearer {authorizationToken}' \
-H 'Content-Type: application/json'
Ответ
200 Грузы, опубликованные на выбранных площадках.
Модель
[{...}]

Груз в ответе: поля публикации и вычисляемые сервисом.

LoadMeta:

Метаданные публикации: по их идентификатору можно получить все грузы, размещённые одной публикацией

ONE-OF
ContactId1*: int32

Идентификатор первого выбранного контакта. dict: GET https://api.ati.su/firms/v1.0/contacts → id. Список всех контактов и их идентификаторы можно получить с помощью API для работы с фирмами. Контакт должен быть виден для остальных участников АТИ

ContactId2: int32 (nullable)

Идентификатор второго выбранного контакта, если не выбрано, то null. Контакт должен быть виден для остальных участников АТИ

Note: string

Примечание к грузу. Ограничение по длине: 1000 символов

FirstDate: date-time

Дата, начиная с которой груз актуален, в формате UTC. Минимальное значение равно текущей дате. При значении параметра DateType равным 0, допустимое значение поля - текущая дата. При значении параметра DateType равным 1, допустимое значение поля - от текущей даты до 2 месяцев вперед. При значении параметра DateType равным 2, допустимое значение поля - текущая дата. При значении параметра DateType равным 3, FirstDate должен принимать значение текущей даты или отсутствовать

LastDate: date-time

Дата, после которой груз не актуален, в формате UTC. Минимальное значение равно значению параметра FirstDate. При значении параметра DateType равным 0, допустимое значение поля - от текущей даты до 1 дня вперед. При значении параметра DateType равным 1, допустимое значение поля - от даты в параметре FirstDate до 9 дней вперед. При значении параметра DateType равным 2, сервис вычисляет поле как FirstDate + 2 месяца, передаваемое значение игнорируется. При значении параметра DateType равным 3, LastDate автоматически устанавливается на значение + 2 дня от текущей даты, передаваемое значение игнорируется

DateType: int32

Тип готовности груза к перевозке, по умолчанию 0

  • 0 - Готов к загрузке
  • 1 - в период с FirstDate по LastDate
  • 2 - постоянно
  • 3 - груза нет, запрос ставки
PeriodicityId: int32

Периодичность загрузки. Если параметр DateType не равен 2, PeriodicityId равен 0. Иначе PeriodicityId может принимать следующие значения:

  • 1 - ежедневно
  • 100 - по рабочим дням
OrderNumber: string

Номер заказа. Ограничение по длине: 250 символов

Krugoreis: boolean

Включён ли кругорейс

Loading*:

Точка погрузки

ONE-OF
Unloading*:

Точка выгрузки

ONE-OF
Cargo*:

Что везём: наименование, вес, объём, упаковка

ONE-OF
Transport*:

Требования к транспорту: кузов, варианты загрузки и выгрузки

ONE-OF
Payment*:

Условия оплаты и ставка

ONE-OF
InviteSettings:

Настройки автоприглашений

ONE-OF
PriorityView:

Приоритетный показ

ONE-OF
Stealth:

Настройки показа груза

ONE-OF
Deal:

Сделка, в рамках которой размещён груз

ONE-OF
UnloadFirstDate: date-time (nullable)

Дата начала разгрузки, в формате UTC. Может иметь значение null. Минимальное значение равно текущей дате. Не указывается при значении параметра DateType равным 3

UnloadLastDate: date-time (nullable)

Дата окончания разгрузки, в формате UTC. Может иметь значение null. Если нет даты начала разгрузки UnloadFirstDate, должна отсутствовать дата окончания разгрузки UnloadLastDate. Не указывается при значении параметра DateType равным 3

ArchiveDate: date-time (nullable)

Дата и время переноса в архив

ArchiveReason:

Причина переноса в архив

ONE-OF

(nullable)

enum
[Unknown, System, Manual, Complaints, UnwantedContent, DeleteCsvLoad, MergeLoadsAfterEdit, ContactDoesNotHaveAccessToVirtualPayments, VerticesLoadDelete, StealthStatisticError, CheckDuplicateComplaints, DeleteContact, DeleteFirm, CleanOldLoadsJob]

Причина, по которой груз оказался в архиве.

  • VerticesLoadDelete - Снят при сквозной передаче груза
  • StealthStatisticError - Снят из-за ошибки при подсчёте статистики Стелса
  • CheckDuplicateComplaints - Снят при проверке дублирующих жалоб
  • DeleteContact - Удалён контакт
  • DeleteFirm - Удалена фирма
  • CleanOldLoadsJob - Истёк срок актуальности
  • Unknown - Причина не определена
  • System - Снят системой
  • Manual - Снят с публикации владельцем
  • Complaints - Снят по жалобам
  • UnwantedContent - Снят за недопустимое содержимое
  • DeleteCsvLoad - Удалён вместе с CSV-загрузкой
  • MergeLoadsAfterEdit - Объединён с другим грузом после редактирования
  • ContactDoesNotHaveAccessToVirtualPayments - Снят: у контакта нет права оплачивать услугу со счёта фирмы
TruePrice: int32

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

TrueCurrencyId: int32

Идентификатор валюты озвученной ставки. dict: GET /v1.0/dictionaries/currencyTypes → Id

ResponseCount: int32

Количество отзывов о грузе (без встречных предложений)

OfferCount: int32

Количество встречных предложений (остальные отзывы не учитываются)

CanBeDeleted: boolean

Можно ли снять груз с публикации

HasPermissionsToLoad: boolean

Есть ли у текущего контакта доступ к грузу: контакт указан в грузе или имеет доступ к его подразделению

CanBeEdited: boolean

Можно ли редактировать груз

CanBeRenewed: boolean

Можно ли обновить груз

CanBeRestored: boolean

Можно ли восстановить груз из архива

EditRestriction:

Причина отказа в редактировании груза, 0 — доступ есть. dict: GET /v1.0/dictionaries/load_access_denied_reasons → ключ

ONE-OF
enum
[0, 1, 2, 3, 4, 5, 6, 7, 8, 9, 10, 11, 12, 13, 14, 15, 16]

Причина отказа в доступе к грузу.

  • 0 - Вы имеете доступ к работе с грузом
  • 1 - Ваша фирма больше не может размещать грузы из-за нарушения правил АТИ
  • 2 - Груз зарезервирован или взят, операции с грузом запрещены
  • 3 - Превышен лимит актуальных грузов
  • 4 - Вы пытаетесь работать с грузами под общим пользователем, недостаточно прав
  • 5 - У вашего контакта недостаточно прав для работы с данным грузом
  • 6 - Груз имеет завершённые торги, операции с грузом запрещены
  • 7 - Сервис сделок временно недоступен
  • 8 - Нельзя изменять или удалять груз из сквозных торгов
  • 9 - У вашего контакта недостаточно прав для создания грузов
  • 10 - У вашего контакта недостаточно прав для работы с виртуальными кошельками
  • 11 - У вашего контакта недостаточно прав для работы с грузами на общей площадке
  • 12 - У вашего контакта недостаточно прав для работы с грузами на персональных площадках
  • 13 - У вашего контакта нет доступа к одной или нескольким персональным площадкам, указанным в грузе
  • 14 - У вашего контакта нет доступа к подразделению груза
  • 15 - Ваш контакт должен быть указан первым в грузе
  • 16 - Груз не опубликован ни на одной площадке
DeleteRestriction:

Причина отказа в снятии груза с публикации, 0 — доступ есть. dict: GET /v1.0/dictionaries/load_access_denied_reasons → ключ

ONE-OF
enum
[0, 1, 2, 3, 4, 5, 6, 7, 8, 9, 10, 11, 12, 13, 14, 15, 16]

Причина отказа в доступе к грузу.

  • 0 - Вы имеете доступ к работе с грузом
  • 1 - Ваша фирма больше не может размещать грузы из-за нарушения правил АТИ
  • 2 - Груз зарезервирован или взят, операции с грузом запрещены
  • 3 - Превышен лимит актуальных грузов
  • 4 - Вы пытаетесь работать с грузами под общим пользователем, недостаточно прав
  • 5 - У вашего контакта недостаточно прав для работы с данным грузом
  • 6 - Груз имеет завершённые торги, операции с грузом запрещены
  • 7 - Сервис сделок временно недоступен
  • 8 - Нельзя изменять или удалять груз из сквозных торгов
  • 9 - У вашего контакта недостаточно прав для создания грузов
  • 10 - У вашего контакта недостаточно прав для работы с виртуальными кошельками
  • 11 - У вашего контакта недостаточно прав для работы с грузами на общей площадке
  • 12 - У вашего контакта недостаточно прав для работы с грузами на персональных площадках
  • 13 - У вашего контакта нет доступа к одной или нескольким персональным площадкам, указанным в грузе
  • 14 - У вашего контакта нет доступа к подразделению груза
  • 15 - Ваш контакт должен быть указан первым в грузе
  • 16 - Груз не опубликован ни на одной площадке
RestoreRestriction:

Причина отказа в восстановлении груза из архива, 0 — доступ есть. dict: GET /v1.0/dictionaries/load_access_denied_reasons → ключ

ONE-OF
enum
[0, 1, 2, 3, 4, 5, 6, 7, 8, 9, 10, 11, 12, 13, 14, 15, 16]

Причина отказа в доступе к грузу.

  • 0 - Вы имеете доступ к работе с грузом
  • 1 - Ваша фирма больше не может размещать грузы из-за нарушения правил АТИ
  • 2 - Груз зарезервирован или взят, операции с грузом запрещены
  • 3 - Превышен лимит актуальных грузов
  • 4 - Вы пытаетесь работать с грузами под общим пользователем, недостаточно прав
  • 5 - У вашего контакта недостаточно прав для работы с данным грузом
  • 6 - Груз имеет завершённые торги, операции с грузом запрещены
  • 7 - Сервис сделок временно недоступен
  • 8 - Нельзя изменять или удалять груз из сквозных торгов
  • 9 - У вашего контакта недостаточно прав для создания грузов
  • 10 - У вашего контакта недостаточно прав для работы с виртуальными кошельками
  • 11 - У вашего контакта недостаточно прав для работы с грузами на общей площадке
  • 12 - У вашего контакта недостаточно прав для работы с грузами на персональных площадках
  • 13 - У вашего контакта нет доступа к одной или нескольким персональным площадкам, указанным в грузе
  • 14 - У вашего контакта нет доступа к подразделению груза
  • 15 - Ваш контакт должен быть указан первым в грузе
  • 16 - Груз не опубликован ни на одной площадке
RenewRestriction: string

Причина отказа в обновлении груза. Пустая строка, если обновление доступно

Id: guid

Идентификатор груза

LoadNumber: string

Номер груза

UpdatedAt: date-time

Дата последнего изменения груза в UTC

AddedAt: date-time

Дата публикации груза в UTC

RefreshedAt: date-time

Дата последнего обновления груза в выдаче, в UTC

Distance: int32

Расстояние по дорогам в километрах

PlatonRoadsLength: int32

Протяжённость участков маршрута, за которые взимается плата по системе «Платон», в километрах

TollRoadsLength: int32

Протяжённость платных дорог на маршруте в километрах

TravelTime: string

Расчётное время в пути в формате [d.]hh:mm:ss

Zimnik: boolean

Учитывать ли зимники при построении маршрута

Ferries: boolean

Учитывать ли паромные переправы при построении маршрута

FirmId: string

Идентификатор фирмы

AuctionId: guid (nullable)

Идентификатор аукциона по грузу

}]
Пример
[...]
{...}
"LoadMeta":{...},
"LoadMetaId":"3fa85f64-5717-4562-b3fc-2c963f66afa6",
"MetaData":"import-2026-09"
},
"ContactId1":1234567,
"ContactId2":1234568,
"Note":"Погрузка с 9 до 18, пропуск заказывать заранее",
"FirstDate":"2026-09-08T00:00:00.000Z",
"LastDate":"2026-09-10T00:00:00.000Z",
"DateType":1,
"PeriodicityId":0,
"OrderNumber":"ЗК-2026-0917",
"Krugoreis":false,
"Loading":{...},
"CityId":1,
"Latitude":59.939095,
"Longitude":30.315868,
"Street":"ул. Салова, 57",
"OrganizationId":"3fa85f64-5717-4562-b3fc-2c963f66afa6",
"AddressId":"3fa85f64-5717-4562-b3fc-2c963f66afa6",
"TimeStart":"2026-09-08T09:00:00.000Z",
"TimeEnd":"2026-09-08T18:00:00.000Z",
"IsRoundTheClock":false,
"LargeCities":[...],
0
],
"LoadingCargos":[...]
{...}
"CargoId":1,
"NameId":1,
"Name":"Продукты питания",
"PackagingType":1,
"PackagingQuantity":20,
"Weight":20,
"Volume":82,
"Sizes":{...}
"Length":13.6,
"Width":2.45,
"Height":2.7,
"Diameter":1.2,
"LengthHighlight":false,
"WidthHighlight":false,
"HeightHighlight":false
}
}
]
},
"ExtraPoints":[...],
{...}
"CityId":1,
"PointType":2,
"Latitude":59.939095,
"Longitude":30.315868,
"Street":"пр. Ленина, 10",
"OrganizationId":"3fa85f64-5717-4562-b3fc-2c963f66afa6",
"AddressId":"3fa85f64-5717-4562-b3fc-2c963f66afa6",
"OrdinalId":1,
"IsRoundTheClock":false,
"LoadingDateStart":"2026-09-09T00:00:00.000Z",
"LoadingDateEnd":"2026-09-09T00:00:00.000Z",
"LoadingTimeStart":"09:00:00",
"LoadingTimeEnd":"18:00:00",
"LoadingCargos":[...],
{...}
"CargoId":1,
"NameId":1,
"Name":"Продукты питания",
"PackagingType":1,
"PackagingQuantity":20,
"Weight":20,
"Volume":82,
"Sizes":{...}
"Length":13.6,
"Width":2.45,
"Height":2.7,
"Diameter":1.2,
"LengthHighlight":false,
"WidthHighlight":false,
"HeightHighlight":false
}
}
],
"UnloadingCargos":[...]
{...}
"CargoId":1,
"Weight":10,
"Volume":40,
"PackagingQuantity":10,
"IsDefinedByTtn":false
}
]
}
],
"Unloading":{...},
"CityId":1,
"Latitude":59.939095,
"Longitude":30.315868,
"Street":"ул. Салова, 57",
"OrganizationId":"3fa85f64-5717-4562-b3fc-2c963f66afa6",
"AddressId":"3fa85f64-5717-4562-b3fc-2c963f66afa6",
"TimeStart":"2026-09-08T09:00:00.000Z",
"TimeEnd":"2026-09-08T18:00:00.000Z",
"IsRoundTheClock":false,
"LargeCities":[...],
0
],
"LoadingCargos":[...]
{...}
"CargoId":1,
"NameId":1,
"Name":"Продукты питания",
"PackagingType":1,
"PackagingQuantity":20,
"Weight":20,
"Volume":82,
"Sizes":{...}
"Length":13.6,
"Width":2.45,
"Height":2.7,
"Diameter":1.2,
"LengthHighlight":false,
"WidthHighlight":false,
"HeightHighlight":false
}
}
]
},
"Cargo":{...},
"Weight":20,
"Volume":82,
"ADR":0,
"CargoTypeId":59,
"CargoType":"Стройматериалы",
"PackType":1,
"PalletCount":33,
"BeltCount":0,
"DogruzType":1,
"SborGruz":false,
"Size":{...}
"Length":13.6,
"Width":2.45,
"Height":2.7,
"Diameter":1.2,
"LengthHighlight":false,
"WidthHighlight":false,
"HeightHighlight":false
}
},
"Transport":{...},
"CarType":5,
"CarTypeString":"5",
"LoadingType":3,
"LoadingLogicalOperator":"OR",
"UnloadingType":3,
"UnloadingLogicalOperator":"OR",
"TrucksQuantity":1,
"TemperatureFrom":-18,
"TemperatureTo":4,
"Stsepka":false,
"Pnevmohod":false,
"Koniki":false,
"TIR":false,
"CMR":false,
"T1":false,
"SanPassport":false,
"IsTracking":false,
"RequiredCapacity":20
},
"Payment":{...},
"CurrencyId":1,
"MoneyType":22,
"RateSum":85000,
"SumWithNDS":102000,
"SumWithoutNDS":85000,
"PrepayPercent":30,
"PrepayPercentEnabled":true,
"PayDays":5,
"PayDaysEnabled":true,
"FixedRate":true,
"Torg":false,
"DirectContract":false,
"InFuel":false,
"OnUnloading":false,
"HideResponses":false,
"AcceptPaymentTypes":0
},
"InviteSettings":{...},
"InviteDelayInSeconds":600,
"InviteDurationInSeconds":3600,
"MaxPercentDeviation":10,
"NeedArchiveOnInvite":false
},
"PriorityView":{...},
"DailyLimit":500,
"IsForPayedOnly":false,
"OrderLimit":100,
"ViewRate":1.5,
"MoneySpentPerDay":12,
"MoneySpentPerOrder":45
},
"Stealth":{...},
"ListIdToHide":"3fa85f64-5717-4562-b3fc-2c963f66afa6",
"FirmRegDateToHide":"2024-01-01T00:00:00.000Z",
"ScoreToHide":3
},
"LoadFiles":[...],
{...}
"FileId":"a1b2c3d4e5f6a7b8c9d0e1f2",
"FileType":1,
"Attributes":0,
"Name":"Договор.pdf",
"Link":"https://api.ati.su/gw/plyushkin/v1/a1b2c3d4e5f6a7b8c9d0e1f2",
"Size":-1
}
],
"Deal":{...},
"Auction":{...}
"StartRate":50000,
"Currency":1,
"Step":500,
"PaymentType":0,
"AcceptSecondPayType":false,
"StartDate":"2026-09-08T09:00:00.000Z",
"EndDate":"2026-09-08T12:00:00.000Z",
"EndDateBoundary":"2026-09-09T09:00:00.000Z",
"Nds":20,
"TimeToProvideDocuments":4,
"AutoRenew":true,
"RenewTime":5,
"MaxRenewTime":30,
"RaiseBid":false,
"MaxRate":60000,
"RaiseBidInterval":30,
"ResponseInMinutes":15,
"Duration":180,
"StartSinceFirstBet":false,
"AuctionRestartParameters":{...},
"AuctionFinishAction":0,
"InitRestartCount":1,
"InitChangeWinnerCount":1,
"DurationAfterRestart":120,
"RateIncrease":500,
"RateIncreaseOption":1
},
"AcceptCounterOffersOnlyBeforeFirstBet":false,
"WinnerCriterion":0,
"Source":0,
"AuctionId":"3fa85f64-5717-4562-b3fc-2c963f66afa6",
"LoadId":"3fa85f64-5717-4562-b3fc-2c963f66afa6",
"ActiveDealId":"3fa85f64-5717-4562-b3fc-2c963f66afa6",
"State":0,
"Finished":false,
"WinDate":"2026-09-08T12:05:00.000Z",
"AuctionRates":[...]
{...}
"AuctionRateId":"3fa85f64-5717-4562-b3fc-2c963f66afa6",
"AddedAt":"2026-09-08T10:15:30.000Z",
"RateFirm":{...},
"Score":4.5,
"Status":0,
"Name":"ООО «Перевозчик»",
"ContactName":"Иван Петров",
"AtiId":"1234567"
},
"Rate":48000,
"State":0,
"LoadingDate":"2026-09-09T00:00:00.000Z",
"FirmId":7654321,
"ContactId":0
}
]
}
},
"Boards":[...],
{...}
"BoardId":"a0a0a0a0a0a0a0a0a0a0a0a0",
"PublicationTime":"2026-09-08T12:00:00.000Z",
"IsReservationEnabled":false,
"PublicationOption":0,
"IsPublished":true,
"IsCommonBoard":true
}
],
"UnloadFirstDate":"2026-09-11T00:00:00.000Z",
"UnloadLastDate":"2026-09-12T00:00:00.000Z",
"ArchiveDate":"2026-09-07T10:15:30.000Z",
"ArchiveReason":"Unknown",
"TruePrice":85000,
"TrueCurrencyId":1,
"ResponseCount":3,
"OfferCount":2,
"CanBeDeleted":true,
"HasPermissionsToLoad":true,
"CanBeEdited":true,
"CanBeRenewed":true,
"CanBeRestored":false,
"EditRestriction":0,
"DeleteRestriction":0,
"RestoreRestriction":0,
"RenewRestriction":"Груз можно обновить не ранее чем через 40 минут",
"Id":"3fa85f64-5717-4562-b3fc-2c963f66afa6",
"LoadNumber":"12345678",
"UpdatedAt":"2026-09-07T10:15:30.000Z",
"AddedAt":"2026-09-05T08:00:00.000Z",
"RefreshedAt":"2026-09-07T09:00:00+00:00",
"Distance":712,
"PlatonRoadsLength":540,
"TollRoadsLength":120,
"TravelTime":"10:30:00",
"Zimnik":false,
"Ferries":false,
"FirmId":"1234567",
"AuctionId":"3fa85f64-5717-4562-b3fc-2c963f66afa6"
}
]
400 Идентификатор площадки не из 24 символов.
Модель
{...}

Ошибка вместо результата: машинный ключ и пояснение для пользователя.

Reason: string

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

Error: string

Ключ ошибки

}
Пример
{...}
"Reason":"Ошибка валидации: Массив ids не должен быть пуст",
"Error":"validation_error"
}
403 Среди площадок есть недоступная фирме, в том числе общая.
Модель
{...}

Ошибка вместо результата: машинный ключ и пояснение для пользователя.

Reason: string

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

Error: string

Ключ ошибки

}
Пример
{...}
"Reason":"Следующие площадки не существуют или вы не имеете доступа к ним: 5f1e2d3c4b5a69788796a5b4",
"Error":"boards_access_denied_error"
}

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

Выставление ставки в Торгах (аукционе)
post /v1.2/auction/bet
Параметры
Параметров нет
Запрос
Модель
{...}

Для внесения ставки грузоперевозчиком

auction_id*: uuid

Id аукциона

loading_date: date-time

Ближайшая возможная для перевозчика дата загрузки. Используется только в Торгах с критерием победы по ставке и дате загрузки

payment_type*: enum
[1, 22, 23, 24, 25]

Тип оплаты

  • 1 - Наличка
  • 22 - Любая
  • 23 - На карту
  • 24 - С НДС
  • 25 - Без НДС
  • Остальные зарезервированы
rate*: double

Ставка на груз, поставленная перевозчиком

}
Пример запроса
curl 'https://api.ati.su/v1.2/auction/bet' \
-X 'POST' \
-H 'Authorization: Bearer {authorizationToken}' \
-H 'Content-Type: application/json' \
--data-raw '{"auction_id":"3fa85f64-5717-4562-b3fc-2c963f66afa6","loading_date":"1970-01-01T00:00:00.000Z","payment_type":0,"rate":0.5}'
Ответ
200 Статус ставки
Модель
{...}

Статус ставки после выставления

auction_end_date: date-time

Параметр устарел, используйте auction.end_date. Дата окончания Торгов (аукциона).

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

Статус выставленной ставки

  • 0 - Ставка выставлена
  • 1 - Ставка выставлена и Торги (аукцион) завершены
  • 2 - Ставка не выставлена, поскольку Торги (аукцион) не найдены
  • 3 - Ставка не выставлена, поскольку она не лучшая
  • 4 - Ставка выставлена минимальная, но Торги (аукцион) не завершены
  • 5 - Ставка выставлена и Торги (аукцион) продлены
  • 6 - Ставка не выставлена, поскольку торги завершены
}
Пример
{...}
"auction":{...},
"auction_id":"8ef73743-fb35-4bdc-83a9-5904fa517ded",
"currency":1,
"current_rate_with_nds":5000,
"current_rate_without_nds":6000,
"end_date":"2023-04-24T11:36:52.0301243Z",
"finished":false,
"is_our_rate_best":true,
"load_id":"2f86f429-334a-4dae-be3f-624f92870829",
"next_rate_with_nds":5500,
"next_rate_without_nds":6600,
"our_rate":{...},
"added_at":"2023-04-24T11:35:52.0301298Z",
"auction_rate_id":"d4aa20cc-500b-494d-b67e-77a9fe8826bf",
"contact_id":1,
"loading_date":null,
"rate_with_nds":4500,
"rate_without_nds":5400,
"state":0
},
"participants_count":2,
"response_prohibited":false,
"server_date":"2023-04-24T11:36:52.0302924Z",
"start_date":"2023-04-24T11:30:52.0301216Z",
"winner_criterion":0
},
"auction_end_date":"2023-04-24T11:36:52.0300965Z",
"result_status":0
}
403 У вас нет доступа на сохранение ставки
Модель
null
Пример
null
404 Торги (аукцион) не найдены
Модель
null
Пример
null

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

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

Взятие груза / Редактирование заказа. Взятие груза возможно в том случае, если пользователь является победителем торгов (аукциона), получил приглашение от грузовладельца или состоит на площадке, где опубликован груз.
post /v1.2/orders/takeload/{loadId}
Параметры
Параметр Тип Расположение Описание
loadId обязательный string (guid) path
Id груза Пример: 2fb965f2-85e9-4213-90e7-f396e47219e7
Запрос
Модель
ONE-OF

(nullable)

Пример запроса
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,"vat_percent":7,"driver_id":"2fb965f2-85e9-4213-90e7-f396e47219e7","truck_info_id":"2fb965f2-85e9-4213-90e7-f396e47219e7","semitrailer_id":"2fb965f2-85e9-4213-90e7-f396e47219e7","trailer_id":"2fb965f2-85e9-4213-90e7-f396e47219e7","requisites_id":"2fb965f2-85e9-4213-90e7-f396e47219e7","signer_id":"2fb965f2-85e9-4213-90e7-f396e47219e7","is_drop_docs":false,"deal_kind":0,"taker_note":"Комментарий"}'
Ответ
200 Успешное взятие/редактирование
Модель
{...}

Заказ с копией груза.

load_copy:

Копия груза.
При создании заказа груз копируется, копия не отображается в поиске и её невозможно отредактировать

ONE-OF
deal:

Заказ.

Основная информация о заказе

ONE-OF

(nullable)

}
Пример
{...}
"load_copy":{...},
"id":"2fb965f2-85e9-4213-90e7-f396e47219e7",
"load_number":"ATI00012345",
"load_meta":{...},
"load_meta_id":"2fb965f2-85e9-4213-90e7-f396e47219e7",
"meta_data":{}
},
"auction_id":"7c9e6679-7425-40de-944b-e07fc1f90ae7",
"updated_at":"2024-06-15T10:30:00Z",
"added_at":"2024-06-14T09:00:00Z",
"archive_date":"2024-06-15T12:00:00Z",
"distance":720,
"distance_type":1,
"platon_roads_length":120,
"toll_roads_length":80,
"travel_time":"08:30:00",
"true_price":80000,
"true_currency_id":1,
"parent_id":"9c514669-b666-42ea-85e6-312093b93a50",
"is_unpublished":true,
"firm_id":12345,
"contact_id1":100,
"contact_id2":101,
"note":"Тент, боковая загрузка",
"first_date":"2024-06-16T00:00:00Z",
"last_date":"2024-06-18T00:00:00Z",
"date_type":0,
"periodicity_id":0,
"order_number":"ЗН-15",
"krugoreis":false,
"zimnik":false,
"ferries":false,
"loading":{...},
"fias_id":"2fb965f2-85e9-4213-90e7-f396e47219e7",
"city_id":1,
"latitude":55.7558,
"longitude":37.6173,
"street":"ул. Ленина, 1",
"organization_id":"7c9e6679-7425-40de-944b-e07fc1f90ae7",
"address_id":"9c514669-b666-42ea-85e6-312093b93a50",
"time_start":"2024-06-15T08:00:00Z",
"time_end":"2024-06-15T18:00:00Z",
"is_round_the_clock":false,
"large_cities":[...],
0
],
"large_cities_with_distance":[...],
{...}
"city_id":1,
"distance":15.5
}
],
"loading_cargos":[...],
{...}
"cargo_id":1,
"name_id":59,
"name":"Щебень",
"packaging_type":1,
"packaging_quantity":10,
"weight":20,
"volume":40,
"sizes":{...},
"length":13.6,
"width":2.45,
"height":2.7,
"diameter":0,
"length_highlight":false,
"width_highlight":false,
"height_highlight":false
},
"packaging_type_name":"коробки"
}
],
"organization":{...}
"organization_id":"2fb965f2-85e9-4213-90e7-f396e47219e7",
"firm_id":12345,
"name":"ООО Ромашка",
"ownership":1,
"residency":0,
"inn":7707083893,
"phone":"+79001234567",
"extra_phone":123,
"docs_address":{...},
"postcode":101000,
"city_id":1,
"street_name":"ул. Ленина",
"house_no":1,
"office_no":10
},
"stocks":[...],
{...}
"stock_id":"2fb965f2-85e9-4213-90e7-f396e47219e7",
"address":"ул. Ленина, 1",
"address_city_id":1,
"address_latitude":55.7558,
"address_longitude":37.6173,
"note":"Въезд со двора",
"work_schedules":[...],
{...}
"stock_schedule_id":"2fb965f2-85e9-4213-90e7-f396e47219e7",
"day_of_week":0,
"start_time":"09:00:00",
"end_time":"18:00:00"
}
],
"breaks_schedules":[...],
{...}
"stock_schedule_id":"2fb965f2-85e9-4213-90e7-f396e47219e7",
"day_of_week":0,
"start_time":"09:00:00",
"end_time":"18:00:00"
}
],
"contact_persons":[...],
{...}
"contact_person_id":"2fb965f2-85e9-4213-90e7-f396e47219e7",
"name":"Иван Иванов",
"phone":"+79001234567",
"email":"driver@example.com",
"extra_phone":123
}
],
"schedule_summary":"пн–пт 09:00–18:00",
"stock_type":0,
"timeslots_binding":{...}
"warehouse_id":1001,
"status":0
}
}
],
"contact_persons":[...],
{...}
"contact_person_id":"2fb965f2-85e9-4213-90e7-f396e47219e7",
"name":"Иван Иванов",
"phone":"+79001234567",
"email":"driver@example.com",
"extra_phone":123
}
],
"ownership_name":"ООО"
}
},
"extra_points":[...],
{...}
"route_point_id":"2fb965f2-85e9-4213-90e7-f396e47219e7",
"id":"2fb965f2-85e9-4213-90e7-f396e47219e7",
"city_id":1,
"point_type":0,
"ordinal_id":1,
"distance":120,
"street":"ул. Ленина, 1",
"latitude":55.7558,
"longitude":37.6173,
"organization_id":"7c9e6679-7425-40de-944b-e07fc1f90ae7",
"address_id":"9c514669-b666-42ea-85e6-312093b93a50",
"loading_date_start":"2024-06-15T00:00:00Z",
"loading_date_end":"2024-06-15T00:00:00Z",
"loading_time_start":"08:00:00",
"loading_time_end":"18:00:00",
"is_round_the_clock":false,
"city_name":"Москва",
"loading_cargos":[...],
{...}
"cargo_id":1,
"name_id":59,
"name":"Щебень",
"packaging_type":1,
"packaging_quantity":10,
"weight":20,
"volume":40,
"sizes":{...},
"length":13.6,
"width":2.45,
"height":2.7,
"diameter":0,
"length_highlight":false,
"width_highlight":false,
"height_highlight":false
},
"packaging_type_name":"коробки"
}
],
"unloading_cargos":[...],
{...}
"cargo_id":1,
"weight":20,
"volume":40,
"packaging_quantity":10,
"is_defined_by_ttn":false
}
],
"organization":{...}
"organization_id":"2fb965f2-85e9-4213-90e7-f396e47219e7",
"firm_id":12345,
"name":"ООО Ромашка",
"ownership":1,
"residency":0,
"inn":7707083893,
"phone":"+79001234567",
"extra_phone":123,
"docs_address":{...},
"postcode":101000,
"city_id":1,
"street_name":"ул. Ленина",
"house_no":1,
"office_no":10
},
"stocks":[...],
{...}
"stock_id":"2fb965f2-85e9-4213-90e7-f396e47219e7",
"address":"ул. Ленина, 1",
"address_city_id":1,
"address_latitude":55.7558,
"address_longitude":37.6173,
"note":"Въезд со двора",
"work_schedules":[...],
{...}
"stock_schedule_id":"2fb965f2-85e9-4213-90e7-f396e47219e7",
"day_of_week":0,
"start_time":"09:00:00",
"end_time":"18:00:00"
}
],
"breaks_schedules":[...],
{...}
"stock_schedule_id":"2fb965f2-85e9-4213-90e7-f396e47219e7",
"day_of_week":0,
"start_time":"09:00:00",
"end_time":"18:00:00"
}
],
"contact_persons":[...],
{...}
"contact_person_id":"2fb965f2-85e9-4213-90e7-f396e47219e7",
"name":"Иван Иванов",
"phone":"+79001234567",
"email":"driver@example.com",
"extra_phone":123
}
],
"schedule_summary":"пн–пт 09:00–18:00",
"stock_type":0,
"timeslots_binding":{...}
"warehouse_id":1001,
"status":0
}
}
],
"contact_persons":[...],
{...}
"contact_person_id":"2fb965f2-85e9-4213-90e7-f396e47219e7",
"name":"Иван Иванов",
"phone":"+79001234567",
"email":"driver@example.com",
"extra_phone":123
}
],
"ownership_name":"ООО"
}
}
],
"unloading":{...},
"fias_id":"2fb965f2-85e9-4213-90e7-f396e47219e7",
"city_id":1,
"latitude":55.7558,
"longitude":37.6173,
"street":"ул. Ленина, 1",
"organization_id":"7c9e6679-7425-40de-944b-e07fc1f90ae7",
"address_id":"9c514669-b666-42ea-85e6-312093b93a50",
"time_start":"2024-06-15T08:00:00Z",
"time_end":"2024-06-15T18:00:00Z",
"is_round_the_clock":false,
"large_cities":[...],
0
],
"large_cities_with_distance":[...],
{...}
"city_id":1,
"distance":15.5
}
],
"loading_cargos":[...],
{...}
"cargo_id":1,
"name_id":59,
"name":"Щебень",
"packaging_type":1,
"packaging_quantity":10,
"weight":20,
"volume":40,
"sizes":{...},
"length":13.6,
"width":2.45,
"height":2.7,
"diameter":0,
"length_highlight":false,
"width_highlight":false,
"height_highlight":false
},
"packaging_type_name":"коробки"
}
],
"organization":{...}
"organization_id":"2fb965f2-85e9-4213-90e7-f396e47219e7",
"firm_id":12345,
"name":"ООО Ромашка",
"ownership":1,
"residency":0,
"inn":7707083893,
"phone":"+79001234567",
"extra_phone":123,
"docs_address":{...},
"postcode":101000,
"city_id":1,
"street_name":"ул. Ленина",
"house_no":1,
"office_no":10
},
"stocks":[...],
{...}
"stock_id":"2fb965f2-85e9-4213-90e7-f396e47219e7",
"address":"ул. Ленина, 1",
"address_city_id":1,
"address_latitude":55.7558,
"address_longitude":37.6173,
"note":"Въезд со двора",
"work_schedules":[...],
{...}
"stock_schedule_id":"2fb965f2-85e9-4213-90e7-f396e47219e7",
"day_of_week":0,
"start_time":"09:00:00",
"end_time":"18:00:00"
}
],
"breaks_schedules":[...],
{...}
"stock_schedule_id":"2fb965f2-85e9-4213-90e7-f396e47219e7",
"day_of_week":0,
"start_time":"09:00:00",
"end_time":"18:00:00"
}
],
"contact_persons":[...],
{...}
"contact_person_id":"2fb965f2-85e9-4213-90e7-f396e47219e7",
"name":"Иван Иванов",
"phone":"+79001234567",
"email":"driver@example.com",
"extra_phone":123
}
],
"schedule_summary":"пн–пт 09:00–18:00",
"stock_type":0,
"timeslots_binding":{...}
"warehouse_id":1001,
"status":0
}
}
],
"contact_persons":[...],
{...}
"contact_person_id":"2fb965f2-85e9-4213-90e7-f396e47219e7",
"name":"Иван Иванов",
"phone":"+79001234567",
"email":"driver@example.com",
"extra_phone":123
}
],
"ownership_name":"ООО"
}
},
"cargo":{...},
"weight":20,
"volume":40,
"adr":0,
"cargo_type_id":1,
"cargo_type":"Щебень",
"pack_type":1,
"pallet_count":11,
"belt_count":6,
"dogruz_type":0,
"sbor_gruz":false,
"size":{...}
"length":13.6,
"width":2.45,
"height":2.7,
"diameter":0,
"length_highlight":false,
"width_highlight":false,
"height_highlight":false
}
},
"transport":{...},
"car_type":200,
"car_type_string":"тентованный, рефрижератор",
"loading_type":0,
"loading_logical_operator":"OR",
"unloading_type":0,
"unloading_logical_operator":"OR",
"trucks_quantity":1,
"temperature_from":-18,
"temperature_to":-10,
"truck_attribs":0,
"stsepka":false,
"pnevmohod":false,
"koniki":false,
"tir":false,
"cmr":false,
"t1":false,
"san_passport":false,
"sanitation_logbook":false,
"is_tracking":true,
"required_capacity":20,
"team_driving":false
},
"boards":[...],
{...}
"board_id":"ati",
"name":"АТИ",
"color":"#FF6600"
}
],
"unload_first_date":"2024-06-17T00:00:00Z",
"unload_last_date":"2024-06-19T00:00:00Z"
},
"deal":{...}
"deal_id":"2fb965f2-85e9-4213-90e7-f396e47219e7",
"load_copy_id":"7c9e6679-7425-40de-944b-e07fc1f90ae7",
"load_id":"9c514669-b666-42ea-85e6-312093b93a50",
"taker_ati_id":12345,
"taker_persistent_user_id":1001,
"taker_contact_id":100,
"cargo_owner_ati_id":67890,
"cargo_owner_persistent_user_id":2002,
"updated_at":"2024-06-15T10:30:00Z",
"end_of_reservation":"2024-06-16T18:00:00Z",
"auction_id":"6ba7b810-9dad-11d1-80b4-00c04fd430c8",
"status":0,
"counterparty_status":0,
"payment":{...},
"rates":[...],
{...}
"rate":45000,
"rate_type":0,
"currency":1,
"active":true,
"vat_percent":22
}
],
"prepay_percent":30,
"prepay_percent_enabled":true,
"on_unloading":false,
"in_fuel":false,
"pay_days_enabled":true,
"pay_days":5,
"fixed_rate":true,
"torg":false,
"direct_contract":true,
"money_type":1
},
"pay_docs":{...},
"documents_copies":{...},
"checked":true,
"date":"2024-06-15T10:30:00Z"
},
"documents_original":{...},
"checked":true,
"date":"2024-06-15T10:30:00Z"
},
"documents_original_track":{...},
"transport_company_id":100,
"tracking_url":"https://files.ati.su/example",
"tracking_number":"RD123456789RU",
"sending_date":"2024-06-15T10:30:00Z"
},
"payment":{...}
"checked":true,
"date":"2024-06-15T10:30:00Z"
}
},
"files":[...],
{...}
"id":"2fb965f2-85e9-4213-90e7-f396e47219e7",
"storage_file_id":"file-abc-123",
"access":0,
"add_date":"2024-06-15T10:30:00Z",
"deal_id":"2fb965f2-85e9-4213-90e7-f396e47219e7",
"is_counterparty_file":false,
"file_name":"Накладная.pdf",
"size":102400,
"link":"https://files.ati.su/example",
"file_id":"file-abc-123",
"source_type":0,
"source_file_type":0,
"file_type":0,
"timeslots_warehouse_ids":[...]
0
]
}
],
"document_templates":[...],
{...}
"organization_address":"ул. Ленина, 1",
"templates":[...]
{...}
"add_date":"2024-06-15T10:30:00Z",
"access":0,
"timeslots_warehouse_ids":[...],
0
],
"deal_id":"2fb965f2-85e9-4213-90e7-f396e47219e7",
"deal_point_id":"2fb965f2-85e9-4213-90e7-f396e47219e7",
"owner_firm_id":12345,
"cargoes_ids_hash":0,
"contact_id":100,
"file_name":"Заявка.pdf",
"file_id":"file-abc-123",
"id":"7c9e6679-7425-40de-944b-e07fc1f90ae7",
"size":102400,
"link":"https://files.ati.su/example"
}
]
}
],
"customer":{...},
"ati_id":12345,
"source":0,
"name":"ООО Ромашка",
"ownership_id":1,
"inn":7707083893,
"ogrn":1027700132195,
"requisite":{...},
"name":"Основной счёт",
"bank":"ПАО Сбербанк",
"ks":30101810400000000000,
"registration_number":1481,
"rs":40702810938000000000,
"bik":9611925
},
"gen_director":{...},
"name":"Иван",
"surname":"Иванов",
"patronymic":"Иванович",
"number_phone":"+79001234567"
},
"contact":{...},
"name":"Иван",
"surname":"Иванов",
"patronymic":"Иванович",
"number_phone":"+79001234567",
"phone":"+74951234567",
"messenger_phone":"+79007654321",
"fax":"+74957654321",
"was_modified":false,
"selected_number":{...},
"value":"+79001234567",
"country_code":"RU"
},
"is_confirmed":true
},
"address":[...],
{...}
"is_legal":true,
"post_index":101000,
"city_id":1,
"street_name":"ул. Ленина",
"house":1,
"entrance":2,
"litera":"А",
"office_no":10,
"recipient_full_name":"Иван Иванов",
"comment":"Комментарий",
"region_id":1
}
],
"claims_count":3,
"recommendation_count":12,
"bad_partner_firms_count":2
},
"is_tracking":true,
"should_show_rate_to_driver":true,
"started_at":"2024-06-15T08:00:00Z",
"finished_at":"2024-06-20T18:00:00Z",
"denial_reason":"Грузовладелец отклонил заказ",
"taker_requisites":{...},
"requisite_id":"2fb965f2-85e9-4213-90e7-f396e47219e7",
"requisite_firm_name":"ООО Ромашка",
"signer_id":"7c9e6679-7425-40de-944b-e07fc1f90ae7",
"own_ship_id":1,
"inn":7707083893,
"kpp":770701001,
"requisite_type_id":1
},
"driver":{...},
"driver_id":"2fb965f2-85e9-4213-90e7-f396e47219e7",
"parent_id":"7c9e6679-7425-40de-944b-e07fc1f90ae7",
"first_name":"Иван",
"second_name":"Иванов",
"patronymic":"Иванович",
"phone_number":"+79001234567",
"driver_license_number":"77АА123456",
"driver_license_when_issued":"2018-04-12T00:00:00Z",
"passport_series":4510,
"passport_number":123456,
"passport_issued_by":"ОВД г. Москвы",
"passport_when_issued":"2015-06-15T00:00:00Z",
"registration":"г. Москва",
"is_attracted_driver":false,
"last_deal_related_id":"9c514669-b666-42ea-85e6-312093b93a50",
"description":"Опыт 10 лет",
"attracted_from":"ООО Ромашка",
"scans":[...],
{...}
"id":"2fb965f2-85e9-4213-90e7-f396e47219e7",
"owner_id":"7c9e6679-7425-40de-944b-e07fc1f90ae7",
"name":"ПТС.pdf",
"file_id":"file-abc-123",
"type":0
}
],
"origin":0,
"date_of_birth":"1985-03-20T00:00:00Z",
"department_code_in_passport":"770-001",
"driver_inn":7707083893,
"in_cargo_owner_black_list":false,
"external_id":"ext-driver-1",
"black_list_reasons":[...]
"string"
]
},
"truck":{...},
"truck_id":"2fb965f2-85e9-4213-90e7-f396e47219e7",
"parent_id":"7c9e6679-7425-40de-944b-e07fc1f90ae7",
"last_deal_related_id":"9c514669-b666-42ea-85e6-312093b93a50",
"type":0,
"description":"Тент 82 м³",
"brand_id":1,
"model":"Actros",
"number":"А123ВС77",
"phone_number":"+79001234567",
"is_attracted_truck":false,
"ownership_type":0,
"car_type_id":200,
"capacity":20,
"volume":82,
"length":13.6,
"width":2.45,
"height":2.7,
"manufacture_year":2020,
"vin":"WDB9340321L123456",
"vrc":"77АА123456",
"body_number":123456,
"dimension":40,
"truck_passport_number":"77ТТ123456",
"can_refrigerator":false,
"has_gen_set":false,
"truck_owner_name":"ООО Ромашка",
"can_carry_heavy_container":false,
"can_carry_tall_container":false,
"external_id":"ext-truck-1",
"verified":true,
"modification_restricted":false,
"scans":[...],
{...}
"id":"2fb965f2-85e9-4213-90e7-f396e47219e7",
"owner_id":"7c9e6679-7425-40de-944b-e07fc1f90ae7",
"name":"ПТС.pdf",
"file_id":"file-abc-123",
"type":0
}
],
"origin":0
},
"trailer":{...},
"truck_id":"2fb965f2-85e9-4213-90e7-f396e47219e7",
"parent_id":"7c9e6679-7425-40de-944b-e07fc1f90ae7",
"last_deal_related_id":"9c514669-b666-42ea-85e6-312093b93a50",
"type":0,
"description":"Тент 82 м³",
"brand_id":1,
"model":"Actros",
"number":"А123ВС77",
"phone_number":"+79001234567",
"is_attracted_truck":false,
"ownership_type":0,
"car_type_id":200,
"capacity":20,
"volume":82,
"length":13.6,
"width":2.45,
"height":2.7,
"manufacture_year":2020,
"vin":"WDB9340321L123456",
"vrc":"77АА123456",
"body_number":123456,
"dimension":40,
"truck_passport_number":"77ТТ123456",
"can_refrigerator":false,
"has_gen_set":false,
"truck_owner_name":"ООО Ромашка",
"can_carry_heavy_container":false,
"can_carry_tall_container":false,
"external_id":"ext-truck-1",
"verified":true,
"modification_restricted":false,
"scans":[...],
{...}
"id":"2fb965f2-85e9-4213-90e7-f396e47219e7",
"owner_id":"7c9e6679-7425-40de-944b-e07fc1f90ae7",
"name":"ПТС.pdf",
"file_id":"file-abc-123",
"type":0
}
],
"origin":0
},
"semi_trailer":{...},
"truck_id":"2fb965f2-85e9-4213-90e7-f396e47219e7",
"parent_id":"7c9e6679-7425-40de-944b-e07fc1f90ae7",
"last_deal_related_id":"9c514669-b666-42ea-85e6-312093b93a50",
"type":0,
"description":"Тент 82 м³",
"brand_id":1,
"model":"Actros",
"number":"А123ВС77",
"phone_number":"+79001234567",
"is_attracted_truck":false,
"ownership_type":0,
"car_type_id":200,
"capacity":20,
"volume":82,
"length":13.6,
"width":2.45,
"height":2.7,
"manufacture_year":2020,
"vin":"WDB9340321L123456",
"vrc":"77АА123456",
"body_number":123456,
"dimension":40,
"truck_passport_number":"77ТТ123456",
"can_refrigerator":false,
"has_gen_set":false,
"truck_owner_name":"ООО Ромашка",
"can_carry_heavy_container":false,
"can_carry_tall_container":false,
"external_id":"ext-truck-1",
"verified":true,
"modification_restricted":false,
"scans":[...],
{...}
"id":"2fb965f2-85e9-4213-90e7-f396e47219e7",
"owner_id":"7c9e6679-7425-40de-944b-e07fc1f90ae7",
"name":"ПТС.pdf",
"file_id":"file-abc-123",
"type":0
}
],
"origin":0
},
"document":{...},
"id":"2fb965f2-85e9-4213-90e7-f396e47219e7",
"old_id":"7c9e6679-7425-40de-944b-e07fc1f90ae7",
"editor":12345,
"url":"https://files.ati.su/example",
"old_url":"https://files.ati.su/example",
"name":"Заявка",
"is_signed":true,
"access":0
},
"additional_documents":[...],
{...}
"id":"2fb965f2-85e9-4213-90e7-f396e47219e7",
"is_counterparty_file":false,
"url":"https://files.ati.su/example",
"name":"Акт.pdf",
"is_signed":true,
"document_type":0,
"access":0
}
],
"in_work_status_model":0,
"in_work":{...},
"deal_id":"2fb965f2-85e9-4213-90e7-f396e47219e7",
"in_work_status":0,
"in_work_date":"2024-06-15T10:30:00Z",
"ati_id":12345,
"contact_id":100,
"tracker_phone":79001234567
},
"deal_note":"Просим уточнить время загрузки",
"deal_kind":0,
"points":[...]
{...}
"deal_point_id":"2fb965f2-85e9-4213-90e7-f396e47219e7",
"ordinal_id":1,
"point_type":0,
"city_id":1,
"lat":55.75,
"lon":37.62,
"address":"ул. Ленина, 1",
"participant_name":"ООО Ромашка",
"region_id":1,
"contact_name":"Иван Иванов",
"organization_id":"2fb965f2-85e9-4213-90e7-f396e47219e7",
"stock_id":"2fb965f2-85e9-4213-90e7-f396e47219e7",
"stock":{...},
"stock_id":"2fb965f2-85e9-4213-90e7-f396e47219e7",
"address":"ул. Ленина, 1",
"address_city_id":1,
"note":"Въезд со двора",
"contact_persons":[...],
{...}
"contact_person_id":"2fb965f2-85e9-4213-90e7-f396e47219e7",
"name":"Иван Иванов",
"phone":"+79001234567",
"email":"driver@example.com"
}
],
"schedule_summary":"пн–пт 09:00–18:00",
"stock_type":0,
"timeslots_warehouse_id":1001
},
"organization":{...}
"organization_id":"2fb965f2-85e9-4213-90e7-f396e47219e7",
"name":"ООО Ромашка",
"phone":"+79001234567",
"contact_persons":[...]
{...}
"contact_person_id":"2fb965f2-85e9-4213-90e7-f396e47219e7",
"name":"Иван Иванов",
"phone":"+79001234567",
"email":"driver@example.com"
}
]
}
}
]
}
}
4XX Ошибка запроса. [Подробнее про ошибки API](https://ati.su/developers/documentation/errors/)
Модель
ONE-OF

(nullable)

Пример
{...}
"reason":"Неизвестная ошибка",
"error":"unknown_server_error"
}

Приглашение взять груз

Существует еще один способ получить предложение на перевозку - персональное приглашение от грузовладельца на сделку. Как это работает:

При публикации груза с фиксированной ставкой у грузовладельца есть возможность отправить персональное предложение различным перевозчикам. Чтобы получить список поступивших вам персональных предложений, воспользуйтесь методом:

Получение списка приглашений.
get /v1.2/orders/invites/my
Параметры
Параметр Тип Расположение Описание
role integer query
Роль пользователя: `0` — Грузовладелец, `1` — Перевозчик Пример: 1
Запрос
Пример запроса
curl 'https://api.ati.su/v1.2/orders/invites/my' \
-X 'GET' \
-H 'Authorization: Bearer {authorizationToken}' \
-H 'Content-Type: application/json'
Ответ
200 Список приглашений на перевозку груза
Модель
[{...}]

Персональное приглашение.

owner_ati_id: string

Id фирмы грузовладельца.

owner_persistent_user_id: int32

Постоянный Id фирмы грузовладельца.

owner_contact_id: int32 (nullable)

Id контакта, который отправил приглашение.

taker_ati_id: string

Id приглашенной фирмы.

taker_persistent_user_id: int32

Постоянный Id приглашенной фирмы.

taker_contact_id: int32

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

taker_contacts_list: [int32]

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

date: date-time

Время отправки приглашения.

cancellation_date: date-time (nullable)

Время отмены приглашения.

payment:

Предложенные параметры оплаты.

ONE-OF
load:

Параметры предложенного груза.

ONE-OF
is_tracking: boolean

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

deal_kind:

Тип заказа.

ONE-OF
enum
[0, 1, 2, 4, 8, 16, 32, 64, 128, 256]

Тип заказа.

  • 0 — Заказ невозможен
  • 1 — Взятие груза из поиска
  • 2 — Заказ из торгов
  • 4 — Предложение груза
  • 8 — Из перехвата машин
  • 16 — Односторонний заказ
  • 32 — Предложение груза из встречного предложения
  • 64 — Предложение груза по контракту
  • 128 — Создан вручную для тестирования черновиков
  • 256 — Создан из АТИ-Доков
}]
Пример
[...]
{...}
"owner_ati_id":67890,
"owner_persistent_user_id":2002,
"owner_contact_id":200,
"taker_ati_id":12345,
"taker_persistent_user_id":1001,
"taker_contact_id":100,
"taker_contacts_list":[...],
0
],
"date":"2024-06-15T10:30:00Z",
"cancellation_date":"2024-06-16T12:00:00Z",
"payment":{...},
"rates":[...],
{...}
"rate":45000,
"rate_type":0,
"currency":1,
"vat_percent":22
}
],
"prepay_percent":30,
"prepay_percent_enabled":true,
"on_unloading":false,
"in_fuel":false,
"pay_days_enabled":true,
"pay_days":5,
"fixed_rate":true,
"torg":false,
"direct_contract":true,
"payment_source":0
},
"load":{...},
"id":"2fb965f2-85e9-4213-90e7-f396e47219e7",
"load_number":"ATI00012345",
"distance":720,
"distance_type":1,
"platon_roads_length":120,
"toll_roads_length":80,
"travel_time":"08:30:00",
"true_price":80000,
"true_currency_id":1,
"note":"Тент, боковая загрузка",
"first_date":"2024-06-16T00:00:00Z",
"last_date":"2024-06-18T00:00:00Z",
"date_type":0,
"periodicity_id":0,
"order_number":"ЗН-15",
"krugoreis":false,
"zimnik":false,
"ferries":false,
"loading":{...},
"fias_id":"2fb965f2-85e9-4213-90e7-f396e47219e7",
"city_id":1,
"latitude":55.7558,
"longitude":37.6173,
"street":"ул. Ленина, 1",
"organization_id":"7c9e6679-7425-40de-944b-e07fc1f90ae7",
"address_id":"9c514669-b666-42ea-85e6-312093b93a50",
"time_start":"1900-01-01T08:00:00Z",
"time_end":"1900-01-01T18:00:00Z",
"is_round_the_clock":false,
"large_cities":[...],
0
],
"large_cities_with_distance":[...],
{...}
"city_id":1,
"distance":15.5
}
],
"loading_cargos":[...],
{...}
"cargo_id":1,
"name_id":59,
"name":"Щебень",
"packaging_type":1,
"packaging_quantity":10,
"weight":20,
"volume":40,
"sizes":{...},
"length":13.6,
"width":2.45,
"height":2.7,
"diameter":0,
"length_highlight":false,
"width_highlight":false,
"height_highlight":false
},
"packaging_type_name":"коробки"
}
],
"organization":{...}
"organization_id":"2fb965f2-85e9-4213-90e7-f396e47219e7",
"firm_id":12345,
"name":"ООО Ромашка",
"ownership":1,
"residency":0,
"inn":7707083893,
"phone":"+79001234567",
"extra_phone":123,
"docs_address":{...},
"postcode":101000,
"city_id":1,
"street_name":"ул. Ленина",
"house_no":1,
"office_no":10
},
"stocks":[...],
{...}
"stock_id":"2fb965f2-85e9-4213-90e7-f396e47219e7",
"address":"ул. Ленина, 1",
"address_city_id":1,
"address_latitude":55.7558,
"address_longitude":37.6173,
"note":"Въезд со двора",
"work_schedules":[...],
{...}
"stock_schedule_id":"2fb965f2-85e9-4213-90e7-f396e47219e7",
"day_of_week":0,
"start_time":"09:00:00",
"end_time":"18:00:00"
}
],
"breaks_schedules":[...],
{...}
"stock_schedule_id":"2fb965f2-85e9-4213-90e7-f396e47219e7",
"day_of_week":0,
"start_time":"09:00:00",
"end_time":"18:00:00"
}
],
"contact_persons":[...],
{...}
"contact_person_id":"2fb965f2-85e9-4213-90e7-f396e47219e7",
"name":"Иван Иванов",
"phone":"+79001234567",
"email":"driver@example.com",
"extra_phone":123
}
],
"schedule_summary":"пн–пт 09:00–18:00",
"stock_type":0,
"timeslots_binding":{...}
"warehouse_id":1001,
"status":0
}
}
],
"contact_persons":[...],
{...}
"contact_person_id":"2fb965f2-85e9-4213-90e7-f396e47219e7",
"name":"Иван Иванов",
"phone":"+79001234567",
"email":"driver@example.com",
"extra_phone":123
}
],
"ownership_name":"ООО"
}
},
"extra_points":[...],
{...}
"route_point_id":"2fb965f2-85e9-4213-90e7-f396e47219e7",
"id":"2fb965f2-85e9-4213-90e7-f396e47219e7",
"city_id":1,
"point_type":0,
"ordinal_id":1,
"distance":120,
"street":"ул. Ленина, 1",
"latitude":55.7558,
"longitude":37.6173,
"organization_id":"7c9e6679-7425-40de-944b-e07fc1f90ae7",
"address_id":"9c514669-b666-42ea-85e6-312093b93a50",
"loading_date_start":"2024-06-15T00:00:00Z",
"loading_date_end":"2024-06-15T00:00:00Z",
"loading_time_start":"08:00:00",
"loading_time_end":"18:00:00",
"is_round_the_clock":false,
"city_name":"Москва",
"loading_cargos":[...],
{...}
"cargo_id":1,
"name_id":59,
"name":"Щебень",
"packaging_type":1,
"packaging_quantity":10,
"weight":20,
"volume":40,
"sizes":{...},
"length":13.6,
"width":2.45,
"height":2.7,
"diameter":0,
"length_highlight":false,
"width_highlight":false,
"height_highlight":false
},
"packaging_type_name":"коробки"
}
],
"unloading_cargos":[...],
{...}
"cargo_id":1,
"weight":20,
"volume":40,
"packaging_quantity":10,
"is_defined_by_ttn":false
}
],
"organization":{...}
"organization_id":"2fb965f2-85e9-4213-90e7-f396e47219e7",
"firm_id":12345,
"name":"ООО Ромашка",
"ownership":1,
"residency":0,
"inn":7707083893,
"phone":"+79001234567",
"extra_phone":123,
"docs_address":{...},
"postcode":101000,
"city_id":1,
"street_name":"ул. Ленина",
"house_no":1,
"office_no":10
},
"stocks":[...],
{...}
"stock_id":"2fb965f2-85e9-4213-90e7-f396e47219e7",
"address":"ул. Ленина, 1",
"address_city_id":1,
"address_latitude":55.7558,
"address_longitude":37.6173,
"note":"Въезд со двора",
"work_schedules":[...],
{...}
"stock_schedule_id":"2fb965f2-85e9-4213-90e7-f396e47219e7",
"day_of_week":0,
"start_time":"09:00:00",
"end_time":"18:00:00"
}
],
"breaks_schedules":[...],
{...}
"stock_schedule_id":"2fb965f2-85e9-4213-90e7-f396e47219e7",
"day_of_week":0,
"start_time":"09:00:00",
"end_time":"18:00:00"
}
],
"contact_persons":[...],
{...}
"contact_person_id":"2fb965f2-85e9-4213-90e7-f396e47219e7",
"name":"Иван Иванов",
"phone":"+79001234567",
"email":"driver@example.com",
"extra_phone":123
}
],
"schedule_summary":"пн–пт 09:00–18:00",
"stock_type":0,
"timeslots_binding":{...}
"warehouse_id":1001,
"status":0
}
}
],
"contact_persons":[...],
{...}
"contact_person_id":"2fb965f2-85e9-4213-90e7-f396e47219e7",
"name":"Иван Иванов",
"phone":"+79001234567",
"email":"driver@example.com",
"extra_phone":123
}
],
"ownership_name":"ООО"
}
}
],
"unloading":{...},
"fias_id":"2fb965f2-85e9-4213-90e7-f396e47219e7",
"city_id":1,
"latitude":55.7558,
"longitude":37.6173,
"street":"ул. Ленина, 1",
"organization_id":"7c9e6679-7425-40de-944b-e07fc1f90ae7",
"address_id":"9c514669-b666-42ea-85e6-312093b93a50",
"time_start":"1900-01-01T08:00:00Z",
"time_end":"1900-01-01T18:00:00Z",
"is_round_the_clock":false,
"large_cities":[...],
0
],
"large_cities_with_distance":[...],
{...}
"city_id":1,
"distance":15.5
}
],
"loading_cargos":[...],
{...}
"cargo_id":1,
"name_id":59,
"name":"Щебень",
"packaging_type":1,
"packaging_quantity":10,
"weight":20,
"volume":40,
"sizes":{...},
"length":13.6,
"width":2.45,
"height":2.7,
"diameter":0,
"length_highlight":false,
"width_highlight":false,
"height_highlight":false
},
"packaging_type_name":"коробки"
}
],
"organization":{...}
"organization_id":"2fb965f2-85e9-4213-90e7-f396e47219e7",
"firm_id":12345,
"name":"ООО Ромашка",
"ownership":1,
"residency":0,
"inn":7707083893,
"phone":"+79001234567",
"extra_phone":123,
"docs_address":{...},
"postcode":101000,
"city_id":1,
"street_name":"ул. Ленина",
"house_no":1,
"office_no":10
},
"stocks":[...],
{...}
"stock_id":"2fb965f2-85e9-4213-90e7-f396e47219e7",
"address":"ул. Ленина, 1",
"address_city_id":1,
"address_latitude":55.7558,
"address_longitude":37.6173,
"note":"Въезд со двора",
"work_schedules":[...],
{...}
"stock_schedule_id":"2fb965f2-85e9-4213-90e7-f396e47219e7",
"day_of_week":0,
"start_time":"09:00:00",
"end_time":"18:00:00"
}
],
"breaks_schedules":[...],
{...}
"stock_schedule_id":"2fb965f2-85e9-4213-90e7-f396e47219e7",
"day_of_week":0,
"start_time":"09:00:00",
"end_time":"18:00:00"
}
],
"contact_persons":[...],
{...}
"contact_person_id":"2fb965f2-85e9-4213-90e7-f396e47219e7",
"name":"Иван Иванов",
"phone":"+79001234567",
"email":"driver@example.com",
"extra_phone":123
}
],
"schedule_summary":"пн–пт 09:00–18:00",
"stock_type":0,
"timeslots_binding":{...}
"warehouse_id":1001,
"status":0
}
}
],
"contact_persons":[...],
{...}
"contact_person_id":"2fb965f2-85e9-4213-90e7-f396e47219e7",
"name":"Иван Иванов",
"phone":"+79001234567",
"email":"driver@example.com",
"extra_phone":123
}
],
"ownership_name":"ООО"
}
},
"cargo":{...},
"weight":20,
"volume":40,
"adr":0,
"cargo_type_id":1,
"cargo_type":"Щебень",
"pack_type":1,
"pallet_count":11,
"belt_count":6,
"dogruz_type":0,
"sbor_gruz":false,
"size":{...}
"length":13.6,
"width":2.45,
"height":2.7,
"diameter":0,
"length_highlight":false,
"width_highlight":false,
"height_highlight":false
}
},
"transport":{...},
"car_type":200,
"car_type_string":"200",
"loading_type":0,
"loading_logical_operator":"OR",
"unloading_type":0,
"unloading_logical_operator":"OR",
"trucks_quantity":1,
"temperature_from":-18,
"temperature_to":-10,
"truck_attribs":0,
"stsepka":false,
"pnevmohod":false,
"koniki":false,
"tir":false,
"cmr":false,
"t1":false,
"san_passport":false,
"sanitation_logbook":false,
"is_tracking":true,
"required_capacity":20,
"team_driving":false
},
"unload_first_date":"2024-06-17T00:00:00Z",
"unload_last_date":"2024-06-19T00:00:00Z"
},
"is_tracking":true,
"deal_kind":0
}
]
4XX Ошибка запроса. [Подробнее про ошибки API](https://ati.su/developers/documentation/errors/)
Модель
ONE-OF

(nullable)

Пример
{...}
"reason":"Неизвестная ошибка",
"error":"unknown_server_error"
}

У вас будет возможность взять груз по указанной ставке или отказаться от предложения, если условия вас не устроят.

Взятие груза / Редактирование заказа. Взятие груза возможно в том случае, если пользователь является победителем торгов (аукциона), получил приглашение от грузовладельца или состоит на площадке, где опубликован груз.
post /v1.2/orders/takeload/{loadId}
Параметры
Параметр Тип Расположение Описание
loadId обязательный string (guid) path
Id груза Пример: 2fb965f2-85e9-4213-90e7-f396e47219e7
Запрос
Модель
ONE-OF

(nullable)

Пример запроса
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,"vat_percent":7,"driver_id":"2fb965f2-85e9-4213-90e7-f396e47219e7","truck_info_id":"2fb965f2-85e9-4213-90e7-f396e47219e7","semitrailer_id":"2fb965f2-85e9-4213-90e7-f396e47219e7","trailer_id":"2fb965f2-85e9-4213-90e7-f396e47219e7","requisites_id":"2fb965f2-85e9-4213-90e7-f396e47219e7","signer_id":"2fb965f2-85e9-4213-90e7-f396e47219e7","is_drop_docs":false,"deal_kind":0,"taker_note":"Комментарий"}'
Ответ
200 Успешное взятие/редактирование
Модель
{...}

Заказ с копией груза.

load_copy:

Копия груза.
При создании заказа груз копируется, копия не отображается в поиске и её невозможно отредактировать

ONE-OF
deal:

Заказ.

Основная информация о заказе

ONE-OF

(nullable)

}
Пример
{...}
"load_copy":{...},
"id":"2fb965f2-85e9-4213-90e7-f396e47219e7",
"load_number":"ATI00012345",
"load_meta":{...},
"load_meta_id":"2fb965f2-85e9-4213-90e7-f396e47219e7",
"meta_data":{}
},
"auction_id":"7c9e6679-7425-40de-944b-e07fc1f90ae7",
"updated_at":"2024-06-15T10:30:00Z",
"added_at":"2024-06-14T09:00:00Z",
"archive_date":"2024-06-15T12:00:00Z",
"distance":720,
"distance_type":1,
"platon_roads_length":120,
"toll_roads_length":80,
"travel_time":"08:30:00",
"true_price":80000,
"true_currency_id":1,
"parent_id":"9c514669-b666-42ea-85e6-312093b93a50",
"is_unpublished":true,
"firm_id":12345,
"contact_id1":100,
"contact_id2":101,
"note":"Тент, боковая загрузка",
"first_date":"2024-06-16T00:00:00Z",
"last_date":"2024-06-18T00:00:00Z",
"date_type":0,
"periodicity_id":0,
"order_number":"ЗН-15",
"krugoreis":false,
"zimnik":false,
"ferries":false,
"loading":{...},
"fias_id":"2fb965f2-85e9-4213-90e7-f396e47219e7",
"city_id":1,
"latitude":55.7558,
"longitude":37.6173,
"street":"ул. Ленина, 1",
"organization_id":"7c9e6679-7425-40de-944b-e07fc1f90ae7",
"address_id":"9c514669-b666-42ea-85e6-312093b93a50",
"time_start":"2024-06-15T08:00:00Z",
"time_end":"2024-06-15T18:00:00Z",
"is_round_the_clock":false,
"large_cities":[...],
0
],
"large_cities_with_distance":[...],
{...}
"city_id":1,
"distance":15.5
}
],
"loading_cargos":[...],
{...}
"cargo_id":1,
"name_id":59,
"name":"Щебень",
"packaging_type":1,
"packaging_quantity":10,
"weight":20,
"volume":40,
"sizes":{...},
"length":13.6,
"width":2.45,
"height":2.7,
"diameter":0,
"length_highlight":false,
"width_highlight":false,
"height_highlight":false
},
"packaging_type_name":"коробки"
}
],
"organization":{...}
"organization_id":"2fb965f2-85e9-4213-90e7-f396e47219e7",
"firm_id":12345,
"name":"ООО Ромашка",
"ownership":1,
"residency":0,
"inn":7707083893,
"phone":"+79001234567",
"extra_phone":123,
"docs_address":{...},
"postcode":101000,
"city_id":1,
"street_name":"ул. Ленина",
"house_no":1,
"office_no":10
},
"stocks":[...],
{...}
"stock_id":"2fb965f2-85e9-4213-90e7-f396e47219e7",
"address":"ул. Ленина, 1",
"address_city_id":1,
"address_latitude":55.7558,
"address_longitude":37.6173,
"note":"Въезд со двора",
"work_schedules":[...],
{...}
"stock_schedule_id":"2fb965f2-85e9-4213-90e7-f396e47219e7",
"day_of_week":0,
"start_time":"09:00:00",
"end_time":"18:00:00"
}
],
"breaks_schedules":[...],
{...}
"stock_schedule_id":"2fb965f2-85e9-4213-90e7-f396e47219e7",
"day_of_week":0,
"start_time":"09:00:00",
"end_time":"18:00:00"
}
],
"contact_persons":[...],
{...}
"contact_person_id":"2fb965f2-85e9-4213-90e7-f396e47219e7",
"name":"Иван Иванов",
"phone":"+79001234567",
"email":"driver@example.com",
"extra_phone":123
}
],
"schedule_summary":"пн–пт 09:00–18:00",
"stock_type":0,
"timeslots_binding":{...}
"warehouse_id":1001,
"status":0
}
}
],
"contact_persons":[...],
{...}
"contact_person_id":"2fb965f2-85e9-4213-90e7-f396e47219e7",
"name":"Иван Иванов",
"phone":"+79001234567",
"email":"driver@example.com",
"extra_phone":123
}
],
"ownership_name":"ООО"
}
},
"extra_points":[...],
{...}
"route_point_id":"2fb965f2-85e9-4213-90e7-f396e47219e7",
"id":"2fb965f2-85e9-4213-90e7-f396e47219e7",
"city_id":1,
"point_type":0,
"ordinal_id":1,
"distance":120,
"street":"ул. Ленина, 1",
"latitude":55.7558,
"longitude":37.6173,
"organization_id":"7c9e6679-7425-40de-944b-e07fc1f90ae7",
"address_id":"9c514669-b666-42ea-85e6-312093b93a50",
"loading_date_start":"2024-06-15T00:00:00Z",
"loading_date_end":"2024-06-15T00:00:00Z",
"loading_time_start":"08:00:00",
"loading_time_end":"18:00:00",
"is_round_the_clock":false,
"city_name":"Москва",
"loading_cargos":[...],
{...}
"cargo_id":1,
"name_id":59,
"name":"Щебень",
"packaging_type":1,
"packaging_quantity":10,
"weight":20,
"volume":40,
"sizes":{...},
"length":13.6,
"width":2.45,
"height":2.7,
"diameter":0,
"length_highlight":false,
"width_highlight":false,
"height_highlight":false
},
"packaging_type_name":"коробки"
}
],
"unloading_cargos":[...],
{...}
"cargo_id":1,
"weight":20,
"volume":40,
"packaging_quantity":10,
"is_defined_by_ttn":false
}
],
"organization":{...}
"organization_id":"2fb965f2-85e9-4213-90e7-f396e47219e7",
"firm_id":12345,
"name":"ООО Ромашка",
"ownership":1,
"residency":0,
"inn":7707083893,
"phone":"+79001234567",
"extra_phone":123,
"docs_address":{...},
"postcode":101000,
"city_id":1,
"street_name":"ул. Ленина",
"house_no":1,
"office_no":10
},
"stocks":[...],
{...}
"stock_id":"2fb965f2-85e9-4213-90e7-f396e47219e7",
"address":"ул. Ленина, 1",
"address_city_id":1,
"address_latitude":55.7558,
"address_longitude":37.6173,
"note":"Въезд со двора",
"work_schedules":[...],
{...}
"stock_schedule_id":"2fb965f2-85e9-4213-90e7-f396e47219e7",
"day_of_week":0,
"start_time":"09:00:00",
"end_time":"18:00:00"
}
],
"breaks_schedules":[...],
{...}
"stock_schedule_id":"2fb965f2-85e9-4213-90e7-f396e47219e7",
"day_of_week":0,
"start_time":"09:00:00",
"end_time":"18:00:00"
}
],
"contact_persons":[...],
{...}
"contact_person_id":"2fb965f2-85e9-4213-90e7-f396e47219e7",
"name":"Иван Иванов",
"phone":"+79001234567",
"email":"driver@example.com",
"extra_phone":123
}
],
"schedule_summary":"пн–пт 09:00–18:00",
"stock_type":0,
"timeslots_binding":{...}
"warehouse_id":1001,
"status":0
}
}
],
"contact_persons":[...],
{...}
"contact_person_id":"2fb965f2-85e9-4213-90e7-f396e47219e7",
"name":"Иван Иванов",
"phone":"+79001234567",
"email":"driver@example.com",
"extra_phone":123
}
],
"ownership_name":"ООО"
}
}
],
"unloading":{...},
"fias_id":"2fb965f2-85e9-4213-90e7-f396e47219e7",
"city_id":1,
"latitude":55.7558,
"longitude":37.6173,
"street":"ул. Ленина, 1",
"organization_id":"7c9e6679-7425-40de-944b-e07fc1f90ae7",
"address_id":"9c514669-b666-42ea-85e6-312093b93a50",
"time_start":"2024-06-15T08:00:00Z",
"time_end":"2024-06-15T18:00:00Z",
"is_round_the_clock":false,
"large_cities":[...],
0
],
"large_cities_with_distance":[...],
{...}
"city_id":1,
"distance":15.5
}
],
"loading_cargos":[...],
{...}
"cargo_id":1,
"name_id":59,
"name":"Щебень",
"packaging_type":1,
"packaging_quantity":10,
"weight":20,
"volume":40,
"sizes":{...},
"length":13.6,
"width":2.45,
"height":2.7,
"diameter":0,
"length_highlight":false,
"width_highlight":false,
"height_highlight":false
},
"packaging_type_name":"коробки"
}
],
"organization":{...}
"organization_id":"2fb965f2-85e9-4213-90e7-f396e47219e7",
"firm_id":12345,
"name":"ООО Ромашка",
"ownership":1,
"residency":0,
"inn":7707083893,
"phone":"+79001234567",
"extra_phone":123,
"docs_address":{...},
"postcode":101000,
"city_id":1,
"street_name":"ул. Ленина",
"house_no":1,
"office_no":10
},
"stocks":[...],
{...}
"stock_id":"2fb965f2-85e9-4213-90e7-f396e47219e7",
"address":"ул. Ленина, 1",
"address_city_id":1,
"address_latitude":55.7558,
"address_longitude":37.6173,
"note":"Въезд со двора",
"work_schedules":[...],
{...}
"stock_schedule_id":"2fb965f2-85e9-4213-90e7-f396e47219e7",
"day_of_week":0,
"start_time":"09:00:00",
"end_time":"18:00:00"
}
],
"breaks_schedules":[...],
{...}
"stock_schedule_id":"2fb965f2-85e9-4213-90e7-f396e47219e7",
"day_of_week":0,
"start_time":"09:00:00",
"end_time":"18:00:00"
}
],
"contact_persons":[...],
{...}
"contact_person_id":"2fb965f2-85e9-4213-90e7-f396e47219e7",
"name":"Иван Иванов",
"phone":"+79001234567",
"email":"driver@example.com",
"extra_phone":123
}
],
"schedule_summary":"пн–пт 09:00–18:00",
"stock_type":0,
"timeslots_binding":{...}
"warehouse_id":1001,
"status":0
}
}
],
"contact_persons":[...],
{...}
"contact_person_id":"2fb965f2-85e9-4213-90e7-f396e47219e7",
"name":"Иван Иванов",
"phone":"+79001234567",
"email":"driver@example.com",
"extra_phone":123
}
],
"ownership_name":"ООО"
}
},
"cargo":{...},
"weight":20,
"volume":40,
"adr":0,
"cargo_type_id":1,
"cargo_type":"Щебень",
"pack_type":1,
"pallet_count":11,
"belt_count":6,
"dogruz_type":0,
"sbor_gruz":false,
"size":{...}
"length":13.6,
"width":2.45,
"height":2.7,
"diameter":0,
"length_highlight":false,
"width_highlight":false,
"height_highlight":false
}
},
"transport":{...},
"car_type":200,
"car_type_string":"тентованный, рефрижератор",
"loading_type":0,
"loading_logical_operator":"OR",
"unloading_type":0,
"unloading_logical_operator":"OR",
"trucks_quantity":1,
"temperature_from":-18,
"temperature_to":-10,
"truck_attribs":0,
"stsepka":false,
"pnevmohod":false,
"koniki":false,
"tir":false,
"cmr":false,
"t1":false,
"san_passport":false,
"sanitation_logbook":false,
"is_tracking":true,
"required_capacity":20,
"team_driving":false
},
"boards":[...],
{...}
"board_id":"ati",
"name":"АТИ",
"color":"#FF6600"
}
],
"unload_first_date":"2024-06-17T00:00:00Z",
"unload_last_date":"2024-06-19T00:00:00Z"
},
"deal":{...}
"deal_id":"2fb965f2-85e9-4213-90e7-f396e47219e7",
"load_copy_id":"7c9e6679-7425-40de-944b-e07fc1f90ae7",
"load_id":"9c514669-b666-42ea-85e6-312093b93a50",
"taker_ati_id":12345,
"taker_persistent_user_id":1001,
"taker_contact_id":100,
"cargo_owner_ati_id":67890,
"cargo_owner_persistent_user_id":2002,
"updated_at":"2024-06-15T10:30:00Z",
"end_of_reservation":"2024-06-16T18:00:00Z",
"auction_id":"6ba7b810-9dad-11d1-80b4-00c04fd430c8",
"status":0,
"counterparty_status":0,
"payment":{...},
"rates":[...],
{...}
"rate":45000,
"rate_type":0,
"currency":1,
"active":true,
"vat_percent":22
}
],
"prepay_percent":30,
"prepay_percent_enabled":true,
"on_unloading":false,
"in_fuel":false,
"pay_days_enabled":true,
"pay_days":5,
"fixed_rate":true,
"torg":false,
"direct_contract":true,
"money_type":1
},
"pay_docs":{...},
"documents_copies":{...},
"checked":true,
"date":"2024-06-15T10:30:00Z"
},
"documents_original":{...},
"checked":true,
"date":"2024-06-15T10:30:00Z"
},
"documents_original_track":{...},
"transport_company_id":100,
"tracking_url":"https://files.ati.su/example",
"tracking_number":"RD123456789RU",
"sending_date":"2024-06-15T10:30:00Z"
},
"payment":{...}
"checked":true,
"date":"2024-06-15T10:30:00Z"
}
},
"files":[...],
{...}
"id":"2fb965f2-85e9-4213-90e7-f396e47219e7",
"storage_file_id":"file-abc-123",
"access":0,
"add_date":"2024-06-15T10:30:00Z",
"deal_id":"2fb965f2-85e9-4213-90e7-f396e47219e7",
"is_counterparty_file":false,
"file_name":"Накладная.pdf",
"size":102400,
"link":"https://files.ati.su/example",
"file_id":"file-abc-123",
"source_type":0,
"source_file_type":0,
"file_type":0,
"timeslots_warehouse_ids":[...]
0
]
}
],
"document_templates":[...],
{...}
"organization_address":"ул. Ленина, 1",
"templates":[...]
{...}
"add_date":"2024-06-15T10:30:00Z",
"access":0,
"timeslots_warehouse_ids":[...],
0
],
"deal_id":"2fb965f2-85e9-4213-90e7-f396e47219e7",
"deal_point_id":"2fb965f2-85e9-4213-90e7-f396e47219e7",
"owner_firm_id":12345,
"cargoes_ids_hash":0,
"contact_id":100,
"file_name":"Заявка.pdf",
"file_id":"file-abc-123",
"id":"7c9e6679-7425-40de-944b-e07fc1f90ae7",
"size":102400,
"link":"https://files.ati.su/example"
}
]
}
],
"customer":{...},
"ati_id":12345,
"source":0,
"name":"ООО Ромашка",
"ownership_id":1,
"inn":7707083893,
"ogrn":1027700132195,
"requisite":{...},
"name":"Основной счёт",
"bank":"ПАО Сбербанк",
"ks":30101810400000000000,
"registration_number":1481,
"rs":40702810938000000000,
"bik":9611925
},
"gen_director":{...},
"name":"Иван",
"surname":"Иванов",
"patronymic":"Иванович",
"number_phone":"+79001234567"
},
"contact":{...},
"name":"Иван",
"surname":"Иванов",
"patronymic":"Иванович",
"number_phone":"+79001234567",
"phone":"+74951234567",
"messenger_phone":"+79007654321",
"fax":"+74957654321",
"was_modified":false,
"selected_number":{...},
"value":"+79001234567",
"country_code":"RU"
},
"is_confirmed":true
},
"address":[...],
{...}
"is_legal":true,
"post_index":101000,
"city_id":1,
"street_name":"ул. Ленина",
"house":1,
"entrance":2,
"litera":"А",
"office_no":10,
"recipient_full_name":"Иван Иванов",
"comment":"Комментарий",
"region_id":1
}
],
"claims_count":3,
"recommendation_count":12,
"bad_partner_firms_count":2
},
"is_tracking":true,
"should_show_rate_to_driver":true,
"started_at":"2024-06-15T08:00:00Z",
"finished_at":"2024-06-20T18:00:00Z",
"denial_reason":"Грузовладелец отклонил заказ",
"taker_requisites":{...},
"requisite_id":"2fb965f2-85e9-4213-90e7-f396e47219e7",
"requisite_firm_name":"ООО Ромашка",
"signer_id":"7c9e6679-7425-40de-944b-e07fc1f90ae7",
"own_ship_id":1,
"inn":7707083893,
"kpp":770701001,
"requisite_type_id":1
},
"driver":{...},
"driver_id":"2fb965f2-85e9-4213-90e7-f396e47219e7",
"parent_id":"7c9e6679-7425-40de-944b-e07fc1f90ae7",
"first_name":"Иван",
"second_name":"Иванов",
"patronymic":"Иванович",
"phone_number":"+79001234567",
"driver_license_number":"77АА123456",
"driver_license_when_issued":"2018-04-12T00:00:00Z",
"passport_series":4510,
"passport_number":123456,
"passport_issued_by":"ОВД г. Москвы",
"passport_when_issued":"2015-06-15T00:00:00Z",
"registration":"г. Москва",
"is_attracted_driver":false,
"last_deal_related_id":"9c514669-b666-42ea-85e6-312093b93a50",
"description":"Опыт 10 лет",
"attracted_from":"ООО Ромашка",
"scans":[...],
{...}
"id":"2fb965f2-85e9-4213-90e7-f396e47219e7",
"owner_id":"7c9e6679-7425-40de-944b-e07fc1f90ae7",
"name":"ПТС.pdf",
"file_id":"file-abc-123",
"type":0
}
],
"origin":0,
"date_of_birth":"1985-03-20T00:00:00Z",
"department_code_in_passport":"770-001",
"driver_inn":7707083893,
"in_cargo_owner_black_list":false,
"external_id":"ext-driver-1",
"black_list_reasons":[...]
"string"
]
},
"truck":{...},
"truck_id":"2fb965f2-85e9-4213-90e7-f396e47219e7",
"parent_id":"7c9e6679-7425-40de-944b-e07fc1f90ae7",
"last_deal_related_id":"9c514669-b666-42ea-85e6-312093b93a50",
"type":0,
"description":"Тент 82 м³",
"brand_id":1,
"model":"Actros",
"number":"А123ВС77",
"phone_number":"+79001234567",
"is_attracted_truck":false,
"ownership_type":0,
"car_type_id":200,
"capacity":20,
"volume":82,
"length":13.6,
"width":2.45,
"height":2.7,
"manufacture_year":2020,
"vin":"WDB9340321L123456",
"vrc":"77АА123456",
"body_number":123456,
"dimension":40,
"truck_passport_number":"77ТТ123456",
"can_refrigerator":false,
"has_gen_set":false,
"truck_owner_name":"ООО Ромашка",
"can_carry_heavy_container":false,
"can_carry_tall_container":false,
"external_id":"ext-truck-1",
"verified":true,
"modification_restricted":false,
"scans":[...],
{...}
"id":"2fb965f2-85e9-4213-90e7-f396e47219e7",
"owner_id":"7c9e6679-7425-40de-944b-e07fc1f90ae7",
"name":"ПТС.pdf",
"file_id":"file-abc-123",
"type":0
}
],
"origin":0
},
"trailer":{...},
"truck_id":"2fb965f2-85e9-4213-90e7-f396e47219e7",
"parent_id":"7c9e6679-7425-40de-944b-e07fc1f90ae7",
"last_deal_related_id":"9c514669-b666-42ea-85e6-312093b93a50",
"type":0,
"description":"Тент 82 м³",
"brand_id":1,
"model":"Actros",
"number":"А123ВС77",
"phone_number":"+79001234567",
"is_attracted_truck":false,
"ownership_type":0,
"car_type_id":200,
"capacity":20,
"volume":82,
"length":13.6,
"width":2.45,
"height":2.7,
"manufacture_year":2020,
"vin":"WDB9340321L123456",
"vrc":"77АА123456",
"body_number":123456,
"dimension":40,
"truck_passport_number":"77ТТ123456",
"can_refrigerator":false,
"has_gen_set":false,
"truck_owner_name":"ООО Ромашка",
"can_carry_heavy_container":false,
"can_carry_tall_container":false,
"external_id":"ext-truck-1",
"verified":true,
"modification_restricted":false,
"scans":[...],
{...}
"id":"2fb965f2-85e9-4213-90e7-f396e47219e7",
"owner_id":"7c9e6679-7425-40de-944b-e07fc1f90ae7",
"name":"ПТС.pdf",
"file_id":"file-abc-123",
"type":0
}
],
"origin":0
},
"semi_trailer":{...},
"truck_id":"2fb965f2-85e9-4213-90e7-f396e47219e7",
"parent_id":"7c9e6679-7425-40de-944b-e07fc1f90ae7",
"last_deal_related_id":"9c514669-b666-42ea-85e6-312093b93a50",
"type":0,
"description":"Тент 82 м³",
"brand_id":1,
"model":"Actros",
"number":"А123ВС77",
"phone_number":"+79001234567",
"is_attracted_truck":false,
"ownership_type":0,
"car_type_id":200,
"capacity":20,
"volume":82,
"length":13.6,
"width":2.45,
"height":2.7,
"manufacture_year":2020,
"vin":"WDB9340321L123456",
"vrc":"77АА123456",
"body_number":123456,
"dimension":40,
"truck_passport_number":"77ТТ123456",
"can_refrigerator":false,
"has_gen_set":false,
"truck_owner_name":"ООО Ромашка",
"can_carry_heavy_container":false,
"can_carry_tall_container":false,
"external_id":"ext-truck-1",
"verified":true,
"modification_restricted":false,
"scans":[...],
{...}
"id":"2fb965f2-85e9-4213-90e7-f396e47219e7",
"owner_id":"7c9e6679-7425-40de-944b-e07fc1f90ae7",
"name":"ПТС.pdf",
"file_id":"file-abc-123",
"type":0
}
],
"origin":0
},
"document":{...},
"id":"2fb965f2-85e9-4213-90e7-f396e47219e7",
"old_id":"7c9e6679-7425-40de-944b-e07fc1f90ae7",
"editor":12345,
"url":"https://files.ati.su/example",
"old_url":"https://files.ati.su/example",
"name":"Заявка",
"is_signed":true,
"access":0
},
"additional_documents":[...],
{...}
"id":"2fb965f2-85e9-4213-90e7-f396e47219e7",
"is_counterparty_file":false,
"url":"https://files.ati.su/example",
"name":"Акт.pdf",
"is_signed":true,
"document_type":0,
"access":0
}
],
"in_work_status_model":0,
"in_work":{...},
"deal_id":"2fb965f2-85e9-4213-90e7-f396e47219e7",
"in_work_status":0,
"in_work_date":"2024-06-15T10:30:00Z",
"ati_id":12345,
"contact_id":100,
"tracker_phone":79001234567
},
"deal_note":"Просим уточнить время загрузки",
"deal_kind":0,
"points":[...]
{...}
"deal_point_id":"2fb965f2-85e9-4213-90e7-f396e47219e7",
"ordinal_id":1,
"point_type":0,
"city_id":1,
"lat":55.75,
"lon":37.62,
"address":"ул. Ленина, 1",
"participant_name":"ООО Ромашка",
"region_id":1,
"contact_name":"Иван Иванов",
"organization_id":"2fb965f2-85e9-4213-90e7-f396e47219e7",
"stock_id":"2fb965f2-85e9-4213-90e7-f396e47219e7",
"stock":{...},
"stock_id":"2fb965f2-85e9-4213-90e7-f396e47219e7",
"address":"ул. Ленина, 1",
"address_city_id":1,
"note":"Въезд со двора",
"contact_persons":[...],
{...}
"contact_person_id":"2fb965f2-85e9-4213-90e7-f396e47219e7",
"name":"Иван Иванов",
"phone":"+79001234567",
"email":"driver@example.com"
}
],
"schedule_summary":"пн–пт 09:00–18:00",
"stock_type":0,
"timeslots_warehouse_id":1001
},
"organization":{...}
"organization_id":"2fb965f2-85e9-4213-90e7-f396e47219e7",
"name":"ООО Ромашка",
"phone":"+79001234567",
"contact_persons":[...]
{...}
"contact_person_id":"2fb965f2-85e9-4213-90e7-f396e47219e7",
"name":"Иван Иванов",
"phone":"+79001234567",
"email":"driver@example.com"
}
]
}
}
]
}
}
4XX Ошибка запроса. [Подробнее про ошибки API](https://ati.su/developers/documentation/errors/)
Модель
ONE-OF

(nullable)

Пример
{...}
"reason":"Неизвестная ошибка",
"error":"unknown_server_error"
}
Отказ от приглашения. Опциональный сегмент contactId в URL устарел и игнорируется.
delete /v1.2/orders/invites/{loadId}/{contactId}
Параметры
Параметр Тип Расположение Описание
loadId обязательный string (guid) path
ID груза Пример: 2fb965f2-85e9-4213-90e7-f396e47219e7
contactId обязательный integer (int32) path
Устарело, игнорируется. Сегмент оставлен для старых URL; отказ всегда по грузу и текущему пользователю, не по контакту. Пример: 12345
Запрос
Пример запроса
curl 'https://api.ati.su/v1.2/orders/invites/{loadId}/{contactId}' \
-X 'DELETE' \
-H 'Authorization: Bearer {authorizationToken}' \
-H 'Content-Type: application/json'
Ответ
200 Успешный отказ от приглашения
Успешный ответ
4XX Ошибка запроса. [Подробнее про ошибки API](https://ati.su/developers/documentation/errors/)
Модель
ONE-OF

(nullable)

Пример
{...}
"reason":"Неизвестная ошибка",
"error":"unknown_server_error"
}

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