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

Створення заявки з транспорту

Опис

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

Структура URL

POST /v2/proposals/my/add/lorry

Список параметрів

Назва Опис Тип передачі параметра Обов'яз.(+)/За замовч.(значення)
language Мова локалізації. Опис використання. Query string parameter ru
contactId Ідентифікатор підлеглого контакту користувача. Request body parameter
publishDate Дата публікації заявки, timestamp. Якщо вказано, то заявка створюється зі статусом prepared і переводиться в published у вказаний момент часу. До цього моменту параметр може бути змінено. 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 POST -H "Accept: application/json" -H "Content-Type: application/json" -H "Authorization: 3WQ1EQ465C4005000130" \
"https://api.lardi-trans.com/v2/proposals/my/add/lorry" \
-d '{
    "dateFrom": "2021-08-27",
    "dateTo": "2021-08-30",
    "transBodyTypeId": 63,
    "bodyGroupId": 2,
    "loadTypes": [
        24,
        25,
        26,
        27
    ],
    "paymentForms": [
        {
            "id": 10,
            "vat": true
        }
    ],
    "adr": 3,
    "cmr": true,
    "cmrInsurance": true,
    "groupage": true,
    "t1": true,
    "tir": true,
    "lorryAmount": 2,
    "note": "some useful note",
    "paymentPrice": 1000,
    "paymentCurrencyId": 2,
    "paymentUnitId": 2,
    "paymentMomentId": 4,
    "paymentPrepay": 10,
    "paymentDelay": 5,
    "ekmt": true,
    "trailer": true,
    "sizeBodyMass": 20,
    "sizeBodyVolume": 40,
    "sizeBodyLength": 8,
    "sizeBodyWidth": 2.5,
    "sizeBodyHeight": 3,
    "sizeTrailerMass": 15,
    "sizeTrailerVolume": 32,
    "sizeTrailerLength": 8,
    "sizeTrailerWidth": 2.5,
    "sizeTrailerHeight": 3,
    "waypointListSource": [
        {
            "address": "уточнение адреса",
            "countrySign": "UA",
            "areaId": 23,
            "townId": 137
        }
    ],
    "waypointListTarget": [
        {
            "address": "уточнение адреса",
            "countrySign": "UA",
            "areaId": 34,
            "townId": 69
        }
    ],
    "transBodyTypeProperties": [
        "MEGA", "JUMBO"
    ],
    "transBodyTypeCategory": 5        
}'

Зразок відповіді

{
    "id": 298243420
}