Реализация автоматического расчёта маржи при дропшиппинге

Реализация автоматического расчёта маржи при дропшиппинге

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

Что влияет на итоговую маржу

• Закупочная цена — меняется при каждой синхронизации прайса поставщика
• Комиссия эквайринга — 1.5–3.5% в зависимости от платёжной системы
• Стоимость доставки — может компенсироваться или включаться в цену
• Возвраты — статистический процент, закладывается в наценку
• Реклама — CAC (cost per acquisition) для расчёта точки безубыточности

Модель правил маржи

Schema::create('margin_rules', function (Blueprint $table) {
    $table->id();
    $table->string('name');
    $table->enum('scope', ['global', 'supplier', 'category', 'product']);
    $table->nullableMorphs('scopeable'); // polymorphic: Supplier, Category, Product
    $table->enum('type', ['percent', 'fixed', 'table']);
    $table->decimal('value', 8, 2)->nullable(); // для percent и fixed
    $table->jsonb('table_config')->nullable(); // для type=table
    $table->decimal('min_retail_price', 10, 2)->nullable(); // нижняя граница розничной цены
    $table->boolean('include_acquiring', true)->default(true);
    $table->decimal('acquiring_percent', 5, 2)->default(2.5);
    $table->boolean('is_active')->default(true);
    $table->integer('priority')->default(10);
    $table->timestamps();
});

Полный калькулятор маржи

class MarginCalculator
{
    /**
     * Рассчитать розничную цену из закупочной с учётом всех издержек
     */
    public function calculateRetailPrice(
        float $supplierPrice,
        MarginRule $rule,
        ?float $shippingCost = null,
    ): float {
        // Базовая розничная цена по правилу наценки
        $baseRetail = match($rule->type) {
            'percent' => $supplierPrice * (1 + $rule->value / 100),
            'fixed'   => $supplierPrice + $rule->value,
            'table'   => $this->applyTable($supplierPrice, $rule->table_config),
        };

        // Учитываем комиссию эквайринга (добавляем к цене, чтобы покупатель фактически платил нам нетто)
        if ($rule->include_acquiring) {
            $baseRetail = $baseRetail / (1 - $rule->acquiring_percent / 100);
        }

        // Учитываем стоимость доставки, если она включается в цену
        if ($shippingCost && $rule->include_shipping) {
            $baseRetail += $shippingCost;
        }

        // Применяем нижнюю границу
        if ($rule->min_retail_price && $baseRetail < $rule->min_retail_price) {
            $baseRetail = $rule->min_retail_price;
        }

        return round($baseRetail, 2);
    }

    /**
     * Рассчитать фактическую маржу для отчётов
     */
    public function calculateMargin(float $retailPrice, float $supplierPrice, float $acquiringPercent = 2.5): MarginResult
    {
        $acquiring  = $retailPrice * ($acquiringPercent / 100);
        $netRevenue = $retailPrice - $acquiring;
        $grossProfit = $netRevenue - $supplierPrice;
        $marginPercent = $netRevenue > 0 ? ($grossProfit / $netRevenue) * 100 : 0;

        return new MarginResult(
            retailPrice:    $retailPrice,
            supplierPrice:  $supplierPrice,
            acquiring:      round($acquiring, 2),
            netRevenue:     round($netRevenue, 2),
            grossProfit:    round($grossProfit, 2),
            marginPercent:  round($marginPercent, 2),
        );
    }

    /**
     * Ступенчатая наценка по таблице
     */
    private function applyTable(float $price, array $table): float
    {
        // Пример table_config:
        // [{"max_price": 500, "percent": 50}, {"max_price": 2000, "percent": 35},
        //  {"max_price": 10000, "percent": 25}, {"max_price": null, "percent": 15}]
        foreach ($table as $tier) {
            if ($tier['max_price'] === null || $price <= $tier['max_price']) {
                return $price * (1 + $tier['percent'] / 100);
            }
        }
        return $price * 1.15; // fallback
    }
}

Resolver правил маржи

Правила применяются в порядке специфичности: товар > категория > поставщик > глобальные.

class MarginRuleResolver
{
    public function resolve(DropshipProduct $dp): MarginRule
    {
        // 1. Индивидуальное правило для конкретного товара
        $rule = MarginRule::where('scope', 'product')
            ->where('scopeable_type', Product::class)
            ->where('scopeable_id', $dp->product_id)
            ->active()
            ->orderBy('priority')
            ->first();

        if ($rule) return $rule;

        // 2. Правило для категории товара
        if ($dp->product?->category_id) {
            $categoryIds = $dp->product->category->ancestorsAndSelf()->pluck('id');
            $rule = MarginRule::where('scope', 'category')
                ->where('scopeable_type', Category::class)
                ->whereIn('scopeable_id', $categoryIds)
                ->active()
                ->orderBy('priority')
                ->first();

            if ($rule) return $rule;
        }

        // 3. Правило для поставщика
        $rule = MarginRule::where('scope', 'supplier')
            ->where('scopeable_type', Supplier::class)
            ->where('scopeable_id', $dp->supplier_id)
            ->active()
            ->first();

        if ($rule) return $rule;

        // 4. Глобальное правило по умолчанию
        return MarginRule::where('scope', 'global')->active()->firstOrFail();
    }
}

Автоматический пересчёт при изменении закупочной цены

class RecalculateRetailPriceListener
{
    public function handle(SupplierPriceUpdatedEvent $event): void
    {
        $dp   = $event->dropshipProduct;
        $rule = $this->resolver->resolve($dp);

        if (!$dp->product || $dp->product->price_locked) {
            return; // цена зафиксирована вручную — не трогаем
        }

        $newRetailPrice = $this->calculator->calculateRetailPrice(
            supplierPrice: $dp->supplier_price,
            rule: $rule,
        );

        $dp->product->update(['price' => $newRetailPrice]);

        Log::debug('Retail price recalculated', [
            'product_id'    => $dp->product_id,
            'supplier_price' => $dp->supplier_price,
            'retail_price'  => $newRetailPrice,
            'rule'          => $rule->name,
        ]);
    }
}

Отчёт по марже

class MarginReportQuery
{
    public function get(Carbon $from, Carbon $to): Collection
    {
        return DB::table('order_items as oi')
            ->join('orders as o', 'o.id', '=', 'oi.order_id')
            ->join('products as p', 'p.id', '=', 'oi.product_id')
            ->join('dropship_products as dp', 'dp.product_id', '=', 'p.id')
            ->join('dropship_suppliers as s', 's.id', '=', 'dp.supplier_id')
            ->whereBetween('o.paid_at', [$from, $to])
            ->where('o.status', 'completed')
            ->selectRaw('
                s.name as supplier,
                SUM(oi.quantity * oi.price) as revenue,
                SUM(oi.quantity * dp.supplier_price) as cost,
                SUM(oi.quantity * (oi.price - dp.supplier_price)) as gross_profit,
                ROUND(
                    SUM(oi.quantity * (oi.price - dp.supplier_price)) /
                    NULLIF(SUM(oi.quantity * oi.price), 0) * 100, 2
                ) as margin_percent
            ')
            ->groupBy('s.id', 's.name')
            ->orderByDesc('gross_profit')
            ->get();
    }
}

Сроки

Базовый калькулятор (процентная наценка) + автопересчёт при синхронизации цен — 2–3 рабочих дня. Ступенчатые правила, иерархия приоритетов, учёт эквайринга, отчёт по марже — 3–5 рабочих дней.