# Торги

События [Торгов](https://ati.su/developers/raw/api/auctions.md).

При возникновении события в системе ATI.SU, к вебхуку будет отправлен [POST запрос](https://ati.su/developers/raw/api/webhooks/index.md#получение-сообщений).
В параметре `entity` будет сущность темы подписки в соответствии с моделью, представленной на этой странице.

При удалении Торга, параметр `entity` будет принимать значение `null`.

Тема `auctions`

**Пример**

```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` - Выбор победителя происходит по ставке и дате загрузки. Если нет лучшей ставки с лучшей датой - требуется выбор победителя вручную
---

## llms.txt

Индекс ключевых страниц документации для LLM и AI-агентов доступен в [основном llms.txt](https://ati.su/developers/llms.txt).
