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

Описание

С помощью этого метода можно создать новую заявку по транспорту.

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