Редагування заявки з вантажу
Опис
За допомогою цього методу можна відредагувати заявку з вантажу.
Структура URL
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 | |
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 | |
cargoBodyTypeIds |
Масив ідентифікаторів типів транспортного засобу з Довідника. | Request body parameter | |
cargoPackaging[].id |
Ідентифікатор типу пакування з Довідника. | Request body parameter | |
cargoPackaging[].count |
Кількість пакування. | 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 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 | |
sizeMass |
Маса вантажу, т. | Request body parameter | + |
sizeVolume |
Об'єм вантажу, м3. | Request body parameter | |
sizeLength |
Довжина вантажу, м. | Request body parameter | |
sizeWidth |
Ширина вантажу, м. | Request body parameter | |
sizeHeight |
Висота вантажу, м. | Request body parameter | |
waypointListSource |
Точки завантаження, масив Структур "Точка завантаження в запитах". | Request body parameter | |
waypointListTarget |
Точки вивантаження, масив Структур "Точка завантаження в запитах". | Request body parameter | |
cargoBodyTypeProperties |
Характеристики кузову, перелічуваний тип. DOUBLE_DECK, JUMBO, MEGA | 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/cargo/published/350203659" \
-d '{
"cargoBodyTypeIds": [
69,
28,
30,
63
],
"loadTypes": [
24,
25
],
"paymentForms": [
{
"id": 10,
"vat": true
}
],
"cargoPackaging": [
{
"id": 10,
"count": 12
}
],
"note": "",
"cmr": false,
"sizeMass": 19,
"waypointListSource": [
{
"address": "уточнение адреса",
"countrySign": "UA",
"areaId": 23,
"townId": 137
}
],
"waypointListTarget": [
{
"address": "уточнение адреса",
"countrySign": "UA",
"areaId": 34,
"townId": 69
}
],
"cargoBodyTypeProperties": [
"MEGA", "JUMBO"
]
}'
Зразок відповіді
{
"result": "OK"
}