Створення заявки з вантажу

Опис

За допомогою цього методу можна створити нову заявку з вантажу.

Структура URL

POST /v2/proposals/my/add/cargo

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

Назва	Опис	Тип передачі параметра	Обов'яз.(+)/За замовч.(значення)
language	Мова локалізації. Опис використання.	Query string parameter	ru
contactId	Ідентифікатор підлеглого контакту користувача.	Request body parameter
publishDate	Дата публікації заявки, timestamp, 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
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
sizeMass	Маса вантажу, т.	Request body parameter	+
sizeVolume	Об'єм вантажу, м3.	Request body parameter
sizeLength	Довжина вантажу, м.	Request body parameter
sizeWidth	Ширина вантажу, м.	Request body parameter
sizeHeight	Висота вантажу, м.	Request body parameter
waypointListSource	Точки завантаження, масив Структур "Точка завантаження в запитах". Масив не може бути порожнім.	Request body parameter	+
waypointListTarget	Точки вивантаження, масив Структур "Точка завантаження в запитах". Масив не може бути порожнім.	Request body parameter	+
cargoBodyTypeProperties	Характеристики кузову, перелічуваний тип. DOUBLE_DECK, JUMBO, MEGA	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,
    "sizeMass": 24,
    "sizeVolume": 30,
    "sizeLength": 10.1,
    "sizeWidth": 2.5,
    "sizeHeight": 3,
    "waypointListSource": [
        {
            "address": "уточнение адреса",
            "countrySign": "UA",
            "areaId": 23,
            "townId": 137
        }
    ],
    "waypointListTarget": [
        {
            "address": "уточнение адреса",
            "countrySign": "UA",
            "areaId": 34,
            "townId": 69
        }
    ],
    "cargoBodyTypeProperties": [
        "MEGA", "JUMBO"
    ]      
}'

Зразок відповіді

{
    "id": 298243420
}