Как найти перевозчика на груз
Если вы опубликовали груз на персональной Площадке или включили возможность бронирования грузов , то перевозчик может забронировать ваш груз и прислать данные для оформления заявки на перевозку.
Если вы собираете встречные предложения к грузу, получить их можно одним из методов получения отзывов на груз:
Получение отзывов на конкретный груз фирмы.
На данный момент можно получить только встречные предложения.
Получение встречных предложений на грузы фирмы с одной или несколькими ставками .
Перевозчика, предложившего хорошую ставку, вы можете пригласить на Заказ.
Отправка приглашения по встречному предложению
Если вы знаете, какому перевозчику хотите отдать груз, опубликуйте груз с нужной ставкой и отправьте персональное приглашение на Заказ.
Отправка приглашения
post
/v1.2/orders/invites
Отправить
Развернуть все
Свернуть все
{
"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
}
Параметры приглашения
load_id* :
guid
Минимальное количество символов: 1
Id груза
taker_ati_id* :
string
Минимальное количество символов: 1
Id аккаунта приглашаемой фирмы
taker_contacts_list* :
[int32]
Список контактов приглашаемой фирмы
payment* :{...}
Параметры оплаты заказа. Обязательно указание хотя бы одной ставки и валюты для неё.
price :
decimal
(nullable)
currency_id :
int32
(nullable)
nds_price :
decimal
(nullable)
nds_currency_id :
int32
(nullable)
not_nds_price :
decimal
(nullable)
not_nds_currency_id :
int32
(nullable)
}
cancel_after_in_minutes :
int32
(nullable)
Через сколько минут отменить приглашение "Оформить Заказ".
Допустимое значение от 1 до 4320 минут. По умолчанию - 4320 (3 суток)
deprecated
cancellation_date :
date-time
(nullable)
Дата отмены предложения на перевозку груза, формат ISO 8601
is_tracking :
boolean
Запрос отслеживания через АТИ Водитель
}
CURL
1C
Пример ответа
Ответ
200 Приглашение отправлено
Развернуть все
Свернуть все
Развернуть все
Свернуть все
Пример
Модель
{...}
"reason" : "string" ,
"error" : "string"
}
Загрузка...
Развернуть все
Свернуть все
Загрузка...
Перевозчик получит уведомление и сможет взять груз и отправить вам данные для оформления документов.
Если же по грузу проводились Торги (Аукцион), то после их завершения груз автоматически будет забронирован за победителем, за исключением случая, когда несколько ставок будут считаться лучшими: одна - “с лучшей датой”, а другая - “с лучшей ставкой”. В этом случае победителя нужно будет выбрать вручную. Это можно сделать с помощью метода смены победителя в Торгах.
Смена победителя Торгов (аукциона)
post
/v1.2/auction/bet/win/{auctionRateId}
Отправить
Id ставки Торгов (аукциона) (выбирается одна из ставок со статусами state=[0,-3]) устанавливается победной (со статусом state=1)
CURL
1C
Пример ответа
Ответ
200 Торги (аукцион) грузовладельца
Развернуть все
Свернуть все
Пример
Модель
{...}
"accept_second_pay_type" : true ,
"active_deal_id" : "c7ba865c-6dd2-43e4-bb29-66df7583989a" ,
"auction_id" : "c771ed18-84e4-4ab8-8f91-1be412274d86" ,
"auction_rates" : [...],
{...},
"added_at" : "2023-04-24T11:31:52.0690515Z" ,
"ati_id" : "12345" ,
"auction_rate_id" : "5a2e6b1c-b02a-45b0-9136-f64a9236ab21" ,
"contact_id" : 0 ,
"loading_date" : null ,
"rate_with_nds" : 5500 ,
"rate_without_nds" : 6600 ,
"source" : 0 ,
"state" : 0
} ,
{...}
"added_at" : "2023-04-24T11:32:52.0690605Z" ,
"ati_id" : "33345" ,
"auction_rate_id" : "cd342abc-ac8d-4b08-87d3-def8f125b28d" ,
"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:52.0690757Z" ,
"duration" : 6 ,
"end_date" : "2023-04-24T11:36:52.0690878Z" ,
"end_date_boundary" : "2023-04-24T11:36:52.0690866Z" ,
"finish_type" : 0 ,
"finished" : true ,
"is_docs_expired" : false ,
"load_id" : "a86db870-967e-4893-b6e1-fef16c73b054" ,
"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:52.069361Z" ,
"start_date" : "2023-04-24T11:30:52.0690743Z" ,
"start_since_first_bet" : false ,
"state" : 0 ,
"step" : 500 ,
"time_to_provide_documents" : 3 ,
"win_date" : "2023-04-24T11:36:52.0690844Z" ,
"winner_criterion" : 0
}
{...}
Торги (аукцион) для грузовладельца
accept_second_pay_type :
boolean
Возможность принимать другой тип оплаты (с НДС или без НДС)
active_deal_id :
uuid
Id сделки, привязанной к Торгам (аукциону)
auction_rates :[{...}]
Список ставок по Торгам (аукциону)
ati_id* :
string
Фирма, поставившая ставку
loading_date :
date-time
Ближайшая возможная для перевозчика дата загрузки. Используется только в Торгах с критерием победы по ставке и дате загрузки
rate_with_nds :
double
Ставка c НДС на груз, выставленная перевозчиком
rate_without_nds :
double
Ставка без НДС на груз, выставленная перевозчиком
source :
enum
[0, 1]
Система, на стороне которой сделана ставка
state* :
enum
[0, 1, -8, -7, -6, -5, -4, -3, -2]
Статус ставки
-8
- Грузоотправитель отклонил документ
-7
- Победитель отклонил документ
-6
- Победитель отменил сделку
-5
- Грузовладелец отменил сделку
-4
- Победитель отказался, теперь его нельзя выбрать больше в качестве победителя
-3
- Бывший победитель
-2
- Перевозчик отказался от участия
0
- Непобедная ставка при завершении Торгов (аукциона)
1
- Победная ставка
}]
auction_restart_parameters :{...}
Параметры перезапуска торгов
auction_finish_action :
enum
[1, 2, 3]
Финальное действие после завершения аукциона
1
— Опубликовать груз со ставкой
2
— Опубликовать груз с запросом ставки
3
— Удалить груз
current_change_winner_count :
int32
Оставшееся количество попыток выбора нового победителя
current_restart_count :
int32
Оставшееся количество попыток перезапуска торгов
duration_after_restart :
int32
Длительность торгов в минутах после перезапуска
init_change_winner_count :
int32
Начальное количество попыток выбора нового победителя
init_restart_count :
int32
Начальное количество попыток перезапуска торгов
is_manually_restarted :
boolean
Параметр, показывающий, был ли последний перезапуск выбран вручную
rate_increase :
double
Повышение ставки при перезапуске
rate_increase_option :
enum
[1, 2]
Способ повышения ставки
1
— Повышение ставки в валюте
2
— Повышение ставки в процентах
}
auto_renew* :
boolean
Автопродление Торгов (аукциона) при выставлении ставки в последние 5 минут до окончания Торгов (аукциона)
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 (в минутах)
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
- Выбор победителя происходит по ставке и дате загрузки. Если нет лучшей ставки с лучшей датой - требуется выбор победителя вручную
}
403 У вас нет доступа на установление победной ставки
Развернуть все
Свернуть все
404 Торги (аукцион) не найдены, либо груз не найден
Развернуть все
Свернуть все
Загрузка...
Развернуть все
Свернуть все
Загрузка...
После того, как победитель возьмет груз и отправит вам данные, вы сможете оформить с ним Заказ.
Полная документация API Торгов .