Укрпошта для інтернет-магазину: підключення API в Bazify

Що таке Укрпошта для бізнесу і кому вона підходить

Укрпошта — національний оператор, у якого відділення є майже в кожному селі. Для інтернет-магазину це шанс доставити замовлення туди, де немає відділення Нової Пошти, і запропонувати покупцю ще один спосіб доставки. Для бізнесу Укрпошта працює за договором: ти стаєш бізнес-клієнтом, і тобі видають ключі для електронного обміну даними, тобто для API.

Найкраще інтеграція підходить магазинам, які відправляють щодня хоча б кілька посилок і втомились вручну вписувати кожну накладну в кабінет Укрпошти. З API дані покупця, вага й сума беруться із замовлення, а штрихкод одразу зʼявляється в картці. Якщо ти відправляєш лише раз на тиждень, звичайне оформлення в кабінеті Укрпошти теж спрацює, хоча час на нього йде.

Що означає «API» для тебе як для підприємця: це спосіб, за яким Bazify від твого імені звертається до Укрпошти. Ти не програмуєш. Потрібно лише отримати ключі й один раз вставити їх у налаштування.

Що вміє інтеграція в Bazify

• Служба доставки «Укрпошта» з перевіркою ключів кнопкою «Перевірити з'єднання».
• Створення відправлення (ТТН) з картки замовлення: отримувач, поштовий індекс, вага, оголошена цінність, тип «стандарт» або «експрес».
• Накладений платіж: у формі відправлення є позначка і сума для накладеного платежу.
• Друк наліпки у форматі PDF для посилки.
• Статус посилки: кнопка «Оновити статус» у замовленні й необовʼязковий авто-трекінг у фоні.
• Правила, які перетворюють статус Укрпошти на статус замовлення, наприклад «вручено» або «повернуто».
• Автоматична оплата накладеного платежу, коли посилку вручено, і чек Checkbox, якщо в тебе ввімкнено фіскалізацію.

Як це працює день за днем

Покупець на сайті обирає спосіб доставки. Якщо Укрпошту ввімкнено серед способів доставки магазину, вона зʼявляється на оформленні разом з іншими. Замовлення потрапляє в CRM. Коли ти зібрав посилку, відкриваєш замовлення, натискаєш створення ТТН, перевіряєш дані в формі (індекс отримувача, вага, цінність, накладений платіж, якщо він потрібен) і підтверджуєш. Номер зʼявляється в замовленні.

Далі ти завантажуєш наліпку PDF, друкуєш і клеїш на посилку. Далі Bazify питає в Укрпошти про статус: за кнопкою або сам, якщо ввімкнено авто-трекінг. Коли посилку вручено, замовлення з накладеним платежем саме стає «оплаченим», а оплата зʼявляється у фінансах. Повторне оновлення статусу оплату не дублює. Якщо посилка повернулась відправнику, автоматична оплата скасовується.

💡 Порада. Хочеш бачити, де посилки застрягли? Увімкни авто-трекінг у налаштуваннях служби. За замовчуванням він вимкнений, тож статуси оновлюються лише кнопкою.

Що потрібно від підприємця

• Договір з Укрпоштою як ФОП або ТОВ (бізнес-клієнт). Без договору ключів не буде.
• Три ключі: Bearer eCom (створення відправлень), Bearer StatusTracking (статуси) і Counterparty token, він же User token. Їх видає Укрпошта: запитай у свого менеджера або подивись у кабінеті бізнес-клієнта.
• Дані відправника: назва або ПІБ, телефон, індекс відділення відправника, тип (фізична особа, ФОП або компанія).
• Тарифи та умови визначає твій договір з Укрпоштою. Bazify їх не змінює і не показує.
• Для накладеного платежу з чеками: каса Checkbox з налаштованою фіскалізацією накладеного платежу.

Як підключити Укрпошту: кроки

1. 1

   Отримай ключі

   Уклади договір з Укрпоштою як бізнес-клієнт і попроси менеджера або візьми в кабінеті Bearer eCom, Bearer StatusTracking і Counterparty token.

2. 2

   Додай службу в Bazify

   Відкрий Налаштування → Доставка і додай службу «Укрпошта». Встав три ключі та заповни дані відправника: назву або ПІБ, телефон, індекс відділення і тип.

3. 3

   Перевір з'єднання

   Натисни «Перевірити з'єднання». Така сама кнопка є в каталозі інтеграцій. Має зʼявитися повідомлення, що підключення успішне. Для перевірки обовʼязково вкажи телефон відправника у форматі 380XXXXXXXXX.

4. 4

   Ввімкни спосіб доставки на сайті

   Познач Укрпошту серед способів доставки магазину, щоб покупці могли її обрати на оформленні замовлення.

5. 5

   Створи першу ТТН

   Відкрий замовлення з доставкою Укрпоштою, створи відправлення, завантаж наліпку PDF і надрукуй її. Докладніше про кожен крок є в довідці.

Хочеш, щоб статуси посилок оновлювались самі? У вікні служби постав «Авто-трекінг»: тоді статуси оновлюватимуться кілька разів на годину.

Чесні обмеження

• Потрібен договір з Укрпоштою і три ключі. Без них підключення неможливе, а видача ключів залежить від Укрпошти, не від Bazify.
• Для ТТН треба поштовий індекс отримувача (5 цифр) і телефон отримувача. Їх вводять у форму відправлення. Пошук відділень на вітрині в Bazify зараз є лише для Нової Пошти, тому для Укрпошти індекс доводиться перевіряти самому.
• Авто-трекінг за замовчуванням вимкнений. Поки його не ввімкнено, статус оновлюється кнопкою «Оновити статус» у замовленні.
• Якщо Укрпошта тимчасово не відповідає, Bazify покаже повідомлення, а статус не зміниться. Спробуй пізніше.
• Помилка «ТТН не знайдено» означає, що номер створено не в тому акаунті Укрпошти, ключі якого підключено.
• Тарифи Укрпошти Bazify не розраховує і не показує: вартість пересилки визначає твій договір.

⚠️ Увага. Автоматичного створення ТТН для Укрпошти ми не обіцяємо: відправлення створюється з картки замовлення за твоєю дією.

Укрпошта чи Нова Пошта

Це не «або-або». Багато магазинів лишають основною Нову Пошту, а Укрпошту додають як другий варіант для покупців із малих населених пунктів чи для посилок, де зручніша її мережа. У Bazify обидві служби працюють в одному місці, а для замовлень діють однакові правила: статуси, накладений платіж і чеки.

Покрокову інструкцію з підключення й таблицю типових повідомлень про помилки ми зібрали в довідці, а в статті про Укрпошту для інтернет-магазину розібрано, коли вона вигідніша. Посилання на обидва матеріали внизу сторінки.

Часті питання

Які ключі потрібні для Укрпошти?

Три: Bearer eCom для створення відправлень, Bearer StatusTracking для статусів і Counterparty token (User token). Їх видає Укрпошта за договором.

Чи потрібен договір з Укрпоштою?

Так, як бізнес-клієнт: ФОП або ТОВ. Без договору ключів API немає, а тарифи й умови визначає саме договір.

Чи можна створити ТТН і наліпку із замовлення?

Так. У картці замовлення створюєш відправлення, а потім завантажуєш наліпку PDF і друкуєш її для посилки.

Чи підтримується накладений платіж?

Так. У формі відправлення є позначка накладеного платежу з сумою. Коли посилку вручено, замовлення стає оплаченим, а повторне оновлення оплату не дублює.

Чи оновлюються статуси посилок самі?

За бажанням. Вмикаєш «Авто-трекінг» у налаштуваннях служби, і статуси оновлюються кілька разів на годину. За замовчуванням є лише кнопка «Оновити статус».

Чи бачить покупець вибір відділення Укрпошти на сайті?

Підбір відділень у кошику зараз є для Нової Пошти. Для Укрпошти індекс одержувача вводиться у формі ТТН.

Що робити, якщо Укрпошта не відповідає?

Спробуй пізніше: Bazify покаже повідомлення про недоступність служби. Якщо помилка про ключі, перевір їх і натисни «Перевірити з'єднання».

Читайте також

• ДовідкаУкрпошта: ТТН і наліпки
• БлогУкрпошта для інтернет-магазину
• ІнтеграціїНова Пошта
• РішенняСлужби доставки в CRM
• ІнтеграціїCheckbox
• БлогНакладений платіж і контроль оплати