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