Помощь
Чат для вопросов по API
Мгновенно ответим на ваши вопросы
api@ati.su
Электронная почта техподдержки
Тикетная система
Оставить заявку на отдел
«Консультанты по интеграции (API)»
api.ati.su - заказы, торги, площадки
Наш телеграм-канал
Код в АТИ:
Выход

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

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

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

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

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

Id груза

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

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

taker_contact_id*: int32

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

cancel_after_in_minutes: int32

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

}
CURL 1C
CURL
Копировать

                
1C
Копировать

                
Пример ответа Ответ
200 Приглашение отправлено
Развернуть все Свернуть все
4XX Ошибка запроса. Подробнее про ошибки API
Развернуть все Свернуть все
Пример Модель
{...}
"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

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

}
CURL 1C
CURL
Копировать

                
1C
Копировать

                
Пример ответа Ответ
200 Приглашение отправлено
Развернуть все Свернуть все
4XX Ошибка запроса. Подробнее про ошибки API
Развернуть все Свернуть все
Пример Модель
{...}
"reason":"string",
"error":"string"
}
{...}

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

reason: string

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

error: string

Ключ ошибки

}
Загрузка...
Развернуть все Свернуть все
Загрузка...

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

 
Получение отправленных приглашений
get
/v1.2/orders/invites/{loadId}
CURL 1C
CURL
Копировать

                
1C
Копировать

                
Пример ответа Ответ
200 Отправленные приглашения
Развернуть все Свернуть все
Пример Модель
[...]
{...}
"taker_ati_id":"string",
"taker_contact_id":0,
"date":"1970-01-01T00:00:00.000Z",
"cancellation_date":"1970-01-01T00:00:00.000Z",
"deal_kind":0
}
]
[{...}]
taker_ati_id: string

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

taker_contact_id: int32

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

date: date-time

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

cancellation_date: date-time

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

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

Тип Заказа

  • 0 — Заказ невозможен
  • 1 — Взятие груза из поиска
  • 2 — Из Торгов (аукциона)
  • 4 — Персональное приглашение
  • 8 — Из перехвата машин
  • 16 — Односторонний заказ
  • 32 — Приглашение из встречного предложения
}]
4XX Ошибка запроса. Подробнее про ошибки API
Развернуть все Свернуть все
Пример Модель
{...}
"reason":"string",
"error":"string"
}
{...}

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

reason: string

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

error: string

Ключ ошибки

}
Загрузка...
Развернуть все Свернуть все
Загрузка...

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

 
Получение списка приглашений
get
/v1.2/orders/invites/my
CURL 1C
CURL
Копировать

                
1C
Копировать

                
Пример ответа Ответ
200 Список приглашений на перевозку груза
Развернуть все Свернуть все
Пример Модель
[...]
{...}
"owner_ati_id":"string",
"owner_contact_id":0,
"taker_ati_id":"string",
"taker_contact_id":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
},
"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",
"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
}
]
},
"extra_points":[...],
{...}
"city_id":0,
"point_type":0,
"ordinal_id":0,
"distance":0,
"street":"string",
"latitude":0.5,
"longitude":0.5
}
],
"unloading":{...},
"fias_id":"3fa85f64-5717-4562-b3fc-2c963f66afa6",
"city_id":0,
"latitude":0.5,
"longitude":0.5,
"street":"string",
"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
}
]
},
"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,
"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
},
"unload_first_date":"1970-01-01T00:00:00.000Z",
"unload_last_date":"1970-01-01T00:00:00.000Z"
}
}
]
[{...}]
owner_ati_id: string

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

owner_contact_id: int32

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

taker_ati_id: string

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

taker_contact_id: int32

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

date: date-time

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

cancellation_date: date-time

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

}]
4XX Ошибка запроса. Подробнее про ошибки API
Развернуть все Свернуть все
Пример Модель
{...}
"reason":"string",
"error":"string"
}
{...}

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

reason: string

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

error: string

Ключ ошибки

}
Загрузка...
Развернуть все Свернуть все
Загрузка...

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

 
Отказ от приглашения
delete
/v1.2/orders/invites/{loadId}/{contactId}
CURL 1C
CURL
Копировать

                
1C
Копировать

                
Пример ответа Ответ
200 Успешный отказ от приглашения
Развернуть все Свернуть все
4XX Ошибка запроса. Подробнее про ошибки API
Развернуть все Свернуть все
Пример Модель
{...}
"reason":"string",
"error":"string"
}
{...}

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

reason: string

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

error: string

Ключ ошибки

}
Загрузка...
Развернуть все Свернуть все
Загрузка...