> 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/help-center/ua/readme.md).

# Help Center

## Підтримка та корисні ресурси

{% columns %}
{% column valign="bottom" %}
👨‍💻 **Технічна підтримка**

Для питань інтеграції API, помилок запитів та технічних проблем використовуйте тікет-систему.\
<servicedesk@novapost.com>
{% endcolumn %}

{% column valign="middle" %}
🧩 **Підтримка бізнес-клієнтів**&#x20;

Допомога з інтеграцією сервісів Nova Post у бізнес-процеси, консультації щодо підключення API.\
<api.consult@novapost.com>
{% endcolumn %}
{% endcolumns %}

#### Контакти відділу продажів

Оберіть країну або регіон для зв’язку з локальною командою продажів Nova Post.

{% hint style="info" %}
Не знайшли свою країну? Напишіть на загальну адресу підтримки <sales@novapost.com>
{% endhint %}

<details>

<summary>🌍 Європа</summary>

| Країна          | Телефон          | Email                         |
| --------------- | ---------------- | ----------------------------- |
| Польща          | +48 532 697 974  | <wspolpraca@novapost.pl>      |
| Чехія           | +420 776 060 379 | <sale_cz@novapost.com>        |
| Німеччина       | +49 170 731 6517 | <sale_de@novapost.com>        |
| Угорщина        | +36 96 800 609   | <support_hu@novapost.com>     |
| Італія          | +39 029 994 0609 | <support_it@novapost.com>     |
| Іспанія         | +34 930 474 609  | <support_es@novapost.com>     |
| Румунія         | +40 373 785 207  | <support_ro@novapost.com>     |
| Словаччина      | +421 552 302 609 | <support_sk@novapost.com>     |
| Франція         | +33 159 420 609  | <support_fr@novapost.com>     |
| Нідерланди      | +31 203 695 606  | <support_nl@novapost.com>     |
| Велика Британія | +44 180 330 0609 | <ikhmelevskyi.b@novapost.com> |
| Австрія         | -                | <support_at@novapost.com>     |

</details>

<details>

<summary>🌐 Baltic region</summary>

| Регіон        | Телефон         | Email                      |
| ------------- | --------------- | -------------------------- |
| Baltic region | +37 123 557 979 | <balticsales@novapost.com> |

</details>

<details>

<summary>🤝 Партнерські запити</summary>

| Тип звернення      | Email                             |
| ------------------ | --------------------------------- |
| Партнерські запити | <partner_np_europa@novaposhta.ua> |

</details>

#### ❓Питання, які ставлять найчастіше

<details>

<summary><strong>Як отримати доступ до API Nova Post?</strong></summary>

Для доступу до API необхідно укласти договір із Nova Post. Після підписання договору відповідальній особі надається можливість створити API-ключ в особистому кабінеті.&#x20;

</details>

<details>

<summary><strong>Як отримати API-ключ?</strong></summary>

API-ключ генерується в особистому кабінеті після активації доступу до API. Ключ використовується для створення JWT-токена.

</details>

<details>

<summary><strong>Як працює авторизація?</strong></summary>

Авторизація здійснюється через JWT-токен.\
JWT генерується за допомогою API-ключа та передається у заголовку:

```
Authorization: Bearer {JWT_TOKEN}
```

Токен необхідно додавати до кожного запиту.

</details>

<details>

<summary><strong>Чи є тестове середовище (sandbox)?</strong></summary>

Так, доступне тестове середовище для перевірки інтеграції.\
Рекомендується використовувати його перед переходом у production.

</details>

<details>

<summary><strong>Який формат запитів використовується?</strong></summary>

API працює з JSON-форматом.\
Усі запити повинні містити заголовок:

```
Content-Type: application/json
```

</details>

<details>

<summary><strong>Де знайти перелік доступних методів?</strong></summary>

Повний перелік методів доступний у розділі **Методи API**, де наведено параметри запитів, приклади та можливі відповіді.

</details>

<details>

<summary><strong>Де отримати системні значення (відділення, валюти тощо)?</strong></summary>

Системні значення доступні в розділі **Довідники**.\
Рекомендується використовувати їх для формування коректних API-запитів.

</details>

<details>

<summary><strong>Що робити у разі помилки в запиті?</strong></summary>

**Перевірте:**

1. Коректність JWT-токена
2. Формат переданих даних
3. Обов’язкові параметри

Якщо проблема не вирішується — зверніться до **Help Center** або служби підтримки.

</details>

<details>

<summary><strong>Як згенерувати JWT-токен</strong></summary>

Використайте метод:

```
GET /clients/authorization
```

Передайте API-ключ у запиті. У відповідь буде повернуто тимчасовий JWT-токен.

Токен необхідно додавати до кожного запиту в заголовку:

```
Authorization: Bearer {JWT_TOKEN}
```

</details>

<details>

<summary><strong>Скільки діє JWT-токен?</strong></summary>

JWT-токен має обмежений строк дії. Рекомендується реалізувати механізм автоматичного оновлення токена перед закінченням його дії.

</details>


---

# 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/help-center/ua/readme.md?ask=<question>&goal=<endgoal>
```

`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.