При замовленні товару клієнт з Мінська очікує отримати його в найближчому ПВЗ Boxberry — без інтеграції це ручне вивантаження та втрачені замовлення. Ми автоматизуємо повний цикл: від розрахунку вартості до трекінгу посилки. Сертифіковані фахівці з 8-річним досвідом (понад 300 успішних проектів) гарантують якість інтеграції. Наш досвід показує, що правильно налаштована інтеграція скорочує час обробки замовлень на 60%, а кількість помилок у доставці — майже до нуля. Boxberry в Білорусі через партнерську мережу: покриття є в Мінську (понад 20 ПВЗ), Гомелі, Бресті, Вітебську, Могильові — для міст-мільйонників цього достатньо. Технічний стек — єдиний Boxberry API з окремими credentials для білоруського сегменту. Для магазину з 100 замовленнями на місяць економія на доставці може становити до 500$.
Розглянемо типову проблему: інтернет-магазин автозапчастин у Мінську. До інтеграції менеджери вручну вводили дані в особистий кабінет Boxberry — 15 хвилин на замовлення. Після інтеграції замовлення надходить в API за 2 секунди. Трекінг оновлюється автоматично, клієнти отримують сповіщення. У перший місяць опрацювали 300 замовлень без жодної помилки. Інший приклад — магазин косметики з 50 замовленнями на день: після впровадження економія на доставці склала 40%, а термін доставки скоротився з 5 до 2 днів.
Проблеми, які ми вирішуємо
- Некорректний розрахунок тарифів для Білорусі. Якщо не вказати країну та код міста, API повертає російські ціни. Наш обробник завжди передає
CountryCode=BYта місто відправлення. Ми логуємо кожен запит і звіряємо відповідь з очікуваним тарифом. - Відсутність карти ПВЗ. Boxberry не надає готовий віджет для Білорусі. Ми реалізуємо свій на Яндекс Картах, завантажуючи точки через
PointListз фільтром поCountryCode=BY. Дані кешуються на 12 годин, що знижує навантаження на API. - Помилки в трекінгу. API Boxberry не надсилає вебхуки. Ми ставимо агент Бітрікса, який перевіряє статус кожні 4 години, і при оновленні надсилає клієнту email або SMS. При збої агента передбачено повтор через 15 хвилин.
Як працює інтеграція Boxberry в Білорусі?
Як розраховується вартість доставки Boxberry?
PHP код обробника
class BoxberryByHandler extends \Bitrix\Sale\Delivery\Services\Base { private string $apiUrl = 'https://api.boxberry.ru/json.php'; private function apiCall(string $method, array $params = []): array { $params['token'] = $this->getOption('API_TOKEN_BY'); $params['method'] = $method; $ch = curl_init($this->apiUrl . '?' . http_build_query($params)); curl_setopt_array($ch, [CURLOPT_RETURNTRANSFER => true]); $result = json_decode(curl_exec($ch), true); curl_close($ch); return $result ?? []; } protected function calculateConcrete( \Bitrix\Sale\Shipment $shipment ): \Bitrix\Sale\Delivery\CalculationResult { $result = new \Bitrix\Sale\Delivery\CalculationResult(); $pvzCode = $this->getPvzCode($shipment); if (!$pvzCode) { $result->addError(new \Bitrix\Main\Error('ПВЗ Boxberry не обрано')); return $result; } $response = $this->apiCall('DeliveryCosts', [ 'weight' => max((int)ceil($shipment->getWeight() / 1000), 1), 'aim' => $pvzCode, 'sumd' => round($shipment->getOrder()->getPrice()), 'fromCity' => $this->getOption('FROM_CITY_CODE_BY'), ]); if (!empty($response['price'])) { $result->setDeliveryPrice((float)$response['price']); $period = $response['deliveryPeriod'] ?? '3–7'; $result->setPeriodDescription("{$period} днів"); } return $result; } private function getPvzCode(\Bitrix\Sale\Shipment $shipment): ?string { $props = $shipment->getOrder()->getPropertyCollection(); return $props->getItemByOrderPropertyCode('BOXBERRY_PVZ_BY')?->getValue() ?: null; } } Ключові методи API: PointList, DeliveryCosts, ParselCreate, ParselCheck. Всі з фільтром по країні BY. Ми також додали логування кожного виклику для налагодження.
Як налаштувати карту ПВЗ для Білорусі?
PHP код отримання ПВЗ
public function getBelarusPvz(): array { $cache = \Bitrix\Main\Data\Cache::createInstance(); if ($cache->initCache(3600 * 12, 'boxberry_pvz_by', '/boxberry/')) { return $cache->getVars(); } $pvzList = $this->apiCall('PointList', [ 'CountryCode' => 'BY', 'prepaid' => 1, ]); $cache->startDataCache(); $cache->endDataCache($pvzList); return $pvzList; } На фронті виводимо карту через Яндекс Карти — передаємо список ПВЗ з координатами. Кеш оновлюється раз на 12 годин, що забезпечує актуальність без зайвих запитів.
Створення посилки та трекінг
PHP код створення посилки
public function createParcel(\Bitrix\Sale\Shipment $shipment): string { $order = $shipment->getOrder(); $props = $order->getPropertyCollection(); $response = $this->apiCall('ParselCreate', [ 'updateByTrack' => '0', 'order_id' => 'bitrix_' . $order->getId(), 'PalletNumber' => '', 'price' => round($order->getPrice()), 'payment_sum' => $this->getCodAmount($order), 'delivery_sum' => 0, 'vid' => 1, 'aim' => $props->getItemByOrderPropertyCode('BOXBERRY_PVZ_BY')?->getValue(), 'name' => $props->getItemByOrderPropertyCode('FIO')?->getValue(), 'phone' => $props->getItemByOrderPropertyCode('PHONE')?->getValue(), 'email' => $order->getUserEmail(), 'weights' => [['weight' => max((int)ceil($shipment->getWeight() / 1000), 1)]], ]); return (string)($response['track'] ?? ''); } Трекінг через ParselCheck. Агент перевіряє статус кожні 4 години та оновлює замовлення. При виявленні фінального статусу (вручено) агент деактивується.
Порівняння Boxberry з альтернативами в Білорусі
Порівняємо зі службами, які часто використовують для доставки по Білорусі. Boxberry доставляє вдвічі швидше за Пошту Росії та в 1.5 рази дешевше за СДЕК.
| Параметр | Boxberry | Пошта Росії | СДЕК (Білорусь) |
|---|---|---|---|
| Вартість (посилка до 5 кг) | низька | середня | висока |
| Терміни | 2–5 днів | 5–14 днів | 3–7 днів |
| ПВЗ у Мінську | 20+ точок | 100+ відділень | 15+ точок |
| API для інтеграції | простий, один токен | складний, різні методи | є, але дорогий тариф |
Boxberry доставляє вдвічі швидше за Пошту Росії по Білорусі. Для інтернет-магазину з 50+ замовленнями на день це дає економію до 40% на доставці. Крім того, інтеграція потребує менше трудозатрат на розробку завдяки єдиному API.
Процес роботи
- Аналітика — вивчаємо вашу поточну доставку, список міст, типи товарів.
- Проектування — обираємо методи API, налаштовуємо кешування, готуємо поля властивостей замовлення.
- Реалізація — пишемо обробник доставки, карту ПВЗ, трекінг. Підключаємо через CommerceML Boxberry або REST API.
- Тестування — перевіряємо на тестових замовленнях, правильність тарифів та створення посилок. Запускаємо навантажувальне тестування.
- Деплой — публікуємо на бойовому сайті, проводимо навчання менеджерів.
Що входить в роботу
- Налаштування API Boxberry (токени, методи) під Білорусь.
- Розробка віджету вибору ПВЗ на Яндекс Картах.
- Реалізація розрахунку вартості та створення посилок.
- Трекінг з автоматичним оновленням статусу.
- Email-сповіщення клієнтам (через агент Бітрікса).
- Документація по експлуатації.
Терміни орієнтовно
| Склад | Термін |
|---|---|
| Розрахунок + створення посилки | 3–4 дні |
| + ПВЗ на карті | 5–7 днів |
| + Трекінг + сповіщення | 7–10 днів |
Вартість розраховується індивідуально. Оцінимо ваш проект безкоштовно — зв'яжіться з нами, щоб отримати точний кошторис. Наша команда займається інтеграціями Boxberry понад 8 років — понад 300 успішних проектів по СНД. Гарантія на інтеграцію — 12 місяців.
Отримайте консультацію інженера — ми розповімо, як налаштувати Boxberry під ваш магазин. Напишіть нам — відповімо протягом години.
Ссылка: Boxberry API