Europochta Logistics Services Integration into Mobile Application
Europochta—Belarusian private logistics operator specializing in international shipments and e-commerce delivery. Provides API for tariff calculation, creating shipments, tracking, and working with pickup point network.
Europochta API: Available Methods
Working with Europochta API requires registration on developer portal and obtaining API key. Main method groups:
Delivery Calculator: cost calculation by weight, dimensions, shipment type, and destination. Critical to pass parameters precisely: Europochta distinguishes "tracked shipment" and "untracked shipment" with different tariffs.
Creating Bill: electronic document for shipment. API returns shipment number and PDF bill for printing.
Tracking: getting shipment movement history by its number.
Pickup Points (PVZ): list of points with coordinates, working hours, available services.
Tracking Integration
Requests to Europochta API authorized via API key in X-Api-Key header. Responses—JSON. Status list fixed, map them to user-friendly strings on app side.
Special note: Europochta actively works with shipments from China (AliExpress, Wildberries). When tracking such parcels, part of movement history comes from partner tracking systems (e.g., Cainiao)—API returns aggregated status. Not all intermediate events displayed, which is normal.
Pickup Point Selection on Map
Pickup point map—standard feature for e-commerce apps. Get point list via API, cache locally with 24-hour TTL. On iOS render via MapKit, on Android—Google Maps SDK.
Working hours filter—implement on client: parse schedule from string like "Mon-Fri: 9:00-20:00, Sat: 10:00-18:00" and compare with current time considering point's timezone. Non-trivial if PVZ network operates in different cities with different timezones.
Status Notifications
Push notifications on status change—mandatory for logistics apps. Scheme: background task (WorkManager / BGAppRefreshTask) periodically checks active shipments, on change shows local push.
Alternative: Europochta webhooks (if supported)—server receives event and sends FCM/APNs push to client. More reliable and saves battery.
Timeline: basic tracking and PVZ integration—5-8 days. Full cycle with shipment creation and bill printing—2-3 weeks.







