Реалізація мультипостачальницького дропшипінгу

Реалізація мультипоставщикового дропшиппінгу

Робота з кількома постачальниками вирішує дві задачи: розширення ассортименту та страховочна резервація — коли у основного постачальника кінчився товар, замовлення йде до резервного. Технічно це значно складніше одиночного постачальника: потрібно керувати конкуруючими цінами на один артикул, приоритетами, правилами маршрутизації замовлень та консолідацією остатків.

Ключові концепції

Supplier routing — логіка вибору постачальника для конкретного замовлення. Може враховувати: наявність товару, ціну, приоритет, регіон доставки, швидкість обробки.

Product mapping — один товар у каталозі магазину може відповідати артикулам кількох постачальників. Потрібна таблиця відповідностей.

Price aggregation — якщо кілька постачальників пропонують один товар, ціна в каталозі формується на основі найкращої закупочної ціни.

Stock consolidation — агрегований остаток за всіма постачальниками або тільки за приоритетним.

Схема даних

// Один товар → кілька постачальників
Schema::create('product_supplier_mappings', function (Blueprint $table) {
    $table->id();
    $table->foreignId('product_id')->constrained();
    $table->foreignId('supplier_id')->constrained('dropship_suppliers');
    $table->string('supplier_sku');
    $table->integer('priority')->default(10); // менше = вищий приоритет
    $table->decimal('supplier_price', 10, 2)->nullable();
    $table->integer('supplier_stock')->default(0);
    $table->boolean('is_active')->default(true);
    $table->timestamp('price_synced_at')->nullable();
    $table->timestamp('stock_synced_at')->nullable();

    $table->unique(['product_id', 'supplier_id']);
    $table->index(['product_id', 'is_active', 'priority']);
});

Маршрутизатор постачальника

class SupplierRouter
{
    /**
     * Вибрати оптимального постачальника для позиції замовлення
     */
    public function route(OrderItem $item, RoutingStrategy $strategy): ?ProductSupplierMapping
    {
        $candidates = ProductSupplierMapping::where('product_id', $item->product_id)
            ->where('is_active', true)
            ->where('supplier_stock', '>=', $item->quantity)
            ->with('supplier')
            ->orderBy('priority')
            ->get();

        if ($candidates->isEmpty()) {
            return null; // немає доступних постачальників
        }

        return $strategy->select($candidates, $item);
    }
}

// Стратегія: мінімальна закупочна ціна
class CheapestSupplierStrategy implements RoutingStrategy
{
    public function select(Collection $candidates, OrderItem $item): ProductSupplierMapping
    {
        return $candidates->sortBy('supplier_price')->first();
    }
}

// Стратегія: максимальний приоритет (налаштовується вручну)
class PrioritySupplierStrategy implements RoutingStrategy
{
    public function select(Collection $candidates, OrderItem $item): ProductSupplierMapping
    {
        return $candidates->sortBy('priority')->first();
    }
}

// Стратегія: найближчий склад до адреси доставки (потрібні координати складів)
class NearestWarehouseStrategy implements RoutingStrategy
{
    public function select(Collection $candidates, OrderItem $item): ProductSupplierMapping
    {
        $deliveryCoords = $this->geocode($item->order->delivery_address);

        return $candidates->sortBy(function ($mapping) use ($deliveryCoords) {
            $warehouse = $mapping->supplier->primaryWarehouse;
            return $this->haversineDistance($deliveryCoords, $warehouse->coordinates);
        })->first();
    }
}

Агрегація цін

class MultiSupplierPriceAggregator
{
    /**
     * Вичислити розничну ціну на основі найкращої закупочної ціни серед постачальників
     */
    public function aggregate(Product $product): float
    {
        $bestMapping = ProductSupplierMapping::where('product_id', $product->id)
            ->where('is_active', true)
            ->where('supplier_stock', '>', 0)
            ->whereNotNull('supplier_price')
            ->orderBy('supplier_price')
            ->first();

        if (!$bestMapping) {
            // Всі постачальники не мають товару — залишаємо поточну ціну
            return $product->price;
        }

        return $this->calculator->calculate(
            supplierPrice: $bestMapping->supplier_price,
            marginRule: $this->resolveMarginRule($product, $bestMapping->supplier),
        );
    }
}

Консолідація остатків

class StockConsolidator
{
    public function getDisplayStock(Product $product, string $mode = 'sum'): int
    {
        $mappings = ProductSupplierMapping::where('product_id', $product->id)
            ->where('is_active', true)
            ->get();

        return match($mode) {
            // Сума всіх постачальників (показуємо 999+, якщо > 100)
            'sum'      => min($mappings->sum('supplier_stock'), 9999),
            // Тільки приоритетний постачальник
            'priority' => $mappings->sortBy('priority')->first()?->supplier_stock ?? 0,
            // Максимум серед постачальників
            'max'      => $mappings->max('supplier_stock') ?? 0,
            // Булево: є хоча б у одного постачальника
            'any'      => $mappings->where('supplier_stock', '>', 0)->isNotEmpty() ? 1 : 0,
        };
    }
}

Розподіл позицій замовлення за постачальниками

Одне замовлення з кількома позиціями може йти до різних постачальників:

class OrderSplitter
{
    public function split(Order $order): Collection
    {
        $groups = collect();

        foreach ($order->items as $item) {
            $mapping = $this->router->route($item, new PrioritySupplierStrategy());

            if (!$mapping) {
                throw new NoSupplierAvailableException($item->product);
            }

            $supplierId = $mapping->supplier_id;

            if (!$groups->has($supplierId)) {
                $groups->put($supplierId, [
                    'supplier'  => $mapping->supplier,
                    'items'     => collect(),
                ]);
            }

            $groups[$supplierId]['items']->push([
                'item'        => $item,
                'supplier_sku' => $mapping->supplier_sku,
            ]);
        }

        return $groups;
    }
}

Fallback при нестачі товару

Якщо приоритетний постачальник не може виконати замовлення повністю:

public function routeWithFallback(OrderItem $item): array
{
    $remaining = $item->quantity;
    $allocations = [];

    $mappings = ProductSupplierMapping::where('product_id', $item->product_id)
        ->where('is_active', true)
        ->where('supplier_stock', '>', 0)
        ->orderBy('priority')
        ->get();

    foreach ($mappings as $mapping) {
        if ($remaining <= 0) break;

        $take = min($remaining, $mapping->supplier_stock);
        $allocations[] = ['mapping' => $mapping, 'quantity' => $take];
        $remaining -= $take;
    }

    if ($remaining > 0) {
        throw new InsufficientMultiSupplierStockException($item, $remaining);
    }

    return $allocations;
}

Звітність за постачальниками

В адміністративній панелі відображається:

• Оборот за кожним постачальником
• Середній час виконання замовлень
• Відсоток відмов (товара не виявилось після прийму замовлення)
• Динаміка закупочних цін

Терміни реалізації

Итого: 15–20 робочих днів в залежності від кількості постачальників та складності правил маршрутизації.