> 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/metodi-1/metodi/readme.md).

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

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

* **Авторизація** — отримання 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 dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://api-portal.novapost.com/metodi-1/metodi/readme.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
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.