Калькулятор стоимости услуг
Рассчитывает стоимость услуг Маркета для товаров с заданными параметрами. Порядок товаров в запросе и ответе сохраняется, чтобы определить, для какого товара рассчитана стоимость услуги.
Обратите внимание: калькулятор осуществляет примерные расчеты. Финальная стоимость для каждого заказа зависит от предоставленных услуг.
В запросе можно указать либо параметр campaignId
, либо sellingProgram
. Совместное использование параметров приведет к ошибке.
⚙️ Лимит: 100 запросов в минуту, не более 200 товаров в одном запросе |
---|
Request
POST
https://api.partner.market.yandex.ru/tariffs/calculate
Body
{
"parameters": {
"campaignId": 0,
"sellingProgram": "FBY",
"frequency": "DAILY"
},
"offers": [
{
"categoryId": 0,
"price": 0,
"length": 0,
"width": 0,
"height": 0,
"weight": 0,
"quantity": 1
}
]
}
Name |
Type |
Description |
parameters* |
Параметры для расчета стоимости услуг. |
|
offers* |
Товары, для которых нужно рассчитать стоимость услуг. |
CalculateTariffsParametersDTO
Параметры для расчета стоимости услуг.
Name |
Type |
Description |
campaignId |
integer<int64> |
Идентификатор кампании. У пользователя, который выполняет запрос, должен быть доступ к этой кампании. Используйте параметр Обязательный параметр, если не указан параметр |
sellingProgram |
Модель размещения. Обязательный параметр, если не указан параметр
|
|
frequency |
Частота выплат.
|
CalculateTariffsOfferDTO
Параметры товара, для которого нужно рассчитать стоимость услуг.
Name |
Type |
Description |
categoryId* |
integer<int64> |
Идентификатор категории товара на Маркете. Для расчета стоимости услуг необходимо указать идентификатор листовой категории товара — той, которая не имеет дочерних категорий. Чтобы узнать идентификатор категории, к которой относится товар, воспользуйтесь запросом POST categories/tree. |
price* |
number |
Цена товара в рублях. |
length* |
number |
Длина товара в сантиметрах. |
width* |
number |
Ширина товара в сантиметрах. |
height* |
number |
Высота товара в сантиметрах. |
weight* |
number |
Вес товара в килограммах. |
quantity |
integer<int32> |
Квант продажи — количество единиц товара в одном товарном предложении.
|
SellingProgramType
Модель размещения:
FBY
— FBY.FBS
— FBS.DBS
— DBS.EXPRESS
— Экспресс.
Type |
Description |
Enum: |
PaymentFrequencyType
Частота выплат:
DAILY
— ежедневно.WEEKLY
— раз в неделю.BIWEEKLY
— раз в две недели.MONTHLY
— раз в месяц.
Подробнее о графике выплат читайте в Справке для продавцов.
Type |
Description |
Enum: |
Responses
200 OK
Стоимость услуг.
Body
{
"status": "OK",
"result": {
"offers": [
{
"offer": {
"categoryId": 0,
"price": 0,
"length": 0,
"width": 0,
"height": 0,
"weight": 0,
"quantity": 1
},
"tariffs": [
{
"type": "AGENCY_COMMISSION",
"amount": 0,
"parameters": [
{
"name": "string",
"value": "string"
}
]
}
]
}
]
}
}
Name |
Type |
Description |
status |
Тип ответа.
|
|
result |
Стоимость услуг. |
CalculateTariffsResponseDTO
Расчет стоимости услуг.
Name |
Type |
Description |
offers* |
Стоимость услуг. |
CalculateTariffsOfferInfoDTO
Стоимость услуг.
Name |
Type |
Description |
offer* |
Информация о товаре, которую вы передали в запросе для расчета стоимости услуг. |
|
tariffs* |
Список услуг и их стоимость. По некоторым услугам могут возвращаться несколько разных стоимостей. Например, в модели FBS стоимость услуги |
CalculatedTariffDTO
Информация об услугах Маркета.
Name |
Type |
Description |
type |
Услуга Маркета.
|
|
amount |
number |
Стоимость услуги в рублях. |
parameters |
Параметры расчета тарифа. |
CalculatedTariffType
Услуга Маркета:
-
AGENCY_COMMISSION
— прием платежа покупателя. -
PAYMENT_TRANSFER
— перевод платежа покупателя. -
FEE
— размещение товара на Маркете. -
DELIVERY_TO_CUSTOMER
— доставка покупателю. -
CROSSREGIONAL_DELIVERY
— доставка в федеральный округ, город или населенный пункт. -
EXPRESS_DELIVERY
— экспресс-доставка покупателю. -
SORTING
— обработка заказа. -
MIDDLE_MILE
— средняя миля.
Подробнее об услугах Маркета читайте в Справке для продавцов.
Type |
Description |
Enum: |
TariffParameterDTO
Детали расчета конкретной услуги Маркета.
Name |
Type |
Description |
name* |
string |
Название параметра. |
value* |
string |
Значение параметра. |
400 Bad Request
Запрос содержит неправильные данные.
Body
{
"status": "OK",
"errors": [
{
"code": "string",
"message": "string"
}
]
}
Name |
Type |
Description |
status |
Тип ответа.
|
|
errors |
Список ошибок. |
ApiErrorDTO
Общий формат ошибки.
Name |
Type |
Description |
code* |
string |
Код ошибки. |
message |
string |
Описание ошибки. |
401 Unauthorized
В запросе не указаны данные для авторизации.
Body
{
"status": "OK",
"errors": [
{
"code": "string",
"message": "string"
}
]
}
Name |
Type |
Description |
status |
Тип ответа.
|
|
errors |
Список ошибок. |
403 Forbidden
Данные для авторизации неверны или доступ к ресурсу запрещен.
Body
{
"status": "OK",
"errors": [
{
"code": "string",
"message": "string"
}
]
}
Name |
Type |
Description |
status |
Тип ответа.
|
|
errors |
Список ошибок. |
404 Not Found
Запрашиваемый ресурс не найден.
Body
{
"status": "OK",
"errors": [
{
"code": "string",
"message": "string"
}
]
}
Name |
Type |
Description |
status |
Тип ответа.
|
|
errors |
Список ошибок. |
420 Method Failure
Превышено ограничение на доступ к ресурсу.
Body
{
"status": "OK",
"errors": [
{
"code": "string",
"message": "string"
}
]
}
Name |
Type |
Description |
status |
Тип ответа.
|
|
errors |
Список ошибок. |
500 Internal Server Error
Внутренняя ошибка сервера.
Body
{
"status": "OK",
"errors": [
{
"code": "string",
"message": "string"
}
]
}
Name |
Type |
Description |
status |
Тип ответа.
|
|
errors |
Список ошибок. |