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

Описание

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

Структура URL

POST /v2/proposals/my/add/cargo

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

Название	Описание	Тип передачи параметра	Обязат.(+)/По умолч.(значение)
language	Язык локализации. Описание использования.	Query string parameter	ru
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

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
        }
    ]
}'

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

{
    "id": 298243420
}