Skip to content
Для ИИ NEW Мои токены Поддержка
Чат для вопросов по API Мгновенно ответим на ваши вопросы
api@ati.su Электронная почта техподдержки
Тикетная система Оставить заявку на отдел "Консультанты по интеграции (API)"
api.ati.su - заказы, торги, площадки Наш телеграм-канал
Для подтверждения действия введите пароль
Чтобы продолжить, введите пароль для пользователя
Отменить
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.

OpenAPI · Markdown

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

Методы для работы с приглашениями «Оформить заявку»

Отправка приглашения

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

Отправка приглашения. Отправляет приглашение оформить заказ грузоперевозчику с оповещением *Отправленное повторно приглашение удалит предыдущее*
post /v1.2/orders/invites
Параметры
Параметров нет
Запрос
Модель
ONE-OF

(nullable)

Пример запроса 
curl 'https://api.ati.su/v1.2/orders/invites' \
  -X 'POST' \
  -H 'Authorization: Bearer {authorizationToken}' \
  -H 'Content-Type: application/json' \
  --data-raw '{"load_id":"7a48a9d3-55cb-48a2-8527-35ff461eeb8c","taker_ati_id":"14612","taker_contacts_list":[0],"payment":{"rates":[{"rate_type":0,"rate":120000,"currency":1,"vat_percent":22}],"price":10000,"currency_id":32,"nds_price":12000,"nds_currency_id":1,"not_nds_price":10000,"not_nds_currency_id":1},"cancellation_date":"2024-06-16T12:00:00Z","is_tracking":true}'
Ответ
200 Приглашение отправлено
Успешный ответ
4XX Ошибка запроса. [Подробнее про ошибки API](https://ati.su/developers/documentation/errors/)
Модель
ONE-OF

(nullable)

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

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

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

Отправка приглашения по встречному предложению. Отправляет приглашение оформить заказ грузоперевозчику по встречному предложению
post /v1.2/orders/invites/counter_offer
Параметры
Параметров нет
Запрос
Модель
ONE-OF

(nullable)

Пример запроса 
curl 'https://api.ati.su/v1.2/orders/invites/counter_offer' \
  -X 'POST' \
  -H 'Authorization: Bearer {authorizationToken}' \
  -H 'Content-Type: application/json' \
  --data-raw '{"load_id":"7a48a9d3-55cb-48a2-8527-35ff461eeb8c","response_id":"5026ffdd-4c2a-eb11-bb90-0025906a774d","rate_types":[0],"cancel_after_in_minutes":60,"need_archive_on_invite":false}'
Ответ
200 Приглашение отправлено
Успешный ответ
4XX Ошибка запроса. [Подробнее про ошибки API](https://ati.su/developers/documentation/errors/)
Модель
ONE-OF

(nullable)

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

Получение отправленных приглашений по грузу

Получение отправленных приглашений.
get /v1.2/orders/invites/{loadId}
Параметры
Параметр Тип Расположение Описание
loadId обязательный string (guid) path
ID груза Пример: 2fb965f2-85e9-4213-90e7-f396e47219e7
Запрос
Пример запроса 
curl 'https://api.ati.su/v1.2/orders/invites/{loadId}' \
  -X 'GET' \
  -H 'Authorization: Bearer {authorizationToken}' \
  -H 'Content-Type: application/json'
Ответ
200 Отправленные приглашения
Модель
[{...}]

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

load_id: guid

Id груза.

taker_ati_id: string

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

taker_persistent_user_id: int32

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

taker_contacts_list: [int32]

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

taker_contact_id: int32

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

deprecated
date: date-time

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

cancellation_date: date-time (nullable)

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

deal_kind:

Тип заказа.

* 0 — Заказ невозможен
* 1 — Взятие груза из поиска
* 2 — Заказ из торгов
* 4 — Предложение груза
* 8 — Из перехвата машин
* 16 — Односторонний заказ
* 32 — Предложение груза из встречного предложения
* 64 — Предложение груза по контракту

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

Тип заказа.

  • 0 — Заказ невозможен
  • 1 — Взятие груза из поиска
  • 2 — Заказ из торгов
  • 4 — Предложение груза
  • 8 — Из перехвата машин
  • 16 — Односторонний заказ
  • 32 — Предложение груза из встречного предложения
  • 64 — Предложение груза по контракту
  • 128 — Создан вручную для тестирования черновиков
  • 256 — Создан из АТИ-Доков
payment:

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

ONE-OF
is_tracking: boolean

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

}]
Пример
[...]
{...}
"load_id":"2fb965f2-85e9-4213-90e7-f396e47219e7",
"taker_ati_id":12345,
"taker_persistent_user_id":1001,
"taker_contacts_list":[...],
0
],
"date":"2024-06-15T10:30:00Z",
"cancellation_date":"2024-06-16T12:00:00Z",
"deal_kind":0,
"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
},
"is_tracking":true
}
]
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"
}

Отказ от приглашения

Отказ от приглашения. Опциональный сегмент 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"
}

Удаление приглашения

Удаление предложения.
delete /v1.2/orders/invites/by_taker_id/{loadId}/{takerAtiId}
Параметры
Параметр Тип Расположение Описание
loadId обязательный string (guid) path
ID груза Пример: 2fb965f2-85e9-4213-90e7-f396e47219e7
takerAtiId обязательный string path
Id аккаунта приглашаемой фирмы Пример: 12345
Запрос
Пример запроса 
curl 'https://api.ati.su/v1.2/orders/invites/by_taker_id/{loadId}/{takerAtiId}' \
  -X 'DELETE' \
  -H 'Authorization: Bearer {authorizationToken}' \
  -H 'Content-Type: application/json'
Ответ
200 Успешное удаление предложения
Успешный ответ