# Грузы на площадках

События чужих [Грузов](https://ati.su/developers/raw/api/loads/published.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`.

Тема `cargoes.on_boards`

**Пример**

```json
{
  "cargo_id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
  "cargo_number": "string",
  "added_at": "1970-01-01T00:00:00.000Z",
  "updated_at": "1970-01-01T00:00:00.000Z",
  "persistent_user_id": 0,
  "ati_id": "string",
  "route": {
    "loading": {
      "near_cities": [
        0
      ],
      "dates": {
        "type": "string",
        "first_date": "1970-01-01T00:00:00.000Z",
        "last_date": "1970-01-01T00:00:00.000Z",
        "time": {}
      },
      "cargos": [
        {
          "cargo_id": 0,
          "weight": {
            "type": "kilos",
            "quantity": 0.5
          },
          "volume": {
            "quantity": 0.5
          },
          "sizes": {
            "length": {
              "value": 0.5,
              "is_highlighted": false
            },
            "height": {
              "value": 0.5,
              "is_highlighted": false
            },
            "width": {
              "value": 0.5,
              "is_highlighted": false
            },
            "diameter": 0.5
          }
        }
      ],
      "city_id": 0,
      "address": "string",
      "coordinates": {
        "longitude": 0.5,
        "latitude": 0.5
      },
      "organization": {
        "name": "string",
        "ownership": 0
      }
    },
    "unloading": {
      "near_cities": [
        0
      ],
      "dates": {
        "first_date": "1970-01-01T00:00:00.000Z",
        "last_date": "1970-01-01T00:00:00.000Z",
        "time": {
          "type": "string"
        }
      },
      "city_id": 0,
      "address": "string",
      "coordinates": {
        "longitude": 0.5,
        "latitude": 0.5
      },
      "organization": {
        "name": "string",
        "ownership": 0
      }
    },
    "way_points": [
      {
        "type": "string",
        "city_id": 0,
        "address": "string",
        "coordinates": {
          "longitude": 0.5,
          "latitude": 0.5
        },
        "organization": {
          "organization_id": "string"
        },
        "catalogs_organization": {
          "name": "string",
          "ownership": 0
        },
        "cargos": [
          {
            "cargo_id": 0,
            "weight": {
              "type": "kilos",
              "quantity": 0.5
            },
            "volume": {
              "quantity": 0.5
            },
            "sizes": {
              "length": {
                "value": 0.5,
                "is_highlighted": false
              },
              "height": {
                "value": 0.5,
                "is_highlighted": false
              },
              "width": {
                "value": 0.5,
                "is_highlighted": false
              },
              "diameter": 0.5
            },
            "name": "string",
            "packaging": {
              "type": 0,
              "quantity": 0
            }
          }
        ],
        "loading_date": {
          "first_date": "1970-01-01T00:00:00.000Z",
          "last_date": "1970-01-01T00:00:00.000Z",
          "time": {}
        }
      }
    ],
    "is_round_trip": false
  },
  "truck": {
    "trucks_count": 0,
    "load_type": "ftl",
    "body_types": [
      0
    ],
    "body_loading": {
      "types": [
        0
      ],
      "is_all_required": false
    },
    "body_unloading": {
      "types": [
        0
      ],
      "is_all_required": false
    },
    "temperature": {
      "from": 0,
      "to": 0
    },
    "documents": {
      "tir": false,
      "cmr": false,
      "t1": false,
      "medical_card": false
    },
    "requirements": {
      "logging_truck": false,
      "road_train": false,
      "air_suspension": false
    },
    "adr": 0,
    "belts_count": 0,
    "is_tracking": false,
    "required_capacity": 0.5
  },
  "payment": {
    "type": "string",
    "direct_offer": false,
    "prepayment": {
      "percent": 0,
      "using_fuel": false
    },
    "payment_mode": {},
    "auction_id": "3fa85f64-5717-4562-b3fc-2c963f66afa6"
  },
  "documents": [
    {
      "id": "string",
      "name": "string",
      "link": "string"
    }
  ],
  "boards": [
    {
      "id": "string",
      "reservation_enabled": false
    }
  ],
  "note": "string",
  "contacts": [
    0
  ],
  "distance": 0
}
```

**Описание полей модели**
- `cargo_id` — ID груза
- `cargo_number` — Номер груза, автоматически генерируемый ATI.SU
- `added_at` — Время добавления груза
- `updated_at` — Время изменения груза
- `persistent_user_id` — Идентификатор пользователя, разместившего заявку
- `ati_id` — Код пользователя, разместившего заявку
- `route` — Маршрут
- `route.loading` — Загрузка
- `route.loading.near_cities` — Ближайшие города. Id города из словаря
- `route.loading.dates` — Даты загрузки
- `route.loading.dates.type` — Тип даты
- `route.loading.dates.first_date` — Дата начала
- `route.loading.dates.last_date` — Дата конца
- `route.loading.dates.time` — Время загрузки
- `route.loading.cargos` — Параметры грузов
- `route.loading.cargos[].cargo_id` — Id груза
- `route.loading.cargos[].weight` — Вес
- `route.loading.cargos[].weight.type` — Тип
- `route.loading.cargos[].weight.quantity` — Количество
- `route.loading.cargos[].volume` — Объём
- `route.loading.cargos[].volume.quantity` — Количество
- `route.loading.cargos[].sizes` — Габариты
- `route.loading.cargos[].sizes.length` — Длина, метры
- `route.loading.cargos[].sizes.length.value` — Значение
- `route.loading.cargos[].sizes.length.is_highlighted` — Выделить значение цветом в результатах поиска
- `route.loading.cargos[].sizes.height` — Высота, метры
- `route.loading.cargos[].sizes.height.value` — Значение
- `route.loading.cargos[].sizes.height.is_highlighted` — Выделить значение цветом в результатах поиска
- `route.loading.cargos[].sizes.width` — Ширина, метры
- `route.loading.cargos[].sizes.width.value` — Значение
- `route.loading.cargos[].sizes.width.is_highlighted` — Выделить значение цветом в результатах поиска
- `route.loading.cargos[].sizes.diameter` — Диаметр, метры
- `route.loading.city_id` — Id города из словаря
- `route.loading.address` — Адрес без города
- `route.loading.coordinates` — Координаты
- `route.loading.coordinates.longitude` — Долгота
- `route.loading.coordinates.latitude` — Широта
- `route.loading.organization` — Организация
- `route.loading.organization.name` — Назание организации
- `route.loading.organization.ownership` — Организационно-правовая форма собственности. Значение из [словаря](https://ati.su/developers/api/dictionaries/firms/#get-v1.0-dictionaries-ownerships)
- `route.unloading` — Разгрузка
- `route.unloading.near_cities` — Ближайшие города. Id города из словаря
- `route.unloading.dates` — Даты разгрузки
- `route.unloading.dates.first_date` — Дата разгрузки
- `route.unloading.dates.last_date` — Поздняя дата разгрузки
- `route.unloading.dates.time` — Время разгрузки
- `route.unloading.dates.time.type` — Тип времени
- `route.unloading.city_id` — Id города из словаря
- `route.unloading.address` — Адрес без города
- `route.unloading.coordinates` — Координаты
- `route.unloading.coordinates.longitude` — Долгота
- `route.unloading.coordinates.latitude` — Широта
- `route.unloading.organization` — Организация
- `route.unloading.organization.name` — Назание организации
- `route.unloading.organization.ownership` — Организационно-правовая форма собственности. Значение из [словаря](https://ati.su/developers/api/dictionaries/firms/#get-v1.0-dictionaries-ownerships)
- `route.way_points` — Точки маршрута
- `route.way_points[].type` — Тип промежуточной точки
- `route.way_points[].city_id` — Id города из словаря
- `route.way_points[].address` — Адрес без города
- `route.way_points[].coordinates` — Координаты
- `route.way_points[].coordinates.longitude` — Долгота
- `route.way_points[].coordinates.latitude` — Широта
- `route.way_points[].organization` — Организация
- `route.way_points[].catalogs_organization` — Организация из справочников
- `route.way_points[].catalogs_organization.name` — Назание организации
- `route.way_points[].catalogs_organization.ownership` — Организационно-правовая форма собственности. Значение из [словаря](https://ati.su/developers/api/dictionaries/firms/#get-v1.0-dictionaries-ownerships)
- `route.way_points[].cargos` — Параметры грузов
- `route.way_points[].cargos[].cargo_id` — Id груза
- `route.way_points[].cargos[].weight` — Вес
- `route.way_points[].cargos[].weight.type` — Тип
- `route.way_points[].cargos[].weight.quantity` — Количество
- `route.way_points[].cargos[].volume` — Объём
- `route.way_points[].cargos[].volume.quantity` — Количество
- `route.way_points[].cargos[].sizes` — Габариты
- `route.way_points[].cargos[].sizes.length` — Длина, метры
- `route.way_points[].cargos[].sizes.length.value` — Значение
- `route.way_points[].cargos[].sizes.length.is_highlighted` — Выделить значение цветом в результатах поиска
- `route.way_points[].cargos[].sizes.height` — Высота, метры
- `route.way_points[].cargos[].sizes.height.value` — Значение
- `route.way_points[].cargos[].sizes.height.is_highlighted` — Выделить значение цветом в результатах поиска
- `route.way_points[].cargos[].sizes.width` — Ширина, метры
- `route.way_points[].cargos[].sizes.width.value` — Значение
- `route.way_points[].cargos[].sizes.width.is_highlighted` — Выделить значение цветом в результатах поиска
- `route.way_points[].cargos[].sizes.diameter` — Диаметр, метры
- `route.way_points[].cargos[].name` — Наименование груза
- `route.way_points[].cargos[].packaging` — Упаковка
- `route.way_points[].cargos[].packaging.type` — Тип: ссылка на словарь типов упаковки
- `route.way_points[].cargos[].packaging.quantity` — Количество
- `route.way_points[].loading_date` — Параметры даты и времени загрузки
- `route.way_points[].loading_date.first_date` — Дата начала
- `route.way_points[].loading_date.last_date` — Дата конца
- `route.way_points[].loading_date.time` — Время загрузки
- `route.is_round_trip` — Кругорейс
- `truck` — Транспорт
- `truck.trucks_count` — Количество машин
- `truck.load_type` — Загрузка
- `truck.body_types` — Типы кузовов
- `truck.body_loading` — Способы загрузки
- `truck.body_loading.types` — Id типа загрузки
- `truck.body_loading.is_all_required` — Обязательны все выбранные
- `truck.body_unloading` — Способы разгрузки
- `truck.body_unloading.types` — Id типа загрузки
- `truck.body_unloading.is_all_required` — Обязательны все выбранные
- `truck.temperature` — Температура
- `truck.temperature.from` — От
- `truck.temperature.to` — До
- `truck.documents` — Разрешения
- `truck.documents.tir` — TIR
- `truck.documents.cmr` — CMR
- `truck.documents.t1` — T1
- `truck.documents.medical_card` — Медкнижка
- `truck.requirements` — Требования
- `truck.requirements.logging_truck` — Коники
- `truck.requirements.road_train` — Сцепка
- `truck.requirements.air_suspension` — Пневмоход
- `truck.adr` — ADR
- `truck.belts_count` — Количество ремней
- `truck.is_tracking` — Трекинг через ATI.SU Водитель
- `truck.required_capacity` — Требуемая грузоподъемность в тоннах
- `payment` — Оплата
- `payment.type` — Тип оплаты
- `payment.direct_offer` — Прямой договор
- `payment.prepayment` — Предоплата
- `payment.prepayment.percent` — Процент предоплаты
- `payment.prepayment.using_fuel` — Предоплата топливом
- `payment.payment_mode` — Режим оплаты
- `payment.auction_id` — Id торгов
- `documents` — Фото груза и документов
- `documents[].id` — Id документа
- `documents[].name` — Название документа
- `documents[].link` — Ссылка на документ
- `boards` — Площадки груза
- `boards[].id` — Id площадки
- `boards[].reservation_enabled` — Разрешить перевозчикам бронировать груз
- `note` — Примечание к заявке
- `contacts` — Контакты
- `distance` — Дистанция, км
---

## llms.txt

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