# Грузы

События [Грузов](https://ati.su/developers/raw/api/loads/published.md).

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

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

Тема `cargoes`

**Пример**

```json
{
  "cargo_application_id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
  "snapshot_id": 0,
  "cargo_application_number": "string",
  "department_id": 0,
  "persistent_user_id": 0,
  "actor_contact_id": 0,
  "external_id": "string",
  "added_at": "1970-01-01T00:00:00.000Z",
  "updated_at": "1970-01-01T00:00:00.000Z",
  "refreshed_at": "1970-01-01T00:00:00.000Z",
  "origin_source": "string",
  "route": {
    "loading": {
      "city": {
        "city_id": 0,
        "region_id": 0,
        "country_id": 0
      },
      "coordinates": {
        "longitude": 0.5,
        "latitude": 0.5
      },
      "address": "string",
      "organization": {
        "organization_id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
        "address_id": "3fa85f64-5717-4562-b3fc-2c963f66afa6"
      }
    },
    "unloading": {
      "city": {
        "city_id": 0,
        "region_id": 0,
        "country_id": 0
      },
      "coordinates": {
        "longitude": 0.5,
        "latitude": 0.5
      },
      "address": "string",
      "organization": {
        "organization_id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
        "address_id": "3fa85f64-5717-4562-b3fc-2c963f66afa6"
      }
    },
    "way_points": [
      {
        "city": {
          "city_id": 0,
          "region_id": 0,
          "country_id": 0
        },
        "coordinates": {
          "longitude": 0.5,
          "latitude": 0.5
        },
        "address": "string",
        "organization": {
          "organization_id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
          "address_id": "3fa85f64-5717-4562-b3fc-2c963f66afa6"
        }
      }
    ],
    "is_round_trip": false
  },
  "truck": {
    "trucks_count": 0,
    "load_type": "string",
    "body_types": [
      0
    ],
    "is_tracking": false,
    "adr": 0,
    "belts_count": 0,
    "required_capacity": 0.5,
    "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,
      "team_driving": false
    }
  },
  "payment": {
    "type": "string",
    "hide_counter_offers": false,
    "direct_offer": false,
    "prepayment": {
      "percent": 0,
      "using_fuel": false
    },
    "payment_mode": {
      "type": "string"
    }
  },
  "boards": [
    {
      "id": "string",
      "publication_mode": "string",
      "publication_time": "1970-01-01T00:00:00.000Z",
      "cancel_publish_on_auction_bet": false,
      "reservation_enabled": false,
      "is_published": false
    }
  ],
  "documents": [
    {
      "file_id": "string",
      "name": "string",
      "link": "string"
    }
  ],
  "application_contacts": [
    {
      "id": 0
    }
  ],
  "paid_features": {
    "priority_view": {
      "rate": 0.5,
      "only_for_paid_users": false,
      "limit": 0.5,
      "daily_limit": 0.5
    },
    "stealth": {
      "list_id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
      "minimal_registration_date": "1970-01-01T00:00:00.000Z",
      "minimal_stars_count": 0
    }
  },
  "note": "string",
  "lot_id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
  "lot_number": 0,
  "is_pass_through_copy": false,
  "is_archived": false,
  "archive_date": "1970-01-01T00:00:00.000Z"
}
```

**Описание полей модели**
- `cargo_application_id` — Id груза
- `snapshot_id` — Id состояния груза (меняется при каждом редактировании)
- `cargo_application_number` — Номер груза, автоматически генерируемый ATI.SU
- `department_id` — Подразделение, которому принадлежит заявка.
- `persistent_user_id` — Идентификатор пользователя, разместившего заявку
- `actor_contact_id` — Идентификатор контакта, разместившего заявку
- `external_id` — Внешний номер груза или заказа
- `added_at` — Время добавления груза, UTC
- `updated_at` — Время последнего изменения груза, UTC
- `refreshed_at` — Время последнего обновления груза, UTC (поднятие груза в поисковой выдаче)
- `origin_source` — Использованный api при создания груза: - `web-cargos-api`, - `mobile-cargos-api`, - `internal-cargos-api`, - `public-cargos-api`, - `internal-atrucks`, - `internal-torgtrans`, - `csv_import`, - `pass-through`, - `unknown`
- `route` — Маршрут
- `route.loading` — Загрузка
- `route.loading.city` — Информация о населённом пункте
- `route.loading.city.city_id` — Id города из словаря городов
- `route.loading.city.region_id` — Id региона из словаря регионов
- `route.loading.city.country_id` — Id страны из словаря стран
- `route.loading.coordinates` — Координаты
- `route.loading.coordinates.longitude` — Долгота
- `route.loading.coordinates.latitude` — Широта
- `route.loading.address` — Адрес в населённом пункте
- `route.loading.organization` — Данные об организации из справочника
- `route.loading.organization.organization_id` — Id из справочника организаций
- `route.loading.organization.address_id` — Id адреса в организации
- `route.unloading` — Разгрузка
- `route.unloading.city` — Информация о населённом пункте
- `route.unloading.city.city_id` — Id города из словаря городов
- `route.unloading.city.region_id` — Id региона из словаря регионов
- `route.unloading.city.country_id` — Id страны из словаря стран
- `route.unloading.coordinates` — Координаты
- `route.unloading.coordinates.longitude` — Долгота
- `route.unloading.coordinates.latitude` — Широта
- `route.unloading.address` — Адрес в населённом пункте
- `route.unloading.organization` — Данные об организации из справочника
- `route.unloading.organization.organization_id` — Id из справочника организаций
- `route.unloading.organization.address_id` — Id адреса в организации
- `route.way_points` — Точки маршрута
- `route.way_points[].city` — Информация о населённом пункте
- `route.way_points[].city.city_id` — Id города из словаря городов
- `route.way_points[].city.region_id` — Id региона из словаря регионов
- `route.way_points[].city.country_id` — Id страны из словаря стран
- `route.way_points[].coordinates` — Координаты
- `route.way_points[].coordinates.longitude` — Долгота
- `route.way_points[].coordinates.latitude` — Широта
- `route.way_points[].address` — Адрес в населённом пункте
- `route.way_points[].organization` — Данные об организации из справочника
- `route.way_points[].organization.organization_id` — Id из справочника организаций
- `route.way_points[].organization.address_id` — Id адреса в организации
- `route.is_round_trip` — Кругорейс
- `truck` — Транспорт
- `truck.trucks_count` — Количество машин
- `truck.load_type` — Загрузка: - `ftl` — отдельной машиной - `dont-care` — не важно
- `truck.body_types` — TypeId типов кузовов. Значение TypeId из словаря кузовов
- `truck.is_tracking` — Трекинг через АТИ Водитель
- `truck.adr` — ADR
- `truck.belts_count` — Количество ремней
- `truck.required_capacity` — Требуемая грузоподъемность в тоннах
- `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.requirements.team_driving` — Экипаж - требуется 2 водителя
- `payment` — Оплата
- `payment.type` — Тип оплаты: - `with-bargaining` - ставка с возможностью торга - `without-bargaining` - ставка без возможности торга - `rate-request` - запрос ставки - `auction` - у заявки проводятся Торги
- `payment.hide_counter_offers` — Встречные предложения видны только вам
- `payment.direct_offer` — Прямой договор
- `payment.prepayment` — Предоплата
- `payment.prepayment.percent` — Процент предоплаты
- `payment.prepayment.using_fuel` — Предоплата топливом
- `payment.payment_mode` — Режим оплаты
- `payment.payment_mode.type` — Тип режима оплаты: - `delayed-payment` — через несколько дней - `on-unloading` — на выгрузке
- `boards` — Площадки груза
- `boards[].id` — Id площадки
- `boards[].publication_mode` — Опубликовать груз: now – сразу `15m` – через 15 минут `30m` – через 30 минут `1h` – через час `3h` – через 3 часа `6h` – через 6 часов `exact-time` - в точное время
- `boards[].publication_time` — Точное время публикации груза, для publication_mode = 'exact-time'
- `boards[].cancel_publish_on_auction_bet` — Не публиковать груз при отложенной публикации, если появилась ставка по Торгам
- `boards[].reservation_enabled` — Разрешить перевозчикам бронировать груз
- `boards[].is_published` — Груз опубликован на площадке
- `documents` — Фото груза и документов
- `documents[].file_id` — Id документа в API Плюшкин (TODO ссылка)
- `documents[].name` — Название документа
- `documents[].link` — Ссылка на документ
- `application_contacts` — Информация о контактах груза
- `application_contacts[].id` — Id контакта
- `paid_features` — Платные услуги
- `paid_features.priority_view` — Приоритетный показ
- `paid_features.priority_view.rate` — Ставка за просмотр
- `paid_features.priority_view.only_for_paid_users` — Показывать приоритетный груз только платным пользователям
- `paid_features.priority_view.limit` — Лимит на заявку
- `paid_features.priority_view.daily_limit` — Суточный лимит
- `paid_features.stealth` — Стэлс
- `paid_features.stealth.list_id` — Id списка фирм для скрытия
- `paid_features.stealth.minimal_registration_date` — Минимальная дата регистрации фирм, которые будут видеть груза
- `paid_features.stealth.minimal_stars_count` — Минимальное количество звёзд фирм, которые будут видеть груз
- `note` — Примечание к грузу
- `lot_id` — Id Лота, к которому прикреплён данный груз
- `lot_number` — Номер Лота, к которому прикреплён данный груз
- `is_pass_through_copy` — Является ли груз сквозной копией
- `is_archived` — Отправлен ли груз в архив
- `archive_date` — Время отправки груза в архив, UTC