Модели перечислены отдельно и раскрываются также непосредственно у методов, где они используются.
UnitCalculator31 полей
purchasePricenumber · double
Закупочная цена вместе с остальными расходами(общая себестоимость товара)
purchasePercentnumber · double
Процент выкупа
widthinteger · int32
Ширина в мм
heightinteger · int32
Высота в мм
depthinteger · int32
Глубина в мм
categoryIdinteger · int64
Категория
servicestring
Сервис
salePricenumber · double
Цена продажи
commissionnumber · double
Комиссия
wildberriesFbsBaseCommissionnumber · double
Базовая комиссия WB FBS без коэффициента скорости передачи заказа, %
wildberriesFbsPlannedTransferHoursnumber · double
Плановое время передачи заказа WB FBS, ч
wildberriesFbsTransferNormHoursnumber · double
Норматив времени передачи заказа WB FBS, ч
wildberriesFbsSpeedCoefficientnumber · double
Коэффициент скорости передачи заказа WB FBS, п.п.
wildberriesFbsEffectiveCommissionnumber · double
Эффективная комиссия WB FBS с коэффициентом скорости, %
wildberriesFbsTransferHoursSourcestring
Источник планового времени передачи заказа
wildberriesFbsSpeedCoefficientValidFromstring · date
Дата начала действия правил коэффициента скорости
wildberriesFbsSpeedCoefficientSourcestring
Источник правил коэффициента скорости
logisticnumber · double
Логистика
warehouseRationumber · double
Коэффициент склада в %
logisticRationumber · double
Коэффициент логистики
ktrnumber · double
Региональный показатель ВБ для логистики
expensesnumber · double
Итого расходы
newPriceByRubnumber · double
Расчетная цена по желаемой прибыли в рублях
newPriceByMarginalitynumber · double
Расчетная цена по желаемой прибыли в марже
desiredMarginPercentnumber · double
Желаемый % маржинальности
desiredProfitRubnumber · double
Желаемая прибыль, руб.
profitnumber · double
Прибыль
markUpnumber · double
Наценка
marginalitynumber · double
Маржа
organizationIdinteger · int64
Идентификатор организации
taxRatenumber · double
Налог, только у УСН
Контракт ошибок
Как API возвращает прикладные ошибки
Код ошибки одинаков для всех локалей, а текст для пользователя переводится сервером. Поэтому бизнес-логику стройте по error, а localMessage используйте только для отображения.
error
Стабильный машинный код ошибки для логики интеграции.
localMessage
Готовое сообщение на языке пользователя API-токена.
params
Значения
文
Язык localMessage определяется полем lang пользователя, которому принадлежит API-токен. Язык страницы документации и заголовок Accept-Language его не переключают; если язык пользователя не указан, используется русский.
RUПользователь с локалью ru
{
"error": "error_brand_already_exists",
"localMessage": "Бренд Base уже существует",
"params": {
"name": "Base"
}
}
Прикладные ошибки обычно возвращаются как JSON с полями error, localMessage и params. Ориентируйтесь на error; локализованный текст может меняться. Как API возвращает прикладные ошибки ↑
401auth_required
Требуется авторизация
Заголовок Authorization отсутствует, пуст или содержит недействительный токен.
400error_access_denied
Недостаточно прав
Токен существует, но его роль не позволяет выполнить операцию.
500error_unknown
Непредвиденная ошибка
Внутренняя ошибка. Сохраните время запроса и обратитесь в поддержку, не повторяя мутацию вслепую.
400error_category_not_found
Не найдена категория
Персональная ошибка этого метода. Для программной логики используйте стабильный код error_category_not_found; localMessage содержит приведённый выше перевод.
400error_depth_not_found
Не указана глубина
Персональная ошибка этого метода. Для программной логики используйте стабильный код error_depth_not_found; localMessage содержит приведённый выше перевод.
400error_height_not_found
Не указана высота
Персональная ошибка этого метода. Для программной логики используйте стабильный код error_height_not_found; localMessage содержит приведённый выше перевод.
400error_no_client
Клиент не найден или был удален. Напишите в поддержку
Персональная ошибка этого метода. Для программной логики используйте стабильный код error_no_client; localMessage содержит приведённый выше перевод.
400error_organization_not_found
Не найдена организация
Персональная ошибка этого метода. Для программной логики используйте стабильный код error_organization_not_found; localMessage содержит приведённый выше перевод.
400error_purchase_percent_not_found
Не указан процент выкупа
Персональная ошибка этого метода. Для программной логики используйте стабильный код error_purchase_percent_not_found; localMessage содержит приведённый выше перевод.
400error_sale_price_not_found
Не указана цена продажи
Персональная ошибка этого метода. Для программной логики используйте стабильный код error_sale_price_not_found; localMessage содержит приведённый выше перевод.
400error_service_not_found
Не выбран маркетплейс
Персональная ошибка этого метода. Для программной логики используйте стабильный код error_service_not_found; localMessage содержит приведённый выше перевод.
400error_width_not_found
Не указана ширина
Персональная ошибка этого метода. Для программной логики используйте стабильный код error_width_not_found; localMessage содержит приведённый выше перевод.
GET
Расчет цены по произвольному товару
/api/calculator/price
Токен с правами чтения
Метод ведет расчет цены по произвольному товару
Параметры запроса
Поле
Тип
Обязательно
Описание
purchasePrice
number · double
Нет
Закупочная цена вместе с остальными расходами(общая себестоимость товара)
Прикладные ошибки обычно возвращаются как JSON с полями error, localMessage и params. Ориентируйтесь на error; локализованный текст может меняться. Как API возвращает прикладные ошибки ↑
401auth_required
Требуется авторизация
Заголовок Authorization отсутствует, пуст или содержит недействительный токен.
400error_access_denied
Недостаточно прав
Токен существует, но его роль не позволяет выполнить операцию.
500error_unknown
Непредвиденная ошибка
Внутренняя ошибка. Сохраните время запроса и обратитесь в поддержку, не повторяя мутацию вслепую.
400error_category_not_found
Не найдена категория
Персональная ошибка этого метода. Для программной логики используйте стабильный код error_category_not_found; localMessage содержит приведённый выше перевод.
400error_depth_not_found
Не указана глубина
Персональная ошибка этого метода. Для программной логики используйте стабильный код error_depth_not_found; localMessage содержит приведённый выше перевод.
400error_fill_purchase_price
Нет закупочной цены
Персональная ошибка этого метода. Для программной логики используйте стабильный код error_fill_purchase_price; localMessage содержит приведённый выше перевод.
400error_height_not_found
Не указана высота
Персональная ошибка этого метода. Для программной логики используйте стабильный код error_height_not_found; localMessage содержит приведённый выше перевод.
400error_no_client
Клиент не найден или был удален. Напишите в поддержку
Персональная ошибка этого метода. Для программной логики используйте стабильный код error_no_client; localMessage содержит приведённый выше перевод.
400error_organization_not_found
Не найдена организация
Персональная ошибка этого метода. Для программной логики используйте стабильный код error_organization_not_found; localMessage содержит приведённый выше перевод.
400error_purchase_percent_not_found
Не указан процент выкупа
Персональная ошибка этого метода. Для программной логики используйте стабильный код error_purchase_percent_not_found; localMessage содержит приведённый выше перевод.
400error_service_not_found
Не выбран маркетплейс
Персональная ошибка этого метода. Для программной логики используйте стабильный код error_service_not_found; localMessage содержит приведённый выше перевод.
400error_width_not_found
Не указана ширина
Персональная ошибка этого метода. Для программной логики используйте стабильный код error_width_not_found; localMessage содержит приведённый выше перевод.