> 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/api-docs-ua/zagalna-informaciya.md). # Загальна інформація Цей розділ містить документацію API для інтеграції із сервісами Нової пошти **в межах України**. API призначений для роботи з внутрішніми відправленнями по Україні та надає методи для створення й керування експрес-накладними, роботи з контрагентами і адресами, отримання довідників, друкованих форм, реєстрів, трекінгу та інших сервісів. Технічна версія цього інтерфейсу — [**API 2.0**](http://api.novaposhta.ua/v2.0). Для міжнародних відправлень, відправлень за кордон та інтеграції із сервісами Nova Post в інших країнах **використовуйте міжнародний Nova Post API**, документація якого доступна в розділі [**API Docs**](https://api-portal.novapost.com/methods/ua/). **Міжнародний API активно розвивається та поступово доповнюється можливостями для роботи з відправленнями в межах України**. У перспективі він стане єдиним API для інтеграції із сервісами Nova Post незалежно від країни та напрямку відправлення. Тому для нових інтеграцій рекомендуємо також ознайомитися з можливостями [**API Docs**](/methods/ua/overview.md). ### Огляд методів Методи згруповані за основними напрямками інтеграції: * **Адреси** — робота з довідниками (населених пунктів, поштоматів тощо) і створення адрес контрагентів. * **Виклик кур'єра** — робота із заявками на виклик кур'єра. * **Додаткові послуги** — створення переадресації або повернення, зміна даних. * **Довідники** — робота з довідниками. * **Друковані форми** — отримання друкованих форм документів. * **Експрес-накладна** — створення, редагування, видалення та отримання даних за експрес-накладною. * **Контактні персони** — створення, оновлення та видалення контактних осіб контрагентів. * **Контрагенти** — робота із даними контрагентів. * **Оплати** — деталізація вартості відправлень. * **Реєстри** — робота із реєстрами експрес-накладних. * **Трекінг** — отримання детальної інформації про статус відправлень. * **Фрахт** — робота із заявками на перевезення вантажів. ### Авторизація Для початку роботи з функціоналом API UA необхідно згенерувати API-ключ і використовувати його під час формування запитів. Щоб згенерувати ключ, перейдіть за посиланням «[**Отримати API Key**](https://new.novaposhta.ua/)» (**Бізнес-кабінет**/**Налаштування**/**Безпека**) та натисніть «**Створити ключ**». Детальніше — на сторінці «[**Створення API-ключа**](/novaposhta-docs/ua/kroki-integraciyi/stvorennya-api-klyucha.md)». ### Точки входу **JSON:** **XML:** ### Формат запиту Обмін даними здійснюється за протоколом HTTPS із використанням методів передачі даних POST або GET на точку входу залежно від типу запиту (XML або JSON). Формат обов'язково має бути вказаний маленькими літерами. Наприклад: . ### Формат відповіді Відповідь завжди повертається з кодом 200 навіть у разі логічних помилок. --- # 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/api-docs-ua/zagalna-informaciya.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.