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

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

Описание

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

Структура 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"
}