Расчёт услуг через API Маркета даёт предварительную оценку по переданным параметрам. Ошибка в категории, единицах измерения или трактовке ответа искажает сравнение товаров. Инструкция редакционно проверена 15 октября 2026 года; это не новость о смене тарифов.

Выберите контекст расчёта

Метод POST v2/tariffs/calculate требует campaignId либо sellingProgram. Совместная передача этих параметров приводит к ошибке. Первый задаёт конкретный магазин, второй — модель работы. Если используется магазин, проверьте его технический идентификатор: он отличается от businessId и не относится к рекламной кампании.

Редакционная рекомендация — подписать каждый сценарий расчёта: действующий магазин или сравнение моделей для будущего размещения. Смешивать результаты без этой пометки нельзя. Коллега должен видеть, какие исходные условия использовались и почему две оценки одного товара различаются.

Подготовьте параметры товара

В запросе указывают листовую категорию Маркета, цену в рублях, длину, ширину и высоту в сантиметрах, вес в килограммах. quantity означает квант продажи; значение по умолчанию — один. Документация разрешает до 200 предложений в запросе и сохраняет их порядок в ответе.

Перед массовой оценкой проверьте несколько строк исходной таблицы вручную. Число 500 в колонке веса может означать граммы в учётной программе, но метод ожидает килограммы. Отдельно сверяйте состав предложения: набор из нескольких единиц должен описываться согласованно с тем, что действительно продаётся покупателю.

Не складывайте все варианты услуги

Ответ содержит список услуг и их стоимость. По одной услуге могут возвращаться разные значения: например, обработка FBS зависит от способа отгрузки и количества заказов. Поле parameters объясняет условия расчёта. Поэтому механическое суммирование всех строк ответа может дать неверную оценку.

Редакционная рекомендация — показывать в рабочей таблице не только итог, но и выбранные условия. Если программа не умеет однозначно выбрать вариант, вынесите его на проверку. Молчаливый выбор первой строки создаёт видимость точности, которую сложно обнаружить при сравнении сотен товаров.

Сверьте оценку с фактом

Документация предупреждает, что окончательная сумма зависит от фактически оказанных услуг. После продаж сравните предварительную модель с экономикой завершённых заказов. Разницу разберите по составляющим: изменившиеся параметры, другой сценарий обслуживания либо расходы, которые ваша таблица не учитывала.

Сохраните дату расчёта и исходные значения, чтобы позднее можно было воспроизвести оценку. Не заменяйте ими банковскую выплату или прибыль товара: это разные показатели. Рабочий результат интеграции — объяснимый предварительный расчёт с проверенными входными данными и условиями выбора каждой услуги, а не обещание неизменной суммы будущего списания.