Интеграция логистических сервисов Белпочты в мобильное приложение
Белпочта — национальный оператор почтовой связи Беларуси. В отличие от Почты России, публичный 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.