PHPackages brychokvadim/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. brychokvadim/novaposhta ActiveLibrary[API Development](/categories/api) brychokvadim/novaposhta ======================= NovaPoshta (API 2.0) for Laravel 7+ 1.5(6mo ago)07MITPHPPHP >=7.3 Since Nov 4Pushed 6mo agoCompare [ Source](https://github.com/brychokvadim/NovaPoshta)[ Packagist](https://packagist.org/packages/brychokvadim/novaposhta)[ RSS](/packages/brychokvadim-novaposhta/feed)WikiDiscussions master Synced 1mo ago READMEChangelog (1)Dependencies (1)Versions (2)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 29 — LowBetter than 60% of packages Maintenance68 Regular maintenance activity Popularity4 Limited adoption so far Community10 Small or concentrated contributor base Maturity30 Early-stage or recently created project Bus Factor1 Top contributor holds 87.8% 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 Unknown Total 1 Last Release 189d ago ### Community Maintainers ![](https://www.gravatar.com/avatar/5e8b24f35ebe82e7607d24176577991c0569900fd54f9c29b45cc0d4cf64a2b4?d=identicon)[ABVV.Group](/maintainers/ABVV.Group) --- Top Contributors [![daaner](https://avatars.githubusercontent.com/u/9641698?v=4)](https://github.com/daaner "daaner (208 commits)")[![StyleCIBot](https://avatars.githubusercontent.com/u/11048387?v=4)](https://github.com/StyleCIBot "StyleCIBot (21 commits)")[![noxoua](https://avatars.githubusercontent.com/u/142592979?v=4)](https://github.com/noxoua "noxoua (6 commits)")[![brychokvadim](https://avatars.githubusercontent.com/u/47942981?v=4)](https://github.com/brychokvadim "brychokvadim (2 commits)") --- Tags deliverydaanernovaposhtaukraine-deliverylaravel-nplaravel-novaposhta ### Embed Badge ![Health badge](/badges/brychokvadim-novaposhta/health.svg) ``` [![Health](https://phpackages.com/badges/brychokvadim-novaposhta/health.svg)](https://phpackages.com/packages/brychokvadim-novaposhta) ``` ### Alternatives [daaner/novaposhta NovaPoshta (API 2.0) for Laravel 7+ 3720.8k](/packages/daaner-novaposhta)[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) PHPackages © 2026 [Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)