Перейти до змісту

Інтеграція з Укрпоштою

Укрпошта

Укрпошта – друга за популярністю служба доставки в українському e-commerce. У МійДроп вона працює так само, як Нова пошта: ви обираєте службу доставки в замовленні, CRM сама генерує ТТН, дає роздрукувати маркування й далі автоматично стежить за статусом посилки.

Розвивайте свій бізнес разом із МійДроп! Організовуйте роботу менеджерів, ведіть складський облік та багато іншого – https://mydp.co.ua/5qWIT


План статті:

  1. 1. Що вміє інтеграція
  2. 2. Що потрібно для роботи: договір і ключі
  3. 3. Як додати контрагента Укрпошти в CRM МійДроп?
  4. 4. Як вказати контрагента за замовчуванням?
  5. 5. Як увімкнути Укрпошту у формі замовлення?
  6. 6. Створення замовлення і генерація ТТН
  7. 7. Габарити і вага посилок
  8. 8. Друк маркування
  9. 9. Автоматичні статуси і повернення
  10. 10. Дропшипери зі своїми контрагентами Укрпошти
  11. 11. Часті помилки та їх усунення

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

  • генерація ТТН з картки замовлення – вручну або автоматично

  • друк маркування на посилку

  • відправлення "відділення → відділення" і кур'єрська доставка на адресу отримувача

  • накладений платіж, у тому числі із зарахуванням на розрахунковий рахунок

  • автоматичне відстеження статусів і повернень

  • зміна статусу замовлення в CRM, коли посилку отримано або повернено

  • сповіщення про зміну статусу в Telegram

  • необмежена кількість контрагентів-відправників із різними містами та відділеннями


Що потрібно для роботи: договір і ключі

Щоб генерувати ТТН прямо з CRM, потрібні два ключі – PRODUCTION BEARER eCom і PRODUCTION COUNTERPARTY TOKEN. Їх видає Укрпошта після підписання договору – https://www.ukrposhta.ua/ua/ukrposhta-dlia-biznesu.

Підписання договору - вимога пошти, а не CRM. Скріншот із сайту пошти.

Важливо!

Для відстеження статусів ТТН, створених вручну або у відділенні пошти, договір і ключі не потрібні. Достатньо вказати номер ТТН у відповідному полі замовлення – CRM однаково стежитиме за посилкою.


Як додати контрагента Укрпошти в CRM МійДроп?

Перейдіть у розділ "Налаштування" → підрозділ "Генерація та друк ТТН" → вкладка "Укрпошта" → натисніть "Налаштувати контрагентів".

Налаштування → Генерація та друк ТТН → вкладка Укрпошта

Далі натисніть кнопку "Додати контрагента Укрпошти". ↓

Кнопка "Додати контрагента Укрпошти"

Заповніть форму:

  • PRODUCTION BEARER eCom і PRODUCTION COUNTERPARTY TOKEN – ключі, які ви отримали за договором;

  • Тип відправника – "Фіз. особа", "ФОП" або "Юр. особа". Для ФОП додатково вказується ІПН, для юр. особи – ЄДРПОУ;

  • Прізвище, Ім'я, По батькові і Номер телефону – дані відправника, від імені якого створюватимуться ТТН;

  • Зараховувати накладений платіж на розрахунковий рахунок і IBAN – доступно для ФОП і юр. осіб. Вмикайте, тільки якщо у вас підписаний відповідний договір з Укрпоштою;

  • Тип поштового відправлення – "Експрес" або "Стандарт";

  • Дія у разі відмови від отримання – повернути назад через 14 або через 7 днів;

  • Огляд при отриманні дозволений – галочка, яка дозволяє отримувачу перевірити вміст посилки у відділенні;

  • Місто і Відділення пошти – звідки ви робите відправлення;

  • Назва контрагента – необов'язкове поле. Якщо його заповнити, у CRM замість ПІБ буде відображатись ця назва;

  • Активний – галочка, яка вмикає контрагента для нових замовлень.

Форма додавання контрагента Укрпошти

Важливо!

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

Важливо!

Видалення контрагента не впливає на вже додані замовлення.


Як вказати контрагента за замовчуванням?

Якщо контрагентів декілька, замовлення створюватимуться по черзі на кожного з тих, у кого стоїть галочка "Активний".

Щоб завжди відправляти від імені одного конкретного контрагента, перейдіть у розділ "Налаштування" → підрозділ "Генерація та друк ТТН" → вкладка "Укрпошта" → позначте галочкою пункт "Контрагент за замовчуванням" і оберіть потрібного зі списку. Після внесення змін натисніть кнопку "Зберегти".

Галочка "Контрагент за замовчуванням" і вибраний контрагент

Важливо!

Якщо потрібно відправляти від імені однієї й тієї ж людини, але з різних міст або відділень, створіть у CRM кілька контрагентів з тими самими ключами, а в полі "Назва контрагента" вкажіть, чим вони відрізняються. Наприклад, "Ігор Павленко, Київ" і "Ігор Павленко, Дніпро".


Як увімкнути Укрпошту у формі замовлення?

Щоб служба доставки з'явилась у списку при створенні замовлення, перейдіть у розділ "Налаштування" → підрозділ "Генерація та друк ТТН" → блок "Дозволені служби доставки" → позначте галочкою пункт "Укрпошта" і натисніть "Зберегти".

Блок "Дозволені служби доставки" з позначеною галочкою Укрпошта


Створення замовлення і генерація ТТН

У формі замовлення оберіть службу доставки "Укрпошта", вкажіть місто та відділення отримувача, а також контрагента-відправника (він підставляється автоматично).

Блок "Доставка" у формі замовлення зі службою доставки Укрпошта

Далі ТТН генерується так само, як для інших служб доставки: автоматично після додавання замовлення або вручну з картки замовлення. Загальні налаштування автогенерації описані в статті Генерація та друк ТТН.

Що потрапляє в накладну:

  • Накладений платіж із замовлення. Якщо у контрагента увімкнене зарахування на розрахунковий рахунок, кошти підуть на вказаний IBAN;

  • Оголошена вартість – береться з поля оголошеної вартості, а якщо воно порожнє – з суми накладеного платежу або суми замовлення. Для типу відправлення "Стандарт" вона передається завжди, для "Експрес" – тільки коли є накладений платіж;

  • Опис посилки – назви товарів і примітка до замовлення, якщо ви увімкнули відповідні пункти в підрозділі "Генерація та друк ТТН";

  • Платник за доставку – якщо в замовленні стоїть галочка "Доставка за рахунок відправника", платите ви, інакше – отримувач.

Кур'єрська доставка теж підтримується: увімкніть у замовленні галочку "Доставка кур'єром" і вкажіть вулицю, будинок та квартиру. Відділення в такому разі теж вказується – найближче до адреси отримувача.

Важливо!

Якщо після генерації ТТН ви змінили суму накладеного платежу, ім'я, телефон або відділення отримувача, обов'язково перегенеруйте ТТН кнопкою в картці замовлення.


Габарити і вага посилок

Для Укрпошти обов'язкові вага і довжина посилки – без них ТТН не згенерується. Ширина та висота потрапляють у накладну, якщо їх заповнено.

Щоб не заповнювати габарити в кожному замовленні вручну, перейдіть у розділ "Налаштування" → підрозділ "Генерація та друк ТТН" → вкладка "Укрпошта" і заповніть поля "Стандартна довжина посилки", "Стандартна ширина посилки" та "Стандартна висота посилки" – їх видно на скріншоті вище. Стандартна вага вказується нижче, у полі "Стандартна вага посилки (в кг)", спільному для всіх служб доставки.

Якщо потрібно вказувати габарити окремо для кожного замовлення чи товару, увімкніть у цьому ж підрозділі галочку "Включити поля «Довжина», «Ширина», «Висота» під час додавання замовлення та для товарів".


Друк маркування

Коли ТТН згенерована, у картці замовлення з'являється кнопка друку – CRM завантажує готову етикетку Укрпошти у форматі PDF.

Картка замовлення з номером ТТН Укрпошти і кнопкою друку маркування


Автоматичні статуси і повернення

CRM регулярно опитує Укрпошту і сама оновлює статус посилки в замовленні – окремо нічого налаштовувати не треба.

Якщо у вас увімкнена синхронізація статусів замовлень зі статусами доставки, то статус замовлення змінюється автоматично:

  • посилка в дорозі – замовлення переходить у статус "Доставка";

  • посилку вручено і кошти видано – замовлення переходить у "Продаж";

  • клієнт не забрав посилку і вона їде назад – замовлення переходить у "Повернення";

  • повернення отримано – замовлення переходить у "Повернення отримано", а товари повертаються на склад, якщо у вас увімкнений складський облік із поверненням залишків.

Про зміну статусів можна отримувати сповіщення в Telegram – це вмикається в розділі Сповіщення.


Дропшипери зі своїми контрагентами Укрпошти

Якщо дропшипер відправляє посилки сам, він може додати власних контрагентів Укрпошти у своєму особистому кабінеті: розділ "Налаштування" → підрозділ "Генерація та друк ТТН" → вкладка "Укрпошта". Форма і правила такі самі, як описані вище.

Детальніше про такий сценарій — у статті Подача замовлень зі своєю ТТН.

Окремо в налаштуваннях дропшиперів є галочка "Дозволити дропшиперам подачу замовлень з накладеним платежем по Укрпошті" – без неї дропшипери зможуть подавати замовлення Укрпоштою тільки з передоплатою.


Часті помилки та їх усунення

ТТН не генерується, помилка про ключі. Перевірте PRODUCTION BEARER eCom і PRODUCTION COUNTERPARTY TOKEN – це саме бойові (production) ключі з договору. У формі редагування контрагента цих полів немає, тому з новими ключами потрібно додати нового контрагента.

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

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

Помилка про договір для накладеного платежу. Зарахування накладеного платежу на розрахунковий рахунок працює лише за окремим договором з Укрпоштою. Якщо його немає – вимкніть цю галочку в контрагента.

Служби доставки немає у списку в замовленні. Увімкніть галочку "Укрпошта" в блоці "Дозволені служби доставки" (Налаштування → Генерація та друк ТТН).


Розвивайте свій бізнес разом із МійДроп! Організовуйте співпрацю з дропшиперами, аналізуйте статистику продажів та багато іншого – https://mydp.co.ua/5qWIT