Перейти до змісту

Редагування заявки з вантажу

Опис

За допомогою цього методу можна відредагувати заявку з вантажу.

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