Інтеграція логістичних сервісів Белпошти в мобільний додаток
Белпошта — національний оператор поштового зв'язку Беларуші. На відміну від Російської пошти, публічний API для розробників у Белпошти обмежений: доступний тільки сервіс трекінгу відправлень, а для інтеграції відправки та розрахунку тарифів потрібна угода та доступ до закритого API.
Трекінг відправлень
Публічна точка для відстеження — веб-форма на belpost.by/Otsledit-otpravlenie. Для програмного доступу використовуємо офіційний API трекінгу: запит за трек-номером повертає список подій з кодами операцій, датами та місцями обробки.
Трек-номери Белпошти — міжнародний формат S10 (14 символів), наприклад CP123456789BY. Валідацію робимо на клієнті перед відправкою запиту: регулярне вираження ^[A-Z]{2}[0-9]{8}[A-Z]{2}$ покриває більшість форматів.
Відповідь API містить операції російською та білоруською мовами. Якщо додаток мультимовний, локалізовані тексти приходять з сервера, а не з локальних рядків додатка.
Розрахунок вартості доставки
Белпошта надає онлайн-калькулятор на сайті. Для інтеграції в мобільний додаток є два шляхи:
API за контрактом: надається корпоративним клієнтам. Дозволяє розраховувати тарифи, створювати електронні супровідні документи, отримувати статистику відправлень. Для підключення — звернення в відділ корпоративних продажів Белпошти.
Парсинг публічного калькулятора: технічно можливий, але нестабільний при змінах на сайті. Використовуємо тільки як тимчасове рішення.
Особливості білоруського ринку
Валюта — BYN (білоруський рубль). При відображенні вартості доставки враховуємо форматування: пробіл як розділювач тисяч, кома як десятковий розділювач. NumberFormatter на iOS та NumberFormat на Android налаштовуємо з Locale("ru", "BY").
НДС для фізичних осіб включений в тариф. Для юридичних осіб — виділяється окремо. Якщо додаток працює в B2B-сегменті, потрібно розрізняти ці випадки в інтерфейсі.
Інтеграція з картою пунктів видачі
У Белпошти понад 3300 відділень. Для відображення найближчих відділень на карті використовуємо публічний API геолокації відділень або статичний JSON з координатами, оновлюваний періодично. На iOS — MapKit з кастомними анотаціями, на Android — Google Maps SDK або MapLibre для офлайн-режиму.
Фільтрація за режимом роботи, типом послуг, наявністю EMS — дані з довідника відділень Белпошти.
Терміни реалізації: інтеграція трекінгу — 3-5 днів. Корпоративна інтеграція з розрахунком тарифів та картою відділень — 2-3 тижні після отримання доступу до API.