> 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/methods/ua/overview.md).

# Огляд методів

Розділ Методи містить API-інструменти Nova Post для інтеграції ключових логістичних процесів у зовнішні системи та автоматизації взаємодії з сервісами доставки.

Методи згруповані за основними напрямками інтеграції:

* **Авторизація** — отримання API-ключів і JWT-токенів для авторизованих запитів;
* **Довідники** — доступ до довідкових даних для коректного формування API-запитів;
* **Сервіси** — додаткові методи для роботи з окремими сервісними сценаріями;
* **Відправлення** — створення, оновлення, розрахунок і керування доставкою;
* **Кур'єрська доставка** — оформлення та супровід заявок на забір відправлень кур’єром;
* **Webhooks** — автоматичне отримання подій і статусів через підписки;
* **Фулфілмент** — управління товарами, складськими залишками, замовленнями та inbound-операціями.

Кожен підрозділ містить опис endpoint-ів, параметри запиту, приклади відповідей і правила використання для побудови інтеграції.

### Колекції у Postman

Це набір готових запитів для тестування методів API, який спрощує інтеграцію та усуває потребу створювати запити вручну.

<p align="right"><br><a href="https://documenter.getpostman.com/view/37226773/2sAYQWLZdh" class="button primary">Завантажити</a></p>

### SDK для PHP-застосунків

Це офіційна PHP-бібліотека для інтеграції з API Nova Post, яка надає готові методи для роботи з відправленнями, відстеженням, розрахунками та іншими сервісами Nova Post, підтримуючи сучасні стандарти PHP і гнучкі можливості налаштування.

<p align="right"><a href="https://api-portal.novapost.com/changelog-1/documentation-1/sdk-dlya-php" class="button secondary">Почати роботу з SDK</a></p>

### Версіонування API

#### Опис

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

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

#### Стратегія Версіонування

Ми використовуємо **версіонування на основі URL**. Номер версії включається до шляху API endpoint:

* `https://api.novapost.com/v1.0/shipments` - поточна версія
* `https://api.novapost.com/v2.0/shipments` - майбутня версія

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


---

# 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 by asking a question.

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://api-portal.novapost.com/methods/ua/overview.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

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.
