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

Щоб оформлювати посилки Укрпошти в QUINCEFIN, спочатку отримайте дані для підключення у свого менеджера Укрпошти. Потім внесіть їх у QUINCEFIN і заповніть дані відправника. Нижче — усі кроки по порядку.

1. Отримайте ключі у менеджера Укрпошти

Ключі надсилає менеджер Укрпошти на вашу електронну пошту після укладення договору. Це спеціальні коди доступу, за якими Укрпошта дозволяє QUINCEFIN оформлювати ваші посилки. Такий порядок наведено в правилах роботи Укрпошти, розділ 4.

• Якщо договір уже є: зверніться до менеджера, який обслуговує вашу організацію або ФОП, і попросіть дані для підключення за текстом нижче.
• Якщо договору ще немає: залиште заявку на сторінці «Укрпошта для бізнесу» або зверніться до менеджера вашого регіону. Скажіть, що хочете укласти договір і оформлювати посилки через QUINCEFIN.
• Якщо не знаєте свого менеджера: скористайтеся списком менеджерів за регіонами або напишіть у підтримку корпоративних клієнтів: [email protected]. Вкажіть назву організації чи ФОП та ЄДРПОУ або ІПН і попросіть контакт вашого менеджера.

Що написати менеджеру

Можна скопіювати цей текст і додати свої реквізити:

Добрий день! Хочемо оформлювати відправлення Укрпошти з облікової системи QUINCEFIN (QFin). Наша організація / ФОП: [назва], ЄДРПОУ / ІПН: [код], номер договору: [номер]. Будь ласка, надішліть на нашу електронну пошту дані доступу до API для реальних відправлень: PRODUCTION BEARER eCom, PROD_COUNTERPARTY TOKEN та COUNTERPARTY UUID. Також просимо надати PRODUCTION BEARER StatusTracking для відстеження відправлень.

Слова API, Bearer і token у зверненні потрібні менеджеру, щоб він надіслав саме дані для підключення облікової системи. Самостійно придумувати ці значення не потрібно.

Для початку роботи достатньо трьох значень: Bearer eCom, Counterparty token та UUID контрагента. Якщо ключ відстеження StatusTracking ще не надіслали, підключення можна завершити без нього.

2. Перенесіть дані з листа у QUINCEFIN

1. Відкрийте Налаштування → Інтеграції → Служби доставки → Укрпошта.
2. Натисніть Створити.
3. На вкладці Підключення у полі Профіль введіть зручну для себе назву, наприклад Укрпошта — ФОП Петренко. Цю назву ви задаєте самі.
4. Скопіюйте значення з листа менеджера у поля за таблицею нижче. Копіюйте сам код повністю, без назви рядка та зайвих пробілів.

Перші три рядки обов’язкові. Поле Bearer StatusTracking залиште порожнім, якщо цього ключа ще немає.

Ці назви використано в офіційній документації API Укрпошти, розділ 1.1.

UUID контрагента — окремий код, який надає Укрпошта. У це поле не можна підставляти ІПН, ЄДРПОУ, номер договору чи номер телефону. Якщо такого рядка в листі немає, попросіть менеджера дослати UUID для виданих робочих ключів.

Для реальних посилок беріть значення з позначками PRODUCTION та PROD. Значення з позначками SANDBOX або SAND призначені для тестування. Якщо отримали лише тестові дані, попросіть менеджера надіслати робочі.

Після заповнення полів:

1. Натисніть Перевірити з’єднання. Якщо з’явилася помилка, перевірте скопійовані значення або скористайтеся підказками внизу цієї сторінки.
2. Натисніть Застосувати. Профіль збережеться, і стане доступним поле Відправник.
3. Перейдіть до наступного кроку — заповнення відправника. Самих ключів для оформлення посилок ще недостатньо.

3. Заповніть і виберіть відправника

Відправник — це ваша організація, ФОП або фізична особа, від чийого імені відправлятимете посилки. Його картку можна створити прямо в QUINCEFIN.

1. У збереженому профілі натисніть … біля поля Відправник.
2. Якщо потрібний відправник уже є у списку, виділіть його, натисніть Вибрати й перейдіть до пункту 5. Якщо список порожній або вашого відправника немає, натисніть Створити.
3. Заповніть картку за підказками нижче й натисніть OK. QUINCEFIN передасть дані в Укрпошту та створить там відправника.
4. Виберіть відправника у списку та натисніть Вибрати.
5. Переконайтеся, що його ім’я або назва з’явилися у полі Відправник. Натисніть Застосувати або OK у профілі, щоб зберегти вибір.

Якщо Укрпошта відхилила дані, картка залишиться збереженою в QFin із попередженням Відправника не створено в Укрпошті. Виправте дані й натисніть OK ще раз. Профіль можна завершити лише з відправником, успішно створеним в Укрпошті.

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

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

Необов’язково: вага, розміри й опис посилки

На вкладці За замовчуванням можна вказати Опис відправлення, Вагу, кг, Довжину, см, Ширину, см та Висоту, см. Поля профілю необов’язкові, але вони заповнюють початкове місце в новій ТТН.

Для відправлення потрібні додатна вага та всі три розміри місця. Якщо не заповнили їх у профілі, введіть безпосередньо в ТТН.

Наприклад, для однакових коробок можна вказати опис Одяг, вагу 1 кг та розміри 30 × 20 × 10 см. Перед створенням кожного відправлення перевіряйте фактичні значення.

Необов’язково: кілька організацій і профіль користувача

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

У ТТН доступні профілі, відправники яких належать організації накладної, а також профілі без прив’язки відправника до організації.

Щоб призначити користувачу профіль за замовчуванням:

1. Відкрийте Налаштування → Мій профіль → Параметри користувача й натисніть Редагувати.
2. На вкладці Профілі інтеграцій виберіть Профіль Укрпошти.
3. Збережіть зміни.

У новій ТТН система спочатку шукає призначений користувачу профіль, який підходить організації накладної. Якщо такого немає, вибирає профіль цієї організації або профіль без прив’язки до організації. Перед створенням відправлення перевірте поле Профіль Укрпошти.

Докладніше: Параметри користувача.

Якщо підключення не працює

Якщо потрібні ключі або уточнення щодо договору, зверніться до свого менеджера Укрпошти. З технічними питаннями щодо доступу до API можна написати [email protected] — цей контакт наведено в частих питаннях Укрпошти.

Якщо не вдається виконати кроки в QUINCEFIN, зверніться до підтримки QUINCEFIN і опишіть, на якому кроці виникла проблема.

Далі: ТТН Укрпошти: створення, редагування та видалення.