# API для работы с Торгами (аукционами) ## Возможности API API Торгов (аукционов) позволяет работать с [Торгами](https://help.ati.su/auktsiony-v-ati) от лица грузовладельца или перевозчика. **Грузовладелец** может: - [Получить Торги (аукцион) по ID](#get-v1.2-auction-%7bauctionId%7d) - [Получить список Торгов (аукционов) по набору ID](#post-v1.2-auction-byids) - [Отменить Торги (аукцион)](#delete-v1.2-auction-%7bauctionId%7d) - [Досрочно завершить Торги (аукцион)](#post-v1.2-auction-%7bauctionId%7d-finish_aot) - [Изменить победителя после завершения Торгов (аукциона)](#post-v1.2-auction-bet-win-%7bauctionRateId%7d) **Перевозчик** может: - [Получить Торги (аукцион)](#get-v1.2-auction-%7bauctionId%7d) - [Поставить ставку](#post-v1.2-auction-bet) - [Отменить ставку](#post-v1.2-auction-bet-refuse-%7bauctionRateId%7d) - [Отказаться от победы в Торгах (аукционе)](#post-v1.2-auction-%7bauctionId%7d-refuse) ## Как проходят Торги (аукцион) ![auction_flow](~/images/auction/auction_flow.png) :::caution API позволяет работать с уже существующими Торгами (аукционами). Сами Торги создаются при добавлении груза с помощью [API грузов](https://ati.su/developers/raw/api/loads/index.md) ::: ## Для грузовладельца Торги (аукцион) начинаются с создания груза с Торгами (аукционом) и его публикации. Далее участники делают, перебивают, отменяют ставки. Далее вы можете получить информацию о нужных Торгах с помощью соответствующих методов. На основе полученной информации вы решаете, что делать дальше: 1. **Если Торги (аукцион) не завершились:** - завершить Торги досрочно. В этом случае побеждает участник с лучшей на момент завершения ставкой; - отменить Торги. 2. **Если Торги (аукцион) завершились (с победителем или без):** - сменить победителя при его наличии; - отменить Торги. #### Завершение Торгов (аукциона) Торги (аукцион) могут быть завершены тремя способами: 1. автоматически по времени; 2. автоматически по минимальной ставке; 3. досрочно по инициативе грузовладельца. ## Для перевозчика О наличии Торгов (аукционов) вы можете узнать, [получив грузы по площадкам](https://ati.su/developers/raw/api/loads/published.md#get-v1.0-loads-search-byboards). За наличие аукциона в грузе отвечает поле `AuctionID`. Зная `Id` Торгов (аукциона) вы можете: - [Получить информацию о Торгах (аукционе)](#get-v1.2-auction-%7bauctionId%7d) - [Поставить ставку](#post-v1.2-auction-bet) - [Отменить ставку](#post-v1.2-auction-bet-refuse-%7bauctionRateId%7d) - [Отказаться от победы](#post-v1.2-auction-%7bauctionId%7d-refuse) :::caution Отменить ставку можно не позднее, чем через 30 секунд после ее выставления. ::: ## Методы для работы с Торгами (аукционами) #### Получение списка торгов для грузовладельца Получение всех Торгов (аукционов) для грузовладельца **Пример запроса (curl):** ```bash curl 'https://api.ati.su/v1.2/auction' \ -X 'GET' \ -H 'Authorization: Bearer {authorizationToken}' \ -H 'Content-Type: application/json' ``` **OpenAPI схема:** [JSON](https://ati.su/developers/raw/api/auctions.openapi.json) **Пример ответа (200)** ```json [ { "accept_second_pay_type": true, "active_deal_id": "adb51ee2-2eda-4e1b-9081-6d95f10e8466", "auction_id": "e1143412-6bf4-43f3-932b-d00f9a65849c", "auction_rates": [ { "added_at": "2023-04-24T11:31:51.9748922Z", "ati_id": "12345", "auction_rate_id": "8afae956-adcd-4bdd-9676-f3a8485a6d25", "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.9749001Z", "ati_id": "33345", "auction_rate_id": "789d9dea-98d5-4a71-8c9d-de9be2ca6b86", "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.9749155Z", "duration": 6, "end_date": "2023-04-24T11:36:51.9749281Z", "end_date_boundary": "2023-04-24T11:36:51.9749281Z", "finish_type": 0, "finished": true, "is_docs_expired": false, "load_id": "aeae42f6-0102-46e4-8310-2fa8cd23d771", "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.9752751Z", "start_date": "2023-04-24T11:30:51.9749144Z", "start_since_first_bet": false, "state": 0, "step": 500, "time_to_provide_documents": 3, "win_date": "2023-04-24T11:36:51.9749244Z", "winner_criterion": 0 } ] ``` **Описание полей ответа** - `[].accept_second_pay_type` — Возможность принимать другой тип оплаты (с НДС или без НДС) - `[].active_deal_id` — Id сделки, привязанной к Торгам (аукциону) - `[].auction_id` — Id Торгов (аукциона) - `[].auction_rates` — Список ставок по Торгам (аукциону) - `[].auction_rates[].added_at` — Дата добавления - `[].auction_rates[].ati_id` — Фирма, поставившая ставку - `[].auction_rates[].auction_rate_id` — Id ставки - `[].auction_rates[].contact_id` — Контакт - `[].auction_rates[].loading_date` — Ближайшая возможная для перевозчика дата загрузки. Используется только в Торгах с критерием победы по ставке и дате загрузки - `[].auction_rates[].rate_with_nds` — Ставка c НДС на груз, выставленная перевозчиком - `[].auction_rates[].rate_without_nds` — Ставка без НДС на груз, выставленная перевозчиком - `[].auction_rates[].source` — Система, на стороне которой сделана ставка - `[].auction_rates[].state` — Статус ставки * `-8` - Грузоотправитель отклонил документ * `-7` - Победитель отклонил документ * `-6` - Победитель отменил сделку * `-5` - Грузовладелец отменил сделку * `-4` - Победитель отказался, теперь его нельзя выбрать больше в качестве победителя * `-3` - Бывший победитель * `-2` - Перевозчик отказался от участия * `0` - Непобедная ставка при завершении Торгов (аукциона) * `1` - Победная ставка - `[].auction_restart_parameters` — Параметры перезапуска торгов - `[].auction_restart_parameters.auction_finish_action` — Финальное действие после завершения аукциона * `1` — Опубликовать груз со ставкой * `2` — Опубликовать груз с запросом ставки * `3` — Удалить груз - `[].auction_restart_parameters.current_change_winner_count` — Оставшееся количество попыток выбора нового победителя - `[].auction_restart_parameters.current_restart_count` — Оставшееся количество попыток перезапуска торгов - `[].auction_restart_parameters.duration_after_restart` — Длительность торгов в минутах после перезапуска - `[].auction_restart_parameters.init_change_winner_count` — Начальное количество попыток выбора нового победителя - `[].auction_restart_parameters.init_restart_count` — Начальное количество попыток перезапуска торгов - `[].auction_restart_parameters.is_manually_restarted` — Параметр, показывающий, был ли последний перезапуск выбран вручную - `[].auction_restart_parameters.rate_increase` — Повышение ставки при перезапуске - `[].auction_restart_parameters.rate_increase_option` — Способ повышения ставки * `1` — Повышение ставки в валюте * `2` — Повышение ставки в процентах - `[].auto_renew` — Автопродление Торгов (аукциона) при выставлении ставки в последние 5 минут до окончания Торгов (аукциона) - `[].currency` — Валюта ставки на груз - `[].current_rate_with_nds` — Текущая ставка с НДС - `[].current_rate_without_nds` — Текущая ставка без НДС - `[].deleted` — Аукцион помечен удалённым - спустя некоторое время он автоматически удалится полностью - `[].docs_expired_date` — Время окончания подачи документов (только для победителя) - `[].duration` — Длительность Торгов (аукциона) в минутах - `[].end_date` — Время окончания Торгов (аукциона) - `[].end_date_boundary` — Время окончания Торгов (аукциона), после которого они автоматически завершаются, если нет автопродления - `[].finish_type` — Тип окончания аукциона * `0` - По времени * `1` - По минимальной ставке * `2` - Досрочное - `[].finished` — Завершены ли Торги (аукцион) - `[].is_docs_expired` — Время подачи документов истекло (только для победителя) - `[].load_id` — Id груза, для которого активны Торги (аукцион) - `[].max_rate` — Максимально допустимая ставка по Торгам (аукциону) при автоповышении (RaiseBid = true) - `[].max_renew_time` — Максимально допустимое время, на которое сдвигается окончание Торгов (аукциона) при включённом AutoRenew (в минутах) - `[].nds` — Ставка НДС - `[].participants_count` — Количество участников - `[].raise_bid` — Автоповышение ставки на Шаг (step), если нет предложений - `[].raise_bid_interval` — Период увеличения ставки в минутах при автоповышении (RaiseBid = true) - `[].renew_time` — Время, на которое сдвигается окончание Торгов (аукциона) при включённом AutoRenew (в минутах) - `[].response_in_minutes` — Количество минут с момента начала Торгов (аукциона) (StartDate), после которых возможно принимать встречные предложения - `[].response_prohibited` — Встречные предложения запрещены - `[].server_date` — Серверное время. Для синхронизации Торгов (аукциона) - `[].start_date` — Время начала Торгов (аукциона) - `[].start_since_first_bet` — Длительность Торгов (аукциона) отсчитывается с момента первой ставки - `[].state` — Статус аукциона * `-100` - Не удалось определить состояние аукциона * `-14` - Аукцион отменён вручную грузовладельцем * `-13` - Аукцион удалён, т.к. расторгнут заказ * `-12` - Аукцион без ставок завершён * `-11` - Аукцион удалён автоматически * `-10` - Аукцион удалён т.к. сделка завершена * `-9` - Аукцион удалён * `-8` - При включённом копировании грузов: ожидается действие от экспедитора в случае, когда заказ с победителем отменён, других участников нет * `-7` - При включённом копировании грузов: ожидается действие с торгами от экспедитора в случае, когда заказ с победителем отменён и есть потенциальный победитель * `-6` - При включённом копировании грузов: торги завершены, экспедитор не является победителем * `-5` - Одна ставка лучшая по цене, другая по дате * `-4` - Закончился, но победитель вовремя не взял груз и при этом есть еще возможные победители * `-3` - Закончился, но победитель вовремя не взял груз и при этом он единственный возможный победитель * `-2` - Закончился, ждем когда победитель возьмёт груз * `-1` - Закончился, ставок нет * `0` - Идет, ставок нет * `1` - Идёт (уже есть валидные ставки) - `[].step` — Шаг изменения ставки Торгов (аукциона) - `[].time_to_provide_documents` — Время на предоставление перевозчиком данных для заявки (в часах) - `[].win_date` — Время выигрыша ставки (только для победителя) - `[].winner_criterion` — Критерий победы в аукционе * `0` - Выбор победителя происходит автоматически по лучшей ставке * `1` - Выбор победителя происходит по ставке и дате загрузки. Если нет лучшей ставки с лучшей датой - требуется выбор победителя вручную #### Получение торга по его идентификатору Получение Торгов (аукциона) по Id **Пример запроса (curl):** ```bash curl 'https://api.ati.su/v1.2/auction/3fa85f64-5717-4562-b3fc-2c963f66afa6?withDeleted=true' \ -X 'GET' \ -H 'Authorization: Bearer {authorizationToken}' \ -H 'Content-Type: application/json' ``` **OpenAPI схема:** [JSON](https://ati.su/developers/raw/api/auctions.openapi.json) **Пример ответа (200)** ```json { "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 } ``` **Описание полей ответа** - `accept_second_pay_type` — Возможность принимать другой тип оплаты (с НДС или без НДС) - `active_deal_id` — Id сделки, привязанной к Торгам (аукциону) - `auction_id` — Id Торгов (аукциона) - `auction_rates` — Список ставок по Торгам (аукциону) - `auction_rates[].added_at` — Дата добавления - `auction_rates[].ati_id` — Фирма, поставившая ставку - `auction_rates[].auction_rate_id` — Id ставки - `auction_rates[].contact_id` — Контакт - `auction_rates[].loading_date` — Ближайшая возможная для перевозчика дата загрузки. Используется только в Торгах с критерием победы по ставке и дате загрузки - `auction_rates[].rate_with_nds` — Ставка c НДС на груз, выставленная перевозчиком - `auction_rates[].rate_without_nds` — Ставка без НДС на груз, выставленная перевозчиком - `auction_rates[].source` — Система, на стороне которой сделана ставка - `auction_rates[].state` — Статус ставки * `-8` - Грузоотправитель отклонил документ * `-7` - Победитель отклонил документ * `-6` - Победитель отменил сделку * `-5` - Грузовладелец отменил сделку * `-4` - Победитель отказался, теперь его нельзя выбрать больше в качестве победителя * `-3` - Бывший победитель * `-2` - Перевозчик отказался от участия * `0` - Непобедная ставка при завершении Торгов (аукциона) * `1` - Победная ставка - `auction_restart_parameters` — Параметры перезапуска торгов - `auction_restart_parameters.auction_finish_action` — Финальное действие после завершения аукциона * `1` — Опубликовать груз со ставкой * `2` — Опубликовать груз с запросом ставки * `3` — Удалить груз - `auction_restart_parameters.current_change_winner_count` — Оставшееся количество попыток выбора нового победителя - `auction_restart_parameters.current_restart_count` — Оставшееся количество попыток перезапуска торгов - `auction_restart_parameters.duration_after_restart` — Длительность торгов в минутах после перезапуска - `auction_restart_parameters.init_change_winner_count` — Начальное количество попыток выбора нового победителя - `auction_restart_parameters.init_restart_count` — Начальное количество попыток перезапуска торгов - `auction_restart_parameters.is_manually_restarted` — Параметр, показывающий, был ли последний перезапуск выбран вручную - `auction_restart_parameters.rate_increase` — Повышение ставки при перезапуске - `auction_restart_parameters.rate_increase_option` — Способ повышения ставки * `1` — Повышение ставки в валюте * `2` — Повышение ставки в процентах - `auto_renew` — Автопродление Торгов (аукциона) при выставлении ставки в последние 5 минут до окончания Торгов (аукциона) - `currency` — Валюта ставки на груз - `current_rate_with_nds` — Текущая ставка с НДС - `current_rate_without_nds` — Текущая ставка без НДС - `deleted` — Аукцион помечен удалённым - спустя некоторое время он автоматически удалится полностью - `docs_expired_date` — Время окончания подачи документов (только для победителя) - `duration` — Длительность Торгов (аукциона) в минутах - `end_date` — Время окончания Торгов (аукциона) - `end_date_boundary` — Время окончания Торгов (аукциона), после которого они автоматически завершаются, если нет автопродления - `finish_type` — Тип окончания аукциона * `0` - По времени * `1` - По минимальной ставке * `2` - Досрочное - `finished` — Завершены ли Торги (аукцион) - `is_docs_expired` — Время подачи документов истекло (только для победителя) - `load_id` — Id груза, для которого активны Торги (аукцион) - `max_rate` — Максимально допустимая ставка по Торгам (аукциону) при автоповышении (RaiseBid = true) - `max_renew_time` — Максимально допустимое время, на которое сдвигается окончание Торгов (аукциона) при включённом AutoRenew (в минутах) - `nds` — Ставка НДС - `participants_count` — Количество участников - `raise_bid` — Автоповышение ставки на Шаг (step), если нет предложений - `raise_bid_interval` — Период увеличения ставки в минутах при автоповышении (RaiseBid = true) - `renew_time` — Время, на которое сдвигается окончание Торгов (аукциона) при включённом AutoRenew (в минутах) - `response_in_minutes` — Количество минут с момента начала Торгов (аукциона) (StartDate), после которых возможно принимать встречные предложения - `response_prohibited` — Встречные предложения запрещены - `server_date` — Серверное время. Для синхронизации Торгов (аукциона) - `start_date` — Время начала Торгов (аукциона) - `start_since_first_bet` — Длительность Торгов (аукциона) отсчитывается с момента первой ставки - `state` — Статус аукциона * `-100` - Не удалось определить состояние аукциона * `-14` - Аукцион отменён вручную грузовладельцем * `-13` - Аукцион удалён, т.к. расторгнут заказ * `-12` - Аукцион без ставок завершён * `-11` - Аукцион удалён автоматически * `-10` - Аукцион удалён т.к. сделка завершена * `-9` - Аукцион удалён * `-8` - При включённом копировании грузов: ожидается действие от экспедитора в случае, когда заказ с победителем отменён, других участников нет * `-7` - При включённом копировании грузов: ожидается действие с торгами от экспедитора в случае, когда заказ с победителем отменён и есть потенциальный победитель * `-6` - При включённом копировании грузов: торги завершены, экспедитор не является победителем * `-5` - Одна ставка лучшая по цене, другая по дате * `-4` - Закончился, но победитель вовремя не взял груз и при этом есть еще возможные победители * `-3` - Закончился, но победитель вовремя не взял груз и при этом он единственный возможный победитель * `-2` - Закончился, ждем когда победитель возьмёт груз * `-1` - Закончился, ставок нет * `0` - Идет, ставок нет * `1` - Идёт (уже есть валидные ставки) - `step` — Шаг изменения ставки Торгов (аукциона) - `time_to_provide_documents` — Время на предоставление перевозчиком данных для заявки (в часах) - `win_date` — Время выигрыша ставки (только для победителя) - `winner_criterion` — Критерий победы в аукционе * `0` - Выбор победителя происходит автоматически по лучшей ставке * `1` - Выбор победителя происходит по ставке и дате загрузки. Если нет лучшей ставки с лучшей датой - требуется выбор победителя вручную #### Получение списка торгов по их идентификаторам Получение списка Торгов (аукционов) по массиву id Торгов (аукционов) **Пример запроса (curl):** ```bash curl 'https://api.ati.su/v1.2/auction/byids' \ -X 'POST' \ -H 'Authorization: Bearer {authorizationToken}' \ -H 'Content-Type: application/json' \ --data-raw '[ "3fa85f64-5717-4562-b3fc-2c963f66afa6" ]' ``` **OpenAPI схема:** [JSON](https://ati.su/developers/raw/api/auctions.openapi.json) **Пример ответа (200)** ```json [ { "accept_second_pay_type": true, "active_deal_id": "11fd8b8d-1a68-4e02-a9ec-6af5b90d89a8", "auction_id": "a93234db-3ba6-44fc-b946-06c08c8f58f7", "auction_rates": [ { "added_at": "2023-04-24T11:31:51.9996831Z", "ati_id": "12345", "auction_rate_id": "1f8b6617-c717-47ec-8deb-2fef504e5a2f", "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.9996963Z", "ati_id": "33345", "auction_rate_id": "cac6be64-8b82-43fd-9a87-8208913f894b", "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.9997183Z", "duration": 6, "end_date": "2023-04-24T11:36:51.9997338Z", "end_date_boundary": "2023-04-24T11:36:51.999732Z", "finish_type": 0, "finished": true, "is_docs_expired": false, "load_id": "62cec59c-fd1b-4545-95b7-08f1bb95e368", "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.0002292Z", "start_date": "2023-04-24T11:30:51.9997166Z", "start_since_first_bet": false, "state": 0, "step": 500, "time_to_provide_documents": 3, "win_date": "2023-04-24T11:36:51.9997291Z", "winner_criterion": 0 }, { "auction_id": "48866a07-b1b9-4f4e-8980-19118ed25c10", "currency": 1, "current_rate_with_nds": 5000, "current_rate_without_nds": 6000, "end_date": "2023-04-24T11:36:51.9997534Z", "finished": false, "is_our_rate_best": true, "load_id": "ef34b355-62ae-428a-83b1-8bf5809209a2", "next_rate_with_nds": 5500, "next_rate_without_nds": 6600, "our_rate": { "added_at": "2023-04-24T11:35:51.9997573Z", "auction_rate_id": "981ccdef-5f13-4599-b994-76a1991255db", "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.0003727Z", "start_date": "2023-04-24T11:30:51.9997516Z", "winner_criterion": 0 }, { "active_deal_id": "143a9e3b-368b-4fca-9d12-1c035d45d074", "auction_id": "1acfb6a9-81bd-4abe-afb5-a1fe3be17653", "currency": 1, "current_rate_with_nds": 5000, "current_rate_without_nds": 6000, "docs_expired_date": "2023-04-24T14:36:51.9997965Z", "end_date": "2023-04-24T11:36:51.9997816Z", "finished": true, "is_docs_expired": false, "load_id": "97c210ee-8431-4a64-93c6-4eeb2d95be7d", "our_rate": { "added_at": "2023-04-24T11:35:51.9997838Z", "auction_rate_id": "4567c7d0-83f4-49c5-9779-89473f976d0f", "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:52.0004775Z", "start_date": "2023-04-24T11:30:51.9997795Z", "time_to_provide_documents": 3, "win_date": "2023-04-24T11:36:51.9997995Z", "winner_criterion": 0 } ] ``` **Описание полей ответа** - `[].accept_second_pay_type` — Возможность принимать другой тип оплаты (с НДС или без НДС) - `[].active_deal_id` — Id сделки, привязанной к Торгам (аукциону) - `[].auction_id` — Id Торгов (аукциона) - `[].auction_rates` — Список ставок по Торгам (аукциону) - `[].auction_rates[].added_at` — Дата добавления - `[].auction_rates[].ati_id` — Фирма, поставившая ставку - `[].auction_rates[].auction_rate_id` — Id ставки - `[].auction_rates[].contact_id` — Контакт - `[].auction_rates[].loading_date` — Ближайшая возможная для перевозчика дата загрузки. Используется только в Торгах с критерием победы по ставке и дате загрузки - `[].auction_rates[].rate_with_nds` — Ставка c НДС на груз, выставленная перевозчиком - `[].auction_rates[].rate_without_nds` — Ставка без НДС на груз, выставленная перевозчиком - `[].auction_rates[].source` — Система, на стороне которой сделана ставка - `[].auction_rates[].state` — Статус ставки * `-8` - Грузоотправитель отклонил документ * `-7` - Победитель отклонил документ * `-6` - Победитель отменил сделку * `-5` - Грузовладелец отменил сделку * `-4` - Победитель отказался, теперь его нельзя выбрать больше в качестве победителя * `-3` - Бывший победитель * `-2` - Перевозчик отказался от участия * `0` - Непобедная ставка при завершении Торгов (аукциона) * `1` - Победная ставка - `[].auction_restart_parameters` — Параметры перезапуска торгов - `[].auction_restart_parameters.auction_finish_action` — Финальное действие после завершения аукциона * `1` — Опубликовать груз со ставкой * `2` — Опубликовать груз с запросом ставки * `3` — Удалить груз - `[].auction_restart_parameters.current_change_winner_count` — Оставшееся количество попыток выбора нового победителя - `[].auction_restart_parameters.current_restart_count` — Оставшееся количество попыток перезапуска торгов - `[].auction_restart_parameters.duration_after_restart` — Длительность торгов в минутах после перезапуска - `[].auction_restart_parameters.init_change_winner_count` — Начальное количество попыток выбора нового победителя - `[].auction_restart_parameters.init_restart_count` — Начальное количество попыток перезапуска торгов - `[].auction_restart_parameters.is_manually_restarted` — Параметр, показывающий, был ли последний перезапуск выбран вручную - `[].auction_restart_parameters.rate_increase` — Повышение ставки при перезапуске - `[].auction_restart_parameters.rate_increase_option` — Способ повышения ставки * `1` — Повышение ставки в валюте * `2` — Повышение ставки в процентах - `[].auto_renew` — Автопродление Торгов (аукциона) при выставлении ставки в последние 5 минут до окончания Торгов (аукциона) - `[].currency` — Валюта ставки на груз - `[].current_rate_with_nds` — Текущая ставка с НДС - `[].current_rate_without_nds` — Текущая ставка без НДС - `[].deleted` — Аукцион помечен удалённым - спустя некоторое время он автоматически удалится полностью - `[].docs_expired_date` — Время окончания подачи документов (только для победителя) - `[].duration` — Длительность Торгов (аукциона) в минутах - `[].end_date` — Время окончания Торгов (аукциона) - `[].end_date_boundary` — Время окончания Торгов (аукциона), после которого они автоматически завершаются, если нет автопродления - `[].finish_type` — Тип окончания аукциона * `0` - По времени * `1` - По минимальной ставке * `2` - Досрочное - `[].finished` — Завершены ли Торги (аукцион) - `[].is_docs_expired` — Время подачи документов истекло (только для победителя) - `[].load_id` — Id груза, для которого активны Торги (аукцион) - `[].max_rate` — Максимально допустимая ставка по Торгам (аукциону) при автоповышении (RaiseBid = true) - `[].max_renew_time` — Максимально допустимое время, на которое сдвигается окончание Торгов (аукциона) при включённом AutoRenew (в минутах) - `[].nds` — Ставка НДС - `[].participants_count` — Количество участников - `[].raise_bid` — Автоповышение ставки на Шаг (step), если нет предложений - `[].raise_bid_interval` — Период увеличения ставки в минутах при автоповышении (RaiseBid = true) - `[].renew_time` — Время, на которое сдвигается окончание Торгов (аукциона) при включённом AutoRenew (в минутах) - `[].response_in_minutes` — Количество минут с момента начала Торгов (аукциона) (StartDate), после которых возможно принимать встречные предложения - `[].response_prohibited` — Встречные предложения запрещены - `[].server_date` — Серверное время. Для синхронизации Торгов (аукциона) - `[].start_date` — Время начала Торгов (аукциона) - `[].start_since_first_bet` — Длительность Торгов (аукциона) отсчитывается с момента первой ставки - `[].state` — Статус аукциона * `-100` - Не удалось определить состояние аукциона * `-14` - Аукцион отменён вручную грузовладельцем * `-13` - Аукцион удалён, т.к. расторгнут заказ * `-12` - Аукцион без ставок завершён * `-11` - Аукцион удалён автоматически * `-10` - Аукцион удалён т.к. сделка завершена * `-9` - Аукцион удалён * `-8` - При включённом копировании грузов: ожидается действие от экспедитора в случае, когда заказ с победителем отменён, других участников нет * `-7` - При включённом копировании грузов: ожидается действие с торгами от экспедитора в случае, когда заказ с победителем отменён и есть потенциальный победитель * `-6` - При включённом копировании грузов: торги завершены, экспедитор не является победителем * `-5` - Одна ставка лучшая по цене, другая по дате * `-4` - Закончился, но победитель вовремя не взял груз и при этом есть еще возможные победители * `-3` - Закончился, но победитель вовремя не взял груз и при этом он единственный возможный победитель * `-2` - Закончился, ждем когда победитель возьмёт груз * `-1` - Закончился, ставок нет * `0` - Идет, ставок нет * `1` - Идёт (уже есть валидные ставки) - `[].step` — Шаг изменения ставки Торгов (аукциона) - `[].time_to_provide_documents` — Время на предоставление перевозчиком данных для заявки (в часах) - `[].win_date` — Время выигрыша ставки (только для победителя) - `[].winner_criterion` — Критерий победы в аукционе * `0` - Выбор победителя происходит автоматически по лучшей ставке * `1` - Выбор победителя происходит по ставке и дате загрузки. Если нет лучшей ставки с лучшей датой - требуется выбор победителя вручную #### Отмена торгов Отмена Торгов (аукциона) по Id **Пример запроса (curl):** ```bash curl 'https://api.ati.su/v1.2/auction/3fa85f64-5717-4562-b3fc-2c963f66afa6' \ -X 'DELETE' \ -H 'Authorization: Bearer {authorizationToken}' \ -H 'Content-Type: application/json' ``` **OpenAPI схема:** [JSON](https://ati.su/developers/raw/api/auctions.openapi.json) #### Досрочное завершение Досрочное завершение Торгов (аукциона) **Пример запроса (curl):** ```bash curl 'https://api.ati.su/v1.2/auction/3fa85f64-5717-4562-b3fc-2c963f66afa6/finish_aot' \ -X 'POST' \ -H 'Authorization: Bearer {authorizationToken}' \ -H 'Content-Type: application/json' ``` **OpenAPI схема:** [JSON](https://ati.su/developers/raw/api/auctions.openapi.json) **Пример ответа (200)** ```json { "accept_second_pay_type": true, "active_deal_id": "aa30b2e3-778b-4125-ae26-75269311542e", "auction_id": "60a21a9c-727e-42b1-b092-cea3b87a0f56", "auction_rates": [ { "added_at": "2023-04-24T11:31:52.100118Z", "ati_id": "12345", "auction_rate_id": "057b35fd-59f8-4e42-a1b0-cf7c0e6e5260", "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.1001269Z", "ati_id": "33345", "auction_rate_id": "c057841f-0e55-45b3-b46f-def80b479e29", "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.1001426Z", "duration": 6, "end_date": "2023-04-24T11:36:52.1001554Z", "end_date_boundary": "2023-04-24T11:36:52.1001542Z", "finish_type": 0, "finished": true, "is_docs_expired": false, "load_id": "aa5cfb62-de6d-4c3b-853f-3270fc8793a9", "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.1004411Z", "start_date": "2023-04-24T11:30:52.1001412Z", "start_since_first_bet": false, "state": 0, "step": 500, "time_to_provide_documents": 3, "win_date": "2023-04-24T11:36:52.1001516Z", "winner_criterion": 0 } ``` **Описание полей ответа** - `accept_second_pay_type` — Возможность принимать другой тип оплаты (с НДС или без НДС) - `active_deal_id` — Id сделки, привязанной к Торгам (аукциону) - `auction_id` — Id Торгов (аукциона) - `auction_rates` — Список ставок по Торгам (аукциону) - `auction_rates[].added_at` — Дата добавления - `auction_rates[].ati_id` — Фирма, поставившая ставку - `auction_rates[].auction_rate_id` — Id ставки - `auction_rates[].contact_id` — Контакт - `auction_rates[].loading_date` — Ближайшая возможная для перевозчика дата загрузки. Используется только в Торгах с критерием победы по ставке и дате загрузки - `auction_rates[].rate_with_nds` — Ставка c НДС на груз, выставленная перевозчиком - `auction_rates[].rate_without_nds` — Ставка без НДС на груз, выставленная перевозчиком - `auction_rates[].source` — Система, на стороне которой сделана ставка - `auction_rates[].state` — Статус ставки * `-8` - Грузоотправитель отклонил документ * `-7` - Победитель отклонил документ * `-6` - Победитель отменил сделку * `-5` - Грузовладелец отменил сделку * `-4` - Победитель отказался, теперь его нельзя выбрать больше в качестве победителя * `-3` - Бывший победитель * `-2` - Перевозчик отказался от участия * `0` - Непобедная ставка при завершении Торгов (аукциона) * `1` - Победная ставка - `auction_restart_parameters` — Параметры перезапуска торгов - `auction_restart_parameters.auction_finish_action` — Финальное действие после завершения аукциона * `1` — Опубликовать груз со ставкой * `2` — Опубликовать груз с запросом ставки * `3` — Удалить груз - `auction_restart_parameters.current_change_winner_count` — Оставшееся количество попыток выбора нового победителя - `auction_restart_parameters.current_restart_count` — Оставшееся количество попыток перезапуска торгов - `auction_restart_parameters.duration_after_restart` — Длительность торгов в минутах после перезапуска - `auction_restart_parameters.init_change_winner_count` — Начальное количество попыток выбора нового победителя - `auction_restart_parameters.init_restart_count` — Начальное количество попыток перезапуска торгов - `auction_restart_parameters.is_manually_restarted` — Параметр, показывающий, был ли последний перезапуск выбран вручную - `auction_restart_parameters.rate_increase` — Повышение ставки при перезапуске - `auction_restart_parameters.rate_increase_option` — Способ повышения ставки * `1` — Повышение ставки в валюте * `2` — Повышение ставки в процентах - `auto_renew` — Автопродление Торгов (аукциона) при выставлении ставки в последние 5 минут до окончания Торгов (аукциона) - `currency` — Валюта ставки на груз - `current_rate_with_nds` — Текущая ставка с НДС - `current_rate_without_nds` — Текущая ставка без НДС - `deleted` — Аукцион помечен удалённым - спустя некоторое время он автоматически удалится полностью - `docs_expired_date` — Время окончания подачи документов (только для победителя) - `duration` — Длительность Торгов (аукциона) в минутах - `end_date` — Время окончания Торгов (аукциона) - `end_date_boundary` — Время окончания Торгов (аукциона), после которого они автоматически завершаются, если нет автопродления - `finish_type` — Тип окончания аукциона * `0` - По времени * `1` - По минимальной ставке * `2` - Досрочное - `finished` — Завершены ли Торги (аукцион) - `is_docs_expired` — Время подачи документов истекло (только для победителя) - `load_id` — Id груза, для которого активны Торги (аукцион) - `max_rate` — Максимально допустимая ставка по Торгам (аукциону) при автоповышении (RaiseBid = true) - `max_renew_time` — Максимально допустимое время, на которое сдвигается окончание Торгов (аукциона) при включённом AutoRenew (в минутах) - `nds` — Ставка НДС - `participants_count` — Количество участников - `raise_bid` — Автоповышение ставки на Шаг (step), если нет предложений - `raise_bid_interval` — Период увеличения ставки в минутах при автоповышении (RaiseBid = true) - `renew_time` — Время, на которое сдвигается окончание Торгов (аукциона) при включённом AutoRenew (в минутах) - `response_in_minutes` — Количество минут с момента начала Торгов (аукциона) (StartDate), после которых возможно принимать встречные предложения - `response_prohibited` — Встречные предложения запрещены - `server_date` — Серверное время. Для синхронизации Торгов (аукциона) - `start_date` — Время начала Торгов (аукциона) - `start_since_first_bet` — Длительность Торгов (аукциона) отсчитывается с момента первой ставки - `state` — Статус аукциона * `-100` - Не удалось определить состояние аукциона * `-14` - Аукцион отменён вручную грузовладельцем * `-13` - Аукцион удалён, т.к. расторгнут заказ * `-12` - Аукцион без ставок завершён * `-11` - Аукцион удалён автоматически * `-10` - Аукцион удалён т.к. сделка завершена * `-9` - Аукцион удалён * `-8` - При включённом копировании грузов: ожидается действие от экспедитора в случае, когда заказ с победителем отменён, других участников нет * `-7` - При включённом копировании грузов: ожидается действие с торгами от экспедитора в случае, когда заказ с победителем отменён и есть потенциальный победитель * `-6` - При включённом копировании грузов: торги завершены, экспедитор не является победителем * `-5` - Одна ставка лучшая по цене, другая по дате * `-4` - Закончился, но победитель вовремя не взял груз и при этом есть еще возможные победители * `-3` - Закончился, но победитель вовремя не взял груз и при этом он единственный возможный победитель * `-2` - Закончился, ждем когда победитель возьмёт груз * `-1` - Закончился, ставок нет * `0` - Идет, ставок нет * `1` - Идёт (уже есть валидные ставки) - `step` — Шаг изменения ставки Торгов (аукциона) - `time_to_provide_documents` — Время на предоставление перевозчиком данных для заявки (в часах) - `win_date` — Время выигрыша ставки (только для победителя) - `winner_criterion` — Критерий победы в аукционе * `0` - Выбор победителя происходит автоматически по лучшей ставке * `1` - Выбор победителя происходит по ставке и дате загрузки. Если нет лучшей ставки с лучшей датой - требуется выбор победителя вручную #### Смена победителя Смена победителя Торгов (аукциона) **Пример запроса (curl):** ```bash curl 'https://api.ati.su/v1.2/auction/bet/win/3fa85f64-5717-4562-b3fc-2c963f66afa6' \ -X 'POST' \ -H 'Authorization: Bearer {authorizationToken}' \ -H 'Content-Type: application/json' ``` **OpenAPI схема:** [JSON](https://ati.su/developers/raw/api/auctions.openapi.json) **Пример ответа (200)** ```json { "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` — Возможность принимать другой тип оплаты (с НДС или без НДС) - `active_deal_id` — Id сделки, привязанной к Торгам (аукциону) - `auction_id` — Id Торгов (аукциона) - `auction_rates` — Список ставок по Торгам (аукциону) - `auction_rates[].added_at` — Дата добавления - `auction_rates[].ati_id` — Фирма, поставившая ставку - `auction_rates[].auction_rate_id` — Id ставки - `auction_rates[].contact_id` — Контакт - `auction_rates[].loading_date` — Ближайшая возможная для перевозчика дата загрузки. Используется только в Торгах с критерием победы по ставке и дате загрузки - `auction_rates[].rate_with_nds` — Ставка c НДС на груз, выставленная перевозчиком - `auction_rates[].rate_without_nds` — Ставка без НДС на груз, выставленная перевозчиком - `auction_rates[].source` — Система, на стороне которой сделана ставка - `auction_rates[].state` — Статус ставки * `-8` - Грузоотправитель отклонил документ * `-7` - Победитель отклонил документ * `-6` - Победитель отменил сделку * `-5` - Грузовладелец отменил сделку * `-4` - Победитель отказался, теперь его нельзя выбрать больше в качестве победителя * `-3` - Бывший победитель * `-2` - Перевозчик отказался от участия * `0` - Непобедная ставка при завершении Торгов (аукциона) * `1` - Победная ставка - `auction_restart_parameters` — Параметры перезапуска торгов - `auction_restart_parameters.auction_finish_action` — Финальное действие после завершения аукциона * `1` — Опубликовать груз со ставкой * `2` — Опубликовать груз с запросом ставки * `3` — Удалить груз - `auction_restart_parameters.current_change_winner_count` — Оставшееся количество попыток выбора нового победителя - `auction_restart_parameters.current_restart_count` — Оставшееся количество попыток перезапуска торгов - `auction_restart_parameters.duration_after_restart` — Длительность торгов в минутах после перезапуска - `auction_restart_parameters.init_change_winner_count` — Начальное количество попыток выбора нового победителя - `auction_restart_parameters.init_restart_count` — Начальное количество попыток перезапуска торгов - `auction_restart_parameters.is_manually_restarted` — Параметр, показывающий, был ли последний перезапуск выбран вручную - `auction_restart_parameters.rate_increase` — Повышение ставки при перезапуске - `auction_restart_parameters.rate_increase_option` — Способ повышения ставки * `1` — Повышение ставки в валюте * `2` — Повышение ставки в процентах - `auto_renew` — Автопродление Торгов (аукциона) при выставлении ставки в последние 5 минут до окончания Торгов (аукциона) - `currency` — Валюта ставки на груз - `current_rate_with_nds` — Текущая ставка с НДС - `current_rate_without_nds` — Текущая ставка без НДС - `deleted` — Аукцион помечен удалённым - спустя некоторое время он автоматически удалится полностью - `docs_expired_date` — Время окончания подачи документов (только для победителя) - `duration` — Длительность Торгов (аукциона) в минутах - `end_date` — Время окончания Торгов (аукциона) - `end_date_boundary` — Время окончания Торгов (аукциона), после которого они автоматически завершаются, если нет автопродления - `finish_type` — Тип окончания аукциона * `0` - По времени * `1` - По минимальной ставке * `2` - Досрочное - `finished` — Завершены ли Торги (аукцион) - `is_docs_expired` — Время подачи документов истекло (только для победителя) - `load_id` — Id груза, для которого активны Торги (аукцион) - `max_rate` — Максимально допустимая ставка по Торгам (аукциону) при автоповышении (RaiseBid = true) - `max_renew_time` — Максимально допустимое время, на которое сдвигается окончание Торгов (аукциона) при включённом AutoRenew (в минутах) - `nds` — Ставка НДС - `participants_count` — Количество участников - `raise_bid` — Автоповышение ставки на Шаг (step), если нет предложений - `raise_bid_interval` — Период увеличения ставки в минутах при автоповышении (RaiseBid = true) - `renew_time` — Время, на которое сдвигается окончание Торгов (аукциона) при включённом AutoRenew (в минутах) - `response_in_minutes` — Количество минут с момента начала Торгов (аукциона) (StartDate), после которых возможно принимать встречные предложения - `response_prohibited` — Встречные предложения запрещены - `server_date` — Серверное время. Для синхронизации Торгов (аукциона) - `start_date` — Время начала Торгов (аукциона) - `start_since_first_bet` — Длительность Торгов (аукциона) отсчитывается с момента первой ставки - `state` — Статус аукциона * `-100` - Не удалось определить состояние аукциона * `-14` - Аукцион отменён вручную грузовладельцем * `-13` - Аукцион удалён, т.к. расторгнут заказ * `-12` - Аукцион без ставок завершён * `-11` - Аукцион удалён автоматически * `-10` - Аукцион удалён т.к. сделка завершена * `-9` - Аукцион удалён * `-8` - При включённом копировании грузов: ожидается действие от экспедитора в случае, когда заказ с победителем отменён, других участников нет * `-7` - При включённом копировании грузов: ожидается действие с торгами от экспедитора в случае, когда заказ с победителем отменён и есть потенциальный победитель * `-6` - При включённом копировании грузов: торги завершены, экспедитор не является победителем * `-5` - Одна ставка лучшая по цене, другая по дате * `-4` - Закончился, но победитель вовремя не взял груз и при этом есть еще возможные победители * `-3` - Закончился, но победитель вовремя не взял груз и при этом он единственный возможный победитель * `-2` - Закончился, ждем когда победитель возьмёт груз * `-1` - Закончился, ставок нет * `0` - Идет, ставок нет * `1` - Идёт (уже есть валидные ставки) - `step` — Шаг изменения ставки Торгов (аукциона) - `time_to_provide_documents` — Время на предоставление перевозчиком данных для заявки (в часах) - `win_date` — Время выигрыша ставки (только для победителя) - `winner_criterion` — Критерий победы в аукционе * `0` - Выбор победителя происходит автоматически по лучшей ставке * `1` - Выбор победителя происходит по ставке и дате загрузки. Если нет лучшей ставки с лучшей датой - требуется выбор победителя вручную #### Выставление ставки в торгах Выставление ставки в Торгах (аукционе) **Пример запроса (curl):** ```bash 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 }' ``` **OpenAPI схема:** [JSON](https://ati.su/developers/raw/api/auctions.openapi.json) **Описание полей запроса** - `auction_id` — Id аукциона - `loading_date` — Ближайшая возможная для перевозчика дата загрузки. Используется только в Торгах с критерием победы по ставке и дате загрузки - `payment_type` — Тип оплаты * `1` - Наличка * `22` - Любая * `23` - На карту * `24` - С НДС * `25` - Без НДС * Остальные зарезервированы - `rate` — Ставка на груз, поставленная перевозчиком **Пример ответа (200)** ```json { "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 } ``` **Описание полей ответа** - `auction` — Торги (аукцион) для перевозчика - `auction.auction_id` — Id Торгов (аукциона) - `auction.currency` — Валюта ставки на груз - `auction.current_rate_with_nds` — Текущая ставка с НДС - `auction.current_rate_without_nds` — Текущая ставка без НДС - `auction.end_date` — Время окончания Торгов (аукциона) - `auction.finished` — Завершены ли Торги (аукцион) - `auction.is_our_rate_best` — Ставка лучшая в незавершенных Торгах (аукционе) (в завершенных - не отображается) - `auction.load_id` — Id груза, для которого активны Торги (аукцион) - `auction.next_rate_with_nds` — Следующая возможная ставка с НДС - `auction.next_rate_without_nds` — Следующая возможная ставка без НДС - `auction.our_rate` — Выставленная ставка - `auction.our_rate.added_at` — Дата добавления - `auction.our_rate.auction_rate_id` — Id ставки - `auction.our_rate.contact_id` — Контакт - `auction.our_rate.loading_date` — Ближайшая возможная для перевозчика дата загрузки. Используется только в Торгах с критерием победы по ставке и дате загрузки - `auction.our_rate.rate_with_nds` — Ставка c НДС на груз, выставленная перевозчиком - `auction.our_rate.rate_without_nds` — Ставка без НДС на груз, выставленная перевозчиком - `auction.our_rate.state` — Статус ставки * `-8` - Грузоотправитель отклонил документ * `-7` - Победитель отклонил документ * `-6` - Победитель отменил сделку * `-5` - Грузовладелец отменил сделку * `-4` - Победитель отказался, теперь его нельзя выбрать больше в качестве победителя * `-3` - Бывший победитель * `-2` - Перевозчик отказался от участия * `0` - Непобедная ставка при завершении Торгов (аукциона) * `1` - Победная ставка - `auction.participants_count` — Количество участников - `auction.response_prohibited` — Встречные предложения запрещены - `auction.server_date` — Серверное время. Для синхронизации Торгов (аукциона) - `auction.start_date` — Время начала Торгов (аукциона) - `auction.winner_criterion` — Критерий победы в аукционе * `0` - Выбор победителя происходит автоматически по лучшей ставке * `1` - Выбор победителя происходит по ставке и дате загрузки. Если нет лучшей ставки с лучшей датой - требуется выбор победителя вручную - `auction_end_date` — Параметр устарел, используйте auction.end_date. Дата окончания Торгов (аукциона). - `result_status` — Статус выставленной ставки * `0` - Ставка выставлена * `1` - Ставка выставлена и Торги (аукцион) завершены * `2` - Ставка не выставлена, поскольку Торги (аукцион) не найдены * `3` - Ставка не выставлена, поскольку она не лучшая * `4` - Ставка выставлена минимальная, но Торги (аукцион) не завершены * `5` - Ставка выставлена и Торги (аукцион) продлены * `6` - Ставка не выставлена, поскольку торги завершены #### Отмена ставки Отмена ставки в Торгах (аукционе) **Пример запроса (curl):** ```bash curl 'https://api.ati.su/v1.2/auction/bet/refuse/3fa85f64-5717-4562-b3fc-2c963f66afa6' \ -X 'POST' \ -H 'Authorization: Bearer {authorizationToken}' \ -H 'Content-Type: application/json' ``` **OpenAPI схема:** [JSON](https://ati.su/developers/raw/api/auctions.openapi.json) **Пример ответа (200)** ```json [ 0, 1, 2, 3, 4, 5, -1 ] ``` #### Отказ от победы Отказ от победы в Торгах (аукционе) **Пример запроса (curl):** ```bash curl 'https://api.ati.su/v1.2/auction/3fa85f64-5717-4562-b3fc-2c963f66afa6/refuse' \ -X 'POST' \ -H 'Authorization: Bearer {authorizationToken}' \ -H 'Content-Type: application/json' ``` **OpenAPI схема:** [JSON](https://ati.su/developers/raw/api/auctions.openapi.json) --- ## llms.txt Индекс ключевых страниц документации для LLM и AI-агентов доступен в [основном llms.txt](https://ati.su/developers/llms.txt).