1.01. Предварительная оценка стоимости доставки

Расчет стоимости доставки на основании переданных параметров заказа.

Request

POST

b2b.taxi.tst.yandex.net/api/b2b/platform/pricing-calculator

Тестовое окружение

POST

b2b-authproxy.taxi.yandex.net/api/b2b/platform/pricing-calculator

Продакшен-окружение

Query parameters

Name

Description

is_oversized

Type: boolean

Флаг КГТ

Body

application/json
{
    "source": {
        "platform_station_id": "string"
    },
    "destination": {
        "address": "Санкт-Петербург, Большая Монетная улица, 1к1А"
    },
    "tariff": "time_interval",
    "total_weight": 0,
    "total_assessed_price": 0,
    "client_price": 0,
    "payment_method": "already_paid",
    "places": [
        {
            "physical_dims": {
                "weight_gross": 0,
                "dx": 0,
                "dy": 0,
                "dz": 0,
                "predefined_volume": 0
            }
        }
    ]
}

Name

Description

destination*

Type: PricingDestinationNode

Информация о точке получения заказа

source*

Type: PricingSourceNode

Информация о точке отправления заказа

tariff*

Type: string

Тариф доставки. Выберите один из двух.

  1. time_interval — доставка до двери в интервал
  2. self_pickup — доставка до ПВЗ

Enum: time_interval, self_pickup

total_weight*

Type: integer

Cуммарный вес посылки в граммах

client_price

Type: integer

Cумма к оплате с получателя в копейках

Default: 0

payment_method

Type: string

Способ оплаты товаров.
already_paid — уже оплачено
card_on_receipt — оплата картой при получении
cash_on_receipt — оплата наличными при получении

Default: already_paid

Enum: already_paid, card_on_receipt, cash_on_receipt

places

Type: PricingResourcePlace[]

Информация о местах в заказе

Min items: 0

total_assessed_price

Type: integer

Суммарная оценочная стоимость посылок в копейках

Default: 0

PricingDestinationNode

В объекте два параметра. Заполните один из них

Name

Description

address

Type: string

Адрес получения с указанием города, улицы и номера дома.
Номер квартиры, подъезда и этаж указывать не нужно

Example: Санкт-Петербург, Большая Монетная улица, 1к1А

platform_station_id

Type: any

ID ПВЗ или постамата, зарегистрированного в платформе, в который нужна доставка

PricingSourceNode

Name

Description

platform_station_id

Type: string

ID склада отправки, зарегистрированного в платформе

PricingResourcePlace

Name

Description

physical_dims*

Type: PlacePhysicalDimensions

Физические параметры места

PlacePhysicalDimensions

Весогабаритные характеристики грузомест

Name

Description

dx*

Type: integer

Длина, сантиметры

dy*

Type: integer

Высота, сантиметры

dz*

Type: integer

Ширина, сантиметры

weight_gross*

Type: integer

Вес брутто, граммы

predefined_volume

Type: integer

Объем (в см3)

Responses

200 OK

Успешный запрос

Body

application/json
{
    "error": false,
    "pricing_total": "string",
    "pricing_commission_on_delivery_payment_amount": "string",
    "pricing_commission_on_delivery_payment": "string",
    "pricing": "string"
}

Name

Description

...rest

oneOf PricingResponse

...rest

oneOf UnavailableTariffResponse

PricingResponse

Name

Description

error*

Type: boolean

pricing_total*

Type: string

Суммарная стоимость доставки с учетом дополнительных услуг (с НДС)

pricing

Type: string

Стоимость за услугу доставки и страхование посылки в руб (с НДС).
В случае указания способа оплаты already_paid не заполняется

pricing_commission_on_delivery_payment

Type: string

Размер комисиии за прием наложенного платежа в %.
Заполняется в случае указания способа оплаты отлиного от already_paid

pricing_commission_on_delivery_payment_amount

Type: string

Размер комисиии за прием наложенного платежа в руб (с НДС).
Заполняется в случае указания способа оплаты отлиного от already_paid

UnavailableTariffResponse

Name

Description

error

Type: boolean

message

Type: string