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

Опис

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

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