При замовленні товару клієнт з Мінська очікує отримати його в найближчому ПВЗ 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