Грузы
События Грузов.
При возникновении события в системе ATI.SU, к вебхуку будет отправлен POST запрос.
В параметре entity будет сущность темы подписки в соответствии с моделью, представленной на этой странице.
При удалении Груза, параметр entity будет принимать значение null.
Тема cargoes
Контракт заявки груза, ожидаемый в ответах integration http методов работы с грузами
ID груза OBSOLETE используй поле CargoApplicationId
Номер груза, автоматически генерируемый ATI.SU OBSOLETE используй поле CargoApplicationNumber
OBSOLETE используй поле OriginSource
Контакты OBSOLETE используй поле ApplicationContacts
Дистанция, км
Id груза
Id состояния груза (меняется при каждом редактировании)
Номер груза, автоматически генерируемый ATI.SU
Подразделение, которому принадлежит заявка.
Идентификатор пользователя, разместившего заявку
Идентификатор контакта, разместившего заявку
Внешний номер груза или заказа
Время добавления груза, UTC
Время последнего изменения груза, UTC
Время последнего поднятия груза, UTC
Использованный api при создания груза: - web-cargos-api, - mobile-cargos-api, - public-cargos-api
Маршрут
Основная точка загрузки — начало маршрута. Здесь даты загрузки и грузы, которые забирают в начале маршрута.
Ближайшие города. Id города из словаря OBSOLETE используй поле NearbyCities
Даты загрузки. Вид задаёт дискриминатор type.
Тип даты — в промежутке дат (from-date).
Время загрузки в пределах дня.
Время в пределах дня. Вид задаёт дискриминатор type. Часовой пояс времени приходит полем offset и не связан со смещением в датах.
Тип времени — с ограничением (bounded).
Начало интервала в формате HH:mm.
Конец интервала в формате HH:mm.
Часовой пояс интервала в формате +HH:mm.
Первый день, когда груз можно забрать. Приходит при любом type, в том числе ready и permanent.
Последний день, когда груз можно забрать. Приходит при любом type, в том числе ready и permanent.
Готов к загрузке сегодня и завтра (TODO возможно убрать)
Время загрузки в пределах дня.
Время в пределах дня. Вид задаёт дискриминатор type. Часовой пояс времени приходит полем offset и не связан со смещением в датах.
Тип времени — с ограничением (bounded).
Начало интервала в формате HH:mm.
Конец интервала в формате HH:mm.
Часовой пояс интервала в формате +HH:mm.
Первый день, когда груз можно забрать. Приходит при любом type, в том числе ready и permanent.
Последний день, когда груз можно забрать. Приходит при любом type, в том числе ready и permanent.
Периодичность постоянной загрузки: - everyday — каждый день - workdays — по рабочим дням
Время загрузки в пределах дня.
Время в пределах дня. Вид задаёт дискриминатор type. Часовой пояс времени приходит полем offset и не связан со смещением в датах.
Тип времени — с ограничением (bounded).
Начало интервала в формате HH:mm.
Конец интервала в формате HH:mm.
Часовой пояс интервала в формате +HH:mm.
Первый день, когда груз можно забрать. Приходит при любом type, в том числе ready и permanent.
Последний день, когда груз можно забрать. Приходит при любом type, в том числе ready и permanent.
Первый день, когда груз можно забрать. Приходит при любом type, в том числе ready и permanent.
Последний день, когда груз можно забрать. Приходит при любом type, в том числе ready и permanent.
Грузы заявки. cargo_id сквозной по всей заявке: по нему точки разгрузки указывают, что снимают.
Id наименования груза. dict: GET /gw/marshak/v1/dictionaries/cargo_typ → dictionary_item_id Для груза, созданного через API, сервис подбирает id по name. Нет совпадения — приходит 59 «Другой».
Наименование груза
Упаковка
Упаковка груза.
Id типа упаковки. dict: GET /gw/marshak/v1/dictionaries/pack_types → dictionary_item_id
Количество
Номер груза, сквозной по всей заявке. По нему точки разгрузки указывают, какой именно груз снимают.
Вес
Вес груза.
Тип: - tons — тонны - kilos — килограммы
Количество
Объём
Объём груза.
Количество
Габариты
Габариты груза.
Длина, метры
Габаритный размер.
Значение
Выделить значение цветом в результатах поиска
Высота, метры
Габаритный размер.
Значение
Выделить значение цветом в результатах поиска
Ширина, метры
Габаритный размер.
Значение
Выделить значение цветом в результатах поиска
Диаметр, метры
Ближайшие крупные города, не больше 10.
Id города. dict: GET /v1.0/dictionaries/cities → id
Расстояние от точки маршрута до этого города, километры.
Id города из словаря OBSOLETE используй поле City.CityId
Населённый пункт точки.
Id города. dict: GET /v1.0/dictionaries/cities → id
Id региона. dict: GET /v1.0/dictionaries/regions → id
Id страны. dict: GET /v1.0/dictionaries/countries → id
Координаты точки.
Координаты.
Долгота
Широта
Адрес в населённом пункте.
Организация из справочника, если адрес точки был взят оттуда. Иначе не заполнена.
Организация — грузоотправитель или грузополучатель. Её адрес указан в точке маршрута.
Id организации. dict: GET /v1.2/catalogs/organizations → id
Id адреса организации. dict: GET /v1.2/catalogs/organizations/addresses → id
Основная точка разгрузки — конец маршрута.
Ближайшие города. Id города из словаря OBSOLETE используй поле NearbyCities
Даты разгрузки. Могут быть не заданы.
Даты разгрузки. Значима календарная дата, а не момент времени: день определяется по смещению в значении.
Первый день разгрузки.
Последний день разгрузки.
Время разгрузки в пределах дня.
Время в пределах дня. Вид задаёт дискриминатор type. Часовой пояс времени приходит полем offset и не связан со смещением в датах.
Тип времени — с ограничением (bounded).
Начало интервала в формате HH:mm.
Конец интервала в формате HH:mm.
Часовой пояс интервала в формате +HH:mm.
Ближайшие крупные города, не больше 10.
Id города. dict: GET /v1.0/dictionaries/cities → id
Расстояние от точки маршрута до этого города, километры.
Id города из словаря OBSOLETE используй поле City.CityId
Населённый пункт точки.
Id города. dict: GET /v1.0/dictionaries/cities → id
Id региона. dict: GET /v1.0/dictionaries/regions → id
Id страны. dict: GET /v1.0/dictionaries/countries → id
Координаты точки.
Координаты.
Долгота
Широта
Адрес в населённом пункте.
Организация из справочника, если адрес точки был взят оттуда. Иначе не заполнена.
Организация — грузоотправитель или грузополучатель. Её адрес указан в точке маршрута.
Id организации. dict: GET /v1.2/catalogs/organizations → id
Id адреса организации. dict: GET /v1.2/catalogs/organizations/addresses → id
Промежуточные точки между загрузкой и разгрузкой, не больше 15, в порядке проезда.
Тип промежуточной точки — точка загрузки (loading).
Грузы, которые забирают в этой точке.
Id наименования груза. dict: GET /gw/marshak/v1/dictionaries/cargo_typ → dictionary_item_id Для груза, созданного через API, сервис подбирает id по name. Нет совпадения — приходит 59 «Другой».
Наименование груза
Упаковка
Упаковка груза.
Id типа упаковки. dict: GET /gw/marshak/v1/dictionaries/pack_types → dictionary_item_id
Количество
Номер груза, сквозной по всей заявке. По нему точки разгрузки указывают, какой именно груз снимают.
Вес
Вес груза.
Тип: - tons — тонны - kilos — килограммы
Количество
Объём
Объём груза.
Количество
Габариты
Габариты груза.
Длина, метры
Габаритный размер.
Значение
Выделить значение цветом в результатах поиска
Высота, метры
Габаритный размер.
Значение
Выделить значение цветом в результатах поиска
Ширина, метры
Габаритный размер.
Значение
Выделить значение цветом в результатах поиска
Диаметр, метры
Дата и время загрузки в этой точке.
Даты прибытия в промежуточную точку. Значима календарная дата, а не момент времени: день определяется по смещению в значении.
Первый день, когда машина может приехать в точку.
Последний день, когда машина может приехать в точку.
Время прибытия в пределах дня.
Время в пределах дня. Вид задаёт дискриминатор type. Часовой пояс времени приходит полем offset и не связан со смещением в датах.
Тип времени — с ограничением (bounded).
Начало интервала в формате HH:mm.
Конец интервала в формате HH:mm.
Часовой пояс интервала в формате +HH:mm.
Id города из словаря OBSOLETE используй поле City.CityId
Населённый пункт точки.
Id города. dict: GET /v1.0/dictionaries/cities → id
Id региона. dict: GET /v1.0/dictionaries/regions → id
Id страны. dict: GET /v1.0/dictionaries/countries → id
Координаты точки.
Координаты.
Долгота
Широта
Адрес в населённом пункте.
Организация из справочника, если адрес точки был взят оттуда. Иначе не заполнена.
Организация — грузоотправитель или грузополучатель. Её адрес указан в точке маршрута.
Id организации. dict: GET /v1.2/catalogs/organizations → id
Id адреса организации. dict: GET /v1.2/catalogs/organizations/addresses → id
Грузы, которые снимают в этой точке.
Снимаемое количество упаковок.
Снимаемая часть груза будет определена в ТТН.
Номер груза, сквозной по всей заявке. По нему точки разгрузки указывают, какой именно груз снимают.
Вес
Вес груза.
Тип: - tons — тонны - kilos — килограммы
Количество
Объём
Объём груза.
Количество
Габариты
Габариты груза.
Длина, метры
Габаритный размер.
Значение
Выделить значение цветом в результатах поиска
Высота, метры
Габаритный размер.
Значение
Выделить значение цветом в результатах поиска
Ширина, метры
Габаритный размер.
Значение
Выделить значение цветом в результатах поиска
Диаметр, метры
Дата и время разгрузки в этой точке.
Даты прибытия в промежуточную точку. Значима календарная дата, а не момент времени: день определяется по смещению в значении.
Первый день, когда машина может приехать в точку.
Последний день, когда машина может приехать в точку.
Время прибытия в пределах дня.
Время в пределах дня. Вид задаёт дискриминатор type. Часовой пояс времени приходит полем offset и не связан со смещением в датах.
Тип времени — с ограничением (bounded).
Начало интервала в формате HH:mm.
Конец интервала в формате HH:mm.
Часовой пояс интервала в формате +HH:mm.
Id города из словаря OBSOLETE используй поле City.CityId
Населённый пункт точки.
Id города. dict: GET /v1.0/dictionaries/cities → id
Id региона. dict: GET /v1.0/dictionaries/regions → id
Id страны. dict: GET /v1.0/dictionaries/countries → id
Координаты точки.
Координаты.
Долгота
Широта
Адрес в населённом пункте.
Организация из справочника, если адрес точки был взят оттуда. Иначе не заполнена.
Организация — грузоотправитель или грузополучатель. Её адрес указан в точке маршрута.
Id организации. dict: GET /v1.2/catalogs/organizations → id
Id адреса организации. dict: GET /v1.2/catalogs/organizations/addresses → id
Id города из словаря OBSOLETE используй поле City.CityId
Населённый пункт точки.
Id города. dict: GET /v1.0/dictionaries/cities → id
Id региона. dict: GET /v1.0/dictionaries/regions → id
Id страны. dict: GET /v1.0/dictionaries/countries → id
Координаты точки.
Координаты.
Долгота
Широта
Адрес в населённом пункте.
Организация из справочника, если адрес точки был взят оттуда. Иначе не заполнена.
Организация — грузоотправитель или грузополучатель. Её адрес указан в точке маршрута.
Id организации. dict: GET /v1.2/catalogs/organizations → id
Id адреса организации. dict: GET /v1.2/catalogs/organizations/addresses → id
Id города из словаря OBSOLETE используй поле City.CityId
Населённый пункт точки.
Id города. dict: GET /v1.0/dictionaries/cities → id
Id региона. dict: GET /v1.0/dictionaries/regions → id
Id страны. dict: GET /v1.0/dictionaries/countries → id
Координаты точки.
Координаты.
Долгота
Широта
Адрес в населённом пункте.
Организация из справочника, если адрес точки был взят оттуда. Иначе не заполнена.
Организация — грузоотправитель или грузополучатель. Её адрес указан в точке маршрута.
Id организации. dict: GET /v1.2/catalogs/organizations → id
Id адреса организации. dict: GET /v1.2/catalogs/organizations/addresses → id
Кругорейс
Транспорт
Количество машин
Вариант загрузки машины, строка: - ftl — отдельной машиной - ltl — догрузом - dont-care — отдельной машиной или догрузом Значение можно без преобразования передать в truck.load_type запроса.
Типы кузова. dict: GET /gw/marshak/v1/dictionaries/cartypes → dictionary_item_id Значения совпадают с TypeId из GET /v1.0/dictionaries/carTypes.
Трекинг через АТИ Водитель
ADR
Количество ремней
Требуемая грузоподъемность в тоннах
Способы загрузки
Способы загрузки или разгрузки.
Способы загрузки или разгрузки списком id. dict: GET /gw/marshak/v1/dictionaries/load_type → dictionary_item_id
Обязательны все выбранные
Способы разгрузки
Способы загрузки или разгрузки.
Способы загрузки или разгрузки списком id. dict: GET /gw/marshak/v1/dictionaries/load_type → dictionary_item_id
Обязательны все выбранные
Температура
Температура.
От
До
Разрешения
Разрешения транспорта.
TIR
CMR
T1
Медкнижка
Требования
Требования к транспорту.
Коники
Сцепка
Пневмоход
Для груза необходимы два водителя
Оплата
Тип оплаты — с возможностью торга (with-bargaining).
Настройки автоматического приглашения на лучшее встречное предложение
Настройки автоматического приглашения на встречные предложения.
Период приема встречного предложения до автоматического приглашения (в формате 30m, 1h, 2d).
Период действия автоматического приглашения (в формате 30m, 1h, 2d).
Архивировать заявку при срабатывании автоматического приглашения
Максимальное возможное отклонение от ставки для срабатывания автоматического приглашения
Id валюты из словаря валют
Deprecated: Использовать поле RatesWithVat
Ставка безнал с НДС
Ставка безнал без НДС
Ставка наличными
Возможность отправлять наличные на карту
Безналичные ставки с НДС — не больше одной на процент
Ставка
НДС процент. Допустимые значения задаёт словарь валют — атрибут vat_percents
Встречные предложения видны только вам
Прямой договор
Предоплата
Предоплата.
Процент предоплаты
Предоплата топливом
Режим оплаты
Режим оплаты.
Тип режима оплаты — через несколько дней (delayed-payment).
Количество банковских дней
Id валюты из словаря валют
Deprecated: Использовать поле RatesWithVat
Ставка безнал с НДС
Ставка безнал без НДС
Ставка наличными
Возможность отправлять наличные на карту
Безналичные ставки с НДС — не больше одной на процент
Ставка
НДС процент. Допустимые значения задаёт словарь валют — атрибут vat_percents
Встречные предложения видны только вам
Прямой договор
Предоплата
Предоплата.
Процент предоплаты
Предоплата топливом
Режим оплаты
Режим оплаты.
Тип режима оплаты — через несколько дней (delayed-payment).
Количество банковских дней
Можно предлагать ставки безнал с НДС
Можно предлагать ставки безнал без НДС
Можно предлагать ставки наличными
Настройки автоматического приглашения на лучшее встречное предложение
Настройки автоматического приглашения на встречные предложения.
Период приема встречного предложения до автоматического приглашения (в формате 30m, 1h, 2d).
Период действия автоматического приглашения (в формате 30m, 1h, 2d).
Архивировать заявку при срабатывании автоматического приглашения
Максимальное возможное отклонение от ставки для срабатывания автоматического приглашения
Встречные предложения видны только вам
Прямой договор
Предоплата
Предоплата.
Процент предоплаты
Предоплата топливом
Режим оплаты
Режим оплаты.
Тип режима оплаты — через несколько дней (delayed-payment).
Количество банковских дней
Id Торгов
Начальная ставка Торгов
Id валюты из словаря валют
Шаг ставки Торгов
Принимать ставки с НДС
Принимать ставки без НДС
Размер НДС, в процентах
Опция Антиснайпер
Время, за которое победитель обязан предоставить документы
Критерий выбора победителя Торгов, строка: - best-rate — по лучшей ставке - matching-date — с учётом даты загрузки и лучшей ставки
Количество автоматических переназначений победителя Торгов, в случае отказа от груза
Параметры длительности Торгов
Может быть null, если есть значение у поля FinishUntil. Длительность проведения Торгов: 30m — 30 минут 1h — 1 час 2h — 2 часа 3h — 3 часа 4h — 4 часа 6h — 6 часов 12h — 12 часов 1d — 1 день 2d — 2 дня 3d — 3 дня 4d — 4 дня 5d — 5 дней
Отсчитывать длительность Торгов с момента первой ставки
Точные дата и время завершения Торгов
Действие при окончательном завершении Торгов без победителя
Действие — переместить заявку в архив (archive).
Id валюты из словаря валют
Deprecated: Использовать поле RatesWithVat
Ставка безнал с НДС
Ставка безнал без НДС
Ставка наличными
Возможность отправлять наличные на карту
Автоматическое приглашение на лучшее встречное предложение
Настройки автоматического приглашения на встречные предложения.
Период приема встречного предложения до автоматического приглашения (в формате 30m, 1h, 2d).
Период действия автоматического приглашения (в формате 30m, 1h, 2d).
Архивировать заявку при срабатывании автоматического приглашения
Максимальное возможное отклонение от ставки для срабатывания автоматического приглашения
Безналичные ставки с НДС — не больше одной на процент
Ставка
НДС процент. Допустимые значения задаёт словарь валют — атрибут vat_percents
Можно предлагать ставки безнал с НДС
Можно предлагать ставки безнал без НДС
Можно предлагать ставки наличными
Автоматическое приглашение на лучшее встречное предложение
Настройки автоматического приглашения на встречные предложения.
Период приема встречного предложения до автоматического приглашения (в формате 30m, 1h, 2d).
Период действия автоматического приглашения (в формате 30m, 1h, 2d).
Архивировать заявку при срабатывании автоматического приглашения
Максимальное возможное отклонение от ставки для срабатывания автоматического приглашения
Параметры доступности встречных предложений во время проведения Торгов
Параметры доступности встречных предложений во время Торгов.
Может быть null, в таком случае будем принимать встречные предложения сразу. Принимать встречные предложения через: - 30m — 30 минут - 1h — 1 час - 2h — 2 часа - 3h — 3 часа - 4h — 4 часа - 6h — 6 часов - 12h — 12 часов
Принимать встречные предложения до первой ставки по Торгам
Параметры автопродления Торгов
Параметры автопродления Торгов.
Количество минут, на которые будут продливаться Торги
Максимальное время, на которое будут продливаться Торги (в минутах)
Параметры повышения ставки Торгов при отсутствии ставок
Параметры повышения ставки Торгов при отсутствии ставок.
Интервал автоматического повышения ставки в минутах.
Максимальное значение ставки Торгов
Параметры перезапуска Торгов в случае отсутствия ставок
Параметры перезапуска Торгов при отсутствии ставок.
Количество перезапусков
Длительность Торгов после перезапуска: 30m — 30 минут 1h — 1 час 2h — 2 часа 3h — 3 часа 4h — 4 часа 6h — 6 часов 12h — 12 часов
Параметры повышения начальной ставки после перезапуска торгов.
Параметры повышения начальной ставки после перезапуска Торгов.
Тип повышения — абсолютное значение в валюте (currency).
Значение, на которое нужно повысить начальную ставку.
Значение, на которое нужно повысить начальную ставку.
Встречные предложения видны только вам
Прямой договор
Предоплата
Предоплата.
Процент предоплаты
Предоплата топливом
Режим оплаты
Режим оплаты.
Тип режима оплаты — через несколько дней (delayed-payment).
Количество банковских дней
Площадки груза
Id площадки
Опубликовать груз: now – сразу 15m – через 15 минут 30m – через 30 минут 1h – через час 3h – через 3 часа 6h – через 6 часов exact-time - в точное время
Точное время публикации груза, для publication_mode = 'exact-time'
Не публиковать груз при отложенной публикации, если появилась ставка по Торгам
Стратегия ограничений публикации груза на площадке
Разрешить перевозчикам бронировать груз
Груз опубликован на площадке
Фото груза и документов
Старый id документа OBSOLETE используй поле FileID
Id документа в API Плюшкин (TODO ссылка)
Название документа
Ссылка на документ
Информация о контактах груза
Id контакта
Платные услуги
Платные услуги: приоритетный показ, стелс.
Приоритетный показ
Приоритетный показ.
Потрачено атисов за день OBSOLETE необходимо получать эту информацию из api приоритетного показа по грузам
Потрачено атисов на эту заявку OBSOLETE необходимо получать эту информацию из api приоритетного показа по грузам
Ставка за просмотр
Показывать приоритетный груз только платным пользователям
Лимит на заявку
Суточный лимит
Стэлс
Стелс.
Id списка фирм для скрытия
Минимальная дата регистрации фирм, которые будут видеть груза
Минимальное количество звёзд фирм, которые будут видеть груз
Примечание к грузу
Id Лота, к которому прикреплён данный груз
Номер Лота, к которому прикреплён данный груз
Является ли груз сквозной копией
Отправлен ли груз в архив
Время отправки груза в архив, UTC
Истинная ставка на груз после жалоб "Озвученная ставка"
Истинная валюта ставки на груз после жалоб "Озвученная ставка"
Идентификатор интегратора (клиентского приложения), через которое был создан груз