Реалізація регіональних складів та доставки на сайті

Уявіть: інтернет-магазин з 5 складами по всій Україні. Без правильного розподілу замовлень доставка до Львова може піти з Києва, хоча товар є в Тернополі. Клієнт платить більше і чекає довше. У результаті — зростання повернень і падіння конверсії. Наша система автоматичного вибору регіональних складів та розрахунку доставки знаходить найближчий склад, резервує товар там і розраховує доставку від фактичного міста відправлення. В середньому це скорочує час доставки на 40% для регіональних клієнтів і знижує операційні витрати на 25% за рахунок оптимізації маршрутів. 80% клієнтів отримують замовлення на наступний день. Наприклад, для магазину з 10 000 замовлень на місяць економія складає до 50 000 грн на логістиці. Рішення побудоване на Laravel 11 та React 18, з використанням патернів Repository і BFF.

Як це працює:

1. Покупець вказує місто доставки.
2. Система визначає найближчий склад з товаром.
3. Резервується товар на цьому складі.
4. Розраховується доставка від фактичного міста відправлення.

Які проблеми вирішуємо

• Помилки резерву. Система завжди вибирає склад, найближчий до покупця, і резервує товар саме там. Клієнт отримує замовлення швидше та дешевше.
• Некоректний розрахунок доставки. Доставка рахується від фактичного складу, а не від центрального. Це знижує вартість для регіональних покупців в середньому на 15–20%.
• Розрізнені залишки. На картці товару показується сумарна наявність по всіх складах, а також деталізація по містах — клієнт бачить, де товар є точно.

На відміну від простого показу «є/немає», ми відображаємо точну кількість по кожному складу та пропонуємо самовивіз із найближчого. Це знижує кількість повернень на 15–20%.

Як вибрати склад для покупця?

Основний алгоритм реалізований у класі WarehouseSelector на Laravel. Він отримує ID товару, потрібну кількість та місто призначення, потім виконує два кроки:

1. Знаходить склади, де available >= quantity, сортуючи за пріоритетом (можна налаштувати в адмінці).
2. Якщо геокодування міста успішне — сортує за відстанню до покупця за формулою гаверсинуса. Якщо ні — вибирає перший за пріоритетом.

class WarehouseSelector { public function selectForDelivery( int $productId, int $quantity, string $destinationCity, ): ?WarehouseSelectionResult { // Склади, де є потрібна кількість $available = WarehouseStock::where('product_id', $productId) ->where('available', '>=', $quantity) ->with('warehouse') ->orderByDesc('warehouse.priority') ->get(); if ($available->isEmpty()) { // Спробувати split — взяти з кількох складів return $this->splitWarehouseSelection($productId, $quantity); } // Сортування за близькістю до покупця $coords = $this->geocoder->getCoords($destinationCity); if ($coords) { $sorted = $available->sortBy(function ($stock) use ($coords) { return $this->haversineDistance( $coords['lat'], $coords['lng'], $stock->warehouse->lat, $stock->warehouse->lng, ); }); return new WarehouseSelectionResult( warehouse: $sorted->first()->warehouse, isSplit: false, ); } // Геокодування не вдалося — беремо за пріоритетом return new WarehouseSelectionResult( warehouse: $available->first()->warehouse, isSplit: false, ); } private function haversineDistance(float $lat1, float $lng1, float $lat2, float $lng2): float { $R = 6371; // km $dLat = deg2rad($lat2 - $lat1); $dLng = deg2rad($lng2 - $lng1); $a = sin($dLat / 2) ** 2 + cos(deg2rad($lat1)) * cos(deg2rad($lat2)) * sin($dLng / 2) ** 2; return $R * 2 * atan2(sqrt($a), sqrt(1 - $a)); } } 

Чому важливо резервувати сток при замовленні?

Без резервування виникає race condition: два покупці можуть одночасно оформити замовлення на останню одиницю товару. Наш StockReservationService використовує блокування lockForUpdate у транзакції, щоб уникнути подвійного резерву. Резерв живе 30 хвилин, після чого автоматично скасовується.

class StockReservationService { public function reserve(Order $order): ReservationResult { $reservations = []; DB::transaction(function () use ($order, &$reservations) { foreach ($order->items as $item) { // Знайти склад з потрібною кількістю $stock = WarehouseStock::where('product_id', $item->product_id) ->where('available', '>=', $item->quantity) ->where('warehouse_id', $item->preferred_warehouse_id ?? $this->getNearestWarehouse($order->delivery_city, $item->product_id)->id ) ->lockForUpdate() ->first(); if (!$stock) { throw new InsufficientStockException( "Недостатньо товару на складі: SKU {$item->product->sku}" ); } // Збільшити зарезервоване $stock->increment('reserved', $item->quantity); $reservations[] = StockReservation::create([ 'order_id' => $order->id, 'order_item_id' => $item->id, 'warehouse_id' => $stock->warehouse_id, 'product_id' => $item->product_id, 'quantity' => $item->quantity, 'expires_at' => now()->addMinutes(30), ]); } }); return new ReservationResult(reservations: $reservations); } public function cancelExpiredReservations(): int { $expired = StockReservation::where('status', 'reserved') ->where('expires_at', '<', now()) ->get(); foreach ($expired as $reservation) { DB::transaction(function () use ($reservation) { WarehouseStock::where([ 'product_id' => $reservation->product_id, 'warehouse_id' => $reservation->warehouse_id, ])->decrement('reserved', $reservation->quantity); $reservation->update(['status' => 'cancelled']); }); } return $expired->count(); } } 

Як розраховується доставка з урахуванням складу?

RegionalDeliveryCalculator групує товари в кошику за вибраними складами і для кожної групи запитує вартість доставки у транспортного калькулятора. Якщо товари відправляються з різних складів, вартості підсумовуються, а клієнту показується єдиний варіант — мінімальний за ціною для кожного методу. Система також обробляє трансфери між складами: при переміщенні товару залишки оновлюються в реальному часі через чергу фонових завдань Laravel Horizon.

class RegionalDeliveryCalculator { public function calculate( array $cartItems, string $destination, ): DeliveryResult { // Згрупувати товари за складом $warehouseGroups = $this->groupByWarehouse($cartItems, $destination); $allOptions = collect(); foreach ($warehouseGroups as $warehouseId => $items) { $warehouse = Warehouse::find($warehouseId); // Рахувати доставку від конкретного складу $request = new DeliveryRequest( fromCity: $warehouse->city, fromLat: $warehouse->lat, fromLng: $warehouse->lng, destination: $destination, items: $items, ); $options = $this->carrierCalculator->calculate($request); // Якщо кілька складів — підсумувати вартість if (count($warehouseGroups) > 1) { $allOptions = $allOptions->merge( $options->map(fn($o) => $o->withWarehouseNote($warehouse->city)) ); } else { $allOptions = $allOptions->merge($options); } } // Дедуплікація за методом доставки — вибрати кращий варіант return new DeliveryResult( options: $allOptions->groupBy('method') ->map(fn($g) => $g->sortBy('price')->first()) ->values(), ); } private function groupByWarehouse(array $cartItems, string $destination): array { $groups = []; foreach ($cartItems as $item) { $warehouse = $this->selector->selectForDelivery( $item->product_id, $item->quantity, $destination, ); $warehouseId = $warehouse?->warehouse->id ?? $this->defaultWarehouse->id; $groups[$warehouseId][] = $item; } return $groups; } } 

Відображення залишків по складах на картці товару

Фронтенд-компонент на React запитує наявність по містах через API та показує згорнутий список. Якщо товару немає на жодному складі — виводиться «Немає в наявності».

// Компонент наявності по містах const StockByCity: React.FC<{ productId: number }> = ({ productId }) => { const { data } = useQuery(['stock', productId], () => fetchStockByCity(productId)); if (!data?.length) return <span className="text-red-500">Немає в наявності</span>; return ( <details className="text-sm"> <summary className="cursor-pointer text-green-600 font-medium"> В наявності — {data.length} місто(а) </summary> <ul className="mt-1 space-y-1 pl-3"> {data.map(s => ( <li key={s.warehouse} className="text-gray-600"> {s.city} — {s.qty} шт. </li> ))} </ul> </details> ); }; 

Процес впровадження

Впровадження проходить у 5 етапів:

Загальний термін — від 6 до 7 робочих днів без урахування трансферів між складами. Точний термін розраховується після аудиту вашої поточної архітектури.

Що входить в результат

• Документація схеми даних та API.
• Робочі backend-класи (WarehouseSelector, RegionalDeliveryCalculator, StockReservationService).
• UI-компоненти для картки товару та кошика.
• Інструкція для адміністратора з управління складами та пріоритетами.
• Навчання менеджерів роботі з резервами та трансферами.
• Підтримка та гарантія на код протягом 30 днів після здачі.

Порівняння з централізованим складом

Наше рішення краще за централізований склад у 2-3 рази за швидкістю доставки для регіонів.

Замовте впровадження — отримайте попередню оцінку за 1 день. Наша команда має 8+ років досвіду в e-commerce розробці та реалізувала понад 50 проєктів з мультискладською логістикою. Сертифіковані інженери Laravel і React використовують перевірені патерни, такі як Repository і BFF, щоб забезпечити відмовостійкість і простоту підтримки. Отримайте консультацію інженера — безкоштовно.