Поддержка
Чат для вопросов по API
Мгновенно ответим на ваши вопросы
api@ati.su
Электронная почта техподдержки
Тикетная система
Оставить заявку на отдел
«Консультанты по интеграции (API)»
api.ati.su - заказы, торги, площадки
Наш телеграм-канал
Код в ATI.SU:
Выход
Для подтверждения действия введите пароль
Чтобы продолжить, введите пароль для пользователя

Опубликованные грузы

Методы для работы с грузами

Добавление груза

Перед добавлением происходит сначала проверка на возможность объединения грузов, а потом проверка на дублирование.

 
post
/v2/cargos
Развернуть все Свернуть все
{...}
}
CURL 1C
CURL
Копировать

                
1C
Копировать

                
Пример ответа Ответ
200 Success
Развернуть все Свернуть все
Пример Модель
{...}
"cargo_application":{...}
"cargo_id":"3fa85f64-5717-4562-b3fc-2c963f66afa6",
"cargo_number":"string",
"external_id":"string",
"added_at":"1970-01-01T00:00:00.000Z",
"updated_at":"1970-01-01T00:00:00.000Z",
"persistent_user_id":0,
"department_id":0,
"route":{...},
"loading":{...},
"city_id":0,
"address":"string",
"coordinates":{...},
"longitude":0.5,
"latitude":0.5
},
"organization":{...}
"organization_id":"3fa85f64-5717-4562-b3fc-2c963f66afa6",
"address_id":"3fa85f64-5717-4562-b3fc-2c963f66afa6"
}
},
"unloading":{...},
"city_id":0,
"address":"string",
"coordinates":{...},
"longitude":0.5,
"latitude":0.5
},
"organization":{...}
"organization_id":"3fa85f64-5717-4562-b3fc-2c963f66afa6",
"address_id":"3fa85f64-5717-4562-b3fc-2c963f66afa6"
}
},
"way_points":[...],
{...}
"type":"string",
"city_id":0,
"address":"string",
"coordinates":{...},
"longitude":0.5,
"latitude":0.5
},
"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
],
"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":{...},
"hide_counter_offers":false,
"direct_offer":false,
"prepayment":{...},
"percent":0,
"using_fuel":false
},
"payment_mode":{}
},
"documents":[...],
{...}
"id":"string",
"file_id":"string",
"name":"string",
"link":"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
}
],
"paid_features":{...},
"priority_view":{...},
"rate":0.5,
"limit":0.5,
"daily_limit":0.5,
"only_for_paid_users":false,
"money_spent_per_day":0.5,
"money_spent_per_order":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",
"contacts":[...],
0
],
"is_pass_through_copy":false,
"is_test":false,
"is_archived":false,
"archive_date":"1970-01-01T00:00:00.000Z",
"has_counter_offer":false,
"has_contract":false,
"distance":0,
"lot_id":"3fa85f64-5717-4562-b3fc-2c963f66afa6",
"lot_number":0,
"source":0
}
}
{...}
}
Загрузка...
Развернуть все Свернуть все
Загрузка...
 
Добавление груза
Данная версия метода устарела и её поддержка будет прекращена.
Пожалуйста, пользуйтесь актуальной версией API.
post
/v1.0/loads
Развернуть все Свернуть все
{...}
ContactId1*: int32

Идентификатор первого выбранного контакта.
Список всех контактов и их идентификаторы можно получить с помощью API для работы с фирмами
Контакт должен быть виден для остальных участников АТИ

ContactId2: int32 (nullable)

Идентификатор второго выбранного контакта, если не выбрано, то null
Контакт должен быть виден для остальных участников АТИ

Note: string

Примечание к грузу
Ограничение по длине: 1000 символов

FirstDate: date-time

Дата, начиная с которой груз актуален, в формате UTC
Минимальное значение равно текущей дате
При значении параметра DateType равным 0, допустимое значение поля - текущая дата
При значении параметра DateType равным 1, допустимое значение поля - от текущей даты до 60 дней вперед
При значении параметра DateType равным 2, допустимое значение поля - текущая дата
При значении параметра DateType равным 3, FirstDate должен принимать значение текущей даты или отсутствовать

LastDate: date-time

Дата, после которой груз не актуален, в формате UTC
Минимальное значение равно значению параметра FirstDate
При значении параметра DateType равным 0, допустимое значение поля - от текущей даты до 1 дня вперед
При значении параметра DateType равным 1, допустимое значение поля - от даты в параметре FirstDate до 9 дней вперед
При значении параметра DateType равным 2, данное поле вычисляется автоматически по формуле FirstDate + 2 месяца, передаваемое значение игнорируется
При значении параметра DateType равным 3, LastDate автоматически устанавливается на значение + 2 дня от текущей даты, передаваемое значение игнорируется

DateType: int32

Выбор типа готовности груза к перевозке

  • 0 - Готов к загрузке
  • 1 - с Х по У
  • 2 - постоянно
  • 3 - груза нет, запрос ставки
PeriodicityId: int32

Периодичность загрузки
Если параметр DateType не равен 2, PeriodicityId равен 0.
Иначе PeriodicityId может принимать следующие значения:

  • 1 - ежедневно
  • 100 - по рабочим дням
OrderNumber: string

Номер заказа
Ограничение по длине: 250 символов

Krugoreis: boolean

Параметр, который определяет, включен ли кругорейс для перевозки груза

UnloadFirstDate: date-time (nullable)

Дата начала разгрузки, в формате UTC.
Может иметь значение null.
Минимальное значение равно текущей дате.
При значении параметра DateType равным 3, UnloadFirstDate принимает значение null

UnloadLastDate: date-time (nullable)

Дата окончания разгрузки, в формате UTC. Может иметь значение null.
Если нет даты начала разгрузки UnloadFirstDate, должна отсутствовать дата окончания разгрузки UnloadLastDate.
При значении параметра DateType равным 3, UnloadFirstDate принимает значение null

}
CURL 1C
CURL
Копировать

                
1C
Копировать

                
Пример ответа Ответ
200 Груз
Развернуть все Свернуть все
Пример Модель
{...}
"LoadMeta":{...},
"LoadMetaId":"3fa85f64-5717-4562-b3fc-2c963f66afa6",
"MetaData":"string"
},
"ContactId1":0,
"ContactId2":0,
"Note":"string",
"FirstDate":"1970-01-01T00:00:00.000Z",
"LastDate":"1970-01-01T00:00:00.000Z",
"DateType":0,
"PeriodicityId":0,
"OrderNumber":"string",
"Krugoreis":false,
"Loading":{...},
"CityId":0,
"Latitude":0.5,
"Longitude":0.5,
"Street":"string",
"TimeStart":"1970-01-01T00:00:00.000Z",
"TimeEnd":"1970-01-01T00:00:00.000Z",
"IsRoundTheClock":false,
"LargeCities":[...],
0
],
"LoadingCargos":[...]
{...}
"CargoId":0,
"NameId":0,
"Name":"string",
"PackagingType":0,
"PackagingQuantity":0,
"Weight":0.5,
"Volume":0.5,
"Sizes":{...}
"Length":0.5,
"Width":0.5,
"Height":0.5,
"Diameter":0.5,
"LengthHighlight":false,
"WidthHighlight":false,
"HeightHighlight":false
}
}
]
},
"ExtraPoints":[...],
{...}
"CityId":0,
"PointType":0,
"Latitude":0.5,
"Longitude":0.5,
"Street":"string",
"OrdinalId":0,
"IsRoundTheClock":false,
"LoadingDateStart":"1970-01-01T00:00:00.000Z",
"LoadingDateEnd":"1970-01-01T00:00:00.000Z",
"LoadingTimeStart":null,
"LoadingTimeEnd":null,
"LoadingCargos":[...],
{...}
"CargoId":0,
"NameId":0,
"Name":"string",
"PackagingType":0,
"PackagingQuantity":0,
"Weight":0.5,
"Volume":0.5,
"Sizes":{...}
"Length":0.5,
"Width":0.5,
"Height":0.5,
"Diameter":0.5,
"LengthHighlight":false,
"WidthHighlight":false,
"HeightHighlight":false
}
}
],
"UnloadingCargos":[...]
{...}
"CargoId":0,
"Weight":0.5,
"Volume":0.5,
"PackagingQuantity":0,
"IsDefinedByTtn":false
}
]
}
],
"Unloading":{...},
"CityId":0,
"Latitude":0.5,
"Longitude":0.5,
"Street":"string",
"TimeStart":"1970-01-01T00:00:00.000Z",
"TimeEnd":"1970-01-01T00:00:00.000Z",
"IsRoundTheClock":false,
"LargeCities":[...],
0
],
"LoadingCargos":[...]
{...}
"CargoId":0,
"NameId":0,
"Name":"string",
"PackagingType":0,
"PackagingQuantity":0,
"Weight":0.5,
"Volume":0.5,
"Sizes":{...}
"Length":0.5,
"Width":0.5,
"Height":0.5,
"Diameter":0.5,
"LengthHighlight":false,
"WidthHighlight":false,
"HeightHighlight":false
}
}
]
},
"Cargo":{...},
"Weight":0.5,
"Volume":0.5,
"ADR":0,
"CargoTypeId":0,
"CargoType":"string",
"PackType":0,
"PalletCount":0,
"BeltCount":0,
"DogruzType":0,
"SborGruz":false,
"Size":{...}
"Length":0.5,
"Width":0.5,
"Height":0.5,
"Diameter":0.5,
"LengthHighlight":false,
"WidthHighlight":false,
"HeightHighlight":false
}
},
"Transport":{...},
"CarType":0,
"LoadingType":0,
"LoadingLogicalOperator":"string",
"UnloadingType":0,
"UnloadingLogicalOperator":"string",
"TrucksQuantity":0,
"TemperatureFrom":0,
"TemperatureTo":0,
"Stsepka":false,
"Pnevmohod":false,
"Koniki":false,
"TIR":false,
"CMR":false,
"T1":false,
"SanPassport":false,
"IsTracking":false
},
"Payment":{...},
"CurrencyId":0,
"MoneyType":0,
"RateSum":0.5,
"SumWithNDS":0.5,
"SumWithoutNDS":0.5,
"PrepayPercent":0,
"PrepayPercentEnabled":false,
"PayDays":0,
"PayDaysEnabled":false,
"FixedRate":false,
"Torg":false,
"DirectContract":false,
"InFuel":false,
"OnUnloading":false,
"HideResponses":false,
"AcceptPaymentTypes":0
},
"InviteSettings":{...},
"InviteDelayInSeconds":0,
"InviteDurationInSeconds":0
},
"PriorityView":{...},
"DailyLimit":0.5,
"IsForPayedOnly":false,
"OrderLimit":0.5,
"ViewRate":0.5,
"MoneySpentPerDay":0.5,
"MoneySpentPerOrder":0.5
},
"Stealth":{...},
"ListIdToHide":"3fa85f64-5717-4562-b3fc-2c963f66afa6",
"FirmRegDateToHide":"1970-01-01T00:00:00.000Z",
"ScoreToHide":0.5
},
"LoadFiles":[...],
{...}
"Id":"3fa85f64-5717-4562-b3fc-2c963f66afa6",
"FileType":0,
"Attributes":0,
"Name":"string",
"Link":"string",
"Size":0
}
],
"Deal":{...},
"Auction":{...}
"StartRate":0.5,
"Currency":0,
"Step":0.5,
"PaymentType":0,
"AcceptSecondPayType":false,
"StartDate":"1970-01-01T00:00:00.000Z",
"EndDate":"1970-01-01T00:00:00.000Z",
"EndDateBoundary":"1970-01-01T00:00:00.000Z",
"Nds":0.5,
"TimeToProvideDocuments":0.5,
"AutoRenew":false,
"RenewTime":0,
"MaxRenewTime":0,
"RaiseBid":false,
"MaxRate":0.5,
"RaiseBidInterval":0,
"ResponseInMinutes":0,
"Duration":0,
"StartSinceFirstBet":false,
"AuctionRestartParameters":{...},
"AuctionFinishAction":0,
"InitRestartCount":0,
"InitChangeWinnerCount":0,
"DurationAfterRestart":0
},
"AcceptCounterOffersOnlyBeforeFirstBet":false,
"WinnerCriterion":0,
"AuctionId":"3fa85f64-5717-4562-b3fc-2c963f66afa6",
"LoadId":"3fa85f64-5717-4562-b3fc-2c963f66afa6",
"ActiveDealId":"3fa85f64-5717-4562-b3fc-2c963f66afa6",
"State":0,
"Finished":false,
"WinDate":"1970-01-01T00:00:00.000Z",
"AuctionRates":[...]
{...}
"AuctionRateId":"3fa85f64-5717-4562-b3fc-2c963f66afa6",
"AddedAt":"1970-01-01T00:00:00.000Z",
"RateFirm":{...},
"Score":0.5,
"Status":0,
"Name":"string",
"ContactName":"string",
"AtiId":"string"
},
"Rate":0.5,
"State":0,
"LoadingDate":"1970-01-01T00:00:00.000Z",
"FirmId":0,
"ContactId":0
}
]
}
},
"Boards":[...],
{...}
"BoardId":"string",
"PublicationTime":"1970-01-01T00:00:00.000Z",
"IsReservationEnabled":false,
"PublicationOption":0,
"IsPublished":false,
"IsCommonBoard":false
}
],
"UnloadFirstDate":"1970-01-01T00:00:00.000Z",
"UnloadLastDate":"1970-01-01T00:00:00.000Z",
"ArchiveDate":"1970-01-01T00:00:00.000Z",
"ArchiveReason":"Unknown",
"TruePrice":0,
"TrueCurrencyId":0,
"ResponseCount":0,
"OfferCount":0,
"CanBeDeleted":false,
"HasPermissionsToLoad":false,
"CanBeEdited":false,
"CanBeRenewed":false,
"CanBeRestored":false,
"EditRestriction":0,
"DeleteRestriction":0,
"RestoreRestriction":0,
"RenewRestriction":"string",
"Id":"3fa85f64-5717-4562-b3fc-2c963f66afa6",
"LoadNumber":"string",
"UpdatedAt":"1970-01-01T00:00:00.000Z",
"AddedAt":"1970-01-01T00:00:00.000Z",
"Distance":0,
"PlatonRoadsLength":0,
"TollRoadsLength":0,
"TravelTime":"?",
"Zimnik":false,
"Ferries":false,
"FirmId":"string",
"AuctionId":"3fa85f64-5717-4562-b3fc-2c963f66afa6"
}
{...}
ContactId1*: int32

Идентификатор первого выбранного контакта.
Список всех контактов и их идентификаторы можно получить с помощью API для работы с фирмами
Контакт должен быть виден для остальных участников АТИ

ContactId2: int32 (nullable)

Идентификатор второго выбранного контакта, если не выбрано, то null
Контакт должен быть виден для остальных участников АТИ

Note: string

Примечание к грузу
Ограничение по длине: 1000 символов

FirstDate: date-time

Дата, начиная с которой груз актуален, в формате UTC
Минимальное значение равно текущей дате
При значении параметра DateType равным 0, допустимое значение поля - текущая дата
При значении параметра DateType равным 1, допустимое значение поля - от текущей даты до 60 дней вперед
При значении параметра DateType равным 2, допустимое значение поля - текущая дата
При значении параметра DateType равным 3, FirstDate должен принимать значение текущей даты или отсутствовать

LastDate: date-time

Дата, после которой груз не актуален, в формате UTC
Минимальное значение равно значению параметра FirstDate
При значении параметра DateType равным 0, допустимое значение поля - от текущей даты до 1 дня вперед
При значении параметра DateType равным 1, допустимое значение поля - от даты в параметре FirstDate до 9 дней вперед
При значении параметра DateType равным 2, данное поле вычисляется автоматически по формуле FirstDate + 2 месяца, передаваемое значение игнорируется
При значении параметра DateType равным 3, LastDate автоматически устанавливается на значение + 2 дня от текущей даты, передаваемое значение игнорируется

DateType: int32

Выбор типа готовности груза к перевозке

  • 0 - Готов к загрузке
  • 1 - с Х по У
  • 2 - постоянно
  • 3 - груза нет, запрос ставки
PeriodicityId: int32

Периодичность загрузки
Если параметр DateType не равен 2, PeriodicityId равен 0.
Иначе PeriodicityId может принимать следующие значения:

  • 1 - ежедневно
  • 100 - по рабочим дням
OrderNumber: string

Номер заказа
Ограничение по длине: 250 символов

Krugoreis: boolean

Параметр, который определяет, включен ли кругорейс для перевозки груза

UnloadFirstDate: date-time (nullable)

Дата начала разгрузки, в формате UTC.
Может иметь значение null.
Минимальное значение равно текущей дате.
При значении параметра DateType равным 3, UnloadFirstDate принимает значение null

UnloadLastDate: date-time (nullable)

Дата окончания разгрузки, в формате UTC. Может иметь значение null.
Если нет даты начала разгрузки UnloadFirstDate, должна отсутствовать дата окончания разгрузки UnloadLastDate.
При значении параметра DateType равным 3, UnloadFirstDate принимает значение null

ArchiveDate: date-time (nullable)

Дата и время переноса в архив

ArchiveReason: enum (nullable)
[Unknown, System, Manual, Complaints, UnwantedContent, DeleteCsvLoad, MergeLoadsAfterEdit, ContactDoesNotHaveAccessToVirtualPayments, VerticesLoadDelete, StealthStatisticError, CheckDuplicateComplaints, DeleteContact, DeleteFirm, CleanOldLoadsJob]

Причина переноса в архив

TruePrice: int32

Озвученная ставка

TrueCurrencyId: int32

ID валюты озвученной ставки

ResponseCount: int32

Количество отзывов о грузе (без встречных предложений)

OfferCount: int32

Количество встречных предложений (остальные отзывы не учитываются)

CanBeDeleted: boolean

Есть ли доступ на удаление груза.

HasPermissionsToLoad: boolean

Есть ли доступ на работу с грузом (без учета прав).

CanBeEdited: boolean

Есть ли доступ на редактирование груза.

CanBeRenewed: boolean

Есть ли доступ на обновление груза.

CanBeRestored: boolean

Есть ли доступ на восстановление груза

EditRestriction: enum
[0, 1, 2, 3, 4, 5, 6, 7, 8, 9, 10, 11, 12, 13, 14, 15]

Причины отказа в доступе на редактирование груза:

  • 0 - Вы имеете доступ к работе с грузом
  • 1 - Ваша фирма больше не может размещать грузы из-за нарушения правил АТИ
  • 2 - Груз зарезервирован/взят, операции с грузом запрещены
  • 3 - Превышен лимит актуальных грузов
  • 4 - Вы пытаетесь работать с грузами под общим пользователем. Недостаточно прав
  • 5 - У вашего контакта недостаточно прав для работы с данным грузом
  • 6 - Груз имеет завершенные Торги, операции с грузом запрещены
  • 7 - Сервис сделок временно недоступен
  • 8 - Нельзя изменять или удалять груз из сквозных торгов
  • 9 - У вашего контакта недостаточно прав для создания грузов
  • 10 - У вашего контакта недостаточно прав для работы с виртуальными кошельками
  • 11 - У вашего контакта недостаточно прав для работы с грузами на Общей площадке
  • 12 - У вашего контакта недостаточно прав для работы с грузами на Персональных площадках
  • 13 - У вашего контакта нет доступа для работы с одной или несколькими персональными площадками, указанными в грузе
  • 14 - У вашего контакта нет доступа для работы с подразделением, в которое восстанавливается груз
  • 15 - Ваш контакт должен быть указан первым в грузе
DeleteRestriction: enum
[0, 1, 2, 3, 4, 5, 6, 7, 8, 9, 10, 11, 12, 13, 14, 15]

Причины отказа в доступе на удаление контакта:

  • 0 - Вы имеете доступ к работе с грузом
  • 1 - Ваша фирма больше не может размещать грузы из-за нарушения правил АТИ
  • 2 - Груз зарезервирован/взят, операции с грузом запрещены
  • 3 - Превышен лимит актуальных грузов
  • 4 - Вы пытаетесь работать с грузами под общим пользователем. Недостаточно прав
  • 5 - У вашего контакта недостаточно прав для работы с данным грузом
  • 6 - Груз имеет завершенные Торги, операции с грузом запрещены
  • 7 - Сервис сделок временно недоступен
  • 8 - Нельзя изменять или удалять груз из сквозных торгов
  • 9 - У вашего контакта недостаточно прав для создания грузов
  • 10 - У вашего контакта недостаточно прав для работы с виртуальными кошельками
  • 11 - У вашего контакта недостаточно прав для работы с грузами на Общей площадке
  • 12 - У вашего контакта недостаточно прав для работы с грузами на Персональных площадках
  • 13 - У вашего контакта нет доступа для работы с одной или несколькими персональными площадками, указанными в грузе
  • 14 - У вашего контакта нет доступа для работы с подразделением, в которое восстанавливается груз
  • 15 - Ваш контакт должен быть указан первым в грузе
RestoreRestriction: enum
[0, 1, 2, 3, 4, 5, 6, 7, 8, 9, 10, 11, 12, 13, 14, 15]

Причины отказа в доступе на восстановление груза:

  • 0 - Вы имеете доступ к работе с грузом
  • 1 - Ваша фирма больше не может размещать грузы из-за нарушения правил АТИ
  • 2 - Груз зарезервирован/взят, операции с грузом запрещены
  • 3 - Превышен лимит актуальных грузов
  • 4 - Вы пытаетесь работать с грузами под общим пользователем. Недостаточно прав
  • 5 - У вашего контакта недостаточно прав для работы с данным грузом
  • 6 - Груз имеет завершенные Торги, операции с грузом запрещены
  • 7 - Сервис сделок временно недоступен
  • 8 - Нельзя изменять или удалять груз из сквозных торгов
  • 9 - У вашего контакта недостаточно прав для создания грузов
  • 10 - У вашего контакта недостаточно прав для работы с виртуальными кошельками
  • 11 - У вашего контакта недостаточно прав для работы с грузами на Общей площадке
  • 12 - У вашего контакта недостаточно прав для работы с грузами на Персональных площадках
  • 13 - У вашего контакта нет доступа для работы с одной или несколькими персональными площадками, указанными в грузе
  • 14 - У вашего контакта нет доступа для работы с подразделением, в которое восстанавливается груз
  • 15 - Ваш контакт должен быть указан первым в грузе
RenewRestriction: string

Причина отказа в доступе на обновление груза.

Id: guid

Идентификатор груза

LoadNumber: string

Номер груза

UpdatedAt: date-time

Дата последнего изменения груза в формате UTC

AddedAt: date-time

Время добавления груза в формате UTC

Distance: int32

Расстояние по дорогам в км

PlatonRoadsLength: int32

Протяженность дорог в км, в построенном пути за которые взимается плата по системе Платон

TollRoadsLength: int32

Протяженность платных дорог в построенном пути в км

TravelTime: time-span

Время в пути

Zimnik: boolean

Параметр, который определяет, включен ли зимник для перевозки груза

Ferries: boolean

Параметр, который определяет, учитывать ли паромные переправы для перевозки груза

FirmId: string

Идентификатор фирмы

AuctionId: guid (nullable)

Id аукциона

}
202 У Вас уже есть груз с такими же параметрами, поэтому два груза объединены в один
Развернуть все Свернуть все
Пример Модель
{...}
"Reason":"string",
"Error":"string"
}
{...}

Модель ошибки

Reason: string

Причина ошибки

Error: string

Ключ ошибки

}
4XX Ошибка запроса. Подробнее про ошибки API
Развернуть все Свернуть все
Пример Модель
{...}
"Reason":"string",
"Error":"string"
}
{...}

Модель ошибки

Reason: string

Причина ошибки

Error: string

Ключ ошибки

}
Загрузка...
Развернуть все Свернуть все
Загрузка...

Редактирование груза

Перед редактированием происходит сначала проверка на возможность объединения грузов, а потом проверка на дублирование.
При редактировании груза, как и при добавлении, нужно указывать все необходимые параметры, а не только изменяемые.

 
put
/v2/cargos/{cargoApplicationId}
Развернуть все Свернуть все
{...}
}
CURL 1C
CURL
Копировать

                
1C
Копировать

                
Пример ответа Ответ
200 Success
Развернуть все Свернуть все
Пример Модель
{...}
"cargo_application":{...}
"cargo_id":"3fa85f64-5717-4562-b3fc-2c963f66afa6",
"cargo_number":"string",
"external_id":"string",
"added_at":"1970-01-01T00:00:00.000Z",
"updated_at":"1970-01-01T00:00:00.000Z",
"persistent_user_id":0,
"department_id":0,
"route":{...},
"loading":{...},
"city_id":0,
"address":"string",
"coordinates":{...},
"longitude":0.5,
"latitude":0.5
},
"organization":{...}
"organization_id":"3fa85f64-5717-4562-b3fc-2c963f66afa6",
"address_id":"3fa85f64-5717-4562-b3fc-2c963f66afa6"
}
},
"unloading":{...},
"city_id":0,
"address":"string",
"coordinates":{...},
"longitude":0.5,
"latitude":0.5
},
"organization":{...}
"organization_id":"3fa85f64-5717-4562-b3fc-2c963f66afa6",
"address_id":"3fa85f64-5717-4562-b3fc-2c963f66afa6"
}
},
"way_points":[...],
{...}
"type":"string",
"city_id":0,
"address":"string",
"coordinates":{...},
"longitude":0.5,
"latitude":0.5
},
"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
],
"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":{...},
"hide_counter_offers":false,
"direct_offer":false,
"prepayment":{...},
"percent":0,
"using_fuel":false
},
"payment_mode":{}
},
"documents":[...],
{...}
"id":"string",
"file_id":"string",
"name":"string",
"link":"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
}
],
"paid_features":{...},
"priority_view":{...},
"rate":0.5,
"limit":0.5,
"daily_limit":0.5,
"only_for_paid_users":false,
"money_spent_per_day":0.5,
"money_spent_per_order":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",
"contacts":[...],
0
],
"is_pass_through_copy":false,
"is_test":false,
"is_archived":false,
"archive_date":"1970-01-01T00:00:00.000Z",
"has_counter_offer":false,
"has_contract":false,
"distance":0,
"lot_id":"3fa85f64-5717-4562-b3fc-2c963f66afa6",
"lot_number":0,
"source":0
}
}
{...}
}
Загрузка...
Развернуть все Свернуть все
Загрузка...
 
Редактирование груза
Данная версия метода устарела и её поддержка будет прекращена.
Пожалуйста, пользуйтесь актуальной версией API.
put
/v1.0/loads/{loadId}
Развернуть все Свернуть все
{...}
ContactId1*: int32

Идентификатор первого выбранного контакта.
Список всех контактов и их идентификаторы можно получить с помощью API для работы с фирмами
Контакт должен быть виден для остальных участников АТИ

ContactId2: int32 (nullable)

Идентификатор второго выбранного контакта, если не выбрано, то null
Контакт должен быть виден для остальных участников АТИ

Note: string

Примечание к грузу
Ограничение по длине: 1000 символов

FirstDate: date-time

Дата, начиная с которой груз актуален, в формате UTC
Минимальное значение равно текущей дате
При значении параметра DateType равным 0, допустимое значение поля - текущая дата
При значении параметра DateType равным 1, допустимое значение поля - от текущей даты до 60 дней вперед
При значении параметра DateType равным 2, допустимое значение поля - текущая дата
При значении параметра DateType равным 3, FirstDate должен принимать значение текущей даты или отсутствовать

LastDate: date-time

Дата, после которой груз не актуален, в формате UTC
Минимальное значение равно значению параметра FirstDate
При значении параметра DateType равным 0, допустимое значение поля - от текущей даты до 1 дня вперед
При значении параметра DateType равным 1, допустимое значение поля - от даты в параметре FirstDate до 9 дней вперед
При значении параметра DateType равным 2, данное поле вычисляется автоматически по формуле FirstDate + 2 месяца, передаваемое значение игнорируется
При значении параметра DateType равным 3, LastDate автоматически устанавливается на значение + 2 дня от текущей даты, передаваемое значение игнорируется

DateType: int32

Выбор типа готовности груза к перевозке

  • 0 - Готов к загрузке
  • 1 - с Х по У
  • 2 - постоянно
  • 3 - груза нет, запрос ставки
PeriodicityId: int32

Периодичность загрузки
Если параметр DateType не равен 2, PeriodicityId равен 0.
Иначе PeriodicityId может принимать следующие значения:

  • 1 - ежедневно
  • 100 - по рабочим дням
OrderNumber: string

Номер заказа
Ограничение по длине: 250 символов

Krugoreis: boolean

Параметр, который определяет, включен ли кругорейс для перевозки груза

UnloadFirstDate: date-time (nullable)

Дата начала разгрузки, в формате UTC.
Может иметь значение null.
Минимальное значение равно текущей дате.
При значении параметра DateType равным 3, UnloadFirstDate принимает значение null

UnloadLastDate: date-time (nullable)

Дата окончания разгрузки, в формате UTC. Может иметь значение null.
Если нет даты начала разгрузки UnloadFirstDate, должна отсутствовать дата окончания разгрузки UnloadLastDate.
При значении параметра DateType равным 3, UnloadFirstDate принимает значение null

}
CURL 1C
CURL
Копировать

                
1C
Копировать

                
Пример ответа Ответ
200 Груз
Развернуть все Свернуть все
Пример Модель
{...}
"LoadMeta":{...},
"LoadMetaId":"3fa85f64-5717-4562-b3fc-2c963f66afa6",
"MetaData":"string"
},
"ContactId1":0,
"ContactId2":0,
"Note":"string",
"FirstDate":"1970-01-01T00:00:00.000Z",
"LastDate":"1970-01-01T00:00:00.000Z",
"DateType":0,
"PeriodicityId":0,
"OrderNumber":"string",
"Krugoreis":false,
"Loading":{...},
"CityId":0,
"Latitude":0.5,
"Longitude":0.5,
"Street":"string",
"TimeStart":"1970-01-01T00:00:00.000Z",
"TimeEnd":"1970-01-01T00:00:00.000Z",
"IsRoundTheClock":false,
"LargeCities":[...],
0
],
"LoadingCargos":[...]
{...}
"CargoId":0,
"NameId":0,
"Name":"string",
"PackagingType":0,
"PackagingQuantity":0,
"Weight":0.5,
"Volume":0.5,
"Sizes":{...}
"Length":0.5,
"Width":0.5,
"Height":0.5,
"Diameter":0.5,
"LengthHighlight":false,
"WidthHighlight":false,
"HeightHighlight":false
}
}
]
},
"ExtraPoints":[...],
{...}
"CityId":0,
"PointType":0,
"Latitude":0.5,
"Longitude":0.5,
"Street":"string",
"OrdinalId":0,
"IsRoundTheClock":false,
"LoadingDateStart":"1970-01-01T00:00:00.000Z",
"LoadingDateEnd":"1970-01-01T00:00:00.000Z",
"LoadingTimeStart":null,
"LoadingTimeEnd":null,
"LoadingCargos":[...],
{...}
"CargoId":0,
"NameId":0,
"Name":"string",
"PackagingType":0,
"PackagingQuantity":0,
"Weight":0.5,
"Volume":0.5,
"Sizes":{...}
"Length":0.5,
"Width":0.5,
"Height":0.5,
"Diameter":0.5,
"LengthHighlight":false,
"WidthHighlight":false,
"HeightHighlight":false
}
}
],
"UnloadingCargos":[...]
{...}
"CargoId":0,
"Weight":0.5,
"Volume":0.5,
"PackagingQuantity":0,
"IsDefinedByTtn":false
}
]
}
],
"Unloading":{...},
"CityId":0,
"Latitude":0.5,
"Longitude":0.5,
"Street":"string",
"TimeStart":"1970-01-01T00:00:00.000Z",
"TimeEnd":"1970-01-01T00:00:00.000Z",
"IsRoundTheClock":false,
"LargeCities":[...],
0
],
"LoadingCargos":[...]
{...}
"CargoId":0,
"NameId":0,
"Name":"string",
"PackagingType":0,
"PackagingQuantity":0,
"Weight":0.5,
"Volume":0.5,
"Sizes":{...}
"Length":0.5,
"Width":0.5,
"Height":0.5,
"Diameter":0.5,
"LengthHighlight":false,
"WidthHighlight":false,
"HeightHighlight":false
}
}
]
},
"Cargo":{...},
"Weight":0.5,
"Volume":0.5,
"ADR":0,
"CargoTypeId":0,
"CargoType":"string",
"PackType":0,
"PalletCount":0,
"BeltCount":0,
"DogruzType":0,
"SborGruz":false,
"Size":{...}
"Length":0.5,
"Width":0.5,
"Height":0.5,
"Diameter":0.5,
"LengthHighlight":false,
"WidthHighlight":false,
"HeightHighlight":false
}
},
"Transport":{...},
"CarType":0,
"LoadingType":0,
"LoadingLogicalOperator":"string",
"UnloadingType":0,
"UnloadingLogicalOperator":"string",
"TrucksQuantity":0,
"TemperatureFrom":0,
"TemperatureTo":0,
"Stsepka":false,
"Pnevmohod":false,
"Koniki":false,
"TIR":false,
"CMR":false,
"T1":false,
"SanPassport":false,
"IsTracking":false
},
"Payment":{...},
"CurrencyId":0,
"MoneyType":0,
"RateSum":0.5,
"SumWithNDS":0.5,
"SumWithoutNDS":0.5,
"PrepayPercent":0,
"PrepayPercentEnabled":false,
"PayDays":0,
"PayDaysEnabled":false,
"FixedRate":false,
"Torg":false,
"DirectContract":false,
"InFuel":false,
"OnUnloading":false,
"HideResponses":false,
"AcceptPaymentTypes":0
},
"InviteSettings":{...},
"InviteDelayInSeconds":0,
"InviteDurationInSeconds":0
},
"PriorityView":{...},
"DailyLimit":0.5,
"IsForPayedOnly":false,
"OrderLimit":0.5,
"ViewRate":0.5,
"MoneySpentPerDay":0.5,
"MoneySpentPerOrder":0.5
},
"Stealth":{...},
"ListIdToHide":"3fa85f64-5717-4562-b3fc-2c963f66afa6",
"FirmRegDateToHide":"1970-01-01T00:00:00.000Z",
"ScoreToHide":0.5
},
"LoadFiles":[...],
{...}
"Id":"3fa85f64-5717-4562-b3fc-2c963f66afa6",
"FileType":0,
"Attributes":0,
"Name":"string",
"Link":"string",
"Size":0
}
],
"Deal":{...},
"Auction":{...}
"StartRate":0.5,
"Currency":0,
"Step":0.5,
"PaymentType":0,
"AcceptSecondPayType":false,
"StartDate":"1970-01-01T00:00:00.000Z",
"EndDate":"1970-01-01T00:00:00.000Z",
"EndDateBoundary":"1970-01-01T00:00:00.000Z",
"Nds":0.5,
"TimeToProvideDocuments":0.5,
"AutoRenew":false,
"RenewTime":0,
"MaxRenewTime":0,
"RaiseBid":false,
"MaxRate":0.5,
"RaiseBidInterval":0,
"ResponseInMinutes":0,
"Duration":0,
"StartSinceFirstBet":false,
"AuctionRestartParameters":{...},
"AuctionFinishAction":0,
"InitRestartCount":0,
"InitChangeWinnerCount":0,
"DurationAfterRestart":0
},
"AcceptCounterOffersOnlyBeforeFirstBet":false,
"WinnerCriterion":0,
"AuctionId":"3fa85f64-5717-4562-b3fc-2c963f66afa6",
"LoadId":"3fa85f64-5717-4562-b3fc-2c963f66afa6",
"ActiveDealId":"3fa85f64-5717-4562-b3fc-2c963f66afa6",
"State":0,
"Finished":false,
"WinDate":"1970-01-01T00:00:00.000Z",
"AuctionRates":[...]
{...}
"AuctionRateId":"3fa85f64-5717-4562-b3fc-2c963f66afa6",
"AddedAt":"1970-01-01T00:00:00.000Z",
"RateFirm":{...},
"Score":0.5,
"Status":0,
"Name":"string",
"ContactName":"string",
"AtiId":"string"
},
"Rate":0.5,
"State":0,
"LoadingDate":"1970-01-01T00:00:00.000Z",
"FirmId":0,
"ContactId":0
}
]
}
},
"Boards":[...],
{...}
"BoardId":"string",
"PublicationTime":"1970-01-01T00:00:00.000Z",
"IsReservationEnabled":false,
"PublicationOption":0,
"IsPublished":false,
"IsCommonBoard":false
}
],
"UnloadFirstDate":"1970-01-01T00:00:00.000Z",
"UnloadLastDate":"1970-01-01T00:00:00.000Z",
"ArchiveDate":"1970-01-01T00:00:00.000Z",
"ArchiveReason":"Unknown",
"TruePrice":0,
"TrueCurrencyId":0,
"ResponseCount":0,
"OfferCount":0,
"CanBeDeleted":false,
"HasPermissionsToLoad":false,
"CanBeEdited":false,
"CanBeRenewed":false,
"CanBeRestored":false,
"EditRestriction":0,
"DeleteRestriction":0,
"RestoreRestriction":0,
"RenewRestriction":"string",
"Id":"3fa85f64-5717-4562-b3fc-2c963f66afa6",
"LoadNumber":"string",
"UpdatedAt":"1970-01-01T00:00:00.000Z",
"AddedAt":"1970-01-01T00:00:00.000Z",
"Distance":0,
"PlatonRoadsLength":0,
"TollRoadsLength":0,
"TravelTime":"?",
"Zimnik":false,
"Ferries":false,
"FirmId":"string",
"AuctionId":"3fa85f64-5717-4562-b3fc-2c963f66afa6"
}
{...}
ContactId1*: int32

Идентификатор первого выбранного контакта.
Список всех контактов и их идентификаторы можно получить с помощью API для работы с фирмами
Контакт должен быть виден для остальных участников АТИ

ContactId2: int32 (nullable)

Идентификатор второго выбранного контакта, если не выбрано, то null
Контакт должен быть виден для остальных участников АТИ

Note: string

Примечание к грузу
Ограничение по длине: 1000 символов

FirstDate: date-time

Дата, начиная с которой груз актуален, в формате UTC
Минимальное значение равно текущей дате
При значении параметра DateType равным 0, допустимое значение поля - текущая дата
При значении параметра DateType равным 1, допустимое значение поля - от текущей даты до 60 дней вперед
При значении параметра DateType равным 2, допустимое значение поля - текущая дата
При значении параметра DateType равным 3, FirstDate должен принимать значение текущей даты или отсутствовать

LastDate: date-time

Дата, после которой груз не актуален, в формате UTC
Минимальное значение равно значению параметра FirstDate
При значении параметра DateType равным 0, допустимое значение поля - от текущей даты до 1 дня вперед
При значении параметра DateType равным 1, допустимое значение поля - от даты в параметре FirstDate до 9 дней вперед
При значении параметра DateType равным 2, данное поле вычисляется автоматически по формуле FirstDate + 2 месяца, передаваемое значение игнорируется
При значении параметра DateType равным 3, LastDate автоматически устанавливается на значение + 2 дня от текущей даты, передаваемое значение игнорируется

DateType: int32

Выбор типа готовности груза к перевозке

  • 0 - Готов к загрузке
  • 1 - с Х по У
  • 2 - постоянно
  • 3 - груза нет, запрос ставки
PeriodicityId: int32

Периодичность загрузки
Если параметр DateType не равен 2, PeriodicityId равен 0.
Иначе PeriodicityId может принимать следующие значения:

  • 1 - ежедневно
  • 100 - по рабочим дням
OrderNumber: string

Номер заказа
Ограничение по длине: 250 символов

Krugoreis: boolean

Параметр, который определяет, включен ли кругорейс для перевозки груза

UnloadFirstDate: date-time (nullable)

Дата начала разгрузки, в формате UTC.
Может иметь значение null.
Минимальное значение равно текущей дате.
При значении параметра DateType равным 3, UnloadFirstDate принимает значение null

UnloadLastDate: date-time (nullable)

Дата окончания разгрузки, в формате UTC. Может иметь значение null.
Если нет даты начала разгрузки UnloadFirstDate, должна отсутствовать дата окончания разгрузки UnloadLastDate.
При значении параметра DateType равным 3, UnloadFirstDate принимает значение null

ArchiveDate: date-time (nullable)

Дата и время переноса в архив

ArchiveReason: enum (nullable)
[Unknown, System, Manual, Complaints, UnwantedContent, DeleteCsvLoad, MergeLoadsAfterEdit, ContactDoesNotHaveAccessToVirtualPayments, VerticesLoadDelete, StealthStatisticError, CheckDuplicateComplaints, DeleteContact, DeleteFirm, CleanOldLoadsJob]

Причина переноса в архив

TruePrice: int32

Озвученная ставка

TrueCurrencyId: int32

ID валюты озвученной ставки

ResponseCount: int32

Количество отзывов о грузе (без встречных предложений)

OfferCount: int32

Количество встречных предложений (остальные отзывы не учитываются)

CanBeDeleted: boolean

Есть ли доступ на удаление груза.

HasPermissionsToLoad: boolean

Есть ли доступ на работу с грузом (без учета прав).

CanBeEdited: boolean

Есть ли доступ на редактирование груза.

CanBeRenewed: boolean

Есть ли доступ на обновление груза.

CanBeRestored: boolean

Есть ли доступ на восстановление груза

EditRestriction: enum
[0, 1, 2, 3, 4, 5, 6, 7, 8, 9, 10, 11, 12, 13, 14, 15]

Причины отказа в доступе на редактирование груза:

  • 0 - Вы имеете доступ к работе с грузом
  • 1 - Ваша фирма больше не может размещать грузы из-за нарушения правил АТИ
  • 2 - Груз зарезервирован/взят, операции с грузом запрещены
  • 3 - Превышен лимит актуальных грузов
  • 4 - Вы пытаетесь работать с грузами под общим пользователем. Недостаточно прав
  • 5 - У вашего контакта недостаточно прав для работы с данным грузом
  • 6 - Груз имеет завершенные Торги, операции с грузом запрещены
  • 7 - Сервис сделок временно недоступен
  • 8 - Нельзя изменять или удалять груз из сквозных торгов
  • 9 - У вашего контакта недостаточно прав для создания грузов
  • 10 - У вашего контакта недостаточно прав для работы с виртуальными кошельками
  • 11 - У вашего контакта недостаточно прав для работы с грузами на Общей площадке
  • 12 - У вашего контакта недостаточно прав для работы с грузами на Персональных площадках
  • 13 - У вашего контакта нет доступа для работы с одной или несколькими персональными площадками, указанными в грузе
  • 14 - У вашего контакта нет доступа для работы с подразделением, в которое восстанавливается груз
  • 15 - Ваш контакт должен быть указан первым в грузе
DeleteRestriction: enum
[0, 1, 2, 3, 4, 5, 6, 7, 8, 9, 10, 11, 12, 13, 14, 15]

Причины отказа в доступе на удаление контакта:

  • 0 - Вы имеете доступ к работе с грузом
  • 1 - Ваша фирма больше не может размещать грузы из-за нарушения правил АТИ
  • 2 - Груз зарезервирован/взят, операции с грузом запрещены
  • 3 - Превышен лимит актуальных грузов
  • 4 - Вы пытаетесь работать с грузами под общим пользователем. Недостаточно прав
  • 5 - У вашего контакта недостаточно прав для работы с данным грузом
  • 6 - Груз имеет завершенные Торги, операции с грузом запрещены
  • 7 - Сервис сделок временно недоступен
  • 8 - Нельзя изменять или удалять груз из сквозных торгов
  • 9 - У вашего контакта недостаточно прав для создания грузов
  • 10 - У вашего контакта недостаточно прав для работы с виртуальными кошельками
  • 11 - У вашего контакта недостаточно прав для работы с грузами на Общей площадке
  • 12 - У вашего контакта недостаточно прав для работы с грузами на Персональных площадках
  • 13 - У вашего контакта нет доступа для работы с одной или несколькими персональными площадками, указанными в грузе
  • 14 - У вашего контакта нет доступа для работы с подразделением, в которое восстанавливается груз
  • 15 - Ваш контакт должен быть указан первым в грузе
RestoreRestriction: enum
[0, 1, 2, 3, 4, 5, 6, 7, 8, 9, 10, 11, 12, 13, 14, 15]

Причины отказа в доступе на восстановление груза:

  • 0 - Вы имеете доступ к работе с грузом
  • 1 - Ваша фирма больше не может размещать грузы из-за нарушения правил АТИ
  • 2 - Груз зарезервирован/взят, операции с грузом запрещены
  • 3 - Превышен лимит актуальных грузов
  • 4 - Вы пытаетесь работать с грузами под общим пользователем. Недостаточно прав
  • 5 - У вашего контакта недостаточно прав для работы с данным грузом
  • 6 - Груз имеет завершенные Торги, операции с грузом запрещены
  • 7 - Сервис сделок временно недоступен
  • 8 - Нельзя изменять или удалять груз из сквозных торгов
  • 9 - У вашего контакта недостаточно прав для создания грузов
  • 10 - У вашего контакта недостаточно прав для работы с виртуальными кошельками
  • 11 - У вашего контакта недостаточно прав для работы с грузами на Общей площадке
  • 12 - У вашего контакта недостаточно прав для работы с грузами на Персональных площадках
  • 13 - У вашего контакта нет доступа для работы с одной или несколькими персональными площадками, указанными в грузе
  • 14 - У вашего контакта нет доступа для работы с подразделением, в которое восстанавливается груз
  • 15 - Ваш контакт должен быть указан первым в грузе
RenewRestriction: string

Причина отказа в доступе на обновление груза.

Id: guid

Идентификатор груза

LoadNumber: string

Номер груза

UpdatedAt: date-time

Дата последнего изменения груза в формате UTC

AddedAt: date-time

Время добавления груза в формате UTC

Distance: int32

Расстояние по дорогам в км

PlatonRoadsLength: int32

Протяженность дорог в км, в построенном пути за которые взимается плата по системе Платон

TollRoadsLength: int32

Протяженность платных дорог в построенном пути в км

TravelTime: time-span

Время в пути

Zimnik: boolean

Параметр, который определяет, включен ли зимник для перевозки груза

Ferries: boolean

Параметр, который определяет, учитывать ли паромные переправы для перевозки груза

FirmId: string

Идентификатор фирмы

AuctionId: guid (nullable)

Id аукциона

}
202 У Вас уже есть груз с такими же параметрами, поэтому два груза объединены в один
Развернуть все Свернуть все
Пример Модель
{...}
"Reason":"string",
"Error":"string"
}
{...}

Модель ошибки

Reason: string

Причина ошибки

Error: string

Ключ ошибки

}
4XX Ошибка запроса. Подробнее про ошибки API
Развернуть все Свернуть все
Пример Модель
{...}
"Reason":"string",
"Error":"string"
}
{...}

Модель ошибки

Reason: string

Причина ошибки

Error: string

Ключ ошибки

}
Загрузка...
Развернуть все Свернуть все
Загрузка...

Получение одного груза

 
get
/v2/cargos/{cargoApplicationId}
CURL 1C
CURL
Копировать

                
1C
Копировать

                
Пример ответа Ответ
200 Success
Развернуть все Свернуть все
Пример Модель
{...}
"cargo_id":"3fa85f64-5717-4562-b3fc-2c963f66afa6",
"cargo_number":"string",
"external_id":"string",
"added_at":"1970-01-01T00:00:00.000Z",
"updated_at":"1970-01-01T00:00:00.000Z",
"persistent_user_id":0,
"department_id":0,
"route":{...},
"loading":{...},
"city_id":0,
"address":"string",
"coordinates":{...},
"longitude":0.5,
"latitude":0.5
},
"organization":{...}
"organization_id":"3fa85f64-5717-4562-b3fc-2c963f66afa6",
"address_id":"3fa85f64-5717-4562-b3fc-2c963f66afa6"
}
},
"unloading":{...},
"city_id":0,
"address":"string",
"coordinates":{...},
"longitude":0.5,
"latitude":0.5
},
"organization":{...}
"organization_id":"3fa85f64-5717-4562-b3fc-2c963f66afa6",
"address_id":"3fa85f64-5717-4562-b3fc-2c963f66afa6"
}
},
"way_points":[...],
{...}
"type":"string",
"city_id":0,
"address":"string",
"coordinates":{...},
"longitude":0.5,
"latitude":0.5
},
"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
],
"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":{...},
"hide_counter_offers":false,
"direct_offer":false,
"prepayment":{...},
"percent":0,
"using_fuel":false
},
"payment_mode":{}
},
"documents":[...],
{...}
"id":"string",
"file_id":"string",
"name":"string",
"link":"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
}
],
"paid_features":{...},
"priority_view":{...},
"rate":0.5,
"limit":0.5,
"daily_limit":0.5,
"only_for_paid_users":false,
"money_spent_per_day":0.5,
"money_spent_per_order":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",
"contacts":[...],
0
],
"is_pass_through_copy":false,
"is_test":false,
"is_archived":false,
"archive_date":"1970-01-01T00:00:00.000Z",
"has_counter_offer":false,
"has_contract":false,
"distance":0,
"lot_id":"3fa85f64-5717-4562-b3fc-2c963f66afa6",
"lot_number":0,
"source":0
}
{...}
cargo_id: uuid

ID груза

cargo_number: string (nullable)

Номер груза, автоматически генерируемый ATI.SU

external_id: string (nullable)

Внешний номер груза или заказа

added_at: date-time

Время добавления груза

updated_at: date-time

Время изменения груза

persistent_user_id: int32

Идентификатор пользователя, разместившего заявку

department_id: int32

Подразделение, которому принадлежит заявка.

note: string (nullable)

Примечание к заявке

contacts: [int32]

Контакты

is_pass_through_copy: boolean
is_test: boolean
is_archived: boolean

Находится ли заявка в архиве

archive_date: date-time (nullable)
has_counter_offer: boolean
has_contract: boolean (nullable)
distance: int32

Дистанция, км

lot_id: uuid (nullable)
lot_number: int32 (nullable)
source: enum
[0, 1, 2, 3, 4, 5, 6, 7, 8]
}
Загрузка...
Развернуть все Свернуть все
Загрузка...
 
Получение одного груза с выбранным id
Данная версия метода устарела и её поддержка будет прекращена.
Пожалуйста, пользуйтесь актуальной версией API.
get
/v1.0/loads/{loadId}
CURL 1C
CURL
Копировать

                
1C
Копировать

                
Пример ответа Ответ
200 Груз
Развернуть все Свернуть все
Пример Модель
{...}
"LoadMeta":{...},
"LoadMetaId":"3fa85f64-5717-4562-b3fc-2c963f66afa6",
"MetaData":"string"
},
"ContactId1":0,
"ContactId2":0,
"Note":"string",
"FirstDate":"1970-01-01T00:00:00.000Z",
"LastDate":"1970-01-01T00:00:00.000Z",
"DateType":0,
"PeriodicityId":0,
"OrderNumber":"string",
"Krugoreis":false,
"Loading":{...},
"CityId":0,
"Latitude":0.5,
"Longitude":0.5,
"Street":"string",
"TimeStart":"1970-01-01T00:00:00.000Z",
"TimeEnd":"1970-01-01T00:00:00.000Z",
"IsRoundTheClock":false,
"LargeCities":[...],
0
],
"LoadingCargos":[...]
{...}
"CargoId":0,
"NameId":0,
"Name":"string",
"PackagingType":0,
"PackagingQuantity":0,
"Weight":0.5,
"Volume":0.5,
"Sizes":{...}
"Length":0.5,
"Width":0.5,
"Height":0.5,
"Diameter":0.5,
"LengthHighlight":false,
"WidthHighlight":false,
"HeightHighlight":false
}
}
]
},
"ExtraPoints":[...],
{...}
"CityId":0,
"PointType":0,
"Latitude":0.5,
"Longitude":0.5,
"Street":"string",
"OrdinalId":0,
"IsRoundTheClock":false,
"LoadingDateStart":"1970-01-01T00:00:00.000Z",
"LoadingDateEnd":"1970-01-01T00:00:00.000Z",
"LoadingTimeStart":null,
"LoadingTimeEnd":null,
"LoadingCargos":[...],
{...}
"CargoId":0,
"NameId":0,
"Name":"string",
"PackagingType":0,
"PackagingQuantity":0,
"Weight":0.5,
"Volume":0.5,
"Sizes":{...}
"Length":0.5,
"Width":0.5,
"Height":0.5,
"Diameter":0.5,
"LengthHighlight":false,
"WidthHighlight":false,
"HeightHighlight":false
}
}
],
"UnloadingCargos":[...]
{...}
"CargoId":0,
"Weight":0.5,
"Volume":0.5,
"PackagingQuantity":0,
"IsDefinedByTtn":false
}
]
}
],
"Unloading":{...},
"CityId":0,
"Latitude":0.5,
"Longitude":0.5,
"Street":"string",
"TimeStart":"1970-01-01T00:00:00.000Z",
"TimeEnd":"1970-01-01T00:00:00.000Z",
"IsRoundTheClock":false,
"LargeCities":[...],
0
],
"LoadingCargos":[...]
{...}
"CargoId":0,
"NameId":0,
"Name":"string",
"PackagingType":0,
"PackagingQuantity":0,
"Weight":0.5,
"Volume":0.5,
"Sizes":{...}
"Length":0.5,
"Width":0.5,
"Height":0.5,
"Diameter":0.5,
"LengthHighlight":false,
"WidthHighlight":false,
"HeightHighlight":false
}
}
]
},
"Cargo":{...},
"Weight":0.5,
"Volume":0.5,
"ADR":0,
"CargoTypeId":0,
"CargoType":"string",
"PackType":0,
"PalletCount":0,
"BeltCount":0,
"DogruzType":0,
"SborGruz":false,
"Size":{...}
"Length":0.5,
"Width":0.5,
"Height":0.5,
"Diameter":0.5,
"LengthHighlight":false,
"WidthHighlight":false,
"HeightHighlight":false
}
},
"Transport":{...},
"CarType":0,
"LoadingType":0,
"LoadingLogicalOperator":"string",
"UnloadingType":0,
"UnloadingLogicalOperator":"string",
"TrucksQuantity":0,
"TemperatureFrom":0,
"TemperatureTo":0,
"Stsepka":false,
"Pnevmohod":false,
"Koniki":false,
"TIR":false,
"CMR":false,
"T1":false,
"SanPassport":false,
"IsTracking":false
},
"Payment":{...},
"CurrencyId":0,
"MoneyType":0,
"RateSum":0.5,
"SumWithNDS":0.5,
"SumWithoutNDS":0.5,
"PrepayPercent":0,
"PrepayPercentEnabled":false,
"PayDays":0,
"PayDaysEnabled":false,
"FixedRate":false,
"Torg":false,
"DirectContract":false,
"InFuel":false,
"OnUnloading":false,
"HideResponses":false,
"AcceptPaymentTypes":0
},
"InviteSettings":{...},
"InviteDelayInSeconds":0,
"InviteDurationInSeconds":0
},
"PriorityView":{...},
"DailyLimit":0.5,
"IsForPayedOnly":false,
"OrderLimit":0.5,
"ViewRate":0.5,
"MoneySpentPerDay":0.5,
"MoneySpentPerOrder":0.5
},
"Stealth":{...},
"ListIdToHide":"3fa85f64-5717-4562-b3fc-2c963f66afa6",
"FirmRegDateToHide":"1970-01-01T00:00:00.000Z",
"ScoreToHide":0.5
},
"LoadFiles":[...],
{...}
"Id":"3fa85f64-5717-4562-b3fc-2c963f66afa6",
"FileType":0,
"Attributes":0,
"Name":"string",
"Link":"string",
"Size":0
}
],
"Deal":{...},
"Auction":{...}
"StartRate":0.5,
"Currency":0,
"Step":0.5,
"PaymentType":0,
"AcceptSecondPayType":false,
"StartDate":"1970-01-01T00:00:00.000Z",
"EndDate":"1970-01-01T00:00:00.000Z",
"EndDateBoundary":"1970-01-01T00:00:00.000Z",
"Nds":0.5,
"TimeToProvideDocuments":0.5,
"AutoRenew":false,
"RenewTime":0,
"MaxRenewTime":0,
"RaiseBid":false,
"MaxRate":0.5,
"RaiseBidInterval":0,
"ResponseInMinutes":0,
"Duration":0,
"StartSinceFirstBet":false,
"AuctionRestartParameters":{...},
"AuctionFinishAction":0,
"InitRestartCount":0,
"InitChangeWinnerCount":0,
"DurationAfterRestart":0
},
"AcceptCounterOffersOnlyBeforeFirstBet":false,
"WinnerCriterion":0,
"AuctionId":"3fa85f64-5717-4562-b3fc-2c963f66afa6",
"LoadId":"3fa85f64-5717-4562-b3fc-2c963f66afa6",
"ActiveDealId":"3fa85f64-5717-4562-b3fc-2c963f66afa6",
"State":0,
"Finished":false,
"WinDate":"1970-01-01T00:00:00.000Z",
"AuctionRates":[...]
{...}
"AuctionRateId":"3fa85f64-5717-4562-b3fc-2c963f66afa6",
"AddedAt":"1970-01-01T00:00:00.000Z",
"RateFirm":{...},
"Score":0.5,
"Status":0,
"Name":"string",
"ContactName":"string",
"AtiId":"string"
},
"Rate":0.5,
"State":0,
"LoadingDate":"1970-01-01T00:00:00.000Z",
"FirmId":0,
"ContactId":0
}
]
}
},
"Boards":[...],
{...}
"BoardId":"string",
"PublicationTime":"1970-01-01T00:00:00.000Z",
"IsReservationEnabled":false,
"PublicationOption":0,
"IsPublished":false,
"IsCommonBoard":false
}
],
"UnloadFirstDate":"1970-01-01T00:00:00.000Z",
"UnloadLastDate":"1970-01-01T00:00:00.000Z",
"ArchiveDate":"1970-01-01T00:00:00.000Z",
"ArchiveReason":"Unknown",
"TruePrice":0,
"TrueCurrencyId":0,
"ResponseCount":0,
"OfferCount":0,
"CanBeDeleted":false,
"HasPermissionsToLoad":false,
"CanBeEdited":false,
"CanBeRenewed":false,
"CanBeRestored":false,
"EditRestriction":0,
"DeleteRestriction":0,
"RestoreRestriction":0,
"RenewRestriction":"string",
"Id":"3fa85f64-5717-4562-b3fc-2c963f66afa6",
"LoadNumber":"string",
"UpdatedAt":"1970-01-01T00:00:00.000Z",
"AddedAt":"1970-01-01T00:00:00.000Z",
"Distance":0,
"PlatonRoadsLength":0,
"TollRoadsLength":0,
"TravelTime":"?",
"Zimnik":false,
"Ferries":false,
"FirmId":"string",
"AuctionId":"3fa85f64-5717-4562-b3fc-2c963f66afa6"
}
{...}
ContactId1*: int32

Идентификатор первого выбранного контакта.
Список всех контактов и их идентификаторы можно получить с помощью API для работы с фирмами
Контакт должен быть виден для остальных участников АТИ

ContactId2: int32 (nullable)

Идентификатор второго выбранного контакта, если не выбрано, то null
Контакт должен быть виден для остальных участников АТИ

Note: string

Примечание к грузу
Ограничение по длине: 1000 символов

FirstDate: date-time

Дата, начиная с которой груз актуален, в формате UTC
Минимальное значение равно текущей дате
При значении параметра DateType равным 0, допустимое значение поля - текущая дата
При значении параметра DateType равным 1, допустимое значение поля - от текущей даты до 60 дней вперед
При значении параметра DateType равным 2, допустимое значение поля - текущая дата
При значении параметра DateType равным 3, FirstDate должен принимать значение текущей даты или отсутствовать

LastDate: date-time

Дата, после которой груз не актуален, в формате UTC
Минимальное значение равно значению параметра FirstDate
При значении параметра DateType равным 0, допустимое значение поля - от текущей даты до 1 дня вперед
При значении параметра DateType равным 1, допустимое значение поля - от даты в параметре FirstDate до 9 дней вперед
При значении параметра DateType равным 2, данное поле вычисляется автоматически по формуле FirstDate + 2 месяца, передаваемое значение игнорируется
При значении параметра DateType равным 3, LastDate автоматически устанавливается на значение + 2 дня от текущей даты, передаваемое значение игнорируется

DateType: int32

Выбор типа готовности груза к перевозке

  • 0 - Готов к загрузке
  • 1 - с Х по У
  • 2 - постоянно
  • 3 - груза нет, запрос ставки
PeriodicityId: int32

Периодичность загрузки
Если параметр DateType не равен 2, PeriodicityId равен 0.
Иначе PeriodicityId может принимать следующие значения:

  • 1 - ежедневно
  • 100 - по рабочим дням
OrderNumber: string

Номер заказа
Ограничение по длине: 250 символов

Krugoreis: boolean

Параметр, который определяет, включен ли кругорейс для перевозки груза

UnloadFirstDate: date-time (nullable)

Дата начала разгрузки, в формате UTC.
Может иметь значение null.
Минимальное значение равно текущей дате.
При значении параметра DateType равным 3, UnloadFirstDate принимает значение null

UnloadLastDate: date-time (nullable)

Дата окончания разгрузки, в формате UTC. Может иметь значение null.
Если нет даты начала разгрузки UnloadFirstDate, должна отсутствовать дата окончания разгрузки UnloadLastDate.
При значении параметра DateType равным 3, UnloadFirstDate принимает значение null

ArchiveDate: date-time (nullable)

Дата и время переноса в архив

ArchiveReason: enum (nullable)
[Unknown, System, Manual, Complaints, UnwantedContent, DeleteCsvLoad, MergeLoadsAfterEdit, ContactDoesNotHaveAccessToVirtualPayments, VerticesLoadDelete, StealthStatisticError, CheckDuplicateComplaints, DeleteContact, DeleteFirm, CleanOldLoadsJob]

Причина переноса в архив

TruePrice: int32

Озвученная ставка

TrueCurrencyId: int32

ID валюты озвученной ставки

ResponseCount: int32

Количество отзывов о грузе (без встречных предложений)

OfferCount: int32

Количество встречных предложений (остальные отзывы не учитываются)

CanBeDeleted: boolean

Есть ли доступ на удаление груза.

HasPermissionsToLoad: boolean

Есть ли доступ на работу с грузом (без учета прав).

CanBeEdited: boolean

Есть ли доступ на редактирование груза.

CanBeRenewed: boolean

Есть ли доступ на обновление груза.

CanBeRestored: boolean

Есть ли доступ на восстановление груза

EditRestriction: enum
[0, 1, 2, 3, 4, 5, 6, 7, 8, 9, 10, 11, 12, 13, 14, 15]

Причины отказа в доступе на редактирование груза:

  • 0 - Вы имеете доступ к работе с грузом
  • 1 - Ваша фирма больше не может размещать грузы из-за нарушения правил АТИ
  • 2 - Груз зарезервирован/взят, операции с грузом запрещены
  • 3 - Превышен лимит актуальных грузов
  • 4 - Вы пытаетесь работать с грузами под общим пользователем. Недостаточно прав
  • 5 - У вашего контакта недостаточно прав для работы с данным грузом
  • 6 - Груз имеет завершенные Торги, операции с грузом запрещены
  • 7 - Сервис сделок временно недоступен
  • 8 - Нельзя изменять или удалять груз из сквозных торгов
  • 9 - У вашего контакта недостаточно прав для создания грузов
  • 10 - У вашего контакта недостаточно прав для работы с виртуальными кошельками
  • 11 - У вашего контакта недостаточно прав для работы с грузами на Общей площадке
  • 12 - У вашего контакта недостаточно прав для работы с грузами на Персональных площадках
  • 13 - У вашего контакта нет доступа для работы с одной или несколькими персональными площадками, указанными в грузе
  • 14 - У вашего контакта нет доступа для работы с подразделением, в которое восстанавливается груз
  • 15 - Ваш контакт должен быть указан первым в грузе
DeleteRestriction: enum
[0, 1, 2, 3, 4, 5, 6, 7, 8, 9, 10, 11, 12, 13, 14, 15]

Причины отказа в доступе на удаление контакта:

  • 0 - Вы имеете доступ к работе с грузом
  • 1 - Ваша фирма больше не может размещать грузы из-за нарушения правил АТИ
  • 2 - Груз зарезервирован/взят, операции с грузом запрещены
  • 3 - Превышен лимит актуальных грузов
  • 4 - Вы пытаетесь работать с грузами под общим пользователем. Недостаточно прав
  • 5 - У вашего контакта недостаточно прав для работы с данным грузом
  • 6 - Груз имеет завершенные Торги, операции с грузом запрещены
  • 7 - Сервис сделок временно недоступен
  • 8 - Нельзя изменять или удалять груз из сквозных торгов
  • 9 - У вашего контакта недостаточно прав для создания грузов
  • 10 - У вашего контакта недостаточно прав для работы с виртуальными кошельками
  • 11 - У вашего контакта недостаточно прав для работы с грузами на Общей площадке
  • 12 - У вашего контакта недостаточно прав для работы с грузами на Персональных площадках
  • 13 - У вашего контакта нет доступа для работы с одной или несколькими персональными площадками, указанными в грузе
  • 14 - У вашего контакта нет доступа для работы с подразделением, в которое восстанавливается груз
  • 15 - Ваш контакт должен быть указан первым в грузе
RestoreRestriction: enum
[0, 1, 2, 3, 4, 5, 6, 7, 8, 9, 10, 11, 12, 13, 14, 15]

Причины отказа в доступе на восстановление груза:

  • 0 - Вы имеете доступ к работе с грузом
  • 1 - Ваша фирма больше не может размещать грузы из-за нарушения правил АТИ
  • 2 - Груз зарезервирован/взят, операции с грузом запрещены
  • 3 - Превышен лимит актуальных грузов
  • 4 - Вы пытаетесь работать с грузами под общим пользователем. Недостаточно прав
  • 5 - У вашего контакта недостаточно прав для работы с данным грузом
  • 6 - Груз имеет завершенные Торги, операции с грузом запрещены
  • 7 - Сервис сделок временно недоступен
  • 8 - Нельзя изменять или удалять груз из сквозных торгов
  • 9 - У вашего контакта недостаточно прав для создания грузов
  • 10 - У вашего контакта недостаточно прав для работы с виртуальными кошельками
  • 11 - У вашего контакта недостаточно прав для работы с грузами на Общей площадке
  • 12 - У вашего контакта недостаточно прав для работы с грузами на Персональных площадках
  • 13 - У вашего контакта нет доступа для работы с одной или несколькими персональными площадками, указанными в грузе
  • 14 - У вашего контакта нет доступа для работы с подразделением, в которое восстанавливается груз
  • 15 - Ваш контакт должен быть указан первым в грузе
RenewRestriction: string

Причина отказа в доступе на обновление груза.

Id: guid

Идентификатор груза

LoadNumber: string

Номер груза

UpdatedAt: date-time

Дата последнего изменения груза в формате UTC

AddedAt: date-time

Время добавления груза в формате UTC

Distance: int32

Расстояние по дорогам в км

PlatonRoadsLength: int32

Протяженность дорог в км, в построенном пути за которые взимается плата по системе Платон

TollRoadsLength: int32

Протяженность платных дорог в построенном пути в км

TravelTime: time-span

Время в пути

Zimnik: boolean

Параметр, который определяет, включен ли зимник для перевозки груза

Ferries: boolean

Параметр, который определяет, учитывать ли паромные переправы для перевозки груза

FirmId: string

Идентификатор фирмы

AuctionId: guid (nullable)

Id аукциона

}
4XX Ошибка запроса. Подробнее про ошибки API
Развернуть все Свернуть все
Пример Модель
{...}
"Reason":"string",
"Error":"string"
}
{...}

Модель ошибки

Reason: string

Причина ошибки

Error: string

Ключ ошибки

}
Загрузка...
Развернуть все Свернуть все
Загрузка...

Получение всех своих грузов

Доступен фильтр по контакту. При передаче значения в contactId будут получены только те грузы, у которых ContactId1 == contactId либо ContactId2 == contactId.
Получать этим методом чужие грузы с общей площадки нельзя. Метод предназначен для работы со своими грузами.

 
Получение всех грузов фирмы
get
/v1.0/loads
CURL 1C
CURL
Копировать

                
1C
Копировать

                
Пример ответа Ответ
200 Грузы
Развернуть все Свернуть все
Пример Модель
[...]
{...}
"LoadMeta":{...},
"LoadMetaId":"3fa85f64-5717-4562-b3fc-2c963f66afa6",
"MetaData":"string"
},
"ContactId1":0,
"ContactId2":0,
"Note":"string",
"FirstDate":"1970-01-01T00:00:00.000Z",
"LastDate":"1970-01-01T00:00:00.000Z",
"DateType":0,
"PeriodicityId":0,
"OrderNumber":"string",
"Krugoreis":false,
"Loading":{...},
"CityId":0,
"Latitude":0.5,
"Longitude":0.5,
"Street":"string",
"TimeStart":"1970-01-01T00:00:00.000Z",
"TimeEnd":"1970-01-01T00:00:00.000Z",
"IsRoundTheClock":false,
"LargeCities":[...],
0
],
"LoadingCargos":[...]
{...}
"CargoId":0,
"NameId":0,
"Name":"string",
"PackagingType":0,
"PackagingQuantity":0,
"Weight":0.5,
"Volume":0.5,
"Sizes":{...}
"Length":0.5,
"Width":0.5,
"Height":0.5,
"Diameter":0.5,
"LengthHighlight":false,
"WidthHighlight":false,
"HeightHighlight":false
}
}
]
},
"ExtraPoints":[...],
{...}
"CityId":0,
"PointType":0,
"Latitude":0.5,
"Longitude":0.5,
"Street":"string",
"OrdinalId":0,
"IsRoundTheClock":false,
"LoadingDateStart":"1970-01-01T00:00:00.000Z",
"LoadingDateEnd":"1970-01-01T00:00:00.000Z",
"LoadingTimeStart":null,
"LoadingTimeEnd":null,
"LoadingCargos":[...],
{...}
"CargoId":0,
"NameId":0,
"Name":"string",
"PackagingType":0,
"PackagingQuantity":0,
"Weight":0.5,
"Volume":0.5,
"Sizes":{...}
"Length":0.5,
"Width":0.5,
"Height":0.5,
"Diameter":0.5,
"LengthHighlight":false,
"WidthHighlight":false,
"HeightHighlight":false
}
}
],
"UnloadingCargos":[...]
{...}
"CargoId":0,
"Weight":0.5,
"Volume":0.5,
"PackagingQuantity":0,
"IsDefinedByTtn":false
}
]
}
],
"Unloading":{...},
"CityId":0,
"Latitude":0.5,
"Longitude":0.5,
"Street":"string",
"TimeStart":"1970-01-01T00:00:00.000Z",
"TimeEnd":"1970-01-01T00:00:00.000Z",
"IsRoundTheClock":false,
"LargeCities":[...],
0
],
"LoadingCargos":[...]
{...}
"CargoId":0,
"NameId":0,
"Name":"string",
"PackagingType":0,
"PackagingQuantity":0,
"Weight":0.5,
"Volume":0.5,
"Sizes":{...}
"Length":0.5,
"Width":0.5,
"Height":0.5,
"Diameter":0.5,
"LengthHighlight":false,
"WidthHighlight":false,
"HeightHighlight":false
}
}
]
},
"Cargo":{...},
"Weight":0.5,
"Volume":0.5,
"ADR":0,
"CargoTypeId":0,
"CargoType":"string",
"PackType":0,
"PalletCount":0,
"BeltCount":0,
"DogruzType":0,
"SborGruz":false,
"Size":{...}
"Length":0.5,
"Width":0.5,
"Height":0.5,
"Diameter":0.5,
"LengthHighlight":false,
"WidthHighlight":false,
"HeightHighlight":false
}
},
"Transport":{...},
"CarType":0,
"LoadingType":0,
"LoadingLogicalOperator":"string",
"UnloadingType":0,
"UnloadingLogicalOperator":"string",
"TrucksQuantity":0,
"TemperatureFrom":0,
"TemperatureTo":0,
"Stsepka":false,
"Pnevmohod":false,
"Koniki":false,
"TIR":false,
"CMR":false,
"T1":false,
"SanPassport":false,
"IsTracking":false
},
"Payment":{...},
"CurrencyId":0,
"MoneyType":0,
"RateSum":0.5,
"SumWithNDS":0.5,
"SumWithoutNDS":0.5,
"PrepayPercent":0,
"PrepayPercentEnabled":false,
"PayDays":0,
"PayDaysEnabled":false,
"FixedRate":false,
"Torg":false,
"DirectContract":false,
"InFuel":false,
"OnUnloading":false,
"HideResponses":false,
"AcceptPaymentTypes":0
},
"InviteSettings":{...},
"InviteDelayInSeconds":0,
"InviteDurationInSeconds":0
},
"PriorityView":{...},
"DailyLimit":0.5,
"IsForPayedOnly":false,
"OrderLimit":0.5,
"ViewRate":0.5,
"MoneySpentPerDay":0.5,
"MoneySpentPerOrder":0.5
},
"Stealth":{...},
"ListIdToHide":"3fa85f64-5717-4562-b3fc-2c963f66afa6",
"FirmRegDateToHide":"1970-01-01T00:00:00.000Z",
"ScoreToHide":0.5
},
"LoadFiles":[...],
{...}
"Id":"3fa85f64-5717-4562-b3fc-2c963f66afa6",
"FileType":0,
"Attributes":0,
"Name":"string",
"Link":"string",
"Size":0
}
],
"Deal":{...},
"Auction":{...}
"StartRate":0.5,
"Currency":0,
"Step":0.5,
"PaymentType":0,
"AcceptSecondPayType":false,
"StartDate":"1970-01-01T00:00:00.000Z",
"EndDate":"1970-01-01T00:00:00.000Z",
"EndDateBoundary":"1970-01-01T00:00:00.000Z",
"Nds":0.5,
"TimeToProvideDocuments":0.5,
"AutoRenew":false,
"RenewTime":0,
"MaxRenewTime":0,
"RaiseBid":false,
"MaxRate":0.5,
"RaiseBidInterval":0,
"ResponseInMinutes":0,
"Duration":0,
"StartSinceFirstBet":false,
"AuctionRestartParameters":{...},
"AuctionFinishAction":0,
"InitRestartCount":0,
"InitChangeWinnerCount":0,
"DurationAfterRestart":0
},
"AcceptCounterOffersOnlyBeforeFirstBet":false,
"WinnerCriterion":0,
"AuctionId":"3fa85f64-5717-4562-b3fc-2c963f66afa6",
"LoadId":"3fa85f64-5717-4562-b3fc-2c963f66afa6",
"ActiveDealId":"3fa85f64-5717-4562-b3fc-2c963f66afa6",
"State":0,
"Finished":false,
"WinDate":"1970-01-01T00:00:00.000Z",
"AuctionRates":[...]
{...}
"AuctionRateId":"3fa85f64-5717-4562-b3fc-2c963f66afa6",
"AddedAt":"1970-01-01T00:00:00.000Z",
"RateFirm":{...},
"Score":0.5,
"Status":0,
"Name":"string",
"ContactName":"string",
"AtiId":"string"
},
"Rate":0.5,
"State":0,
"LoadingDate":"1970-01-01T00:00:00.000Z",
"FirmId":0,
"ContactId":0
}
]
}
},
"Boards":[...],
{...}
"BoardId":"string",
"PublicationTime":"1970-01-01T00:00:00.000Z",
"IsReservationEnabled":false,
"PublicationOption":0,
"IsPublished":false,
"IsCommonBoard":false
}
],
"UnloadFirstDate":"1970-01-01T00:00:00.000Z",
"UnloadLastDate":"1970-01-01T00:00:00.000Z",
"ArchiveDate":"1970-01-01T00:00:00.000Z",
"ArchiveReason":"Unknown",
"TruePrice":0,
"TrueCurrencyId":0,
"ResponseCount":0,
"OfferCount":0,
"CanBeDeleted":false,
"HasPermissionsToLoad":false,
"CanBeEdited":false,
"CanBeRenewed":false,
"CanBeRestored":false,
"EditRestriction":0,
"DeleteRestriction":0,
"RestoreRestriction":0,
"RenewRestriction":"string",
"Id":"3fa85f64-5717-4562-b3fc-2c963f66afa6",
"LoadNumber":"string",
"UpdatedAt":"1970-01-01T00:00:00.000Z",
"AddedAt":"1970-01-01T00:00:00.000Z",
"Distance":0,
"PlatonRoadsLength":0,
"TollRoadsLength":0,
"TravelTime":"?",
"Zimnik":false,
"Ferries":false,
"FirmId":"string",
"AuctionId":"3fa85f64-5717-4562-b3fc-2c963f66afa6"
}
]
[{...}]
ContactId1*: int32

Идентификатор первого выбранного контакта.
Список всех контактов и их идентификаторы можно получить с помощью API для работы с фирмами
Контакт должен быть виден для остальных участников АТИ

ContactId2: int32 (nullable)

Идентификатор второго выбранного контакта, если не выбрано, то null
Контакт должен быть виден для остальных участников АТИ

Note: string

Примечание к грузу
Ограничение по длине: 1000 символов

FirstDate: date-time

Дата, начиная с которой груз актуален, в формате UTC
Минимальное значение равно текущей дате
При значении параметра DateType равным 0, допустимое значение поля - текущая дата
При значении параметра DateType равным 1, допустимое значение поля - от текущей даты до 60 дней вперед
При значении параметра DateType равным 2, допустимое значение поля - текущая дата
При значении параметра DateType равным 3, FirstDate должен принимать значение текущей даты или отсутствовать

LastDate: date-time

Дата, после которой груз не актуален, в формате UTC
Минимальное значение равно значению параметра FirstDate
При значении параметра DateType равным 0, допустимое значение поля - от текущей даты до 1 дня вперед
При значении параметра DateType равным 1, допустимое значение поля - от даты в параметре FirstDate до 9 дней вперед
При значении параметра DateType равным 2, данное поле вычисляется автоматически по формуле FirstDate + 2 месяца, передаваемое значение игнорируется
При значении параметра DateType равным 3, LastDate автоматически устанавливается на значение + 2 дня от текущей даты, передаваемое значение игнорируется

DateType: int32

Выбор типа готовности груза к перевозке

  • 0 - Готов к загрузке
  • 1 - с Х по У
  • 2 - постоянно
  • 3 - груза нет, запрос ставки
PeriodicityId: int32

Периодичность загрузки
Если параметр DateType не равен 2, PeriodicityId равен 0.
Иначе PeriodicityId может принимать следующие значения:

  • 1 - ежедневно
  • 100 - по рабочим дням
OrderNumber: string

Номер заказа
Ограничение по длине: 250 символов

Krugoreis: boolean

Параметр, который определяет, включен ли кругорейс для перевозки груза

UnloadFirstDate: date-time (nullable)

Дата начала разгрузки, в формате UTC.
Может иметь значение null.
Минимальное значение равно текущей дате.
При значении параметра DateType равным 3, UnloadFirstDate принимает значение null

UnloadLastDate: date-time (nullable)

Дата окончания разгрузки, в формате UTC. Может иметь значение null.
Если нет даты начала разгрузки UnloadFirstDate, должна отсутствовать дата окончания разгрузки UnloadLastDate.
При значении параметра DateType равным 3, UnloadFirstDate принимает значение null

ArchiveDate: date-time (nullable)

Дата и время переноса в архив

ArchiveReason: enum (nullable)
[Unknown, System, Manual, Complaints, UnwantedContent, DeleteCsvLoad, MergeLoadsAfterEdit, ContactDoesNotHaveAccessToVirtualPayments, VerticesLoadDelete, StealthStatisticError, CheckDuplicateComplaints, DeleteContact, DeleteFirm, CleanOldLoadsJob]

Причина переноса в архив

TruePrice: int32

Озвученная ставка

TrueCurrencyId: int32

ID валюты озвученной ставки

ResponseCount: int32

Количество отзывов о грузе (без встречных предложений)

OfferCount: int32

Количество встречных предложений (остальные отзывы не учитываются)

CanBeDeleted: boolean

Есть ли доступ на удаление груза.

HasPermissionsToLoad: boolean

Есть ли доступ на работу с грузом (без учета прав).

CanBeEdited: boolean

Есть ли доступ на редактирование груза.

CanBeRenewed: boolean

Есть ли доступ на обновление груза.

CanBeRestored: boolean

Есть ли доступ на восстановление груза

EditRestriction: enum
[0, 1, 2, 3, 4, 5, 6, 7, 8, 9, 10, 11, 12, 13, 14, 15]

Причины отказа в доступе на редактирование груза:

  • 0 - Вы имеете доступ к работе с грузом
  • 1 - Ваша фирма больше не может размещать грузы из-за нарушения правил АТИ
  • 2 - Груз зарезервирован/взят, операции с грузом запрещены
  • 3 - Превышен лимит актуальных грузов
  • 4 - Вы пытаетесь работать с грузами под общим пользователем. Недостаточно прав
  • 5 - У вашего контакта недостаточно прав для работы с данным грузом
  • 6 - Груз имеет завершенные Торги, операции с грузом запрещены
  • 7 - Сервис сделок временно недоступен
  • 8 - Нельзя изменять или удалять груз из сквозных торгов
  • 9 - У вашего контакта недостаточно прав для создания грузов
  • 10 - У вашего контакта недостаточно прав для работы с виртуальными кошельками
  • 11 - У вашего контакта недостаточно прав для работы с грузами на Общей площадке
  • 12 - У вашего контакта недостаточно прав для работы с грузами на Персональных площадках
  • 13 - У вашего контакта нет доступа для работы с одной или несколькими персональными площадками, указанными в грузе
  • 14 - У вашего контакта нет доступа для работы с подразделением, в которое восстанавливается груз
  • 15 - Ваш контакт должен быть указан первым в грузе
DeleteRestriction: enum
[0, 1, 2, 3, 4, 5, 6, 7, 8, 9, 10, 11, 12, 13, 14, 15]

Причины отказа в доступе на удаление контакта:

  • 0 - Вы имеете доступ к работе с грузом
  • 1 - Ваша фирма больше не может размещать грузы из-за нарушения правил АТИ
  • 2 - Груз зарезервирован/взят, операции с грузом запрещены
  • 3 - Превышен лимит актуальных грузов
  • 4 - Вы пытаетесь работать с грузами под общим пользователем. Недостаточно прав
  • 5 - У вашего контакта недостаточно прав для работы с данным грузом
  • 6 - Груз имеет завершенные Торги, операции с грузом запрещены
  • 7 - Сервис сделок временно недоступен
  • 8 - Нельзя изменять или удалять груз из сквозных торгов
  • 9 - У вашего контакта недостаточно прав для создания грузов
  • 10 - У вашего контакта недостаточно прав для работы с виртуальными кошельками
  • 11 - У вашего контакта недостаточно прав для работы с грузами на Общей площадке
  • 12 - У вашего контакта недостаточно прав для работы с грузами на Персональных площадках
  • 13 - У вашего контакта нет доступа для работы с одной или несколькими персональными площадками, указанными в грузе
  • 14 - У вашего контакта нет доступа для работы с подразделением, в которое восстанавливается груз
  • 15 - Ваш контакт должен быть указан первым в грузе
RestoreRestriction: enum
[0, 1, 2, 3, 4, 5, 6, 7, 8, 9, 10, 11, 12, 13, 14, 15]

Причины отказа в доступе на восстановление груза:

  • 0 - Вы имеете доступ к работе с грузом
  • 1 - Ваша фирма больше не может размещать грузы из-за нарушения правил АТИ
  • 2 - Груз зарезервирован/взят, операции с грузом запрещены
  • 3 - Превышен лимит актуальных грузов
  • 4 - Вы пытаетесь работать с грузами под общим пользователем. Недостаточно прав
  • 5 - У вашего контакта недостаточно прав для работы с данным грузом
  • 6 - Груз имеет завершенные Торги, операции с грузом запрещены
  • 7 - Сервис сделок временно недоступен
  • 8 - Нельзя изменять или удалять груз из сквозных торгов
  • 9 - У вашего контакта недостаточно прав для создания грузов
  • 10 - У вашего контакта недостаточно прав для работы с виртуальными кошельками
  • 11 - У вашего контакта недостаточно прав для работы с грузами на Общей площадке
  • 12 - У вашего контакта недостаточно прав для работы с грузами на Персональных площадках
  • 13 - У вашего контакта нет доступа для работы с одной или несколькими персональными площадками, указанными в грузе
  • 14 - У вашего контакта нет доступа для работы с подразделением, в которое восстанавливается груз
  • 15 - Ваш контакт должен быть указан первым в грузе
RenewRestriction: string

Причина отказа в доступе на обновление груза.

Id: guid

Идентификатор груза

LoadNumber: string

Номер груза

UpdatedAt: date-time

Дата последнего изменения груза в формате UTC

AddedAt: date-time

Время добавления груза в формате UTC

Distance: int32

Расстояние по дорогам в км

PlatonRoadsLength: int32

Протяженность дорог в км, в построенном пути за которые взимается плата по системе Платон

TollRoadsLength: int32

Протяженность платных дорог в построенном пути в км

TravelTime: time-span

Время в пути

Zimnik: boolean

Параметр, который определяет, включен ли зимник для перевозки груза

Ferries: boolean

Параметр, который определяет, учитывать ли паромные переправы для перевозки груза

FirmId: string

Идентификатор фирмы

AuctionId: guid (nullable)

Id аукциона

}]
4XX Ошибка запроса. Подробнее про ошибки API
Развернуть все Свернуть все
Пример Модель
{...}
"Reason":"string",
"Error":"string"
}
{...}

Модель ошибки

Reason: string

Причина ошибки

Error: string

Ключ ошибки

}
Загрузка...
Развернуть все Свернуть все
Загрузка...

Обновление одного груза

 
Позволяет обновить груз с указанным id. Обновление грузов нужно, чтобы ваш груз показывался в списке грузов на более высокой позиции.
put
/v1.0/loads/{loadId}/renew
CURL 1C
CURL
Копировать

                
1C
Копировать

                
Пример ответа Ответ
200 Статус
Развернуть все Свернуть все
Пример Модель
{...}
"any-key":{...}
"Status":0,
"Message":"string"
}
}
{...}
}
4XX Ошибка запроса. Подробнее про ошибки API
Развернуть все Свернуть все
Пример Модель
{...}
"Reason":"string",
"Error":"string"
}
{...}

Модель ошибки

Reason: string

Причина ошибки

Error: string

Ключ ошибки

}
Загрузка...
Развернуть все Свернуть все
Загрузка...

Обновление нескольких грузов

 
Позволяет обновить грузы с указанными id. Обновление грузов нужно, чтобы ваш груз показывался в списке грузов на более высокой позиции.
put
/v1.0/loads/renew
ids
array
Добавить еще поле
CURL 1C
CURL
Копировать

                
1C
Копировать

                
Пример ответа Ответ
200 Статус
Развернуть все Свернуть все
Пример Модель
{...}
"any-key":{...}
"Status":0,
"Message":"string"
}
}
{...}
}
4XX Ошибка запроса. Подробнее про ошибки API
Развернуть все Свернуть все
Пример Модель
{...}
"Reason":"string",
"Error":"string"
}
{...}

Модель ошибки

Reason: string

Причина ошибки

Error: string

Ключ ошибки

}
Загрузка...
Развернуть все Свернуть все
Загрузка...

Удаление одного груза

 
Позволяет удалить груз с указанным id.
delete
/v1.0/loads/{loadId}
CURL 1C
CURL
Копировать

                
1C
Копировать

                
Пример ответа Ответ
200 Статус
Развернуть все Свернуть все
Пример Модель
{...}
"any-key":{...}
"Status":0,
"Message":"string"
}
}
{...}
}
4XX Ошибка запроса. Подробнее про ошибки API
Развернуть все Свернуть все
Пример Модель
{...}
"Reason":"string",
"Error":"string"
}
{...}

Модель ошибки

Reason: string

Причина ошибки

Error: string

Ключ ошибки

}
Загрузка...
Развернуть все Свернуть все
Загрузка...

Удаление нескольких грузов

 
Позволяет удалить грузы с указанными id.
delete
/v1.0/loads
ids
array
Добавить еще поле
ID грузов
CURL 1C
CURL
Копировать

                
1C
Копировать

                
Пример ответа Ответ
200 Статус
Развернуть все Свернуть все
Пример Модель
{...}
"any-key":{...}
"Status":0,
"Message":"string"
}
}
{...}
}
4XX Ошибка запроса. Подробнее про ошибки API
Развернуть все Свернуть все
Пример Модель
{...}
"Reason":"string",
"Error":"string"
}
{...}

Модель ошибки

Reason: string

Причина ошибки

Error: string

Ключ ошибки

}
Загрузка...
Развернуть все Свернуть все
Загрузка...

Изменение приоритетного показа

 
Изменение параметров приоритетного показа у груза.
put
/v1.0/loads/{loadId}/priority
Развернуть все Свернуть все
{...}
DailyLimit: decimal

Суточный лимит списания по услуге

  • Должен иметь длину не более 5 символов
  • Не более 2 символов после запятой
  • Должен быть больше либо равен значению ViewRate или быть равным нулю (если ограничения нет)
  • Должен быть равен 0 или отсутствовать, если параметр ViewRate отсутствует или равен 0
IsForPayedOnly: boolean

Показывать приоритетный показ только платным пользователям

OrderLimit: decimal

Лимит на заявку

  • Должен иметь длину не более 5 символов
  • Не более 2 символов после запятой
  • Должен быть больше либо равен значению ViewRate или быть равным нулю (если ограничения нет)
  • Должен быть равен 0 или отсутствовать, если параметр ViewRate отсутствует или равен 0
ViewRate: decimal

Ставка за просмотр

  • Минимальное значение 0,6
  • Не более 2 символов после запятой
  • Должен иметь длину не более 5 символов
MoneySpentPerDay: decimal

Количество денег, потраченное на заявку за день. Только для чтения

MoneySpentPerOrder: decimal

Количество денег, потраченное на заявку в целом. Только для чтения

}
CURL 1C
CURL
Копировать

                
1C
Копировать

                
Пример ответа Ответ
200 Актуальное состояние груза
Развернуть все Свернуть все
Пример Модель
{...}
"LoadMeta":{...},
"LoadMetaId":"3fa85f64-5717-4562-b3fc-2c963f66afa6",
"MetaData":"string"
},
"ContactId1":0,
"ContactId2":0,
"Note":"string",
"FirstDate":"1970-01-01T00:00:00.000Z",
"LastDate":"1970-01-01T00:00:00.000Z",
"DateType":0,
"PeriodicityId":0,
"OrderNumber":"string",
"Krugoreis":false,
"Loading":{...},
"CityId":0,
"Latitude":0.5,
"Longitude":0.5,
"Street":"string",
"TimeStart":"1970-01-01T00:00:00.000Z",
"TimeEnd":"1970-01-01T00:00:00.000Z",
"IsRoundTheClock":false,
"LargeCities":[...],
0
],
"LoadingCargos":[...]
{...}
"CargoId":0,
"NameId":0,
"Name":"string",
"PackagingType":0,
"PackagingQuantity":0,
"Weight":0.5,
"Volume":0.5,
"Sizes":{...}
"Length":0.5,
"Width":0.5,
"Height":0.5,
"Diameter":0.5,
"LengthHighlight":false,
"WidthHighlight":false,
"HeightHighlight":false
}
}
]
},
"ExtraPoints":[...],
{...}
"CityId":0,
"PointType":0,
"Latitude":0.5,
"Longitude":0.5,
"Street":"string",
"OrdinalId":0,
"IsRoundTheClock":false,
"LoadingDateStart":"1970-01-01T00:00:00.000Z",
"LoadingDateEnd":"1970-01-01T00:00:00.000Z",
"LoadingTimeStart":null,
"LoadingTimeEnd":null,
"LoadingCargos":[...],
{...}
"CargoId":0,
"NameId":0,
"Name":"string",
"PackagingType":0,
"PackagingQuantity":0,
"Weight":0.5,
"Volume":0.5,
"Sizes":{...}
"Length":0.5,
"Width":0.5,
"Height":0.5,
"Diameter":0.5,
"LengthHighlight":false,
"WidthHighlight":false,
"HeightHighlight":false
}
}
],
"UnloadingCargos":[...]
{...}
"CargoId":0,
"Weight":0.5,
"Volume":0.5,
"PackagingQuantity":0,
"IsDefinedByTtn":false
}
]
}
],
"Unloading":{...},
"CityId":0,
"Latitude":0.5,
"Longitude":0.5,
"Street":"string",
"TimeStart":"1970-01-01T00:00:00.000Z",
"TimeEnd":"1970-01-01T00:00:00.000Z",
"IsRoundTheClock":false,
"LargeCities":[...],
0
],
"LoadingCargos":[...]
{...}
"CargoId":0,
"NameId":0,
"Name":"string",
"PackagingType":0,
"PackagingQuantity":0,
"Weight":0.5,
"Volume":0.5,
"Sizes":{...}
"Length":0.5,
"Width":0.5,
"Height":0.5,
"Diameter":0.5,
"LengthHighlight":false,
"WidthHighlight":false,
"HeightHighlight":false
}
}
]
},
"Cargo":{...},
"Weight":0.5,
"Volume":0.5,
"ADR":0,
"CargoTypeId":0,
"CargoType":"string",
"PackType":0,
"PalletCount":0,
"BeltCount":0,
"DogruzType":0,
"SborGruz":false,
"Size":{...}
"Length":0.5,
"Width":0.5,
"Height":0.5,
"Diameter":0.5,
"LengthHighlight":false,
"WidthHighlight":false,
"HeightHighlight":false
}
},
"Transport":{...},
"CarType":0,
"LoadingType":0,
"LoadingLogicalOperator":"string",
"UnloadingType":0,
"UnloadingLogicalOperator":"string",
"TrucksQuantity":0,
"TemperatureFrom":0,
"TemperatureTo":0,
"Stsepka":false,
"Pnevmohod":false,
"Koniki":false,
"TIR":false,
"CMR":false,
"T1":false,
"SanPassport":false,
"IsTracking":false
},
"Payment":{...},
"CurrencyId":0,
"MoneyType":0,
"RateSum":0.5,
"SumWithNDS":0.5,
"SumWithoutNDS":0.5,
"PrepayPercent":0,
"PrepayPercentEnabled":false,
"PayDays":0,
"PayDaysEnabled":false,
"FixedRate":false,
"Torg":false,
"DirectContract":false,
"InFuel":false,
"OnUnloading":false,
"HideResponses":false,
"AcceptPaymentTypes":0
},
"InviteSettings":{...},
"InviteDelayInSeconds":0,
"InviteDurationInSeconds":0
},
"PriorityView":{...},
"DailyLimit":0.5,
"IsForPayedOnly":false,
"OrderLimit":0.5,
"ViewRate":0.5,
"MoneySpentPerDay":0.5,
"MoneySpentPerOrder":0.5
},
"Stealth":{...},
"ListIdToHide":"3fa85f64-5717-4562-b3fc-2c963f66afa6",
"FirmRegDateToHide":"1970-01-01T00:00:00.000Z",
"ScoreToHide":0.5
},
"LoadFiles":[...],
{...}
"Id":"3fa85f64-5717-4562-b3fc-2c963f66afa6",
"FileType":0,
"Attributes":0,
"Name":"string",
"Link":"string",
"Size":0
}
],
"Deal":{...},
"Auction":{...}
"StartRate":0.5,
"Currency":0,
"Step":0.5,
"PaymentType":0,
"AcceptSecondPayType":false,
"StartDate":"1970-01-01T00:00:00.000Z",
"EndDate":"1970-01-01T00:00:00.000Z",
"EndDateBoundary":"1970-01-01T00:00:00.000Z",
"Nds":0.5,
"TimeToProvideDocuments":0.5,
"AutoRenew":false,
"RenewTime":0,
"MaxRenewTime":0,
"RaiseBid":false,
"MaxRate":0.5,
"RaiseBidInterval":0,
"ResponseInMinutes":0,
"Duration":0,
"StartSinceFirstBet":false,
"AuctionRestartParameters":{...},
"AuctionFinishAction":0,
"InitRestartCount":0,
"InitChangeWinnerCount":0,
"DurationAfterRestart":0
},
"AcceptCounterOffersOnlyBeforeFirstBet":false,
"WinnerCriterion":0,
"AuctionId":"3fa85f64-5717-4562-b3fc-2c963f66afa6",
"LoadId":"3fa85f64-5717-4562-b3fc-2c963f66afa6",
"ActiveDealId":"3fa85f64-5717-4562-b3fc-2c963f66afa6",
"State":0,
"Finished":false,
"WinDate":"1970-01-01T00:00:00.000Z",
"AuctionRates":[...]
{...}
"AuctionRateId":"3fa85f64-5717-4562-b3fc-2c963f66afa6",
"AddedAt":"1970-01-01T00:00:00.000Z",
"RateFirm":{...},
"Score":0.5,
"Status":0,
"Name":"string",
"ContactName":"string",
"AtiId":"string"
},
"Rate":0.5,
"State":0,
"LoadingDate":"1970-01-01T00:00:00.000Z",
"FirmId":0,
"ContactId":0
}
]
}
},
"Boards":[...],
{...}
"BoardId":"string",
"PublicationTime":"1970-01-01T00:00:00.000Z",
"IsReservationEnabled":false,
"PublicationOption":0,
"IsPublished":false,
"IsCommonBoard":false
}
],
"UnloadFirstDate":"1970-01-01T00:00:00.000Z",
"UnloadLastDate":"1970-01-01T00:00:00.000Z",
"ArchiveDate":"1970-01-01T00:00:00.000Z",
"ArchiveReason":"Unknown",
"TruePrice":0,
"TrueCurrencyId":0,
"ResponseCount":0,
"OfferCount":0,
"CanBeDeleted":false,
"HasPermissionsToLoad":false,
"CanBeEdited":false,
"CanBeRenewed":false,
"CanBeRestored":false,
"EditRestriction":0,
"DeleteRestriction":0,
"RestoreRestriction":0,
"RenewRestriction":"string",
"Id":"3fa85f64-5717-4562-b3fc-2c963f66afa6",
"LoadNumber":"string",
"UpdatedAt":"1970-01-01T00:00:00.000Z",
"AddedAt":"1970-01-01T00:00:00.000Z",
"Distance":0,
"PlatonRoadsLength":0,
"TollRoadsLength":0,
"TravelTime":"?",
"Zimnik":false,
"Ferries":false,
"FirmId":"string",
"AuctionId":"3fa85f64-5717-4562-b3fc-2c963f66afa6"
}
{...}
ContactId1*: int32

Идентификатор первого выбранного контакта.
Список всех контактов и их идентификаторы можно получить с помощью API для работы с фирмами
Контакт должен быть виден для остальных участников АТИ

ContactId2: int32 (nullable)

Идентификатор второго выбранного контакта, если не выбрано, то null
Контакт должен быть виден для остальных участников АТИ

Note: string

Примечание к грузу
Ограничение по длине: 1000 символов

FirstDate: date-time

Дата, начиная с которой груз актуален, в формате UTC
Минимальное значение равно текущей дате
При значении параметра DateType равным 0, допустимое значение поля - текущая дата
При значении параметра DateType равным 1, допустимое значение поля - от текущей даты до 60 дней вперед
При значении параметра DateType равным 2, допустимое значение поля - текущая дата
При значении параметра DateType равным 3, FirstDate должен принимать значение текущей даты или отсутствовать

LastDate: date-time

Дата, после которой груз не актуален, в формате UTC
Минимальное значение равно значению параметра FirstDate
При значении параметра DateType равным 0, допустимое значение поля - от текущей даты до 1 дня вперед
При значении параметра DateType равным 1, допустимое значение поля - от даты в параметре FirstDate до 9 дней вперед
При значении параметра DateType равным 2, данное поле вычисляется автоматически по формуле FirstDate + 2 месяца, передаваемое значение игнорируется
При значении параметра DateType равным 3, LastDate автоматически устанавливается на значение + 2 дня от текущей даты, передаваемое значение игнорируется

DateType: int32

Выбор типа готовности груза к перевозке

  • 0 - Готов к загрузке
  • 1 - с Х по У
  • 2 - постоянно
  • 3 - груза нет, запрос ставки
PeriodicityId: int32

Периодичность загрузки
Если параметр DateType не равен 2, PeriodicityId равен 0.
Иначе PeriodicityId может принимать следующие значения:

  • 1 - ежедневно
  • 100 - по рабочим дням
OrderNumber: string

Номер заказа
Ограничение по длине: 250 символов

Krugoreis: boolean

Параметр, который определяет, включен ли кругорейс для перевозки груза

UnloadFirstDate: date-time (nullable)

Дата начала разгрузки, в формате UTC.
Может иметь значение null.
Минимальное значение равно текущей дате.
При значении параметра DateType равным 3, UnloadFirstDate принимает значение null

UnloadLastDate: date-time (nullable)

Дата окончания разгрузки, в формате UTC. Может иметь значение null.
Если нет даты начала разгрузки UnloadFirstDate, должна отсутствовать дата окончания разгрузки UnloadLastDate.
При значении параметра DateType равным 3, UnloadFirstDate принимает значение null

ArchiveDate: date-time (nullable)

Дата и время переноса в архив

ArchiveReason: enum (nullable)
[Unknown, System, Manual, Complaints, UnwantedContent, DeleteCsvLoad, MergeLoadsAfterEdit, ContactDoesNotHaveAccessToVirtualPayments, VerticesLoadDelete, StealthStatisticError, CheckDuplicateComplaints, DeleteContact, DeleteFirm, CleanOldLoadsJob]

Причина переноса в архив

TruePrice: int32

Озвученная ставка

TrueCurrencyId: int32

ID валюты озвученной ставки

ResponseCount: int32

Количество отзывов о грузе (без встречных предложений)

OfferCount: int32

Количество встречных предложений (остальные отзывы не учитываются)

CanBeDeleted: boolean

Есть ли доступ на удаление груза.

HasPermissionsToLoad: boolean

Есть ли доступ на работу с грузом (без учета прав).

CanBeEdited: boolean

Есть ли доступ на редактирование груза.

CanBeRenewed: boolean

Есть ли доступ на обновление груза.

CanBeRestored: boolean

Есть ли доступ на восстановление груза

EditRestriction: enum
[0, 1, 2, 3, 4, 5, 6, 7, 8, 9, 10, 11, 12, 13, 14, 15]

Причины отказа в доступе на редактирование груза:

  • 0 - Вы имеете доступ к работе с грузом
  • 1 - Ваша фирма больше не может размещать грузы из-за нарушения правил АТИ
  • 2 - Груз зарезервирован/взят, операции с грузом запрещены
  • 3 - Превышен лимит актуальных грузов
  • 4 - Вы пытаетесь работать с грузами под общим пользователем. Недостаточно прав
  • 5 - У вашего контакта недостаточно прав для работы с данным грузом
  • 6 - Груз имеет завершенные Торги, операции с грузом запрещены
  • 7 - Сервис сделок временно недоступен
  • 8 - Нельзя изменять или удалять груз из сквозных торгов
  • 9 - У вашего контакта недостаточно прав для создания грузов
  • 10 - У вашего контакта недостаточно прав для работы с виртуальными кошельками
  • 11 - У вашего контакта недостаточно прав для работы с грузами на Общей площадке
  • 12 - У вашего контакта недостаточно прав для работы с грузами на Персональных площадках
  • 13 - У вашего контакта нет доступа для работы с одной или несколькими персональными площадками, указанными в грузе
  • 14 - У вашего контакта нет доступа для работы с подразделением, в которое восстанавливается груз
  • 15 - Ваш контакт должен быть указан первым в грузе
DeleteRestriction: enum
[0, 1, 2, 3, 4, 5, 6, 7, 8, 9, 10, 11, 12, 13, 14, 15]

Причины отказа в доступе на удаление контакта:

  • 0 - Вы имеете доступ к работе с грузом
  • 1 - Ваша фирма больше не может размещать грузы из-за нарушения правил АТИ
  • 2 - Груз зарезервирован/взят, операции с грузом запрещены
  • 3 - Превышен лимит актуальных грузов
  • 4 - Вы пытаетесь работать с грузами под общим пользователем. Недостаточно прав
  • 5 - У вашего контакта недостаточно прав для работы с данным грузом
  • 6 - Груз имеет завершенные Торги, операции с грузом запрещены
  • 7 - Сервис сделок временно недоступен
  • 8 - Нельзя изменять или удалять груз из сквозных торгов
  • 9 - У вашего контакта недостаточно прав для создания грузов
  • 10 - У вашего контакта недостаточно прав для работы с виртуальными кошельками
  • 11 - У вашего контакта недостаточно прав для работы с грузами на Общей площадке
  • 12 - У вашего контакта недостаточно прав для работы с грузами на Персональных площадках
  • 13 - У вашего контакта нет доступа для работы с одной или несколькими персональными площадками, указанными в грузе
  • 14 - У вашего контакта нет доступа для работы с подразделением, в которое восстанавливается груз
  • 15 - Ваш контакт должен быть указан первым в грузе
RestoreRestriction: enum
[0, 1, 2, 3, 4, 5, 6, 7, 8, 9, 10, 11, 12, 13, 14, 15]

Причины отказа в доступе на восстановление груза:

  • 0 - Вы имеете доступ к работе с грузом
  • 1 - Ваша фирма больше не может размещать грузы из-за нарушения правил АТИ
  • 2 - Груз зарезервирован/взят, операции с грузом запрещены
  • 3 - Превышен лимит актуальных грузов
  • 4 - Вы пытаетесь работать с грузами под общим пользователем. Недостаточно прав
  • 5 - У вашего контакта недостаточно прав для работы с данным грузом
  • 6 - Груз имеет завершенные Торги, операции с грузом запрещены
  • 7 - Сервис сделок временно недоступен
  • 8 - Нельзя изменять или удалять груз из сквозных торгов
  • 9 - У вашего контакта недостаточно прав для создания грузов
  • 10 - У вашего контакта недостаточно прав для работы с виртуальными кошельками
  • 11 - У вашего контакта недостаточно прав для работы с грузами на Общей площадке
  • 12 - У вашего контакта недостаточно прав для работы с грузами на Персональных площадках
  • 13 - У вашего контакта нет доступа для работы с одной или несколькими персональными площадками, указанными в грузе
  • 14 - У вашего контакта нет доступа для работы с подразделением, в которое восстанавливается груз
  • 15 - Ваш контакт должен быть указан первым в грузе
RenewRestriction: string

Причина отказа в доступе на обновление груза.

Id: guid

Идентификатор груза

LoadNumber: string

Номер груза

UpdatedAt: date-time

Дата последнего изменения груза в формате UTC

AddedAt: date-time

Время добавления груза в формате UTC

Distance: int32

Расстояние по дорогам в км

PlatonRoadsLength: int32

Протяженность дорог в км, в построенном пути за которые взимается плата по системе Платон

TollRoadsLength: int32

Протяженность платных дорог в построенном пути в км

TravelTime: time-span

Время в пути

Zimnik: boolean

Параметр, который определяет, включен ли зимник для перевозки груза

Ferries: boolean

Параметр, который определяет, учитывать ли паромные переправы для перевозки груза

FirmId: string

Идентификатор фирмы

AuctionId: guid (nullable)

Id аукциона

}
4XX Ошибка запроса. Подробнее про ошибки API
Развернуть все Свернуть все
Пример Модель
{...}
"Reason":"string",
"Error":"string"
}
{...}

Модель ошибки

Reason: string

Причина ошибки

Error: string

Ключ ошибки

}
Загрузка...
Развернуть все Свернуть все
Загрузка...

Удаление приоритетного показа

 
Обнуление параметров приоритетного показа у груза.
delete
/v1.0/loads/{loadId}/priority
CURL 1C
CURL
Копировать

                
1C
Копировать

                
Пример ответа Ответ
200 Актуальное состояние груза
Развернуть все Свернуть все
Пример Модель
{...}
"LoadMeta":{...},
"LoadMetaId":"3fa85f64-5717-4562-b3fc-2c963f66afa6",
"MetaData":"string"
},
"ContactId1":0,
"ContactId2":0,
"Note":"string",
"FirstDate":"1970-01-01T00:00:00.000Z",
"LastDate":"1970-01-01T00:00:00.000Z",
"DateType":0,
"PeriodicityId":0,
"OrderNumber":"string",
"Krugoreis":false,
"Loading":{...},
"CityId":0,
"Latitude":0.5,
"Longitude":0.5,
"Street":"string",
"TimeStart":"1970-01-01T00:00:00.000Z",
"TimeEnd":"1970-01-01T00:00:00.000Z",
"IsRoundTheClock":false,
"LargeCities":[...],
0
],
"LoadingCargos":[...]
{...}
"CargoId":0,
"NameId":0,
"Name":"string",
"PackagingType":0,
"PackagingQuantity":0,
"Weight":0.5,
"Volume":0.5,
"Sizes":{...}
"Length":0.5,
"Width":0.5,
"Height":0.5,
"Diameter":0.5,
"LengthHighlight":false,
"WidthHighlight":false,
"HeightHighlight":false
}
}
]
},
"ExtraPoints":[...],
{...}
"CityId":0,
"PointType":0,
"Latitude":0.5,
"Longitude":0.5,
"Street":"string",
"OrdinalId":0,
"IsRoundTheClock":false,
"LoadingDateStart":"1970-01-01T00:00:00.000Z",
"LoadingDateEnd":"1970-01-01T00:00:00.000Z",
"LoadingTimeStart":null,
"LoadingTimeEnd":null,
"LoadingCargos":[...],
{...}
"CargoId":0,
"NameId":0,
"Name":"string",
"PackagingType":0,
"PackagingQuantity":0,
"Weight":0.5,
"Volume":0.5,
"Sizes":{...}
"Length":0.5,
"Width":0.5,
"Height":0.5,
"Diameter":0.5,
"LengthHighlight":false,
"WidthHighlight":false,
"HeightHighlight":false
}
}
],
"UnloadingCargos":[...]
{...}
"CargoId":0,
"Weight":0.5,
"Volume":0.5,
"PackagingQuantity":0,
"IsDefinedByTtn":false
}
]
}
],
"Unloading":{...},
"CityId":0,
"Latitude":0.5,
"Longitude":0.5,
"Street":"string",
"TimeStart":"1970-01-01T00:00:00.000Z",
"TimeEnd":"1970-01-01T00:00:00.000Z",
"IsRoundTheClock":false,
"LargeCities":[...],
0
],
"LoadingCargos":[...]
{...}
"CargoId":0,
"NameId":0,
"Name":"string",
"PackagingType":0,
"PackagingQuantity":0,
"Weight":0.5,
"Volume":0.5,
"Sizes":{...}
"Length":0.5,
"Width":0.5,
"Height":0.5,
"Diameter":0.5,
"LengthHighlight":false,
"WidthHighlight":false,
"HeightHighlight":false
}
}
]
},
"Cargo":{...},
"Weight":0.5,
"Volume":0.5,
"ADR":0,
"CargoTypeId":0,
"CargoType":"string",
"PackType":0,
"PalletCount":0,
"BeltCount":0,
"DogruzType":0,
"SborGruz":false,
"Size":{...}
"Length":0.5,
"Width":0.5,
"Height":0.5,
"Diameter":0.5,
"LengthHighlight":false,
"WidthHighlight":false,
"HeightHighlight":false
}
},
"Transport":{...},
"CarType":0,
"LoadingType":0,
"LoadingLogicalOperator":"string",
"UnloadingType":0,
"UnloadingLogicalOperator":"string",
"TrucksQuantity":0,
"TemperatureFrom":0,
"TemperatureTo":0,
"Stsepka":false,
"Pnevmohod":false,
"Koniki":false,
"TIR":false,
"CMR":false,
"T1":false,
"SanPassport":false,
"IsTracking":false
},
"Payment":{...},
"CurrencyId":0,
"MoneyType":0,
"RateSum":0.5,
"SumWithNDS":0.5,
"SumWithoutNDS":0.5,
"PrepayPercent":0,
"PrepayPercentEnabled":false,
"PayDays":0,
"PayDaysEnabled":false,
"FixedRate":false,
"Torg":false,
"DirectContract":false,
"InFuel":false,
"OnUnloading":false,
"HideResponses":false,
"AcceptPaymentTypes":0
},
"InviteSettings":{...},
"InviteDelayInSeconds":0,
"InviteDurationInSeconds":0
},
"PriorityView":{...},
"DailyLimit":0.5,
"IsForPayedOnly":false,
"OrderLimit":0.5,
"ViewRate":0.5,
"MoneySpentPerDay":0.5,
"MoneySpentPerOrder":0.5
},
"Stealth":{...},
"ListIdToHide":"3fa85f64-5717-4562-b3fc-2c963f66afa6",
"FirmRegDateToHide":"1970-01-01T00:00:00.000Z",
"ScoreToHide":0.5
},
"LoadFiles":[...],
{...}
"Id":"3fa85f64-5717-4562-b3fc-2c963f66afa6",
"FileType":0,
"Attributes":0,
"Name":"string",
"Link":"string",
"Size":0
}
],
"Deal":{...},
"Auction":{...}
"StartRate":0.5,
"Currency":0,
"Step":0.5,
"PaymentType":0,
"AcceptSecondPayType":false,
"StartDate":"1970-01-01T00:00:00.000Z",
"EndDate":"1970-01-01T00:00:00.000Z",
"EndDateBoundary":"1970-01-01T00:00:00.000Z",
"Nds":0.5,
"TimeToProvideDocuments":0.5,
"AutoRenew":false,
"RenewTime":0,
"MaxRenewTime":0,
"RaiseBid":false,
"MaxRate":0.5,
"RaiseBidInterval":0,
"ResponseInMinutes":0,
"Duration":0,
"StartSinceFirstBet":false,
"AuctionRestartParameters":{...},
"AuctionFinishAction":0,
"InitRestartCount":0,
"InitChangeWinnerCount":0,
"DurationAfterRestart":0
},
"AcceptCounterOffersOnlyBeforeFirstBet":false,
"WinnerCriterion":0,
"AuctionId":"3fa85f64-5717-4562-b3fc-2c963f66afa6",
"LoadId":"3fa85f64-5717-4562-b3fc-2c963f66afa6",
"ActiveDealId":"3fa85f64-5717-4562-b3fc-2c963f66afa6",
"State":0,
"Finished":false,
"WinDate":"1970-01-01T00:00:00.000Z",
"AuctionRates":[...]
{...}
"AuctionRateId":"3fa85f64-5717-4562-b3fc-2c963f66afa6",
"AddedAt":"1970-01-01T00:00:00.000Z",
"RateFirm":{...},
"Score":0.5,
"Status":0,
"Name":"string",
"ContactName":"string",
"AtiId":"string"
},
"Rate":0.5,
"State":0,
"LoadingDate":"1970-01-01T00:00:00.000Z",
"FirmId":0,
"ContactId":0
}
]
}
},
"Boards":[...],
{...}
"BoardId":"string",
"PublicationTime":"1970-01-01T00:00:00.000Z",
"IsReservationEnabled":false,
"PublicationOption":0,
"IsPublished":false,
"IsCommonBoard":false
}
],
"UnloadFirstDate":"1970-01-01T00:00:00.000Z",
"UnloadLastDate":"1970-01-01T00:00:00.000Z",
"ArchiveDate":"1970-01-01T00:00:00.000Z",
"ArchiveReason":"Unknown",
"TruePrice":0,
"TrueCurrencyId":0,
"ResponseCount":0,
"OfferCount":0,
"CanBeDeleted":false,
"HasPermissionsToLoad":false,
"CanBeEdited":false,
"CanBeRenewed":false,
"CanBeRestored":false,
"EditRestriction":0,
"DeleteRestriction":0,
"RestoreRestriction":0,
"RenewRestriction":"string",
"Id":"3fa85f64-5717-4562-b3fc-2c963f66afa6",
"LoadNumber":"string",
"UpdatedAt":"1970-01-01T00:00:00.000Z",
"AddedAt":"1970-01-01T00:00:00.000Z",
"Distance":0,
"PlatonRoadsLength":0,
"TollRoadsLength":0,
"TravelTime":"?",
"Zimnik":false,
"Ferries":false,
"FirmId":"string",
"AuctionId":"3fa85f64-5717-4562-b3fc-2c963f66afa6"
}
{...}
ContactId1*: int32

Идентификатор первого выбранного контакта.
Список всех контактов и их идентификаторы можно получить с помощью API для работы с фирмами
Контакт должен быть виден для остальных участников АТИ

ContactId2: int32 (nullable)

Идентификатор второго выбранного контакта, если не выбрано, то null
Контакт должен быть виден для остальных участников АТИ

Note: string

Примечание к грузу
Ограничение по длине: 1000 символов

FirstDate: date-time

Дата, начиная с которой груз актуален, в формате UTC
Минимальное значение равно текущей дате
При значении параметра DateType равным 0, допустимое значение поля - текущая дата
При значении параметра DateType равным 1, допустимое значение поля - от текущей даты до 60 дней вперед
При значении параметра DateType равным 2, допустимое значение поля - текущая дата
При значении параметра DateType равным 3, FirstDate должен принимать значение текущей даты или отсутствовать

LastDate: date-time

Дата, после которой груз не актуален, в формате UTC
Минимальное значение равно значению параметра FirstDate
При значении параметра DateType равным 0, допустимое значение поля - от текущей даты до 1 дня вперед
При значении параметра DateType равным 1, допустимое значение поля - от даты в параметре FirstDate до 9 дней вперед
При значении параметра DateType равным 2, данное поле вычисляется автоматически по формуле FirstDate + 2 месяца, передаваемое значение игнорируется
При значении параметра DateType равным 3, LastDate автоматически устанавливается на значение + 2 дня от текущей даты, передаваемое значение игнорируется

DateType: int32

Выбор типа готовности груза к перевозке

  • 0 - Готов к загрузке
  • 1 - с Х по У
  • 2 - постоянно
  • 3 - груза нет, запрос ставки
PeriodicityId: int32

Периодичность загрузки
Если параметр DateType не равен 2, PeriodicityId равен 0.
Иначе PeriodicityId может принимать следующие значения:

  • 1 - ежедневно
  • 100 - по рабочим дням
OrderNumber: string

Номер заказа
Ограничение по длине: 250 символов

Krugoreis: boolean

Параметр, который определяет, включен ли кругорейс для перевозки груза

UnloadFirstDate: date-time (nullable)

Дата начала разгрузки, в формате UTC.
Может иметь значение null.
Минимальное значение равно текущей дате.
При значении параметра DateType равным 3, UnloadFirstDate принимает значение null

UnloadLastDate: date-time (nullable)

Дата окончания разгрузки, в формате UTC. Может иметь значение null.
Если нет даты начала разгрузки UnloadFirstDate, должна отсутствовать дата окончания разгрузки UnloadLastDate.
При значении параметра DateType равным 3, UnloadFirstDate принимает значение null

ArchiveDate: date-time (nullable)

Дата и время переноса в архив

ArchiveReason: enum (nullable)
[Unknown, System, Manual, Complaints, UnwantedContent, DeleteCsvLoad, MergeLoadsAfterEdit, ContactDoesNotHaveAccessToVirtualPayments, VerticesLoadDelete, StealthStatisticError, CheckDuplicateComplaints, DeleteContact, DeleteFirm, CleanOldLoadsJob]

Причина переноса в архив

TruePrice: int32

Озвученная ставка

TrueCurrencyId: int32

ID валюты озвученной ставки

ResponseCount: int32

Количество отзывов о грузе (без встречных предложений)

OfferCount: int32

Количество встречных предложений (остальные отзывы не учитываются)

CanBeDeleted: boolean

Есть ли доступ на удаление груза.

HasPermissionsToLoad: boolean

Есть ли доступ на работу с грузом (без учета прав).

CanBeEdited: boolean

Есть ли доступ на редактирование груза.

CanBeRenewed: boolean

Есть ли доступ на обновление груза.

CanBeRestored: boolean

Есть ли доступ на восстановление груза

EditRestriction: enum
[0, 1, 2, 3, 4, 5, 6, 7, 8, 9, 10, 11, 12, 13, 14, 15]

Причины отказа в доступе на редактирование груза:

  • 0 - Вы имеете доступ к работе с грузом
  • 1 - Ваша фирма больше не может размещать грузы из-за нарушения правил АТИ
  • 2 - Груз зарезервирован/взят, операции с грузом запрещены
  • 3 - Превышен лимит актуальных грузов
  • 4 - Вы пытаетесь работать с грузами под общим пользователем. Недостаточно прав
  • 5 - У вашего контакта недостаточно прав для работы с данным грузом
  • 6 - Груз имеет завершенные Торги, операции с грузом запрещены
  • 7 - Сервис сделок временно недоступен
  • 8 - Нельзя изменять или удалять груз из сквозных торгов
  • 9 - У вашего контакта недостаточно прав для создания грузов
  • 10 - У вашего контакта недостаточно прав для работы с виртуальными кошельками
  • 11 - У вашего контакта недостаточно прав для работы с грузами на Общей площадке
  • 12 - У вашего контакта недостаточно прав для работы с грузами на Персональных площадках
  • 13 - У вашего контакта нет доступа для работы с одной или несколькими персональными площадками, указанными в грузе
  • 14 - У вашего контакта нет доступа для работы с подразделением, в которое восстанавливается груз
  • 15 - Ваш контакт должен быть указан первым в грузе
DeleteRestriction: enum
[0, 1, 2, 3, 4, 5, 6, 7, 8, 9, 10, 11, 12, 13, 14, 15]

Причины отказа в доступе на удаление контакта:

  • 0 - Вы имеете доступ к работе с грузом
  • 1 - Ваша фирма больше не может размещать грузы из-за нарушения правил АТИ
  • 2 - Груз зарезервирован/взят, операции с грузом запрещены
  • 3 - Превышен лимит актуальных грузов
  • 4 - Вы пытаетесь работать с грузами под общим пользователем. Недостаточно прав
  • 5 - У вашего контакта недостаточно прав для работы с данным грузом
  • 6 - Груз имеет завершенные Торги, операции с грузом запрещены
  • 7 - Сервис сделок временно недоступен
  • 8 - Нельзя изменять или удалять груз из сквозных торгов
  • 9 - У вашего контакта недостаточно прав для создания грузов
  • 10 - У вашего контакта недостаточно прав для работы с виртуальными кошельками
  • 11 - У вашего контакта недостаточно прав для работы с грузами на Общей площадке
  • 12 - У вашего контакта недостаточно прав для работы с грузами на Персональных площадках
  • 13 - У вашего контакта нет доступа для работы с одной или несколькими персональными площадками, указанными в грузе
  • 14 - У вашего контакта нет доступа для работы с подразделением, в которое восстанавливается груз
  • 15 - Ваш контакт должен быть указан первым в грузе
RestoreRestriction: enum
[0, 1, 2, 3, 4, 5, 6, 7, 8, 9, 10, 11, 12, 13, 14, 15]

Причины отказа в доступе на восстановление груза:

  • 0 - Вы имеете доступ к работе с грузом
  • 1 - Ваша фирма больше не может размещать грузы из-за нарушения правил АТИ
  • 2 - Груз зарезервирован/взят, операции с грузом запрещены
  • 3 - Превышен лимит актуальных грузов
  • 4 - Вы пытаетесь работать с грузами под общим пользователем. Недостаточно прав
  • 5 - У вашего контакта недостаточно прав для работы с данным грузом
  • 6 - Груз имеет завершенные Торги, операции с грузом запрещены
  • 7 - Сервис сделок временно недоступен
  • 8 - Нельзя изменять или удалять груз из сквозных торгов
  • 9 - У вашего контакта недостаточно прав для создания грузов
  • 10 - У вашего контакта недостаточно прав для работы с виртуальными кошельками
  • 11 - У вашего контакта недостаточно прав для работы с грузами на Общей площадке
  • 12 - У вашего контакта недостаточно прав для работы с грузами на Персональных площадках
  • 13 - У вашего контакта нет доступа для работы с одной или несколькими персональными площадками, указанными в грузе
  • 14 - У вашего контакта нет доступа для работы с подразделением, в которое восстанавливается груз
  • 15 - Ваш контакт должен быть указан первым в грузе
RenewRestriction: string

Причина отказа в доступе на обновление груза.

Id: guid

Идентификатор груза

LoadNumber: string

Номер груза

UpdatedAt: date-time

Дата последнего изменения груза в формате UTC

AddedAt: date-time

Время добавления груза в формате UTC

Distance: int32

Расстояние по дорогам в км

PlatonRoadsLength: int32

Протяженность дорог в км, в построенном пути за которые взимается плата по системе Платон

TollRoadsLength: int32

Протяженность платных дорог в построенном пути в км

TravelTime: time-span

Время в пути

Zimnik: boolean

Параметр, который определяет, включен ли зимник для перевозки груза

Ferries: boolean

Параметр, который определяет, учитывать ли паромные переправы для перевозки груза

FirmId: string

Идентификатор фирмы

AuctionId: guid (nullable)

Id аукциона

}
4XX Ошибка запроса. Подробнее про ошибки API
Развернуть все Свернуть все
Пример Модель
{...}
"Reason":"string",
"Error":"string"
}
{...}

Модель ошибки

Reason: string

Причина ошибки

Error: string

Ключ ошибки

}
Загрузка...
Развернуть все Свернуть все
Загрузка...

Методы для работы с комментариями к грузам

Получение всех комментариев ко всем грузам для текущей фирмы

Ответ будет представлен в виде словаря, где ключ - это id груза, а значение - массив структуры “комментарий”.

 
Получение всех комментариев фирмы ко всем грузам
get
/v1.0/loads/comments
CURL 1C
CURL
Копировать

                
1C
Копировать

                
Пример ответа Ответ
200 Комментарии ко всем грузам фирмы
Развернуть все Свернуть все
Пример Модель
{...}
"any-key":[...]
{...}
"CommentId":"3fa85f64-5717-4562-b3fc-2c963f66afa6",
"Message":"string",
"ContactId":0,
"CommentDateTime":"1970-01-01T00:00:00.000Z"
}
]
}
{...}
}
4XX Ошибка запроса. Подробнее про ошибки API
Развернуть все Свернуть все
Пример Модель
{...}
"Reason":"string",
"Error":"string"
}
{...}

Модель ошибки

Reason: string

Причина ошибки

Error: string

Ключ ошибки

}
Загрузка...
Развернуть все Свернуть все
Загрузка...

Получение всех комментариев к грузу для текущей фирмы

 
Получение всех комментариев к грузу для текущей фирмы.
get
/v1.0/loads/{loadId}/comments
CURL 1C
CURL
Копировать

                
1C
Копировать

                
Пример ответа Ответ
200 Комментарии к грузу
Развернуть все Свернуть все
Пример Модель
[...]
{...}
"CommentId":"3fa85f64-5717-4562-b3fc-2c963f66afa6",
"Message":"string",
"ContactId":0,
"CommentDateTime":"1970-01-01T00:00:00.000Z"
}
]
[{...}]
CommentId: guid

Идентификатор комментария

Message: string

Комментарий

ContactId: int32

Контакт фирмы, который оставил комментарий

CommentDateTime: date-time

Время, когда комментарий был оставлен

}]
4XX Ошибка запроса. Подробнее про ошибки API
Развернуть все Свернуть все
Пример Модель
{...}
"Reason":"string",
"Error":"string"
}
{...}

Модель ошибки

Reason: string

Причина ошибки

Error: string

Ключ ошибки

}
Загрузка...
Развернуть все Свернуть все
Загрузка...

Добавление либо редактирование комментария к грузу

При редактировании комментария у изменённого комментария поменяется CommentId.

Требования к комментарию

  • комментарий не может быть пустым
  • длина комментария не более 128 символов
  • если для фирмы включен режим раздельного доступа, то количество комментариев к одному грузу ограничено одним комментарием на контакт, иначе – одним комментарием на фирму
 
Добавление либо редактирование комментария к грузу
put
/v1.0/loads/{loadId}/comments
CURL 1C
CURL
Копировать

                
1C
Копировать

                
Пример ответа Ответ
200 Комментарий к грузу
Развернуть все Свернуть все
Пример Модель
{...}
"CommentId":"3fa85f64-5717-4562-b3fc-2c963f66afa6",
"Message":"string",
"ContactId":0,
"CommentDateTime":"1970-01-01T00:00:00.000Z"
}
{...}
CommentId: guid

Идентификатор комментария

Message: string

Комментарий

ContactId: int32

Контакт фирмы, который оставил комментарий

CommentDateTime: date-time

Время, когда комментарий был оставлен

}
4XX Ошибка запроса. Подробнее про ошибки API
Развернуть все Свернуть все
Пример Модель
{...}
"Reason":"string",
"Error":"string"
}
{...}

Модель ошибки

Reason: string

Причина ошибки

Error: string

Ключ ошибки

}
Загрузка...
Развернуть все Свернуть все
Загрузка...

Удаление комментария у груза

 
Удаление комментария у груза.
delete
/v1.0/loads/{loadId}/comments
CURL 1C
CURL
Копировать

                
1C
Копировать

                
Пример ответа Ответ
200 Комментарий к грузу успешно удален
Развернуть все Свернуть все
Пример Модель
"string"
string
4XX Ошибка запроса. Подробнее про ошибки API
Развернуть все Свернуть все
Пример Модель
{...}
"Reason":"string",
"Error":"string"
}
{...}

Модель ошибки

Reason: string

Причина ошибки

Error: string

Ключ ошибки

}
Загрузка...
Развернуть все Свернуть все
Загрузка...

Методы для работы с отзывами к грузам

Отзыв может быть “Встречным предложением” с одной или несколькими ставками, “Груза нет”, “Озвученная ставка”.

Требования к дате, передаваемой в dateFrom при отправке запросов на получение отзывов:

  • Дата в UTC, начиная с которой необходимо показывать отзывы. Если ничего не передано, значит показываем абсолютно все отзывы
  • Формат даты: yyyy-mm-ddThh:mm:ss<timezone_specifier>, где timezone_specifier обозначает спецификатор часового пояса, например:
    • Z - дата в формате UTC. Пример, 2016-04-28T20:01:57Z;
    • -hh:mm - часовой пояс UTC-hh:mm. Пример UTC-1: 2016-04-28T20:01:57-01:00;
    • %2Bhh:mm - часовой пояс UTC+hh:mm. Пример UTC+1: 2016-04-28T20:01:57%2B01:00;
  • Если модификатора часового пояса нет, дата отправляется в формате UTC+3(Москва)

Получение встречных предложений на грузы фирмы с одной или несколькими ставками

 
Получение встречных предложений на грузы фирмы с одной или несколькими ставками .
get
/v1.0/loads/new/responses
CURL 1C
CURL
Копировать

                
1C
Копировать

                
Пример ответа Ответ
200 Массив отзывов на все грузы фирмы
Развернуть все Свернуть все
Пример Модель
[...]
{...}
"ResponseId":"3fa85f64-5717-4562-b3fc-2c963f66afa6",
"LoadId":"3fa85f64-5717-4562-b3fc-2c963f66afa6",
"LoadNumber":"string",
"LoadFirmId":0,
"FirmId":0,
"FirmName":"string",
"ContactId":0,
"AddedAt":"1970-01-01T00:00:00.000Z",
"UpdatedAt":"1970-01-01T00:00:00.000Z",
"Price":0.5,
"CurrencyId":0,
"NdsPrice":0.5,
"NdsCurrencyId":0,
"NotNdsPrice":0.5,
"NotNdsCurrencyId":0,
"CounterOfferSource":0,
"Note":"string",
"PayAttributes":0,
"PrepayPercent":0,
"PayAfterMaxBankDays":0,
"LoadingDate":"1970-01-01T00:00:00.000Z",
"IsOutdated":false,
"IsLoadPublished":false,
"IsNoLoad":false,
"AnnouncedCurrencyId":0,
"AnnouncedRate":0,
"FirmInfo":{...}
"TotalScore":0.5,
"Status":0,
"FullFirmName":"string",
"Contact":{...},
"Id":0,
"Name":"string",
"Telephone":"string",
"Email":"string",
"Icq":"string",
"Mobile":"string",
"MobileOperator":"string",
"SkypeName":"string",
"CityId":0,
"Location":{...}
"CityId":0,
"RegionId":0,
"CountryId":0,
"FullName":"string",
"ShortName":"string",
"IsRegionalCenter":false,
"CitySize":0,
"FiasId":"3fa85f64-5717-4562-b3fc-2c963f66afa6",
"CityName":"string",
"RegionName":"string",
"CountryName":"string",
"CountryCodeName":"string"
}
},
"Inn":"string"
}
}
]
[{...}]
ResponseId: guid

Id отзыва

LoadId: guid

Id груза, на который оставлен отзыв

LoadNumber: string

Номер груза

LoadFirmId: int32

Id фирмы, которой принадлежит груз

FirmId: int32

Id фирмы, которая оставила отзыв

FirmName: string

Название фирмы

ContactId: int32

Контакт, который сделал встречное предложение

AddedAt: date-time

Дата добавления отзыва

UpdatedAt: date-time

Дата изменения отзыва

Price: decimal

Предложенная цена встречного предложения

CurrencyId: int32

Валюта встречного предложения
Значение из словаря валют АТИ

NdsPrice: decimal

Предложенная цена встречного предложения с ндс

NdsCurrencyId: int32

Валюта ставки встречного предложения б/нал с НДС.Параметр должен быть равен валюте, указанной в грузе, если параметр FixedRate равен True и параметр Torg равен False.
Значение из словаря валют АТИ

NotNdsPrice: decimal

Предложенная цена встречного предложения без ндс

NotNdsCurrencyId: int32

Валюта встречного предложения без ндс

CounterOfferSource: enum
[0, 1, 2, 3, 4, 5, 6]

Обозначение откуда было добавлено встречное предложение

  • 0 - Неизвестный источник
  • 1 - Мобильное приложение
  • 2 - Интегратор
  • 3 - Перехват грузов интегратором
  • 4 - Страница поиска грузов
  • 5 - Перехват машин
  • 6 - Сквозное встречное предложение, добавлено автоматически
Note: string

Примечание к встречному предложению
Максимальная длина - 512 символов

PayAttributes: int32

Атрибуты оплаты, по умолчанию - 0. Битовая сумма следующих параметров:

  • 1 - возможна оплата наличными
  • 2 - возможна оплата по безналичному рассчету
  • 4 - блиц
  • 8 - оплата с НДС
  • 16 - возможна предоплата
  • 32 - оплата на выгрузке
  • 64 - включена ли оплата через некоторое количество банковских дней
PrepayPercent: int32

Процент предоплаты
Должен быть равен 0 или отсутствовать, если PayAttributes не содержит флаг 16 - возможна предоплата. Допустимое значение от 0 до 100

PayAfterMaxBankDays: int32

Оплата через ... банковских дней
Должен быть равен 0 или отсутствовать, если PayAttributes не содержит флаг 64 - включена оплата через некоторое количество банковских дней. Допустимое значение от 0 до 99

LoadingDate: date-time (nullable)

Дата, когда предложивший хочет перевезти ваш груз

IsOutdated: boolean

Определяет, просрочен ли отзыв. Когда груз редактируют, удаляют, обновляют, отзыв помечается просроченным.
Только для чтения.

IsLoadPublished: boolean

Относится ли отзыв к публикующемуся грузу

IsNoLoad: boolean

Параметр "Груза нет"

AnnouncedCurrencyId: int32

Валюта "Озвученной ставки"
Значение из словаря валют АТИ

AnnouncedRate: int32

Озвученная ставка

}]
4XX Ошибка запроса. Подробнее про ошибки API
Развернуть все Свернуть все
Пример Модель
{...}
"Reason":"string",
"Error":"string"
}
{...}

Модель ошибки

Reason: string

Причина ошибки

Error: string

Ключ ошибки

}
Загрузка...
Развернуть все Свернуть все
Загрузка...

Получение отзывов на любой груз по ID

Если груз принадлежит вашей фирме, то вернутся все отзывы на ваш груз с полной информацией. Если груз принадлежит чужой фирме, то вернутся все отзывы на этот груз, но при этом все отзывы, кроме вашего, будут иметь в поле FirmInfo.Contact значение null.

 
Получение отзывов на конкретный груз фирмы. На данный момент можно получить только встречные предложения.
get
/v1.0/loads/new/{loadId}/responses
CURL 1C
CURL
Копировать

                
1C
Копировать

                
Пример ответа Ответ
200 Массив отзывов
Развернуть все Свернуть все
Пример Модель
[...]
{...}
"ResponseId":"3fa85f64-5717-4562-b3fc-2c963f66afa6",
"LoadId":"3fa85f64-5717-4562-b3fc-2c963f66afa6",
"LoadNumber":"string",
"LoadFirmId":0,
"FirmId":0,
"FirmName":"string",
"ContactId":0,
"AddedAt":"1970-01-01T00:00:00.000Z",
"UpdatedAt":"1970-01-01T00:00:00.000Z",
"Price":0.5,
"CurrencyId":0,
"NdsPrice":0.5,
"NdsCurrencyId":0,
"NotNdsPrice":0.5,
"NotNdsCurrencyId":0,
"CounterOfferSource":0,
"Note":"string",
"PayAttributes":0,
"PrepayPercent":0,
"PayAfterMaxBankDays":0,
"LoadingDate":"1970-01-01T00:00:00.000Z",
"IsOutdated":false,
"IsLoadPublished":false,
"IsNoLoad":false,
"AnnouncedCurrencyId":0,
"AnnouncedRate":0,
"FirmInfo":{...}
"TotalScore":0.5,
"Status":0,
"FullFirmName":"string",
"Contact":{...},
"Id":0,
"Name":"string",
"Telephone":"string",
"Email":"string",
"Icq":"string",
"Mobile":"string",
"MobileOperator":"string",
"SkypeName":"string",
"CityId":0,
"Location":{...}
"CityId":0,
"RegionId":0,
"CountryId":0,
"FullName":"string",
"ShortName":"string",
"IsRegionalCenter":false,
"CitySize":0,
"FiasId":"3fa85f64-5717-4562-b3fc-2c963f66afa6",
"CityName":"string",
"RegionName":"string",
"CountryName":"string",
"CountryCodeName":"string"
}
},
"Inn":"string"
}
}
]
[{...}]
ResponseId: guid

Id отзыва

LoadId: guid

Id груза, на который оставлен отзыв

LoadNumber: string

Номер груза

LoadFirmId: int32

Id фирмы, которой принадлежит груз

FirmId: int32

Id фирмы, которая оставила отзыв

FirmName: string

Название фирмы

ContactId: int32

Контакт, который сделал встречное предложение

AddedAt: date-time

Дата добавления отзыва

UpdatedAt: date-time

Дата изменения отзыва

Price: decimal

Предложенная цена встречного предложения

CurrencyId: int32

Валюта встречного предложения
Значение из словаря валют АТИ

NdsPrice: decimal

Предложенная цена встречного предложения с ндс

NdsCurrencyId: int32

Валюта ставки встречного предложения б/нал с НДС.Параметр должен быть равен валюте, указанной в грузе, если параметр FixedRate равен True и параметр Torg равен False.
Значение из словаря валют АТИ

NotNdsPrice: decimal

Предложенная цена встречного предложения без ндс

NotNdsCurrencyId: int32

Валюта встречного предложения без ндс

CounterOfferSource: enum
[0, 1, 2, 3, 4, 5, 6]

Обозначение откуда было добавлено встречное предложение

  • 0 - Неизвестный источник
  • 1 - Мобильное приложение
  • 2 - Интегратор
  • 3 - Перехват грузов интегратором
  • 4 - Страница поиска грузов
  • 5 - Перехват машин
  • 6 - Сквозное встречное предложение, добавлено автоматически
Note: string

Примечание к встречному предложению
Максимальная длина - 512 символов

PayAttributes: int32

Атрибуты оплаты, по умолчанию - 0. Битовая сумма следующих параметров:

  • 1 - возможна оплата наличными
  • 2 - возможна оплата по безналичному рассчету
  • 4 - блиц
  • 8 - оплата с НДС
  • 16 - возможна предоплата
  • 32 - оплата на выгрузке
  • 64 - включена ли оплата через некоторое количество банковских дней
PrepayPercent: int32

Процент предоплаты
Должен быть равен 0 или отсутствовать, если PayAttributes не содержит флаг 16 - возможна предоплата. Допустимое значение от 0 до 100

PayAfterMaxBankDays: int32

Оплата через ... банковских дней
Должен быть равен 0 или отсутствовать, если PayAttributes не содержит флаг 64 - включена оплата через некоторое количество банковских дней. Допустимое значение от 0 до 99

LoadingDate: date-time (nullable)

Дата, когда предложивший хочет перевезти ваш груз

IsOutdated: boolean

Определяет, просрочен ли отзыв. Когда груз редактируют, удаляют, обновляют, отзыв помечается просроченным.
Только для чтения.

IsLoadPublished: boolean

Относится ли отзыв к публикующемуся грузу

IsNoLoad: boolean

Параметр "Груза нет"

AnnouncedCurrencyId: int32

Валюта "Озвученной ставки"
Значение из словаря валют АТИ

AnnouncedRate: int32

Озвученная ставка

}]
4XX Ошибка запроса. Подробнее про ошибки API
Развернуть все Свернуть все
Пример Модель
{...}
"Reason":"string",
"Error":"string"
}
{...}

Модель ошибки

Reason: string

Причина ошибки

Error: string

Ключ ошибки

}
Загрузка...
Развернуть все Свернуть все
Загрузка...

Получение отзывов на заданные грузы фирмы в виде словаря

Ответ будет представлен в виде словаря, где ключ – id груза, а значение - массив структур “отзыв на груз”, содержащий:

  • Result, представляющий набор отзывов для данного груза;
  • Status, представляющий статус груза: если груз с таким id не найден у вашей фирмы, статус равен 1, иначе статус равен 0. Если у груза статус равен 1, то массив отзывов всегда пуст.

Список ключей словаря полностью совпадает со списком грузов, для которых были запрошены отзывы.

 
Получение отзывов на заданные грузы фирмы в виде словаря. На данный момент можно получить только встречные предложения.
get
/v1.0/loads/new/responses/by-ids
loadIds
array
Добавить еще поле
Массив id грузов, для которых нужно получить отзывы
CURL 1C
CURL
Копировать

                
1C
Копировать

                
Пример ответа Ответ
200 Массив отзывов по заданным грузам в виде словаря
Развернуть все Свернуть все
Пример Модель
{...}
"any-key":{...}
"Status":0,
"Message":"string",
"Result":[...],
{...}
"ResponseId":"3fa85f64-5717-4562-b3fc-2c963f66afa6",
"LoadId":"3fa85f64-5717-4562-b3fc-2c963f66afa6",
"LoadNumber":"string",
"LoadFirmId":0,
"FirmId":0,
"FirmName":"string",
"ContactId":0,
"AddedAt":"1970-01-01T00:00:00.000Z",
"UpdatedAt":"1970-01-01T00:00:00.000Z",
"Price":0.5,
"CurrencyId":0,
"NdsPrice":0.5,
"NdsCurrencyId":0,
"NotNdsPrice":0.5,
"NotNdsCurrencyId":0,
"CounterOfferSource":0,
"Note":"string",
"PayAttributes":0,
"PrepayPercent":0,
"PayAfterMaxBankDays":0,
"LoadingDate":"1970-01-01T00:00:00.000Z",
"IsOutdated":false,
"IsLoadPublished":false,
"IsNoLoad":false,
"AnnouncedCurrencyId":0,
"AnnouncedRate":0,
"FirmInfo":{...}
"TotalScore":0.5,
"Status":0,
"FullFirmName":"string",
"Contact":{...},
"Id":0,
"Name":"string",
"Telephone":"string",
"Email":"string",
"Icq":"string",
"Mobile":"string",
"MobileOperator":"string",
"SkypeName":"string",
"CityId":0,
"Location":{...}
"CityId":0,
"RegionId":0,
"CountryId":0,
"FullName":"string",
"ShortName":"string",
"IsRegionalCenter":false,
"CitySize":0,
"FiasId":"3fa85f64-5717-4562-b3fc-2c963f66afa6",
"CityName":"string",
"RegionName":"string",
"CountryName":"string",
"CountryCodeName":"string"
}
},
"Inn":"string"
}
}
],
"Error":"string",
"Reason":"string"
}
}
{...}
}
4XX Ошибка запроса. Подробнее про ошибки API
Развернуть все Свернуть все
Пример Модель
{...}
"Reason":"string",
"Error":"string"
}
{...}

Модель ошибки

Reason: string

Причина ошибки

Error: string

Ключ ошибки

}
Загрузка...
Развернуть все Свернуть все
Загрузка...

Добавление либо редактирование отзыва на чужой груз

 
Добавление либо редактирование отзыва на чужой груз.
put
/v1.0/loads/new/{loadId}/responses
Развернуть все Свернуть все
{...}
ResponseId: guid

Id отзыва
Только для чтения

LoadId: guid

Id груза, на который оставлен отзыв
Только для чтения

LoadNumber: string

Номер груза
Только для чтения

LoadFirmId: int32

Id фирмы, которой принадлежит груз
Только для чтения

FirmId: int32

Id фирмы, которая оставила отзыв
Только для чтения

ContactId: int32

Контакт, который сделал встречное предложение

AddedAt: date-time

Дата добавления отзыва
Только для чтения

UpdatedAt: date-time

Дата изменения отзыва
Только для чтения

Price: decimal

Предложенная ставка встречного предложения не б/нал. Параметр должен быть равен одной из ставок груза: RateSum, SumWithNDS или SumWithoutNDS, если у груза, которому выставляется встречное предложение, параметр FixedRate равен True И параметр Torg равен False. Значение больше 0 и содержит не более 10 символов.

CurrencyId: int32

Валюта встречного предложения. Параметр должен быть равен валюте, указанной в грузе, если параметр FixedRate равен True и параметр Torg равен False
Значение из словаря валют АТИ

NdsPrice: decimal

Предложенная ставка встречного предложения б/нал с НДС

NdsCurrencyId: int32

Валюта ставки встречного предложения б/нал с НДС.Параметр должен быть равен валюте, указанной в грузе, если параметр FixedRate равен True и параметр Torg равен False.
Значение из словаря валют АТИ

NotNdsPrice: decimal

Предложенная ставка встречного предложения б/нал без НДС

NotNdsCurrencyId: int32

Валюта ставки встречного предложения б/нал без НДС. Параметр должен быть равен валюте, указанной в грузе, если параметр FixedRate равен True и параметр Torg равен False
Значение из словаря валют АТИ

Note: string

Примечание к встречному предложению
Максимальная длина - 512 символов

PayAttributes: int32

Атрибуты оплаты, по умолчанию - 0. Битовая сумма следующих параметров:

  • 1 - возможна оплата наличными
  • 2 - возможна оплата по безналичному рассчету
  • 4 - блиц
  • 8 - оплата с НДС
  • 16 - возможна предоплата
  • 32 - оплата на выгрузке
  • 64 - включена ли оплата через некоторое количество банковских дней
PrepayPercent: int32

Процент предоплаты
Должен быть равен 0 или отсутствовать, если PayAttributes не содержит флаг 16 - возможна предоплата. Допустимое значение от 0 до 100

PayAfterMaxBankDays: int32

Оплата через ... банковских дней
Должен быть равен 0 или отсутствовать, если PayAttributes не содержит флаг 64 - включена оплата через некоторое количество банковских дней. Допустимое значение от 0 до 99

LoadingDate: date-time (nullable)

Дата, когда предложивший хочет перевезти ваш груз

IsOutdated: boolean

Определяет, просрочен ли отзыв. Когда груз редактируют, удаляют, обновляют, отзыв помечается просроченным.
Только для чтения.

IsLoadPublished: boolean

Относится ли отзыв к публикующемуся грузу
Только для чтения

IsNoLoad: boolean

Параметр "Груза нет"

AnnouncedCurrencyId: int32

Валюта "Озвученной ставки"
Значение из словаря валют АТИ

AnnouncedRate: int32

Озвученная ставка

}
CURL 1C
CURL
Копировать

                
1C
Копировать

                
Пример ответа Ответ
200 Отзыв на груз
Развернуть все Свернуть все
Пример Модель
{...}
"ResponseId":"3fa85f64-5717-4562-b3fc-2c963f66afa6",
"LoadId":"3fa85f64-5717-4562-b3fc-2c963f66afa6",
"LoadNumber":"string",
"LoadFirmId":0,
"FirmId":0,
"FirmName":"string",
"ContactId":0,
"AddedAt":"1970-01-01T00:00:00.000Z",
"UpdatedAt":"1970-01-01T00:00:00.000Z",
"Price":0.5,
"CurrencyId":0,
"NdsPrice":0.5,
"NdsCurrencyId":0,
"NotNdsPrice":0.5,
"NotNdsCurrencyId":0,
"CounterOfferSource":0,
"Note":"string",
"PayAttributes":0,
"PrepayPercent":0,
"PayAfterMaxBankDays":0,
"LoadingDate":"1970-01-01T00:00:00.000Z",
"IsOutdated":false,
"IsLoadPublished":false,
"IsNoLoad":false,
"AnnouncedCurrencyId":0,
"AnnouncedRate":0,
"FirmInfo":{...}
"TotalScore":0.5,
"Status":0,
"FullFirmName":"string",
"Contact":{...},
"Id":0,
"Name":"string",
"Telephone":"string",
"Email":"string",
"Icq":"string",
"Mobile":"string",
"MobileOperator":"string",
"SkypeName":"string",
"CityId":0,
"Location":{...}
"CityId":0,
"RegionId":0,
"CountryId":0,
"FullName":"string",
"ShortName":"string",
"IsRegionalCenter":false,
"CitySize":0,
"FiasId":"3fa85f64-5717-4562-b3fc-2c963f66afa6",
"CityName":"string",
"RegionName":"string",
"CountryName":"string",
"CountryCodeName":"string"
}
},
"Inn":"string"
}
}
{...}
ResponseId: guid

Id отзыва

LoadId: guid

Id груза, на который оставлен отзыв

LoadNumber: string

Номер груза

LoadFirmId: int32

Id фирмы, которой принадлежит груз

FirmId: int32

Id фирмы, которая оставила отзыв

FirmName: string

Название фирмы

ContactId: int32

Контакт, который сделал встречное предложение

AddedAt: date-time

Дата добавления отзыва

UpdatedAt: date-time

Дата изменения отзыва

Price: decimal

Предложенная цена встречного предложения

CurrencyId: int32

Валюта встречного предложения
Значение из словаря валют АТИ

NdsPrice: decimal

Предложенная цена встречного предложения с ндс

NdsCurrencyId: int32

Валюта ставки встречного предложения б/нал с НДС.Параметр должен быть равен валюте, указанной в грузе, если параметр FixedRate равен True и параметр Torg равен False.
Значение из словаря валют АТИ

NotNdsPrice: decimal

Предложенная цена встречного предложения без ндс

NotNdsCurrencyId: int32

Валюта встречного предложения без ндс

CounterOfferSource: enum
[0, 1, 2, 3, 4, 5, 6]

Обозначение откуда было добавлено встречное предложение

  • 0 - Неизвестный источник
  • 1 - Мобильное приложение
  • 2 - Интегратор
  • 3 - Перехват грузов интегратором
  • 4 - Страница поиска грузов
  • 5 - Перехват машин
  • 6 - Сквозное встречное предложение, добавлено автоматически
Note: string

Примечание к встречному предложению
Максимальная длина - 512 символов

PayAttributes: int32

Атрибуты оплаты, по умолчанию - 0. Битовая сумма следующих параметров:

  • 1 - возможна оплата наличными
  • 2 - возможна оплата по безналичному рассчету
  • 4 - блиц
  • 8 - оплата с НДС
  • 16 - возможна предоплата
  • 32 - оплата на выгрузке
  • 64 - включена ли оплата через некоторое количество банковских дней
PrepayPercent: int32

Процент предоплаты
Должен быть равен 0 или отсутствовать, если PayAttributes не содержит флаг 16 - возможна предоплата. Допустимое значение от 0 до 100

PayAfterMaxBankDays: int32

Оплата через ... банковских дней
Должен быть равен 0 или отсутствовать, если PayAttributes не содержит флаг 64 - включена оплата через некоторое количество банковских дней. Допустимое значение от 0 до 99

LoadingDate: date-time (nullable)

Дата, когда предложивший хочет перевезти ваш груз

IsOutdated: boolean

Определяет, просрочен ли отзыв. Когда груз редактируют, удаляют, обновляют, отзыв помечается просроченным.
Только для чтения.

IsLoadPublished: boolean

Относится ли отзыв к публикующемуся грузу

IsNoLoad: boolean

Параметр "Груза нет"

AnnouncedCurrencyId: int32

Валюта "Озвученной ставки"
Значение из словаря валют АТИ

AnnouncedRate: int32

Озвученная ставка

}
4XX Ошибка запроса. Подробнее про ошибки API
Развернуть все Свернуть все
Пример Модель
{...}
"Reason":"string",
"Error":"string"
}
{...}

Модель ошибки

Reason: string

Причина ошибки

Error: string

Ключ ошибки

}
Загрузка...
Развернуть все Свернуть все
Загрузка...

Удаление отзыва на груз

При удалении встречного предложения у своего груза, необходимо заполнить как loadId, так и ids.
При удалении отзыва на чужой груза, необходимо передать loadId.

 
Позволяет удалить встречные предложения с указанными id для своего груза или удалить отзыв фирмы у чужого груза.
delete
/v1.0/loads/new/{loadId}/responses
ids
array
Добавить еще поле
ID отзывов (если нужно удалить встречные предложения у своего груза)
CURL 1C
CURL
Копировать

                
1C
Копировать

                
Пример ответа Ответ
200
Развернуть все Свернуть все
Пример Модель
{...}
"any-key":{...}
"Status":0,
"Message":"string",
"Error":"string",
"Reason":"string"
}
}
{...}
}
4XX Ошибка запроса. Подробнее про ошибки API
Развернуть все Свернуть все
Пример Модель
{...}
"Reason":"string",
"Error":"string"
}
{...}

Модель ошибки

Reason: string

Причина ошибки

Error: string

Ключ ошибки

}
Загрузка...
Развернуть все Свернуть все
Загрузка...

Методы для поиска грузов

Поиск грузов на площадках

В теле ответа находится массив грузов, которые опубликованы на выбранных площадках. В грузах будут указаны только те площадки, в которых дата публикации меньше текущей.
Если массив boardIds пуст, будут получены грузы со всех возможных площадок.

 
Проводит поиск грузов, которые размещены на указанных площадках. В результате присутствуют как ваши грузы, так и грузы других пользователей.
get
/v1.0/loads/search/byboards
boardIds
array
Добавить еще поле
Массив ID площадок
CURL 1C
CURL
Копировать

                
1C
Копировать

                
Пример ответа Ответ
200 Массив грузов, которые опубликованы на выбранных площадках
Развернуть все Свернуть все
Пример Модель
[...]
{...}
"LoadMeta":{...},
"LoadMetaId":"3fa85f64-5717-4562-b3fc-2c963f66afa6",
"MetaData":"string"
},
"ContactId1":0,
"ContactId2":0,
"Note":"string",
"FirstDate":"1970-01-01T00:00:00.000Z",
"LastDate":"1970-01-01T00:00:00.000Z",
"DateType":0,
"PeriodicityId":0,
"OrderNumber":"string",
"Krugoreis":false,
"Loading":{...},
"CityId":0,
"Latitude":0.5,
"Longitude":0.5,
"Street":"string",
"TimeStart":"1970-01-01T00:00:00.000Z",
"TimeEnd":"1970-01-01T00:00:00.000Z",
"IsRoundTheClock":false,
"LargeCities":[...],
0
],
"LoadingCargos":[...]
{...}
"CargoId":0,
"NameId":0,
"Name":"string",
"PackagingType":0,
"PackagingQuantity":0,
"Weight":0.5,
"Volume":0.5,
"Sizes":{...}
"Length":0.5,
"Width":0.5,
"Height":0.5,
"Diameter":0.5,
"LengthHighlight":false,
"WidthHighlight":false,
"HeightHighlight":false
}
}
]
},
"ExtraPoints":[...],
{...}
"CityId":0,
"PointType":0,
"Latitude":0.5,
"Longitude":0.5,
"Street":"string",
"OrdinalId":0,
"IsRoundTheClock":false,
"LoadingDateStart":"1970-01-01T00:00:00.000Z",
"LoadingDateEnd":"1970-01-01T00:00:00.000Z",
"LoadingTimeStart":null,
"LoadingTimeEnd":null,
"LoadingCargos":[...],
{...}
"CargoId":0,
"NameId":0,
"Name":"string",
"PackagingType":0,
"PackagingQuantity":0,
"Weight":0.5,
"Volume":0.5,
"Sizes":{...}
"Length":0.5,
"Width":0.5,
"Height":0.5,
"Diameter":0.5,
"LengthHighlight":false,
"WidthHighlight":false,
"HeightHighlight":false
}
}
],
"UnloadingCargos":[...]
{...}
"CargoId":0,
"Weight":0.5,
"Volume":0.5,
"PackagingQuantity":0,
"IsDefinedByTtn":false
}
]
}
],
"Unloading":{...},
"CityId":0,
"Latitude":0.5,
"Longitude":0.5,
"Street":"string",
"TimeStart":"1970-01-01T00:00:00.000Z",
"TimeEnd":"1970-01-01T00:00:00.000Z",
"IsRoundTheClock":false,
"LargeCities":[...],
0
],
"LoadingCargos":[...]
{...}
"CargoId":0,
"NameId":0,
"Name":"string",
"PackagingType":0,
"PackagingQuantity":0,
"Weight":0.5,
"Volume":0.5,
"Sizes":{...}
"Length":0.5,
"Width":0.5,
"Height":0.5,
"Diameter":0.5,
"LengthHighlight":false,
"WidthHighlight":false,
"HeightHighlight":false
}
}
]
},
"Cargo":{...},
"Weight":0.5,
"Volume":0.5,
"ADR":0,
"CargoTypeId":0,
"CargoType":"string",
"PackType":0,
"PalletCount":0,
"BeltCount":0,
"DogruzType":0,
"SborGruz":false,
"Size":{...}
"Length":0.5,
"Width":0.5,
"Height":0.5,
"Diameter":0.5,
"LengthHighlight":false,
"WidthHighlight":false,
"HeightHighlight":false
}
},
"Transport":{...},
"CarType":0,
"LoadingType":0,
"LoadingLogicalOperator":"string",
"UnloadingType":0,
"UnloadingLogicalOperator":"string",
"TrucksQuantity":0,
"TemperatureFrom":0,
"TemperatureTo":0,
"Stsepka":false,
"Pnevmohod":false,
"Koniki":false,
"TIR":false,
"CMR":false,
"T1":false,
"SanPassport":false,
"IsTracking":false
},
"Payment":{...},
"CurrencyId":0,
"MoneyType":0,
"RateSum":0.5,
"SumWithNDS":0.5,
"SumWithoutNDS":0.5,
"PrepayPercent":0,
"PrepayPercentEnabled":false,
"PayDays":0,
"PayDaysEnabled":false,
"FixedRate":false,
"Torg":false,
"DirectContract":false,
"InFuel":false,
"OnUnloading":false,
"HideResponses":false,
"AcceptPaymentTypes":0
},
"InviteSettings":{...},
"InviteDelayInSeconds":0,
"InviteDurationInSeconds":0
},
"PriorityView":{...},
"DailyLimit":0.5,
"IsForPayedOnly":false,
"OrderLimit":0.5,
"ViewRate":0.5,
"MoneySpentPerDay":0.5,
"MoneySpentPerOrder":0.5
},
"Stealth":{...},
"ListIdToHide":"3fa85f64-5717-4562-b3fc-2c963f66afa6",
"FirmRegDateToHide":"1970-01-01T00:00:00.000Z",
"ScoreToHide":0.5
},
"LoadFiles":[...],
{...}
"Id":"3fa85f64-5717-4562-b3fc-2c963f66afa6",
"FileType":0,
"Attributes":0,
"Name":"string",
"Link":"string",
"Size":0
}
],
"Deal":{...},
"Auction":{...}
"StartRate":0.5,
"Currency":0,
"Step":0.5,
"PaymentType":0,
"AcceptSecondPayType":false,
"StartDate":"1970-01-01T00:00:00.000Z",
"EndDate":"1970-01-01T00:00:00.000Z",
"EndDateBoundary":"1970-01-01T00:00:00.000Z",
"Nds":0.5,
"TimeToProvideDocuments":0.5,
"AutoRenew":false,
"RenewTime":0,
"MaxRenewTime":0,
"RaiseBid":false,
"MaxRate":0.5,
"RaiseBidInterval":0,
"ResponseInMinutes":0,
"Duration":0,
"StartSinceFirstBet":false,
"AuctionRestartParameters":{...},
"AuctionFinishAction":0,
"InitRestartCount":0,
"InitChangeWinnerCount":0,
"DurationAfterRestart":0
},
"AcceptCounterOffersOnlyBeforeFirstBet":false,
"WinnerCriterion":0,
"AuctionId":"3fa85f64-5717-4562-b3fc-2c963f66afa6",
"LoadId":"3fa85f64-5717-4562-b3fc-2c963f66afa6",
"ActiveDealId":"3fa85f64-5717-4562-b3fc-2c963f66afa6",
"State":0,
"Finished":false,
"WinDate":"1970-01-01T00:00:00.000Z",
"AuctionRates":[...]
{...}
"AuctionRateId":"3fa85f64-5717-4562-b3fc-2c963f66afa6",
"AddedAt":"1970-01-01T00:00:00.000Z",
"RateFirm":{...},
"Score":0.5,
"Status":0,
"Name":"string",
"ContactName":"string",
"AtiId":"string"
},
"Rate":0.5,
"State":0,
"LoadingDate":"1970-01-01T00:00:00.000Z",
"FirmId":0,
"ContactId":0
}
]
}
},
"Boards":[...],
{...}
"BoardId":"string",
"PublicationTime":"1970-01-01T00:00:00.000Z",
"IsReservationEnabled":false,
"PublicationOption":0,
"IsPublished":false,
"IsCommonBoard":false
}
],
"UnloadFirstDate":"1970-01-01T00:00:00.000Z",
"UnloadLastDate":"1970-01-01T00:00:00.000Z",
"ArchiveDate":"1970-01-01T00:00:00.000Z",
"ArchiveReason":"Unknown",
"TruePrice":0,
"TrueCurrencyId":0,
"ResponseCount":0,
"OfferCount":0,
"CanBeDeleted":false,
"HasPermissionsToLoad":false,
"CanBeEdited":false,
"CanBeRenewed":false,
"CanBeRestored":false,
"EditRestriction":0,
"DeleteRestriction":0,
"RestoreRestriction":0,
"RenewRestriction":"string",
"Id":"3fa85f64-5717-4562-b3fc-2c963f66afa6",
"LoadNumber":"string",
"UpdatedAt":"1970-01-01T00:00:00.000Z",
"AddedAt":"1970-01-01T00:00:00.000Z",
"Distance":0,
"PlatonRoadsLength":0,
"TollRoadsLength":0,
"TravelTime":"?",
"Zimnik":false,
"Ferries":false,
"FirmId":"string",
"AuctionId":"3fa85f64-5717-4562-b3fc-2c963f66afa6"
}
]
[{...}]
ContactId1*: int32

Идентификатор первого выбранного контакта.
Список всех контактов и их идентификаторы можно получить с помощью API для работы с фирмами
Контакт должен быть виден для остальных участников АТИ

ContactId2: int32 (nullable)

Идентификатор второго выбранного контакта, если не выбрано, то null
Контакт должен быть виден для остальных участников АТИ

Note: string

Примечание к грузу
Ограничение по длине: 1000 символов

FirstDate: date-time

Дата, начиная с которой груз актуален, в формате UTC
Минимальное значение равно текущей дате
При значении параметра DateType равным 0, допустимое значение поля - текущая дата
При значении параметра DateType равным 1, допустимое значение поля - от текущей даты до 60 дней вперед
При значении параметра DateType равным 2, допустимое значение поля - текущая дата
При значении параметра DateType равным 3, FirstDate должен принимать значение текущей даты или отсутствовать

LastDate: date-time

Дата, после которой груз не актуален, в формате UTC
Минимальное значение равно значению параметра FirstDate
При значении параметра DateType равным 0, допустимое значение поля - от текущей даты до 1 дня вперед
При значении параметра DateType равным 1, допустимое значение поля - от даты в параметре FirstDate до 9 дней вперед
При значении параметра DateType равным 2, данное поле вычисляется автоматически по формуле FirstDate + 2 месяца, передаваемое значение игнорируется
При значении параметра DateType равным 3, LastDate автоматически устанавливается на значение + 2 дня от текущей даты, передаваемое значение игнорируется

DateType: int32

Выбор типа готовности груза к перевозке

  • 0 - Готов к загрузке
  • 1 - с Х по У
  • 2 - постоянно
  • 3 - груза нет, запрос ставки
PeriodicityId: int32

Периодичность загрузки
Если параметр DateType не равен 2, PeriodicityId равен 0.
Иначе PeriodicityId может принимать следующие значения:

  • 1 - ежедневно
  • 100 - по рабочим дням
OrderNumber: string

Номер заказа
Ограничение по длине: 250 символов

Krugoreis: boolean

Параметр, который определяет, включен ли кругорейс для перевозки груза

UnloadFirstDate: date-time (nullable)

Дата начала разгрузки, в формате UTC.
Может иметь значение null.
Минимальное значение равно текущей дате.
При значении параметра DateType равным 3, UnloadFirstDate принимает значение null

UnloadLastDate: date-time (nullable)

Дата окончания разгрузки, в формате UTC. Может иметь значение null.
Если нет даты начала разгрузки UnloadFirstDate, должна отсутствовать дата окончания разгрузки UnloadLastDate.
При значении параметра DateType равным 3, UnloadFirstDate принимает значение null

ArchiveDate: date-time (nullable)

Дата и время переноса в архив

ArchiveReason: enum (nullable)
[Unknown, System, Manual, Complaints, UnwantedContent, DeleteCsvLoad, MergeLoadsAfterEdit, ContactDoesNotHaveAccessToVirtualPayments, VerticesLoadDelete, StealthStatisticError, CheckDuplicateComplaints, DeleteContact, DeleteFirm, CleanOldLoadsJob]

Причина переноса в архив

TruePrice: int32

Озвученная ставка

TrueCurrencyId: int32

ID валюты озвученной ставки

ResponseCount: int32

Количество отзывов о грузе (без встречных предложений)

OfferCount: int32

Количество встречных предложений (остальные отзывы не учитываются)

CanBeDeleted: boolean

Есть ли доступ на удаление груза.

HasPermissionsToLoad: boolean

Есть ли доступ на работу с грузом (без учета прав).

CanBeEdited: boolean

Есть ли доступ на редактирование груза.

CanBeRenewed: boolean

Есть ли доступ на обновление груза.

CanBeRestored: boolean

Есть ли доступ на восстановление груза

EditRestriction: enum
[0, 1, 2, 3, 4, 5, 6, 7, 8, 9, 10, 11, 12, 13, 14, 15]

Причины отказа в доступе на редактирование груза:

  • 0 - Вы имеете доступ к работе с грузом
  • 1 - Ваша фирма больше не может размещать грузы из-за нарушения правил АТИ
  • 2 - Груз зарезервирован/взят, операции с грузом запрещены
  • 3 - Превышен лимит актуальных грузов
  • 4 - Вы пытаетесь работать с грузами под общим пользователем. Недостаточно прав
  • 5 - У вашего контакта недостаточно прав для работы с данным грузом
  • 6 - Груз имеет завершенные Торги, операции с грузом запрещены
  • 7 - Сервис сделок временно недоступен
  • 8 - Нельзя изменять или удалять груз из сквозных торгов
  • 9 - У вашего контакта недостаточно прав для создания грузов
  • 10 - У вашего контакта недостаточно прав для работы с виртуальными кошельками
  • 11 - У вашего контакта недостаточно прав для работы с грузами на Общей площадке
  • 12 - У вашего контакта недостаточно прав для работы с грузами на Персональных площадках
  • 13 - У вашего контакта нет доступа для работы с одной или несколькими персональными площадками, указанными в грузе
  • 14 - У вашего контакта нет доступа для работы с подразделением, в которое восстанавливается груз
  • 15 - Ваш контакт должен быть указан первым в грузе
DeleteRestriction: enum
[0, 1, 2, 3, 4, 5, 6, 7, 8, 9, 10, 11, 12, 13, 14, 15]

Причины отказа в доступе на удаление контакта:

  • 0 - Вы имеете доступ к работе с грузом
  • 1 - Ваша фирма больше не может размещать грузы из-за нарушения правил АТИ
  • 2 - Груз зарезервирован/взят, операции с грузом запрещены
  • 3 - Превышен лимит актуальных грузов
  • 4 - Вы пытаетесь работать с грузами под общим пользователем. Недостаточно прав
  • 5 - У вашего контакта недостаточно прав для работы с данным грузом
  • 6 - Груз имеет завершенные Торги, операции с грузом запрещены
  • 7 - Сервис сделок временно недоступен
  • 8 - Нельзя изменять или удалять груз из сквозных торгов
  • 9 - У вашего контакта недостаточно прав для создания грузов
  • 10 - У вашего контакта недостаточно прав для работы с виртуальными кошельками
  • 11 - У вашего контакта недостаточно прав для работы с грузами на Общей площадке
  • 12 - У вашего контакта недостаточно прав для работы с грузами на Персональных площадках
  • 13 - У вашего контакта нет доступа для работы с одной или несколькими персональными площадками, указанными в грузе
  • 14 - У вашего контакта нет доступа для работы с подразделением, в которое восстанавливается груз
  • 15 - Ваш контакт должен быть указан первым в грузе
RestoreRestriction: enum
[0, 1, 2, 3, 4, 5, 6, 7, 8, 9, 10, 11, 12, 13, 14, 15]

Причины отказа в доступе на восстановление груза:

  • 0 - Вы имеете доступ к работе с грузом
  • 1 - Ваша фирма больше не может размещать грузы из-за нарушения правил АТИ
  • 2 - Груз зарезервирован/взят, операции с грузом запрещены
  • 3 - Превышен лимит актуальных грузов
  • 4 - Вы пытаетесь работать с грузами под общим пользователем. Недостаточно прав
  • 5 - У вашего контакта недостаточно прав для работы с данным грузом
  • 6 - Груз имеет завершенные Торги, операции с грузом запрещены
  • 7 - Сервис сделок временно недоступен
  • 8 - Нельзя изменять или удалять груз из сквозных торгов
  • 9 - У вашего контакта недостаточно прав для создания грузов
  • 10 - У вашего контакта недостаточно прав для работы с виртуальными кошельками
  • 11 - У вашего контакта недостаточно прав для работы с грузами на Общей площадке
  • 12 - У вашего контакта недостаточно прав для работы с грузами на Персональных площадках
  • 13 - У вашего контакта нет доступа для работы с одной или несколькими персональными площадками, указанными в грузе
  • 14 - У вашего контакта нет доступа для работы с подразделением, в которое восстанавливается груз
  • 15 - Ваш контакт должен быть указан первым в грузе
RenewRestriction: string

Причина отказа в доступе на обновление груза.

Id: guid

Идентификатор груза

LoadNumber: string

Номер груза

UpdatedAt: date-time

Дата последнего изменения груза в формате UTC

AddedAt: date-time

Время добавления груза в формате UTC

Distance: int32

Расстояние по дорогам в км

PlatonRoadsLength: int32

Протяженность дорог в км, в построенном пути за которые взимается плата по системе Платон

TollRoadsLength: int32

Протяженность платных дорог в построенном пути в км

TravelTime: time-span

Время в пути

Zimnik: boolean

Параметр, который определяет, включен ли зимник для перевозки груза

Ferries: boolean

Параметр, который определяет, учитывать ли паромные переправы для перевозки груза

FirmId: string

Идентификатор фирмы

AuctionId: guid (nullable)

Id аукциона

}]
4XX Ошибка запроса. Подробнее про ошибки API
Развернуть все Свернуть все
Пример Модель
{...}
"Reason":"string",
"Error":"string"
}
{...}

Модель ошибки

Reason: string

Причина ошибки

Error: string

Ключ ошибки

}
Загрузка...
Развернуть все Свернуть все
Загрузка...

Методы для добавления документа к грузу

Создание документа в АТИ-Доках на груз

Данный метод позволяет создавать следующие типы документов:

  • заказ
  • заказ (табличный вид)
  • заявка (к договору)
  • заявка к договору (табличный вид)
  • поручение экспедитору

Тип создаваемого документа должен быть передан в documentType в том же виде, как он указан выше.

 
Позволяет создавать документ заданного типа в АТИ-Доках на груз с заданным id.
post
/v1.0/loads/{loadId}/atidocs/{documentType}
CURL 1C
CURL
Копировать

                
1C
Копировать

                
Пример ответа Ответ
200 Статус
Развернуть все Свернуть все
Пример Модель
{...}
"Id":"string",
"Url":"string"
}
{...}
Id: string

Id документа

Url: string

Ссылка на документ

}
4XX Ошибка запроса. Подробнее про ошибки API
Развернуть все Свернуть все
Пример Модель
{...}
"Reason":"string",
"Error":"string"
}
{...}

Модель ошибки

Reason: string

Причина ошибки

Error: string

Ключ ошибки

}
Загрузка...
Развернуть все Свернуть все
Загрузка...