> For the complete documentation index, see [llms.txt](https://api-portal.novapost.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://api-portal.novapost.com/gotovi-integraciyi/gotovi-integraciyi/populyarni-integraciyi/base-baselinker.md).
# Base (Baselinker)
Оформлюйте доставку покупцям свого магазину безпосередньо через розділ управління замовленнями в Base (Baselinker).
* Вибір відділення Nova Post або адресної доставки покупцем під час замовлення.
* Автоматичне створення транспортних та експортних документів.
* Оформлення замовлень з оплатою при отриманні.
* Оформлення доставки ваших замовлень клієнтам у вашій країні, по всій Європі та в Україну напряму в кабінеті Shopify.
* Доступ до трекінга доставки та нотифікація покупців про зміну статусу доставки.
**Кроки інтеграції:**
1. **Підписати договори з Nova Post на надання логістичних послуг**. Якщо ви продаєте за кордон, вам знадобиться два договори: на внутрішню доставку по країні та на міжнародну – для доставки в інші країни. Для підписання договору зверніться до відділу продажів своєї країни.
2. **Підписати додатковий договір для послуги** [«Оплата при отриманні»](https://api-portal-stage.novapost.com/uk/api-methods/cod)\*
{% hint style="info" %}
\*Тільки для продавців з Польщі, Чехії, Німеччини
{% endhint %}
3. **Зареєструватись в My Nova Post** у вашій країні після підписання договорів з контактними даними, які ви вказали в договорі контактами довіреної особи-представника.
4. **Отримати API-ключ Nova Post.**
### Налаштування Nova Post на Base (Baselinker)
1. Знайти в Baselinker модуль Nova Post в меню інтеграцій.
2. Перейдіть у розділ "Кур'єрські служби".
3. Заповніть всі поля в розділі налаштувань та натисніть "Зберегти".
#### Опис полів для налаштування модуля Nova Post в Base (Baselinker)
{% hint style="info" %}
Ця інформація надалі використовується під час оформлення замовлення, її непотрібно вказувати кожен раз.
{% endhint %}
Основні поля: Ця інформація надалі використовується під час оформлення замовлення, її непотрібно вказувати кожен раз.
| Назва поля | Що вказувати |
| ------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Account name | Назва облікового запису, що відображатиметься в панелі Base (Baselinker) |
| API key |
Ідентифікаційний номер платника податків компанії-відправника
|
| 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 | номер контракту з Nova Post |
Поля для налаштування післяплати
| Account number for COD (IBAN) | IBAN, зазначений в договорі для отримання післяплати |
| ----------------------------- | ------------------------------------------------------------- |
| Bank account owner | Ідентифікаційний номер платника податків компанії-відправника |
Налаштування ваги
Налаштування ваги відправлення за замовчуванням
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)
1. Заповніть поля розділу **Delivery address**
2. Заповніть дані про посилку в розділі **Shipment** та натисніть **Send package Nova Post.**
#### Як коректно заповнити поле Address
* В поле Address НЕ дублювати поля: Postal code, City, State, Country.
* Черговість написання:
* Назва вулиці → Номер будинку → Номер квартири (за потреби)
* Номер будинку → Назва вулиці → Номер квартири (за потреби)
* Блок Pickup at point має бути не заповненим
**Для доставки в Україну:**
* Усі слова пишуться латиницею без перекладу. Наприклад: Budynok 10, Kvartyra 25, vul. Shevchenka, Kyiv
* Допускаються англійські скорочення
| Повна назва | Скорочення | Переклад |
| ----------- | ---------- | --------------- |
| Street | St | Вулиця |
| Avenue | Ave | Авеню, проспект |
| Boulevard | Blvd | Бульвар |
| Road | Rd | Дорога |
| Lane | Ln | Провулок |
| Apartment | Apt | Квартира |
{% hint style="warning" %}
**Суворо дотримуйтесь правил структурованого внесення адреси, щоб забезпечити точність доставки, мінімізувати ризик помилок та затримок в доставці.**
API Nova Post очікує отримати структуровану адресу одержувача. Структурована адреса – набір даних, що вказані певним чином та в певній послідовності.
У процесі інтеграції Base (Baselinker) передає адресу отримувача у вигляді одного рядка. На стороні Nova Post цей рядок обробляється автоматичним алгоритмом парсингу, який розділяє його на окремі елементи для створення відправлення.
Якщо адресу буде внесено неправильно, алгоритм не зможе автоматично опрацювати посилку. В такому випадку обробка замовлення буде сповільнена через необхідність втручання співробітника або існує ризик помилкової доставки на неправильну адресу.
{% endhint %}
#### Доставка у відділення або поштомат
Для цього типу доставки потрібно вказати конкретне відділення чи поштомат. 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.
1. Перейдіть [на мапу відділень](https://novapost.com/en-pl/departments/) та оберіть країну та місто доставки.
2. Перейдіть на картку відділення або поштомату та натисніть **Copy.**
3. Поверніться в картку заповнення в Baselinker та перейдіть до редагування розділу Pick up at point. Вставте скопійовану інформацію в поле **ID**
#### Як заповнити дані про посилку
1. В картці замовлення спустіться в розділ Shipments, натисніть Nova Post для відкриття форми створення посилки.
2. Заповніть всі обов'язкові поля та натисніть Send package Nova Post.
Приклад заповнення даних про посилку:
Опис полів форми створення посилки
| Назва поля | Що вказувати |
| ----------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Insurance | Оголошена цінність посилки |
| Content description |
Опис відправлення\*
\*Для коректного автоматичного заповнення опису посилки в розділі Default settings of shipment and printouts виберіть одне з налаштувань: Product list (Quantity, Name) або Product list (Quantity, SKU, Name, Price)
|
| Cash on delivery |
Сума післяплати\*. Якщо поле не заповнене, посилку буде доставлено без післяплати.
\*Для оформлення післяплати у налаштуваннях модуля обов'язково мають бути заповнені поля Account number for COD (IBAN) та Bank account owner
|
| Weight, Length, Width, Height | Габарити посилки: вага, довжина, ширина, висота |
#### Як роздрукувати маркування для посилки з Base (Baselinker)
1. Маркування для однієї посилки в кожному замовленні.
2. Друк маркування для декількох посилок (1) або для кількох посилок (2).
### Як відстежувати посилки в Base (Baselinker)
1. Package number - це номер експрес накладної. По кліку можна перейти до відстеження посилки.
2. Сторінка трекінгу посилки
---
# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.
## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.
Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:
```
GET https://api-portal.novapost.com/gotovi-integraciyi/gotovi-integraciyi/populyarni-integraciyi/base-baselinker.md?ask=&goal=
```
`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.
Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
