Page tree
Skip to end of metadata
Go to start of metadata

You are viewing an old version of this page. View the current version.

Compare with Current View Page History

Version 1 Next »

Метод используется для расчета стоимости и сроков доставки по коду тарифа.

Запрос на расчет по коду тарифа

Для использования необходимо отправить POST-запрос на URL:

Тело запроса

Необходимо передавать в формате JSON (Content-Type: application/json).

Поддерживаются следующие поля:

Название поля

Описание

Тип поля

Обяз. для заполн.

1dateДата и время планируемой передачи заказа
По умолчанию - текущая
dateTime нет
2typeТип заказа (для проверки доступности тарифа и дополнительных услуг по типу заказа):
1 - "интернет-магазин"
2 - "доставка" 
По умолчанию - 1
integerнет
3currencyВалюта, в которой необходимо произвести расчет (подробнее см. приложение 1)
По умолчанию - валюта договора
integerнет
4tariff_codeКод тарифаintegerда
5from_locationАдрес отправленияlocationда
5.1codeКод локации (справочник СДЭК)string()

да

6to_locationАдрес полученияlocationда
6.1codeКод локации (справочник СДЭК)string()

да

7servicesДополнительные услугиservice[ ]нет
7.1codeТип дополнительной услуги, код из справочника доп. услуг ((подробнее см. приложение 2)string()да
7.2parameterПараметр дополнительной услуги:
  • количество упаковок для услуги "Упаковка 1" и "Упаковка 2" (для всех типов заказа)
  • объявленная стоимость заказа для услуги "Страхование" (только для заказов с типом "доставка")
  • этаж для "Подъем на этаж ручной"
integerнет
8packagesСписок информации по местам (упаковкам)package[ ]да
8.1weightОбщий вес (в граммах)integerда
8.2lengthГабариты упаковки. Длина (в сантиметрах)integerнет
8.3widthГабариты упаковки. Ширина (в сантиметрах)integerнет
8.4heightГабариты упаковки. Высота (в сантиметрах)integerнет

Ответ на расчет по коду тарифа

Ответ возвращается в формате JSON:

Название поля

Описание

Тип поля

Обяз. для заполн.

1delivery_sumСтоимость доставкиfloatда
2period_minМинимальное время доставки (в рабочих днях)integerда
3period_maxМаксимальное время доставки (в рабочих днях)integerда
4weight_calcРасчетный вес (в граммах)integerда
5servicesДополнительные услуги (возвращается, если в запросе были переданы доп. услуги)service[ ]нет
5.1codeТип дополнительной услуги, код из справочника доп. услугstring()да
5.2sumСтоимость услугиfloatда
6total_sumСтоимость доставки с учетом дополнительных услугfloatда
7currencyВалюта, в которой рассчитана стоимость доставки (код СДЭК)string(3)да
8errorsСписок ошибокerror[]нет
8.1codeКод ошибкиstring()да
8.2messageОписание ошибкиstring()да


Пример запроса
{
    "type": "2",
    "date": "2020-11-03T11:49:32+0700",
    "currency": "1",
    "lang": "rus",
    "tariff_code": "11",
    "from_location": {
        "code": "270"
    },
    "to_location": {
        "code": "44"
    },
    "services": [
        {
            "code": "PACKAGE_1",
            "parameter": "2"
        }
    ],
    "packages": [
        {
            "height": 10,
            "length": 10,
            "weight": 4000,
            "width": 10
        }
    ]
}


Пример ответа
{
    "period_min": 2,
    "currency": "RUB",
    "delivery_sum": 1040.0,
    "weight_calc": 4000,
    "services": [
        {
            "code": "PACKAGE_1",
            "sum": 100.0
        }
    ],
    "period_max": 2,
    "total_sum": 1140.0
}

Приложение 1. Валюты калькулятора

КодВалюта
1Рубль
2Тенге
3Доллар
4Евро
5Фунт стерлингов
6Юань
7Белорусские рубли
8Гривна
9Киргизский сом
10Армянский драм
11Турецкая лира
12Тайский бат
13Вона
14Дирхам
15Сум
16Тугрик
17Злотый
18Манат
19Лари

Приложение 2. Дополнительные услуги

Код услугиНазвание

INSURANCE

Страхование

DELIV_WEEKEND

Доставка в выходной день

TAKE_SENDER

Забор в городе отправителе

DELIV_RECEIVER

Доставка в городе получателе

TRYING_ON

Примерка на дому

PART_DELIV

Частичная доставка

INSPECTION_CARGO

Осмотр вложения

REVERSE

Реверс

DANGER_CARGOОпасный груз
PACKAGE_1Упаковка 1
PACKAGE_2Упаковка 2
WAIT_FOR_RECEIVERОжидание более 15 мин. у получателя
WAIT_FOR_SENDERОжидание более 15 мин. у отправителя
REPEATED_DELIVERYПовторная поездка
SMSСмс уведомление
GET_UP_FLOOR_BY_HANDПодъем на этаж ручной
GET_UP_FLOOR_BY_ELEVATORПодъем на этаж лифтом
CALLПрозвон
THERMAL_MODEТепловой режим
  • No labels