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

Описание

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

Структура URL

POST /v2/proposals/my/add/cargo

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

Название	Описание	Тип передачи параметра	Обязат.(+)/По умолч.(значение)
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
paymentPrice	Цена доставки (устаревшее).	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
cargoBodyTypeIds	Массив идентификаторов типов транспортного средства из Справочника.	Request body parameter	+
cargoPackaging[].id	Идентификатор типа упаковки из Справочника.	Request body parameter
cargoPackaging[].count	Количество упаковки.	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
contentName	Произвольное название груза. Используйте этот параметр, если не можете определить или получить contentId. Один из двух параметров: contentName, contentId - должен быть указан.	Request body parameter
contentId	Наименование груза из Справочника. Один из двух параметров: contentName, contentId - должен быть указан.	Request body parameter
medicalRecords	Наличие медицинской книжки.	Request body parameter
customsControl	Находится ли груз под таможенным контролем.	Request body parameter
loadingFrequencyId	Идентификатор частоты отгрузки из Справочника.	Request body parameter
sizeMassFrom	Нижняя граница массы груза, т. Один из двух параметров: sizeMassFrom, sizeMassTo - должен быть указан.	Request body parameter
sizeMassTo	Верхняя граница массы груза, т. Один из двух параметров: sizeMassFrom, sizeMassTo - должен быть указан.	Request body parameter
sizeVolumeFrom	Нижняя граница объема груза, м3.	Request body parameter
sizeVolumeTo	Верхняя граница объема груза, м3.	Request body parameter
sizeLength	Длина груза, м.	Request body parameter
sizeWidth	Ширина груза, м.	Request body parameter
sizeHeight	Высота груза, м.	Request body 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" \
-d '{
    "dateFrom": "2021-08-27",
    "dateTo": "2021-08-30",
    "contentId": 18,
    "bodyGroupId": 2,
    "cargoBodyTypeIds": [
        69,
        28,
        30,
        63
    ],
    "loadTypes": [
        24,
        25,
        26,
        27
    ],
    "paymentForms": [
        {
            "id": 10,
            "vat": true
        }
    ],
    "cargoPackaging": [
        {
            "id": 10,
            "count": 12
        }
    ],
    "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,
    "medicalRecords": true,
    "customsControl": true,
    "sizeMassFrom": 24,
    "sizeMassTo": 36,
    "sizeVolumeFrom": 30,
    "sizeVolumeTo": 40,
    "sizeLength": 10.1,
    "sizeWidth": 2.5,
    "sizeHeight": 3,
    "waypointListSource": [
        {
            "address": "уточнение адреса",
            "countrySign": "UA",
            "areaId": 23,
            "townId": 137
        }
    ],
    "waypointListTarget": [
        {
            "address": "уточнение адреса",
            "countrySign": "UA",
            "areaId": 34,
            "townId": 69
        }
    ]
}'

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

{
    "id": 298243420
}