WZCalc

About

Простой калькулятор для предварительного расчета цены товаров для маркетплейсов 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
    • Price fee Ozon
  • Wildberries
    • Logistics FBS
    • Logistics FBO
    • Returns
    • Profit
    • Price
• 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

Документация для калькулятора.

How is this calculated?
В этом разделе можно ознакомится с тем, как просходит расчет составляющих цены.

Project structure
Структура проекта.

Calculator core package
Краткое описание ядра калькулятора для расчетов, с описанием интерфейсов, сервисов, калькуляторов и используемых структур данных.

Endpoints
Описание endpoints.

Constraints
Описание ограничений для входных данных.

Variable
Расшифровка используемых имен переменных.

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

---

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 (процент выкупа), $r \in N \cap [1, 100]$
  $L$ - logistics_fee (стоимость логистики для одного товара)
  $R$ - reverse_logistics_fee (стоимость обратной логистики для одного невыкупленного товара)
  $P$ - nonredemption_processing_cost (стоимость обработки одного возврата), $P \in N$
  $F$ - returns_fee (стоимость возвратов при текущем redemption_percentage)

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

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

• Формула:

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

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

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

Profit fee Ozon

Price fee Ozon

Wildberries

Logistics FBS

Logistics FBO

Returns

Profit

Price

---

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

wb_services

calculators

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

common

ozon

wildberries

domain

Dataclasses

oz_calcdata

wb_calcdata

---

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

input

tax_system: Система налогооблажения str ['simple', 'difference']

profit_percent: Желаемый профит - в процентах от себестоимость
comission_percent: Процент комиссии маркетплейса
acquiring_percent: Процент эквайринга
tax_percent: Процент налога
risk_percent: Процент рисков
redemption_percentage: Процент выкупа
last_mile_percent: Процент последняя миля

shipment_processing: Стоимость обработки отправления
count: Количество товаров в комплекте
cost_per_one: Стоимость единицы товара
wage_cost: Стоимость труда
box_cost: Стоимость упаковки

box_size: Размеры упаковки
local_index: Индекс локализации
nonredemption_processing_cost: Стоимость обработки одного возврата

minimal_price_fbs: Стоимость логистики FBS для упаковки объемом менее 0.4 литра
base_price_fbs: Базовая стоимость логистики FBS
volume_factor_fbs: Стоимость логистики FBS за каждый дополнительный литр для упавки объемом более 1 литра
fix_large_fbs: Стоимость логистики FBS для упаковки объемом более 190 литров

base_price_fbo: Базовая стоимость логистики FBO
volume_factor_fbo: Стоимость логистики FBO за каждый дополнительный литр для упавки объемом более 1 литра
fix_large_fbo: Стоимость логистики FBO для упаковки объемом более 190 литров

output

Wildberries

---

References

fast api best practices