API-интеграция

Функция /1.1/order/calculate
Назначение: Расчет стоимости. Основное отличие от 1.0/order/calculate возможность указывать доп.услуги к каждому месту груза.
Поля запроса:
ПараметрОписаниеТипОбязательныйПример
city_pickup_codeКод города откудастрокаДа660000100000
city_delivery_codeКод города кудастрокаДа000000000001
declared_priceОбъявленная стоимость груза (руб)integerДа1000
confirmation_priceНаличие документов подтверждающих стоимостьboolean

Да (если declared_price более 50 000),

по умолчанию 0

1
serviceмассив кодов услугмассив кодов услугв в составе placesНетplaces[0]service[0] = T001
places[0]service[1] = S026
heightВысота груза (см) позицииdecimal(10,2)Да (если не указан volume)places[0][height] = 100
places[1][height]  = 120
widthШирина груза (см) позицииdecimal(10,2)Да (если не указан volume)places[0][width] = 100
places[1][width] = 120
lengthДлина груза (см) позицииdecimal(10,2)Да (если не указан volume)

places[0][length] = 100
places[1][length] = 120

count_placeКоличество мест в позициимассив integerДаplaces[0][count_place] = 1
places[1][count_place] = 2
weightМасса КГ позициимассив integerДаplaces[0][weight] = 2
places[1][weight] = 4
volumeОбъем М³ позициимассив decimal(10,3)Да (если не указаны height, width, length)places[1][volume] = 1
places[0][volume] = 2
pick_upЗабор груза по городуinteger(
1 - да
0 - нет
)		Нет1
deliveryДоставка груза по городуinteger(
1 - да
0 - нет
)		Нет1
insuranceУслуга страхования грузаinteger(
1 - да
0 - нет
)		Да (если стоимость груза равна или более 10 000 руб.)1
insurance_agent_codeКод страхового агентастрокаДа (если insurance = 1 )8000152423
have_docЕсть документы подтверждающие стоимость грузаinteger(
1 - да
0 - нет
)		Да (если стоимость груза равна или более 50 000 руб. )1
cargo_type_codeКод характера грузастрокаНет (по умолчанию 03)01
currency_codeВалюта результата расчетамассив строкаНет (по умолчанию RUB)currency_code[0] = KZT
currency_code[1] = RUB
all_places_sameВсе места одинаковы по размеруbooleanНет (по умолчанию 0)1

Поля ответа:

Параметры ответа массив типа calculateResult где ключом элемента является тип валюты например RUB

Описание типа calculateResult:

ПараметрОписаниеТипПример
standartСтандартcalculateResultType 
economyЭкономcalculateResultType 
expressЭкспрессcalculateResultType 
standard_courierСтандарт курьерcalculateResultType 
express_courierЭкспресс курьерcalculateResultType 

 

Описание типа calculateResultType:

ПараметрОписаниеТипПример
nameНазвание типа перевозкистрокаСтандарт
costОбщая стоимость перевозкиinteger149070
timeСрок доставки в дняхinteger5
currency_codeКод валютыстрокаKZT
detailДетализация стоимостиcalculateService 

 

Описание типа calculateService:

ПараметрОписаниеТипПример
nameНазвание услугистрокаДоставка груза
codeКод услугистрокаS002
priceСтоимость услугиinteger3850

Пример запроса:
{
    "city_pickup_code": "660000100000",
    "city_delivery_code": "000000000001",
    "declared_price": "100",
    "currency_code": [
        "KZT",
        "RUB"
    ],
    "places": [
        {
            "count_place": "2",
            "height": "100",
            "width": "100",
            "length": "100",
            "weight": "100",
            "service": [
                "S026",
                "T001"
            ]
        },
        {
            "count_place": "4",
            "weight": "200",
            "volume": "4"
        }
    ],
    "insurance": "1",
    "insurance_agent_code": "8000152423"
}
Пример ответа:
[
    {
        "express": {
            "cost": 187625,
            "name": "Экспресс",
            "time": 0,
            "detail": [
                {
                    "code": "S026",
                    "name": "Мешок S",
                    "price": 408
                },
                {
                    "code": "S031",
                    "name": "Возмещение страхования груза по дейст.ст",
                    "price": 204
                },
                {
                    "code": "S025",
                    "name": "ЗТТ (деревянная обрешетка)",
                    "price": 9860
                },
                {
                    "code": "S039",
                    "name": "Груз",
                    "price": 177153
                }
            ],
            "currency_code": "KZT"
        },
        "standart": {
            "cost": 187571,
            "name": "Стандарт",
            "time": 7,
            "detail": [
                {
                    "code": "S026",
                    "name": "Мешок S",
                    "price": 408
                },
                {
                    "code": "S031",
                    "name": "Возмещение страхования груза по дейст.ст",
                    "price": 204
                },
                {
                    "code": "S025",
                    "name": "ЗТТ (деревянная обрешетка)",
                    "price": 9860
                },
                {
                    "code": "S039",
                    "name": "Груз",
                    "price": 177099
                }
            ],
            "currency_code": "KZT"
        }
    },
    {
        "express": {
            "cost": 27592,
            "name": "Экспресс",
            "time": 0,
            "detail": [
                {
                    "code": "S026",
                    "name": "Мешок S",
                    "price": 60
                },
                {
                    "code": "S031",
                    "name": "Возмещение страхования груза по дейст.ст",
                    "price": 30
                },
                {
                    "code": "S025",
                    "name": "ЗТТ (деревянная обрешетка)",
                    "price": 1450
                },
                {
                    "code": "S039",
                    "name": "Груз",
                    "price": 26052
                }
            ],
            "currency_code": "RUB"
        },
        "standart": {
            "cost": 27584,
            "name": "Стандарт",
            "time": 7,
            "detail": [
                {
                    "code": "S026",
                    "name": "Мешок S",
                    "price": 60
                },
                {
                    "code": "S031",
                    "name": "Возмещение страхования груза по дейст.ст",
                    "price": 30
                },
                {
                    "code": "S025",
                    "name": "ЗТТ (деревянная обрешетка)",
                    "price": 1450
                },
                {
                    "code": "S039",
                    "name": "Груз",
                    "price": 26044
                }
            ],
            "currency_code": "RUB"
        }
    }
]