Інтеграція розрахунку вартості доставки через API
Розрахунок вартості доставки в реальному часі — критичний елемент конверсії. Покупець повинен бачити точну вартість кожного варіанту доставки під час вибору, а не після підтвердження замовлення. Це зменшує відмови на фінальному кроці оформлення.
Архітектура розрахунку
Розрахунок вартості виконується одним запитом до бекенду, який одночасно опитує API всіх підключених служб доставки та повертає уніфікований список варіантів.
class DeliveryCalculator
{
private array $providers;
public function calculate(Cart $cart, Address $destination): Collection
{
$requests = collect($this->providers)->map(function ($provider) use ($cart, $destination) {
return $provider->calculateAsync($cart, $destination); // повертає Promise
});
return collect(async_all($requests)) // паралельне виконання
->flatten()
->sortBy('price')
->filter(fn($option) => $option->isAvailable());
}
}
Паралельні запити через Guzzle Pool або ReactPHP HTTP. Тайм-аут для кожного зовнішнього запиту — не більше 2–3 секунд. Якщо провайдер не відповів — його варіант просто не включається в список.
Уніфікований формат варіанту доставки
class DeliveryOption
{
public string $providerId; // 'cdek', 'boxberry', 'pochta'
public string $serviceCode; // 'cdek_express', 'cdek_pvz'
public string $name; // 'CDEK: Express'
public string $type; // 'courier' | 'pvz' | 'postamat'
public int $price; // у копійках
public ?int $priceWithDiscount;
public int $minDays;
public int $maxDays;
public ?string $pvzCode; // якщо потрібен вибір пункту видачі
public array $meta; // додаткові дані провайдера
}
Кешування результатів
Розрахунок повторюється при кожній зміні адреси або складу кошика. Кешування має сенс за ключем {cart_hash}:{destination_hash} на 10–15 хвилин.
$cacheKey = "delivery:{$cart->hash()}:{$destination->hash()}";
return Cache::remember($cacheKey, 900, fn() => $this->fetchFromProviders($cart, $destination));
Параметри для розрахунку
Кожен провайдер вимагає різних параметрів, але основа спільна:
- Розміри та вага посилки (загальні для всіх товарів у кошику)
- Місто/регіон відправлення (адреса складу)
- Місто/регіон призначення
- Задекларована вартість (впливає на вартість страховки)
- Кількість місць
Габарити вилучаються з товарів: якщо продавець не заповнив — застосовуються значення за замовчуванням.
Різні склади та пункти відправлення
Інтернет-магазини з кількома складами повинні розраховувати доставку від найближчого складу до адреси покупця. Це вимагає попередньої логіки маршрутизації: визначити, з якого складу буде відправлено кожен товар, і розрахувати доставку від кожного складу окремо.
Відображення результатів
На UI результати групуються таким чином:
- Кур'єрська доставка: кілька варіантів за швидкістю/вартістю
- Самовивіз з пункту видачі: клік → відкривається карта вибору пункту
- Російська пошта: окремо (зазвичай повільніше, дешевше)
Термін доставки відображається як "1–2 робочих дні" або "до 15 березня" — для цього потрібен виробничий календар (святкові дні, вихідні).
Термін інтеграції: 3–5 днів для підключення 2–3 провайдерів з паралельними запитами та кешуванням.