Редагування заявки з транспорту
Опис
За допомогою цього методу можна відредагувати заявку з транспорту.
Структура 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 |
ЄKMT. | 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"
}