Предварительная оценка без создания заявки

Request

POST

b2b.taxi.yandex.net/b2b/cargo/integration/v2/check-price

Адрес сервиса

Headers

Name

Description

Accept-Language*

Type: string

Предпочитаемый язык ответа

Например:
ru — русский
en — английский

Example: ru

Body

application/json

{
    "items": [
        {
            "size": {
                "length": 0.1,
                "width": 0.2,
                "height": 0.3
            },
            "weight": 2.105,
            "quantity": 1,
            "pickup_point": 1,
            "dropoff_point": 2
        }
    ],
    "route_points": [
        {
            "id": 1,
            "coordinates": [
                0.1,
                0.1
            ],
            "fullname": "Санкт-Петербург, Большая Монетная улица, 1к1А",
            "country": "Россия",
            "city": "Санкт-Петербург",
            "street": "Большая Монетная улица",
            "building": "23к1А",
            "porch": "A",
            "sfloor": "1",
            "sflat": "1"
        }
    ],
    "requirements": {
        "taxi_class": "cargo",
        "cargo_type": "lcv_m",
        "cargo_loaders": 1,
        "pro_courier": false,
        "cargo_options": [
            "thermobag"
        ],
        "same_day_data": {
            "delivery_interval": {
                "from": "2020-01-01T00:00:00+00:00",
                "to": "2020-01-02T00:00:00+00:00"
            }
        }
    },
    "skip_door_to_door": false
}

Name	Description
route_points*	Type: RoutePointWithAddress[] Точки маршрута. Отсортированы в порядке посещения А-Б1....БN Min items: `1`
items	Type: Item[] Параметры товаров Min items: `1`
requirements	Type: ClaimCustomContext Требования к доставке (класс авто, опции)
skip_door_to_door	Type: boolean Отключить доставку до двери (выключить опцию "От двери до двери"). Возможные значения: true (курьер доставит заказ только на улицу, до подъезда) false (курьер доставит заказ до двери) — значение по умолчанию. Default: `false` Example: `false`

RoutePointWithAddress

Name	Description
building	Type: string Строение Example: `23к1А`
city	Type: string Город Example: `Санкт-Петербург`
coordinates	Type: number[] Координаты точек в виде массива из двух вещественных чисел: долгота, широта — именно в таком порядке. Example: `[ 0.1, 0.1 ]` Min items: `2` Max items: `2`
country	Type: string Страна Example: `Россия`
fullname	Type: string Полный адрес с указанием города, улицы и номера дома. Номер квартиры, подъезда и этаж указывать не нужно. Example: `Санкт-Петербург, Большая Монетная улица, 1к1А`
id	Type: integer<int64> Числовой id точки(int64). Параметр обязательный, если в заказе несколько точек доставки Example: `1`
porch	Type: string Подъезд (может быть A) Example: `A`
sflat	Type: string Квартира Example: `1`
sfloor	Type: string Этаж Example: `1`
street	Type: string Улица Example: `Большая Монетная улица`

Item

Name	Description
quantity*	Type: integer<int64> Количество единиц товара Example: `1` Min value: `1`
dropoff_point	Type: integer<int64> Идентификатор точки (int64), куда нужно доставить товар. Может быть любым числом. Должен соответствовать значению route_points[].id у точки назначения. Параметр обязательный, если в заказе несколько точек доставки. Example: `2`
pickup_point	Type: integer<int64> Идентификатор точки (int64), откуда нужно забрать товар. Может быть любым числом. Должен соответствовать значению route_points[].id у точки отправки. Параметр обязательный, если в заказе несколько точек доставки. Example: `1`
size	Type: CargoItemSizes Габариты товара в метрах. В полях следует передавать актуальные значения. Если габариты не были переданы, заказ оформляется с учетом максимально допустимых габаритов для выбранного тарифа. Если фактические характеристики товара превысят допустимые, курьер вправе отказаться от выполнения такого заказа на месте. В этом случае будет удержана стоимость подачи. Курьер (courier): до 0.80 м × 0.50 м × 0.50 м Экспресс (express): до 1.00 м × 0.60 м × 0.50 м Грузовой (cargo): Маленький кузов: до 1.70 м × 0.96 м × 0.90 м Средний кузов: до 2.60 м × 1.30 м × 1.50 м Большой кузов: до 3.80 м × 1.80 м × 1.80 м
weight	Type: number Вес товара в килограммах. Пример: 2.105 Example: `2.105`

ClaimCustomContext

Дополнительный контекст для фильтрации исполнителей.
Для использования нужно согласовать с менеджером.

CargoItemSizes

Габариты товара в метрах. В полях следует передавать актуальные значения.

Если габариты не были переданы, заказ оформляется с учетом
максимально допустимых габаритов для выбранного тарифа.

Если фактические характеристики товара превысят допустимые,
курьер вправе отказаться от выполнения такого заказа на месте.
В этом случае будет удержана стоимость подачи.

Курьер (courier): до 0.80 м × 0.50 м × 0.50 м
Экспресс (express): до 1.00 м × 0.60 м × 0.50 м
Грузовой (cargo):

Маленький кузов: до 1.70 м × 0.96 м × 0.90 м
Средний кузов: до 2.60 м × 1.30 м × 1.50 м
Большой кузов: до 3.80 м × 1.80 м × 1.80 м

Name	Description
height*	Type: number Высота в метрах Example: `0.3` Min value: `0` Max value: `500`
length*	Type: number Длина в метрах Example: `0.1` Min value: `0` Max value: `500`
width*	Type: number Ширина в метрах Example: `0.2` Min value: `0` Max value: `500`

Responses

200 OK

Body

application/json

{
    "price": "12.50",
    "currency_rules": {
        "code": "RUB",
        "text": "руб.",
        "template": "$VALUE$ $SIGN$$CURRENCY$",
        "sign": "₽"
    },
    "requirements": {
        "taxi_class": "cargo",
        "cargo_type": "lcv_m",
        "cargo_loaders": 1,
        "pro_courier": false,
        "cargo_options": [
            "thermobag"
        ],
        "same_day_data": {
            "delivery_interval": {
                "from": "2020-01-01T00:00:00+00:00",
                "to": "2020-01-02T00:00:00+00:00"
            }
        }
    },
    "distance_meters": 10,
    "eta": 10,
    "zone_id": "moscow"
}

Name	Description
price*	Type: string Стоимость доставки в формате десятичной дроби Decimal(18, 4) Example: `12.50` Pattern: `^-?[0-9]{1,14}(\.[0-9]{0,4})?$`
requirements*	Type: ClaimCustomContext Требования к доставке (класс авто, опции)
currency_rules	Type: CurrencyRules Правила отображения валюты
distance_meters	Type: number Расстояние в метрах для указанного маршрута, от первой точки до последней точки Example: `10`
eta	Type: number Расчетное врем прибытия в минутах Example: `10`
zone_id	Type: string Идентификатор (ID) зоны доставки Example: `moscow`

CurrencyRules

Правила отображения валюты

Name	Description
code*	Type: string Трехзначный код валюты, в которой ведется расчет Example: `RUB` Min length: `3` Max length: `3`
template*	Type: string Шаблон для отображения валюты Example: `$VALUE$ $SIGN$$CURRENCY$`
text*	Type: string Сокращенное наименование валюты Example: `руб.`
sign	Type: string Символ валюты Example: `₽`

400 Bad Request

Неверный запрос

Body

application/json

{
    "code": "bad_request",
    "message": "bad request"
}

Name

Description

code*

Type: string

Код ошибки

Example: bad_request

Enum: bad_request, address_not_found

message*

Type: string

Описание ошибки

Example: bad request

409 Conflict

Нет подходящих машин | Не удалось построить маршрут

Body

application/json

{
    "code": "estimating.requirement_unavailable",
    "message": "requirement unavailable"
}

Name

Description

code*

Type: string

Код ошибки

Example: estimating.requirement_unavailable

Enum: unknown_error, errors.suitable_offer_not_found, estimating.cant_construct_route, estimating.cargocorp_payment_failure, estimating.claim.no_zone_id, estimating.limited_by_claims_creation_overflow, estimating.no_pickup_point, estimating.payment_method_cant_order, estimating.swapped_coordinates, estimating.payment_method_zone_unavailable, estimating.permitted_tariffs_not_enough, estimating.requirement_unavailable, estimating.route_too_long, estimating.route_too_short, estimating.tariff.no_categories, estimating.tariff.not_available_in_zone, estimating.tariff.not_present_in_tariff_line_strategy, estimating.tariff.no_sdd_tariff, estimating.tariff.no_tariff_plan, estimating.too_large_linear_size, estimating.too_many_loaders, estimating.cargo_type_unavailable, estimating.warning.too_heavy_item, estimating.warning.too_large_item, estimating.route_is_prohibited

message*

Type: string

Описание ошибки

Example: requirement unavailable

429 Too Many Requests

Слишком много запросов

Body

application/json

{
    "code": "too_many_requests",
    "message": "Слишком много запросов"
}

Name

Description

code*

Type: string

Код ошибки

Example: too_many_requests

Enum: unknown_error, too_many_requests

message*

Type: string

Описание ошибки

Example: Слишком много запросов

Была ли статья полезна?

1.1 Доступные тарифы

2.1 Телефон