Розробка калькулятора доставки для інтернет-магазину

Розробка калькулятора доставки – ключове завдання для e-commerce. Покупець додає товари в кошик, переходить до оформлення і бачить несподівано високу вартість доставки. За даними досліджень, неочікувана вартість доставки — причина 60% покинутих кошиків. Калькулятор доставки, що попередньо показує вартість, вирішує цю проблему і підвищує конверсію на 15–30%. Реалізація такого калькулятора — нетривіальне завдання: потрібно врахувати об'ємну вагу, інтегруватися з API кількох служб доставки (СДЭК, Boxberry, Пошта Росії), забезпечити відмовостійкість і швидкість розрахунків. Запити до API займають 200–800 мс і часто платні, тому потрібне грамотне кешування та паралельна обробка. Ми розглянемо технічні деталі: від зберігання тарифів у базі до паралельних запитів і обробки помилок. Наведемо приклади коду на Laravel і React, розповімо про кешування та роботу з об'ємною вагою. Впровадження агрегатора окупається за 2–3 місяці, економлячи до 30% на доставці. При обороті 100 000 грн на місяць економія може сягати 25 000 грн щомісяця.

Наша команда має 5+ років досвіду в e-commerce розробці та реалізувала 20+ калькуляторів доставки. Ми надаємо гарантію на працездатність калькулятора протягом 3 місяців після запуску. Це дозволило накопичити типові рішення, що прискорюють впровадження. Звертайтеся — ми допоможемо підібрати оптимальну архітектуру під ваш бюджет.

Що рахує калькулятор доставки

Вартість доставки залежить від параметрів, які потрібно отримати з різних джерел:

• Адреса складу (звідки везуть) — може бути фіксованою або найближчим магазином.
• Адреса покупця (куди везуть) — до дверей чи до пункту видачі.
• Вага та габарити товарів у кошику (що везуть).
• Обраний спосіб доставки — кур'єр, ПВЗ, поштомат, Пошта Росії.
• Терміновість — стандарт або експрес.

Параметри товарів зберігаються в базі даних інтернет-магазину. Тарифи доставки — або у власних таблицях (для партнерських договорів з фіксованими цінами), або приходять у реальному часі через API служби доставки.

Локальні таблиці та API: два підходи до розрахунку

Локальні тарифні таблиці

Для простих випадків — коли є договір з фіксованими цінами або доставка власними силами — тарифи зберігаються локально:

CREATE TABLE shipping_zones ( id SERIAL PRIMARY KEY, name VARCHAR(100), regions TEXT[], base_price DECIMAL(10,2), price_per_kg DECIMAL(10,2), price_per_km DECIMAL(10,2), min_days INT, max_days INT ); CREATE TABLE shipping_methods ( id SERIAL PRIMARY KEY, zone_id INT REFERENCES shipping_zones(id), name VARCHAR(100), carrier VARCHAR(50), multiplier DECIMAL(4,2) DEFAULT 1.0, free_from DECIMAL(10,2) ); 

class LocalShippingCalculator { public function calculate(Cart $cart, Address $destination): Collection { $zone = $this->zoneDetector->detect($destination->city); $weight = $cart->totalWeight(); $orderTotal = $cart->total(); return ShippingMethod::where('zone_id', $zone->id)->get() ->map(function (ShippingMethod $method) use ($weight, $orderTotal, $zone) { $cost = $zone->base_price + ($weight * $zone->price_per_kg); $cost *= $method->multiplier; if ($method->free_from && $orderTotal >= $method->free_from) { $cost = 0; } return [ 'id' => $method->id, 'name' => $method->name, 'carrier' => $method->carrier, 'cost' => round($cost, 2), 'min_days' => $zone->min_days * $method->multiplier < 1 ? 1 : (int)($zone->min_days / $method->multiplier), 'max_days' => $zone->max_days, 'free' => $cost === 0.0, ]; }); } } 

API-розрахунок у реальному часі: приклад із СДЭК

Зазначимо: коли потрібні актуальні тарифи служби доставки, запит надсилається до їхнього API:

class CdekShippingCalculator { private string $baseUrl = 'https://api.cdek.ru/v2'; public function calculate( string $fromCity, string $toCity, float $weight, array $dimensions ): array { $token = $this->authenticate(); $response = Http::withToken($token) ->post("{$this->baseUrl}/calculator/tarifflist", [ 'from_location' => ['city' => $fromCity], 'to_location' => ['city' => $toCity], 'packages' => [[ 'weight' => (int)($weight * 1000), 'length' => $dimensions['length'], 'width' => $dimensions['width'], 'height' => $dimensions['height'], ]], ]); return collect($response->json('tariff_codes')) ->map(fn($t) => [ 'tariff_code' => $t['tariff_code'], 'tariff_name' => $t['tariff_name'], 'cost' => $t['delivery_sum'], 'min_days' => $t['period_min'], 'max_days' => $t['period_max'], ]) ->toArray(); } } 

Порівняння підходів

Локальні таблиці швидші за API в 10–80 разів, але поступаються в гнучкості. Інтеграція з СДЭК у 2 рази швидше, ніж з Поштою Росії. Вибір залежить від обсягів і вимог до актуальності.

Як агрегувати кілька служб доставки?

Реальний калькулятор зазвичай показує варіанти від кількох служб одночасно. Запити надсилаються паралельно. Якщо один сервіс недоступний — показуємо інші. Покупець не бачить помилку, лише менше варіантів.

public function getShippingOptions(Cart $cart, Address $address): array { $weight = $cart->totalWeight(); $dimensions = $cart->boundingBox(); $results = collect([ 'cdek' => fn() => $this->cdek->calculate($address, $weight, $dimensions), 'boxberry' => fn() => $this->boxberry->calculate($address, $weight, $dimensions), 'pochta' => fn() => $this->russianPost->calculate($address, $weight, $dimensions), ])->map(function ($calculator, $carrier) { try { return $calculator(); } catch (\Exception $e) { logger()->warning("Shipping calculator error: $carrier", ['error' => $e->getMessage()]); return []; } })->flatten(1)->sortBy('cost')->values(); return $results->toArray(); } 

Нижче — порівняння популярних служб доставки для інтеграції.

Що таке об'ємна вага і як вона впливає на вартість?

Багато служб вважають оплачувану вагу як максимум із фактичної та об'ємної. Згідно з правилами СДЭК, оплачувана вага дорівнює максимуму з фактичної та об'ємної. Об'ємна вага — це розрахункова вага, заснована на габаритах. Для повітряної доставки коефіцієнт 6000 см³/кг, для морської — 1000 см³/кг. Якщо цього не врахувати, розцінки будуть занижені. Приклад: посилка вагою 2 кг з габаритами 50×40×30 см дає об'ємну вагу 60000/5000=12 кг — платити доведеться за 12 кг.

Оптимізація розрахунків через кешування

Запити до API служб доставки повільні (200–800 мс) і часто платні. Кешуємо за ключем із міста відправлення, міста призначення та ваги. Тарифи змінюються рідко, тому кеш на 30 хвилин — оптимальний. При оновленні тарифів інвалідуємо за патерном.

Інтерфейс калькулятора: реактивний компонент

На сторінці товару або кошика — компактний блок з полем введення міста та списком методів з цінами та термінами. Без перезавантаження сторінки:

const ShippingCalculator = () => { const [city, setCity] = useState(''); const [options, setOptions] = useState([]); const [loading, setLoading] = useState(false); const calculate = useMemo( () => debounce(async (cityValue) => { if (cityValue.length < 3) return; setLoading(true); try { const res = await fetch('/api/shipping/calculate', { method: 'POST', headers: { 'Content-Type': 'application/json' }, body: JSON.stringify({ city: cityValue, cart_id: cartId }), }); const data = await res.json(); setOptions(data.options); } finally { setLoading(false); } }, 600), [cartId] ); return ( <div className="shipping-calculator"> <input value={city} onChange={(e) => { setCity(e.target.value); calculate(e.target.value); }} placeholder="Введіть ваше місто" /> {loading && <Spinner />} {options.map((opt) => ( <ShippingOption key={opt.id} option={opt} /> ))} </div> ); }; 

Дебаунс на 600 мс — не стріляємо запитами після кожного символу.

Скільки часу займає розробка?

1. Аналітика — збір вимог, визначення списку служб доставки, тарифних зон.
2. Проектування — вибір стеку (Laravel/PHP + React/Next.js), проектування схеми бази.
3. Реалізація — написання калькулятора, інтеграція з API, розробка UI-компонента.
4. Тестування — перевірка 100+ сценаріїв (різні міста, ваги, помилки API).
5. Деплой та моніторинг — налаштування кешування, алертів при збоях.

Орієнтовні терміни:

• Калькулятор з однією службою за фіксованими тарифами — 2–3 дні.
• З реальним API однієї служби — 3–5 днів (включаючи обробку помилок та кешування).
• Агрегатор на 3–5 служб з інтерфейсом вибору — 2–3 тижні.

Економія клієнтів на доставці після впровадження агрегатора становить у середньому 20–30%, а інвестиції окупаються за 2–3 місяці. При значному обороті економія може бути суттєвою. Зв'яжіться з нами для попередньої оцінки вашого проекту.

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

• Документація: опис тарифних схем, схема бази, інструкція з додавання нових служб.
• Доступи до панелі адміністратора для керування тарифами.
• Навчання співробітників: як змінювати тарифи, додавати зони.
• Технічна підтримка протягом місяця після запуску.

Отримайте консультацію інженера: ми допоможемо вибрати оптимальну архітектуру та реалізуємо калькулятор за 2–3 тижні.