# Торги на площадках

События чужих [Торгов](https://ati.su/developers/raw/api/auctions.md) на
[доступных персональных площадках](https://ati.su/developers/raw/api/boards.md#get-v2-boards-public-boards-canView).

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

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

Тема `auctions.on_boards`

**Пример**

```json
{
  "auction_id": "248de03c-c445-4cca-8858-4e9b495ce3d7",
  "currency": 1,
  "current_rate_with_nds": 5000,
  "current_rate_without_nds": 6000,
  "end_date": "2023-04-24T11:36:51.930351Z",
  "finished": false,
  "is_our_rate_best": true,
  "load_id": "dcbe9875-ebb8-4c06-bbb9-ab4093c5fe20",
  "next_rate_with_nds": 5500,
  "next_rate_without_nds": 6600,
  "our_rate": {
    "added_at": "2023-04-24T11:35:51.9303557Z",
    "auction_rate_id": "47c55885-1ca1-4d05-bc66-968d0e53f0ce",
    "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:51.9305017Z",
  "start_date": "2023-04-24T11:30:51.930351Z",
  "winner_criterion": 0
}
```

**Описание полей модели**
- `auction_id` — Id Торгов (аукциона)
- `currency` — Валюта ставки на груз
- `current_rate_with_nds` — Текущая ставка с НДС
- `current_rate_without_nds` — Текущая ставка без НДС
- `end_date` — Время окончания Торгов (аукциона)
- `finished` — Завершены ли Торги (аукцион)
- `is_our_rate_best` — Ставка лучшая в незавершенных Торгах (аукционе) (в завершенных - не отображается)
- `load_id` — Id груза, для которого активны Торги (аукцион)
- `next_rate_with_nds` — Следующая возможная ставка с НДС
- `next_rate_without_nds` — Следующая возможная ставка без НДС
- `our_rate` — Выставленная ставка
- `our_rate.added_at` — Дата добавления
- `our_rate.auction_rate_id` — Id ставки
- `our_rate.contact_id` — Контакт
- `our_rate.loading_date` — Ближайшая возможная для перевозчика дата загрузки. Используется только в Торгах с критерием победы по ставке и дате загрузки
- `our_rate.rate_with_nds` — Ставка c НДС на груз, выставленная перевозчиком
- `our_rate.rate_without_nds` — Ставка без НДС на груз, выставленная перевозчиком
- `our_rate.state` — Статус ставки * `-8` - Грузоотправитель отклонил документ * `-7` - Победитель отклонил документ * `-6` - Победитель отменил сделку * `-5` - Грузовладелец отменил сделку * `-4` - Победитель отказался, теперь его нельзя выбрать больше в качестве победителя * `-3` - Бывший победитель * `-2` - Перевозчик отказался от участия * `0` - Непобедная ставка при завершении Торгов (аукциона) * `1` - Победная ставка
- `participants_count` — Количество участников
- `response_prohibited` — Встречные предложения запрещены
- `server_date` — Серверное время. Для синхронизации Торгов (аукциона)
- `start_date` — Время начала Торгов (аукциона)
- `winner_criterion` — Критерий победы в аукционе * `0` - Выбор победителя происходит автоматически по лучшей ставке * `1` - Выбор победителя происходит по ставке и дате загрузки. Если нет лучшей ставки с лучшей датой - требуется выбор победителя вручную
---

## llms.txt

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