Перейти к содержанию

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

Описание

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

Структура URL

1
POST /v2/proposals/my/add/lorry

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

Название Описание Тип передачи параметра Обязат.(+)/По умолч.(значение)
language Язык локализации. Описание использования. Query string parameter ru
contactId Идентификатор подчиненного контакта пользователя. Request body parameter
publishDate Дата публикации заявки, timestamp. Request body parameter
dateFrom Дата загрузки, "yyyy-MM-dd". Request body parameter +
dateTo Дата выгрузки, "yyyy-MM-dd". Request body parameter
paymentPrice Цена доставки. Request body parameter
paymentCurrencyId Идентификатор валюты из Справочника. Request body parameter
paymentUnitId Идентификатор единицы оплаты из Справочника. Request body parameter
paymentTypeId Идентификатор типа оплаты из Справочника. Request body parameter
paymentMomentId Идентификатор момента оплаты из Справочника. Request body parameter
paymentPrepay Процент предоплаты от общей стоимости. Request body parameter
paymentDelay Отсрочка платежа, дни. Request body parameter
paymentVat Наличие НДС. Request body parameter
bodyTypeId Идентификатор типа транспортного средства из Справочника. Request body parameter +
bodyGroupId Идентификатор группы типов транспортного средства из Справочника. Request body parameter
refrigeratorRegime Наличие температурного режима. Request body parameter
refrigeratorRegimeFrom Нижняя граница температурного режима. Request body parameter
refrigeratorRegimeTo Верхняя граница температурного режима. Request body parameter
loadTypes Массив идентификаторов типов загрузки из Справочника. Request body parameter
unloadTypes Массив идентификаторов типов выгрузки из Справочника. 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 +

Результаты

Успешный результат

Структура "Ответ с идентификатором".

Результаты с ошибками

Ошибка валидации

Структура "Ошибка валидации заявки".

Ошибка с кодом

Структура "Ошибка с кодом"

Пример запроса

BASH
 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
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",
    "bodyGroupId": 2,
    "bodyTypeId": 63,
    "loadTypes": [
        24,
        25
    ],
    "unloadTypes": [
        26,
        27
    ],
    "adr": 3,
    "cmr": true,
    "cmrInsurance": true,
    "groupage": true,
    "t1": true,
    "tir": true,
    "lorryAmount": 2,
    "note": "some useful note",
    "paymentPrice": 1000,
    "paymentCurrencyId": 2,
    "paymentUnitId": 2,
    "paymentTypeId": 8,
    "paymentMomentId": 4,
    "paymentPrepay": 10,
    "paymentDelay": 5,
    "paymentVat": true,
    "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
        }
    ]
}'

Пример ответа

1
2
3
{
    "id": 298243420
}