Редактирование заявки по грузу
Описание
С помощью этого метода можно отредактировать заявку по грузу.
Структура URL
1 | PUT /v2/proposals/my/cargo/{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 | |
paymentPrice |
Цена доставки. | Request body parameter | |
paymentCurrencyId |
Идентификатор валюты из Справочника. | Request body parameter | |
paymentUnitId |
Идентификатор единицы оплаты из Справочника. | Request body parameter | |
paymentTypeId |
Идентификатор типа оплаты из Справочника. | Request body parameter | |
paymentMomentId |
Идентификатор момента оплаты из Справочника. | Request body parameter | |
paymentPrepay |
Процент предоплаты от общей стоимости. | Request body parameter | |
paymentDelay |
Отсрочка платежа, дни. | Request body parameter | |
paymentVat |
Наличие НДС. | Request body parameter | |
bodyTypeId |
Идентификатор типа транспортного средства из Справочника. | Request body parameter | |
bodyGroupId |
Идентификатор группы типов транспортного средства из Справочника. | Request body parameter | |
refrigeratorRegime |
Наличие температурного режима. | Request body parameter | |
refrigeratorRegimeFrom |
Нижняя граница температурного режима. | Request body parameter | |
refrigeratorRegimeTo |
Верхняя граница температурного режима. | Request body parameter | |
loadTypes |
Массив идентификаторов типов загрузки из Справочника. | Request body parameter | |
unloadTypes |
Массив идентификаторов типов выгрузки из Справочника. | 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 | |
contentName |
Произвольное название груза. Используйте этот параметр, если не можете определить или получить contentId . Один из двух параметров: contentName , contentId - должен быть указан. |
Request body parameter | |
contentId |
Наименование груза из Справочника. Один из двух параметров: contentName , contentId - должен быть указан. |
Request body parameter | |
medicalRecords |
Наличие медицинской книжки. | Request body parameter | |
customsControl |
Находится ли груз под таможенным контролем. | Request body parameter | |
loadingFrequencyId |
Идентификатор частоты отгрузки из Справочника. | Request body parameter | |
sizeMassFrom |
Нижняя граница массы груза, т. Один из двух параметров: sizeMassFrom , sizeMassTo - должен быть указан. |
Request body parameter | |
sizeMassTo |
Верхняя граница массы груза, т. Один из двух параметров: sizeMassFrom , sizeMassTo - должен быть указан. |
Request body parameter | |
sizeVolumeFrom |
Нижняя граница объема груза, м3. | Request body parameter | |
sizeVolumeTo |
Верхняя граница объема груза, м3. | Request body parameter | |
sizeLength |
Длина груза, м. | Request body parameter | |
sizeWidth |
Ширина груза, м. | Request body parameter | |
sizeHeight |
Высота груза, м. | Request body parameter | |
waypointListSource |
Точки загрузки, массив Структур "Точка загрузки в запросах". | Request body parameter | |
waypointListTarget |
Точки выгрузки, массив Структур "Точка загрузки в запросах". | Request body parameter |
Примечание:
Если не нужно изменять какой-либо параметр заявки, не включайте его в запрос;
Результаты
Успешный результат
Структура "Успешный результат редактирования заявки".
Результаты с ошибками
Ошибка валидации
Структура "Ошибка валидации заявки".
Ошибка с кодом
Пример запроса
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 29 | curl -X PUT -H "Accept: application/json" -H "Content-Type: application/json" -H "Authorization: 3WQ1EQ465C4005000130" \ "https://api.lardi-trans.com/v2/proposals/my/cargo/published/350203659" \ -d '{ "loadTypes": [ 24, 25 ], "unloadTypes": [], "note": "", "cmr": false, "sizeMassFrom": 19, "sizeMassTo": 0, "waypointListSource": [ { "address": "уточнение адреса", "countrySign": "UA", "areaId": 23, "townId": 137 } ], "waypointListTarget": [ { "address": "уточнение адреса", "countrySign": "UA", "areaId": 34, "townId": 69 } ] }' |
Пример ответа
1 2 3 | { "result": "OK" } |