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

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

Описание

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

Структура URL

1
POST /v2/proposals/my/add/cargo

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

Название Описание Тип передачи параметра Обязат.(+)/По умолч.(значение)
contactId Идентификатор подчиненного контакта пользователя. Query string parameter 0
publishDate Дата публикации заявки, timestamp. Query string parameter
dateFrom Дата загрузки, "yyyy-MM-dd". Query string parameter +
dateTo Дата выгрузки, "yyyy-MM-dd". Query string parameter
paymentPrice Цена доставки. Query string parameter
paymentCurrencyId Идентификатор валюты из Справочника. Query string parameter
paymentUnitId Идентификатор единицы оплаты из Справочника. Query string parameter
paymentTypeId Идентификатор типа оплаты из Справочника. Query string parameter
paymentMomentId Идентификатор момента оплаты из Справочника. Query string parameter
paymentPrepay Процент предоплаты от общей стоимости. Query string parameter
paymentDelay Отсрочка платежа, дни. Query string parameter
paymentVat Наличие НДС. Query string parameter false
bodyTypeId Идентификатор типа транспортного средства из Справочника. Query string parameter
bodyGroupId Идентификатор группы типов транспортного средства из Справочника. Query string parameter
refrigeratorRegime Наличие температурного режима. Query string parameter false
refrigeratorRegimeFrom Нижняя граница температурного режима. Query string parameter
refrigeratorRegimeTo Верхняя граница температурного режима. Query string parameter
loadTypes Массив идентификаторов типов загрузки из Справочника. Query string parameter
unloadTypes Массив идентификаторов типов выгрузки из Справочника. Query string parameter
adr Класс ADR. Query string parameter
cmr Наличие транспортной накладной CMR. Query string parameter false
cmrInsurance Наличие страхового полиса CMR. Query string parameter false
groupage Возможность догруза. Query string parameter false
t1 Наличие документа таможенного транзита T1. Query string parameter false
tir Наличие документа таможенного транзита TIR. Query string parameter false
lorryAmount Необходимое количество транспорта. Query string parameter
note Примечание. Query string parameter
contentName Произвольное название груза. Используйте этот параметр, если не можете определить или получить contentId. Один из двух параметров: contentName, contentId - должен быть указан. Query string parameter
contentId Наименование груза из Справочника. Один из двух параметров: contentName, contentId - должен быть указан. Query string parameter
medicalRecords Наличие медицинской книжки. Query string parameter false
customsControl Находится ли груз под таможенным контролем. Query string parameter false
loadingFrequencyId Идентификатор частоты отгрузки из Справочника. Query string parameter
sizeMassFrom Нижняя граница массы груза, т. Один из двух параметров: sizeMassFrom, sizeMassTo - должен быть указан. Query string parameter
sizeMassTo Верхняя граница массы груза, т. Один из двух параметров: sizeMassFrom, sizeMassTo - должен быть указан. Query string parameter
sizeVolumeFrom Нижняя граница объема груза, м3. Query string parameter
sizeVolumeTo Верхняя граница объема груза, м3. Query string parameter
sizeLength Длина груза, м. Query string parameter
sizeWidth Ширина груза, м. Query string parameter
sizeHeight Высота груза, м. Query string 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
curl -X POST -H "Accept: application/json" -H "Content-Type: application/json" -H "Authorization: 3WQ1EQ465C4005000130" \
"https://api.lardi-trans.com/v2/proposals/my/add/cargo?\
dateFrom=2020-11-27\
&dateTo=2020-11-30\
&contentId=18\
&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%20useful%20note\
&paymentPrice=1000\
&paymentCurrencyId=2\
&paymentUnitId=2\
&paymentTypeId=8\
&paymentMomentId=4\
&paymentPrepay=10\
&paymentDelay=5\
&paymentVat=true\
&medicalRecords=true\
&customsControl=true\
&sizeMassFrom=24\
&sizeMassTo=36\
&sizeVolumeFrom=30\
&sizeVolumeTo=40\
&sizeLength=10.1\
&sizeWidth=2.5\
&sizeHeight=3\
" -d '{
    "waypointListSource": [
        {
            "address": "уточнение адреса",
            "countrySign": "UA",
            "areaId": 23,
            "townId": 137
        }
    ],
    "waypointListTarget": [
        {
            "address": "уточнение адреса",
            "countrySign": "UA",
            "areaId": 34,
            "townId": 69
        }
    ]
}'

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

1
2
3
{
    "id": 298243420
}