Skip to content
Мои токены Поддержка
Авторизоваться
Для подтверждения действия введите пароль
Чтобы продолжить, введите пароль для пользователя

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

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

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

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

Отправка приглашения
post /v1.2/orders/invites
Запрос
Модель
{...}
load_id*: guid
Минимальное количество символов: 1

Id груза

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

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

taker_contacts_list*: [int32]

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

cancel_after_in_minutes: int32 (nullable)

Через сколько минут отменить приглашение "Оформить Заказ". Допустимое значение от 1 до 4320 минут. По умолчанию - 4320 (3 суток)

deprecated
cancellation_date: date-time (nullable)

Дата отмены предложения на перевозку груза, формат ISO 8601

is_tracking: boolean

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

}
Пример запроса
curl 'https://api.ati.su/v1.2/orders/invites' \
-X 'POST' \
-H 'Authorization: Bearer {authorizationToken}' \
-H 'Content-Type: application/json' \
--data-raw '{"load_id":"7a48a9d3-55cb-48a2-8527-35ff461eeb8c","taker_ati_id":"14612","taker_contacts_list":[0],"payment":{"price":10000,"currency_id":32,"nds_price":0.5,"nds_currency_id":0,"not_nds_price":0.5,"not_nds_currency_id":0},"cancellation_date":"1970-01-01T00:00:00.000Z","is_tracking":false}'
Ответ
200 Приглашение отправлено
Модель
null
Пример
null
4XX Ошибка запроса. [Подробнее про ошибки API](https://ati.su/developers/documentation/errors/)
Модель
{...}

Модель ошибки

reason: string

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

error: string

Ключ ошибки

}
Пример
{...}
"reason":"string",
"error":"string"
}

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

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

Отправка приглашения по встречному предложению
post /v1.2/orders/invites/counter_offer
Запрос
Модель
{...}
load_id: guid

Id груза

response_id: guid

Id встречного приглашения. Значение из метода получения отзывов

rate_types: [enum]
[0, 1, 2]

По каким ставкам отправить приглашение. Типы ставок:

  • 0 — наличные
  • 1 — б/нал с НДС
  • 2 — б/нал без НДС
cancel_after_in_minutes: int32 (nullable)

Через сколько минут отменить приглашение "Оформить Заказ". Допустимое значение от 1 до 4320 минут. По умолчанию - 4320 (3 суток)

is_auto: boolean

Приглашение создано автоматически

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

Модель ошибки

reason: string

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

error: string

Ключ ошибки

}
Пример
{...}
"reason":"string",
"error":"string"
}

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

Получение отправленных приглашений
get /v1.2/orders/invites/{loadId}
Запрос
Пример запроса
curl 'https://api.ati.su/v1.2/orders/invites/{loadId}' \
-X 'GET' \
-H 'Authorization: Bearer {authorizationToken}' \
-H 'Content-Type: application/json'
Ответ
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: enum
[0, 1, 2, 4, 8, 16, 32, 64]

Тип Заказа

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

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

}]
Пример
[...]
{...}
"load_id":"3fa85f64-5717-4562-b3fc-2c963f66afa6",
"taker_ati_id":"string",
"taker_persistent_user_id":0,
"taker_contacts_list":[...],
0
],
"date":"1970-01-01T00:00:00.000Z",
"cancellation_date":"1970-01-01T00:00:00.000Z",
"deal_kind":0,
"payment":{...},
"rates":[...],
{...}
"rate":0.5,
"rate_type":0,
"currency":0
}
],
"prepay_percent":0,
"prepay_percent_enabled":false,
"on_unloading":false,
"in_fuel":false,
"pay_days_enabled":false,
"pay_days":0,
"fixed_rate":false,
"torg":false,
"direct_contract":false,
"money_type":0,
"payment_source":0
},
"is_tracking":false
}
]
4XX Ошибка запроса. [Подробнее про ошибки API](https://ati.su/developers/documentation/errors/)
Модель
{...}

Модель ошибки

reason: string

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

error: string

Ключ ошибки

}
Пример
{...}
"reason":"string",
"error":"string"
}

Получение всех приглашений пользователя в зависимости от роли

Получение списка приглашений
get /v1.2/orders/invites/my
Запрос
Пример запроса
curl 'https://api.ati.su/v1.2/orders/invites/my' \
-X 'GET' \
-H 'Authorization: Bearer {authorizationToken}' \
-H 'Content-Type: application/json'
Ответ
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)

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

is_tracking: boolean

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

deal_kind: enum
[0, 1, 2, 4, 8, 16, 32, 64]

Тип Заказа

  • 0 — Заказ невозможен
  • 1 — Взятие груза из поиска
  • 2 — Заказ из Торгов
  • 4 — Предложение груза
  • 8 — Из перехвата машин
  • 16 — Односторонний заказ
  • 32 — Предложение груза из встречного предложения
  • 64 — Предложение груза по контракту
}]
Пример
[...]
{...}
"owner_ati_id":"string",
"owner_persistent_user_id":0,
"owner_contact_id":0,
"taker_ati_id":"string",
"taker_persistent_user_id":0,
"taker_contact_id":0,
"taker_contacts_list":[...],
0
],
"date":"1970-01-01T00:00:00.000Z",
"cancellation_date":"1970-01-01T00:00:00.000Z",
"payment":{...},
"rates":[...],
{...}
"rate":0.5,
"rate_type":0,
"currency":0
}
],
"prepay_percent":0,
"prepay_percent_enabled":false,
"on_unloading":false,
"in_fuel":false,
"pay_days_enabled":false,
"pay_days":0,
"fixed_rate":false,
"torg":false,
"direct_contract":false,
"money_type":0,
"payment_source":0
},
"load":{...},
"id":"3fa85f64-5717-4562-b3fc-2c963f66afa6",
"load_number":"string",
"distance":0,
"distance_type":0,
"platon_roads_length":0,
"toll_roads_length":0,
"travel_time":"?",
"true_price":0,
"true_currency_id":0,
"note":"string",
"first_date":"1970-01-01T00:00:00.000Z",
"last_date":"1970-01-01T00:00:00.000Z",
"date_type":0,
"periodicity_id":0,
"order_number":"string",
"krugoreis":false,
"zimnik":false,
"ferries":false,
"loading":{...},
"fias_id":"3fa85f64-5717-4562-b3fc-2c963f66afa6",
"city_id":0,
"latitude":0.5,
"longitude":0.5,
"street":"string",
"organization_id":"3fa85f64-5717-4562-b3fc-2c963f66afa6",
"address_id":"3fa85f64-5717-4562-b3fc-2c963f66afa6",
"time_start":"1970-01-01T00:00:00.000Z",
"time_end":"1970-01-01T00:00:00.000Z",
"is_round_the_clock":false,
"large_cities":[...],
0
],
"large_cities_with_distance":[...],
{...}
"city_id":0,
"distance":0.5
}
],
"loading_cargos":[...],
{...}
"cargo_id":0,
"name_id":0,
"name":"string",
"packaging_type":0,
"packaging_quantity":0,
"weight":0.5,
"volume":0.5,
"sizes":{...},
"length":0.5,
"width":0.5,
"height":0.5,
"diameter":0.5,
"length_highlight":false,
"width_highlight":false,
"height_highlight":false
},
"packaging_type_name":"string"
}
],
"organization":{...}
"organization_id":"3fa85f64-5717-4562-b3fc-2c963f66afa6",
"firm_id":0,
"name":"string",
"ownership":0,
"residency":0,
"inn":"string",
"phone":"string",
"extra_phone":0,
"docs_address":{...},
"postcode":"string",
"city_id":0,
"street_name":"string",
"house_no":"string",
"office_no":"string"
},
"stocks":[...],
{...}
"stock_id":"3fa85f64-5717-4562-b3fc-2c963f66afa6",
"address":"string",
"address_city_id":0,
"address_latitude":0.5,
"address_longitude":0.5,
"note":"string",
"work_schedules":[...],
{...}
"stock_schedule_id":"3fa85f64-5717-4562-b3fc-2c963f66afa6",
"day_of_week":0,
"start_time":"?",
"end_time":"?"
}
],
"breaks_schedules":[...],
{...}
"stock_schedule_id":"3fa85f64-5717-4562-b3fc-2c963f66afa6",
"day_of_week":0,
"start_time":"?",
"end_time":"?"
}
],
"contact_persons":[...],
{...}
"contact_person_id":"3fa85f64-5717-4562-b3fc-2c963f66afa6",
"name":"string",
"phone":"string",
"email":"string"
}
],
"schedule_summary":"string",
"stock_type":0,
"timeslots_binding":{...}
"warehouse_id":0,
"status":0
}
}
],
"contact_persons":[...],
{...}
"contact_person_id":"3fa85f64-5717-4562-b3fc-2c963f66afa6",
"name":"string",
"phone":"string",
"email":"string"
}
],
"ownership_name":"string"
}
},
"extra_points":[...],
{...}
"route_point_id":"3fa85f64-5717-4562-b3fc-2c963f66afa6",
"id":"3fa85f64-5717-4562-b3fc-2c963f66afa6",
"load_id":"3fa85f64-5717-4562-b3fc-2c963f66afa6",
"city_id":0,
"point_type":0,
"ordinal_id":0,
"distance":0,
"street":"string",
"latitude":0.5,
"longitude":0.5,
"organization_id":"3fa85f64-5717-4562-b3fc-2c963f66afa6",
"address_id":"3fa85f64-5717-4562-b3fc-2c963f66afa6",
"loading_date_start":"1970-01-01T00:00:00.000Z",
"loading_date_end":"1970-01-01T00:00:00.000Z",
"loading_time_start":null,
"loading_time_end":null,
"is_round_the_clock":false,
"city_name":"string",
"loading_cargos":[...],
{...}
"cargo_id":0,
"name_id":0,
"name":"string",
"packaging_type":0,
"packaging_quantity":0,
"weight":0.5,
"volume":0.5,
"sizes":{...},
"length":0.5,
"width":0.5,
"height":0.5,
"diameter":0.5,
"length_highlight":false,
"width_highlight":false,
"height_highlight":false
},
"packaging_type_name":"string"
}
],
"unloading_cargos":[...],
{...}
"cargo_id":0,
"weight":0.5,
"volume":0.5,
"packaging_quantity":0,
"is_defined_by_ttn":false
}
],
"organization":{...}
"organization_id":"3fa85f64-5717-4562-b3fc-2c963f66afa6",
"firm_id":0,
"name":"string",
"ownership":0,
"residency":0,
"inn":"string",
"phone":"string",
"extra_phone":0,
"docs_address":{...},
"postcode":"string",
"city_id":0,
"street_name":"string",
"house_no":"string",
"office_no":"string"
},
"stocks":[...],
{...}
"stock_id":"3fa85f64-5717-4562-b3fc-2c963f66afa6",
"address":"string",
"address_city_id":0,
"address_latitude":0.5,
"address_longitude":0.5,
"note":"string",
"work_schedules":[...],
{...}
"stock_schedule_id":"3fa85f64-5717-4562-b3fc-2c963f66afa6",
"day_of_week":0,
"start_time":"?",
"end_time":"?"
}
],
"breaks_schedules":[...],
{...}
"stock_schedule_id":"3fa85f64-5717-4562-b3fc-2c963f66afa6",
"day_of_week":0,
"start_time":"?",
"end_time":"?"
}
],
"contact_persons":[...],
{...}
"contact_person_id":"3fa85f64-5717-4562-b3fc-2c963f66afa6",
"name":"string",
"phone":"string",
"email":"string"
}
],
"schedule_summary":"string",
"stock_type":0,
"timeslots_binding":{...}
"warehouse_id":0,
"status":0
}
}
],
"contact_persons":[...],
{...}
"contact_person_id":"3fa85f64-5717-4562-b3fc-2c963f66afa6",
"name":"string",
"phone":"string",
"email":"string"
}
],
"ownership_name":"string"
}
}
],
"unloading":{...},
"fias_id":"3fa85f64-5717-4562-b3fc-2c963f66afa6",
"city_id":0,
"latitude":0.5,
"longitude":0.5,
"street":"string",
"organization_id":"3fa85f64-5717-4562-b3fc-2c963f66afa6",
"address_id":"3fa85f64-5717-4562-b3fc-2c963f66afa6",
"time_start":"1970-01-01T00:00:00.000Z",
"time_end":"1970-01-01T00:00:00.000Z",
"is_round_the_clock":false,
"large_cities":[...],
0
],
"large_cities_with_distance":[...],
{...}
"city_id":0,
"distance":0.5
}
],
"loading_cargos":[...],
{...}
"cargo_id":0,
"name_id":0,
"name":"string",
"packaging_type":0,
"packaging_quantity":0,
"weight":0.5,
"volume":0.5,
"sizes":{...},
"length":0.5,
"width":0.5,
"height":0.5,
"diameter":0.5,
"length_highlight":false,
"width_highlight":false,
"height_highlight":false
},
"packaging_type_name":"string"
}
],
"organization":{...}
"organization_id":"3fa85f64-5717-4562-b3fc-2c963f66afa6",
"firm_id":0,
"name":"string",
"ownership":0,
"residency":0,
"inn":"string",
"phone":"string",
"extra_phone":0,
"docs_address":{...},
"postcode":"string",
"city_id":0,
"street_name":"string",
"house_no":"string",
"office_no":"string"
},
"stocks":[...],
{...}
"stock_id":"3fa85f64-5717-4562-b3fc-2c963f66afa6",
"address":"string",
"address_city_id":0,
"address_latitude":0.5,
"address_longitude":0.5,
"note":"string",
"work_schedules":[...],
{...}
"stock_schedule_id":"3fa85f64-5717-4562-b3fc-2c963f66afa6",
"day_of_week":0,
"start_time":"?",
"end_time":"?"
}
],
"breaks_schedules":[...],
{...}
"stock_schedule_id":"3fa85f64-5717-4562-b3fc-2c963f66afa6",
"day_of_week":0,
"start_time":"?",
"end_time":"?"
}
],
"contact_persons":[...],
{...}
"contact_person_id":"3fa85f64-5717-4562-b3fc-2c963f66afa6",
"name":"string",
"phone":"string",
"email":"string"
}
],
"schedule_summary":"string",
"stock_type":0,
"timeslots_binding":{...}
"warehouse_id":0,
"status":0
}
}
],
"contact_persons":[...],
{...}
"contact_person_id":"3fa85f64-5717-4562-b3fc-2c963f66afa6",
"name":"string",
"phone":"string",
"email":"string"
}
],
"ownership_name":"string"
}
},
"cargo":{...},
"weight":0.5,
"volume":0.5,
"adr":0,
"cargo_type_id":0,
"cargo_type":"string",
"pack_type":0,
"pallet_count":0,
"belt_count":0,
"dogruz_type":0,
"sbor_gruz":false,
"size":{...}
"length":0.5,
"width":0.5,
"height":0.5,
"diameter":0.5,
"length_highlight":false,
"width_highlight":false,
"height_highlight":false
}
},
"transport":{...},
"car_type":0,
"car_type_string":"string",
"loading_type":0,
"loading_logical_operator":"string",
"unloading_type":0,
"unloading_logical_operator":"string",
"trucks_quantity":0,
"temperature_from":0,
"temperature_to":0,
"stsepka":false,
"pnevmohod":false,
"koniki":false,
"tir":false,
"cmr":false,
"t1":false,
"san_passport":false,
"is_tracking":false,
"required_capacity":0.5
},
"unload_first_date":"1970-01-01T00:00:00.000Z",
"unload_last_date":"1970-01-01T00:00:00.000Z"
},
"is_tracking":false,
"deal_kind":0
}
]
4XX Ошибка запроса. [Подробнее про ошибки API](https://ati.su/developers/documentation/errors/)
Модель
{...}

Модель ошибки

reason: string

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

error: string

Ключ ошибки

}
Пример
{...}
"reason":"string",
"error":"string"
}

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

Отказ от приглашения
delete /v1.2/orders/invites/{loadId}/{contactId}
Запрос
Пример запроса
curl 'https://api.ati.su/v1.2/orders/invites/{loadId}/{contactId}' \
-X 'DELETE' \
-H 'Authorization: Bearer {authorizationToken}' \
-H 'Content-Type: application/json'
Ответ
200 Успешный отказ от приглашения
Модель
null
Пример
null
4XX Ошибка запроса. [Подробнее про ошибки API](https://ati.su/developers/documentation/errors/)
Модель
{...}

Модель ошибки

reason: string

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

error: string

Ключ ошибки

}
Пример
{...}
"reason":"string",
"error":"string"
}

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

Удаление предложения
delete /v1.2/orders/invites/by_taker_id/{loadId}/{takerAtiId}
Запрос
Пример запроса
curl 'https://api.ati.su/v1.2/orders/invites/by_taker_id/{loadId}/{takerAtiId}' \
-X 'DELETE' \
-H 'Authorization: Bearer {authorizationToken}' \
-H 'Content-Type: application/json'
Ответ
200 Успешное удаление предложения
Модель
null
Пример
null