Эффективная интеграция и кастомизация функционала в Битрикс24 часто требует работы на уровне API. Сегодня мы подробно рассмотрим «Расчитать стоимости доставки CALCULATE_URL». Вы узнаете экспертные методики работы с расчитать стоимости и научитесь избегать типичных ошибок начинающих разработчиков.

Расчитать стоимости доставки CALCULATE_URL

Запрос отправляется на адрес указанный в CALCULATE_URL при создании обработчика доставки в методе sale.delivery.handler.add.

Параметры запроса

Пример запроса

{
    "SHIPMENT":{
        "ID":4060,
        "DELIVERY_SERVICE":{
            "ID":225,
            "CONFIG":[
                {
                    "CODE":"PROFILE_TYPE",
                    "VALUE":"CARGO"
                }
            ],
            "PARENT":{
                "ID":223,
                "CONFIG":[
                    {
                        "CODE":"SETTING_1",
                        "VALUE":"String Example Value"
                    }
                ]
            }
        },
        "PRICE":179998,
        "CURRENCY":"RUB",
        "WEIGHT":600,
        "PROPERTY_VALUES":[
            {
                "ID":100,
                "TYPE":"ADDRESS",
                "VALUE":{
                    "LATITUDE":55.726421,
                    "LONGITUDE":37.61187,
                    "FIELDS":{
                        "COUNTRY":"Россия",
                        "ADM_LEVEL_1":"Москва",
                        "ADM_LEVEL_2":"Москва",
                        "ADM_LEVEL_3":"Якиманка",
                        "LOCALITY":"Москва",
                        "SUB_LOCALITY_LEVEL_1":"Центральный административный округ",
                        "STREET":"улица Шаболовка",
                        "BUILDING":"9",
                        "ADDRESS_LINE_1":"улица Шаболовка, 9"
                    }
                }
            },
            {
                "ID":101,
                "TYPE":"ADDRESS",
                "VALUE":{
                    "LATITUDE":55.724779,
                    "LONGITUDE":37.614294,
                    "FIELDS":{
                        "POSTAL_CODE":"115162",
                        "COUNTRY":"Россия",
                        "ADM_LEVEL_1":"Москва",
                        "ADM_LEVEL_2":"район Якиманка",
                        "LOCALITY":"Москва",
                        "STREET":"улица Шаболовка",
                        "BUILDING":"13 с10",
                        "ADDRESS_LINE_1":"улица Шаболовка, 13 с10"
                    }
                }
            }
        ],
        "ITEMS":[
            {
                "NAME":"iPhone 14",
                "PRICE":89999,
                "WEIGHT":300,
                "CURRENCY":"RUB",
                "QUANTITY":2,
                "DIMENSIONS":{
                    "WIDTH":400,
                    "HEIGHT":80,
                    "LENGTH":500
                }
            }
        ],
        "EXTRA_SERVICES_VALUES":[
            {
                "ID":138,
                "CODE":"cargo_type",
                "VALUE":"small_package"
            },
            {
                "ID":137,
                "CODE":"door_delivery",
                "VALUE":"Y"
            },
            {
                "ID":139,
                "CODE":"some_quantity_service",
                "VALUE":3
            }
        ],
        "RESPONSIBLE_CONTACT":{
            "NAME":"Роман Горшков",
            "PHONES":[
                {
                    "TYPE":"MOBILE",
                    "VALUE":"+79097996161"
                }
            ]
        },
        "RECIPIENT_CONTACT":{
            "NAME":"Алексей Миронов",
            "PHONES":[
                {
                    "TYPE":"WORK",
                    "VALUE":"+79097996161"
                }
            ]
        }
    }
}

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

REASON

Пример ответа с успешным расчетом стоимости

{
    "SUCCESS": "Y",
    "PRICE": 79.99,
}

Пример ответа с ошибкой при расчете стоимости

{
    "SUCCESS": "N",
    "REASON": {
        "TEXT": "Delivery is not available for the specified address"
    }
}

• [](./index)
• [](./create-delivery-request)
• [](./cancel-delivery-request)