PHPackages daaner/novaposhta - PHPackages - PHPackages [Skip to content](#main-content)[PHPackages](/)[Directory](/)[Categories](/categories)[Trending](/trending)[Leaderboard](/leaderboard)[Changelog](/changelog)[Analyze](/analyze)[Collections](/collections)[Log in](/login)[Sign up](/register) 1. [Directory](/) 2. / 3. [API Development](/categories/api) 4. / 5. daaner/novaposhta ActiveLibrary[API Development](/categories/api) daaner/novaposhta ================= NovaPoshta (API 2.0) for Laravel 7+ 1.4(1y ago)3720.8k↓26.7%16[1 PRs](https://github.com/daaner/novaposhta/pulls)MITPHPPHP >=7.2.5CI passing Since Jul 6Pushed 5mo ago6 watchersCompare [ Source](https://github.com/daaner/novaposhta)[ Packagist](https://packagist.org/packages/daaner/novaposhta)[ RSS](/packages/daaner-novaposhta/feed)WikiDiscussions master Synced 1mo ago READMEChangelog (10)Dependencies (1)Versions (12)Used By (0) Laravel NovaPoshta API 2.0 ========================== [](#laravel-novaposhta-api-20) [![Scrutinizer Code Quality](https://camo.githubusercontent.com/f14a80c2addc08cfa119e9e2d6d2a11e047988ac6975df80a2506453ae0b0f9d/68747470733a2f2f7363727574696e697a65722d63692e636f6d2f672f6461616e65722f6e6f7661706f736874612f6261646765732f7175616c6974792d73636f72652e706e673f623d6d6173746572)](https://scrutinizer-ci.com/g/daaner/novaposhta/?branch=master)![Laravel Support](https://camo.githubusercontent.com/fbc119104d8453364eafe3a86c665435559ba15b43ee034a9402dd07240f92d6/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f4c61726176656c2d372b2d627269676874677265656e2e737667)![PHP Support](https://camo.githubusercontent.com/8dacc37fd25ea278eb9ad374ce45dcf7b2b2f2b827e739e328484dc02a112d26/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f5048502d372e322e352b2d627269676874677265656e2e737667)[![Official Site](https://camo.githubusercontent.com/77ec09c1db987a627e42c45da24c4dbebae18b75d320bf4b8a5093ed5e8933a0/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f6f6666696369616c2d736974652d626c75652e737667)](https://daaner.github.io/NovaPoshta/) [![Latest Stable Version](https://camo.githubusercontent.com/15055aa905a051ad2fa8d5de8062e3f2d23ecf0508e7a6beab75c4e9e3da450f/68747470733a2f2f706f7365722e707567782e6f72672f6461616e65722f6e6f7661706f736874612f76)](//packagist.org/packages/daaner/novaposhta)[![Total Downloads](https://camo.githubusercontent.com/28a0e05584de623b2ff9d9d7bcefebfaf2c95bf35f294d7ca6a7545c96476018/68747470733a2f2f706f7365722e707567782e6f72672f6461616e65722f6e6f7661706f736874612f646f776e6c6f616473)](//packagist.org/packages/daaner/novaposhta)[![License](https://camo.githubusercontent.com/e118df711f7cf85afcc429eb617fccea51bb589716af8fdd586dc9645574845d/68747470733a2f2f706f7365722e707567782e6f72672f6461616e65722f6e6f7661706f736874612f6c6963656e7365)](//packagist.org/packages/daaner/novaposhta) Управление отправками NovaPoshta ([novaposhta.ua](https://novaposhta.ua/)) с помощью фреймворка Laravel 7 и старше ([Laravel](https://laravel.com)). Удобный пакет для отправки и проверки ТТН через сервис [NovaPoshta.ua](https://novaposhta.ua/) **ВНИМАНИЕ** ``` // Не доделал и не оттестил все модели // используйте ветку `dev-master` // В ней все самое последнее. Документацию стараюсь не затягивать ``` #### Laravel > 7, PHP >= 7.2.5 [](#laravel--7-php--725) Минимальная версия Laravel `7.0`, для более низкой версии нужно использовать `guzzle/guzzle` Работает на Laravel 10 и PHP 8.3 (Laravel 11 не проверялся, но должно) Установка --------- [](#установка) Установите пакет через композер. ``` composer require daaner/novaposhta ``` Если вы НЕ используете autodiscover - добавьте сервис провайдер в конфигурационный файл `config/app.php`. ``` Daaner\NovaPoshta\NovaPoshtaServiceProvider::class, ``` Добавьте фасад `NovaPoshta` в массив в `config/app.php`: ``` 'NovaPoshta' => Daaner\NovaPoshta\Facades\NovaPoshta::class, ``` Выполните публикацию конфига и локализационных файлов командой: ``` php artisan vendor:publish --provider="Daaner\NovaPoshta\NovaPoshtaServiceProvider" ``` Конфигурация ------------ [](#конфигурация) После публикации ресурсов поправьте файл `config/novaposhta.php` и заполните `.env` новыми полями. - Создайте аккаунт на сайте [novaposhta.ua](https://novaposhta.ua) - Скопируйте `Ключ API` в настройках безопасности в разделе `Мои ключи API` и добавьте в соответствующий параметр в `config/novaposhta.php` либо в .env файл - `point` поддерживается только `json` (вряд ли добавится `xml`) - `dev` режим отладки запросов. Включает в лог каждый запрос на API Новой Почты (не оставляйте на продакшене) и в массиве ответа данные с ключем `dev` без преобразования, а та как возвращает Новая Почта - читайте [документацию](https://daaner.github.io/NovaPoshta/) и пользуйтесь Использование и API ------------------- [](#использование-и-api) - `setAPI($apiKey)` - установка API ключа, отличного от значения по умолчанию ``` $cp = new Counterparty; $cp->setAPI('391e241b2c********************e7'); ``` - `getResponse($model, $calledMethod, $methodProperties, $auth = true)` - кастомная отправка данных, если добавятся новые методы ``` use NovaPoshta; $model = 'TrackingDocument'; //нужная модель $calledMethod = 'getStatusDocuments'; //нужный метод $methodProperties = [ //данные по документации ]; $np = new NovaPoshta; $data = $np->getResponse($model, $calledMethod, $methodProperties, $auth = true); dd($data); ``` Поддержка моделей / методов --------------------------- [](#поддержка-моделей--методов) #### Хелперы (более детальные хелперы можно увидеть в документации к модели) [](#хелперы-более-детальные-хелперы-можно-увидеть-в-документации-к-модели) Хелперы вызываются до главного метода обращения: ``` $foo = new Common; $list = $foo->getPaymentForms(); $bar = new Address; $bar->setLimit(5)->setPage(2); $cities = $bar->getCities(); dd($cities); ``` Очень много моделей имеют в ответе дубляж на русском. В некоторых справочниках нет русской локализации. - `setLimit(100)` - лимит запроса записей - `setPage(3)` - пагинация при лимите Официально не документированный функционал ------------------------------------------ [](#официально-не-документированный-функционал) - Получение данных по бонусной карте - Обновить описание реестра - Краткий список накладных реестра - Получение данных об Контрагенте по номеру телефона - Получение данных по картам оплаты, подключенным к системе - Получение списка доступных API ключей - Продление действия API ключа - Получение списка доверенных устройств - Удаление доверенного устройства - Получение данных о входящих посылках - Получение активных промокодов прикрепленных к телефону контрагента - Список данных по бонусной программе контрагента - Список материальных ценностей доступных для заказа - Список заказанных материальных ценностей - Получение списка ордеров для заказа авто - Создание API ключа - Удаление API ключа - Замена/снятие наложного платежа Статус обертки над API новой почты ---------------------------------- [](#статус-обертки-над-api-новой-почты) [Официальная документация API Новой почты](https://developers.novaposhta.ua/)[Документация по пакету](https://daaner.github.io/NovaPoshta/#/) ### [API Адреса](https://daaner.github.io/NovaPoshta/#/Address) [](#api-адреса) #### Работа с адресами [](#работа-с-адресами) - Онлайн поиск в справочнике населенных пунктов - Онлайн поиск улиц в справочнике населенных пунктов - Создать адрес контрагента (отправитель/получатель) - Редактировать адрес контрагента (отправитель/получатель) - Удалить адрес контрагента (отправитель/получатель) - Справочник городов компании - Справочник населенных пунктов Украины - Справочник географических областей Украины - Справочник отделений и типов отделений - Справочник улиц компании - Создать адрес контрагента (отправитель/получатель) - Редактировать адрес контрагента (отправитель/получатель) - Удалить адрес контрагента (отправитель/получатель) ### [API Контрагенты](https://daaner.github.io/NovaPoshta/#/Counterparty) [](#api-контрагенты) #### Работа с данными Контрагента [](#работа-с-данными-контрагента) - Создать Контрагента - Создать контактное лицо Контрагента - Создать Контрагента с типом (юридическое лицо) организация - Создать Контрагента с типом третьего лица - Загрузить список адресов Контрагентов - Загрузить параметры Контрагента - Загрузить список контактных лиц Контрагента - Загрузить список контрагентов - Обновить данные Контрагента - Обновить данные контактного лица Контрагента - Удалить Контрагента получателя - Удалить Контактное лицо Контрагента ### [API Печатные формы](https://daaner.github.io/NovaPoshta/#/) [](#api-печатные-формы) #### Это коллекция методов для получения печатных форм документов. [](#это-коллекция-методов-для-получения-печатных-форм-документов) - Маркировки - печатная форма - Реестры - печатная форма - Экспресс-накладная - печатные формы ### [API Реестры](https://daaner.github.io/NovaPoshta/#/ScanSheet) [](#api-реестры) #### Работа с реестрами экспресс-накладных [](#работа-с-реестрами-экспресс-накладных) - Добавить экспресс-накладные в реестр - Загрузить информацию по одному реестру - Загрузить список реестров - Обновить описание реестра - Краткий список накладных реестра - Удалить (расформировать) реестр отправлений - Удалить экспресс-накладные из реестра ### [API Справочники](https://daaner.github.io/NovaPoshta/#/Common) [](#api-справочники) #### Работа со справочниками. [](#работа-со-справочниками) - Виды временных интервалов - Виды груза - Виды обратной доставки груза - Виды паллет - Виды плательщиков - Виды плательщиков обратной доставки - Виды упаковки - Виды шин и дисков - Описания груза - Перечень ошибок - Технологии доставки - Типы контрагентов - Формы оплаты - Формы собственности ### [API Услуга возврат отправления](https://daaner.github.io/NovaPoshta/#/AdditionalService) [](#api-услуга-возврат-отправления) #### Возможность самостоятельного оформления Клиентом услуги «Возврат отправления» при использовании API. Услуга доступна только для клиентов отправителей. [](#возможность-самостоятельного-оформления-клиентом-услуги-возврат-отправления-при-использовании-api-услуга-доступна-только-для-клиентов-отправителей) - Проверка возможности создания заявки на возврат - Получение списка причин возврата - Получение списка подтипов причины возврата - Создание заявки на возврат - Получение списка заявок на возврат - Удаление заявки на возврат ### [API Услуга Изменение данных](https://daaner.github.io/NovaPoshta/#/) [](#api-услуга-изменение-данных) #### Возможность самостоятельного оформления Клиентом услуги «Изменение данных» при использовании API. [](#возможность-самостоятельного-оформления-клиентом-услуги-изменение-данных-при-использовании-api) - Проверка возможности создания заявки по изменению данных - Создание заявки по изменению данных (Частично) - Удаление заявки - Получение списка заявок ### [API Услуга переадресация отправления](https://daaner.github.io/NovaPoshta/#/AdditionalService) [](#api-услуга-переадресация-отправления) #### Возможность самостоятельного оформления Клиентом услуги «Переадресация» при использовании API. Услуга доступна для клиентов отправителей и получателей. [](#возможность-самостоятельного-оформления-клиентом-услуги-переадресация-при-использовании-api-услуга-доступна-для-клиентов-отправителей-и-получателей) - Проверка возможности создания заявки на переадресацию отправления - Создание заявки переадресация отправления (отделение/адрес) - Удаление заявки - Получение списка заявок ### [API Экспресс-накладная](https://daaner.github.io/NovaPoshta/#/) [](#api-экспресс-накладная) #### Работа с экспресс-накладными [](#работа-с-экспресс-накладными) - Рассчитать стоимость услуг - Прогноз даты доставки груза - Создать экспресс-накладную - Создать экспресс-накладную на адрес - Создать экспресс-накладную на отделение - Создать экспресс-накладную на почтомат "Нова пошта" - Создать экспресс-накладную с обратной доставкой - Редактировать экспресс-накладную (НЕ ТЕСТИРОВАЛОСЬ) - Получение полной инфо об ЭН - Получить список ЭН - Удалить экспресс-накладные - Формирование запроса для получения полного отчета по накладным - Формирование запросов на создание ЭН с дополнительными услугами - Формирование запросов на создание ЭН с различными видами груза --- ### Пропущенный функционал (не вижу потребности или не могу проверить) [](#пропущенный-функционал-не-вижу-потребности-или-не-могу-проверить) - Создание Контрагента с типом юрлицо или третье лицо - не добавлена возможность указывать `CityRef` --- Changelog --------- [](#changelog) Please see [CHANGELOG](CHANGELOG.md) for more information on what has changed recently. Contributing ------------ [](#contributing) Всегда рад поддержке, указаниям на ошибки и ПР! Please see [CONTRIBUTING](CONTRIBUTING.md) for details. Credits ------- [](#credits) - [Daan](https://github.com/daaner) - [Telegram](https://t.me/neodaan) License ------- [](#license) The MIT License (MIT). Please see [License File](LICENSE.md) for more information. ### Health Score 45 — FairBetter than 93% of packages Maintenance53 Moderate activity, may be stable Popularity40 Moderate usage in the ecosystem Community18 Small or concentrated contributor base Maturity56 Maturing project, gaining track record Bus Factor1 Top contributor holds 87.6% of commits — single point of failure How is this calculated?**Maintenance (25%)** — Last commit recency, latest release date, and issue-to-star ratio. Uses a 2-year decay window. **Popularity (30%)** — Total and monthly downloads, GitHub stars, and forks. Logarithmic scaling prevents top-heavy scores. **Community (15%)** — Contributors, dependents, forks, watchers, and maintainers. Measures real ecosystem engagement. **Maturity (30%)** — Project age, version count, PHP version support, and release stability. ### Release Activity Cadence Every ~143 days Recently: every ~290 days Total 11 Last Release 703d ago Major Versions 0.8 → 1.02022-09-27 ### Community Maintainers ![](https://www.gravatar.com/avatar/ab7685d68b0a7a826663193b526e128552ed0993708eda185d25118745641e84?d=identicon)[Daaner](/maintainers/Daaner) --- Top Contributors [![daaner](https://avatars.githubusercontent.com/u/9641698?v=4)](https://github.com/daaner "daaner (212 commits)")[![StyleCIBot](https://avatars.githubusercontent.com/u/11048387?v=4)](https://github.com/StyleCIBot "StyleCIBot (23 commits)")[![noxoua](https://avatars.githubusercontent.com/u/142592979?v=4)](https://github.com/noxoua "noxoua (6 commits)")[![pride-oO](https://avatars.githubusercontent.com/u/48925619?v=4)](https://github.com/pride-oO "pride-oO (1 commits)") --- Tags deliverydelivery-apidelivery-ukrainelaravellaravel-novaposhtanova-poshtanova-poshta-apinovaposhtanovaposhta-3novaposhta-apiphppostservicesdeliverydaanernovaposhtaukraine-deliverylaravel-nplaravel-novaposhta ### Embed Badge ![Health badge](/badges/daaner-novaposhta/health.svg) ``` [![Health](https://phpackages.com/badges/daaner-novaposhta/health.svg)](https://phpackages.com/packages/daaner-novaposhta) ``` ### Alternatives [lis-dev/nova-poshta-api-2 PHP class for API 2.0 ukrainian delivery company "Nova Poshta" 146172.1k](/packages/lis-dev-nova-poshta-api-2)[cdek-it/sdk2.0 PHP SDK для API v2.0 от сервиса интеграции компании СДЭК 3992.9k](/packages/cdek-it-sdk20)[serj1chen/nova-poshta-sdk-php SDK для Новой Почты 5026.5k](/packages/serj1chen-nova-poshta-sdk-php)[kontent-ai/delivery-sdk-php Kontent.ai Delivery SDK for PHP 4628.8k](/packages/kontent-ai-delivery-sdk-php)[antistress-store/cdek-sdk-v2 PHP SDK для API v2.0 от сервиса интеграции компании СДЭК 3152.8k](/packages/antistress-store-cdek-sdk-v2)[ttatpuot/cdek-sdk2.0 Рабочий и поддерживаемый PHP SDK для API v2.0 СДЭК 1315.7k](/packages/ttatpuot-cdek-sdk20) PHPackages © 2026 [Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)