Інтеграція Укрпошти в OpenCart та Laravel: автоматизація доставки для інтернет-магазину
Ручне оформлення відправлень і копіювання трек-номерів з кабінету Укрпошти — це щоденні витрати часу, які прямо впливають на операційні витрати магазину. Інтеграція API Укрпошти з OpenCart або Laravel перетворює цей процес на автоматичну операцію.
Що дає API Укрпошти
Укрпошта надає REST API, яке дозволяє:
- Створювати відправлення програмно після підтвердження замовлення.
- Отримувати трек-номер і передавати його покупцю автоматично.
- Відстежувати статус посилки та оновлювати стан замовлення в магазині.
- Генерувати PDF-наклейку для друку без ручного заповнення форм.
Реалізація на OpenCart
Для OpenCart розробляється окреме розширення — shipping module. Воно з'являється в адмін-панелі як стандартний метод доставки. При оформленні замовлення покупець бачить тарифи Укрпошти в реальному часі (через виклик API calculate), а після підтвердження оплати система автоматично створює відправлення.
Ключові кроки інтеграції:
- Реєстрація додатку в кабінеті Укрпошти та отримання Bearer-токена.
- Розробка OpenCart-модуля, що зберігає налаштування (відправник, тип відправлення, розміри за замовчуванням).
- Webhook або cron-задача, що тригерить створення посилки після зміни статусу замовлення.
- Відправка трек-номера на email покупця через вбудований mail OpenCart або Laravel Notifications.
Реалізація на Laravel
У Laravel-проєктах інтеграція будується через сервісний клас UkrposhtaService, що обгортає HTTP-запити до API Укрпошти. Клас реєструється в контейнері залежностей і викликається з Job-класу, що запускається асинхронно після підтвердження платежу через LiqPay або Monobank.
Ланцюжок виглядає так:
LiqPay Webhook → Laravel Job → UkrposhtaService → трек-номер покупцю
Увесь ланцюжок відпрацьовує у фоновому режимі, не блокуючи основний потік запиту.
Бізнес-ефект
- Скорочення часу оформлення відправлення: з 5–10 хвилин вручну до нуля.
- Менше помилок при введенні адрес — дані підтягуються напряму з форми замовлення.
- Покупець отримує трек-номер одразу після оплати — менше запитів у підтримку.
Потрібна інтеграція Укрпошти?
Команда MaxiMoruM реалізує інтеграції Укрпошти, Nova Poshta, LiqPay та Monobank для OpenCart і Laravel під ключ. Зв'яжіться з нами на maximorum.com — і ми автоматизуємо вашу логістику.