Укр
Інтеграція в Base (Baselinker)
integration

Модуль інтеграції Nova Post для Base (Baselinker)

Інтегруйте послуги Nova Post у свій робочий простір

  • Що таке Base (Baselinker)

    Base (Baselinker) – зручна система керування онлайн-продажами.

    На Base (Baselinker) продавець може обробляти замовлення з різних e-commerce платформ в єдиному зручному інтерфейсі. Наприклад, замовлення з Amazon, Etsy, Shopify та інших централізовано збираються на платформі.

    Ми створили окремий модуль інтеграції послуг Nova Post в Base (Baselinker), щоб надати можливість автоматизувати обробку замовлень і спростити процес оформлення доставки замовлень. Завдяки ньому продавці можуть оформлювати доставку замовлень для своїх клієнтів безпосередньо через розділ управління замовленнями в Base (Baselinker).

Зміст статті:

⠀

Можливості модуля Nova Post на Base (Baselinker)

  • Оформлення доставки замовлень:

    на адресу, у відділення, в поштомат*

  • Маркування відправлень:

    генерація та друк етикеток

  • Трекінг:

    швидкий перехід до відстеження конкретного замовлення

  • Керування замовленнями:

    видалення створених відправлень за потреби

* Доставка у відділення та поштомат вимагає додаткової інтеграції API Nova Post у сервіси клієнта або роботи з картами відділень вручну на сайтах Nova Post

4 кроки для інтеграції Nova Post на BaseLinker

Як налаштувати модуль Nova Post на Base (Baselinker)

Для налаштування вам необхідно мати діючий договір на надання послуг з Nova Post та API-ключ, видану на довірену особу, зазначену в договорі.

<b><span class="custom-font-size font-size-16 custom-font-family font-family-Inter" style="font-weight: 700;font-style: normal;">1.&nbsp;Знайдіть на Baselinker модуль Nova Post: меню інтеграцій → Додати інтеграцію</span></b>
1. Знайдіть на Baselinker модуль Nova Post: меню інтеграцій → Додати інтеграцію
<b><span class="custom-font-size font-size-16 custom-font-family font-family-Inter" style="font-weight: 700;font-style: normal;">2. Перейдіть у розділ «Кур'єрські служби» → в пошуку введіть Nova Post → клікніть на іконку модуля</span></b>
2. Перейдіть у розділ «Кур'єрські служби» → в пошуку введіть Nova Post → клікніть на іконку модуля
<b><span class="custom-font-size font-size-16 custom-font-family font-family-Inter" style="font-weight: 700;font-style: normal;">3. Заповніть всі поля в розділі налаштувань та натисніть «Зберегти».</span></b><br><a style="text-decoration: none;" href="#description" target="_self"><span style="color: rgb(218, 41, 28);"><b><span class="custom-font-size font-size-16 custom-font-family font-family-Inter" style="font-weight: 700;font-style: normal;">Детальний опис значення полів &gt;&gt;</span></b></span></a>
3. Заповніть всі поля в розділі налаштувань та натисніть «Зберегти».
Детальний опис значення полів >>

Опис полів для налаштування модулю Nova Post в Base (Baselinker)

Інтеграція з Base (Baselinker) використовує стандартне Nova Post API, зокрема метод створення відправлення. Під час налаштування модуля користувач вказує всю інформацію, що стосується відправника. Ця інформація надалі використовується під час оформлення замовлення, її непотрібно вказувати кожен раз.

Всі поля в Base (Baselinker) мають аналог в методі створення відправлення API Nova Post з такою самою логікою заповнення, але їх назви можуть відрізнятись через прагнення Base (Baselinker) зробити їх більш зрозумілими для користувачів різних кур'єрських служб. Щоб допомогти з налаштуванням, ми підготували детальне пояснення кожного поля, а також для зручності вказуємо аналог параметра в API Nova Post.

  • Що вказувати

    Account name

    Назва облікового запису, що відображатиметься в панелі Base (Baselinker)

    API key

    API-ключ Nova Post

    Як отримати API-ключ 

    Shipper VAT Number

    Ідентифікаційний номер платника податків компанії-відправника

    параметр в API Nova Post: companyTin

    Sender - company name

    Назва компанії відправника

    Sender - phone number

    Номер телефону відправника

    Sender - e-mail

    Електронна адреса відправника

    Sender - country

    Країна відправки посилок (вибрати з переліку)

    Sender - street

    Вулиця відправника

    Sender - house number

    Номер будинку відправника

    Sender - apartment number

    Номер квартири відправника

    Sender - postal code

    Поштовий індекс відправника

    Sender - city

    Місто відправника

    Sender - name

    Ім'я відправника

    Sender - surname

    Прізвище відправника

    Client number

    id контракту з Nova Post

    параметр в API Nova Post: payerContractNumber

  • Поля для налаштування післяплати

    Account number for COD (IBAN)

    IBAN, зазначений в договорі для отримання післяплати

    параметр в API Nova Post: bankAccountName

    Bank account owner

    Ідентифікаційний номер платника податків компанії-відправника

    параметр в API Nova Post: bankAccountId

  • Налаштування ваги відправлення за замовчуванням

    How to calculate the fixed weight of a cardboard
    • Percentage value – обирайте, якщо хочете, щоб до ваги посилки автоматично додавався певний відсоток, закладений на вагу пакування посилки 
    • Fixed value – обирайте, якщо хочете, щоб до ваги посилки автоматично додавалась визначена вага пакування. Це значення буде однакове для всіх посилок.

  • Якщо здебільшого відправляєте невеликі посилки, проставте наступні значення: Fixed value = 0, щоб в замовлені не фіксувалась завищена вага посилки.

    How to calculate the fixed weight of a cardboard 

    fixed value

    Value of the fixed weight of the cardboard

    0

Як оформити доставку посилки через модуль Nova Post в Base (Baselinker)

Модуль підтримує основні типи доставки:

  • Доставка на адресу: для оформлення не потрібні додаткові дії, оскільки адреса, зазначена покупцем, автоматично передається в Nova Post через інтеграцію з Base (Baselinker).
  • Доставка у відділення або поштомат вимагає додаткових інтеграцій або ручних налаштувань, оскільки Base (Baselinker) не має інтеграції з довідником відділень Nova Post.

Якщо ви приймаєте замовлення на власному сайті, можна інтегрувати довідник відділень, використовуючи API Nova Post. В такому випадку інформація про відділення чи поштомат доставки будуть автоматоматично передаватись в Base (Baselinker).

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

Доставка на адресу

<b><span class="custom-font-size font-size-16 custom-font-family font-family-Inter" style="font-weight: 700;font-style: normal;">Заповніть поля розділу Delivery address, як вказано у прикладі</span></b>
Заповніть поля розділу Delivery address, як вказано у прикладі
<b><span class="custom-font-size font-size-16 custom-font-family font-family-Inter" style="font-weight: 700;font-style: normal;">Заповніть дані про посилку в розділі Shipments та натисніть Send package Nova Post<br></span></b><br><a style="text-decoration: none;" href="#shipments" target="_self"><span style="color: rgb(218, 41, 28);"><b><span class="custom-font-size font-size-16 custom-font-family font-family-Inter" style="font-weight: 700;font-style: normal;">Як заповнювати розділ Shipments</span></b></span></a><img class="np-block-inline-icon" src="https://site-assets.novapost.com/66d56a6f-0ada-4130-96ea-2d79f1054e04.svg">
Заповніть дані про посилку в розділі Shipments та натисніть Send package Nova Post

Як заповнювати розділ Shipments

Як коректно заповнити поле Address

  • В поле Address НЕ дублювати поля: Postal code, City, State, Country.
  • Черговість написання:
    • Назва вулиці → Номер будинку → Номер квартири (за потреби)
    • Номер будинку → Назва вулиці → Номер квартири (за потреби)
  • Блок Pickup at point має бути не заповненим
  • Для доставки в Україну:
    • Усі слова пишуться латиницею без перекладу. Наприклад: Budynok 10, Kvartyra 25, vul. Shevchenka, Kyiv
    • Допускаються англійські скорочення

  • Повна назва

    Street

    Avenue

    Boulevard

    Road

    Lane

    Apartment

  • Скорочення

    St

    Ave

    Blvd

    Rd

    Ln

    Apt

  • Переклад

    Вулиця

    Авеню, проспект

    Бульвар

    Дорога

    Провулок

    Квартира

  • Суворо дотримуйтесь правил структурованого внесення адреси, щоб забезпечити точність доставки, мінімізувати ризик помилок та затримок в доставці

    API Nova Post очікує отримати структуровану адресу одержувача. Структурована адреса – набір даних, що вказані певним чином та в певній послідовності.

    У процесі інтеграції Base (Baselinker) передає адресу отримувача у вигляді одного рядка. На стороні Nova Post цей рядок обробляється автоматичним алгоритмом парсингу, який розділяє його на окремі елементи для створення відправлення.

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

Доставка у відділення або поштомат

Для цього типу доставки потрібно вказати конкретне відділення чи поштомат. Base (Baselinker) не має інтеграції з довідником відділень Nova Post, тому під час оформлення замовлення покупцю не надається доступ до вибору відділення чи поштомата. При цьому модуль Nova Post має можливість передавати ці дані через розділ Pick up at point.

Способи передати дані про відділення або поштомат для доставки:

  • Інтегрувати API Nova Post зі своїм інтернет-магазином або CRM та надати можливість користувачу під час замовлення вказувати потрібне відділення чи поштомат для доставки. Вказані дані автоматично потраплятимуть в Base (Baselinker). Детальніше про метод 
  • Завантажити актуальний довідник відділень та поштоматів Nova Post на платформу прийому замовлень (інтернет-магазин або CRM). Покупці так само зможуть вказувати потрібне відділення чи поштомат для доставки, але довідник відділень не буде оновлюватись. Щоб на сайті відображались актуальні дані про можливі місця доставки, довідник потрібно буде оновлювати. Детальніше 
  • Вручну на Base (Baselinker). Внесіть інформацію про місце доставки в розділ Pick up at point, орієнтуючись на дані, які покупець вказав в Delivery adress:
<b><span class="custom-font-size font-size-16 custom-font-family font-family-Inter" style="font-weight: 700;font-style: normal;">Перейдіть </span></b><a style="text-decoration: none;" href="https://novapost.com/en-pl/departments" target="_blank"><span style="color: rgb(218, 41, 28);"><b><span class="custom-font-size font-size-16 custom-font-family font-family-Inter" style="font-weight: 700;font-style: normal;">на мапу відділень</span></b></span></a><b><span class="custom-font-size font-size-16 custom-font-family font-family-Inter" style="font-weight: 700;font-style: normal;">: виберіть країну та місто доставки. Виберіть потрібне місце доставки: за номером, якщо покупець вказав номер відділення або поштомат введіть адресу, вказану в Delivery adress, та виберіть найближче відділення або поштомат</span></b>
Перейдіть на мапу відділень: виберіть країну та місто доставки. Виберіть потрібне місце доставки: за номером, якщо покупець вказав номер відділення або поштомат введіть адресу, вказану в Delivery adress, та виберіть найближче відділення або поштомат
<b><span class="custom-font-size font-size-16 custom-font-family font-family-Inter" style="font-weight: 700;font-style: normal;">Перейдіть в картку відділення або поштомату та натисніть Copy</span></b>
Перейдіть в картку відділення або поштомату та натисніть Copy
<b><span class="font-size-16 custom-font-family font-family-Inter" style="font-weight: 700;font-style: normal;">Поверніться в картку замовлення на </span><span class="custom-font-size font-size-16 custom-font-family font-family-Inter" style="font-weight: 700;font-style: normal;">Base (Baselinker)</span><span class="font-size-16 custom-font-family font-family-Inter" style="font-weight: 700;font-style: normal;"> та перейдіть до редагування розділу Pick up at point. Вставте скопійовану інформацію в поле ID та збережіть зміни.</span></b><br><br><b><span class="font-size-16 custom-font-family font-family-Inter" style="font-weight: 700;font-style: normal;">Заповніть дані про посилку в розділі Shipments та натисніть Send package Nova Post.</span></b><br><a style="text-decoration: none;" href="#parcel-data" target="_self"><span style="color: rgb(218, 41, 28);"><b><span class="font-size-16 custom-font-family font-family-Inter" style="font-weight: 700;font-style: normal;">Як заповнювати розділ Shipments&nbsp;</span></b></span></a><img class="np-block-inline-icon" src="https://site-assets.novapost.com/66d56a6f-0ada-4130-96ea-2d79f1054e04.svg">
Поверніться в картку замовлення на Base (Baselinker) та перейдіть до редагування розділу Pick up at point. Вставте скопійовану інформацію в поле ID та збережіть зміни.

Заповніть дані про посилку в розділі Shipments та натисніть Send package Nova Post.
Як заповнювати розділ Shipments 

Як заповнити дані про посилку

  1. 1
    В картці замовлення спустіться в розділ Shipments, натисніть Nova Post для відкриття форми створення посилки.
  2. 2
    Заповніть всі обов'язкові поля та натисніть Send package Nova Post. Детальний опис полів 

Приклад заповнення даних про посилку:

Опис полів форми створення посилки

  • Назва поля

    Insurance

    Content description

    Cash on delivery

    Weight, Length, Width, Height

  • Що вказувати

    Оголошена цінність посилки

    Опис відправлення*

    *Для коректного автоматичного заповнення опису посилки в розділі Default settings of shipment and printouts виберіть одне з налаштувань: Product list (Quantity, Name) або Product list (Quantity, SKU, Name, Price)

    Сума післяплати*. Якщо поле не заповнене, посилку буде доставлено без післяплати.

    *Для оформлення післяплати у налаштуваннях модуля обов'язково мають бути заповнені поля Account number for COD (IBAN) та Bank account owner

    Габарити посилки: вага, довжина, ширина, висота

Як роздрукувати маркування для посилки з Base (Baselinker)

<b><span class="custom-font-size font-size-16 custom-font-family font-family-Inter" style="font-weight: 700;font-style: normal;">Маркування для однієї посилки в кожному замовленні</span></b>
Маркування для однієї посилки в кожному замовленні
<b><span class="custom-font-size font-size-16 custom-font-family font-family-Inter" style="font-weight: 700;font-style: normal;">Друк маркування для декількох посилок (1) або однієї посилки (2)</span></b>
Друк маркування для декількох посилок (1) або однієї посилки (2)

Як відстежувати посилки в Base (Baselinker)

<b><span class="custom-font-size font-size-16 custom-font-family font-family-Inter" style="font-weight: 700;font-style: normal;">Package number – це номер експрес-накладної. По кліку можна перейти до відстеження посилки.</span></b>
Package number – це номер експрес-накладної. По кліку можна перейти до відстеження посилки.
Сторінка трекінгу посилки
Сторінка трекінгу посилки