Перейти к содержанию

Редактирование заявки по транспорту

Описание

С помощью этого метода можно отредактировать заявку по транспорту.

Структура URL

1
PUT /v2/proposals/my/lorry/{status}/{id}

Список параметров

Название Описание Тип передачи параметра Обязат.(+)/По умолч.(значение)
status Перечисление "Статусы заявки". Path parameter +
id Идентификатор заявки. Path parameter +
publishDate Дата публикации заявки, timestamp. Если параметр status не будет иметь значения "prepared", значение publishDate будет проигнорировано. Query string parameter
contactId Идентификатор подчиненного контакта пользователя. Query string parameter
dateFrom Дата загрузки, "yyyy-MM-dd". Query string parameter
dateTo Дата выгрузки, "yyyy-MM-dd". Query string parameter
paymentPrice Цена доставки. Query string parameter
paymentCurrencyId Идентификатор валюты из Справочника. Query string parameter
paymentUnitId Идентификатор единицы оплаты из Справочника. Query string parameter
paymentTypeId Идентификатор типа оплаты из Справочника. Query string parameter
paymentMomentId Идентификатор момента оплаты из Справочника. Query string parameter
paymentPrepay Процент предоплаты от общей стоимости. Query string parameter
paymentDelay Отсрочка платежа, дни. Query string parameter
paymentVat Наличие НДС. Query string parameter
bodyTypeId Идентификатор типа транспортного средства из Справочника. Query string parameter
bodyGroupId Идентификатор группы типов транспортного средства из Справочника. Query string parameter
refrigeratorRegime Наличие температурного режима. Query string parameter
refrigeratorRegimeFrom Нижняя граница температурного режима. Query string parameter
refrigeratorRegimeTo Верхняя граница температурного режима. Query string parameter
loadTypes Массив идентификаторов типов загрузки из Справочника. Query string parameter
unloadTypes Массив идентификаторов типов выгрузки из Справочника. Query string parameter
adr Класс ADR. Query string parameter
cmr Наличие транспортной накладной CMR. Query string parameter
cmrInsurance Наличие страхового полиса CMR. Query string parameter
groupage Возможность догруза. Query string parameter
t1 Наличие документа таможенного транзита T1. Query string parameter
tir Наличие документа таможенного транзита TIR. Query string parameter
lorryAmount Необходимое количество транспорта. Query string parameter
note Примечание. Query string parameter
autoparkId Идентификатор одного из объектов автопарка, который пользователь хочет связать с этой заявкой. Если указан этот параметр, то следующие параметры заявки будут взяты из соотв. объекта автопарка: bodyTypeId, bodyGroupId, loadTypes, adr, cmr, t1, tir ekmt, trailer, а также все параметры, начинающиеся с size-. Query string parameter
ekmt EKMT. Query string parameter
trailer Индикатор наличия прицепа. Если вы хотите указать какие-либо параметры прицепа (начинаются с sizeTrailer-), укажите этот параметр. Query string parameter
sizeBodyMass Грузоподъемность кузова. Query string parameter
sizeBodyVolume Объем кузова. Query string parameter
sizeBodyLength Длина кузова. Query string parameter
sizeBodyWidth Ширина кузова. Query string parameter
sizeBodyHeight Высота кузова. Query string parameter
sizeTrailerMass Грузоподъемность прицепа. Query string parameter
sizeTrailerVolume Объем прицепа. Query string parameter
sizeTrailerLength Длина прицепа. Query string parameter
sizeTrailerWidth Ширина прицепа. Query string parameter
sizeTrailerHeight Высота прицепа. Query string parameter
waypointListSource Точки загрузки, массив Структур "Точка загрузки в запросах". Массив не может быть пустым. Request body parameter
waypointListTarget Точки выгрузки, массив Структур "Точка загрузки в запросах". Массив не может быть пустым. Request body parameter

Примечания:

  • Если не нужно изменять какой-либо параметр заявки, не включайте его в запрос;
  • Если нужно очистить числовое значение, передайте 0 в качестве значения параметра;
  • Если нужно очистить строковое значение или массив (например loadTypes), передайте этот параметр с пустой строкой в качестве значения (например, &note=&loadTypes=).

Результаты

Успешный результат

Структура "Успешный результат редактирования заявки".

Результаты с ошибками

Ошибка валидации

Структура "Ошибка валидации заявки".

Ошибка с кодом

Структура "Ошибка с кодом"

Пример запроса

BASH
 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
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?\
dateFrom=2020-11-27\
&dateTo=2020-11-30\
&loadTypes=24,25\
&unloadTypes=\
&note=\
&cmr=false\
&sizeBodyMass=19\
&sizeBodyVolume=0\
" -d '{
    "waypointListSource": [
        {
            "address": "уточнение адреса",
            "countrySign": "UA",
            "areaId": 23,
            "townId": 137
        }
    ],
    "waypointListTarget": [
        {
            "address": "уточнение адреса",
            "countrySign": "UA",
            "areaId": 34,
            "townId": 69
        }
    ]
}'

Пример ответа

1
2
3
{
    "result": "OK"
}