WZCalc

Простой калькулятор для предварительного расчета цены товаров для маркетплейсов Ozon и Wildberries.

Table of Contents

• Summary
• How is this calculated?
  • Ozon
    • Logistics fee FBS Ozon
    • Logistics fee FBO Ozon
    • Reverse logistics fee Ozon
    • Returns fee Ozon
    • Profit fee Ozon: tax-system "simple"
    • Profit fee Ozon: tax-system "diff"
    • Price fee Ozon: tax-system "simple"
    • Price fee Ozon: tax-system "diff"
  • Wildberries
    • Logistics fee FBS wildberries
    • Logistics fee FBO wildberries
    • Returns fee Wildberries
    • Profit fee Wildberries: tax-system "simple"
    • Profit fee Wildberries: tax-system "diff"
    • Price fee Wildberries: tax-system "simple"
    • Price fee Wildberries: tax-system "diff"
• Project structure
• Calculator core package
  • Core package structure
  • Description
    • Interfaces
    • Services
    • Calculators
    • Domain
• Endpoints
  • Calculations
    • Ozon endpoints
    • Wildberries endpoints
• Constraints
• Variables
  • Ozon variables
  • Wildberries variables
• References

Summary

Краткое содержание документации

1. How is this caclulated?
   В этом разделе подробно описано как именно происходит расчет составляющих цены и итоговой цены

2. Project structure
   В этом разделе подробно описана структура проекта

3. Calculator core package
   В этом разделе подробно описаны структура и особенности ядра калькулятора

4. Endpoints
   В этом разделе описано какие существуют endpoints и как именно к ним обращаться

5. Constraints
   В этом разделе описаны существующие pydantic-правила для входящих данных

6. Variables
   В этом разделе приведен список используемых переменных с описанием

7. References
   Ссылки на источники, использованные для написания приложения и создания документации

---

How is this calculated?

Ozon

Logistics fee FBS Ozon

Как расчитывается стомость для логистики FBS.

• Переменные и обозначения:

Обозначение	Параметр	Описание
$V$	box_volume	Объём упаковки в литрах
$I$	local_index	Индекс локализации
$C_{\text{lg}}$	fix_large_fbs	Стоимость логистики за объём $> 190$ литров
$C_{\text{min}}$	minimal_price_fbs	Стоимость логистики за объём $\leq 0.4$ литров
$C_{\text{base}}$	base_price_fbs	Базовая стоимость логистики за объём $0.4 < V \leq 190$ литров
$C_{\text{vol}}$	volume_factor_fbs	Стоимость логистики за каждый дополнительный литр
$L$	logistics_fee	Итоговая стоимость логистики

• Идея расчета:

  Если объем упаковки не превышает 0.4 литра, то стоимость логистики рассчитывается как произведение minimal_price_fbs и local_index:
  $L = C_{\text{min}} \cdot I$

  Если объем упаковки от 0.4 литров до 1 литра включительно, то стоимость логистики рассчитывается как произведение base_price_fbs и local_index:
  $L = C_{\text{base}} \cdot I$

  Если объем упаковки от 1 литра до 190 литров включительно, стоимость логистики расчитвается как произведение local_index и base_price_fbo + volume_factor за каждый дополнительный литр:
  $\bigl(C_{\text{base}} + C_{\text{vol}} \cdot \lceil V - 1 \rceil \bigr) \cdot I$

  Если объем превышает 190 литров, то:
  $L = C_{lg} \cdot I$

• Формула:

$V_{\text{max}}$ = 190
$V_{\text{min}}$ = 0.4
$V_{\text{avg}}$ = 1

$$ L(V) = \begin{cases} C_{\text{lg}} \cdot I & V \gt V_{\max} \\[6pt] C_{\min} \cdot I & 0 \lt V \leq V_{\min} \\[6pt] C_{\text{base}} \cdot I & V_{\min} < V \leq V_{\text{avg}} \\[6pt] \bigl(C_{\text{base}} + C_{\text{vol}} \cdot \lceil V - 1 \rceil \bigr) \cdot I & V_{\text{avg}} < V \leq V_{\max} \end{cases} $$

Logistics fee FBO Ozon

Как расчитывается стомость для логистики FBO.

• Переменные и обозначения:

Обозначение	Параметр	Описание
$V$	box_volume	Объём упаковки в литрах
$I$	local_index	Индекс локализации
$C_{\text{lg}}$	fix_large_fbo	Стоимость логистики за объём $> 190$ литров
$C_{\text{base}}$	base_price_fbo	Базовая стоимость логистики за объём $0 < V \leq 190$ литров
$C_{\text{vol}}$	volume_factor_fbo	Стоимость логистики за каждый дополнительный литр
$L$	logistics_fee	Итоговая стоимость логистики

• Идея расчета:

  Если объем упаковки до 1 литра включительно, то стоимость логистики рассчитывается как произведение base_price_fbs и local_index:
  $L = C_{\text{base}} \cdot I$

  Если объем упаковки от 1 литра до 190 литров включительно, стоимость логистики расчитвается как произведение local_index и base_price_fbo + volume_factor за каждый дополнительный литр:
  $\bigl(C_{\text{base}} + C_{\text{vol}} \cdot \lceil V - 1 \rceil \bigr) \cdot I$

  Если объем превышает 190 литров, то:
  $L = C_{lg} \cdot I$

• Формула:

$V_{\text{max}}$ = 190
$V_{\text{avg}}$ = 1

$$ L(V) = \begin{cases} C_{\text{lg}} \cdot I & V \gt V_{\max} \\[6pt] C_{\text{base}} \cdot I & V \leq V_{\text{avg}} \\[6pt] \bigl(C_{\text{base}} + C_{\text{vol}} \cdot \lceil V - 1 \rceil \bigr) \cdot I & V_{\text{avg}} < V \leq V_{\max} \end{cases} $$

Reverse logistics fee Ozon

Какрасчитывается стоимость обратной логистики.

Стоимость обратной логистики расчитывается так же, как и логистика FBS, только local_index (индекс локализации) всегда равен 1.

Returns fee Ozon

Как расчитывается стоимость невыкупов.

• Переменные и обозначения:

Обозначение	Параметр	Описание
$r$	redemption_percentage	Процент выкупа
$L$	logistics_fee	Стоимость логистики для одного товара
$R$	reverse_logistics_fee	Стоимость обратной логистики для одного невыкупленного товара
$P$	nonredemption_processing_cost	Стоимость обработки одного возврата
$F$	returns_fee	Стоимость возвратов при текущем $r$

• Идея расчета:

  Берем базовую выборку в 100 отправленных заказов.
  Все 100 заказов будут доставлены до ПВЗ покупателя, поэтому логистика оплачивается за все 100 отправлений: $100L$.
  Часть заказов будет возвращена отправителю - за них должна быть оплачена стоимость обратной логистики: $R(100 - r)$.
  Так же должна быть оплачена стоимость обработки возвратов: $P(100 - r)$.
  Суммарные затраты распределяются только на выкупленные заказы ($r$).
  После чего из получившегося значения вычитается $L$, иначе она будет учитана 2 раза*.

  *Отталкиваемся от того, что при расчете итоговой цены товара логистика уже была включена в цену, а returns_fee это дополнение к итоговой цене, которое стремится покрыть стоимость возможного процента невыкупов.

• Формула:

  $F = \frac{100L + (100-r)(R+P)}{r} - L$

• Формула (чистая):
  Расчет происходит по этой формуле

  $F = \frac{100-r}{r}(L + R + P)$

Profit fee Ozon: tax-system "simple"

Как расчитывается профит исходя из итоговой цены и прочих параметров для системы налогооблажения "simple" для Ozon.
Система налогооблажения diff подразумевает, что налог будет расчитан от стоимости товара.

• Переменные и обозначения:

Обозначение	Параметр	Описание
$C$	count	Количество товаров в упаковке
$C_{p}$	cost_per_one	Себестоимость единицы товара
$C_{v}$	cost_value	Себестоимость товара
$K_{p}$	comission_percent	Процент комиссии маркетплейса
$K$	comission_fee	Стоимость комиссии в рублях
$M_{p}$	last_mile_percent	Процент "последней мили"
$M$	last_mile_fee	Стоимость "последней мили"
$Q_{p}$	acquiring_percent	Процент эквайринга маркетплейса
$Q$	acquiring_fee	Стоимость эквайринга в рублях
$T_{p}$	tax_percent	Процент налога
$T$	tax_fee	Стоимость налога в рублях
$Rs_{p}$	risk_percent	Процент рисков
$Rs$	risk_fee	Стоимость рисков в рублях
$B$	box_cost	Стоимость упаковки
$W$	wage_cost	Стоимость труда
$L$	logistics_fee	Стоимость логистики
$Rt$	returns_fee	Стоимость возвратов
$Sh$	shipment_processing	Обработка отправления
$A_{c}$	all_costs	Все расходы
$P_{t}$	total_price	Цена товара на маркетплейсе
$F$	total_profit	Итоговый профит

• Идея расчета:

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

  • cебестоимость товара
  • стоимость последней мили
  • стоимость комиссии
  • стоимость эквайринга
  • налог
  • риски
  • стоимость логистики
  • стоимость возвратов
    Далее, все расходы вычитаются из цены товара на маркетрлейсе.

• Порядок расчета:

Себестоимсть товара

$C_{v} = C_{p} \cdot C$

Стоимость последней мили

$$ M(P_{t}) = \begin{cases} P_{t} \cdot \frac{M_{p}}{100}, & M \lt 500 \\\ M = 500, & M \gt 500 \end{cases} $$

Стоимость комиссии

$K = P_{t} \cdot \frac{K_{p}}{100}$

Стоимость эквайринга

$Q = P_{t} \cdot \frac{Q_{p}}{100}$

Налог

$T = P_{t} \cdot \frac{T_{p}}{100}$

Риски

$Rs = P_{t} \cdot \frac{Rs_{p}}{100}$

Все расходы

$A_{c} = C_{v} + K + M + Q + T + Rs + B + W + L + Rt + Sh$

Итоговый профит

$F = P_{t} - A_{c}$

Profit fee Ozon: tax-system "diff"

Как расчитывается профит исходя из итоговой цены и прочих параметров для системы налогооблажения "diff" для Ozon.
Система налогооблажения diff подразумевает, что налог будет расчитан от чистой прибыли: доход минус расход.

• Переменные и обозначения:

• Идея расчета:

• Порядок расчета:

Price fee Ozon: tax-system "simple"

Как расчитывается цена с учетом системы налогооблажения "simple" для Ozon.
Система налогооблажения diff подразумевает, что налог будет расчитан от стоимости товара.

• Переменные и обозначения:

• Идея расчета:

• Формула:

Price fee Ozon: tax-system "diff"

Как расчитывается цена с учетом системы налогооблажения "diff" для Ozon.
Система налогооблажения diff подразумевает, что налог будет расчитан от чистой прибыли: доход минус расход.

• Переменные и обозначения:

• Идея расчета:

• Формула:

Wildberries

Logistics fee FBS wildberries

Как расчитывается стомость для логистики FBS.

Стоимость логистики для FBS расчитывается так же как и стоимость логистики для FBO, но индекс локализации всегда равен 1.

Logistics fee FBO wildberries

Как расчитывается стомость для логистики FBO.

• Переменные и обозначения

Обозначение	Параметр	Описание
$V$	box_volume	Объём упаковки в литрах
$I$	local_index	Индекс локализации
$C_{\text{base}}$	base_price	Базовая стоимость логистики за объем $V \gt 1$
$C_{\text{min1}}$	min_lim_1_price	Стоимость логистики за малый объём $0 \lt V \leq 0.2$ литров
$C_{\text{min2}}$	min_lim_2_price	Стоимость логистики за малый объём $0.2 \lt V \leq 0.4$ литров
$C_{\text{min3}}$	min_lim_3_price	Стоимость логистики за малый объём $0.4 \lt V \leq 0.6$ литров
$C_{\text{min4}}$	min_lim_4_price	Стоимость логистики за малый объём $0.6 \lt V \leq 0.8$ литров
$C_{\text{min5}}$	min_lim_5_price	Стоимость логистики за малый объём $0.8 \lt V \leq 1$ литра
$C_{\text{vol}}$	volume_factor	Стоимость логистики за каждый дополнительный литр

• Идея расчета

  Если объем упаковки от 0.001 до 0.2 литров включительно, то стоимость логистики расчитывается как произведение min_lim_1_price * local_index:
  $L = C_{\text{min1}} \cdot I$

  Если объем упаковки от 0.2 до 0.4 литров включительно, то стоимость логистики расчитывается как произведение min_lim_2_price * local_index:
  $L = C_{\text{min2}} \cdot I$

  Если объем упаковки от 0.4 до 0.6 литров включительно, то стоимость логистики расчитывается как произведение min_lim_3_price * local_index:
  $L = C_{\text{min3}} \cdot I$

  Если объем упаковки от 0.6 до 0.8 литров включительно, то стоимость логистики расчитывается как произведение min_lim_4_price * local_index:
  $L = C_{\text{min4}} \cdot I$

  Если объем упаковки от 0.8 до 1 литра включительно, то стоимость логистики расчитывается как произведение min_lim_4_price * local_index:
  $L = C_{\text{min5}} \cdot I$

  Если объем упаковки 1 литро более, то стоимость логистики расчитывается как:
  (base_price + (box_volume - 1) * volume_factor) * local_index:
  $L = (C_{\text{base}} + (V - 1) \cdot C_{\text{vol}}) \cdot I$

• Формула

$$ L(V) = \begin{cases} C_{\text{min1}} \cdot I & 0 \lt V \leq 0.2 \\[6pt] C_{\text{min2}} \cdot I & 0.2 \lt V \leq 0.4 \\[6pt] C_{\text{min3}} \cdot I & 0.4 \lt V \leq 0.6 \\[6pt] C_{\text{min4}} \cdot I & 0.6 \lt V \leq 0.8 \\[6pt] C_{\text{min5}} \cdot I & 0.8 \lt V \leq 1 \\[6pt] (C_{\text{base}} + (V - 1) \cdot C_{\text{vol}}) \cdot I & V \gt 1 \\[6pt] \end{cases} $$

Returns fee Wildberries

Как расчитывается стоимость невыкупов.

• Переменные и обозначения:

Обозначение	Параметр	Описание
$r$	redemption_percentage	Процент выкупа
$L$	logistics_fee	Стоимость логистики для одного товара
$P$	nonredemption_processing_cost	Стоимость обработки одного возврата
$F$	returns_fee	Стоимость возвратов при текущем $r$

• Идея расчета:

  Берем базовую выборку в 100 отправленных заказов.
  Все сто заказов будут доставлены до ПВЗ покупателя, поэтому логистика оплачивается за все 100 отправлений: $100L$.
  Часть заказов будет возвращена отправителю - за них должна быть оплачена стоимость обработки возвратов: $P(100 - r)$.
  Суммарные затраты распределяются только на выкупленные заказы $r$: $\frac{100L + P(100 - r)}{r}$.
  После чего из получившегося значения вычитается L , иначе она будет учитана 2 раза*.

  *Отталкиваемся от того, что при расчете итоговой цены товара логистика уже была включена в цену, а returns_fee это дополнение к итоговой цене, которое стремится покрыть стоимость возможного процента невыкупов.

• Формула (сырая):

  $F = \frac{100L + P(100 - r)}{r} - L$

• Формула (обычная):

  $F = \frac{P(100 - r) + L(100 - r)}{r}$

• Формула (чистая):
  Расчет происходит по этой формуле

  $F = \frac{(P + L)(100 - r)}{r}$

Profit fee Wildberries: tax-system "simple"

Как расчитывается профит исходя из итоговой цены и прочих параметров для системы налогооблажения "simple" для Wildberries.
Система налогооблажения simple подразумевает, что налог будет расчитан от стоимости товара.

• Переменные и обозначения:

Обозначение	Параметр	Описание
$C$	count	Количество товаров в упаковке
$C_{p}$	cost_per_one	Себестоимость единицы товара
$C_{v}$	cost_value	Себестоимость товара
$K_{p}$	comission_percent	Процент комиссии маркетплейса
$K$	comission_fee	Стоимость комиссии в рублях
$Q_{p}$	acquiring_percent	Процент эквайринга маркетплейса
$Q$	acquiring_fee	Стоимость эквайринга в рублях
$T_{p}$	tax_percent	Процент налога
$T$	tax_fee	Стоимость налога в рублях
$Rs_{p}$	risk_percent	Процент рисков
$Rs$	risk_fee	Стоимость рисков в рублях
$B$	box_cost	Стоимость упаковки
$W$	wage_cost	Стоимость труда
$L$	logistics_fee	Стоимость логистики
$Rt$	returns_fee	Стоимость возвратов
$A_{c}$	all_costs	Все расходы
$P_{t}$	total_price	Цена товара на маркетплейсе
$F$	total_profit	Итоговый профит

• Идея расчета:

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

  • cебестоимость товара
  • стоимость комиссии
  • стоимость эквайринга
  • налог
  • риски
  • стоимость логистики
  • стоимость возвратов
    Далее, все расходы вычитаются из цены товара на маркетрлейсе.

• Порядок расчета:

Себестоимсть товара
$C_{v} = C_{p} \cdot C$

Стоимость комиссии
$K = P_{t} \cdot \frac{K_{p}}{100}$

Стоимость эквайринга
$Q = P_{t} \cdot \frac{Q_{p}}{100}$

Налог
$T = P_{t} \cdot \frac{T_{p}}{100}$

Риски
$Rs = P_{t} \cdot \frac{Rs_{p}}{100}$

Все расходы
$A_{c} = C_{v} + K + Q + T + Rs + B + W + L + Rt$

Итоговый профит
$F = P_{t} - A_{c}$

Profit fee Wildberries: tax-system "diff"

Как расчитывается профит исходя из итоговой цены и прочих параметров для системы налогооблажения "diff" для Wildberries.
Система налогооблажения diff подразумевает, что налог будет расчитан от чистой прибыли: доход минус расход.

• Переменные и обозначения:

• Идея расчета:

• Формула:

Price fee Wildberries: tax-system "simple"

Как расчитывается цена с учетом системы налогооблажения "simple" для Wildberries.
Система налогооблажения simple подразумевает, что налог будет расчитан от стоимости товара.

• Переменные и обозначения:

• Идея расчета:

• Формула:

Price fee Wildberries: tax-system "diff"

Как расчитывается цена с учетом системы налогооблажения "diff" для Wildberries.
Система налогооблажения diff подразумевает, что налог будет расчитан от чистой прибыли: доход минус расход.

• Переменные и обозначения:

• Идея расчета:

• Формула:

---

Project structure

feature based organisation

wzcalc 

---

Calculator core package

Core package structure

Core
.
│ 
├──   __init__.py 
│ 
├──   interfaces
│    ├──   __init__.py
│    ├──   oz_interfaces.py
│    └──   wb_interfaces.py
│  
├──   services
│    ├──   __init__.py
│    ├──   oz_services.py
│    └──   wb_services.py
│ 
├──   calculators
│    ├──   __init__.py
│    ├──   common.py
│    ├──   ozon.py
│    └──   wildberries.py
│ 
└──   domain
     ├──   __init__.py
     ├──   enums.py
     ├──   oz_calcdata.py
     └──   wb_calcdata.py

Description

Пакет Core предоставляет сервисы для соответствующих расчетов. Core стремится быть независимым от фреймворка поэтому оперирует dataclass и имеет интерфейсы.

interfaces

Интерфейсы для fastapi

oz_interfaces

wb_interfaces

services

Сервисы расчетов

oz_services

oz_calculate_returns_fbs
Функция-cервис расчета стоимости возвратов для Ozon с учетом логистики FBS

oz_calculate_returns_fbo
Функция-cервис расчета стоимости возвратов для Ozon с учетом логистики FBO

oz_calculate_reverse_logistics_fee
Функция-cервис расчета стоимости обратной логистики для Ozon

oz_calculate_profit
Функция-cервис расчета стоимости профита для Ozon

wb_services

wb_calculate_returns
Функция-cервис расчета стоимости возвратов для Wildberries

calculators

Калькуляторы

common

box_volume_clc
Функция-калькулятор объема упаковки исходя из размеров в сантиметрах переданных одной строкой вида "12*10*10"

comissions_fee_clc
Функция-калькулятор фактической стоимости комиссии исходя из процента комиссии

round_decimal
Округляет значение типа данных Decimal в большую сторону до одного знака после запятой

ozon

oz_last_mile_clc
Функция-калькулятор стоимости последней мили для Ozon

oz_log_fbs_clc
Функция-калькулятор стоимости логистики FBS для Ozon

oz_log_fbo_clc
Функция-калькулятор стоимости логистики FBO для Ozon

oz_returns_clc
Функция-калькулятор стоимости возвратов для Ozon

oz_profit_ts_simple_clc
Функция-калькулятор профита исходя из цены для налооблажения % от стоимости товара для Ozon

oz_profit_ts_diff_clc
Функция-калькулятор профита исходя из цены для налооблажения % от чистой прибыли (доход - расход) для Ozon

wildberries

wb_log_clc
Функция-калькулятор стоимости логистики для Wildberries

wb_returns_clc
Функция-калькулятор стоимости возвратов для Wildberries

domain

Dataclasses

cm_calcdata

LogMainParams
local_index
box_volume

oz_calcdata

request

OzLogFbsCosts
minimal_price_fbs
base_price_fbs
volume_factor_fbs
fix_large_fbs

OzLogFboCosts
base_price_fbo
volume_factor_fbo
fix_large_fbo

OzProfitParams
tax_system
count
cost_per_one
last_mile_percent
comission_percent
acquiring_percent
tax_percent
risk_percent
box_cost
wage_cost
shipment_processing
total_price

OzBaseFees
cost_row
last_mile_fee
comission_fee
aquiring_fee

OzLogFees
box_volume
logistics_fee
reverse_logistics_fee
returns_fee

OzProfitArgs
log_params
log_fees
return_params

OzProfitResults
base_fees
tax_fee
risk_fee
total_profit

respone

OzLogFbsResponse
box_size
box_volume
local_index
minimal_price_fbs
base_price_fbs
volume_factor_fbs
fix_large_fbs
logistics_fee

OzLogFboResponse
box_size
box_volume
local_index
base_price_fbo
volume_factor_fbo
fix_large_fbo
logistics_fee

OzReturnsFbsResponse
box_size
box_volume
local_index
minimal_price_fbs
base_price_fbs
fix_large_fbs
redemption_percentage
nonredemption_processing_cost
logistics_fee
reverse_logistics_fee
returns_fee

OzReturnsFboResponse
box_size
box_volume
local_index
minimal_price_fbs
base_price_fbs
volume_factor_fbs
fix_large_fbs
base_price_fbo
volume_factor_fbo
fix_large_fbo
redemption_percentage
nonredemption_processing_cost
logistics_fee
reverse_logistics_fee
returns_fee

OzProfitFbsResponse
tax_system
local_index
box_size
minimal_price_fbs
base_price_fbs
volume_factor_fbs
fix_large_fbs
count
cost_per_one
last_mile_percent
comission_percent
tax_percent
risk_percent
box_cost
wage_cost
shipment_processing
total_price
box_volume
logistics_fee
reverse_logistics_fee
returns_fee
comission_fee
aquiring_fee
last_mile_fee
tax_fee
risk_fee
cost_row
total_profit

OzProfitFboResponse
tax_system
local_index
box_size
minimal_price_fbs
base_price_fbs
volume_factor_fbs
fix_large_fbs
base_price_fbo
volume_factor_fbo
fix_large_fbo
count
cost_per_one
last_mile_percent
comission_percent
tax_percent
risk_percent
box_cost
wage_cost
shipment_processing
total_price box_volume
logistics_fee
reverse_logistics_fee
returns_fee
comission_fee
aquiring_fee
last_mile_fee
tax_fee
risk_fee
cost_row
total_profit

wb_calcdata

request

WbLogCosts
base_price
volume_factor
min_lim_1_price
min_lim_2_price
min_lim_3_price
min_lim_4_price
min_lim_5_price

reponse

WbLogResponse
box_size
box_volume
local_index
base_price
volume_factor
logistics_fee

WbReturnsResponse
box_size
box_volume
local_index
base_price
volume_factor
redemption_percentage
nonredemption_processing_cost
logistics_fee
returns_fee

---

Endpoints

Calculations

Ozon

Метод	URL	Описание
POST	/api/v1/ozon/prices/fbs/calculate	Расчет цены для FBS-логистики
POST	/api/v1/ozon/prices/fbo/calculate	Расчет цены для FBO-логистики
POST	/api/v1/ozon/prices/fbs/bulk/calculate/	Массовый расчет цен для FBS-логистики
POST	/api/v1/ozon/prices/fbo/bulk/calculate/	Массовый расчет цен для FBO-логистики
POST	/api/v1/ozon/logistics/fbs/calculate	Расчет стоимости FBS-логистики
POST	/api/v1/ozon/logistics/fbo/calculate	Расчет стоимости FBO-логистики
POST	/api/v1/ozon/returns/fbs/calculate	Расчет стоимости возвратов для FBS-логистики
POST	/api/v1/ozon/returns/fbo/calculate	Расчет стоимости возвратов для FBO-логистики

Wildberries

Метод	URL	Описание
POST	/api/v1/wb/prices/calculate	Расчет цены
POST	/api/v1/wb/prices/bulk/calculate/	Массовый расчет цен
POST	/api/v1/wb/logistics/calculate	Расчет стоимости логистики
POST	/wb/returns/calculate	Расчет стоимости возвратов

---

Constraints

Ограничения для валидации входящих данных.

Общие

1. Все процентные значения (decimal)
   e.g. comission_percent
   gt=0, le=100, max_digits=4, decimal_places=1
   Больше 0, меньше или равно 100, не более 1 знака после запятой.
   1-100.0

2. Всё, что касается стоимости логистики (decimal)
   e.g. minimal_price_fbs
   gt=0, le=99999, max_digits=6, decimal_places=1
   Больше 0, меньше или равно 99999, не более 1 знака после запятой
   1-99999.9

3. Всё, что касается иных цен (decimal)
   e.g. cost_per_one
   ge=0, max_digits=8, decimal_places=1
   Больше или равно 0, не длинее 7 знаков целой части, не более 1 знака после занятой
   0-9999999.9

Уникальные

1. Тип поставки (string)
   fbs_fbo_option
   Допустимые значения строго "fbs" или "fbo".

2. Размеры упаковки (string)
   box_size
   Допустимые значения проверяются регулярным выражением

3. Индекс локализации (decimal)
   local_index
   gt=0, le=10, max_digits=4, decimal_places=1
   Больше 0, меньше или равно 10, не более 1 знака после запятой
   0-10.0

4. Количество товаров в упаковке (integer)
   count
   conint(ge=1, le=9999999)
   Больше или равно 1, меньше или равно 9999999
   1-9999999

Variables

Используемые переменные

Ozon

Параметр	Описание	Единица измерения
comission_percent	Процент комиссии маркетплейса	%
acquiring_percent	Процент эквайринга	%
shipment_processing	Обработка отправления	руб.
last_mile_percent	Последняя миля (процент)	%
nonredemption_processing_cost	Стоимость обработки возврата	руб.
base_price_fbo	Базовая стоимость логистики FBO	руб.
volume_factor_fbo	Стоимость логистики FBO за каждый дополнительный литр	руб./л
fix_large_fbo	Стоимость логистики FBO за объём > 190 литров	руб.
minimal_price_fbs	Стоимость логистики FBS за объём $\leq 0{,}4$ литров	руб.
base_price_fbs	Базовая стоимость логистики FBS	руб.
volume_factor_fbs	Стоимость логистики FBS за каждый дополнительный литр	руб./л
fix_large_fbs	Стоимость логистики FBS за объём > 190 литров	руб.
cost_per_one	Цена за единицу товара	руб./ед.
count	Количество товара в упаковке	ед.
total_price	Цена товара	руб.
tax_system	Система налогообложения	— (simple/diff)
tax_percent	Процент налога	%
risk_percent	Процент рисков	%
local_index	Индекс локализации	—
box_size	Размер упаковки	см × см × см
wage_cost	Стоимость труда	руб.
box_cost	Стоимость упаковки	руб.
redemption_percentage	Процент выкупа	%
box_volume	Объём упаковки в литрах	л
logistics_fee	Итоговая стоимость логистики	руб.
reverse_logistics_fee	Стоимость обратной логистики (возвраты)	руб.
returns_fee	Стоимость возвратов	руб.
cost_row	Себестоимость товара ($count \cdot cost_per_one$)	руб.
comission_fee	Стоимость комиссии маркетплейса	руб.
aquiring_fee	Стоимость эквайринга	руб.
last_mile_fee	Стоимость последней мили	руб.
tax_fee	Налог	руб.
risk_fee	Риски	руб.
total_profit	Прибыль при текущей цене	руб.

Wildberries

Параметр	Описание	Единица измерения
comission_percent	Процент комиссии маркетплейса	%
acquiring_percent	Процент эквайринга	%
nonredemption_processing_cost	Стоимость обработки возврата	руб.
base_price	Базовая стоимость логистики	руб.
volume_factor	Стоимость логистики за каждый дополнительный литр	руб./л
min_lim_1_price	Стоимость логистики за объём от 0.001 литра до 0.2 литров	руб.
min_lim_2_price	Стоимость логистики за объём от 0.2 литра до 0.4 литров	руб.
min_lim_3_price	Стоимость логистики за объём от 0.4 литра до 0.6 литров	руб.
min_lim_4_price	Стоимость логистики за объём от 0.6 литра до 0.8 литров	руб
min_lim_5_price	Стоимость логистики за объём от 0.8 литра до 1 литра	руб.
cost_per_one	Цена за единицу товара	руб./ед.
count	Количество товара в упаковке	ед.
total_price	Цена товара	руб.
tax_system	Система налогообложения	— (simple/diff)
tax_percent	Процент налога	%
risk_percent	Процент рисков	%
local_index	Индекс локализации	—
box_size	Размер упаковки	см × см × см
wage_cost	Стоимость труда	руб.
box_cost	Стоимость упаковки	руб.
redemption_percentage	Процент выкупа	%
box_volume	Объём упаковки в литрах	л
logistics_fee	Итоговая стоимость логистики	руб.
reverse_logistics_fee	Стоимость обратной логистики (возвраты)	руб.
returns_fee	Стоимость возвратов	руб.
cost_row	Себестоимость товара ($count \cdot cost_per_one$)	руб.
comission_fee	Стоимость комиссии маркетплейса	руб.
aquiring_fee	Стоимость эквайринга	руб.
last_mile_fee	Стоимость последней мили	руб.
tax_fee	Налог	руб.
risk_fee	Риски	руб.
total_profit	Прибыль при текущей цене	руб.

---

References

fast api best practices