Як підключити Укрпошту до HugeProfit
Інтеграція з Укрпоштою дає створення відправлень (ТТН) прямо з продажу, друк маркування і автоматичне відстеження посилок. Працює для бізнес-клієнтів Укрпошти — з договором, після якого Укрпошта надсилає ключі для API.
1. Де взяти ключі
В особистому кабінеті Укрпошти ключів API немає. Після укладення договору Укрпошта надсилає на пошту лист з даними для підключення — таблицю з реквізитами вашої організації і кількома ключами. Для HugeProfit знадобляться два рядки:
| Рядок у листі Укрпошти | Поле в HugeProfit |
|---|---|
| PRODUCTION BEARER eCom | «BEARER eCom» |
| PROD_COUNTERPARTY TOKEN | «COUNTERPARTY TOKEN» |
⚠️ Беріть саме PRODUCTION-ключі. Рядки SANDBOX — тестові: з ними відправлення не потраплять у реальну систему Укрпошти. Ключ StatusTracking вводити не потрібно — відстеження HugeProfit робить сам.
Знадобляться також реквізити з того самого листа: телефон, назва (ПІБ ФОП чи назва компанії), поштовий індекс, ІПН/ЄДРПОУ та IBAN.
2. Підключення
- «Налаштування» → «Інтеграції» → «Доставка» → картка Укрпошти → «Підключити».
- Вставте «BEARER eCom» і «COUNTERPARTY TOKEN».
- Заповніть дані відправника:
- «Телефон» — мобільний, як у договорі;
- ім’я / назва відправника — «ФОП Прізвище Ім’я По батькові» або назва компанії;
- «Введіть поштовий індекс» — індекс відділення, з якого відправляєте;
- «Введіть ЄДРПОУ/РНОКПП вашої організації» — ЄДРПОУ компанії або ІПН ФОП;
- «IBAN» — рахунок, на який Укрпошта перераховуватиме післяплату.
- Збережіть. HugeProfit зареєструє вас як відправника в системі Укрпошти.
Змінити ключі чи реквізити — «Налаштування» на картці → «Редагувати». «Деактивувати» — тимчасово вимкнути, 🗑 — видалити. Кілька договорів (кілька ФОП) — «Додати ще одну інтеграцію».
3. Відправлення
- Продаж з доставкою Укрпоштою → «Відправити/Завершити» → «Створити ТТН Укрпошти». Загальний порядок — у статті Доставка і ТТН.
- У формі: «Відправник», «Одержувач», тип — «Стандарт» чи «Експрес», «Габарити» (довжина має бути найбільшою зі сторін) і «Вага», «Хто платить за доставку», «Опис відправки (50 символів)», «Строк зберігання (дні)».
- Оплата: «Оцінка» — товар уже оплачено, вказується оголошена вартість; «Післяплата (зарахування на картку)» або «Післяплата (зарахування на рахунок)» — післяплата з перерахуванням коштів на картку або на рахунок (IBAN з налаштувань інтеграції). Для зарахування на рахунок потрібна окрема згода Укрпошти (див. «Якщо щось не працює»).
- Після створення можна надрукувати маркування (стікер) для посилки.
- Статус посилки HugeProfit перевіряє автоматично й змінює статус продажу так само, як для Нової Пошти.
Якщо щось не працює
| Проблема | Що зробити |
|---|---|
| Помилка авторизації | Перевірте, що вставлено PRODUCTION-ключі без пробілів і що BEARER і TOKEN не переплутано місцями. |
| Відправлення не створюється через реквізити | Перевірте індекс, ІПН/ЄДРПОУ і IBAN — вони мають збігатися з договором. |
| Ключі загубилися | Зверніться до свого менеджера Укрпошти — ключі надсилає лише вона. |
| Помилка «There must be an agreement for postpaid payment to a bank account» | Укрпошта ще не дозволила перераховувати післяплату на ваш рахунок (IBAN). Зверніться до свого менеджера Укрпошти і напишіть на api-support@ukrposhta.ua з проханням дозволити зарахування на IBAN — вкажіть uuid контрагента (є у файлі з ключами) та ІПН/ЄДРПОУ, на які видано ключі. Поки дозволу немає — використовуйте «Післяплата (зарахування на картку)». |
| Відправник не той | Відправником має бути саме та особа (ФОП чи компанія), з якою укладено договір. |
Огляд можливостей — на сторінці створення ТТН Укрпошти.