Редактирование заявки по транспорту
Описание
С помощью этого метода можно отредактировать заявку по транспорту.
Структура URL
PUT /v2/proposals/my/lorry/{status}/{id}
Список параметров
Название | Описание | Тип передачи параметра | Обязат.(+)/По умолч.(значение) |
---|---|---|---|
language |
Язык локализации. Описание использования. | Query string parameter | ru |
status |
Перечисление "Статусы заявки". Статус уточняет идентификатор. Например, если заявка опубликована, то какой-либо другой статус вернет ошибку "Не найдено". | Path parameter | + |
id |
Идентификатор заявки. | Path parameter | + |
publishDate |
Дата публикации заявки, timestamp. Если параметр status не будет иметь значения "prepared" , значение publishDate будет проигнорировано. |
Request body parameter | |
contactId |
Идентификатор подчиненного контакта пользователя. | Request body parameter | |
dateFrom |
Начальная дата загрузки, "yyyy-MM-dd". | Request body parameter | |
dateTo |
Конечная дата загрузки, "yyyy-MM-dd". | Request body parameter | |
paymentValue |
Цена доставки. | Request body parameter | + |
paymentCurrencyId |
Идентификатор валюты из Справочника. | Request body parameter | + |
paymentUnitId |
Идентификатор единицы оплаты из Справочника. | Request body parameter | |
paymentMomentId |
Идентификатор момента оплаты из Справочника. | Request body parameter | |
paymentPrepay |
Процент предоплаты от общей стоимости. | Request body parameter | |
paymentDelay |
Отсрочка платежа, дни. | Request body parameter | |
bodyGroupId |
Идентификатор группы типов транспортного средства из Справочника (устаревшее). | Request body parameter | |
transBodyTypeId |
Идентификатор типа транспортного средства из Справочника. | Request body parameter | |
paymentForms[].id |
Идентификатор типа оплаты из Справочника. | Request body parameter | |
paymentForms[].vat |
Наличие НДС. | Request body parameter | |
refrigeratorRegime |
Наличие температурного режима. | Request body parameter | |
refrigeratorRegimeFrom |
Нижняя граница температурного режима. | Request body parameter | |
refrigeratorRegimeTo |
Верхняя граница температурного режима. | Request body parameter | |
loadTypes |
Массив идентификаторов типов загрузки из Справочника. | Request body parameter | |
adr |
Класс ADR. | Request body parameter | |
cmr |
Наличие транспортной накладной CMR. | Request body parameter | |
cmrInsurance |
Наличие страхового полиса CMR. | Request body parameter | |
groupage |
Возможность догруза. | Request body parameter | |
t1 |
Наличие документа таможенного транзита T1. | Request body parameter | |
tir |
Наличие документа таможенного транзита TIR. | Request body parameter | |
lorryAmount |
Необходимое количество транспорта. | Request body parameter | |
note |
Примечание. | Request body parameter | |
autoparkId |
Идентификатор одного из объектов автопарка, который пользователь хочет связать с этой заявкой. Если указан этот параметр, то следующие параметры заявки будут взяты из соотв. объекта автопарка: bodyTypeId , bodyGroupId , loadTypes , adr , cmr , t1 , tir ekmt , trailer , а также все параметры, начинающиеся с size- . |
Request body parameter | |
ekmt |
EKMT. | Request body parameter | |
trailer |
Индикатор наличия прицепа. Если вы хотите указать какие-либо параметры прицепа (начинаются с sizeTrailer- ), укажите этот параметр. |
Request body parameter | |
sizeBodyMass |
Грузоподъемность кузова. | Request body parameter | |
sizeBodyVolume |
Объем кузова. | Request body parameter | |
sizeBodyLength |
Длина кузова. | Request body parameter | |
sizeBodyWidth |
Ширина кузова. | Request body parameter | |
sizeBodyHeight |
Высота кузова. | Request body parameter | |
sizeTrailerMass |
Грузоподъемность прицепа. | Request body parameter | |
sizeTrailerVolume |
Объем прицепа. | Request body parameter | |
sizeTrailerLength |
Длина прицепа. | Request body parameter | |
sizeTrailerWidth |
Ширина прицепа. | Request body parameter | |
sizeTrailerHeight |
Высота прицепа. | Request body parameter | |
waypointListSource |
Точки загрузки, массив Структур "Точка загрузки в запросах". | Request body parameter | |
waypointListTarget |
Точки выгрузки, массив Структур "Точка загрузки в запросах". | Request body parameter | |
transBodyTypeProperties |
Характеристики кузова, перечисляемый тип. DOUBLE_DECK, JUMBO, MEGA | Request body parameter | |
transBodyTypeCategory |
Идентификатор категории транспортного средства из Справочника. | Request body parameter |
Примечание:
Если не нужно изменять какой-либо параметр заявки, не включайте его в запрос;
Результаты
Успешный результат
Структура "Успешный результат".
Результаты с ошибками
Ошибка валидации
Структура "Ошибка валидации заявки".
Ошибка с кодом
Пример запроса
BASH
curl -X PUT -H "Accept: application/json" -H "Content-Type: application/json" -H "Authorization: 3WQ1EQ465C4005000130" \
"https://api.lardi-trans.com/v2/proposals/my/lorry/published/350203659" \
-d '{
"dateFrom": "2021-08-25",
"dateTo": "2021-08-27",
"loadTypes": [
24,
25
],
"paymentForms": [
{
"id": 10,
"vat": true
}
],
"note": "",
"cmr": false,
"sizeBodyMass": 19,
"sizeBodyVolume": 0,
"waypointListSource": [
{
"address": "уточнение адреса",
"countrySign": "UA",
"areaId": 23,
"townId": 137
}
],
"waypointListTarget": [
{
"address": "уточнение адреса",
"countrySign": "UA",
"areaId": 34,
"townId": 69
}
],
"transBodyTypeProperties": [
"MEGA", "JUMBO"
],
"transBodyTypeCategory": 5
}'
Пример ответа
{
"result": "OK"
}